togura 0.1.0a5

極めてシンプルな機関リポジトリ

Togura - 極めてシンプルな機関リポジトリ

Togura（とぐら、鳥座）は、極めてシンプルな機関リポジトリを構築するためのアプリケーションです。

動作例は https://nabeta.github.io/togura/ にあります。

特長

ToguraはJPCOARスキーマ 2.0のメタデータの記述、ならびにResourceSyncによるメタデータのハーベストに対応しており、IRDBを通して、CiNii Researchでのメタデータの検索やJaLCによるDOIの付与が行えるようになっています。また、IRDBを通さずにJaLC DOIを付与するためのXMLファイルの出力も行えます。

Toguraで構築する機関リポジトリでの論文や研究データの公開は、ローカル環境（手元のパソコン）でメタデータファイルやHTMLファイルを作成し、それらのファイルを論文や研究データのファイルといっしょにWebサーバにアップロードすることで行います。このため、以下のような特長を持っています。

• Toguraでは直接JPCOARスキーマのメタデータを記述するため、JAIRO Cloudなどでのメタデータマッピングの設定が不要になります。
• Toguraはメタデータの簡易チェック機能を提供しており、JPCOARスキーマに適合しないメタデータを記述した場合でも容易に誤りに気づくことができます。
• 手元のパソコンだけで登録作業を行うため、インターネットに接続されていない環境でも作業を行うことができます（インターネット接続は公開作業のときのみ必要）。メンテナンスによって登録作業を行えなくなる期間も発生しません。
• メタデータファイルをはじめ、登録に使用するファイルがすべて手元のパソコンに残るため、手元のパソコンのバックアップを取ることで、機関リポジトリ全体のバックアップが行えます。データの復旧も、バックアップからファイルをコピーするだけで行えます。
• 複数台のパソコンから接続できる共有フォルダがあれば、複数人で登録作業を行うことができます。
• Toguraによって構築された機関リポジトリは静的ファイルだけで構成されるため、Webサーバでのセキュリティの問題が発生する可能性は極めて低くなります。

一方で、以下のような制限があります。

• メタデータの編集にWebブラウザではなくテキストエディタを使用することを前提としているため、編集に慣れるまで少し時間がかかるかもしれません。
• JPCOARスキーマ以外の独自のメタデータ項目を定義することはできません。
• ファイルを公開するためのWebサーバの用意が別途必要になります。なお、サーバはHTMLファイルなどの静的ファイル（内容が変化しないファイル）がアップロードできるものであればよく、月数百円程度のレンタルサーバで動作させることが可能です。PHPやPython, Rubyなどのプログラミング言語の実行環境は不要です。
• IRDBによるハーベストに対応させる場合、Togura専用のホスト名を用意する必要があります。
  • ハーベスト可: https://togura.example.ac.jp/
  • ハーベスト不可: https://www.example.ac.jp/togura/
• Toguraで扱うファイルは、一律で全体公開となります。ユーザ認証やアクセス元のIPアドレスによる限定公開機能はありません。
  • Toguraにはアクセス制御の機能はありませんが、Webサーバの設定（.htaccessなど）によってパスワードやIPアドレスによるアクセス制御をかけることは可能です。
• Toguraの画面のデザインを変更するには、HTMLテンプレートファイルを直接編集する必要があります。

使い方

必要なソフトウェアのダウンロードとインストール

1. Pythonをインストールします。3.11以降のバージョンをインストールしてください。Windowsをお使いの場合、Microsoft Storeからインストールできます。
2. Visual Studio Code(VSCode)をインストールします。Windowsをお使いの場合、こちらもMicrosoft Storeからインストールできます。
3. VSCodeを起動し、画面上部のメニューから「View」→「Extensions」を選択します。画面左側に拡張機能のウインドウが表示されるので、Japanese Language Packと入力すると、検索結果に"Japanese Language Pack for Visual Studio Code"が表示されるので、"Install"ボタンを押します。
4. 画面右下に「Change Language and Restart」というボタンが表示されるので、ボタンを押してVSCodeを再起動します。
5. VSCodeの画面上部のメニューから「ターミナル」→「新しいターミナル」を選びます。ターミナルのウインドウが画面下部に開くので、以下のコマンドを実行して、uvコマンドをインストールします。なお、venvなどの環境でも動作しますが、以降のコマンドの実行例は適宜読み替えてください。
   • Windowsの場合:

     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
     

   • macOSやLinuxの場合

     curl -LsSf https://astral.sh/uv/install.sh | sh
     

