(latex2e.info)Sectioning

---

Next: Cross references Prev: Layout Up: Top

---

Enter node , (file) or (file)node

6 Sectioning
************

Structure your text into divisions: parts, chapters, sections, etc.  All
sectioning commands have the same form, one of:

     SECTIONING-COMMAND{TITLE}
     SECTIONING-COMMAND*{TITLE}
     SECTIONING-COMMAND[TOC-TITLE]{TITLE}

For instance, declare the start of a subsection as with
'\subsection{Motivation}'.

   The table has each SECTIONING-COMMAND in LaTeX.  All are available in
all of LaTeX's standard document classes 'book', 'report',
and 'article', except that '\chapter' is not available in 'article'.

Sectioning unit    Command            Level
--------------------------------------------------------------------
Part               '\part'            -1 ('book', 'report'), 0
                                      ('article')
Chapter            '\chapter'         0
Section            '\section'         1
Subsection         '\subsection'      2
Subsubsection      '\subsubsection'   3
Paragraph          '\paragraph'       4
Subparagraph       '\subparagraph'    5

   All these commands have a '*'-form that prints TITLE as usual but is
not numbered and does not make an entry in the table of contents.  An
example of using this is for an appendix in an 'article' .  The input
'\appendix\section{Appendix}' gives the output 'A Appendix' (Note:
\appendix).  You can lose the numbering 'A' by instead entering
'\section*{Appendix}' (articles often omit a table of contents and have
simple page headers so the other differences from the '\section' command
may not matter).

   The section title TITLE provides the heading in the main text, but it
may also appear in the table of contents and in the running head or foot
(Note: Page styles).  You may not want the same text in these places
as in the main text.  All of these commands have an optional argument
TOC-TITLE for these other places.

   The level number in the table above determines which sectional units
are numbered, and which appear in the table of contents.  If the
sectioning command's LEVEL is less than or equal to the value of the
counter 'secnumdepth' then the titles for this sectioning command will
be numbered (Note: Sectioning/secnumdepth).  And, if LEVEL is less
than or equal to the value of the counter 'tocdepth' then the table of
contents will have an entry for this sectioning unit (Note:
Sectioning/tocdepth).

   LaTeX expects that before you have a '\subsection' you will have a
'\section' and, in a book, that before a '\section' you will have a
'\chapter'.  Otherwise you can get a something like a subsection
numbered '3.0.1'.

   Two counters relate to the appearance of sectioning commands.

'secnumdepth'
     Controls which sectioning commands are numbered.  Suppress
     numbering of sectioning at any depth greater than LEVEL
     '\setcounter{secnumdepth}{LEVEL}' (Note: \setcounter).  See the
     above table for the level numbers.  For instance, if the
     'secnumdepth' is 1 in an 'article' then a '\section{Introduction}'
     command will produce output like '1 Introduction' while
     '\subsection{Discussion}' will produce output like 'Discussion',
     without the number.  LaTeX's default 'secnumdepth' is 3 in
     'article' class and  2 in the 'book' and 'report' classes.

'tocdepth'
     Controls which sectioning units are listed in the table of
     contents.  The setting '\setcounter{tocdepth}{LEVEL}' makes the
     sectioning units at LEVEL be the smallest ones listed (Note:
     \setcounter).  See the above table for the level numbers.  For
     instance, if 'tocdepth' is 1 then the table of contents will list
     sections but not subsections.  LaTeX's default 'secnumdepth' is 3
     in 'article' class and  2 in the 'book' and 'report' classes.

\part

Start a part.

\chapter

Start a chapter.

\section

Start a section.

\subsection

Start a subsection.

\subsubsection & \paragraph & \subparagraph

Lower divisions.

\appendix

Start appendices.

\frontmatter & \mainmatter & \backmatter

The three parts of a book.

\@startsection

Layout of sectional units.