EpubCCEPUBCheck NAV-003: page breaks without page list
Updated:
EPUBCheck NAV-003 is an error message: “The Navigation Document must have a page list when content document(s) contain page breaks (epub:type="pagebreak").” The content marks page breaks (epub:type="pagebreak") but the navigation document has no page list. Page-break markers exist so readers can go to a printed page number, and without a page list there is no way to reach them.
The official message
The Navigation Document must have a page list when content document(s) contain page breaks (epub:type="pagebreak").
- Default severity
- Error. The EPUB breaks a rule of the specification and is invalid. Stores and Send to Kindle may reject it, and EPUBCheck exits with status 1.
- EPUBCheck version
- 5.4.0
Typical causes
- Page-break markers kept from the print source without generating the matching page list.
- A page list deleted from the nav document by an editor or a script.
How to fix it
- Add a nav with
epub:type="page-list"to the navigation document, with one link per page-break marker, for example<li><a href="ch01.xhtml#page12">12</a></li>. - Give each page-break marker an id so the links have a target.
- Or remove the page-break markers if the printed page numbers do not matter for this book.
- Rebuild the EPUB and run EPUBCheck again to confirm the message is gone.
When it's not this
If a page list exists but its links point to missing ids, the error is RSC-012.
Terms used here
Other NAV messages
NAV-001The nav file is not supported for EPUB v2.NAV-006Content documents contain "figure" elements but the Navigation Document does not have a listing of figures (epub:type="loi").NAV-010"…" nav must not link to remote resources; found link to "…".NAV-011"…" nav must be in reading order; link target "…" is before the previous link’s target in … order.
Sources
Message text and severity from EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explanation by EpubCC.