Skip to main content

Section 31.1 Document Types and Publisher Options

Subsection 31.1.1 Supported Document Types

An EPUB file is produced from a <book>, with or without <part>, or from an <article>. No other document type is supported: a <slideshow>, <letter>, or <memo> halts the conversion with an error rather than producing a partial result.

Subsection 31.1.2 Publisher Options Not Consulted

Two options in the common section of the publication file shape other conversions but not this one. Neither needs to be set, setting either does no harm, and each produces a message reporting that it was not consulted, so nobody is left wondering why the output did not change.
The chunking level (Subsection 45.1.1) is always the default for the document’s structure. The choice has little consequence in an electronic book: a reading system presents the files as one continuous reading order, and the level governs only how large those files are. The default keeps them at a size reading systems handle well.
The table of contents level (Subsection 45.1.2) is not consulted either. The navigation of an EPUB file lists every file of the document, and a reading system provides its own control over how much of that to display at once.