Skip to content

Publication Manifest to EPUB Mapping

Matt Garrish edited this page Oct 1, 2019 · 35 revisions

This document provides a mapping from the Publication Manifest format to EPUB's Package Document.

1. Language Declarations

Publication Manifest EPUB 3 Package Document Explanation
@context/language package[@xml:lang] Global manifest/package language declaration.
term/language metadata/*[@xml:lang] Local language overrides.
inLanguage dc:language Language of the publication.

2. Conformance

Publication Manifest EPUB 3 Package Document Explanation
type (none) The type of publication. EPUB does not have an equivalent in the specification, but can be expressed as meta[@property=rdf:type].
conformsTo dc:type The profile the publication conforms to. EPUB uses reserved keywords instead of URLs for profiles.

3. Structure

Publication Manifest EPUB 3 Package Document Explanation
readingOrder spine Default progression through the content. EPUB uses references to the manifest, while the Package Document uses a list of resources.
resources manifest Identifies the resources of the publication. The EPUB manifest is the complete set of resources, while Pub Manifest uses a union of readingOrder and resources.
links metadata/link Linked resources. EPUB does not separate the links from the other publication metadata, but the links themselves.

4. Resources

Publication Manifest EPUB 3 Package Document Explanation
rel=accessibility-report link[@rel=a11y:certifierReport Accessibility report for the publication. EPUB use is defined in the Accessibility specification.
rel=contents item[@properties=nav] Identifies the document containing the table of contents. EPUB requires all navigation aids in the navigation document, so does not uniquely identify the resources within it.
rel=cover item[@properties= cover-image] EPUB only identifies cover images. Pub Manifest allows any resource to be identified as the cover.
rel=pageList item[@properties=nav] Identifies the document containing the page list. EPUB requires all navigation aids in the navigation document, so does not uniquely identify the resources within it.
rel=preview dc:type=preview A preview for the publication. EPUB use is defined in the Previews specification. EPUB defines entire publications as previews and also embeds previews using collections.
rel=privacy-policy (none) Privacy policy for the publication. EPUB does not have an equivalent in the specification, but could be expressed as link[rel=privacy-policy] once registered.

5. Durations

Publication Manifest EPUB 3 Package Document Explanation
duration meta[@property= media:duration] Total duration of the publication.
linkedResource/length meta[@property= media:duration][@refines=idref] Duration of a resource. EPUB uses meta tags to associated a duration with a resource, whereas Pub Manifest can express the duration directly with the resource.

6. Accessibility

Publication Manifest EPUB 3 Package Document Explanation
accessibilityFeature meta[@property= schema:accessibilityFeature] Accessibility features of the publication. EPUB use is defined in the Accessibility specification.
accessibilityHazard meta[@property= schema:accessibilityHazard] Potential hazards from the content. EPUB use is defined in the Accessibility specification.
accessibilitySummary meta[@property= schema:accessibilitySummary] Human-readable summary of the accessibility. EPUB use is defined in the Accessibility specification.
accessMode meta[@property= schema:accessMode] Access modes of the content. EPUB use is defined in the Accessibility specification.
[accessModeSufficient]https://w3c.github.io/pub-manifest/#accessibility() meta[@property= schema:accessibilityFeature] Sufficient set(s) of access modes that allow consumption of the content. EPUB use is defined in the Accessibility specification.

7. Publication Metadata

Publication Manifest EPUB 3 Package Document Explanation
abridged (none) Whether the publication is abridged. EPUB does not have an equivalent in the specification, but can be expressed as meta[@property=schema:abridged].
creator (author, etc.) dc:creator, dc:contributor + meta[@role] Creators of the publication. EPUB "refines" the DC elements to add roles.
datePublished dc:date Date the publication was published.
dateModified dcterms:modified Last modification date of the publication.
id package[@uid] - dc:identifier Unique identifier for the publication.
name dc:title Title of the publication.
readingProgression page-progression-direction The content flow direction. EPUB's use is more specifically tied to the expected rendering (e.g., page loading for fixed layouts).
url (none) Address of the publication. EPUB does not have an equivalent in the specification, but can be expressed as meta[@property=schema:url].
Clone this wiki locally