Omeka Sの使い方

Omeka Sは、デジタルコレクションを管理・公開するためのオープンソースのウェブアプリケーションです。本章では、Omeka Sのインストール方法について、Docker環境を利用した方法と手動インストールの2つの方法を解説します。 システム要件 Omeka Sを動作させるためには、以下の環境が必要です。 Linux（Ubuntu 20.04以降を推奨） Apache（mod_rewriteが有効であること） MySQL 5.7.9以降 または MariaDB 10.2.6以降 PHP 7.4以降（8.0以降を推奨） PHP拡張モジュール: PDO、pdo_mysql、xml、mbstring、intl、fileinfo、gd または imagick また、画像のサムネイル生成のために ImageMagick が必要です。さくらレンタルサーバなどの環境では、ImageMagickのパスを明示的に指定する必要がある場合があります。 Dockerを使ったインストール（推奨） Dockerを使用すると、環境構築が容易になり、再現性の高いインストールが可能です。詳細については、Omeka S Docker の紹介：デジタルコレクションのための最新かつセキュアなソリューションを参照してください。 docker-compose.ymlの準備 以下は、Omeka Sを動作させるためのdocker-compose.ymlの基本的な例です。 version: '3' services: omeka-s: image: ghcr.io/nakamura196/omeka-s-docker:latest ports: - "80:80" volumes: - omeka-files:/var/www/html/files - omeka-modules:/var/www/html/modules - omeka-themes:/var/www/html/themes environment: OMEKA_DB_HOST: mariadb OMEKA_DB_NAME: omeka OMEKA_DB_USER: omeka OMEKA_DB_PASSWORD: omeka depends_on: - mariadb mariadb: image: mariadb:10.11 volumes: - db-data:/var/lib/mysql environment: MYSQL_ROOT_PASSWORD: rootpassword MYSQL_DATABASE: omeka MYSQL_USER: omeka MYSQL_PASSWORD: omeka volumes: omeka-files: omeka-modules: omeka-themes: db-data: 起動手順 # docker-compose.ymlのあるディレクトリで実行 docker-compose up -d # ログの確認 docker-compose logs -f omeka-s 起動後、ブラウザで http://localhost にアクセスすると、Omeka Sの初期設定画面が表示されます。 ...