6. VSCodeをいったん終了します。この操作を実行しないと、これ以降のコマンドが動作しないので、必ず実行してください。

Toguraの実行準備

1. エクスプローラーなどで、Toguraの登録作業に利用するための空のフォルダを作成します。フォルダの名前はなんでもかまいませんが、半角英数小文字を使用することをおすすめします。以降、このフォルダを「Toguraのフォルダ」と記述します。

2. VSCodeを起動し、メニューから「ファイル」→「フォルダーを開く」を選び、Toguraのフォルダを選んで開きます。

3. 「このフォルダ内のファイルの作成者を信頼しますか?」と尋ねられたら、「はい、作成者を信頼します」を選びます。

4. VSCodeの画面上部のメニューから「ターミナル」→「新しいターミナル」を選び、ターミナルを起動します。ターミナルで以下のコマンドを実行して、Toguraのモジュールをインストールします。もし「uv : 用語 'uv' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。」というエラーが表示された場合、VSCodeを再起動してください。

   uv venv; uv pip install togura
   

5. ターミナルで以下のコマンドを実行して、Toguraの初期設定を行います。末尾の.（ドット）の入力を忘れないようにしてください。

   uv run togura init .
   

6. 画面上部のメニューから「表示」→「拡張機能」を選びます。画面左側のウインドウに拡張機能の一覧が表示されるので、以下の2つに対してそれぞれ「インストール」ボタンを押します。
   画面右下に 「このリポジトリ 用のおすすめ拡張機能 をインストールしますか?」というメッセージが表示された場合、「インストール」を選んでください。ただし、この場合でも別途画面左側のウインドウでそれぞれの拡張機能に対して「インストール」ボタンを押す必要があります。

   • Python
   • YAML

7. ターミナルで以下のコマンドを実行して、Toguraの設定ファイルを作成します。このコマンドでは、設定ファイルconfig.yamlと、テンプレートのファイルtemplates/head_custom.htmlが作成されます。

   uv run togura setup
   

   以下の項目を質問されますので、入力してください。

   • 組織の名称: 大学名など、機関リポジトリを運用する組織の名称です。
   • 機関リポジトリの名称: 機関リポジトリの名称です。
   • 機関リポジトリのトップページのURL: 公開先のWebサーバのトップページのURLです。末尾のスラッシュの入力は不要です。
     • Webサーバによる公開を行わず、自分のパソコンだけで動作を試す場合には、入力は不要です。
   • メールアドレス: OpenAlexのWebAPIを用いてメタデータを検索する際に使用するメールアドレスです。空欄でもかまいませんが、メールアドレスを入力すると検索が速くなります。
   • JaLCのサイトID: JaLCのサイトIDです。JaLCの正会員がDOIの登録を行う際に必要です。JaLCの正会員でない場合、入力は不要です。

   名称などを変更したい場合は、再度同じコマンドを実行してください。

8. VSCodeのメニューで「ファイル」→「名前をつけてワークスペースを保存」を選び、そのまま「保存」を選びます。

動作テスト

1. Windowsのエクスプローラーなどで、Toguraのフォルダを開きます。次の6つのフォルダが存在することを確認します。
   • archive: 作業済み・取り下げ済みのファイルを保存するフォルダ
   • public: 公開用のファイルが出力されるフォルダ
     • データを公開するには、このフォルダの中身をWebサーバにアップロードする
     • このフォルダに保存されたファイルは編集しないこと
   • samples: メタデータのサンプルのフォルダ
   • schema: メタデータスキーマの定義ファイルを保存するフォルダ
   • templates: HTMLテンプレートファイルを保存するフォルダ
   • trash: ResourceSyncの出力から削除するファイルを保存するフォルダ
   • work: 作業用フォルダ
     • このフォルダに保存されたファイルを編集すること
