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