【Omeka Sモジュール】Clean Urlの使い方
概要
Omeka Sでリソース（アイテムセット、アイテム、メディア）に識別子を与える方法を説明します。
具体的には、以下のモジュール「Clean Url」の使い方を説明します。
インストール
以下にOmeka Sがomeka-s-sandboxというフォルダ名でインストールされていることを前提とします。
/home/xxxx/www/omeka-s-sandbox/
以下のREADMEにおいて、関連モジュール「Generic」のインストールが推奨されています。
https://github.com/Daniel-KM/Omeka-S-module-CleanUrl#installation
そこで、以下を実行します。
wget https://github.com/Daniel-KM/Omeka-S-module-Generic/releases/download/3.3.34/Generic-3.3.34.zip
unzip Generic-3.3.34.zip
上記は、Genericのv3.3.34をダウンロードした例です。最新版は以下にアクセスして、画面に示した箇所から、URLを取得してください。
https://github.com/Daniel-KM/Omeka-S-module-Generic
次にClean Urlモジュールをインストールします。以下を実行します。
wget https://github.com/Daniel-KM/Omeka-S-module-CleanUrl/releases/download/3.17.3.3/CleanUrl-3.17.3.3.zip
unzip CleanUrl-3.17.3.3.zip
上記は、CleanUrlのv3.17.3.3をダウンロードした例です。最新版は以下にアクセスして、画面に示した箇所から、URLを取得してください。
https://github.com/Daniel-KM/Omeka-S-module-CleanUrl
管理ダッシュボードへのログイン
以下のURL（例です。ご自身の環境に応じて、変更してください。）から、管理ダッシュボードにログインしてください。
https://shared.ldas.jp/omeka-s-sandbox/login
以下、ログイン後のURLおよび画面です。
https://shared.ldas.jp/omeka-s-sandbox/admin
モジュールのインストール
画面左に表示される「管理」>「モジュール」をクリックして、「Generic」と「Clean Url」がモジュール一覧に表示されることを確認します。「Generic」「Clean Url」の順に、それぞれ「インストール」ボタンをクリックします。
「Clean Url」については、インストール後、以下の設定画面に遷移します。これでインストール作業は完了です。
アイテムへの識別子の付与
Clean Urlの挙動の確認にあたり、アイテムに識別子を付与します。以下の図では、dcterms:identifierを使用しています。この項目（プロパティ）を使用することが一般的ですが、他の項目でもかまいません。後ほど、どの項目を識別子に使用するか、Clean Urlモジュールの設定画面において設定します。
以下では、「test123」という識別子を与えました。
上記のアイテムには、以下のようなURLでアクセスできます。なお、Omeka Sではその内部で複数のサイトを構築することできます。以下の例は、Omeka S内の一つのサイト「test」でアイテムを表示した例です。Omeka Sが自動で割り振る内部IDの「3」がURLに含まれています。
https://shared.ldas.jp/omeka-s-sandbox/s/test/item/3
参考：Omeka SのURLの構造例
Omeka Sでアイテムにアクセスするための構造は以下です。
<Omeka Sをインストールしたパス>/s（SiteのSの意味）/<サイトのID>/item/＜Omekaの内部ID＞
モジュールの設定
以下のように、画面左の「モジュール」をクリックして、一覧に表示される「Clean Url」の「設定」ボタンをクリックします。先に示した設定が表示されます。
以下、いくつかの設定例を紹介します。
Sites and pages
Skip "s/site-slug/" for default site
こちらの項目を下図のように設定すると、
以下のようなエラーが発生するはずです。これは、Omeka Sにおいて、デフォルトサイトが設定されていないためです。
そのため、以下に示すように、画面左の「管理」>「設定」にアクセスして、「デフォルトのサイト」に作成済みのサイトから一つのサイトを選択します。
その後、再度Clean Urlの設定画面に戻り、Skip "s/site-slug/" for default siteにチェックを入れて「送信」ボタンを押します。
そして、画面左の「サイト一覧」から以下の画面に遷移し、それぞれのサイトにアクセスします。以下の例では、サイト「はじめてのウェブサイト」がデフォルトサイト、サイト「はじめてのテーマ」が非デフォルトサイトです。
その結果、前者は「/s/test」という文字列がない、以下のシンプルなURLでアクセスできます。
https://shared.ldas.jp/omeka-s-sandbox/
また、後者はOmeka Sの一般的なURLの構造である「/s/<サイト名>」のままとなっています。
https://shared.ldas.jp/omeka-s-sandbox/s/bootstrap/
上記のように、デフォルトのサイトが決まっており、「/s/<サイト名>」というOmeka S特有のURLの構造をスキップしたい場合、本設定Skip "s/site-slug/" for default siteを有効化することをお勧めします。
アイテム
Default path
この項目で、パスの構造を指定することができます。デフォルトではdocument/{item_identifier}という値が入力されています。
実際、上記のプロセスでClean Urlのモジュールをインストールしたことにより、以下のURLでアイテムの詳細画面にアクセスすることができます。
https://shared.ldas.jp/omeka-s-sandbox/document/test123
例えば、本項目をrecord/{item_identifier}に変更してみます。
その結果、以下のURLはPage not foundになります。
https://shared.ldas.jp/omeka-s-sandbox/document/test123
一方、以下のURLが有効になります。
https://shared.ldas.jp/omeka-s-sandbox/record/test123
上記のように、URLの構造を変更したい場合に、本項目を設定します。
Property for identifier
この項目において、どのプロパティの値を識別子に使用するか、設定することができます。一般的には、デフォルト値であるdcterms:identifierを使用しますが、プロジェクト等において、他のプロパティを使用している場合には、この項目の値を変更します。
まとめ
本記事で紹介したもの以外に、数多くの設定があります。これらについては、適宜、説明を追加していきたいと思います。Omeka Sにおける識別子の管理において、本記事がお役にたてば幸いです。
Discussion