2. samplesフォルダを開き、サンプルの資料のフォルダが保存されていることを確認します。サンプルの資料は、JPCOARスキーマ2.0のサンプルファイルをもとに作成しています。
3. publicフォルダとworkフォルダを開き、それぞれ中身が空であることを確認します。
   • お使いのパソコンで隠しファイルを表示する設定になっている場合、publicフォルダの中に.well-knownフォルダが表示されます。このフォルダはResourceSyncのXMLファイルの出力で使用するため、削除せずそのままにしておいてください。
4. samplesフォルダの中にある00_sampleなどのフォルダをすべて選択して、workフォルダにコピーします。
5. VSCodeに戻ってターミナルを開き、以下のコマンドを実行します。

   uv run togura generate
   

6. publicフォルダの中に作成されているindex.htmlファイルを開き、サンプルの資料の情報が表示されていることを確認します。

資料の登録

1. WindowsのエクスプローラーなどでToguraのフォルダを開き、workフォルダの中に新しいフォルダを作成します。フォルダ名は以下の規則に従う必要があります。

   • 1文字以上の半角数字で始まること
     • この数字がリポジトリでの資料の登録番号となり、公開する際のURLの一部として使用されます。たとえば1001_my_articleというフォルダを作成した場合、そのフォルダの資料はhttps://リポジトリのホスト名/1001/ro-crate-preview.htmlというURLで公開されます。
     • 登録番号はリポジトリ内で重複していない番号を使用する必要がありますが、連番である必要はなく、リポジトリの運用担当者で規則を決めてかまいません（もちろん連番でもかまいません）。なお、Excelなどの表計算ソフトウェアで資料の一覧を管理する際のトラブルを防ぐため、登録番号の先頭の数字は0で始めないことを強くおすすめします。
   • 登録番号の後ろに_（半角のアンダースコア）を含めること
   • _の後ろの文字は任意の文字列を入力可能
     • 資料名など、わかりやすいものであればなんでもかまいません。

   ここではworkフォルダの中に1001_my_articleフォルダを作ったこととして、以降そのフォルダをwork/1001_my_articleフォルダと記述します。

2. samplesフォルダの中にあるサンプルのメタデータファイルから、登録する資料の種類に適したものを選んで、work/1001_my_articleフォルダにコピーします。ファイル名はjpcoar20.yamlのままとしてください。

3. work/1001_my_articleフォルダに、登録したい論文ファイルや研究データファイルをコピーします。ファイル名はなんでもかまいませんが、データを公開するときのURLに使用されるため、英数小文字を使用することをおすすめします。ただし、work/1001_my_articleフォルダの中にフォルダを作成すると、これ以降の処理が正常に動作しなくなりますので注意してください。

4. VSCodeのファイル一覧からwork/1001_my_articleフォルダを開き、メタデータファイルjpcoar20.yamlの編集と保存を行ってください。編集の際には、以下の2点に注意してください。

   • jpcoar20.yamlの文字コードはUTF-8としてください。VSCodeで編集する際には、特になにも設定する必要はありません。
   • jpcoar20.yamlの編集はVSCode以外のテキストエディタでも行うことができますが（後述）、VSCodeで編集する場合、以下の機能が利用できます。
     • 一部のメタデータ項目名の最初の数文字を入力すると、自動的に入力候補が表示されます。
     • JPCOARスキーマに適合しないメタデータを記述している場合、赤色の波線が表示されます。
     • VSCodeでのメタデータのチェック機能を動作させるには、jpcoar20.yamlの1行目に以下の記述が必要です。もし削除してしまった場合、1行目に同じ記述を追加し直してください。

       # yaml-language-server: $schema=../../schema/jpcoar.json
       

資料識別子一覧ファイルによるメタデータの一括作成

注意: この機能は現在開発中です。

資料の識別子（DOIやCiNii ResearchのURL）を記入したExcelファイルとOpenAlexのWebAPIを用いて、Toguraのメタデータを一括で作成することができます。実行する前にuv run togura setupコマンドを用いて、OpenAlexのWebAPIで使用するメールアドレスを設定しておくことをおすすめします。

