EPUBの表紙は、画像がパッケージ内にあるだけでは認識されません。epub coverを確かめるときは、元画像の参照、OPFのmanifestへの収録、coverとしての役割指定を分けて読みます。本文第1ページに大きな画像を置く方法と、書誌の表紙を登録する方法も同じではありません。
表紙1枚と本文画像2枚を入れたパッケージ
検証本は3章で、本文用PNGを2枚、cover用PNGを1枚指定しました。出力EPUBは画像3、spine7、nav3、NCX3を返し、ローカル検査はvalid=trueでした。予定画像数3と収録数は一致しています。表紙のハッシュとEPUB自体のハッシュも永続証拠に残しました。
一番多い失敗は、coverを本文画像として挿入し、リーダーのライブラリ表紙には出ない状態です。その場合は第1章の本文を変えず、ウィザードの表紙登録を確かめて新しいEPUBを作ります。逆に、coverが登録されているのに本文内の2枚が欠けるなら、章からの相対パスへ戻ります。
合格は、表紙元ファイルが存在し、パッケージに収録され、coverの役割がOPFで確認できる状態です。今回のvalid=trueはその合成標本の構造値であり、KDPの受理やすべての本棚表示を保証しません。
表紙の元画像・登録値・EPUB資源を一直線に結ぶ
表紙候補には、寸法、形式、ハッシュ、権利確認の識別子を付けます。作品設定で選んだパスを保存し、生成EPUBのmanifestと画像資源を読み取ります。元画像と収録画像のバイトが変換で異なる場合は、形式と寸法も含めて許容条件を決めます。画像が一件あるという数だけでは、選んだ表紙だと断定できません。
旧巻を複製したときは、古い表紙パスが残る失敗を想定します。タイトルだけ新しくても画像ハッシュが旧版なら差し戻しです。設定を直して別名出力し、表紙、目次、第1章の順を再確認します。販売先固有の寸法や容量審査はローカル構造検査とは別に扱います。
表紙・本文画像・読書順は別の欄で見る
追加検証本は2章で、表紙1枚と本文画像2枚を使いました。作品設定で表紙を登録し、章のMarkdownから二枚を参照して出力すると、検査値は画像3、spine7、nav3、NCX3、valid=trueでした。画像3は役割の内訳と一致しますが、spine7を画像数へ合わせる必要はありません。
Page 5の表紙パスを保存し直す
表紙が認識されないときは、本文の先頭へ同じ画像を貼る前に、EPUBウィザードPage 5の表紙登録を確認します。元画像を移動した後なら、古いパスを消し、新しい絶対位置を選び直して保存します。計画を再読込みし、coverImagePathが意図したファイルを指すかを見ます。
OPFでcoverの役割を確かめる
完成EPUBを展開し、画像ファイルが存在するだけでなく、OPFのmanifestで表紙として結び付いているかを確認します。一枚目の挿絵と見た目が同じでも、cover指定がなければ書店やリーダーがサムネイルへ採用する根拠になりません。表紙役と本文役を別の識別子で追います。
「画像はあるのに表紙なし」から戻る
失敗版を直接編集せず、作品設定へ戻って表紙を再指定し、新しいファイル名で出力します。旧版と新版のOPF、画像数、欠落一覧を比べれば、どの修正が効いたか分かります。本文画像のパスが正常なら、その二件は触りません。
ローカル認識と販売画面を分ける
合格は、表紙1枚と本文2枚が収録され、欠落がなく、表紙の役割がパッケージで確認でき、ローカル検査が通ることです。KDPなど販売先の受理、サムネイルの切り抜き、全リーダーの同一表示は別工程です。技術合格後に実機と販売先プレビューを確認します。
表紙の検品票には元画像SHA、選択したパス、OPF内の資源名、表紙役、寸法を並べます。差し替え時はこの一行だけを更新し、本文二画像の行を不用意に触りません。出力後に表紙役が正しくても、縦横比や文字の可読性は読書画面で別に判断します。
配信先が独自に画像を再圧縮する場合、ローカルEPUBのハッシュは配信後ファイルと一致しません。その差を欠落と誤認せず、各環境で役割、寸法、表示を取り直します。今回の三画像という実値は、元の検証EPUBを識別するSHAと組にして使います。
表紙候補を複数置く場合は、採用版だけをPage 5へ指定し、未採用案は別フォルダへ分けます。同名の差し替えはキャッシュで旧画像に見える恐れがあるため、新しい名前とSHAで試験します。EPUBを展開して採用名の資源とcover役を読み、旧候補が不要に残っていないかも確認します。
表紙を直した後は、navとNCX、二つの本文画像が以前と同じかを再検査します。一項目の修正が他の読書順や参照へ波及していないことを確かめ、三画像・欠落0をもう一度得てから引き渡します。
最後に、EPUBのSHAと検査日時を表紙台帳へ添えます。再出力でSHAが変わったら、以前の画像3・spine7を新しい本へ流用せず、同じ検査をやり直します。