EpubCCEPUBCheck OPF-032: guide link to non-document
Updated:
EPUBCheck OPF-032 is an error message: “Guide references "…" which is not a valid "OPS Content Document".” A reference in the guide element points to a file that is not a content document. The EPUB 2 guide may only point to documents a reading app can open as pages, such as XHTML chapters.
The official message
Guide references "%1$s" which is not a valid "OPS Content Document".
- 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
%1$s, %2$s… are filled in with the file, value or element EPUBCheck found.
Typical causes
- A guide entry of type cover pointing at the cover image instead of the XHTML page that shows it.
- A guide entry pointing at a stylesheet, a font or another non-document file.
- A guide copied from another book whose files had different types.
How to fix it
When it's not this
If the guide's target is not in the manifest at all, that is OPF-031.
Terms used here
Other OPF messages
OPF-031File listed in reference element in guide was not declared in OPF manifest: ….OPF-033The spine contains no linear resources.OPF-030The unique-identifier "…" was not found.OPF-034The spine contains multiple references to the manifest item with id "…".OPF-029The file "…" does not appear to match the media type …, as specified in the OPF file.OPF-035Media type "text/html" is not appropriate for XHTML/OPS.
Sources
Message text and severity from EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explanation by EpubCC.