EPUB制作: 目次Navigation Documentのよくある間違い

EPUB Navigation Documentは、EPUB内に含まれる目次に相当するXHTMLファイルです。 今回は、社内テストやお客様からの問い合わせで発見したコンテンツ制作上の間違いなどをご紹介します。 EPUB Navigation Documentの書き方 なお、ここでは特に断りのない限りEPUB 3.1のEPUB Navigation Documentを参照しますが、3.0や3.0.1でも基本的には同じです。 基本的な構造 必須となっており、多くのビューアでも主に使われるtocタイプを例に挙げます。あくまで概要ですので、詳しくはNavigation Documentの仕様をご確認ください。 nav[type=”toc”]がある navは0個または1個のheading content(h1-h6)を含む(目次全体のタイトルを書ける) navは必ず1個のolを含む olは1個以上のliを含む(項目が1個もない目次は許可されない) liはaまたはspanをどちらか必ず1個含む aはContent Documentへのリンク spanはサブリストのタイトル aとspanは、どちらも空にはできない(imgなどを含むことはできるが、テキストとして処理した際に必ず1文字以上となるように、titleやaltを付与すること) aを含むliは、追加で最大1個のolを含むことができる spanを含むliは、追加で必ず1個のolを含む(spanをleaf要素にすることはできない) epubcheckを使おう 原則として、EPUB公開前にはepubcheckによるチェックを通しておくと安全です。epubcheckを通過したからと言って100%正当なEPUBであることが保証される訳ではありませんが、通常制作していく中で埋め込んでしまうEPUB仕様違反(主に凡ミス)の99%くらいは発見できると思います。 java -jar epubcheck.jar target.epub よくある間違い 1. ネストしたリストに、spanによるheadingがついていない 以下のようなケースです。問題の行を?で示しました。 <ol> <li><a href=”p001.xhtml”>第1章</a></li> <li> ? <ol> ? <li><a href=”p002-1.xhtml”>第2章その1</a></li> <li><a href=”p002-2.xhtml”>第2章その2</a></li> </ol> </li> </ol> liは必ず最初にaまたはspanを含む必要があり、olはこれらに続く形でのみ記述できます。つまり、タイトルのつかないサブリストは許容されません。 epubcheckでは以下のようなエラーが指摘されます。 ERROR(RSC-005): …: ファイル解析時のエラー … Continue reading EPUB制作: 目次Navigation Documentのよくある間違い