EPUB Previews 1.0

Proposed Specification 8 July 2015

Updated to address issues raised during review.

This version:
http://www.idpf.org/epub/previews/epub-previews-20150708.html
Latest version:
http://www.idpf.org/epub/previews/
Previous version:
http://www.idpf.org/epub/previews/epub-previews-20141202.html

Please refer to the errata for this document, which may include some normative corrections.

Editors

Hadrien Gardeur, Feedbooks

Matt Garrish, Invited Expert

Yasuki Ikeuchi, ACCESS

Status of this Document

This document is in proposed recommendation status and is made available for final IDPF membership review.

Table of contents

  1. 1. Overview
    1. 1.1 Purpose and Scope
    2. 1.2 Terminology
    3. 1.3 Conformance Statements
  2. 2. Preview Publications
    1. 2.1 Overview
    2. 2.2 Content Conformance
    3. 2.3 Reading System Conformance
    4. 2.4 Preview Identification
    5. 2.5 Identifiers
    6. 2.6 Example
  3. 3. Embedded Previews
    1. 3.1 Overview
    2. 3.2 Content Conformance
    3. 3.3 Reading System Conformance
    4. 3.4 Preview Collections
    5. 3.5 Fragment identifiers in Preview Collections
    6. 3.6 Generating a Preview Publication from an Embedded Preview
  4. 4. Acquiring Publications
  5. Appendix A. Acknowledgements and Contributors
  6. References
    1. Normative References
    2. Informative References

1. Overview

1.1 Purpose and Scope

This section is informative

This specification, EPUB Previews, describes how preview content can be included in EPUB® Publications. This document outlines two key models for defining such content:

  1. where the Publication itself represents a preview (i.e., the full publication is available as a separate Publication); and
  2. where the Publication identifies a subset of EPUB Content Documents and Publication Resources that constitute the preview.

Best practices for metadata and links related to previews (e.g., to acquire the full Publication) are also covered.

1.2 Terminology

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

Embedded Preview

A preview derived from a subset of resources of its containing EPUB Publication.

Preview Publication

An EPUB Publication whose content represents a preview of another Publication.

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. Preview Publications

2.1 Overview

This section is informative

There are many reasons why a preview might be distributed as a separate EPUB file: to begin marketing a book before the full manuscript is complete, to limit the content available when not using DRM schemes, to minimize download sizes for media-rich works, and so on.

When distributing such a preview, it is necessary both to identify to the User that they do not have the complete publication, and also provide the means for them to obtain that work.

This section details how to create standalone Preview Publications, including the required labelling in the Package Document metadata, how to create an identifier for the preview, and how to link the preview to its parent work (how to acquire the parent work is outlined in 4. Acquiring Publications).

2.2 Content Conformance

In addition to being a valid EPUB Publication, a Preview Publication must meet all of the following criteria:

2.3 Reading System Conformance

In addition to processing the Preview Publication according to the version of the EPUB specification it conforms to, an EPUB Reading System must meet all of the following additional criteria:

2.4 Preview Identification

