はじめに

本章では、Omeka SにIIIF対応を含む各種モジュールをインストールする方法を解説します。Omeka Sは、モジュールを追加することで機能を大幅に拡張できます。特にIIIF ServerモジュールとImage Serverモジュールは、デジタルコレクションをIIIF準拠で公開するための中核的なモジュールです。

モジュールのインストール方法

Omeka Sのモジュールは、modulesディレクトリにモジュールのフォルダを配置し、管理画面から有効化するという2ステップでインストールできます。

基本的なインストール手順

# Docker環境の場合
# 1. モジュールのダウンロード
cd /tmp
wget https://github.com/example/module/releases/download/v1.0/Module.zip
unzip Module.zip

# 2. modulesディレクトリへのコピー
docker compose cp Module omeka-s:/var/www/html/modules/

# 3. パーミッションの設定
docker compose exec omeka-s chown -R www-data:www-data /var/www/html/modules/Module

その後、管理画面の「モジュール」ページで該当モジュールの「インストール」ボタンをクリックします。

一括ダウンロードスクリプト

複数のモジュールを一括でダウンロードするスクリプトを使うと効率的です。

#!/bin/bash
# モジュール一括ダウンロードスクリプト

MODULES_DIR="/var/www/html/modules"

# ダウンロードするモジュールのリスト
declare -A MODULES=(
  ["IiifServer"]="https://github.com/Daniel-KM/Omeka-S-module-IiifServer/releases/download/3.6.21/IiifServer-3.6.21.zip"
  ["ImageServer"]="https://github.com/Daniel-KM/Omeka-S-module-ImageServer/releases/download/3.6.21/ImageServer-3.6.21.zip"
  ["CSVImport"]="https://github.com/omeka-s-modules/CSVImport/releases/download/v2.6.1/CSVImport-2.6.1.zip"
  ["Mapping"]="https://github.com/omeka-s-modules/Mapping/releases/download/v2.1.1/Mapping-2.1.1.zip"
)

for name in "${!MODULES[@]}"; do
  url="${MODULES[$name]}"
  echo "Downloading ${name}..."
  wget -q "$url" -O "/tmp/${name}.zip"
  unzip -q -o "/tmp/${name}.zip" -d "$MODULES_DIR"
  rm "/tmp/${name}.zip"
  echo "${name} installed."
done

chown -R www-data:www-data "$MODULES_DIR"
echo "All modules installed."

IIIF Serverモジュール

IIIF Serverモジュールは、Omeka SにIIIF Presentation APIの機能を追加する中核モジュールです。アイテムに登録された画像から、IIIF準拠のマニフェストファイルを自動生成します。

インストール

# IIIF Serverモジュールのダウンロードと配置
cd /tmp
wget https://github.com/Daniel-KM/Omeka-S-module-IiifServer/releases/download/3.6.21/IiifServer-3.6.21.zip
unzip IiifServer-3.6.21.zip
docker compose cp IiifServer omeka-s:/var/www/html/modules/
docker compose exec omeka-s chown -R www-data:www-data /var/www/html/modules/IiifServer

主要な設定項目

管理画面の「モジュール」>「IIIF Server」>「設定」から以下の項目を構成します：

  • IIIF Presentation APIバージョン: v2またはv3を選択
  • マニフェストのデフォルトラベル: タイトルとして使用するプロパティ
  • Attribution（帰属表示）: マニフェストに含める帰属情報
  • ライセンス: デフォルトのライセンスURI
  • 表示方向: 左から右（left-to-right）または右から左（right-to-left）
##日右本開のき古の典表籍示のに場な合り、ま表す示。方向を「right-to-left」に設定すると

マニフェストURLの確認

IIIF Serverモジュールが有効になると、各アイテムに対して以下のURLでマニフェストにアクセスできます：

#h#httPtPtrprpe:e:s/s/e/e/nlnltotoacactataililohohnonossAtAtP:P:I8I800v8v82030の/の/場i場i合i合iiiff//23//{{iitteemm__iidd}}//mmaanniiffeesstt

目次情報の追加

