DTS Viewerの開発とデジタル源氏物語プロジェクトにおける応用

DTS Viewerの開発とデジタル源氏物語プロジェクトにおける応用の過程をまとめています。

校異源氏物語テキストDBに対するDTS（Distributed Text Services） API

はじめに本章では、校異源氏物語テキストDBで公開しているTEI/XMLファイルに対するDTS（Distributed Text Services）APIの設計と実装について解説します。DTSは、構造化されたテキストコレクションへの統一的なアクセス手段を提供するAPI仕様であり、TEI/XMLで符号化されたテキストの配信に特に適しています。 DTS（Distributed Text Services）とは DTSは、デジタル・ヒューマニティーズの分野で策定されたテキスト配信のためのAPI仕様です。古典テキストの配信規格として広く用いられてきたCTS（Canonical Text Services）を発展させたもので、以下の3つのエンドポイントから構成されます。 3つのエンドポイント Collection エンドポイント (/collection): テキストのコレクション情報を提供します。階層構造を持つコレクションの一覧やメタデータを返却します。 Navigation エンドポイント (/navigation): テキストの内部構造（巻、章、段落など）の情報を提供します。テキストのどの部分をどのように参照できるかを示します。 Document エンドポイント (/document): テキスト本体を取得するためのエンドポイントです。特定の範囲を指定してTEI/XMLのテキストデータを返却します。 CTSとの関係 DTSは、CTSの概念を継承しつつ、JSON-LDやLinked Dataの仕組みを取り入れた現代的なAPI仕様です。CTSがXML-RPCベースのプロトコルだったのに対し、DTSはRESTful APIとしてWebの標準的なアーキテクチャに沿った設計になっています。CTSで使われていたURNベースのテキスト参照体系もDTSでサポートされています。校異源氏物語テキストDBの構造校異源氏物語テキストDBは、源氏物語の校異（テキストの異同）をTEI/XMLで符号化したデータベースです。 TEI/XMLファイルの構造校異源氏物語のTEI/XMLファイルは、TEI Critical Apparatusの仕様に基づいてマークアップされています。 <TEI xmlns="http://www.tei-c.org/ns/1.0"> <teiHeader> <fileDesc> <titleStmt> <title>校異源氏物語桐壺</title> </titleStmt> </fileDesc> </teiHeader> <text> <body> <div n="1" type="巻"> <div n="1" type="章段"> <p> <app> <lem wit="#大島本">いづれの御時にか</lem> <rdg wit="#河内本">いづれの御ときにか</rdg> </app> </p> </div> </div> </body> </text> </TEI> <app>要素が校異情報を、<lem>が底本の読みを、<rdg>が異本の読みをそれぞれ示しています。コレクション構造校異源氏物語は全54帖（巻）から構成されており、DTS APIにおけるコレクション階層は以下のようになります：校 ├ ├ ├ ├ └ 異 ─ ─ ─ ─ ─ 源 ─ ─ ─ ─ ─ 氏物桐帚空夢語壺木蝉浮（橋ルートコレクション） DTS APIの実装技術スタック DTS APIは以下の技術スタックで実装しています： ...

DTSビューアの開発