一括登録を行うには、以下の書式で資料のExcelファイルを作成します。id列とurl列を作成し、id列に登録番号、url列に登録対象のDOIやCiNii ResearchのURLを記入します。ここではこのファイルをworks.xlsxという名前で作成し、Toguraのフォルダに保存したものとします。

id	url
1	https://doi.org/10.5555/12345678
2	https://doi.org/10.5555/12345679
3	https://cir.nii.ac.jp/crid/1570291227970272256

以下のコマンドを実行し、Excelファイルworks.xlsxを読み込みます。

uv run togura work-file import works.xlsx

実行に成功すると、workフォルダに、Excelファイルで指定した登録番号とDOIに対応する資料のタイトルでフォルダが作成され、その中にメタデータファイルjpcoar20.yamlが保存されます。あとは論文や研究データのファイルをこのフォルダに保存し、適宜メタデータファイルの追記や修正を行ってください。

著者識別子による資料識別子一覧ファイルの作成

著者の識別子（ORCIDやresearchmapのURL）を書いたExcelファイルをもとに、インポート用の資料識別子一覧ファイルを作成することができます。
以下の書式でExcelファイルを作成します。url列にORCIDやresearchmapのURLを記述します。ここではauthors.xlsxという名前で作成したものとします。

url
https://orcid.org/0000-0002-9986-7223
https://researchmap.jp/tanabe

以下のコマンドを実行すると、DOI・CiNii ResearchのURL一覧のExcelファイルworks.xlsxが作成されます。

uv run togura work-file create authors.xlsx works.xlsx

このファイルを、以下のコマンドでインポートします。

uv run togura work-file import works.xlsx

リポジトリ公開用ファイルの出力

VSCodeのターミナルで以下のコマンドを実行し、YAMLで作成したメタデータファイルをHTMLファイルとJPCOARスキーマのXMLファイルに変換します。

uv run togura generate

スクリプトの実行が正常に完了すると、ターミナルに以下のメッセージが表示されます。もしこのメッセージが表示されず、エラーになっている場合は、後述の「エラーへの対応」をごらんください。

Toguraによるリポジトリの構築処理が完了しました。

また、publicフォルダの中に以下のファイルとフォルダが作成されます。エクスプローラーなどでindex.htmlやro-crate-preview.htmlファイルを開き、登録した資料の情報が表示されることを確認してください。

• 登録一覧のHTMLファイルindex.html
• 登録番号のついたフォルダ
  • 登録した論文ファイル・研究データファイル
  • ro-crate-preview.html: メタデータを表示するためのHTMLファイル。RO-Crateの規格に則ったファイル名になっています
  • ro-crate-metadata.json: RO-CrateのメタデータJSONファイル
  • jpcoar20.xml: JPCOARスキーマのXMLファイル

メタデータの編集はworkフォルダの中のファイルのみを用いて行います。publicフォルダの中に作成されたファイルは編集しないでください。編集しても、再度uv run togura generateコマンドを実行することで上書きされます。

リポジトリ公開用ファイルのアップロード

publicフォルダに保存されたフォルダとファイルの一式を、Webサーバにアップロードします。アップロードの方法は、FTPクライアントやWeb管理画面など、お使いのWebサーバによって異なりますので、サーバの管理者（大学のIT担当部署・レンタルサーバの業者など）におたずねください。

ロゴの変更

ロゴのファイルはtemplates/images/logo.pngに保存されています。ロゴを変更するには、このファイルを新しいファイルで上書きしてください。
ロゴのファイル名はlogo.png、ファイル形式はpngでなければなりません。

エンバーゴ期間が終了している資料のチェック

Toguraでは、資料に対してエンバーゴ期間が終了しているかどうかの一括チェックを行うことができます。具体的には、以下の条件にあてはまる資料の一覧を出力することができます。

• メタデータのaccess_rightsがembargoed accessになっている
• メタデータのdateのdate_typeがAvailable、かつdateが実行日よりも前の日付になっている

エンバーゴ期間のチェックはuv run togura check-expired-embargoコマンドを用いて行います。指定できる項目は以下のとおりです。

