EPUB 3 Structural Semantics Vocabulary

27 November 2014

This version
http://www.idpf.org/epub/vocab/structure/epub-vocab-structure-20141127.html
Latest version
http://www.idpf.org/epub/vocab/structure
Previous version
http://www.idpf.org/epub/vocab/structure/epub-vocab-structure-20141125.html

A diff of changes from the previous version is also available.

Table of Contents

Status of this Document

This document contains draft terms from the EDUPUB profile.

All terms in the Indexes section, with the exception of the index term, are new in the EPUB Indexes specification, which is now a Proposed Specification.

Any use of the terms marked [draft] should be considered experimental until their respective specifications reach final Recommended Specification status.

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

All unlabled terms are considered stable.

About this vocabulary

This vocabulary, a part of EPUB® 3, defines a set of properties relating to the description of structural semantics of written works. While the vocabulary is generally host language agnostic, it has been constructed primarily to enable semantic inflection of elements in the HTML vocabulary.

The HTML usage context fields indicate contexts in HTML5 documents where the given property is considered relevant. Authors may use the properties on HTML5 markup elements not specifically listed, but must ensure that the semantics they express represent a subset of the carrying element's semantics and do not attach an existing element's meaning to a semantically neutral element.

When processing HTML5 documents, Reading Systems may ignore such non-compliant properties, unless their usage context is explicitly overridden or extended by the host specification.

The Usage Details sections identify IDPF specifications that define or utilize the specified properties.

Revision Policy

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

Requests for additions, modifications and clarifications must be made through the EPUB 3 Revision Tracker.

Document partitions

cover

The publications cover(s), jacket information, etc.

HTML usage context: section, body

frontmatter

Preliminary material to the main content of a publication, such as tables of contents, dedications, etc.

HTML usage context: section, body

bodymatter

The main content of a publication.

HTML usage context: section, body

backmatter

Ancillary material occurring after the main content of a publication, such as indices, appendices, etc.

HTML usage context: section, body

Document divisions

volume

A component of a collection.

HTML usage context: section, body

part

A major structural division of a piece of writing, typically encapsulating a set of related chapters.

HTML usage context: section, body

chapter

A major structural division of a piece of writing.

HTML usage context: section, body

subchapter

A major sub-division of a chapter.

HTML usage context: section, body

division

A major structural division that may also appear as a substructure of a part (esp. in legislation).

HTML usage context: section, body

Document sections and components

Sections and components that typically occur in the publication bodymatter.

abstract [draft]

A short summary of the principle ideas, concepts and conclusions of the work, or of a section or except within it.

HTML usage context: section, grouping content

foreword

An introductory section that precedes the work, typically not written by the work's author.

HTML usage context: section, grouping content

preface

An introductory section that precedes the work, typically written by the work's author.

HTML usage context: section, grouping content

prologue

An introductory section that sets the background to a story, typically part of the narrative.

HTML usage context: section, grouping content

introduction

A section in the beginning of the work, typically introducing the reader to the scope or nature of the work's content.

HTML usage context: section, grouping content

preamble

A section in the beginning of the work, typically containing introductory and/or explanatory prose regarding the scope or nature of the work's content

HTML usage context: section, grouping content

conclusion

An ending section that typically wraps up the work.

HTML usage context: section, grouping content

epilogue

A concluding section that is typically written from a later point in time than the main story, although still part of the narrative.

HTML usage context: section, grouping content

afterword

A closing statement from the author or a person of importance to the story, typically providing insight into how the story came to be written, its significance or related events that have transpired since its timeline.

HTML usage context: section, grouping content

epigraph

A quotation that is pertinent but not integral to the text.

HTML usage context: section, grouping content

Document reference sections

appendix

Supplemental information.

HTML usage context: sectioning content

colophon

A brief description usually located at the end of a publication, describing production notes relevant to the edition.

HTML usage context: sectioning content, grouping content

credits [draft]

A collection of credits.

HTML usage context: sectioning content, grouping content

keywords [draft]

A collection of keywords.

HTML usage context: sectioning content, grouping content

Indexes

index

A detailed list, usually arranged alphabetically, of the specific information in a publication.

HTML usage context: sectioning content, body

Usage details: EPUB Indexes – index property

index-headnotes [draft]

Narrative or other content to assist users in using the index.

Required parent context: index

HTML usage context: sectioning content, header

Usage details: EPUB Indexes – index-headnotes property

index-legend [draft]

