Skip to content
EPUBCheck · Package document (OPF)

EPUBCheck OPF-096b: non-linear page maybe hidden

Updated:

EPUBCheck OPF-096b is a usage message: “No hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.” A non-linear document has no hyperlink pointing to it, and the book contains scripts. A script might provide the link at run time, so EPUBCheck only reports a usage note (shown with -u).

The official message

No hyperlink was found to non-linear document "%1$s", please check that it can be reached from scripted content.

Default severity
Usage. Informative only and hidden by default: it appears when EPUBCheck runs with -u (--usage). It does not make the EPUB invalid.
EPUBCheck version
5.4.0

%1$s, %2$s… are filled in with the file, value or element EPUBCheck found.

Typical causes

  • A scripted menu or quiz that opens the document, which EPUBCheck cannot see.
  • A non-linear note or appendix that really has no link, in a book that happens to have scripts.
  • The link was removed while editing.

How to fix it

  1. Check whether a script really opens the document EPUBCheck names.
  2. If it does not, add a normal link from the text or the navigation document.
  3. Or remove linear="no" from its itemref so it is read in order.

When it's not this

Without scripts, the same situation is the error OPF-096.

Terms used here

Other OPF messages

  • OPF-096 Non-linear content must be reachable, but found no hyperlink to "…".
  • OPF-095 The "media-type" attribute of "voicing" links must be an audio MIME type, but found "…".
  • OPF-097 Resource "…" is listed in the manifest, but no reference to it was found in content documents.
  • OPF-094 The "media-type" attribute is required for "…" links.
  • OPF-098 The "href" attribute must reference resources, not elements in the package document, but found URL "…".
  • OPF-093 The "media-type" attribute is required for linked resources located in the EPUB container

Sources

Message text and severity from EPUBCheck 5.4.0 (W3C, BSD-3-Clause). Explanation by EpubCC.

FAQ

What does EPUBCheck OPF-096b mean?

EPUBCheck OPF-096b is a usage message: “No hyperlink was found to non-linear document "…", please check that it can be reached from scripted content.” A non-linear document has no hyperlink pointing to it, and the book contains scripts. A script might provide the link at run time, so EPUBCheck only reports a usage note (shown with -u).

Is OPF-096b an error?

OPF-096b is reported as usage by default. Informative only and hidden by default: it appears when EPUBCheck runs with -u (--usage). It does not make the EPUB invalid.