The part DTD is intended for a "normal" document, like
the User's Guide or Release Notes. First are some paragraphs
introducing the main contents. After that follows chapters,
written in separate files with the chapter DTD.
A typical part:
<?xml version="1.0" encoding="latin1" ?>
<!DOCTYPE part SYSTEM "part.dtd">
<part>
<header>
<title>The chapter title</title>
<prepared>The author</prepared>
<docno/>
<date/>
<rev/>
</header>
<description>
<p>Some text..</p>
</description>
<include file="file1"></include>
<include file="file2"></include>
</part>
The <header> part is described in
Header Tags.
The optional <description> part is described
below.
One or more chapter
files can be included using <include>, see
below.
The introduction after the title and before the bulk of included chapters/manual pages.
This tag is optional. Can contain any combination and any number
of block tags except
<image> and <table>.
A part or application document can include one or
more files. Which file to include is specified using
the file attribute. The .xml file extension should
be omitted.
Example:
<include file="notes"></include>
The chapter DTD is intended for segments of plain text.
The text is divided into sections, which can be nested.
An example:
<?xml version="1.0" encoding="latin1" ?>
<!DOCTYPE chapter SYSTEM "chapter.dtd">
<chapter>
<header>
<title>Title on first level</title>
<prepared/>
<docno/>
<date/>
<rev/>
</header>
<p>Introduction...</p>
<section>
<title>Title on second level</title>
<p>First paragraph.</p>
<p>Second paragraph etc.</p>
<section>
<title>Title on third level</title>
<p>...</p>
</section>
</section>
...
</chapter>
Between the header and the included files, there can be an introduction consisting of any combination of block tags.
Possibly nested subdivisions of the document. Contains an
optional
<marker>,
a title <title> containing plain text,
followed by any combination and any number of
<section> and block
tags.