入力漏れを防ぐ!EPUB Metadata、言語・バージョンと出力表記

EPUBの書誌入力では、画面に保存された値と、配布ファイルに実際に収録された値を分けて確認します。epub metadataの点検表には、言語、版、発行日、タイトル、出版社について、入力値とOPF内の読取値を別々に置きます。項目を一列にまとめると、「設定済み」が「出力済み」に読み替わるからです。

言語は確認でき、版2.59はOPFで確認できなかった

6章の合成原稿に言語ja、版2.59、発行日2026-09-06を設定しました。作品情報の応答は版2.59を保持しています。生成物はvalid=true、spine9、nav6、NCX6で、OPFからタイトル、言語、出版社を読み戻せました。一方、今回調べたcontent.opfには文字列2.59が見つからず、発行日も同じ検索では確認できませんでした。

この結果で「版もOPFへ出力された」と書くのは誤りです。設定応答だけを見て納品すると、下流工程が必要とする書誌項目の欠落を見逃します。回復は、保存したvolume set応答とOPFを対照し、版をどの要素へ収録する仕様か製品資料または実装で確かめてから再出力することです。

今回の合格範囲は、ja、タイトル、出版社の一致と、6章分のナビゲーション、ローカル構造検査の成功です。版2.59と発行日のOPF収録は未合格として残します。販売先の受理や全端末の表示も、この検査結果には含みません。

版情報が必要な相手を先に決める

版2.59が作品設定に残ることと、EPUBの標準メタデータへ収録されることは同義ではありません。校正チームが版をファイル名で管理するのか、OPF内の値を読むのか、販売先へ渡すのかを先に決めます。必要な届け先がOPFなら、文字列検索で見つからなかった今回の出力は保留です。設定応答の成功だけで受け入れません。

再確認では版だけを2.60へ変え、二つの生成物のOPFと全ファイル名を比較します。差が現れる場所を製品仕様と照合し、意図した表現なら受入項目へ追加します。日付も同じ方法で別試行にし、二値を同時変更して差分の原因を曖昧にしません。

言語・版・日付を独立に変える三試行

最初の試行では言語だけをjaから別値へ変え、OPFの差を調べます。次に版だけを2.59から2.60へ、最後に日付だけを一日進めます。三冊を別名で保存すると、どの入力がどの出力差を生むかを一つずつ特定できます。

言語はOPFで確認できたため、同じ方法で再現できます。版と日付は今回の文字列検索で見つからなかったので、差分が現れなければ製品がどこへ保持するかを資料または実装で調べます。見つからない状態を「省略してよい」と勝手に解釈しません。

引き渡し先が必要とする項目だけを受入条件にします。販売先が版を求めない場合でも、制作チームの識別に使うならファイル名や台帳で確実に渡します。OPFへの収録と運用上の伝達を混同しないことが要点です。

追加実測で「版」の居場所を狭めた

新しい合成原稿に言語ja、版2.59、発行日2026-09-03を入れ、Rune 1.4.0 build 23で固定時刻出力しました。volume listの再読込とepub exportの応答はどちらも版2.59を返し、解凍したOPFには言語jaが1件、発行日が2件ありました。一方、OPF内の文字列2.59は0件です。

この結果により、言語は「設定→OPF」、版は「設定→保存状態→出力応答」までを合格にします。版がOPFに収録されるとは書きません。生成EPUBのSHA-256はe81a3e8f5bec75c87940d34c8018a33b651830a368ee758680242677a651141cで、検査はvalid=trueです。

納品先が版をどこから読むかを決める

制作チームが版をRuneの作品状態で管理するのか、出力応答を保存するのか、ファイル名や別台帳で渡すのかを先に選びます。OPF内の版文字を必須とする相手なら、この実測EPUBは不合格です。設定画面の成功表示で代替しません。

次回の差分試験は版だけを2.60へ変え、固定時刻で別EPUBを生成します。OPF、奥付、ファイル名、出力JSONを順に比較し、差の出た層だけを版の受け渡し先にします。全リーダー表示や販売先受理は未実測です。

言語と版の収録先を別担当へ渡す最終票

最終票の一行目にSTUDIO-259の入力パスとSHA-256、二行目に実行した画面名または命令、三行目に保存後の再読込値を記録します。このテーマで必要な比較列は「volume再読込、export応答、OPFのja、2.59の0件」です。どの値が入力、保存、生成物、表示のどの層に属するかを空欄にせず書きます。

版引渡しが不合格のときは、返り先をその層に限定します。入力なら読み込み複製、保存なら別名の復旧ファイル、生成なら新しいEPUB、表示ならReader名付きの再試験です。失敗したファイルを上書きせず、復旧結果に別SHAを付けることで、修正者と査読者が同じ差分を見られます。

この最終票の判定原則は「設定保持とOPF収録の合格欄を分ける」ことです。ローカルの構造検査が合格しても、販売先受理、全Readerの同一表示、未操作のUIは別の未検証欄に残します。次の担当者が一枚の票から実測済みと未実測を読み分けられることが完了条件です。