Omeka Sでは、一つのインストールの中で複数の「サイト」を作成できます。各サイトは、独自のテーマ、ナビゲーション、ページを持つことができ、同じリソース（アイテム）を異なるサイトで共有して公開することが可能です。本章では、サイトの作成と管理について解説します。 サイトの作成 管理画面の左メニューから「サイト」を選択し、「新しいサイトを追加」ボタンをクリックします。 基本設定 サイト作成時に設定する主な項目は以下の通りです。 項目 説明 タイトル サイトのタイトル。ブラウザのタイトルバーやサイトのヘッダーに表示される スラグ URLの一部となる英数字の識別子（例：my-collection） サマリー サイトの概要説明 テーマ サイトのデザインテーマを選択 リソースプールの設定 サイトに表示するアイテムを制御するために、「リソース」タブでアイテムセットを割り当てます。割り当てられたアイテムセットに含まれるアイテムがサイト上で閲覧可能になります。 なお、アイテムの新規登録時に各サイトへ自動的に追加する設定も可能です。詳しくは、アイテムの新規登録における各サイトへの自動追加の設定についてを参照してください。 ページの作成 サイト内のコンテンツは「ページ」として作成します。ページは、さまざまな「ページブロック」を組み合わせて構成されます。 ページブロックの種類 Omeka Sには、以下のような標準的なページブロックが用意されています。 HTMLブロック 任意のHTML内容を入力できるブロックです。テキストの説明文やカスタムHTMLを記述できます。WYSIWYGエディタが利用でき、見出しや太字、リストなどの基本的な書式設定が可能です。 <h2>コレクションの概要</h2> <p>本コレクションは、江戸時代の浮世絵を中心に構成されています。</p> アイテムショーケース 選択したアイテムをサムネイル画像とともに表示するブロックです。特集コンテンツの紹介や、ハイライトとして特定のアイテムを強調表示するのに適しています。 メディアの埋め込み メディアファイル（画像、動画、音声）を直接ページに埋め込むブロックです。 アイテムの閲覧 指定した条件に一致するアイテムのリストを表示するブロックです。アイテムセットやプロパティの値による絞り込みが可能です。 目次ブロック サイト内のページへのリンクリストを表示するブロックです。サイト内のナビゲーション補助として利用できます。 行区切り ブロック間に水平線を挿入し、視覚的な区切りを追加します。 モジュールによる追加ブロック モジュールをインストールすることで、追加のページブロックが利用可能になります。 Mappingモジュール：地図ブロックを追加し、位置情報を含むアイテムを地図上に表示 Timelineモジュール：タイムラインブロックを追加し、日付情報を持つアイテムを時系列で表示 IIIF Viewersモジュール：IIIFビューアブロックを追加し、画像の高解像度表示が可能 ナビゲーション サイトのナビゲーションメニューは、管理画面のサイト設定の「ナビゲーション」タブで管理します。 ナビゲーションリンクの種類 種類 説明 ページ サイト内のページへのリンク URL 外部URLへのリンク アイテムの閲覧 アイテム一覧ページへのリンク アイテムセットの閲覧 アイテムセット一覧ページへのリンク 階層構造 ナビゲーション項目はドラッグ&ドロップで並べ替えが可能です。また、項目を別の項目の下にドラッグすることで、ドロップダウンメニュー形式の階層構造を作成できます。 ホ コ に お ー レ つ 問 ム ク ├ ├ └ い い シ ─ ─ ─ て 合 ョ ─ ─ ─ わ ン せ 浮 写 地 世 真 図 絵 コ コ コ レ レ レ ク ク ク シ シ シ ョ ョ ョ ン ン ン テーマの選択と設定 各サイトには個別にテーマを設定できます。管理画面のサイト設定の「テーマ」タブから、インストール済みのテーマを選択します。 ...

Omeka Sでは、デジタルコレクションを構成するデータを「リソース」として管理します。リソースには主に「アイテム」「アイテムセット」「メディア」の3種類があり、それぞれにメタデータを付与して管理します。本章では、リソースの基本概念と操作方法について解説します。 リソースの種類 アイテム（Items） アイテムは、Omeka Sにおけるデータの基本単位です。一つのアイテムは、一つのデジタルオブジェクト（文書、画像、音声、動画など）を表します。各アイテムには、メタデータとメディアファイルを関連付けることができます。 詳しくは、リソース > アイテムを参照してください。 アイテムセット（Item Sets） アイテムセットは、関連するアイテムをグループ化するためのコンテナです。例えば、「浮世絵コレクション」や「明治期の写真」といったカテゴリでアイテムをまとめることができます。一つのアイテムは複数のアイテムセットに所属できます。 アイテムセットの階層構造を管理するには、Item Sets Treeモジュールが便利です。詳しくは、Item Sets Treeを参照してください。 メディア（Media） メディアは、アイテムに関連付けられたファイルやリンクです。一つのアイテムに複数のメディアを関連付けることが可能で、以下のような種類があります。 アップロード: ローカルファイルをサーバーにアップロード URL: 外部URLから参照 oEmbed: YouTubeなどのoEmbed対応サービスからの埋め込み IIIF画像: IIIF Image APIで提供される画像の参照 HTML: HTMLコンテンツの直接入力 IIIF画像のメディア登録については、Omeka SでIIIF画像をメディアとして登録する方法を参照してください。 ファイルサイズの制限 大きなファイルをアップロードする場合は、PHPの設定でupload_max_filesizeやpost_max_sizeの値を変更する必要があります。詳しくは、Omeka Sにサイズが大きいファイルをアップロードするを参照してください。 メタデータの入力 語彙（Vocabularies） Omeka Sでは、リンクトデータの原則に基づき、標準化された語彙（ボキャブラリー）を使用してメタデータを記述します。デフォルトで以下の語彙がインストールされています。 語彙 プレフィックス 説明 Dublin Core dcterms 汎用的なメタデータ記述の国際標準 Dublin Core Type dctype リソースの種類を表す語彙 Bibliographic Ontology bibo 書誌情報を記述するための語彙 Friend of a Friend foaf 人物や組織に関する語彙 語彙の追加 標準語彙に加えて、RDFで定義された外部の語彙をインポートすることができます。詳しくは、既存の標準語彙の追加方法を参照してください。 以下の語彙のインポート事例があります。 DC-NDL（国立国会図書館ダブリンコアメタデータ記述） ICA RiC-O PROV-O カスタムオントロジー CustomOntologyモジュールを使用すると、独自のクラスやプロパティを定義できます。詳しくは、CustomOntologyモジュールを使って、クラスやプロパティを追加するを参照してください。作成した語彙の更新方法については、Omeka Sのカスタムオントロジーを用いて作成した語彙を更新するを参照してください。 ...

