ROIS-DS人文学オープンデータ共同利用センター(CODH)

IIIF Curation Finder

"IIIF Curation Finder"は、IIIF Curation Viewerなどで作成したキュレーションを検索する、IIIF (International Image Interoperability Framework)準拠の画像検索ツールである。

ファセット表示機能、キュレーション検索機能、キュレーション内キャンバス一覧機能、キャンバス検索機能、キャンバス詳細表示機能、検索結果を再編集した新規キュレーションの作成機能を提供する。

目次

動作デモ/活用例

使い方

トップ画面

トップ画面キャプチャ

検索バー

検索語を入力し、Enterキーまたは虫眼鏡()ボタンの押下により、検索を実行する。検索は、常にキャンバスおよびキュレーションのメタデータを対象として実行される。

検索オプション()ボタンの押下により、検索オプションが表示される。検索対象メタデータ(人間付与、機械生成)をチェックボックスにより指定する。

トップ画面で検索を実行した場合、検索結果(キュレーションのリスト)画面へ遷移する。

ファセット目次

検索に利用できるファセットの目次が表示される。各項目の押下により、ファセット一覧(後述)の該当位置にページ内スクロールする。

ファセット一覧

ファセット名とともに、検索対象に付与されたタグが一覧で表示される。タグは、生成種別(人間付与/機械生成)に応じて区別して表示される。

タグの押下により、当該タグを検索条件とした検索結果(キャンバスのリスト)画面に遷移する。

ヘッダの「リスト」ボタン

検索結果のキャンバスを、新規キュレーション作成のためのリストに追加すると、リスト内のキャンバス件数が表示される。押下によりキュレーションエクスポート画面へ遷移し、検索結果を再編集した新たなキュレーションを公開できる。

ただし、Web storage (local storage)が利用できないブラウザ環境(ブラウザが「CookieとWebサイトのデータ」を常にブロックする設定になっている場合や、一部のブラウザのプライベートモードなど)では、この機能は利用できない。

検索結果(キュレーションのリスト)画面

検索結果を、キュレーション単位で表示する。これはキャンバスおよびキュレーションのメタデータを対象とした検索結果であって、キュレーションのみのメタデータを対象とした検索結果ではない。

検索結果(キュレーションのリスト)画面キャプチャ

検索結果は、次のキュレーションからなる。

  • キュレーションのメタデータに検索がヒットした場合、当該キュレーション
  • キャンバスのメタデータに検索がヒットした場合、当該キャンバスを含んでいるキュレーション

検索結果には、キュレーションのサムネイル、タイトル、含まれるキャンバス数、クロール日時、キュレーション内キャンバス一覧()ボタンが表示される。サムネイルまたはタイトルの押下により、当該キュレーションをIIIF Curation Viewerで開くことができる。キュレーション内キャンバス一覧ボタンの押下により、キュレーション内キャンバス一覧画面に遷移する。

キャンバスタブの押下により、検索結果(キャンバスのリスト)画面に遷移する。

キュレーション内キャンバス一覧画面

検索結果(キュレーションのリスト)に含まれる、あるキュレーションについて、その内訳(含まれるキャンバス)を一覧表示する。

キュレーション内キャンバス一覧画面キャプチャ

キュレーション内キャンバス一覧には、キャンバスのサムネイル、画像ホスト名、リスト追加()ボタンが表示される。サムネイルの押下により、キャンバス詳細表示画面に遷移する。リスト追加ボタンの押下により、当該キャンバスを、新規キュレーション作成のためのリストに追加できる。

検索結果(キャンバスのリスト)画面

検索結果を、キャンバス単位で表示する。これはキャンバスおよびキュレーションのメタデータを対象とした検索結果であって、キャンバスのみのメタデータを対象とした検索結果ではない。

検索結果(キャンバスのリスト)画面キャプチャ

検索結果は、次のキャンバスからなる。

  • キャンバスのメタデータに検索がヒットした場合、当該キャンバス
  • キュレーションのメタデータに検索がヒットした場合、当該キュレーションに含まれているキャンバス

