<!doctype debiandoc system>to indicate that the document is a Debiandoc-SGML file.
The document should start with the <book>
tag and end with
</book>
.
This should be followed by the <title>
, one or more
<author>
-<email>
pairs, and optionally a
<version>
. Each of these is a piece of marked-up inline
text - see Marked-up inline text and character style markup
, chapter 4. The <version>
may also
contain <date>
which stands for the date at the time the
document is formatted.
Then may come an <abstract>
and a <copyright>
notice and a
<toc>
marker.
The <abstract>
contains a single paragraph.
The <copyright>
notice contains a copyright summary (this
is used, for example, at the bottom of every HTML page) followed by
one or more paragraphs, the first of which must be indicated by a
<p>
tag to distinguish it from the summary.
The <toc>
marker specifies that a table of contents is to be
produced. The <toc>
doesn't contain anything in the SGML
source - its contents are generated by the processing systems. The
<toc>
can have an attribute saying how detailed it should be;
for example, <toc sect1>
says that subsections should be
included, whereas <toc chapt>
says that only chapters should be
included. The values allowed are chapt
, sect
, sect1
and sect2
.
Following these parts comes the body of the document - one or more
chapters <chapt>
.
It is not necessary to mark the end of the <title>
,
<author>
s, <version>
, <abstract>
and
<copyright>
elements - they are implicitly ended by the
start of the next element.