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 v1.1
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

開発履歴

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

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

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

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