検索結果には、キャンバスのサムネイル、画像ホスト名、リスト追加()ボタンが表示される。サムネイルの押下により、キャンバス詳細表示画面に遷移する。リスト追加ボタンの押下により、当該キャンバスを、新規キュレーション作成のためのリストに追加できる。

IIIF Curation Playerで開く()ボタンの押下により、当該検索結果をIIIF Curation Playerで開く。

キュレーションタブの押下により、検索結果(キュレーションのリスト)画面に遷移する。

キャンバス詳細表示画面

キャンバス画像およびアトリビューション情報等が表示され、ズームイン/ズームアウトや各種操作が行える。また、対象が部分キャンバスである場合、元の全体キャンバスのどの部分に対応するかが表示される。

キャンバス詳細表示画面キャプチャ

「戻る」ボタンの押下により、従前の画面に戻る。「リストに入れる」ボタンの押下により、当該キャンバスを、新規キュレーション作成のためのリストに追加できる。IIIF Curation Viewerで開く()ボタンの押下により、当該キャンバスをIIIF Curation Viewerで開く(当該キャンバスが含まれるキュレーション情報の有無に応じて、キュレーション内またはマニフェスト内の当該キャンバスを開く)。IIIFアイコンボタンを、他のIIIFビューワにドラッグ&ドロップすることにより、当該キャンバスを他のIIIFビューワで開くことができる。

キャンバスのメタデータに、設置時の設定により指定された識別子が含まれている場合、識別子のレゾルバへのリンクが表示される。

キャンバスにタグが付与されている場合、タグが表示される。タグの押下により、当該タグを検索条件とした検索結果(キャンバスのリスト)画面に遷移する。

キュレーションエクスポート画面

新規キュレーション作成のためのリストに追加されたキャンバスに基づき、検索結果を再編集した新たなキュレーションを投稿できる。

キュレーションエクスポート画面キャプチャ

ここでは、投稿する新規キュレーションのタイトルや説明を必要に応じて入力する。

「セレクション」には、キャンバスのサムネイル、削除(×ばつ)ボタン、「詳細」ボタンが表示される。サムネイルのドラッグ&ドロップにより、リスト内での順番を変更できる。削除ボタンの押下により、リストからキャンバスを削除できる。「詳細」ボタンの押下により、キャンバス詳細表示画面に遷移する。

「全てクリア」ボタンの押下により、リストから全てのキャンバスを削除できる。「戻る」ボタンの押下により、従前の画面に戻る。「投稿する」ボタンの押下により、新規キュレーションをサーバに投稿する。

※(注記) 画面キャプチャ中の資料の出典:慶應義塾大学所蔵『酒呑童子』

設置時の設定

IIIF Curation Finder設置時のオプション指定により、Finderの挙動をカスタマイズできる。

オプション指定は、次に挙げるプロパティを持ったオブジェクトをIIIFCurationFinderの引数に与えることによって行う。

  • title:デフォルト値'IIIF Curation Finder'
  • service
    • curationJsonExportUrl:デフォルト値''
    • curationViewerUrl:デフォルト値'http://codh.rois.ac.jp/software/iiif-curation-viewer/demo/'
    • curationPlayerUrl:デフォルト値'http://codh.rois.ac.jp/software/iiif-curation-player/demo/'
    • searchEndpointUrl:デフォルト値undefined
    • facetsEndpointUrl:デフォルト値undefined
  • enableFacetedSearch:デフォルト値false
  • identifierResolvers: デフォルト値{}

title

titleは、IIIF Curation Finderのヘッダ左上部分および<title>に用いられる名称を指定する。言語ごとに異なる名称とする場合、次のように@languageと@valueを用いて記述する。

title: [
 {
 '@language': 'ja',
 '@value': '<span class="icf_navbar_brand_logo"></span>顔貌コレクション'
 },
 {
 '@language': 'en',
 '@value': '<span class="icf_navbar_brand_logo"></span>Collection of Facial Expressions'
 }
]

