画像入りの電子書籍では、本文画像と表紙を同じ「画像1枚」と数えないでください。電子書籍 epub 作り方の中で、本文のMarkdown参照は章からの相対パス、表紙は書誌とmanifestのcover登録として点検します。ファイル数が合っていても、役割が入れ替わっていれば不合格です。
3枚の本文画像と1枚の表紙を分けた
検証本は4章で、本文用PNGを3枚、表紙用PNGを1枚指定しました。出力EPUBの検査は画像4、spine8、nav4、NCX4を返し、valid=trueでした。この4という数値は、本文画像3枚に表紙1枚を足した予定と合います。
フォルダ移動後には、旧パスの参照を残したまま同名画像を元の場所へ戻す方法を選びがちです。それではフォルダ設計が再び壊れます。正しい復旧は、各章から新しい画像フォルダへの相対パスを書き直し、表紙はウィザードの登録先を更新することです。
合格条件は、本文の全参照が実ファイルへ到達し、表紙がcoverとして登録され、EPUB内の画像数が資産一覧と合うことです。この検査は著作権や各リーダーでのトリミングを判定しません。
三つの本文画像と表紙を混同せず数える
画像入りの4章標本では、本文内の三画像と表紙候補を別の資源として一覧にします。各画像について、元ファイルのハッシュ、参照する章、代替文、出力後のmanifest項目を記録します。表紙は作品設定から登録されるため、Markdownの画像数と単純に足し合わせて合否を決めません。生成物内の実数と参照経路を見て判断します。
画像名を保ったまま内容だけ差し替えると、古いキャッシュで確認を誤る場合があります。試験出力には新しい名前とハッシュを与え、EPUBから抽出した画像のハッシュも比べます。欠落時は出力物へ直接コピーせず、元プロジェクトの参照を直して再生成します。
画像台帳から欠落箇所を一枚ずつ特定する
画像台帳の行には、章、原稿中の相対パス、元画像ハッシュ、出力資源名、抽出後ハッシュを置きます。三つの本文画像と一枚の表紙なら四行を別々に管理します。出力時に圧縮や形式変換がある場合は、ハッシュ一致ではなく寸法、形式、見た目の確認へ切り替える判断も行ごとに残します。
一枚だけ欠けたとき、すべての画像を再登録すると別の三枚まで変わる恐れがあります。欠けた行の参照元を直し、新しい出力で四行を再検査します。古いEPUBと新しいEPUBのファイル名を分け、どちらを開いたかをハッシュで確定します。
代替文や権利確認は構造検査では評価できません。画像が収録されたという技術合格と、公開に適した画像であるという編集合格を分離し、両方が終わるまで引き渡しません。
画像の向きと色を構造検査の外で確認する
画像資源が正しく収録されても、回転情報や色プロファイルの扱いで見た目が変わることがあります。抽出画像の寸法と向きを元画像と比較し、読書画面で一枚ずつ確認します。三枚のうち一枚だけ横倒しなら、参照ではなく画像準備の工程へ戻ります。
代替文はXHTMLから読み、画像の役割を説明しているか編集者が判断します。装飾画像なら空にするなど、作品の方針を台帳へ記録します。単にファイルがあるという検査ではアクセシビリティを合格にしません。
構造、見た目、代替文の三欄がそろえば、画像入り電子書籍として引き渡せます。販売先の圧縮や再変換は別の環境で再検査します。
参照地図は原稿の場所から描く
画像フォルダを整理するときは、プロジェクトの最上位からではなく、画像を呼び出す章ファイルから見た相対パスを書きます。たとえばchapters/01.mdからassets/scene-a.pngを参照するなら、章と資産の位置関係を台帳に一行で残します。移動前に旧参照の件数を数え、移動後は旧参照が0件、新参照が予定件数になったことを読み直します。同名ファイルを旧位置へ複製する方法は、誤りを隠すだけなので復旧には使いません。
今回の永続標本では、本文画像3枚と表紙1枚を別々に登録し、4章を横書き・版1.7で出力しました。計画時点で本文の各参照と表紙設定を分けたため、検査後の画像4件を根拠のある内訳へ戻せます。spine=8は画像数ではなく読書順の項目数です。navとNCXのリンクが各4件であることも、画像の収録とは別欄で評価します。
壊れた一枚だけを戻して再出力する
移動後の試験で一枚が欠けたら、完成EPUBへ画像を手作業で足してはいけません。欠けた章のMarkdown参照か、作品設定の表紙パスのどちらが壊れたかを先に特定し、元プロジェクトを直して新しい名前で出力します。旧版と新版のSHAを分けて記録すれば、確認者が誤った方を開く事故も防げます。
ローカル検査の合格は、4画像が収録され、欠落参照がなく、navとNCXが存在し、valid=trueであることです。これは画像権利、代替文の質、販売先の受理、端末ごとの切り抜きまで保証しません。構造の領収書と編集上の承認を分けて残すことで、画像入り本を安全に引き渡せます。
引き渡し直前には、EPUBを展開して四つの資産名を台帳の行へ戻します。圧縮や改名が行われる出力では元画像とのハッシュ一致だけを要求せず、どのmanifest項目がどの原本に由来するかを記録します。本文側は三つのXHTML参照、表紙側はcoverの役割を確認し、どちらか一方だけの成功を全体合格にしません。
