Skip to content
EPUBCheck · Package document (OPF)

EPUBCheck OPF-062: Adobe page-map in spine

Updated:

EPUBCheck OPF-062 is a usage message: “Found Adobe page-map attribute on spine element in opf file.” The spine uses Adobe's old page-map attribute, a proprietary way of mapping print pages. It is a usage note (shown with -u): the attribute is not part of EPUB 3.

The official message

Found Adobe page-map attribute on spine element in opf file.

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

Typical causes

  • EPUBs produced for Adobe Digital Editions in the EPUB 2 era.
  • Templates or tools that still add a page-map.xml file.
  • A spine copied from an older edition.

How to fix it

  1. Decide whether you still need Adobe's page map for older readers.
  2. For EPUB 3, add a page list (nav epub:type="page-list") to the navigation document instead.
  3. Then remove the page-map attribute from the spine and the page-map file from the manifest.

When it's not this

If the page-map item the attribute names is missing from the manifest, EPUBCheck also reports OPF-063.

Terms used here

Other OPF messages

  • OPF-063 Referenced Adobe page-map item "…" was not found in the manifest.
  • OPF-060 Duplicate entry in the ZIP file: "…" (file names must be unique after Unicode canonical normalization and full case folding).
  • OPF-065 Invalid metadata declaration, probably due to a cycle in "refines" metadata.
  • OPF-066 Missing "dc:source" or "source-of" pagination metadata. The pagination source must be identified using the "dc:source" and "source-of" properties when the content includes page break markers.
  • OPF-067 The resource "…" must not be listed both as a "link" element in the package metadata and as a manifest item.
  • OPF-055 … tag is empty.

Sources

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

FAQ

What does EPUBCheck OPF-062 mean?

EPUBCheck OPF-062 is a usage message: “Found Adobe page-map attribute on spine element in opf file.” The spine uses Adobe's old page-map attribute, a proprietary way of mapping print pages. It is a usage note (shown with -u): the attribute is not part of EPUB 3.

Is OPF-062 an error?

OPF-062 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.