はじめに

本章では、前章で構築したOmeka Classic環境にIIIF Toolkitプラグインをインストールする手順を解説します。IIIF Toolkitは、Omeka ClassicにIIIF（International Image Interoperability Framework）対応機能を追加するプラグインであり、画像の高解像度配信、IIIFマニフェストの生成、Miradorビューアによる画像閲覧、そしてアノテーション機能を提供します。

IIIF Toolkitプラグインの概要

IIIF Toolkitプラグインは、以下の主要機能を含む複合的なプラグインです：

  • IIIF Image API対応: Cantaloupeイメージサーバとの連携による高解像度画像の配信
  • IIIF Presentation API対応: アイテムに紐づくIIIFマニフェストの自動生成
  • Miradorビューア: IIIF対応の高機能画像ビューア
  • SimpleAnnotationServer連携: W3C Web Annotation規格に準拠したアノテーション機能

プラグインのダウンロードとインストール

IIIF Toolkitのダウンロード

# Omeka Classicのpluginsディレクトリに移動
cd /var/www/html/omeka/plugins

# IIIF Toolkitのダウンロード
sudo git clone https://github.com/utlib/IiifItems.git
sudo chown -R www-data:www-data IiifItems

プラグインの有効化

  1. Omeka Classicの管理画面にログインします
  2. 上部メニューの「プラグイン」をクリックします
  3. 「IIIF Toolkit」を見つけ、「インストール」ボタンをクリックします
  4. インストールが完了したら「有効化」します

Cantaloupeイメージサーバのセットアップ

IIIF Image APIを利用するためには、IIIFに対応したイメージサーバが必要です。ここでは、Cantaloupeを使用します。

Javaのインストール

Cantaloupeの動作にはJava 11以上が必要です。

sudo apt install -y openjdk-11-jre-headless

Cantaloupeのダウンロードと設定

# Cantaloupeのダウンロード
cd /opt
sudo wget https://github.com/cantaloupe-project/cantaloupe/releases/download/v5.0.5/cantaloupe-5.0.5.zip
sudo unzip cantaloupe-5.0.5.zip
sudo mv cantaloupe-5.0.5 cantaloupe

設定ファイルの編集

cantaloupe.propertiesファイルを編集し、Omeka Classicのファイルディレクトリを参照するよう設定します。

sudo cp /opt/cantaloupe/cantaloupe.properties.sample /opt/cantaloupe/cantaloupe.properties
sudo nano /opt/cantaloupe/cantaloupe.properties

主要な設定項目は以下の通りです：

# HTTPサーバの設定
http.enabled = true
http.host = 0.0.0.0
http.port = 8182

# 画像ソースの設定
source.static = FilesystemSource
FilesystemSource.BasicLookupStrategy.path_prefix = /var/www/html/omeka/files/original/

# キャッシュの設定
cache.server.derivative.enabled = true
cache.server.derivative = FilesystemCache
FilesystemCache.pathname = /var/cache/cantaloupe

# CORS対応
endpoint.api.enabled = true

キャッシュディレクトリの作成

sudo mkdir -p /var/cache/cantaloupe
sudo chown -R www-data:www-data /var/cache/cantaloupe

systemdサービスの登録

Cantaloupeをシステムサービスとして登録し、自動起動するようにします。

sudo nano /etc/systemd/system/cantaloupe.service

[Unit]
Description=Cantaloupe IIIF Image Server
After=network.target

[Service]
Type=simple
User=www-data
ExecStart=/usr/bin/java -Dcantaloupe.config=/opt/cantaloupe/cantaloupe.properties -jar /opt/cantaloupe/cantaloupe-5.0.5.jar
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable cantaloupe
sudo systemctl start cantaloupe

IIIF Toolkitプラグインの設定

管理画面での設定

プラグインの設定画面で以下の項目を構成します：

  1. IIIF Image Server URL: CantaloupeのベースURL（例: https://your-domain.example.com:8182/iiif/2）
  2. Mirador Viewer: 有効にするとアイテム詳細画面にMiradorビューアが埋め込まれます
  3. Simple Annotation Server: アノテーション機能の有効化設定

Apacheリバースプロキシの設定

Cantaloupeへのアクセスをリバースプロキシ経由で行う場合、Apacheに以下の設定を追加します。

sudo a2enmod proxy proxy_http
sudo nano /etc/apache2/sites-available/000-default.conf

# Cantaloupeへのリバースプロキシ設定
ProxyPass /iiif http://localhost:8182/iiif
ProxyPassReverse /iiif http://localhost:8182/iiif

# CORS対応
<Location /iiif>
    Header set Access-Control-Allow-Origin "*"
</Location>

sudo a2enmod headers
sudo systemctl restart apache2

動作確認

インストールが完了したら、以下を確認します：

  1. Cantaloupeの動作確認: https://your-domain.example.com/iiif/2 にアクセスし、Cantaloupeの管理画面が表示されることを確認
  2. プラグインの状態: 管理画面の「プラグイン」ページで、IIIF Toolkitが有効になっていることを確認
  3. テスト画像の確認: 画像をアップロードし、IIIF Image APIで配信されることを確認

まとめ

本章では、IIIF Toolkitプラグインのインストールと、Cantaloupeイメージサーバの設定を行いました。これにより、Omeka ClassicからIIIF準拠の画像配信が可能になります。次章では、IIIFマニフェストの登録方法と、Miradorビューアでの閲覧について解説します。

関連記事