Omeka Sは、モジュール（プラグイン）によって機能を拡張できます。本章では、モジュールのインストール方法と、代表的なモジュールを紹介します。IIIFに関連するモジュールについては、次章「モジュール（IIIF）」で詳しく解説します。 モジュールのインストール方法 モジュールのインストール手順は以下の通りです。詳しくは、Omeka Sモジュールのインストール方法を参照してください。 1. モジュールのダウンロード モジュールのZIPファイルをダウンロードし、Omeka Sのmodulesディレクトリに展開します。 cd /var/www/html/omeka-s/modules/ wget https://github.com/omeka/Omeka-S-module-XXX/releases/download/vX.X.X/XXX-X.X.X.zip unzip XXX-X.X.X.zip 2. 管理画面での有効化 管理画面の左メニューから「モジュール」を選択し、一覧に表示されたモジュールの「インストール」ボタンをクリックします。 モジュールの一括ダウンロード 複数のモジュールを一度にダウンロードするスクリプトも利用可能です。詳しくは、Omeka Sのモジュール一括ダウンロードスクリプトを参照してください。 モジュールのアップデート モジュールのアップデート情報については、Omeka Sのモジュールアップデート情報を参照してください。Omeka S本体のアップデートについては、Omeka Sの更新を参照してください。 データインポート系モジュール Bulk Import Bulk Importは、CSVファイルなどからメタデータとメディアを一括で登録するためのモジュールです。大量のアイテムを効率的に登録する場合に不可欠です。 詳しくは以下の記事を参照してください。 Bulk Import：CSVファイルを用いたメタデータと画像の一括登録（2023-03版） Omeka Sの一括登録用モジュール: Bulk Importの使い方（2024-02版） Bulk ImportによるCSVファイルを用いたメタデータの一括更新 Bulk Importによるリソースクラスの登録方法・設定編集ほか CSVファイルの書式例は以下の通りです。 dcterms:title,dcterms:creator,dcterms:date,dcterms:description,media_url "源氏物語絵巻","作者不詳","12世紀","平安時代の物語を描いた絵巻","https://example.com/image1.jpg" "鳥獣戯画","鳥羽僧正","12世紀","動物を擬人化して描いた絵巻","https://example.com/image2.jpg" Bulk Importの設定時には、CSVの各列とOmeka Sのプロパティとの対応（マッピング）を定義します。設定例については、Omeka SのBulkImportを使用する際の設定例を参照してください。 不具合への対応については、以下の記事を参照してください。 Bulk Importの不具合対応（ソースコードからのインストール方法を含む） Omeka SのBulkImportモジュールの不具合 Omeka S Bulk Importの不具合と改善 Bulk Export Bulk Exportモジュールは、Omeka Sのデータをさまざまな形式でエクスポートするモジュールです。 BulkExport：データの一括エクスポート BulkExport：アイテムの詳細画面にエクスポート機能を追加する BulkExportを使って、特定のアイテムの指定した項目のみをエクスポートする File Sideload File Sideloadモジュールは、サーバー上に事前にアップロードしたファイルを、管理画面からメディアとして一括登録できるモジュールです。大量の画像ファイルをアップロードする際に、ブラウザ経由のアップロードよりも高速かつ安定的に処理できます。 ...

