文字コードの検査と画像リンクの検査がそれぞれ通っても、同じ本文を調べた証拠がなければ「修正済みの一冊」とは判断できません。epub データ 編集で最初に確認するのは、二つの検査結果が同じ章版を指しているかです。つながりが証明できないときは出力を止め、文字コピーと選択章の関係を作り直します。
STUDIO-378の固定証拠は、その停止判断をよく示しています。別名のUTF-8コピーは単独で再読込でき、生成EPUBの画像参照も欠けていません。しかし、コピーの本文と、EPUBへ選択された三章の本文は別物でした。この記事では、成功した二つの検査を無理に一冊へ結び付けず、出力前に証拠の切れ目を見つける方法を説明します。
最初に問うのは、二つの証拠が同じ本文か
受付時に作るべきものは「文字の合格票」と「画像の合格票」だけではありません。両票の間に、同じ章ファイル、同じ版、同じ本文を指す結合欄が必要です。文字票にあるコピーのSHAと、画像票にある章のSHAが違うこと自体は問題ではありません。役割の違うファイルならSHAは当然変わります。問題は、どの操作でコピーの本文が選択章へ反映されたかを説明できないことです。
たとえば、文字検査用の短文だけを別名保存し、別途用意したデモ章からEPUBを作ったとします。両方の検査が緑でも、デモ章がその短文を含まなければ、文字修正がEPUBへ届いたとは言えません。この段階で見るのは文字数の一致ではなく、本文の由来です。
出力前の問いは一つです。「再読込したUTF-8コピーのどの部分が、選択したどの章に入っているか」。答えがパス、SHA、または照合した文字列で示せなければ、状態は未接続です。
固定標本を開くと接続が切れている
保存されたapproved-utf8-content.txtには、STUDIO-378 章頭 漢字 カタカナ ABC 123で始まり、STUDIO-378 章尾で終わる三行の短文があります。STUDIO-378-converted-copy.txtはこれと同じSHA 1c0bfec9…d293cです。ここまでは、別名コピーが承認用短文と一致した証拠です。
一方、選択されたchapter-01.mdからchapter-03.mdには、CASE-START-1 STUDIO-378 dedicated sample.のような英語の固有標本が入っています。生成されたp001.xhtmlからp003.xhtmlにも、この固有標本が収録されています。承認用短文は、選択章にも生成XHTMLにも現れません。
したがって、この固定証拠から確認できるのは「文字コピーが単独で読めたこと」と「別本文の三章EPUBが生成されたこと」です。文字コピーを三章へ採用したこと、同一本文が一冊へ流れたこと、修正後の代表文が一致したことは確認できません。この違いを隠さず記録することが、誤った出力合格を防ぎます。
文字側は44文字の独立試験として扱う
文字側ではrune inspect text --fileの保存済み記録を読みます。UTF-8とShift_JISはどちらもLF・44文字、UTF-16LEはLF・45文字でした。変換不能候補はいずれも0件です。44と45という値は固定標本の観測値であり、一般の原稿に期待する文字数ではありません。
別名コピーはUTF-8、LF、44文字で再読込され、approved-utf8-content.txtとは復号本文が一致しています。これは「この短文をUTF-8として保存し直せた」という単独の合格です。選択章との関係は別項目にし、空欄をdecoded_text_equal=trueで埋めてはいけません。
文字の編集で戻る場所も、この短文の範囲に限定します。符号化、改行、文字数、承認用短文との差分に問題があれば、原本を残したまま別名候補を作り直します。三章の生成結果を使って、この単独試験を合格に見せる必要はありません。
画像側は三章のパッケージとして読む
画像側の入力は三つのMarkdown章です。各章がfigure-1.pngとfigure-2.pngを参照し、生成後は章ごとに二つの画像ファイルへ展開されています。固定EPUBには本文画像資源6件、XHTMLの画像参照6件があり、相対パスを解決した欠落は0件でした。
EPUBのSHA-256はfbc91eb1036adb1a41eaea9d6f127197ae95244d9a24d1e0fbd6095714fda173です。ZIP内は17項目、navとNCXは各3、spineは6、保存済みの構造検査はvalid=trueでした。これらは三章のリンクとパッケージ構造についての実測です。
画像が6件そろったことから、文字コピーの採用までは推測できません。また、欠落0は画像の内容、解像度、alt、読書アプリでの見え方を保証しません。画像側は画像側の入力と出力だけで閉じます。
編集判断を三つの状態で記録する
二種類のデータを扱うときは、結合欄を「接続済み」「未接続」「不明」の三状態で管理すると迷いません。
- 接続済みは、再読込したコピーの文字列または由来が、実際に選択された章で確認できる状態です。
- 未接続は、両方を開いた結果、本文が別だと分かった状態です。
- 不明は、片方を開けない、比較する代表箇所が決まっていない、または版情報が欠けている状態です。
STUDIO-378の固定標本は未接続です。文字コピーの内容と三章の内容を直接読めるため、「たぶん同じ」という不明状態でもありません。この判定なら、文字検査と画像検査の実測値を捨てずに、統合成功だけを合格から外せます。
epub データ 編集の作業票には、各レーンの値とは別に、コピーから章へ渡した操作、比較した文字列、比較結果を置きます。結合欄が接続済みになるまで、配布候補のEPUB SHAは確定しません。
未接続なら出力を止めて検証標本を作り直す
回復では、現在の固定artifactを「修正済みの一冊」として上書きしません。文字コピー、三章、EPUBをそのまま保持し、新しい試行名で接続を作ります。次の手順は再試験の設計であり、今回の固定証拠で完了した操作ではありません。
- 採用するUTF-8本文のパスとSHAを決める。
- その本文を使う章ファイルを別名で作り、章のSHAを記録する。
- 採用短文の章頭・中央・章尾が章ファイルに存在するか読む。
- その章パスだけを
rune epub selectとrune epub planへ渡す。 - 出力後のXHTMLで同じ三箇所を読み、画像参照とmanifest資源も照合する。
- 本文の接続、画像参照、構造検査が同じ新EPUBを指した場合だけ候補にする。
途中で本文が消えたら、コピーから章を作る境界へ戻ります。画像参照が欠けたら、該当章のsrcと資源名へ戻ります。新しいEPUBを生成しただけで、接続済みに変えないことが大切です。
今回の結論は合格ではなく停止理由
今回の証拠で安全に言える結論は、文字コピーと画像パッケージがそれぞれ検査済みでも、同じ本文へ接続していないため統合修正は未証明、ということです。固定EPUBは三章・画像6件・欠落0の構造標本として利用できますが、承認用UTF-8短文が通った完成本としては扱えません。
画面上の赤い警告、自動保存の停止、未保存バッファ、IME入力、読書アプリの表示、KDP受理は今回未実測です。公開資料に機能説明があっても、固定artifactの実操作と混ぜません。
二つの合格票を増やすより、間の一本を確かめる方が重要です。コピーと選択章が別本文だと分かった時点で止められれば、誤った「修正済み」を出力へ持ち込まずに済みます。次の試行では、接続を作った新しい章と新しいEPUBを別証拠として残してください。