はじめに

本章では、前章までに構築した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マニフェストが生成されます。

  1. 管理画面の「アイテム」>「アイテムの追加」をクリックします
  2. Dublin Coreメタデータ(タイトル、説明など)を入力します
  3. 「ファイル」タブでJPEGやTIFFなどの画像ファイルをアップロードします
  4. 「アイテムを追加」をクリックして保存します

自動生成されるマニフェストの確認

アイテムが保存されると、IIIF Toolkitが自動的にマニフェストを生成します。マニフェストのURLは以下の形式になります:

https://your-domain.example.com/api/iiif-items/manifest/{item_id}

ブラウザでこのURLにアクセスすると、JSON-LD形式のマニフェストが表示されます。

外部IIIFマニフェストのインポート

IIIF Toolkitは、他機関が公開しているIIIFマニフェストをインポートする機能も持っています。

マニフェストURLによるインポート

  1. 管理画面の「IIIF Toolkit」メニューから「Import」を選択します
  2. インポート元のIIIFマニフェストURLを入力します
  3. インポートオプション(メタデータの取り込み設定など)を指定します
  4. 「Import」をクリックしてインポートを実行します

例えば、国立国会図書館デジタルコレクションや、CURLNIIIFなどの機関が公開するマニフェストを取り込むことができます。

#https://www.dl.ndl.go.jp/api/iiif/1234567/manifest.json

一括登録

大量のデータを登録する場合は、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ビューア上での主な操作方法:

  1. 画像の拡大: マウスホイールまたは「+」ボタンで拡大
  2. 画像の移動: ドラッグで画像をパン
  3. ページ切り替え: サムネイルパネルまたは矢印ボタンで前後のページに移動
  4. 全画面表示: 全画面ボタンをクリック
  5. 情報パネル: マニフェストのメタデータや構造情報を確認

コレクション単位でのマニフェスト管理

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ビューアでの閲覧方法についても触れました。次章では、このビューア上でアノテーションを付与する方法を解説します。

関連記事