<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
<TITLE>Linuxdoc Reference: Sectioning</TITLE>
<LINK HREF="Linuxdoc-Reference-7.html" REL=next>
<LINK HREF="Linuxdoc-Reference-5.html" REL=previous>
<LINK HREF="Linuxdoc-Reference.html#toc6" REL=contents>
</HEAD>
<BODY>
<A HREF="Linuxdoc-Reference-7.html">Next</A>
<A HREF="Linuxdoc-Reference-5.html">Previous</A>
<A HREF="Linuxdoc-Reference.html#toc6">Contents</A>
<HR>
<H2><A NAME="sections"></A> <A NAME="s6">6. Sectioning</A></H2>
<P>
<HR>
<PRE>
<!element chapt - o (%sect, sect*) +(footnote)>
<!element sect - o (%sect, sect1*) +(footnote)>
<!element sect1 - o (%sect, sect2*)>
<!element sect2 - o (%sect, sect3*)>
<!element sect3 - o (%sect, sect4*)>
<!element sect4 - o (%sect)>
</PRE>
<HR>
The <EM>sectioning</EM>
<BLOCKQUOTE>Also the <CODE>chapt</CODE> tag is a <EM>sectioning</EM>
tag.</BLOCKQUOTE>
is done by the according elements, forming the section tree.
They are bringing the various paragraphs within our document to follow a
nice tree.
The top level tag and the allowed depth is varying with the <EM>document
class</EM> (see section
<A HREF="Linuxdoc-Reference-4.html#linuxdoc">The Document Class</A>).
<P>The normal hierarchy is
<PRE>
chapt
sect
sect1
sect2
sect3
sect4
</PRE>
<P>Just take a book, look the table of conetents and you will see.
<P>Each of the tags out of the <EM>sectionings</EM> has nearly the same syntax.
All of them owe a <EM>heading</EM>.
The <CODE>heading</CODE> tag is placed implicitly if you don't note it down.
Also the each of the sectioning tags may contain a <CODE>header</CODE> tag, changing
the current document header (see section
<A HREF="Linuxdoc-Reference-4.html#header">The Header Tag</A>).
<P>Within the you may place subordinate sections and <EM>paragraphs</EM>
(see
<A HREF="Linuxdoc-Reference-7.html#paragraph">Paragraphs</A>).
<P>Some of the sectioning tags may only appear in special document classes (
<A HREF="Linuxdoc-Reference-4.html#linuxdoc">Document Classes</A>).
<P>
<DL>
<DT><B>Hint:</B><DD><P>It's wise to place a <EM>label</EM> tag after the text of the
<EM>section</EM> tag, even if you don't want to refer to the section
<A HREF="Linuxdoc-Reference-10.html#labelandreference">Labels and references</A>.
Later when your document grows you might want to.
</DL>
<P>
<P>
<HR>
<A HREF="Linuxdoc-Reference-7.html">Next</A>
<A HREF="Linuxdoc-Reference-5.html">Previous</A>
<A HREF="Linuxdoc-Reference.html#toc6">Contents</A>
</BODY>
</HTML>