List of symbols, abbreviations or special formatting used in the index, and their meanings.

Required parent context: index-headnotes

HTML usage context: sectioning content, dl

Usage details: EPUB Indexes – index-legend property

index-group [draft]

Collection of consecutive main entries that share a common characteristic, for example the starting letter of the main entries.

Required parent context: index

HTML usage context: sectioning content

Usage details: EPUB Indexes – index-group property

index-entry-list [draft]

Collection of consecutive main entries or subentries.

Required parent context: index-entry , index-group and index

HTML usage context: ul; this property is implied when the ul has an ancestor of index except within index-headnotes

Usage details: EPUB Indexes – index-entry-list property

index-entry [draft]

One term with any attendant subentries, locators, cross references, and/or editorial note.

Required parent context: index-entry-list

HTML usage context: li; this property is implied when parent ul is of type index-entry-list (implicit or explicit)

Usage details: EPUB Indexes – index-entry property

index-term [draft]

Word, phrase, string, glyph or image representing the indexable content.

Required parent context: index-xref-related , index-entry and index-xref-preferred

HTML usage context: phrasing content; typically span

Usage details: EPUB Indexes – index-term property

index-editor-note [draft]

Editorial note pertaining to a single entry.

Required parent context: index-entry

HTML usage context: flow content

Usage details: EPUB Indexes – index-editor-note property

index-locator [draft]

A reference to an occurrence of the indexed content in the publication.

Required parent context: index-entry , index-locator-list and index-locator-range

HTML usage context: a; this property is implied when parent context is index-locator-list or index-locator-range

Usage details: EPUB Indexes – index-locator property

index-locator-list [draft]

Collection of sequential locators or locator ranges.

Required parent context: index-entry

HTML usage context: ul

Usage details: EPUB Indexes – index-locator-list property

index-locator-range [draft]

A pair of locators that connects a term to a range of content rather than a single point.

Required parent context: index-locator-list and index-entry

HTML usage context: flow content

Usage details: EPUB Indexes – index-locator-range property

index-xref-preferred [draft]

Reference from one term to one or more preferred terms or term categories in an index (analogous to "See xxx").

Required parent context: index-entry

HTML usage context: flow content

Usage details: EPUB Indexes – index-xref-preferred property

Reference from one term to one or more related terms or term categories in an index (analogous to "See also xxx").

Required parent context: index-entry

HTML usage context: flow content

Usage details: EPUB Indexes – index-xref-related property

index-term-category [draft]

Word, phrase, string, glyph or image representing a category of terms in the index.

Required parent context: index-xref-related and index-xref-preferred

HTML usage context: a

Usage details: EPUB Indexes – index-term-category property

index-term-categories [draft]

Wrapper for a list of the term categories belonging to an index.

Required parent context: index-xref-preferred and index-xref-related

HTML usage context: a

Usage details: EPUB Indexes – index-term-categories property

Glossaries

glossary

An alphabetical list of terms in a particular domain of knowledge, with the definitions for those terms.

HTML usage context: dl, sectioning content

glossterm

A glossary term.

Required parent context: glossary

HTML usage context: When the element on which the property appears is a dt element within a dl element marked with the glossary property, then the glossterm property on the given dt element is implied.

glossdef

The definition of a term in a glossary.

Required parent context: glossary

HTML usage context: When the element on which the property appears a dd element within a dl element marked with the glossary property, then the glossdef property on the given dd element is implied. When the element context is a dd element and no explicit glossterm link is provided, then the term that this glossdef participates in defining is located in the nearest preceding dt element sibling.

Bibliographies

bibliography

A list of works cited.

HTML usage context: sectioning content

biblioentry

An entry in a bibliography.

Required parent context: bibliography

HTML usage context: grouping content

Preliminary sections and components

Preliminary sections and components, typically occuring in the publication frontmatter.

titlepage

The title page of the work.

HTML usage context: section, grouping content

halftitlepage

The half title page of the work.

HTML usage context: section, grouping content

The copyright page of the work.

HTML usage context: section, grouping content

seriespage [draft]

Marketing section used to list related publications.

HTML usage context: section, grouping content

acknowledgments

A passage containing acknowledgments to entities involved in the realization of the work.

HTML usage context: section, grouping content

imprint

Information relating to the publication or distribution of the work.

HTML usage context: section, grouping content

imprimatur

A formal statement authorizing the publication of the work.

HTML usage context: section, grouping content

contributors

A list of contributors to the work.

HTML usage context: section, grouping content

