WARNING: This document is OBSOLETE.

The EPUB Spine Properties Vocabulary is now an appendix of the EPUB 3 Specification.

EPUB Spine Properties Vocabulary

5 October 2016

This version: http://www.idpf.org/epub/vocab/package/itemref/epub-vocab-itemref-20160617.html
Latest version: http://www.idpf.org/epub/vocab/package/itemref
Previous version: http://www.idpf.org/epub/vocab/package/epub-vocab-package-20160426.html

Document history

Editors

Markus Gylling, International Digital Publishing Forum (IDPF)

Matt Garrish, Invited Expert

All rights reserved. This work is protected under Title 17 of the United States Code. Reproduction and dissemination of this work with changes is prohibited except with the written permission of the International Digital Publishing Forum (IDPF).

EPUB is a registered trademark of the International Digital Publishing Forum.

Status of this Document

This document is subject to change at any time. The terms defined herein will never be removed, but may be deprecated.

Any use of terms marked [draft] should be considered experimental.

Deprecated term are identified by the label [deprecated]. These terms are no longer recommended for use.

Requests for additions, modifications and clarifications can be made through the Issue Tracker. Pull requests are also welcome.

Refer to the IDPF Issue Reporting Guidelines for more information about the change request process.

1 Overview

1.1 About this Vocabulary

This section is informative

This vocabulary defines a set of properties for describing various features of the Package Document [Packages3].

The properties in this vocabulary are usable in the various Package Document attributes that accept the property datatype [Packages3], and are grouped by the element and attribute that they can be used in.

1.2 Referencing

Properties are referenceable using the base IRI http://idpf.org/epub/vocab/package/#.

1.3 Terminology

Terms with meanings specific to EPUB 3 are capitalized in this document (e.g., "Author", "Reading System"). A complete list of these terms and definitions is provided in [EPUB3].

Only the first instance of a term in a section is linked to its definition.

2 Spine `itemref` Properties

The following tables define properties for use in the itemref element [Packages3] properties attribute [Packages3].

2.1 page-spread-left

Name:	page-spread-left
Description:	The page-spread-left property indicates that the first page of the associated `item` element's EPUB Content Document represents the left-hand side of a two-page spread.

2.2 page-spread-right

Name:	page-spread-right
Description:	The page-spread-right property indicates that the first page of the associated `item` element's EPUB Content Document represents the right-hand side of a two-page spread.

2.3 Examples

The following example shows how a two-page spread of a map might be indicated in the spine.

<spine>
	<itemref idref="title"/>
	<itemref idref="ps-1-l" properties="page-spread-left"/>
	<itemref idref="ps-1-r" properties="page-spread-right"/>
	<itemref idref="toc"/>
	…
</spine>

References

Normative References

[EPUB3] EPUB 3 .

[Packages3] EPUB Packages 3 .