一冊になるまで見通せる!EPUBの挿絵、EPUB内での画像格納と出力確認

原稿フォルダに画像があるだけでは、EPUBへ収録されたとは言えません。本文XHTMLの参照、OPFのmanifest、パッケージ内の実ファイルを一つずつ結びます。この記事では epub 挿絵の確認を、三章、合成PNG二枚、表紙一枚の固定標本で行います。同じ画像を複数章から使うため、元画像数ではなく四つの格納役割と四参照を合格値にします。

元画像と使う場所の対応表を作る

最初の表に、元ファイル、使用章、本文または表紙という役割、代替テキスト、期待する出力名を書きます。一枚を二章で再利用する場合は二行にし、参照経路が二つあることを明示します。ファイル数だけでは、どの章に必要か分かりません。

画像の権利確認や色補正は別工程です。今回は格納と参照の整合性だけを扱います。検査中に画像を差し替えず、開始時のSHAと寸法を固定します。

配置の指示も文章で残します。全幅、段落内、章扉などの役割を曖昧にすると、正しい画像が収録されても編集意図と違う場所へ出ます。構造検査へ渡す前に、章と挿入位置を対応表で確定します。

四つのimg参照をXHTMLから集める

固定EPUBでは cover.xhtml と p001〜p003 を読み、合計四つのimg参照を確認しました。各要素のsrcとaltを取得し、対応表の役割へ戻します。altも四件ありましたが、存在するだけで文章として適切とは限りません。

同じPNGが複数のXHTMLから参照される場合、参照件数と物理ファイル数は一致しないことがあります。今回は出力側で四つの役割として格納されています。数え方を先に決め、都合に合わせて「二枚」や「四枚」を使い分けません。

manifest四資源と実ファイルを結ぶ

OPFのmanifestから画像項目を取り出し、href、media-type、propertiesを確認します。固定結果は画像四資源で、XHTMLの四参照すべてに対応する実ファイルがあり、欠落0でした。表紙の項目は本文画像と区別します。

hrefが存在しても、大文字小文字や拡張子が実ファイルと違えば環境によって失敗します。ZIP内の正確な名前と一文字ずつ照合します。未参照の画像が残った場合は、意図的な予備か不要資源かを決めます。

表紙と本文の再利用を混同しない

表紙一枚と本文挿絵は、同じ画像に見えても出版物内の役割が異なります。cover.xhtmlの参照、manifestの表紙指定、本文XHTMLの参照を別欄にします。表紙が表示されたことを、本文挿絵も収録された証拠にはしません。

逆に本文に画像が見えても、書棚用サムネイルや表紙指定が正しいとは限りません。表紙の確認はパッケージ構造と実機表示の両方が必要です。今回の四参照という値には、その役割分けを含めています。

欠落を見つけたらsrc・href・名前を並べる

画像が表示されないときは、原稿の参照、XHTMLのsrc、manifestのhref、ZIP内の名前を横に並べます。どの段階で文字列が変わったかを特定し、該当箇所だけ直します。とりあえず同じ画像を複数フォルダへコピーすると、後で正本が分からなくなります。

再出力後は失敗した一件だけでなく、四参照すべてを再検査します。共通の出力設定が別章へ影響する可能性があるためです。旧EPUBを残し、新しいSHAと検査日時を記録します。

画像ファイルを更新した場合は、名前が同じでも内容SHAが変わります。キャッシュで旧画像が見えることがあるため、EPUBから実際の画像を取り出してSHAを照合します。原稿フォルダ側の新画像を見ただけで出力更新済みと判断しません。

alt四件は内容も人が校正する

機械検査でalt属性が四件あることは確認できますが、その説明が挿絵の役割を伝えるかは人が判断します。装飾画像なら空の代替が適切な場合もあり、物語上重要な図なら情報を言葉で補う必要があります。

ファイル名をそのままaltにしただけの文は合格にしません。章の文脈と対応表を見て、読み上げたときに不要な重複や重大な欠落がないかを確認します。この校正結果は「属性あり」という構造値と分けて残します。

valid=trueを表示保証に読み替えない

固定EPUBのローカル検査は valid=true でした。これは対象にした構造条件を満たし、欠落資源がなかったという結果です。すべての読書アプリで同じ寸法や位置に表示されること、販売先が受理すること、画像の著作権が処理済みであることは示しません。

Rune Studioの公開資料は画像とEPUB出力の対応範囲を知る根拠です。今回の四参照・四資源・alt四件・欠落0は固定パッケージの取得値です。最後に代表章を実機で開き、表示差を別の互換性記録へ残します。

参照経路を一冊分まとめて引き渡す

引き継ぎ表には、三章、元PNG二枚、表紙一枚、四つの役割、XHTML四参照、manifest四資源、alt四件、欠落0を書きます。どの参照がどの実ファイルへ届くかを一行ずつ説明できる状態が完了です。

元画像数と使用回数を混ぜず、表紙と本文を分け、構造検査と見た目の確認を分けます。この三つの区別があれば、画像が増えた本でも「入っているはず」ではなく、パッケージの経路として挿絵を検証できます。