EPUB Content Documents 3.0

Working Group Draft 15 February 2011

This version
http://www.idpf.org/epub/30/spec/epub30-contentdocs-20110215.html
Latest version
http://www.idpf.org/epub/30/spec/epub30-contentdocs.html
Previous version
N/A
Diffs to previous version
N/A

Editors (this version)

Markus Gylling, DAISY Consortium

William McCoy, WebPaper LLC

Elika Etemad, Invited Expert

Matt Garrish, Invited Expert

Editors (previous versions)

Garth Conboy, eBook Technologies

TBD - additional editors

Table of Contents

1. Overview
1.1. Purpose and Scope
1.2. Relationship to Other Specifications
1.2.1. Relationship to HTML5
1.2.2. Relationship to SVG
1.2.3. Relationship to CSS
1.2.4. EPUB 3 Versioning Strategy
1.3. Terminology
1.4. Conformance
1.4.1. Conformance Statements
1.5. Namespace prefix mappings
2. EPUB Content Documents
2.1. XHTML Content Documents
2.1.1. XHTML Content Documents Content Conformance
2.1.2. XHTML Content Documents Reading System Conformance
2.1.3. HTML5 Extensions and Enhancements
2.1.3.1. Semantic Inflection
2.1.3.1.1. Introduction
2.1.3.1.2. The epub:type Attribute
2.1.3.1.3. Vocabulary Association
2.1.3.1.4. Processing Requirements
2.1.3.2. SSML Attributes
2.1.3.2.1. Overview
2.1.3.2.2. The ssml:ph attribute
2.1.3.2.3. The ssml:alphabet attribute
2.1.3.3. The epub:trigger Element
2.1.3.4. Alternate Style Tags
2.1.4. HTML5 Deviations and Constraints
2.1.4.1. Embedded MathML
2.1.4.1.1. Introduction
2.1.4.1.2. Embedded MathML Content Conformance
2.1.4.1.3. Embedded MathML Reading System Conformance
2.1.4.1.4. Alternative Content
2.1.4.2. Embedded SVG
2.1.4.2.1. Embedded SVG and CSS
2.1.4.3. Unicode Restrictions
2.1.4.4. Discouraged Constructs
2.1.4.5. Restricted Constructs
2.2. EPUB Navigation Documents
2.2.1. Introduction
2.2.2. EPUB Navigation Documents Content Conformance
2.2.3. EPUB Navigation Documents Reading System Conformance
2.2.4. EPUB Navigation Document Definition
2.2.4.1. The nav Element: Restrictions
2.2.4.2. The nav Element: Types
2.2.4.2.1. The toc nav Element
2.2.4.2.2. The page-list nav Element
2.2.4.2.3. The landmarks nav Element
2.2.4.2.4. Other nav Elements
2.3. SVG Content Documents
2.3.1. Introduction
2.3.2. SVG Content Documents Content Conformance
2.3.3. Restrictions on SVG 1.1
2.3.4. SVG Reading System Conformance
2.4. Scripted Content Documents
2.4.1. Introduction
2.4.2. Scripted Content Documents Content Conformance
2.4.3. Scripted Content Documents Reading System Conformance
3. EPUB Style Sheets
3.1. EPUB Style Sheet Content Conformance
3.2. EPUB Style Sheet Reading System Conformance
3.3. EPUB 3 CSS Profile
3.3.1. CSS 2.1
3.3.2. CSS 2.0
3.3.3. CSS 3.0 Speech
3.3.4. CSS Fonts Level 3
3.3.5. CSS Text Level 3
3.3.6. CSS Writing Modes
3.3.7. Media Queries
3.3.8. CSS Multi-Column Layout
3.3.9. Ruby Positioning
3.3.10. Display Property Values oeb-page-head and oeb-page-foot
4. PLS Documents
4.1. Overview
4.2. PLS Documents Publication Conformance
4.3. PLS Documents Content Conformance
4.4. PLS Documents Reading System Conformance
A. Schemas
A.1. XHTML Content Document Schema
A.2. EPUB Navigation Document Schema
A.3. SVG Content Document Schema
B. Contributors
B.1. Acknowledgements and Contributors
References

 1 Overview

 1.1 Purpose and Scope

This specification, EPUB Content Documents 3.0, defines profiles of HTML5, SVG, and CSS for use in the context of EPUB® Publications.

This specification is one of a family of related specifications that compose EPUB 3, the third major revision of an interchange and delivery format for digital publications based on XML and Web Standards. It is meant to be read and understood in concert with the other specifications that make up EPUB 3:

  • The EPUB 3 Overview [EPUB3Overview], which should be read first, provides an informative overview of EPUB and a roadmap to the rest of the EPUB 3 documents.

  • EPUB Publications 3.0 [Publications30], which defines publication-level semantics and overarching conformance requirements for EPUB Publications.

  • EPUB Open Container Format (OCF) 3.0 [OCF3], which defines a file format and processing model for encapsulating a set of related resources into a single-file (ZIP) EPUB Container.

  • EPUB Media Overlays 3.0 [MediaOverlays30], which defines a format and a processing model for synchronization of text and audio.

This specification supersedes Open Publication Structure (OPS) 2.0.1 [OPS2]. Refer to [EPUB3Changes] for information on differences between this specification and its predecessor.

 1.2 Relationship to Other Specifications

This section is informative

 1.2.1 Relationship to HTML5

The XHTML document type defined by this specification is based on W3C HTML5, and inherits unless otherwise specified all definitions of semantics, structure and processing behaviors from the HTML5 specification.

In addition, this specification defines a set of extensions to the W3C HTML5 document model that Authors may include in XHTML Content Documents.

This specification defines a simplified processing model that does not require Reading Systems to support scripting, HTML5 forms or the HTML5 DOM. EPUB Reading Systems conformant with this specification are only required to be able to process a conforming EPUB Content Document. As support for scripting and HTML5 forms are optional Reading System features, a conformant Reading System may not be a fully-conformant HTML5 User Agent (i.e., it may not implement the complete HTML5 processing model).

 1.2.2 Relationship to SVG

This specification defines a restricted subset of SVG 1.1 to represent vector graphics inline in XHTML Content Documents and as standalone SVG Content Documents.

 1.2.3 Relationship to CSS

The CSS profile defined in this specification has CSS 2.1 [CSS2.1] as its baseline. Any CSS Style Sheet that conforms to CSS 2.1 may be used in the context of an EPUB Publication, except as noted in CSS 2.1.

This specification also incorporates features defined by CSS3 Modules and introduces EPUB-specific CSS constructs.

 1.2.4 EPUB 3 Versioning Strategy

EPUB 3 references W3C specifications that are not yet final, and incompatible changes to them may occur in the future that would cause EPUB 3 Content Documents that were previously conformant to no longer be conformant to the latest versions of the referenced specifications.