IIIF（International Image Interoperability Framework）は、デジタル画像の共有と相互運用を実現するための国際的な枠組みです。Omeka Sでは、複数のモジュールを組み合わせることで、IIIF対応のデジタルコレクション公開環境を構築できます。本章では、IIIF関連のモジュールについて詳しく解説します。 IIIF関連モジュールの全体像 Omeka Sで利用可能な主なIIIF関連モジュールは以下の通りです。 モジュール 機能 IIIF Server IIIF Presentation APIのマニフェストを自動生成 Image Server IIIF Image APIに対応した画像配信 IIIF Viewers 複数のIIIFビューアを切り替えて表示 Mirador Miradorビューアの埋め込み IIIF Search IIIF Content Search APIの実装 IiifPresentation IIIF Presentation APIの追加機能 これらのモジュールの概要については、IIIF Server / Image Server / Universal Viewerを参照してください。また、利用可能なIIIF対応ビューアの比較については、Omeka Sで利用可能なIIIF対応ビューアを参照してください。 IIIF Serverモジュール IIIF Serverモジュールは、Omeka Sに登録されたアイテムとメディアから、IIIF Presentation API v2/v3に準拠したマニフェストを自動生成するモジュールです。 マニフェストの生成 IIIF Serverモジュールをインストールすると、各アイテムのIIIFマニフェストが自動的に生成されます。マニフェストのURLは以下の形式です。 h t t p s : / / y o u r - d o m a i n . c o m / i i i f / 3 / { i t e m _ i d } / m a n i f e s t マニフェストの出力内容については、Omeka S IIIF ServerのIIIFマニフェスト（version 2）の出力内容を参照してください。また、Presentation API v3のマニフェスト作成については、Omeka Sを用いて、IIIF Presentation API v3のマニフェストファイルを作成するを参照してください。 ...

Omeka Sでは、テーマを使ってサイトの外観をカスタマイズできます。テーマはサイトごとに異なるものを設定でき、既存のテーマを利用するだけでなく、独自のテーマを開発したりカスタマイズしたりすることも可能です。本章では、テーマの選択・カスタマイズ方法について解説します。 テーマの概要 Omeka Sのテーマは、themesディレクトリに配置されます。各テーマは、PHPテンプレートファイル、CSS、JavaScript、画像などのアセットで構成されています。 テーマの一覧を視覚的に確認できるページが用意されています。詳しくは、Omeka Sのテーマの一覧を視覚的に確認するページを作成しました。を参照してください。また、一覧ページの作成プログラムについては、Omeka Sのテーマの一覧を視覚的に確認するページを作成するプログラムを参照してください。 テーマのインストール テーマのインストール手順は、モジュールと同様に簡単です。 cd /var/www/html/omeka-s/themes/ git clone https://github.com/omeka/theme-xxx.git # または wget https://github.com/omeka/theme-xxx/releases/download/vX.X.X/theme-xxx.zip unzip theme-xxx.zip インストール後、管理画面の各サイトの「テーマ」タブから、使用するテーマを選択します。 Bootstrap 5テーマ 筆者が開発したBootstrap 5ベースのOmeka Sテーマは、レスポンシブデザインに対応し、現代的なUI/UXを提供します。 Bootstrap 5を用いたOmeka Sテーマを公開しました。 Bootstrap 5を用いたOmeka Sのテーマver 4.0.2をリリースしました。 Bootstrap 5を用いたOmeka Sテーマの不具合を修正しました。 Bootstrap 5を用いたOmeka Sテーマを更新しました。 Bootstrap 5テーマの特徴 レスポンシブデザイン: スマートフォン、タブレット、PCに対応 カスタマイズ性: Bootstrap 5のユーティリティクラスを活用 モジュール対応: Mappingモジュールなど主要なモジュールに対応 MappingモジュールへのBootstrap 5テーマの対応については、Bootstrap 5テーマのMappingモジュール一部対応を参照してください。 テーマのカスタマイズ CSSのオーバーライド テーマのデザインを微調整する最も簡単な方法は、CSSのオーバーライドです。テーマの設定画面でカスタムCSSを入力できるテーマもあります。そうでない場合は、テーマディレクトリ内のCSSファイルを直接編集します。 /* ヘッダーの背景色を変更 */ header { background-color: #2c3e50; } /* サイトタイトルのフォントサイズを調整 */ .site-title { font-size: 1.8rem; font-weight: bold; } /* アイテム一覧のサムネイルサイズを変更 */ .resource-list .thumbnail img { max-width: 150px; max-height: 150px; } テーマの多言語化 テーマの表示テキストを多言語に対応させる方法については、Omeka Sテーマの多言語化を参照してください。 ...