IIIF Serverモジュールでは、メディアのメタデータを利用して目次（structures/ranges）を生成できます。各メディアのdcterms:titleに章立ての情報を入力することで、IIIFマニフェストに目次情報が含まれるようになります。

Image Serverモジュール

Image Serverモジュールは、IIIF Image APIの機能を提供し、画像の動的なタイル配信を実現します。

インストール

cd /tmp
wget https://github.com/Daniel-KM/Omeka-S-module-ImageServer/releases/download/3.6.21/ImageServer-3.6.21.zip
unzip ImageServer-3.6.21.zip
docker compose cp ImageServer omeka-s:/var/www/html/modules/
docker compose exec omeka-s chown -R www-data:www-data /var/www/html/modules/ImageServer

設定

Image Serverモジュールの主要な設定項目：

  • タイル生成方式: 動的（リクエスト時に生成）または事前生成
  • 画像処理ライブラリ: GD、ImageMagick、またはVips
  • タイルサイズ: デフォルト256px
  • 最大サイズ: 配信する画像の最大サイズ
# ImageMagickが使用可能か確認
docker compose exec omeka-s convert --version

# Vipsが使用可能か確認（推奨：高速）
docker compose exec omeka-s vips --version

CSVImportモジュール

大量のアイテムを一括登録する場合に便利なモジュールです。CSVファイルからメタデータと画像URLを読み込み、アイテムとして登録できます。

インストールと使い方

cd /tmp
wget https://github.com/omeka-s-modules/CSVImport/releases/download/v2.6.1/CSVImport-2.6.1.zip
unzip CSVImport-2.6.1.zip
docker compose cp CSVImport omeka-s:/var/www/html/modules/
docker compose exec omeka-s chown -R www-data:www-data /var/www/html/modules/CSVImport

CSVファイルの形式

dcterms:title,dcterms:description,dcterms:creator,dcterms:date,media_url
"桐壺","源氏物語第一帖","不詳","12世紀","https://example.com/images/kiritsubo.jpg"
"帚木","源氏物語第二帖","不詳","12世紀","https://example.com/images/hahakigi.jpg"

インポート手順

  1. 管理画面の「CSVインポート」をクリック
  2. CSVファイルをアップロード
  3. 各列とOmeka Sのプロパティのマッピングを設定
  4. インポートを実行

その他の推奨モジュール

IIIF Viewersモジュール

Mirador、Universal Viewer、OpenSeadragonなど、複数のIIIFビューアをOmeka Sに設置するモジュールです。

Mappingモジュール

地理情報を持つアイテムを地図上に表示するモジュールです。Leafletを使用した地図表示が可能になります。

Extract Ocrモジュール

PDFファイルに対してOCR（光学文字認識）を実行し、全文検索を可能にするモジュールです。

Numeric Data Typesモジュール

日付データに対する範囲検索を可能にするモジュールです。

Custom Vocabモジュール

プルダウンメニュー形式のカスタム語彙を作成できるモジュールです。メタデータ入力時の選択肢を制限することで、データの一貫性を保てます。

モジュールのアップデート

モジュールを更新する場合は、既存のモジュールフォルダを新しいバージョンで置き換えます。

# バックアップを取る
docker compose cp omeka-s:/var/www/html/modules/IiifServer ./IiifServer-backup

# 新しいバージョンをダウンロードして配置
cd /tmp
wget https://github.com/Daniel-KM/Omeka-S-module-IiifServer/releases/download/3.6.22/IiifServer-3.6.22.zip
unzip IiifServer-3.6.22.zip
docker compose cp IiifServer omeka-s:/var/www/html/modules/
docker compose exec omeka-s chown -R www-data:www-data /var/www/html/modules/IiifServer

管理画面の「モジュール」ページに「アップグレード」ボタンが表示されるので、クリックしてデータベースの更新を完了させます。

まとめ

本章では、Omeka Sにモジュールをインストールする方法を解説し、IIIF Server、Image Server、CSVImportを中心とした主要なモジュールの設定を紹介しました。これらのモジュールにより、Omeka SでIIIF準拠のデジタルコレクションを構築・公開する環境が整います。次章では、これらの機能を活用したキュレーションの方法を解説します。

関連記事