The IDPF anticipates revising the EPUB 3 specifications if and when such incompatible changes occur, updating the normative constraints defined herein as necessary and incrementing the minor version number of EPUB 3 (e.g., publishing an EPUB 3.0.n).

 1.3 Terminology

EPUB Publication (or Publication)

A logical document entity consisting of a set of interrelated resources and packaged in a EPUB Container, as defined by this specification and its sibling specifications .

Publication Resource

A resource that contains content or instructions that contribute, directly or indirectly, to the logic and rendering of the EPUB Publication (e.g., the Package Document, EPUB Content Documents, EPUB Style Sheets, audio, video, images, embedded fonts, scripts). In the absence of this resource, the Publication cannot be rendered as intended by the Author.

Publication resources are listed in the manifest [Publications30] .

Core Media Type Resource

A Publication Resource that is a Core Media Type and may therefore be included in the EPUB Publication without the provision of fallbacks [Publications30] .

EPUB Content Document

A Publication Resource that conforms to one of the EPUB Content Document definitions (XHTML or SVG).

An EPUB Content Document is a Core Media Type, and may therefore be included in the EPUB Publication without the provision of fallbacks [Publications30] .

XHTML Content Document

An EPUB Content Document conforming to the profile of [HTML5] defined in XHTML Content Documents .

XHTML Content Documents use the XHTML syntax of [HTML5].

SVG Content Document

An EPUB Content Document conforming to the constraints expressed in SVG Content Documents .

EPUB Navigation Document

A specialization of the XHTML Content Document, containing human- and machine readable global navigation information, conforming to the constraints expressed in EPUB Navigation Documents .

Scripted Content Document

An EPUB Content Document that includes scripting, or an XHTML Content Document that contains HTML5 forms elements.

Refer to Scripted Content Documents for more information.

top-level Content Document

An EPUB Content Document referenced from the spine

Core Media Type

A set of Publication Resource types for which no fallback is required. Refer to Core Media Types [Publications30] for more information.

Package Document

A Publication Resource carrying bibliographical and structural metadata about the EPUB Publication, as defined in Package Documents [Publications30] .

Manifest

A list of all Publication Resources that constitute the EPUB Publication.

Refer to manifest [Publications30] for more information.

Spine

An ordered list of Publication Resources, typically EPUB Content Documents, representing the default reading order of the publication.

Refer to spine [Publications30] for more information.

Text-to-Speech (TTS)

The rendering of the textual content of an EPUB Publication as artificial human speech using a synthesized voice.

EPUB Style Sheet (or Style Sheet)

A CSS Style Sheet conforming to the CSS profile defined in EPUB Style Sheets .

Viewport

The region of an EPUB Reading System in which the content of an EPUB Publication is rendered visually to a User.

CSS Viewport

A Viewport capable of displaying CSS-styled content.

EPUB Container (or Container)

A ZIP-based packaging and distribution format for an EPUB Publication, as defined in [OCF3].

Author

The person(s) or organization responsible for the creation of an EPUB Publication, which may or may not be the creator of the content and resources it contains.

User

An individual that consumes an EPUB Publication using an EPUB Reading System.

EPUB Reading System (or Reading System)

A system that processes EPUB Publications for presentation to Users in a manner conformant with this specification and its sibling specifications .

 1.4 Conformance

 1.4.1 Conformance Statements

The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "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.

 1.5 Namespace prefix mappings

For convenience, the following namespace prefix mappings [XMLNS] are used throughout this specification:

prefix namespace URI
epub http://www.idpf.org/2011/epub
m http://www.w3.org/1998/Math/MathML
pls http://www.w3.org/2005/01/pronunciation-lexicon
ssml http://www.w3.org/2001/10/synthesis
svg http://www.w3.org/2000/svg

 2 EPUB Content Documents

 2.1 XHTML Content Documents

This section defines a profile of [HTML5] for creating XHTML Content Documents. An instance of an XML document that conforms to this profile is a Core Media Type and is referred to in this specification and its sibling specifications as an XHTML Content Document.

Unless otherwise specified, this specification inherits all definitions of semantics, structure and processing behaviors from the HTML5 specification. [HTML5]

caution

The EPUB 3 XHTML Content Document definition references features in the W3C HTML5 specification that are still works in progress and may change in incompatible ways. When utilizing such features, authors should consider the inherent risks in terms of the potential impact on interoperability and document longevity.

 2.1.1 XHTML Content Documents Content Conformance

An XHTML Content Document must meet all of the following criteria:

Document Properties

  It must meet the conformance constraints for XML documents defined in XML Document Content Conformance [Publications30] .

 It must use the XHTML syntax [HTML5].

 It must be valid to the XHTML Content Document schema as defined in XHTML Content Document Schema.

 For all document constructs used that are defined by [HTML5], it must conform to the conformance criteria defined for those constructs in that specification, unless explicitly overridden in HTML5 Deviations and Constraints.

 It must conform to all content conformance constraints defined in HTML5 Extensions and Enhancements.

File Properties

 The XHTML Content Document filename should use the file extension .xhtml.

note

All Publication Resources referenced from an XHTML Content Document must conform to the constraints for Publication Resources defined in EPUB Publication Content Conformance [Publications30]

 2.1.2 XHTML Content Documents Reading System Conformance

A conformant EPUB Reading System must meet all of the following criteria for processing XHTML Content Documents:

 2.1.3 HTML5 Extensions and Enhancements

This section defines EPUB 3 XHTML Content Document extensions to the underlying HTML5 document model.

TODO Issue 20

 2.1.3.1 Semantic Inflection
 2.1.3.1.1 Introduction

Semantic inflection is the process of attaching additional meaning about the specific purpose and/or nature that an element plays in an XHTML Content Document. In the context of EPUB Publications, such inflection typically pertains to domain-specific semantics that are not covered by the underlying host language (HTML5) vocabulary.

Semantic metadata is not intended for human consumption; it instead provides a controlled way for Reading Systems and other User Agents to learn more about the structure and content of a document, providing them the opportunity to enhance the reading experience for Users.

This specification defines a method for semantic inflection using the attribute axis : instead of adding new XML elements to the XHTML Content Document vocabulary as needed, a fixed set of attributes are used to inflect the desired semantics. A mechanism to identify external vocabularies that provide controlled values for the attributes is also defined.

 2.1.3.1.2 The epub:type Attribute

NOTE: Issue 73

The epub:type attribute inflects semantics on the element on which it appears. Its value is one or more space-separated terms stemming from external vocabularies associated with the document instance, as defined in Vocabulary Association .

The inflected semantic must express a subclass of the semantic of the carrying element. Note that Reading Systems are required to ignore inflected semantics that conflict with the carrying element.

note

The epub:type attribute is intended to be functionally equivalent to the W3C Role Attribute [Role], but with restrictions as specified in Vocabulary Association .

Attribute Name

type

Attribute Namespace

http://www.idpf.org/2011/epub

Usage

May be specified on all elements.

Value

A space-separated list of CURIEs [RDFa11 Core], with restrictions as defined in Vocabulary Association .

 2.1.3.1.3 Vocabulary Association