other-credits

Acknowledgments of previously published parts of the work, illustration credits, and permission to quote from copyrighted material.

HTML usage context: section, grouping content

errata

Publication errata, in printed works typically a loose sheet inserted by hand; sometimes a bound page.

HTML usage context: section, aside, grouping content

dedication

An inscription addressed to one or several particular person(s).

HTML usage context: section, grouping content

revision-history

A record of changes made to a work.

HTML usage context: section, grouping content

Complementary content

case-study [draft]

A detailed analysis of a specific topic.

Inherits from: xhv:complementary

HTML usage context: sectioning content

help

Information that clarifies or augments the content.

Inherits from: xhv:complementary

HTML usage context: aside, phrasing content

marginalia [deprecated]

Content, both textual and graphical, that is offset in the margin.

Inherits from: xhv:complementary

HTML usage context: aside, phrasing content

Replaced by: aside

notice

Information that requires special attention, and that must not be skipped or suppressed. Examples include: alert, warning, caution, danger, important.

HTML usage context: section, grouping content

pullquote [draft]

A quotation from the text that is set off in a distinctive fashion, such as in a larger typeface.

Inherits from: xhv:complementary

HTML usage context: aside

Secondary or supplementary content, typically formatted as an inset or box.

Inherits from: xhv:complementary

HTML usage context: aside

Replaced by: aside

warning [deprecated]

A warning.

HTML usage context: section, grouping content

Replaced by: notice

Titles and headings

halftitle

The title appearing on the first page of a work or immediately before the text.

Inherits from: title

HTML usage context: heading content. This property should only appear once within the document scope.

fulltitle

The full title of the work, either simple, in which case it is identical to title, or compound, in which case it consists of a title and a subtitle.

Inherits from: title

Same as: http://purl.org/dc/terms/title

HTML usage context: heading content. This property should only appear once within the document scope.

covertitle

The title of the work as displayed on the work's cover.

Inherits from: title

HTML usage context: heading content. This property should only appear once within the document scope.

title

The primary name of a work, section or component. When used in the context of a fulltitle, the primary part of the full title.

HTML usage context: heading content, phrasing content descendants of heading content.

subtitle

An explanatory or alternate title for the work.

Inherits from: title

HTML usage context: heading content, phrasing content descendants of heading content, paragraphs, divs

label [draft]

The text label that precedes an ordinal in a component title (e.g., 'Chapter', 'Part', 'Figure', 'Table').

Inherits from: title

HTML usage context: heading content, li, figcaption

ordinal [draft]

An ordinal specifier for a component in a sequence of components (e.g., '1', 'IV', 'B-1').

Inherits from: title

HTML usage context: heading content, li, figcaption

bridgehead

A structurally insignificant heading that does not contribute to the hierarchical structure of the work.

HTML usage context: flow content, typically p, div or span

Educational content

Learning objectives

learning-objective

An explicit designation or description of a learning objective or a reference to an explicit learning objective.

HTML usage context: flow content, phrasing content

learning-objectives [draft]

A collection of learning-objectives.

HTML usage context: sectioning content, grouping content

learning-outcome [draft]

The understanding or ability a student is expected to achieve as a result of a lesson or activity.

HTML usage context: flow content

learning-outcomes [draft]

A collection of learning-outcomes.

HTML usage context: sectioning content, grouping content

learning-resource

A resource provided to enhance learning, or a reference to such a resource.

HTML usage context: flow content

learning-resources [draft]

A collection of learning-resources.

HTML usage context: sectioning content, grouping content

learning-standard [draft]

A formal set of expectations or requirements typically issued by a government or a standards body.

HTML usage context: sectioning content, phrasing content

learning-standards [draft]

A collection of learning-standards.

HTML usage context: sectioning content, grouping content

Testing

answer [draft]

The component of a self-assessment problem that provides the answer to the question.

HTML usage context: aside, grouping content

answers [draft]

A collection of answers.

HTML usage context: sectioning content, grouping content

assessment

A test, quiz, or other activity that helps measure a student's understanding of what is being taught.

HTML usage context: sectioning content

assessments [draft]

A collection of assessments.

HTML usage context: sectioning content

feedback [draft]

Helpful instruction to the reader based on the result of an assessment.

HTML usage context: grouping content, phrasing content

fill-in-the-blank-problem [draft]

A problem that requires the reader to input a text answer to complete a sentence, statement or similar.

HTML usage context: aside, grouping content

general-problem [draft]