• --dir: チェック対象のフォルダを指定します。個別の資料のフォルダではなく、workフォルダのような、資料の一式が保存されているフォルダを指定してください。指定しない場合、workが指定されたものとして動作します。
• --update: このオプションが指定された場合、エンバーゴ期間が終了している資料のメタデータファイルjpcoar20.yamlに対して、access_rightsの値をembargoed accessからopen accessに更新します。更新は確認なしで実行されますので、このオプションを指定する前に、後述の手順で、必ずエンバーゴ期間のチェック結果をテキストファイルに書き出しておいてください。

以下がコマンドの実行例です。

uv run togura check-expired-embargo

# archiveフォルダの資料をチェック対象とする場合
uv run togura check-expired-embargo --dir archive

出力結果は以下のようになります。メタデータに記述した利用可能日（date_typeにAvailableを指定しているdate）と、資料のメタデータの保存場所が出力されますので、メタデータのaccess_rightsの値をopen accessなどに変更してください。

2016-04-01	work/02_journal_article_embargoed/jpcoar20.yaml
2016-04-01	work/04_journal_article_accepted_embargoed/jpcoar20.yaml

出力結果はテキストファイルに書き出すこともできます。以下の実行例は、チェック結果をexpired_embargo.txtというファイルに書き出す例です。この例では、expired_embargo.txtファイルはToguraのフォルダに保存されます。

• Windowsの場合:

  uv run togura check-expired-embargo | Tee-Object -FilePath expired_embargo.txt
  

• macOSやLinuxの場合:

  uv run togura check-expired-embargo | tee expired_embargo.txt
  

メタデータのaccess_rightsの更新は、以下のコマンドで一括で行うこともできます。必ず実行前に、エンバーゴ期間の一覧をテキストファイルに保存しておいてください。

uv run togura check-expired-embargo --update

メタデータの更新が完了したら、uv run togura generateコマンドで更新を公開用のファイルに反映させてください。

公開した資料の取り下げ

1. すでにWebサーバで取り下げ対象の資料を公開している場合、サーバからその資料のフォルダを削除します。
2. publicフォルダを開き、取り下げ対象の資料のフォルダを削除します。
3. 同様にworkフォルダを開き、取り下げ対象の資料のフォルダをarchiveフォルダに移動します。
4. 「リポジトリ公開用ファイルの出力」の手順に沿って、uv run togura generateコマンドを実行し、ファイルを再作成します。
5. 「リポジトリ公開用ファイルのアップロード」の手順に沿って、再作成したファイルをWebサーバにアップロードします。

JPCOARスキーマ・JaLC XMLファイルの出力チェック

Toguraでは、JPCOARスキーマやJaLCのXMLファイルが正しい書式でpublicフォルダに出力されているかどうかを確認することができます。

JPCOARスキーマ

JPCOARスキーマのXMLファイルの出力チェックは、以下のコマンドで行います。GitHub上のXSDファイルを用いてチェックを行うので、インターネットに接続されている環境で実行する必要があります。

uv run togura validate jpcoar20-xml

出力にエラーがある場合、以下のようなメッセージが表示されます。

以下のJPCOARスキーマXMLファイルにエラーがあります。
/home/nabeta/togura/public/00/jpcoar20.xml
invalid XML syntax: mismatched tag: line 3, column 35

JaLC

JaLCのXMLファイルの出力チェックを行うには、事前に以下の準備を行う必要があります。

1. JaLCのWebサイトから、XSDスキーマのzipファイルをダウンロードします。
2. zipファイルを展開するとXSDスキーマという名前のフォルダが作成されますので、そのままschemaフォルダの中にコピーします。

出力チェックは以下のコマンドで行います。

uv run togura validate jalc-xml

出力にエラーがある場合、以下のようなメッセージが表示されます。

以下のJaLC XMLファイルにエラーがあります。
/home/nabeta/togura/public/00/jalc.xml
failed validating '' with XsdPatternFacets(['[0-9]+']):

Reason: value doesn't match any pattern of ['[0-9]+']

Schema component:

  <xs:pattern xmlns:xs="http://www.w3.org/2001/XMLSchema" value="[0-9]+" />

Instance type: <class 'xml.etree.ElementTree.Element'>

