Mirador (4.0.0) の Annotations タブに OCR が出ない — supplementing motivation の落とし穴
本記事は生成AIと共同で執筆しています。事実関係は可能な範囲で公式ドキュメント等と照合していますが、誤りが含まれている可能性があります。重要な判断を行う前にご自身でも一次情報をご確認ください。 TL;DR IIIF Presentation 3 のアーカイブで OCR テキストをアノテーションとして配信したら、Annona など他の viewer では出るのに Mirador 4.0.0 (projectmirador.org/embed) の Annotations タブだけ空、という現象に遭遇した 原因は Mirador 4.0.0 リリース版 の config.annotations.filteredMotivations のデフォルト値が ['oa:commenting', 'oa:tagging', 'sc:painting', 'commenting', 'tagging'] で、supplementing を許可していないため Mirador master ブランチでは filteredMotivations: [] (フィルタ無し) に変更されているが、本記事執筆時点でリリースされていない。リリース版では引き続き上記フィルタが効く motivation を ["commenting", "supplementing"] 配列にすれば、commenting で Mirador 4.0.0 のフィルタを通過しつつ、supplementing も維持して spec 準拠 viewer や text-overlay プラグインから transcription として認識される IIIF Presentation 3 仕様 §3.5「Values for motivation」が定義するのは painting と supplementing のみ。他の値 (commenting / tagging 等) は Web Annotation Data Model 由来。配列形式の許容根拠は IIIF §4.3 (Properties with Multiple Values) と Web Annotation §3.3.5 painting を一緒に指定するのは避ける。各 canvas には既に画像の painting annotation があり、同じ canvas に複数の painting annotation が並ぶと viewer の挙動が実装依存になる 何が起きたか 平賀譲デジタルアーカイブ の API 拡張作業で、コマごとの OCR テキストを IIIF Annotation として配信するエンドポイントを足しました。マニフェストの canvas に annotations 参照を入れて、別 URL で AnnotationPage を返す Presentation 3 の標準構成です。 ...