Omeka Classic + IIIF Toolkitを用いたアノテーション付与環境の構築

はじめに 本章では、Amazon Lightsailを使用してOmeka Classicをインストールする手順を解説します。Omeka Classicは、デジタルコレクションの構築・公開に広く利用されているオープンソースのWebアプリケーションです。後続の章で導入するIIIF Toolkitプラグインと組み合わせることで、IIIF対応のアノテーション付与環境を構築できます。 Amazon Lightsailの準備 Amazon Lightsailは、AWSが提供する軽量なVPS（仮想プライベートサーバ）サービスです。月額固定料金で利用でき、小規模なデジタルアーカイブ環境の構築に適しています。 インスタンスの作成 AWS Lightsail コンソールにアクセスします 「インスタンスの作成」をクリックします 以下の設定を行います： リージョン: 東京（ap-northeast-1）を推奨 プラットフォーム: Linux/Unix ブループリント: OS のみ > Ubuntu 20.04 LTS インスタンスプラン: 1GB RAM以上を推奨（$5/月〜） 静的IPの割り当て インスタンスの作成後、静的IPアドレスを割り当てます。これにより、インスタンスを再起動してもIPアドレスが変わりません。 # Lightsailコンソールの「ネットワーキング」タブから # 静的IPを作成し、インスタンスにアタッチします システム要件とパッケージのインストール Omeka Classicの動作には以下の環境が必要です： PHP: 7.4以上（8.0推奨） MySQL: 5.7以上 Apache: 2.4以上（mod_rewrite有効） ImageMagick: 画像処理用 初期設定スクリプト SSHでインスタンスに接続し、以下のコマンドを実行して必要なパッケージをインストールします。 #!/bin/bash # システムの更新 sudo apt update && sudo apt upgrade -y # Apache, PHP, MySQLのインストール sudo apt install -y apache2 mysql-server php php-mysql php-xml php-mbstring php-zip php-gd php-curl # ImageMagickのインストール sudo apt install -y imagemagick # Apache mod_rewriteの有効化 sudo a2enmod rewrite sudo systemctl restart apache2 PHPの設定 php.iniファイルを編集し、アップロード上限などを調整します。 ...

はじめに 本章では、前章で構築した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 プラグインの有効化 Omeka Classicの管理画面にログインします 上部メニューの「プラグイン」をクリックします 「IIIF Toolkit」を見つけ、「インストール」ボタンをクリックします インストールが完了したら「有効化」します 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のファイルディレクトリを参照するよう設定します。 ...

はじめに 本章では、前章までに構築した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は以下の形式になります： h t t p s : / / y o u r - d o m a i n . e x a m p l e . c o m / a p i / i i i f - i t e m s / m a n i f e s t / { i t e m _ i d } ブラウザでこのURLにアクセスすると、JSON-LD形式のマニフェストが表示されます。 ...

はじめに 本章では、Omeka Classic + IIIF Toolkit環境におけるアノテーションの付与方法を解説します。IIIF Toolkitは、SimpleAnnotationServer（SAS）と連携することで、Miradorビューア上でIIIF画像に対してアノテーションを作成・管理する機能を提供します。これにより、研究者が画像上の特定領域に対してテキストやタグを付与し、共同研究に活用することが可能になります。 アノテーションの概要 IIIF Annotationとは IIIFにおけるアノテーションは、W3C Web Annotation Data Modelに基づいた仕様で定義されています。アノテーションは、ある「ターゲット」（画像上の領域）に対して「ボディ」（テキストやタグなどの情報）を関連付けるものです。 { "@context": "http://www.w3.org/ns/anno.jsonld", "@type": "oa:Annotation", "motivation": "commenting", "resource": { "@type": "dctypes:Text", "chars": "ここに注釈テキストを記述", "format": "text/html" }, "on": { "@type": "oa:SpecificResource", "selector": { "@type": "oa:FragmentSelector", "value": "xywh=100,200,300,400" }, "full": "https://example.com/canvas/1" } } SimpleAnnotationServer（SAS） SimpleAnnotationServerは、IIIFアノテーションを保存・取得するための軽量なアノテーションサーバです。IIIF Toolkitと連携し、Miradorビューアからのアノテーション操作を受け付けます。 SimpleAnnotationServerのセットアップ インストール # Javaの確認（Cantaloupeのインストール時に導入済み） java -version # SASのダウンロード cd /opt sudo git clone https://github.com/glenrobson/SimpleAnnotationServer.git cd SimpleAnnotationServer 設定ファイルの編集 SASの設定ファイルを環境に合わせて編集します。 sudo nano /opt/SimpleAnnotationServer/src/main/webapp/WEB-INF/sas.properties # ストアの設定 store=JsonFileStore json_file_store_dir=/opt/SimpleAnnotationServer/annotations # CORS設定 cors.allowed.origins=* cors.allowed.methods=GET,POST,PUT,DELETE,OPTIONS cors.allowed.headers=Content-Type,Authorization ビルドと起動 # Mavenによるビルド cd /opt/SimpleAnnotationServer sudo mvn package # 起動 java -jar target/dependency/jetty-runner.jar --port 8888 target/simpleAnnotationServer.war systemdサービスとして登録 sudo nano /etc/systemd/system/sas.service [Unit] Description=Simple Annotation Server After=network.target [Service] Type=simple User=www-data WorkingDirectory=/opt/SimpleAnnotationServer ExecStart=/usr/bin/java -jar target/dependency/jetty-runner.jar --port 8888 target/simpleAnnotationServer.war Restart=always [Install] WantedBy=multi-user.target sudo systemctl daemon-reload sudo systemctl enable sas sudo systemctl start sas IIIF ToolkitとSASの接続設定 プラグイン設定画面での接続設定 Omeka Classicの管理画面からIIIF Toolkitの設定を開き、SimpleAnnotationServerのエンドポイントを指定します。 ...