Next: @unnumbered, @appendix: Chapters with Other Labeling, Previous: Structuring Command Types, Up: Chapter Structuring [Contents][Index]
@chapter: Chapter Structuring@chapter identifies a chapter in the document–the highest
level of the normal document structuring hierarchy. Write the command
at the beginning of a line and follow it on the same line by the title
of the chapter. The chapter is numbered automatically, starting
from 1.
For example, the present chapter in this manual is entitled
“@chapter: Chapter Structuring”; the @chapter line
looks like this:
@chapter @code{@@chapter}: Chapter Structuring
In TeX, the @chapter command produces a chapter heading in
the document.
In Info and plain text output, the @chapter command causes the
title to appear on a line by itself, with a line of asterisks inserted
underneath. So, the above example produces the following output:
5 Chapter Structuring *********************
In HTML, the @chapter command produces an <h2>-level
header by default (controlled by the CHAPTER_HEADER_LEVEL
customization variable, see Other Customization Variables).
In the XML and DocBook output, a <chapter> element is produced
that includes all the following sections, up to the next chapter.