本章では、Omeka Sの開発者向けの情報として、REST APIの活用方法、Pythonスクリプトによる自動化、モジュール開発、MCP（Model Context Protocol）サーバーとの連携について解説します。 REST API Omeka Sは包括的なREST APIを提供しており、外部のプログラムからデータの取得・登録・更新・削除が可能です。 APIの基本 APIのエンドポイントは以下の形式です。 G G P P D E E O U E T T S T L T E T E / / / / / a a a a a p p p p p i i i i i / / / / / i i i i i t t t t t e e e e e m m m m m s s s s s / / / : : : i i i d d d # # # # # ア 特 ア ア ア イ 定 イ イ イ テ ア テ テ テ ム イ ム ム ム 一 テ の の の 覧 ム 作 更 削 の の 成 新 除 取 取 得 得 主なリソースタイプとエンドポイントは以下の通りです。 ...

Omeka Sのデータを安全に保護するためには、定期的なバックアップが不可欠です。本章では、バックアップの対象、具体的なバックアップ手順、自動化の方法、そしてサーバー移行時の手順について解説します。 バックアップの対象 Omeka Sのバックアップでは、以下の3つの要素を対象とします。 対象 内容 場所 データベース アイテム、メタデータ、ユーザー情報、サイト設定など MySQL/MariaDB ファイル アップロードされた画像・動画・PDF等のメディアファイル files/ ディレクトリ 設定ファイル database.ini、.htaccess、モジュール・テーマの設定 Omeka Sインストールディレクトリ データベースのバックアップ mysqldumpを使用したバックアップ MySQLまたはMariaDBのデータベースをバックアップするには、mysqldumpコマンドを使用します。 # データベースのバックアップ mysqldump -u omeka -p omeka_database > omeka_backup_$(date +%Y%m%d).sql # 圧縮してバックアップ mysqldump -u omeka -p omeka_database | gzip > omeka_backup_$(date +%Y%m%d).sql.gz Docker環境の場合は、コンテナ内でコマンドを実行します。 # Docker環境でのバックアップ docker exec omeka-mariadb mysqldump -u omeka -pomeka omeka_database > omeka_backup_$(date +%Y%m%d).sql データベースのリストア バックアップからデータベースをリストアする場合は、以下のコマンドを実行します。 # リストア mysql -u omeka -p omeka_database < omeka_backup_20240101.sql # 圧縮ファイルからのリストア gunzip < omeka_backup_20240101.sql.gz | mysql -u omeka -p omeka_database ファイルのバックアップ files/ディレクトリには、アップロードされたメディアファイルとそのサムネイルが格納されています。 ...