はじめに
本章では、前章までに構築したOmeka Classic + IIIF Toolkit環境に対して、IIIFマニフェストを登録し、Miradorビューアで画像を閲覧する方法を解説します。IIIF Toolkitプラグインは、Omeka Classicのアイテムに対してIIIFマニフェストを自動生成する機能を備えており、手動での登録だけでなく、外部のIIIFマニフェストのインポートにも対応しています。
IIIFマニフェストとは
IIIFマニフェスト(IIIF Manifest)は、IIIF Presentation APIで定義されるJSON-LDファイルです。画像のメタデータ、構造情報、表示順序などを記述し、ビューアが画像を適切に表示するために使用されます。
マニフェストの基本的な構造は以下の通りです:
{
"@context": "http://iiif.io/api/presentation/2/context.json",
"@type": "sc:Manifest",
"@id": "https://example.com/manifest.json",
"label": "サンプルマニフェスト",
"sequences": [
{
"@type": "sc:Sequence",
"canvases": [
{
"@type": "sc:Canvas",
"@id": "https://example.com/canvas/1",
"label": "1ページ目",
"width": 1000,
"height": 1500,
"images": [
{
"@type": "oa:Annotation",
"resource": {
"@type": "dctypes:Image",
"service": {
"@context": "http://iiif.io/api/image/2/context.json",
"@id": "https://example.com/iiif/2/image1",
"profile": "http://iiif.io/api/image/2/level2.json"
}
}
}
]
}
]
}
]
}
画像のアップロードによるマニフェスト生成
アイテムの作成と画像のアップロード
IIIF Toolkitが有効な環境では、Omeka Classicのアイテムに画像をアップロードすると、自動的にIIIFマニフェストが生成されます。
- 管理画面の「アイテム」>「アイテムの追加」をクリックします
- Dublin Coreメタデータ(タイトル、説明など)を入力します
- 「ファイル」タブでJPEGやTIFFなどの画像ファイルをアップロードします
- 「アイテムを追加」をクリックして保存します
自動生成されるマニフェストの確認
アイテムが保存されると、IIIF Toolkitが自動的にマニフェストを生成します。マニフェストのURLは以下の形式になります:
ブラウザでこのURLにアクセスすると、JSON-LD形式のマニフェストが表示されます。
外部IIIFマニフェストのインポート
IIIF Toolkitは、他機関が公開しているIIIFマニフェストをインポートする機能も持っています。
マニフェストURLによるインポート
- 管理画面の「IIIF Toolkit」メニューから「Import」を選択します
- インポート元のIIIFマニフェストURLを入力します
- インポートオプション(メタデータの取り込み設定など)を指定します
- 「Import」をクリックしてインポートを実行します
例えば、国立国会図書館デジタルコレクションや、CURLNIIIFなどの機関が公開するマニフェストを取り込むことができます。
一括登録
大量のデータを登録する場合は、PythonスクリプトとOmeka ClassicのAPIを使用した一括登録が有効です。
import requests
import json
# Omeka Classic API設定
API_URL = "https://your-domain.example.com/api"
API_KEY = "your_api_key"
# アイテムの作成
item_data = {
"item_type": {"id": 6},
"element_texts": [
{
"html": False,
"text": "サンプル画像",
"element": {"id": 50} # Title
}
]
}
headers = {"Content-Type": "application/json"}
params = {"key": API_KEY}
response = requests.post(
f"{API_URL}/items",
data=json.dumps(item_data),
headers=headers,
params=params
)
item_id = response.json()["id"]
print(f"アイテムID: {item_id}")
一括登録のより詳細な方法については、関連記事を参照してください。
Miradorビューアでの閲覧
IIIF Toolkitを有効にすると、アイテムの詳細ページにMiradorビューアが自動的に埋め込まれます。Miradorは以下の機能を提供します:
- ズーム・パン: 高解像度画像の拡大・縮小・移動
- 複数画像の並列表示: 比較研究に有用な並列ビュー
- メタデータの表示: マニフェストに含まれるメタデータの閲覧
- アノテーションの表示: 次章で解説するアノテーションの可視化
Miradorの基本操作
Miradorビューア上での主な操作方法:
- 画像の拡大: マウスホイールまたは「+」ボタンで拡大
- 画像の移動: ドラッグで画像をパン
- ページ切り替え: サムネイルパネルまたは矢印ボタンで前後のページに移動
- 全画面表示: 全画面ボタンをクリック
- 情報パネル: マニフェストのメタデータや構造情報を確認
コレクション単位でのマニフェスト管理
IIIF Toolkitでは、Omeka Classicのコレクション機能と連携し、複数のマニフェストをまとめて管理できます。IIIF Collectionとして、関連するマニフェストをグループ化することが可能です。
{
"@context": "http://iiif.io/api/presentation/2/context.json",
"@type": "sc:Collection",
"@id": "https://example.com/api/iiif-items/collection/1",
"label": "コレクション名",
"manifests": [
{
"@id": "https://example.com/api/iiif-items/manifest/1",
"@type": "sc:Manifest",
"label": "マニフェスト1"
}
]
}
まとめ
本章では、IIIF Toolkitを使ったIIIFマニフェストの登録方法を解説しました。画像のアップロードによる自動生成、外部マニフェストのインポート、一括登録の方法を紹介し、Miradorビューアでの閲覧方法についても触れました。次章では、このビューア上でアノテーションを付与する方法を解説します。