NOTE The spec [RDFa11 Core] underlying the profile and prefix attributes is still evolving. The exact mechanism for vocabulary association in EPUB 3 is therefore subject to change.

This specification uses a subset of the vocabulary association mechanism defined in RDFa 1.1 Core [RDFa11 Core]. The profile and prefix attributes of RDFa 1.1 Core are allowed on the root element of XHTML Content Documents, and are used as follows:

The profile attribute [conditionally required]

Specifies the URI [RFC3986] of the vocabulary profile for EPUB Content Documents.

This attribute is optional except when the epub:type attribute is used in an XHTML Content Document, in which case its use is required.

This version of the specification requires the attribute have the value http://www.idpf.org/epub/30/profile/content/ [ContentProfile]

The prefix attribute [optional]

Declares additional vocabulary prefix mappings beyond the mappings declared in the profile, using the syntax defined in [RDFa11 Core].

The prefix attribute must not redeclare a prefix that has already been defined through the metadata profile. Similarly, the XML Namespaces [XMLNS] method of defining namespace prefixes using the xmlns pseudo-attribute must not be used to define vocabulary prefixes.

Besides reserving prefixes for a set of well-known vocabularies, the vocabulary profile for EPUB Content Documents also reserves the EPUB 3 Structural Semantics Vocabulary [StructureVocab] as the default vocabulary for all XHTML Content Documents. The terms defined in this vocabulary are used without prefixes in the epub:type attribute of XHTML Content Documents.

Examples

The following example shows the epub:type attribute used to inflect footnote and note reference semantics. The properties used are defined in the default vocabulary.

<html … profile="http://www.idpf.org/epub/30/profile/content/">
    …
    <p> … <a epub:type="noteref" href="n1">1</a> … </p>    
    …
    <aside epub:type="footnote" id="n1">
        …    
    </aside>
    …
</html>    

The following example shows the epub:type attribute used to inflect glossary semantics on an HTML5 definition list. The property used is defined in the default vocabulary.

<html … profile="http://www.idpf.org/epub/30/profile/content/">
    …
    <dl epub:type="glossary">
        …    
    </dl>        
    …
</html>    

The following example shows the epub:type attribute used to inflect source publication pagebreak semantics. The property used is defined in the default vocabulary. (Note that the source-identifier [Publications30] property provides a means of identifying the source publication to which the given pagination information applies.)

<html … profile="http://www.idpf.org/epub/30/profile/content/">
   …
  <p> … <br epub:type="pagebreak" title="234"/> … </p>    
   … 
</html>   
 2.1.3.1.4 Processing Requirements

Reading Systems must process the epub:type as follows:

  •  A Reading System may associate specialized behaviors with none, some or all of the terms defined in the default vocabulary.

  •  A Reading System may also associate specialized behaviors with terms given in vocabularies other than the default one.

  •  A Reading System must ignore terms that it does not recognize.

  •  When Reading System behavior associated with a given epub:type value conflicts with behavior associated with the carrying element, then the behavior associated with the element must be given precedence.

 2.1.3.2 SSML Attributes
 2.1.3.2.1 Overview

The W3C Speech Synthesis Markup Language [SSML] is a language used for assisting Text-to-Speech (TTS) engines in generating synthetic speech. While SSML is a language designed as a standalone document type, it also defines semantics suitable for use within other host languages.

This specification recasts the SSML 1.1 phoneme element as two attributes (ssml:ph and ssml:alphabet), and makes them available within EPUB XHTML Content Documents.

Reading Systems with Text-to-Speech (TTS) capabilities should support the SSML Attributes as defined below.

NOTE: discussions with SSML WG on reuse of namespace is ongoing

note

For more information on EPUB 3 features related to synthetic speech, refer to Text-to-speech [EPUB3Overview] .

 2.1.3.2.2 The ssml:ph attribute

The ssml:ph attribute specifies a phonemic/phonetic pronunciation for the text contained within the element on which the attribute appears.

Attribute Name

ph

Attribute Namespace

http://www.w3.org/2001/10/synthesis

Usage

May be specified on all elements that have text node descendants, but must not be specified on a descendant of an element that also carries this attribute.

Value

A phonemic/phonetic expression, syntactically valid with respect to the phonemic/phonetic alphabet being used.

This attribute inherits all the semantics of the SSML 1.1 [SSML] phoneme element's ph attribute, with the following addition:

  •  The document text represented by the ssml:ph attribute is the string that results from concatenating the data of all the descendant text nodes of the carrying element in document order.

note

Reading Systems that support the SSML Attributes and PLS Documents must honor the defined precedence rules for these two constructs.

 2.1.3.2.3 The ssml:alphabet attribute

The ssml:alphabet attribute specifies which phonemic/phonetic pronunciation alphabet is used in the value of the ssml:ph attribute.

Attribute Name

alphabet

Attribute Namespace

http://www.w3.org/2001/10/synthesis

Usage

May be specified on the html element.

Value

ipa | x-SAMPA

This attribute inherits all the semantics of the SSML 1.1 [SSML] phoneme element's alphabet attribute.

This specification restricts the allowed phonemic/phonetic pronunciation alphabets to ipa, as defined in [SSML], and x-SAMPA, as defined at [X-SAMPA].

If the ssml:alphabet attribute is omitted from an EPUB Content Document instance, the default value ipa must be assumed for the document.

Reading Systems that support the SSML Attributes feature of this specification must support the ipa alphabet. Support for the x-SAMPA alphabet is optional.

 2.1.3.3 The epub:trigger Element

The trigger element enables the creation of markup-defined user interfaces for controlling multimedia objects, such as audio and video playback, in both scripted and non-scripted contexts.

Element name

trigger

Usage

As a child of head. Repeatable.

Attributes
id [optional]

The ID [XML] of this element, which must be unique within the document scope.

action [required]

The action to perform for this event.

Allowed values: show | hide | play | pause | resume | mute | unmute

ref [required]

