chapter
chapter — A chapter, as of a book.
Synopsis
chapter ::= ![[-]](figs/web/nav/down.gif)
![[+]](figs/web/nav/right.gif)
- Sequence of:
- One of:
- Optionally one of:
- Sequence of:
- Zero or more of:
- One of:
- Sequence of:
- One or more of:
annotationbridgeheadremarkrevhistory- Indexing inlines
- Admonition elements
- Formal elements
- Graphic elements
- Informal elements
informalequationinformalexampleinformalfigureinformaltable(db.cals.informaltable)informaltable(db.html.informaltable)
- List elements
- Paragraph elements
- Publishing elements
- Synopsis elements
- Technical elements
- Verbatim elements
- Optionally one of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- One or more of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- Zero or more of:
- One or more of:
- Sequence of:
- One of:
Attributes
Additional Constraints
- If this element is the root element, it must have a version attribute.
Description
A chapter is a chapter of a book.
Processing expectations
Formatted as a displayed block. Usually introduces a forced page break and often starts on the next recto page. The first chapter of a document usually restarts page numbering. Typically, chapters are numbered and presented in the table of contents.
Attributes
Common attributes and common linking attributes.
- label
Specifies an identifying string for presentation purposes
- status
Identifies the editorial or publication status of the element on which it occurs
Children
The following elements occur in chapter: address, anchor, annotation, bibliography, bibliolist, blockquote, bridgehead, calloutlist, caution, classsynopsis, cmdsynopsis, constraintdef, constructorsynopsis, destructorsynopsis, epigraph, equation, example, fieldsynopsis, figure, formalpara, funcsynopsis, glossary, glosslist, important, index, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titlereq.info), informalequation, informalexample, informalfigure, informaltable (db.cals.informaltable), informaltable (db.html.informaltable), itemizedlist, literallayout, mediaobject, methodsynopsis, msgset, note, orderedlist, para, procedure, productionset, programlisting, programlistingco, qandaset, refentry, remark, revhistory, screen, screenco, screenshot, sect1, section, segmentedlist, sidebar, simpara, simplelist, simplesect, subtitle, synopsis, table (db.cals.table), table (db.html.table), task, tip, title, titleabbrev, toc, topic, variablelist, warning.
Examples
<chapter xmlns='http://docbook.org/ns/docbook'
label="6" xml:id="figures" version="5.0">
<info>
<title>Pictures and Figures</title>
<keywordset>
<keyword>images</keyword>
<keyword>illustrations</keyword>
</keywordset>
<itermset>
<indexterm zone="figures"><primary>Figures</primary></indexterm>
<indexterm zone="figures"><primary>Pictures</primary></indexterm>
<indexterm zone="notreal">
<primary>Sections</primary><secondary>Not Real</secondary>
</indexterm>
</itermset>
</info>
<epigraph>
<attribution>William Safire</attribution>
<para>Knowing how things work is the basis for appreciation, and is
thus a source of civilized delight.
</para>
</epigraph>
<para>Pictures and figures …
</para>
<sect1><title>Top Level Section</title>
<para>…
</para>
<bridgehead xml:id="notreal" renderas='sect3'>Not a Real Section</bridgehead>
<para>This paragraph appears to be under a Sect3 heading, but it's really
in the same Sect1 as the preceding paragraph.
</para>
</sect1>
</chapter>