74 lines
2.6 KiB
HTML
74 lines
2.6 KiB
HTML
<!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>
|