Reference. Reference for the DocBook DTD

[Prev] [Next]


Chapter

Name

Chapter---Chapter of a Book

Synopsis

Content Model
  ((DocInfo?, Title, TitleAbbrev?), ToCchap?
  , (((CalloutList | GlossList | ItemizedList | OrderedList
  | SegmentedList | SimpleList | VariableList | Caution
  | Important | Note | Tip | Warning | LiteralLayout
  | ProgramListing | ProgramListingCO | Screen | ScreenCO
  | ScreenShot | Synopsis | CmdSynopsis | FuncSynopsis
  | FormalPara | Para | SimPara | Address | BlockQuote
  | Graphic | GraphicCO | InformalEquation
  | InformalExample | InformalTable | Equation | Example
  | Figure | Table | MsgSet | Procedure | Sidebar | Anchor
  | BridgeHead | Comment | Highlights | Abstract
  | AuthorBlurb | Epigraph)+, (Sect1* | (RefEntry)*
  | SimpleSect*)) | (Sect1+ | (RefEntry)+ | SimpleSect+))
  , (Index | Glossary
  | Bibliography)*)+
  (IndexTerm | BeginPage)

Inclusions

Chapter includes these elements at every level:

  IndexTerm | BeginPage

Attributes

This element has common and Role attributes.

Name Value(s) Type Default Value
Label CDATA #IMPLIED  
Status CDATA #IMPLIED  

Tag Minimization

The start-tag is required for this element. The end-tag is optional, if your SGML declaration allows minimization.

Description

Chapter of a Book. Chapter may contain anything except higher-level elements such as Part, Book, and Set, or peers such as Appendix and Preface. A Chapter may begin with a DocInfo, followed by a required Title, optional TitleAbbrev, and body. The body may be either paragraphs and block-oriented elements or Sects containing them. At the beginning and end of the body of a Chapter, or the beginning and end of any Sect, there may be any number of ToCs, LoTs, Indexes, Glossaries, and Bibliographies, although these would appear only exceptionally. Chapter has Status, Label, and common attributes.

Parents

These elements contain Chapter: Book, and Part.

Children

Chapter contains these elements: Abstract, Address, Anchor, AuthorBlurb, BeginPage, Bibliography, BlockQuote, BridgeHead, CalloutList, Caution, CmdSynopsis, Comment, DocInfo, Epigraph, Equation, Example, Figure, FormalPara, FuncSynopsis, GlossList, Glossary, Graphic, GraphicCO, Highlights, Important, Index, IndexTerm, InformalEquation, InformalExample, InformalTable, ItemizedList, LiteralLayout, MsgSet, Note, OrderedList, Para, Procedure, ProgramListing, ProgramListingCO, RefEntry, Screen, ScreenCO, ScreenShot, Sect1, SegmentedList, Sidebar, SimPara, SimpleList, SimpleSect, Synopsis, Table, Tip, Title, TitleAbbrev, ToCchap, VariableList, and Warning.

In some contexts, additional elements may be allowed by inclusions in parent elements.

Attributes

Label

Label holds an identifying number or string to be output in some manner when the element it is applied to is rendered.

Status

Editorial or publication status ofthe element it applies to, such as "in review" or "approved for distribution." There is no default.

Examples

<CHAPTER LABEL="II">
<TITLE>A Chapter Devoted to Hierarchy</TITLE>
<TITLEABBREV>Hierarchy</TITLEABBREV>
<TOCCHAP>
<TOCENTRY>Hierarchy</TOCENTRY>
<TOCLEVEL1>
<TOCENTRY>Lonely at the Top</TOCENTRY>
</TOCLEVEL1>
<TOCLEVEL1>
<TOCENTRY>A Gravid Section</TOCENTRY>
</TOCLEVEL1>
</TOCCHAP>
<EPIGRAPH>
<ATTRIBUTION>Benjamin Franklin</ATTRIBUTION>
<PARA>In going on with these experiments, how many pretty systems do we build,
which we soon find ourselves obliged to destroy?</PARA>
</EPIGRAPH>
<HIGHLIGHTS>
<SIMPLELIST>
<MEMBER>Best of the Top</MEMBER>
<MEMBER>Best of the Middle</MEMBER>
<MEMBER>Best of the Bottom</MEMBER>
</SIMPLELIST>
</HIGHLIGHTS>
<SECT1
<TITLE>Lonely at the Top</TITLE>
<FORMALPARA>
<TITLE>A Formal Paragraph</TITLE>
<PARA>A short paragraph, but a formal one.</PARA>
</FORMALPARA>
<SIMPLESECT>
<TITLE>Don't Delve Deeper</TITLE>
<PARA>SimpleSects can't contain other Sects.
</PARA>
</SIMPLESECT>
</SECT1>
<SECT1>
<TITLE>A Gravid Section</TITLE>
<PARA>A short paragraph.</PARA>
<SECT2>
<TITLE>Under the Forest Canopy</TITLE>
<GLOSSARY>
<GLOSSENTRY>
<GLOSSTERM>fum
</GLOSSTERM>
<GLOSSDEF><PARA>Syllable following "fee, fie, fo"</PARA>
</GLOSSDEF>
</GLOSSENTRY>
</GLOSSARY>
<SIMPARA>A short, simple paragraph that can't contain
blocklike objects.</SIMPARA>
<BRIDGEHEAD RENDERAS="sect4">Down to Brass Tacks</BRIDGEHEAD>
<PARA>A short paragraph.</PARA>
<BRIDGEHEAD RENDERAS="sect4">Brass Tacks and Brass Tasks</BRIDGEHEAD>
<PARA>A short paragraph.</PARA>
<SECT3>
<TITLE>Delving Deeper</TITLE>
<PARA>A short paragraph.</PARA>
<SECT4>
<TITLE>We Like Short Sections</TITLE>
<PARA>A short paragraph.</PARA>
<SIDEBAR>
<TITLE>Feeling Out of the Flow?</TITLE>
<PARA>That's because you're in a Sidebar.</PARA>
</SIDEBAR>
<SECT5 RENDERAS="sect4">
<TITLE>Some Writers are Compulsive</TITLE>
<PARA>A short paragraph.</PARA>
</SECT5>
</SECT4>
</SECT3>
</SECT2>
</SECT1>
<BIBLIOGRAPHY>
<BIBLIOENTRY>
<BOOKBIBLIO>
<TITLE>Recursive Tooth Exercises
</TITLE>
<AUTHORGROUP>
<CORPAUTHOR>The Incisor Group
</CORPAUTHOR>
</AUTHORGROUP>
</BOOKBIBLIO>
</BIBLIOENTRY>
</BIBLIOGRAPHY>
<INDEX></INDEX>
</CHAPTER>


[Prev] chapter.class
[Next] Citation
[Reference Home] [Davenport Group Home]