A problem with a free-form solution.

HTML usage context: aside, grouping content

qna

A question and answer section.

HTML usage context: lists or sectioning content

match-problem [draft]

A problem that requires the reader to match the contents of one list with the corresponding items in another list.

HTML usage context: aside, grouping content

multiple-choice-problem [draft]

A problem with a set of potential answers to choose from ‒ some, all or none of which may be correct.

HTML usage context: aside, grouping content

practice [draft]

A review exercise or sample.

See also: practices

HTML usage context: aside, grouping content

practices [draft]

A collection of practices.

HTML usage context: sectioning content

question [draft]

The component of a self-assessment problem that identifies the question to be solved.

HTML usage context: grouping content

true-false-problem [draft]

A problem with either a true or false answer.

HTML usage context: aside, grouping content

Comics

panel [draft]

An individual frame, or drawing.

HTML usage context: li

Usage details: EPUB Region-Based Navigation

panel-group [draft]

A group of panels (e.g., a strip).

HTML usage context: li

Usage details: EPUB Region-Based Navigation

balloon [draft]

An area in a comic panel that contains the words, spoken or thought, of a character.

HTML usage context: li

Usage details: EPUB Region-Based Navigation

text-area [draft]

An area of text in a comic panel. Used to represent titles, narrative text, character dialogue (inside a balloon or not) and similar.

HTML usage context: li

Usage details: EPUB Region-Based Navigation

sound-area [draft]

An area of text in a comic panel that represents a sound.

HTML usage context: li

Usage details: EPUB Region-Based Navigation

Notes and annotations

annotation [deprecated]

Explanatory information about passages in the work.

Inherits from: xhv:complementary

HTML usage context: aside, phrasing content

Replaced by: Open Annotation in EPUB

note [deprecated]

A note. This property does not carry spatial positioning semantics, as do the footnote and rearnote properties. It can be used to identify footnotes, rear notes, marginal notes, inline notes, and similar when legacy naming conventions are not desired.

HTML usage context: On the aside element when identifying a single note, or on descendants of sectioning content when identifying individual notes in a group (refer to footnotes and rearnotes).

Replaced by: footnote, rearnote

footnote

A note appearing at the bottom of a page.

See also: footnotes

HTML usage context: On the aside element when identifying a single footnote, or on descendants of sectioning content when identifying individual footnotes in a group (refer to footnotes and rearnotes).

rearnote

A note appearing in the rear (backmatter) of the work, or at the end of a section.

See also: rearnotes

HTML usage context: On the aside element when identifying a single rearnote, or on descendants of sectioning content when identifying individual rearnotes in a group (refer to footnotes and rearnotes).

footnotes

A collection of notes appearing at the bottom of a page.

See also: footnote

HTML usage context: sectioning content

rearnotes

A collection of notes appearing at the rear (backmatter) of the work, or at the end of a section.

See also: rearnote

HTML usage context: sectioning content

Document text

Terms for describing components at the phrasing level.

credit [draft]

An acknowledgement of the source of cited content, or of a contribution to the work.

HTML usage context: phrasing content

keyword

A key word or phrase.

HTML usage context: phrasing content

topic-sentence

A phrase or sentence serving as an introductory summary of the containing paragraph.

HTML usage context: phrasing content

concluding-sentence

A phrase or sentence serving as a concluding summary of the containing paragraph.

HTML usage context: phrasing content

Tables

table

A structure containing data or content laid out in tabular form.

HTML usage context: Deprecated

Media Overlays usage context: Identifies a seq or par as an escapable or skippable table structure.

table-row

A row of data or content in a tabular structure.

HTML usage context: Deprecated

Media Overlays usage context: Identifies a seq or par as an escapable or skippable table row.

table-cell

A single cell of tabular data or content.

HTML usage context: Deprecated

Media Overlays usage context: Identifies a seq or par as an escapable or skippable table cell.

Lists

list

A structure that contains an enumeration of related content items.

HTML usage context: Deprecated

Media Overlays usage context: Identifies a seq or par as an escapable or skippable list structure.

list-item

A single item in an enumeration.

HTML usage context: Deprecated

Media Overlays usage context: Identifies a seq or par as an escapable or skippable list item.

Figures

figure

An illustration, diagram, photo, code listing or similar, referenced from the text of a work, and typically annotated with a title, caption and/or credits.

HTML usage context: Deprecated

Media Overlays usage context: Identifies a seq or par as an escapable or skippable figure.