はじめに本章では、前章で構築したDTS APIを利用するビューア「DTS Viewer」の開発について解説します。DTS Viewerは、DTSのエンドポイントにアクセスしてテキストコレクションのブラウジング、TEI/XMLテキストのレンダリング、およびIIIF画像の統合表示を実現するWebアプリケーションです。 DTS Viewerの概要 DTS Viewerは、以下の機能を持つWebアプリケーションです：コレクションブラウジング: DTS Collection APIを通じて、テキストコレクションの階層構造をナビゲーションテキスト表示: DTS Document APIから取得したTEI/XMLをブラウザ上でレンダリングページネーション: DTS Navigation APIを使った巻・章段単位のページ送り IIIF画像統合: テキストに関連するIIIF画像の並列表示技術スタック DTS Viewerは以下の技術で構築しています：フレームワーク: Next.js（React） TEIレンダリング: CETEIcean IIIF画像表示: Mirador / OpenSeadragon スタイリング: CSS Modules デプロイ: Vercel プロジェクトの構成 d ├ │ │ │ │ │ ├ │ │ │ │ │ ├ │ ├ │ ├ └ t ─ ─ ─ ─ ─ ─ s ─ ─ ─ ─ ─ ─ - v p ├ ├ │ └ c ├ ├ ├ ├ └ l └ s └ n p i a ─ ─ ─ o ─ ─ ─ ─ ─ i ─ t ─ e a e g ─ ─ ─ m ─ ─ ─ ─ ─ b ─ y ─ x c w e p / l t k e s i c └ d └ o C N T I P d e t . a r n o ─ o ─ n o a E I a t s e c g d l ─ c ─ e l v I I g s i o e e l u n l i V F i . . n . x e [ m [ t e g i V n j c f j . c i e i s c a e i a s s i s j t d n d / t t w e t s g o s i ] t ] i i e w i . n o . / . o o r e o j n j j n n . r n s / s s L . j . . i j s j j s s s s t . j s # # # # # # # # # # ココテ D T レレキコナ T I ペ T E ククスレビ E I ー S I シシトクゲ I I ジ要ョョ表シーテ F ネ A 素ンン示ョシキ画ー P の一詳ンョス像シ I ス覧細一ント表ョクタ覧コ表示ンライコン示イルンポアポーンーネトネンントト DTS APIクライアントの実装 DTS APIとの通信を行うクライアントモジュールを作成します。 ...

校異源氏物語テキストDBのDTS API・DTSビューアおよび校異源氏物語テキストDBの更新

はじめに本章では、校異源氏物語テキストDBのDTS APIとDTSビューアに対して行った更新・改善について解説します。初期実装からの発展として、dts:wrapperの導入、JSON-LDへの対応強化、CTSとの互換性維持、そしてテキストDB自体の拡充について述べます。 DTS APIの更新 dts:wrapperの導入 DTS仕様では、Documentエンドポイントが返却するTEI/XMLをラップするためのdts:wrapper要素が定義されています。これにより、テキスト本体に加えてメタデータやナビゲーション情報を同時に返却することが可能になります。 <dts:wrapper xmlns:dts="https://w3id.org/dts/api#" xmlns:tei="http://www.tei-c.org/ns/1.0"> <dts:metadata> <dts:id>kiritsubo</dts:id> <dts:title>桐壺</dts:title> <dts:parent>genji-collection</dts:parent> </dts:metadata> <dts:content> <tei:TEI>  </tei:TEI> </dts:content> <dts:navigation> <dts:prev></dts:prev> <dts:next></dts:next> </dts:navigation> </dts:wrapper> dts:wrapperの実装 Documentエンドポイントでのdts:wrapperの実装例を示します。 // api/dts/document.js（更新版） app.get('/api/dts/document', async (req, res) => { const { id, ref } = req.query; const format = req.query.format || 'xml'; const teiContent = await loadTEIFile(id, ref); const navigation = await getNavigationContext(id, ref); if (format === 'wrapper') { // dts:wrapperで包んで返却 const wrapped = `<?xml version="1.0" encoding="UTF-8"?> <dts:wrapper xmlns:dts="https://w3id.org/dts/api#"> <dts:metadata> <dts:id>${id}</dts:id> <dts:ref>${ref || ''}</dts:ref> </dts:metadata> <dts:content> ${teiContent} </dts:content> <dts:navigation> ${navigation.prev ? `<dts:prev ref="${navigation.prev}"/>` : ''} ${navigation.next ? `<dts:next ref="${navigation.next}"/>` : ''} </dts:navigation> </dts:wrapper>`; res.set('Content-Type', 'application/xml'); return res.send(wrapped); } // 通常のTEI/XMLを返却 res.set('Content-Type', 'application/xml'); return res.send(teiContent); }); dts:wrapperの検索システムへの応用 dts:wrapperは、検索システムの構築においても有用です。テキスト本体と構造情報を一体的に取得できるため、検索インデックスの作成時にメタデータを保持したままテキストを処理できます。 ...

目次#

目次