Instance:

  <year />

Path: /root/body/content/publication_date/year

エラーへの対応

「uv : 用語用語 'uv' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。」というエラーになる

VSCodeでuvコマンドのインストールを実行したのにエラーになる場合、uvコマンドがVSCodeの環境で認識されていない可能性があります。VSCodeを再起動してください。

togura generateコマンドの実行時に、「以下のメタデータの（項目名）にエラーがあります」というエラーになる

メタデータのYAMLファイルに記述の誤りがある可能性があります。エラーメッセージに、エラーの発生しているメタデータの項目名とファイル名が表示されていますので、該当するメタデータのファイルを開き、エラーになっている箇所（VSCodeを使用している場合、赤の波線が表示されています）を確認してください。メタデータを修正したら、再度uv run togura generateコマンドを実行してください。

VSCodeでエラーが表示されている箇所がないのにuv run togura generateコマンドでエラーになる場合、Toguraの不具合が考えられますので、後述の「使い方の質問」に記載されている連絡先までお問い合わせください。

togura generateコマンドの実行時に、"IsADirectoryError:"というエラーになる

資料のフォルダの中に、別のフォルダが作成されている可能性がありますので、削除するか別の場所に移動してください。Toguraでは、資料のフォルダの中にフォルダを作成することはできません。

メタデータで記述した項目がHTMLに表示されていない

Toguraの不具合の可能性が高いので、「使い方の質問」に記載されている連絡先までお知らせください。

上記以外のエラーになる

実行しようとしていた内容とエラーメッセージの全文を、「使い方の質問」に記載されている連絡先までお知らせください。

バックアップとリストア

バックアップはToguraのフォルダをコピーするだけで行えます。外付けディスクなどにコピーしておいてください。

新しいパソコンでバックアップからのリストア（復元）を行うには、新しいパソコンにToguraを再インストールした後、外付けディスクなどに保存したToguraのフォルダを新しいパソコンにコピーしてください。

VSCode以外での動作

メタデータの編集は、VSCodeのほかにも、メモ帳などUTF-8の扱えるテキストエディタで行うことができます。ただし、メタデータの項目のチェック機能が使えなくなりますのでご注意ください。また、メタデータの保存の際には、文字コードがUTF-8になっていることを確認してください。
メモ帳などVSCode以外のテキストエディタで作成したメタデータでも、VSCodeでToguraを実行することで、メタデータの項目のチェック機能が使えるようになります。チェック機能を有効にするには、上述の「メタデータの書き方」に沿った場所にメタデータのファイルjpcoar20.yamlを保存し、かつjpcoar20.yamlの1行目に以下の行を追加する必要があります。

# yaml-language-server: $schema=../../schema/jpcoar.json

コマンドの実行に使用するターミナルには、VSCode内蔵以外のものを使用することも可能です。Windowsの場合、PowerShellやWindows Terminalが利用可能です。ターミナルのウインドウの位置を自由に設定したい場合は、こちらのほうがおすすめです。
VSCode内蔵以外のターミナルを使用する場合は、Toguraのコマンドの実行前に、ターミナルの作業フォルダをToguraのフォルダに変更する必要があります。以下の実行例は、Toguraのフォルダがドキュメント→toguraにある場合のものです。

# Windowsの場合
cd $home
cd "Documents\togura"

# macOS・Linuxの場合
cd ~
cd Documents/togura

Toguraの更新

VSCodeなどでターミナルを起動し、以下のコマンドを実行します。

uv pip install togura --upgrade

他の機関リポジトリからの移行

Toguraでは、JPCOARスキーマ1.0でのOAI-PMHの出力に対応している機関リポジトリから、登録されている資料とメタデータを移行することができます。移行にはuv run togura migrateコマンドを使用します。

指定できる項目は以下のとおりです。

