EPUB Manifest Role

1.1 Purpose and Scope

This section is informative

This specification, EPUB Manifest Role, defines the requirements for including a manifest of resources necessary for the processing and rendering of a collection [Publications301] in an EPUB® Publication .

1.2 Terminology

Refer to the EPUB Specifications for definitions of EPUB-specific terminology used in this document.

1.3 Conformance Statements

The keywords must, must not, required, shall, shall not, should , should not, recommended, may, and optional in this document are to be interpreted as described in [RFC2119] .

All sections of this specification are normative except where identified by the informative status label "This section is informative". The application of informative status to sections and appendices applies to all child content and subsections they may contain.

All examples in this specification are informative.

2.1 Introduction

A manifest collection is similar in nature to the Package Document manifest [Publications301], but typically identifies a subset of Publication Resources necessary for the rendering of a specific feature of the EPUB Publication.

For example, while the primary purpose of a preview collection [Previews] is to identify the EPUB Content Documents containing the sample content, a Reading System also needs to know the style sheets, images and other resources used in rendering in order to effectively extract the preview for viewing. The manifest collection allows these additional resources to be easily identified.

2.2 Format

A collection element's role attribute must be set to the value "manifest" to indicate that it contains a manifest.

Each manifest collection must contain only one or more link elements, where the IRI contained in each link element's href attribute must reference the location of a required resource. Specific implementations of the manifest collection may set restrictions on the types of resources that can be referenced.

<collection role="manifest">
	<link href="chap01.html" type="application/xhtml+xml"/>
	<link href="main.css" type="text/css"/>
	<link href="interface.css" type="text/css"/>
	<link href="c01img01.jpg" type="image/jpeg"/>
	<link href="c01img02.jpg" type="image/jpeg"/>
	<link href="c01vid01.mp4" type="video/mp4"/>
</collection>

The link element children represent the set of Publication Resources necessary for processing the parent collection. The manifest collection should include a complete set of resources, including all Content Documents listed in the parent, but specific implementations of the collection may specify otherwise.

A manifest collection must be the child of another collection, and each collection should include only a maximum of one manifest collection.

Normative References