Name
chapter — A chapter, as of a book
Synopsis
chapter ::=
((((title &
titleabbrev? & subtitle?),
info? db.titleforbidden.info) |
info db.titlereq.info),
((bibliography | glossary |
index | toc)*,
(((annotation | bridgehead |
remark | revhistory | Indexing inlines | Admonition elements | Formal elements | Graphic elements | Informal elements | List elements | Paragraph elements | Publishing elements | Synopsis elements | Technical elements | Verbatim elements)+,
((section+, simplesect*) |
simplesect+ | (sect1+,
simplesect*) | refentry+)?) |
(section+, simplesect*) |
simplesect+ | (sect1+,
simplesect*) | refentry+),
(bibliography | glossary | index |
toc)*))
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
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>