A relative IRI [RFC3987] to the element which is the object of the action (#id form).

ev:event [required]

The applicable event for this trigger, as defined in [XML Events].

ev:observer [required]

The source object for this trigger, as defined in [XML Events].

Content Model

Empty.

The trigger element associates an event from a specified source object (observer) with a desired action to be performed with a specified target object (ref).

The semantics of the defined action values are:

  • show — set the element's visibility property to visible.

  • hide — set the element's visibility property to hidden.

  • play — play the associated resource from the beginning (only applicable to video or audio elements).

  • pause — pause playing (only applicable to video or audio elements).

  • resume — resume playing (only applicable to video or audio elements).

  • mute — mute sound (only applicable to video or audio elements).

  • unmute — unmute sound (only applicable to video or audio elements).

TODO: example - image button controlling video pause/resume

Reading Systems that support video or audio playback must support the epub:trigger element.

 2.1.3.4 Alternate Style Tags

In accordance with [AltStyleTags] , the link element class attribute may include any of the following values: horizontal, vertical, day and night. These values inherit the semantics defined by that specification for their use.

Reading Systems should select and utilize such tagged style sets as appropriate, and as described in that specification.

 2.1.4 HTML5 Deviations and Constraints

This section defines deviations and/or constraints in EPUB 3 XHTML Content Documents to the underlying HTML5 document model.

 2.1.4.1 Embedded MathML
 2.1.4.1.1 Introduction

XHTML Content Documents support embedded MathML [MATHML] but limit its usage to a restricted subset of the full MathML markup language.

This subset is designed to ease the implementation burden on Reading Systems and to promote accessibility, while retaining compatibility with HTML5 User Agents [HTML5].

note

The mathml [Publications30] property of the manifest item element indicates that an XHTML Content Document contains embedded MathML.

 2.1.4.1.2 Embedded MathML Content Conformance

Any occurrence of MathML markup in XHTML Content Documents must conform to the constraints expressed in the MathML specification [MATHML], with the following additional restrictions:

Presentation MathML

 The m:math element must contain only Presentation MathML, with the exception of the m:annotation-xml element as defined below.

Content MathML

  Content MathML may be included within MathML markup in XHTML Content Documents, and, when present, must occur within an m:annotation-xml child element of an m:semantics element.

 When Content MathML is included as per the previous condition, the given m:annotation-xml element's encoding attribute must be set to either of the functionally-equivalent values MathML-Content or application/mathml-content+xml, and its name attribute must be set to contentequiv.

Deprecated MathML

 Elements and attributes marked as deprecated in [MATHML] must not be included within MathML markup in XHTML Content Documents.

XHTML Content Document fragments

 XHTML Content Document fragments may be included within MathML markup in XHTML Content Documents, and, when present, must occur within an m:annotation-xml child element of an m:semantics element.

 When an XHTML Content Document fragment is included as per the above paragraph, the given m:annotation-xml element's encoding attribute must be set to application/xhtml+xml and its name attribute must be set to alternate-representation.

 Any included XHTML Content Document fragments must not themselves contain MathML markup.

 Any included XHTML Content Document fragments must conform to the content model in which the ancestor m:math element occurs, such that if the m:math element is replaced by the given XHTML Content Document fragment the document remains valid.

Alternative Content

 Alternative content should be included, and, when present, must be represented as defined in Alternative Content.

 2.1.4.1.3 Embedded MathML Reading System Conformance

A conformant EPUB Reading System must meet all of the following criteria for processing MathML embedded in XHTML Content Documents:

 2.1.4.1.4 Alternative Content

Reading Systems should be able to generate any necessary alternative textual renditions dynamically using the given Presentation MathML markup (e.g., as output to Text-to-Speech (TTS) engines). To support Reading Systems that are not so capable, however, alternative textual content should be included with each occurrence of the m:math element in XHTML Content Documents.

The alttext attribute on the m:math element should be used for this purpose primarily when shorter alternative text runs are sufficient. When more extensive alternative text is required, XHTML Content Document fragments should be used. (Note that Reading Systems query these two alternative text locations using a defined preference order.)

For Reading System forward compatibility purposes, fallback images may be provided using the altimg attribute on the m:math element. It is recommended that the dimension and alignment attributes (altimg-width, altimg-height and altimg-valign) be used in conjunction with the altimg attribute.

note

Any images referenced from altimg attributes must conform to the constraints for Publication Resources defined in EPUB Publication Content Conformance [Publications30] .

 2.1.4.2 Embedded SVG

XHTML Content Documents support the embedding of SVG by reference (embedding via reference, for example, from an img or object element) and by inclusion (embedding via direct inclusion of the svg:svg element in the XHTML Content Document) [SVG].

The content conformance constraints for SVG embedded in XHTML Content Documents are the same as defined for SVG Content Documents in Restrictions on SVG 1.1.

Reading Systems must process SVG embedded in XHTML Content Documents as defined in SVG Reading System Conformance.

note

The svg [Publications30] property of the manifest item element indicates that an XHTML Content Document contains embedded SVG.

note

This section defines conformance requirements for SVG embedded in XHTML Content Documents. Refer to SVG Content Documents for conformance requirements for SVG as an EPUB Content Document.

 2.1.4.2.1 Embedded SVG and CSS

For the purposes of styling SVG embedded in XHTML Content Documents by reference , Reading Systems must not apply CSS style rules of the containing document to the referenced SVG document.

For the purposes of styling SVG embedded in XHTML Content Documents by inclusion , Reading Systems must apply applicable CSS rules of the containing document to the included SVG elements.

note

SVG included by reference is processed as a separate document, and must include its own CSS style rules just like an SVG Content Document would. Note that this is consistent with situations where an HTML5 object element references an external HTML5 element.

 2.1.4.3 Unicode Restrictions

This section lists restrictions on the Unicode character repertoire.

Private Use Characters and Embedded Fonts

Any included characters that map to a code point within one of the Private Use Area (PUA) ranges as defined in [Unicode] must occur within a string that is styled or attributed in a manner that includes a reference to an embedded font that contains an appropriate glyph for that code point.

 2.1.4.4 Discouraged Constructs
The rp Element

 The rp element [HTML5] is intended to provide a fallback — an optional parenthesis display around ruby markup — for older version Reading Systems that do not recognize ruby markup. As EPUB 3 Reading Systems are ruby-aware, and can provide fallbacks, the use of rp elements in Content Documents is discouraged.

The embed Element

 Since the embed element [HTML5] does not provide intrinsic facilities to provide fallbacks for Reading Systems that do not support scripting, its use is discouraged when the resource referenced has scripting components. Authors should use the object element instead.

 2.1.4.5 Restricted Constructs

This section lists restrictions on XHTML Content Document that are not enforced by the schema for XHTML Content Documents.

Reference Restrictions

 The HTML5 iframe element src attribute must only reference XHTML Content Documents.

 2.2 EPUB Navigation Documents

 2.2.1 Introduction

The EPUB Navigation Document is a required component [Publications30] of EPUB Publications. It provides the Author with a mechanism to include a human- and machine-readable global navigation layer in the Publication, thereby ensuring increased usability and accessibility for the User.

The EPUB Navigation Document is an adaptation of XHTML Content Document, and is by definition a valid XHTML Content Document instance. All Content and Reading System conformance requirements that apply to XHTML Content Documents also apply to the EPUB Navigation Document.

The navigation features of this adaptation are expressed through specializations of the HTML5 nav element. Each nav element in an EPUB Navigation Document represents a data island — an embedded source of specialized information within the general markup — from which Reading Systems can retrieve navigational information. Unlike typical XML data islands, however, the information within the nav element remains human readable as an HTML5 document.

To facilitate machine readability, the content model of nav elements in EPUB Navigation Documents is restricted relative to what is allowed in general XHTML Content Documents.

As it is a conforming XHTML Content Document, the EPUB Navigation Document may be included in the Publication spine, but may also be provided independently of it.

note

The EPUB Navigation Document is identified in the Package Document manifest through the nav [Publications30] property.

note

The EPUB Navigation Document supersedes the NCX document type as defined in [OPF2].

Information on how EPUB 3 Publications may include an NCX document for EPUB 2 Reading System forwards compatibility purposes is available in NCX Superseded [Publications30] .

 2.2.2 EPUB Navigation Documents Content Conformance

A conformant EPUB Navigation Document must meet all of the following criteria:

Document Properties

 It must conform to all content conformance constraints for XHTML Content Documents as defined in XHTML Content Documents Content Conformance.

 It must be valid to the EPUB Navigation Document schema as defined in EPUB Navigation Document Schema and conform to all content conformance constraints specific for EPUB Navigation Documents expressed in EPUB Navigation Document Definition.

 2.2.3 EPUB Navigation Documents Reading System Conformance

A conformant EPUB Reading System must meet all of the following criteria for processing EPUB Navigation Document:

  •  When requested by a User, Reading Systems must provide access to the links and link labels in the nav elements of the EPUB Navigation Document in a fashion that allows the User to activate the links provided. When a link is activated, the Reading System must relocate the application's current reading position to the destination described by that link.

  •  Reading Systems must honor the above requirement irrespective of whether the EPUB Navigation Document provided in a Publication is part of the spine.

 2.2.4 EPUB Navigation Document Definition

 2.2.4.1 The nav Element: Restrictions

This specification restricts the content model of the nav element and its descendants in EPUB Navigation Documents as follows:

  •  Each nav element may contain an optional heading indicating the title of the navigation list. The heading must be one of the HTML5 h1 through h6 elements or an hgroup.

  •  The optional heading must be followed by a single ol ordered list; no other elements are permitted as direct children of the nav element. This ordered list represents the primary level of content navigation.

  •  Each list item (li) of the ordered list represents a primary heading, structure or other point of interest within the Publication and must contain a child a element representing the link description. The order of li elements must match the order of the content they represent in each targeted EPUB Content Document (see the definition of the href IRI attribute, below), and must also conform to the order of Content Documents in the Publication spine.

  •  Each child a element of a list item may contain any valid HTML5 phrasing content, but must not result in a zero-length text string after concatenation of all child content and application of whitespace normalization rules.

  •  If the a element contains instances of HTML5 embedded content that do not provide intrinsic text alternatives, it must also include a title attribute with an alternate text rendition of the link label.

  •  The IRI provided in the href attribute of the a element must resolve to an EPUB Content Document or fragment therein.

  •  The a element may optionally be followed by an ol ordered list representing a subsidiary content level below that heading (e.g., all the subsection headings of a section). This list must adhere to all the content requirements defined in this section for constructing the primary navigation list, and so on for each additional level of the Publication's hierarchy represented in this manner.

TODO Issue 69

 2.2.4.2 The nav Element: Types

The nav elements within the EPUB Navigation Document are distinguished semantically through the value of their epub:type attribute. By default (and as inferred from the value of the html element profile attribute), values of epub:type are drawn from the EPUB 3 Structural Semantics Vocabulary [StructureVocab]. Refer to The epub:type Attribute for more information.

 2.2.4.2.1 The toc nav Element

The toc nav element is a container for primary structural navigational information. It conceptually corresponds to a table of contents in a printed work (i.e., it provides navigation to the structural sections of the Publication).

For usability and accessibility reasons, Authors should provide an exhaustive toc nav element; it should not exclude references below a certain section depth, as the reduced table of contents often appearing in printed works do.

note

Authors who desire to mimic the reduced table of contents of a printed source should utilize CSS Style Sheets to hide sections below a certain depth visually, while still providing an exhaustive section hierarchy for machine consumption.

note

When XHTML Content Documents are used in the Publication spine, authoring tools may utilize the HTML5 document outline algorithm to generate the toc nav element contents. Note however that when the spine includes multiple Content Documents, the toc nav element contains navigation information that spans across multiple outlines.

The following example shows a partial toc nav element. Note how the author has elected to use CSS style information to hide sections below a certain depth visually.

<nav epub:type="toc" id="toc">
    <h1>Table of contents</h1>
    <ol>
        <li><a href="chap1.xhtml">Chapter 1</a>
            <ol>
                <li><a href="chap1.xhtml#sec-1.1">Chapter 1.1</a>
                    <ol style="display:none">
                        <li><a href="chap1.xhtml#sec-1.1.1">Section 1.1.1</a></li>
                        <li><a href="chap1.xhtml#sec-1.1.2">Section 1.1.2</a></li>
                    </ol>
                </li>
                <li><a href="chap1.xhtml#sec-1.2">Chapter 1.2</a></li>
            </ol>
        </li>
        <li><a href="chap2.xhtml">Chapter 2</a></li>
    </ol>
</nav>

The toc nav element must occur exactly once in EPUB Navigation Documents.

note

The toc nav element corresponds to the navMap element in the superseded NCX [OPF2].

 2.2.4.2.2 The page-list nav Element

The page-list nav element is a container for pagination information. It provides navigation to positions in the Publication content that correspond to the locations of page boundaries present in a print source being represented by this EPUB Publication.

note

The source-identifier [Publications30] property provides a means of identifying the source publication to which the given pagination information applies.

The following example shows a partial page-list nav element.

<nav epub:type="page-list" style="display:none">
    <h2>Pagebreaks of the print version, third edition</h2>
    <ol>
        <li><a href="frontmatter.xhtml#pi">I</a></li>
        <li><a href="frontmatter.xhtml#pii">II</a></li>
        …
        <li><a href="chap1.xhtml#p1">1</a></li>
        <li><a href="chap1.xhtml#p2">2</a></li>
        …
    </ol>
</nav>

The page-list nav element is optional in EPUB Navigation Documents, and must not occur more than once.

note

The page-list nav element corresponds to the pageList element in the superseded NCX. [OPF2]

 2.2.4.2.3 The landmarks nav Element

The landmarks nav element identifies fundamental structural components of the publication in order to enable Reading Systems to provide the User access to them.

The structural semantics of each link target within the landmarks nav element is determined through the value of the epub:type attribute on the a element descendants. The epub:type attribute is required on a descendants of the landmarks nav element.

The following example shows a landmarks nav element with structural semantics drawn from the EPUB Structural Semantics Vocabulary.

<nav epub:type="landmarks">
    <h2>Guide</h2>
    <ol>
        <li><a epub:type="toc" href="#toc">Table of Contents</a></li>
        <li><a epub:type="loi" href="content.html#loi">List of Illustrations</a></li>
        <li><a epub:type="bodymatter" href="content.html#bodymatter">Start of Content</a></li>
    </ol>
</nav>

The landmarks nav element is optional in EPUB Navigation Documents and must not occur more than once.

note

The landmarks nav element corresponds to the deprecated OPF guide element. Refer to guide [Publications30] for more information.

 2.2.4.2.4 Other nav Elements

EPUB Navigation Documents may include zero or more nav elements in addition to the toc, page-list and landmarks nav elements defined above. Such additional nav elements should have an epub:type attribute to provide a machine-readable semantic, and must have a human-readable heading as their first child.

This specification imposes no restrictions on the usage of such additional nav elements; they may be used to represent constructs with homogeneous semantics (such as list of illustrations, or all quotes of a certain author in an anthology) or with heterogeneous semantics (such as the landmarks nav element).

 2.3 SVG Content Documents

 2.3.1 Introduction

The Scalable Vector Graphics (SVG) 1.1 (Second Edition) specification [SVG] defines a format for representing final-form vector graphics and text.

Although an EPUB Publication typically uses XHTML Content Documents as the top-level document type, the use of SVG Content Documents is also permitted. SVGs are typically only used in certain special circumstances, however, such as when final-form page images are the only suitable representation of the content (as may be the case, for example, in the context of manga or comic books).

This section defines a profile for SVG 1.1 [SVG] documents. An instance of an XML document that conforms to this profile is a Core Media Type and is referred to in this specification and its sibling specifications as an SVG Content Document.

note

This section defines conformance requirements for SVG Content Documents. Refer to Embedded SVG for conformance requirements for SVG embedded in XHTML Content Documents.

 2.3.2 SVG Content Documents Content Conformance

An SVG Content Document must meet all of the following criteria:

Document Properties

  It must meet the conformance constraints for XML documents defined in XML Document Content Conformance [Publications30] .

 It must be valid to the SVG Content Document schema as defined in SVG Content Document Schema and conform to all content conformance constraints expressed in Restrictions on SVG 1.1.

 It should adhere to the accessibility guidelines given in [SVG Access].

File Properties

 The SVG Content Document filename should use the file extension .svg.

note

All Publication Resources referenced from an SVG Content Document must conform to the constraints for Publication Resources defined in EPUB Publication Content Conformance [Publications30]

 2.3.3 Restrictions on SVG 1.1

This specification restricts the content model of SVG Content Documents and SVG embedded in XHTML Content Documents as follows:

  •  The SVG Animation Elements must not occur.

  •  The svg:foreignObject element must contain only valid XHTML Content Document Flow content, and its requiredExtensions attribute, if given, must be set to http://www.idpf.org/2007/ops.

  •  The svg:title element must contain only valid XHTML Content Document Phrasing content.

  •  It should include the width and height attributes on the svg:svg element.

 2.3.4 SVG Reading System Conformance

A conformant EPUB Reading System must meet all of the following criteria for processing SVG Content Documents and SVG embedded in XHTML Content Documents:

  •  It must support processing of SVG using semantics defined by the SVG 1.1 specification [SVG].

  •  It must meet the Reading System conformance criteria defined in Scripted Content Documents Reading System Conformance.

  •  If it has a CSS Viewport, it must support visual rendering of SVG using CSS, and should support all properties defined in Appendix N of [SVG]. In the case of embedded SVG, it must also conform to the constraints defined in Embedded SVG and CSS.

  •  It should support User selection and searching of text within SVG elements.

  •  It must recognize the value http://www.idpf.org/2007/ops of the requiredExtensions attribute when appearing on the svg:switch and svg:foreignObject elements as representing the occurrence of XHTML Content Document fragments.

  •  It must regard the svg [Publications30] property of the Package Document manifest item element as the authoritative definition of whether an EPUB XHTML Content Document includes embedded SVG.

 2.4 Scripted Content Documents

 2.4.1 Introduction

EPUB Content Documents may contain scripting using the facilities defined for this in the respective underlying specifications ([HTML5] and [SVG]). When an EPUB Content Document contains scripting, it is referred to in this specification and its sibling specifications as a Scripted Content Document. This label also applies to XHTML Content Documents when they contain instances of HTML5 forms

In the context of XHTML Content Documents, this specification distinguishes between two models of script inclusion:

container-constrained

In this model of scripting, the script execution is constrained to the scope of a Content Document embedded in a parent Content Document using one of the HTML5 object, iframe or embed elements. An executing script may have read access to the DOM of its parent Content Document, but the Reading System must not allow it to modify that DOM, nor other content in the Publication. The script must not manipulate the size of its containing rectangle.

spine-level

In this model of scripting, the script execution scope is a top-level Content Document. There are no restrictions on DOM access or modification.

 2.4.2 Scripted Content Documents Content Conformance

Inclusion Models

 EPUB Content Documents may include scripting. In the context of XHTML Content Documents, the inclusion model should be restricted to the container-constrained model only.

 EPUB Content Documents that include spine-level model scripting must utilize the so-called progressive enhancement technique: when the document is rendered by a Reading System without scripting support or with scripting support disabled, the top-level document content must retain its integrity, remaining consumable by the User without any information loss or other significant deterioration.

Accessibility

 EPUB Content Documents that include scripting — using any inclusion model — should employ relevant accessibility techniques to assure that the content remains consumable by all Users. [WAI-ARIA] [WCAG20]

Fallbacks

 EPUB Content Documents that include scripting — using any inclusion model — should provide fallbacks for such content, either by using intrinsic fallback mechanisms (such as those available for the HTML5 object and canvas elements [HTML5] ) or, when intrinsic fallback is not applicable, by using manifest-level [Publications30] fallback.

note

The scripted [Publications30] property of the manifest item element indicates that an EPUB Content Document is a Scripted Content Document.

 2.4.3 Scripted Content Documents Reading System Conformance

note

Reading Systems may render Scripted Content Documents in a manner that disables other EPUB capabilities and/or provides a different rendering and User experience, such as, for example, disabling pagination.

Authors choosing to restrict the usage of scripting to the container-constrained model will ensure a more consistent User experience between scripted and non-scripted content (e.g., consistent pagination behavior).

Authors should use declarative techniques whenever practical to increase the interoperability, longevity, and accessibility of the Publication, and avoid the inclusion of scripting whenever practical.

 3 EPUB Style Sheets

This section defines a profile for Cascading Style Sheets (CSS) intended to be used for styling of XHTML Content Documents. An instance of a CSS Style Sheet that conforms to this profile is a Core Media Type and is referred to in this specification and its sibling specifications as an EPUB Style Sheet.

caution

The EPUB 3 CSS Profile references CSS specifications that are still works in progress and may change in incompatible ways. When utilizing features from such specifications, authors should consider the inherent risks in terms of the potential impact on interoperability and document longevity.

 3.1 EPUB Style Sheet Content Conformance

A conformant EPUB Style Sheet must meet all of the following criteria:

  •  It must adhere to all content restrictions given in EPUB 3 CSS Profile.

  •  It may include features not explicitly identified in the EPUB 3 CSS Profile, but should be authored so that rendering fidelity does not depend on such additional features.

  •  It must be UTF-8 or UTF-16 encoded.

note

All Publication Resources referenced from a CSS Style Sheet must conform to the constraints for Publication Resources defined in EPUB Publication Content Conformance [Publications30]

 3.2 EPUB Style Sheet Reading System Conformance

  •  Reading Systems with a CSS Viewport should support — render as defined by the corresponding specification in the Viewport — all features included in this profile unless detailed otherwise in EPUB 3 CSS Profile.

  •   Reading Systems may support additional CSS features not explicitly identified in the EPUB 3 CSS Profile, and must handle any unsupported CSS features as defined in [CSS2.1].

note

Reading Systems have varying capabilities with regards to CSS rendering support. For this reason, Reading Systems may ignore some or all style information of an EPUB Style Sheet.

Note also that even when a Reading System does have a CSS Viewport, it is likely to render in a manner that differs from typical HTML5 User Agents (e.g., paginating content rather than providing a infinitely scrolling surface).

 3.3 EPUB 3 CSS Profile

 3.3.1 CSS 2.1

The style baseline of an EPUB Style Sheet is Cascading Style Sheets Level 2 Revision 1 [CSS2.1]. An EPUB Style Sheet may include all style sheet constructs normatively defined in [CSS2.1], with the following exceptions:

  • It is strongly recommended that the fixed value of the position property not be included in an EPUB Style Sheet to avoid potential rendering and interoperability issues. Reading Systems should not, but may, support this property value.

  • The direction and unicode-bidi properties must not be included in an EPUB Style Sheet. Authors should use appropriate HTML5 markup to express directionality information instead.

Reading Systems that have a CSS Viewport must support the font-family property.

For forwards compatibility with EPUB 2 Reading Systems that do not support @font-face rules, authors should reference a generic font using the font-family property.

note

The ability of Reading Systems to paginate absolutely positioned layouts is not guaranteed, so reliance on absolute positioning is discouraged. Reading Systems may not support these property values.

 3.3.2 CSS 2.0

EPUB Style Sheets may include, in addition to the list styles listed in CSS2.1, the following list style types defined in [CSS2.0]:

  • cjk-ideographic

  • hebrew

  • hiragana

  • hiragana-iroha

  • katakana

  • katakana-iroha

Additional details on these list styles can be found in [CSS3Lists]. The definitions in CSS3 Lists are incorrect, so remove this paragraph if an updated WD has not yet been published.

 3.3.3 CSS 3.0 Speech

EPUB Style Sheets may include all features defined in the CSS 3.0 Speech Module [CSS3Speech]. Reading Systems with Text-to-Speech (TTS) capabilities should support the following properties:

  • cue

  • pause

  • rest

  • speak

  • voice-family

note

For more information on EPUB 3 features related to synthetic speech, refer to Text-to-speech [EPUB3Overview] .

 3.3.4 CSS Fonts Level 3

EPUB Style Sheets may include @font-face rules as defined in the CSS Fonts Module Level 3 [CSS3Fonts] specification. OpenType [OpenType], WOFF [WOFF] and SVG [SVG] fonts may be referenced using @font-face rules.

Reading Systems with a CSS Viewport must support OpenType [OpenType] and WOFF [WOFF] fonts embedded using the @font-face rule, as well as the font obfuscation mechanism defined in Font Obfuscation [OCF3] . Reading Systems may support SVG fonts.

In addition, Reading Systems must support at least the following @font-face font descriptors:

  • font-family

  • font-style

  • font-weight

  • src

  • unicode-range

Refer to Intrinsic fallback: CSS Embedded Fonts [Publications30] for font fallback processing requirements.

 3.3.5 CSS Text Level 3

EPUB Style Sheets may include the following properties defined in the CSS Text Level 3 [CSS3Text] specification:

  • line-break

  • text-align-last

  • text-emphasis

  • text-emphasis-color

  • text-emphasis-style

  • text-transform

  • text-trim (force-start, normal and no-justify values only)

  • word-break

  • TODO hyphenation

 3.3.6 CSS Writing Modes

EPUB Style Sheets may include all of the features defined in the CSS Writing Modes Module Level 3 [CSS3WritingModes] specification except for the direction and unicode-bidi properties. Authors should use appropriate HTML5 markup to express directionality information instead.

note

When specified, the directionality indicated by the writing-mode property must match the directionality for all XHTML Content Documents specified in the in the Package metadata. Refer to page-progression-direction in Package Properties [Publications30] for more information.

 3.3.7 Media Queries

EPUB Style Sheets may include @media and @import rules with media queries as defined in the Media Queries [MediaQueries] specification.

 3.3.8 CSS Multi-Column Layout

EPUB Style Sheets may include all of the features defined in the CSS Multi-column Layout Module [CSSMultiCol] specification with the exception of the column-span property.

caution

Authors should not rely on column behavior in overflow conditions as this behavior is unstable and may change.

caution

Pagination algorithms are not fully defined in CSS. Authors should therefore expect exact pagination points to vary from Reading System to Reading System.

Reading Systems must treat the oeb-column-number property as an alias for the column-count property. The use of the oeb-column-number property in EPUB Style Sheets is deprecated; this conformance requirement will be removed in the next major version of EPUB.

 3.3.9 Ruby Positioning

EPUB Style Sheets may include the -epub3-ruby-position property as defined below:

Name: -epub-ruby-position
Value: over | under | right
Initial: over
Applies to: ruby text elements
Inherited: yes
Percentages: N/A
Media: visual
Computed value: as specified

This property controls the placement of ruby text with respect to its base text. Values have the following meanings:

over

Ruby text is positioned on the over side of the ruby base.

under

Ruby text is positioned on the under side of the ruby base.

right

Ruby text is positioned on the right side of the base text. (This value is typically used for Zhuyin Fuhao (Bopomofo) ruby.)

Need a name that avoids misuse in vertical text when over is intended.

note

NOTE: This property will become an alias for the ruby-position property in the CSS Ruby Module [CSS3Ruby].

 3.3.10 Display Property Values oeb-page-head and oeb-page-foot

In addition to the standard values defined for the display property in Section 9.2.4 of [CSS2.1], EPUB Style Sheets may specify the values oeb-page-head and oeb-page-foot.

Reading Systems should present the content of an element assigned display: oeb-page-head only as a header, and the content of an element assigned display: oeb-page-foot only as a footer. Neither should be presented simply as if it were inline or block. The way Reading Systems present headers and footers is not defined by this specification, however (for example, they may render them in fixed positions as per print layouts or pop them up on demand if only limited screen space is available).

For the purposes of page layout, these display values are similar to block boxes with an absolute position (i.e., a position value of fixed or absolute). That is, they are removed from the normal flow and a new block box is created with its own flow. Margins, padding, and other block characteristics are determined as if the element had position: fixed set.

An element assigned display: oeb-page-head or display: oeb-page-foot must not be considered in effect while any markup specified before such an element is still being rendered in the same context (for example, if it is on the same page in a paginated context, or in the viewport for a scrolled context). Once in effect, the element must remain in effect until either of the following conditions is true:

  • another header or footer (respectively) is in effect instead; or

  • no part of its parent element remains presented.

For example, when rendered to a screen with appropriate style settings, the myhead-classed div element in the following example would become the page header as soon as nothing preceding the containing div is displayed, and go out of effect when that div is no longer visible:

 <div>
   <div class="myhead" style="display: oeb-page-head">
      The OEB Publication Structure: Introduction
   </div>
   <h2>Introduction</h2>
   <p>…</p>
</div>           
        

 4 PLS Documents

 4.1 Overview

The W3C Pronunciation Lexicon Specification [PLS] defines syntax and semantics for XML-based pronunciation lexicons to be used by Automatic Speech Recognition and Text-to-Speech (TTS) engines.

The following sections define conformance criteria for PLS documents when included in EPUB Publications, and rules for associating PLS Documents with XHTML Content Documents.

note

For more information on EPUB 3 features related to synthetic speech, refer to Text-to-speech [EPUB3Overview] .

 4.2 PLS Documents Publication Conformance

A conformant EPUB Publication must meet all of the following criteria for inclusion of PLS Documents:

Examples

The following example shows two PLS Documents (one for Chinese and one for Mongolian) associated with an XHTML Content Document.

<html … >    
    <head>
        …
        <link rel="pronunciation" type="application/pls+xml" hreflang="zh" href="../speech/zh.pls"/>
        <link rel="pronunciation" type="application/pls+xml" hreflang="mn" href="../speech/mn.pls"/>
    </head>        
    …
</html>

 4.3 PLS Documents Content Conformance

To be considered a Core Media Type Resource, a PLS Document must meet all of the following criteria:

Document Properties

  It must meet the conformance constraints for XML documents defined in XML Document Content Conformance [Publications30] .

 It must be valid to the RELAX NG schema for PLS documents available at the URI http://www.w3.org/TR/pronunciation-lexicon/pls.rng [PLS].

File Properties

 The PLS Document filename should use the file extension .pls.

 4.4 PLS Documents Reading System Conformance

A conformant EPUB Reading System must meet all of the following criteria for processing PLS Documents:

 Appendix A. Schemas

The schemas in this Appendix are normative. In case of conflicts between the specification prose and the given schema, the schema shall be considered definitive.

note

Validation using these schemas will require a processor that supports [NVDL], [RelaxNG] and [ISOSchematron].

Note, however, that the NVDL schema layer can be substituted by a multi-pass validation using the embedded RELAX NG and ISO Schematron schemas alone.

 A.1 XHTML Content Document Schema

The schema for XHTML Content Documents is available at http://www.idpf.org/epub/30/schema/epub-xhtml-30.nvdl.

 A.2 EPUB Navigation Document Schema

The schema for EPUB Navigation Documents is available at http://www.idpf.org/epub/30/schema/epub-nav-30.nvdl.

 A.3 SVG Content Document Schema

The schema for SVG Content Documents is available at http://www.idpf.org/epub/30/schema/epub-svg-30.nvdl.

 Appendix B. Contributors

This appendix is informative

 B.1 Acknowledgements and Contributors

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 3 specifications were prepared by the International Digital Publishing Forum’s EPUB Maintenance Working Group, operating under a charter approved by the membership in May, 2010 under the leadership of:

Markus Gylling DAISY Consortium Chair
Garth Conboy Google Inc. Vice-chair
Brady Duga Google Inc. Vice-chair
Bill McCoy International Digital Publishing Forum (IDPF) Secretary

Active members of the working group included:

Alexis Wiles, Alicia Wise, … TODO : COMPLETE LIST OF CURRENT WG MEMBERS

For more detailed acknowledgements and information about contributors to each version of EPUB, refer to Contributors [EPUB3Overview] .

 References

Normative References

[AltStyleTags] Alternate Style Tags TODO: incorporate content into EPUB spec family .

[CSS2.0] Cascading Style Sheets, level 2 - CSS2 Specification . Bert Bos, et al. 12 May 1998 (revised 11 April 2008).

[CSS3Fonts] CSS Fonts Module Level 3 .

[CSS3Lists] CSS3 module: Lists TODO remove this entry if an updated WD has not yet been published . S. Montagu, et al. .

[CSS3Speech] CSS3 Speech Module . TODO names and date. .

[CSS3Text] CSS Text Level 3 .

[CSS3WritingModes] CSS Writing Modes Module Level 3 NOTE: this spec draft is undergoing major revision .

[ContentDocs30] EPUB Content Documents 3.0 .

[MATHML] Mathematical Markup Language (MathML) Version 3.0 . David Carlisle, et al. 21 October 2010.

[MediaOverlays30] EPUB Media Overlays 3.0 .

[MediaQueries] Media Queries .

[PLS] Pronunciation Lexicon Specification 1.0 (PLS) . Paolo Baggia. 14 October 2008.

[Publications30] EPUB Publications 3.0 .

[RDFa11 Core] RDFa Core 1.1 . Syntax and processing rules for embedding RDF through attributes. Ben Adida, et al. 26 October 2010.

[RFC3986] Uniform Resource Identifier (URI): Generic Syntax (RFC 3986) . Berners-Lee, et al. January 2005.

[RFC3987] Internationalized Resource Identifiers (IRIs) (RFC 3987) . M Duerst, et al. January 2005.

[RFC5646] Tags for Identifying Languages (RFC 5646) . A. Phillips, M. Davis. September 2009.

[SSML] Speech Synthesis Markup Language (SSML) Version 1.1 . Daniel C. Burnett, et al. 7 September 2010.

[SVG] Scalable Vector Graphics (SVG) 1.1 (Second Edition) . Erik Dahlström, et al. 22 June 2010.

[SVG Access] Accessibility Features of SVG . Charles McCathieNevile, et al. 7 August 2000.

[Unicode] The Unicode Consortium. The Unicode Standard, Version 5.0.0, defined by: The Unicode Standard, Version 5.0 (Boston, MA, Addison-Wesley, 2007. ISBN 0-321-48091-0).

[WAI-ARIA] Accessible Rich Internet Applications (WAI-ARIA) 1.0 . James Craig, et al. .

[WCAG20] Web Content Accessibility Guidelines (WCAG) 2.0 . Ben Caldwel, et al. 11 December 2008.

[WOFF] WOFF File Format 1.0 . TODO names and date. .

[XML] Extensible Markup Language (XML) 1.0 (Fifth Edition) . T. Bray, et al. 26 November 2008.

[XML Events] XML Events . Shane McCarron, et al. 14 October 2003.

[XMLNS] Namespaces in XML (Third Edition) . T. Bray, D. Hollander, A. Layman, R. Tobin. W3C. 8 December 2009.

Informative References

[EPUB3Changes] EPUB 3 Differences from EPUB 2.0.1 . TODO. .

[EPUB3Overview] EPUB 3 Overview . TODO.

[Role] Role Attribute . An attribute to support the role classification of elements. McCarron, et al. 05 August 2010.