• --base-url（必須）: OAI-PMHのベースURLです。JAIRO Cloudの場合、各リポジトリのトップページのURLに/oaiを追加したものになります。たとえばリポジトリのトップページのURLがhttps://jpcoar.repo.nii.ac.jpの場合、OAI-PMHのベースURLはhttps://jpcoar.repo.nii.ac.jp/oaiになります。
• --export-dir（必須）: 取得した資料の本文ファイルとメタデータを保存するフォルダ（ディレクトリ）です。任意の名前のフォルダを指定できます。
• --date-from: 移行対象の開始日で、この日よりも後に登録・更新された資料を移行します。yyyy-MM-dd（年4桁・月2桁・日2桁の半角数字、半角ハイフン区切り）形式で指定します。指定しない場合、コマンド実行時の30日前の日付が指定されたものとして動作します。
• --date-until: 移行対象の終了日で、この日よりも前に登録・更新された資料を移行します。yyyy-MM-dd（年4桁・月2桁・日2桁の半角数字、半角ハイフン区切り）形式で指定します。指定しない場合、コマンド実行時の日付が指定されたものとして動作します。
• --metadata-prefix: 取得するメタデータの種類です。jpcoar_1.0かjpcoar_2.0を指定します。指定しない場合、jpcoar_1.0が指定されたものとして動作します。
• --metadata-only: 本文ファイルをダウンロードせず、JPCOARスキーマのメタデータファイルのみをダウンロードします。

以下がコマンドの実行例です。実際に実行するときには、--base-urlなどを適宜変更してください。また、この実行例では本文ファイルのダウンロードを行うため、実行に長い時間がかかる場合があることにご注意ください。

uv run togura migrate --base-url https://another.repo.example.ac.jp/oai --export-dir another --date-from 2025-08-01 --date-until 2025-08-31 --metadata-prefix jpcoar_1.0

コマンドの実行が完了すると、--export-dirで指定したフォルダ（上記の例ではanother）の中に各資料のフォルダが作成され、その中に本文ファイルとメタデータjpcoar20.yamlが保存されています。この各資料のフォルダをworkフォルダに移動し、uv run togura generateコマンドを実行すると、移行した資料がToguraに登録されます。

なお、指定した期間に登録された資料がない場合、以下のエラーが出力されます。対象の期間を広げて、再度実行してください。

NoRecordsMatch: The combination of the values of the from, until, set and
metadataPrefix arguments results in an empty list.

メタデータスキーマの定義ファイルの更新

この作業は開発者が行うもので、メタデータの編集では必要ありません。

1. yqコマンドをインストールします。

   sudo apt-get install yq
   

2. src/togura/schema/jpcoar.yamlファイルを編集します。
3. yqコマンドでsrc/togura/schema/jpcoar.yamlファイルをJSON Schemaのファイルに変換します。

   yq . src/togura/schema/jpcoar.yaml > src/togura/schema/jpcoar.json
   

TODO

• jpcoar20.yamlのプロパティ名を整理する
• ResourceSyncのchangelist.xmlを作成できるようにする
• RO-Crateで出力する項目を追加する
• JaLCのWebAPIを用いてDOIを直接付与できるようにする
• CiNiiやJaLC、CrossrefやDataCiteの書誌情報を用いて、自動的にメタデータのYAMLファイルを作成する
• GakuNin RDMのコマンドラインツールと連携して、GakuNin RDMからファイルとメタデータの情報を取得する

使い方の質問

使い方やエラーの対応でわからないことがある場合は、Code4Lib JAPANのDiscord、もしくはGitHubのIssuesでお知らせください。作者にメールを送っていただいてもかまいませんが、返信が遅れる可能性が高いため、できるだけDiscordかGitHubでの連絡をお願いします。

参考資料

• Togura（とぐら、鳥座）: 超省力機関リポジトリ （COAR Annual Conference 2025のポスター）
• Hussein Suleman. Designing Repositories in Poor Countries, Open Repositories 2023, 2023.
  • Simple DL
• Super – Simple – Static – Sustainable: a low resource repository jam （Open Repositories 2024のワークショップ）
  • Super-Simple-Static-Sustainable （ワークショップの成果物）
• 阿達 藍留, 山田 俊幸, 大向 一輝. DAKit: 低コストなデータ共有のための静的デジタルアーカイブジェネレータの提案, 情報知識学会誌, 2022, 32巻4号, p.406-409.
  • DAKit

作者

田辺浩介 (@nabeta, nabeta at fastmail dot fm)