service

curationJsonExportUrlは、キュレーションリスト(JSON形式)を外部サービスに送信できるようにする場合、その送信先URLを設定する。

curationViewerUrlは、検索結果のキュレーションやキャンバスを表示する際に用いられるIIIF Curation ViewerのURLを設定する。

curationPlayerUrlは、検索結果(キャンバスのリスト)を表示する際に用いられるIIIF Curation PlayerのURLを設定する。

searchEndpointUrlは、Canvas Indexerの検索用エンドポイントURLを設定する。

facetsEndpointUrlは、Canvas Indexerのファセット一覧取得用エンドポイントURLを設定する。

enableFacetedSearch

enableFacetedSearchは、IIIF Curation Finderでファセット表示機能を有効にするか否かを指定する。

identifierResolvers

identifierResolversは、キャンバス詳細表示画面において、メタデータに含まれる識別子をリンク化する場合、その識別子名とベースURLを設定する。

次のように設定した場合、キャンバスのメタデータに識別子名「DOI」が含まれれば、ベースURL「https:​//doi.org/」の末尾に、メタデータの「DOI」値をURLエンコードして結合したURLへのリンクが表示される。

identifierResolvers: {
 'DOI': 'https://doi.org/'
}

設定例

index.js

var iiifFinder = (function() {
 var configExample = {
 facialExpressions: {
 title: [
 {
 '@language': 'ja',
 '@value': '<span class="icf_navbar_brand_logo"></span>顔貌コレクション'
 },
 {
 '@language': 'en',
 '@value': '<span class="icf_navbar_brand_logo"></span>Collection of Facial Expressions'
 }
 ],
 service: {
 curationJsonExportUrl: 'https://mp.ex.nii.ac.jp/api/curation/json',
 curationViewerUrl: 'http://codh.rois.ac.jp/software/iiif-curation-viewer/demo/',
 curationPlayerUrl: 'http://codh.rois.ac.jp/software/iiif-curation-player/demo/',
 searchEndpointUrl: 'https://mp.ex.nii.ac.jp/api/face/search',
 facetsEndpointUrl: 'https://mp.ex.nii.ac.jp/api/face/facets'
 },
 enableFacetedSearch: true,
 identifierResolvers: {
 'DOI': 'https://doi.org/',
 '慶応義塾大学請求記号': 'https://dcollections.lib.keio.ac.jp/naraehon/search/',
 '京都大学貴重資料デジタルアーカイブレコードID': 'https://rmda.kulib.kyoto-u.ac.jp/item/'
 }
 }
 };
 return IIIFCurationFinder(configExample.facialExpressions);
})();

プラグイン

IIIF Curation Finderは、IIIF Curation Viewerと同様に、プラグインを導入することによって、利用者のニーズに応じた機能拡張が可能となっている。IIIF Curation Viewerプラグイン解説資料を参照のこと。

ライセンス

IIIF Curation Finder v2.0
http://codh.rois.ac.jp/software/iiif-curation-finder/
Copyright 2018 Center for Open Data in the Humanities, Research Organization of Information and Systems
Released under the MIT license
Core contributor: Jun HOMMA (@2SC1815J)
Licenses of open source libraries, see acknowledgements.txt

開発履歴

バージョン2.0 (2024年11月11日)

  1. IIIF Image API非対応リソースの表示に対応。

バージョン1.2 (2024年08月27日)

  1. IIIF Presentation API 3.0のマニフェスト表示に対応。

バージョン1.1 (2021年01月27日)

  1. 識別子のレゾルバへのリンク表示機能を追加
  2. トップ画面にファセット目次(ファセット見出しへのショートカット)を追加

バージョン1.0 (2018年05月23日)

  1. CanvasおよびCurationの検索に対応
  2. 人間付与メタデータおよび機械付与メタデータに対応
  3. ファセット表示に対応

AltStyle によって変換されたページ (->オリジナル) /