IIIF Curation Finder | ROIS-DS人文学オープンデータ共同利用センター

“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)

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

バージョン1.2 (2024-08-27)

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

バージョン1.1 (2021-01-27)

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

バージョン1.0 (2018-05-23)

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