In order to indicate that a Publication represents a preview, its Package Document metadata section [Publications301must include a dc:type element with the value "preview".

The following example shows how a Preview Publication is defined in the Package Document metadata.

<package …>
    <metadata xmlns:dc="http://purl.org/dc/elements/1.1/">
        <dc:type>preview</dc:type>
        …
    </metadata>
</package>

2.5 Identifiers

A Preview Publication must not use the same package identifier as its source Publication.

Since a Preview Publication is rarely a product, this specification recommends using something else than an ISBN as the package identifier.

A Preview Publication should link back to its source Publication using a dc:source element, with the source Publication's package identifier as the value.

The following example shows how a Preview Publication links back to its source publication.

<package … unique-identifier="pub-id">
  <metadata xmlns:dc="http://purl.org/dc/elements/1.1/">
    <dc:type>preview</dc:type>
    <dc:identifier id="pub-id">urn:uuid:13b92c40-3f6b-11e3-aa6e-0800200c9a66</dc:identifier>
    <meta property="dcterms:modified">2013-08-01T12:00:00Z</meta>
    <dc:source>urn:isbn:9782367932095</dc:source>
    …
  </metadata>
</package>

2.6 Example

The following example shows a minimally complete metadata section, where the Publication is identified as a preview, metadata links back to the source publication and a link to acquire it has also been included.

<package … unique-identifier="pub-id">
   …
   <metadata xmlns:dc="http://purl.org/dc/elements/1.1/">
       <dc:title>Norwegian Wood</dc:title>
       <dc:language>en</dc:language>
       <dc:type>preview</dc:type>
       
       <dc:identifier id="pub-id">urn:uuid:A1B0D67E-2E81-4DF5-9E67-A64CBE366809</dc:identifier>
       <meta property="dcterms:modified">2011-01-01T12:00:00Z</meta>
       <dc:source>urn:isbn:9781448103706</dc:source>
        
       <link href="http://example.org/book/9781448103706" 
              rel="acquire" 
              media-type="text/html" />
       <link href="http://example.org/book/9781448103706.atom"
              rel="acquire"
              media-type="application/atom+xml;type=entry;profile=opds-catalog" />
   </metadata>
   …
</package>

3. Embedded Previews

3.1 Overview

This section is informative

Preview content does not have to be packaged as a separate Publication. In many cases, the subset of resources that constitute the preview can be identified within the context of the complete Publication, and directly extracted to present a preview for the User.

These Embedded Previews provide Authors control over how preview content is generated from the source Publication, instead of third-party vendors selecting which part(s) of the Publication to extract. Embedded Previews also provide an advantage over Preview Publications in that a new Publication does not have to be downloaded, and the Preview Publication replaced, when the User purchases the full version ‒ the full content simply has to be unlocked.

This section explains how to use the Package Document collection element to create such previews: from defining the necessary role to the requirements for a manifest of resources, as well as which (parts of) Content Documents can be viewed.

3.2 Content Conformance

An Embedded Preview must meet all of the following criteria:

3.3 Reading System Conformance

An EPUB Reading System must meet all of the following criteria for processing Embedded Previews:

3.4 Preview Collections

An embedded Preview is defined in a Package Document collection element [Publications301] with the role attribute value "preview".

The preview collection must include a child manifest collection [ManifestRole] that identifies all of the EPUB Content Documents in the preview, as well as all the associated resources required to render them.

Each link element’s href attribute must point to an EPUB Content Document. The IRI expressed in the href attribute may include a fragment identifier but must not include EPUB canonical fragment identifiers [EPUBCFI].

The order of child link elements in a preview collection represents the order in which the documents are to be rendered.

The following example shows how a publication can provide a collection that indicates which EPUB Content Documents are included in a preview (including only part of chapter 3), as well as a manifest of the resources necessary for this preview.

<collection role="preview">
    <collection role="manifest">
        <link href="chapter1.xhtml"         
              media-type="application/xhtml+xml" />
        <link href="chapter2.xhtml"         
              media-type="application/xhtml+xml" />
        <link href="chapter3.xhtml"         
              media-type="application/xhtml+xml" />
        <link href="stylesheet.css"         
              media-type="text/css" />
        <link href="image1.jpg"         
              media-type="image/jpeg" />
    </collection>
    <link href="chapter1.xhtml"/>
    <link href="chapter2.xhtml"/>
    <link href="chapter3.xhtml#preview"/>
</collection>

3.5 Fragment identifiers in Preview Collections

While fragment identifiers usually reference a specific location in a document, in the context of a Preview Collection, such fragment identifiers actually reference a range:

3.6 Generating a Preview Publication from an Embedded Preview

Instead of creating a separate Preview Publication, an EPUB Publication containing an Embedded Preview can be used to generate the Preview Publication automatically.

Software that generates a Preview Publication from an Embedded Preview must respect the following processing rules:

note

This specification does not mandate how to adapt content for rendering in a preview. Reading Systems might direct links outside the preview content to a generic placeholder page that indicates the content is not available in the preview, might make such links inactive by removing their href attributes, or might employ other mechanisms to handle references to non-preview content.

It is strongly encouraged, however, that all link labels be retained when adapting the preview ‒ including in the table of contents ‒ to give a complete picture of the content available in the full EPUB Publication.

note

See also [DistributableObjects] for additional guidance on how to translate a collection to a packaged EPUB Publication. The translation steps for previews are not identical (e.g., metadata is taken from the package not the collection), but many of the requirements to produce a valid EPUB Publication are the same.

4. Acquiring Publications

Both Preview Publications and Publications containing Embedded Previews may provide a link to allow a User to acquire the full source Publication. To do so, one or more acquire link elements [Publications301] should be included in the Package Document metadata section.

The following example shows links to an HTML vendor page and an OPDS catalog entry for acquiring the full Publication.

<package …>
   …
   <metadata xmlns:dc="http://purl.org/dc/elements/1.1/">
       <dc:type>preview</dc:type>
       …
       <link href="http://example.org/book/9781448103706" 
              rel="acquire" 
              media-type="text/html" />
        <link href="http://example.org/book/9781448103706.atom"
              rel="acquire"
              media-type="application/atom+xml;type=entry;profile=opds-catalog" />
   </metadata>
   …
</package>

This specification does not define how Reading Systems and vendors are to negotiate access to the acquired Publication.

While this relationship value may be used with any potential media type, this specification recommends using either "text/html" for publications that can be acquired in a browser, or "application/atom+xml;type=entry;profile=opds-catalog" for an [OPDS] entry.

Appendix A. Acknowledgements and Contributors

This appendix is informative

EPUB has been developed by the International Digital Publishing Forum in a cooperative effort, bringing together publishers, vendors, software developers, and experts in the relevant standards.

The EPUB Previews 1.0 specification was prepared by the International Digital Publishing Forum's Advanced/Hybrid Layouts working group, operating under a charter approved by the membership in November 2012, under the leadership of:

Active members of the working group included:

IDPF Members

Invited Experts/Observers

References

Normative References

Informative References