CODH の vdiff.js を Wayback Machine から復元してデジタル源氏物語の「パタパタ顔比較」を一時復旧する
ROIS-DS 人文学オープンデータ共同利用センター (CODH) のホームページが長期メンテナンス中（2026年2月16日夕方よりサービス停止、再開時期未定）で、デジタル源氏物語の「パタパタ顔比較」（CODH の vdiff.js を呼び出していた）が動かなくなっていたため、Wayback Machine から vdiff.js の配布物を取り出して自サイト側に暫定ミラーを置いた手順をまとめます。あくまで CODH のサービス再開までの暫定対応です。
codhvdiffwayback-machinearchivemirror
台本(フルテキスト)
動画の掛け合いを書き起こしたものです。音声を再生しづらい場合はこちらをお読みください。
オープニング
- CODHのサービス停止でvdiff.jsが使えなくなった
- Wayback Machineから取り出して暫定ミラーを設置
- ずんだもん
- こんにちは。今日はCODHのツールをWayback Machineから復元して暫定ミラーを置いた手順を紹介します。
- めたん
- CODHというのはどんな組織ですか？
- ずんだもん
- ROIS-DS人文学オープンデータ共同利用センターの略で、IIIF Curation Viewerやvdiffなどデジタル人文学向けのツール群を公開してきた研究機関です。
- めたん
- どんな問題が起きたのですか？
- ずんだもん
- CODHのサイトが2026年2月から長期メンテナンスで停止しています。デジタル源氏物語の「パタパタ顔比較」機能がvdiff.jsを直接呼び出していたため、この機能が使えなくなってしまいました。
全体方針
- Wayback Machineのid_フラグで生バイトを取得
- wombat注入を避けて正常に動作させる
- めたん
- Wayback Machineからどうやってファイルを取るのですか？
- ずんだもん
- 通常のWayback Machine URLでアクセスすると、JavaScriptにwombatというリライト用のシムが注入されます。自サイトに置き直した環境では動作しなくなることがあります。
- めたん
- それを避けるにはどうするのですか？
- ずんだもん
- URLにid_フラグを追加します。これにより一切のリライトを行わず原本バイトをそのまま返してくれます。また--compressedオプションでgzip圧縮を自動展開します。
- めたん
- スナップショットの時点を選ぶにはどうするのですか？
- ずんだもん
- CDX APIというURLでアーカイブの一覧を取得できます。これで適切な時点のスナップショットを選べます。
アセット取得と配置
- vdiff.jsは HTML1+JS/CSS4+OpenCVの6ファイル構成
- レート制限対策として1〜3秒のスリープを入れる
- めたん
- vdiff.jsはどんなファイル構成なのですか？
- ずんだもん
- HTMLが1ファイル、JS/CSSが4ファイル、OpenCVが1ファイルの計6ファイルです。OpenCVは約7.3MBあります。
- めたん
- 一括ダウンロードするときの注意点はありますか？
- ずんだもん
- Wayback Machineのレート制限に当たることがあります。リクエスト間に1〜3秒のスリープを入れ、失敗したものは別に集めて再試行するのが良いです。
- めたん
- ダウンロードしたら配置してリンクを書き換えるのですね。
- ずんだもん
- はい。ダウンロードしたディレクトリを配信ディレクトリに置けば/vdiff/で配信されます。サイト側のリンクをCODHのURLから/vdiff/に書き換えます。
ライセンスと出典表示
- vdiff.jsはMITライセンス (Jun HOMMA氏)
- 再配布時は著作権表示を維持する
- めたん
- ライセンスの面で注意することはありますか？
- ずんだもん
- vdiff.jsはMITライセンスで公開されており、再配布時は著作権表示を維持する必要があります。ファイル先頭のコメントにある著作権表示をそのまま残しています。
- めたん
- 何か注記を残しておくべきでしょうか？
- ずんだもん
- はい。自サイト側の説明文に「CODHのvdiff.jsをサービス再開までの暫定ミラーとして配信しています」という注記を残しておくのが誠実だと思います。
まとめ
- id_フラグでwombat注入なしの生バイトを取得
- 再開後は速やかに本家URLに戻す予定
- めたん
- 今日の内容を整理してください。
- ずんだもん
- CODHのvdiff.jsをWayback Machineのid_フラグで生バイトとして取得し、自サイトに暫定ミラーを置いた手順を紹介しました。
- めたん
- MITライセンスなので再配布できるのですね。
- ずんだもん
- はい。ただし著作権表示の維持が条件です。CODHのサービス再開後は速やかに各リンクを本家に戻し、ミラーは順次撤去する予定です。ありがとうございました。