The Layout of a Tutorial
In this chapter, you will find an example of a &PROJECT; documentation
parent file. This example is specific to the way the Docs Project uses
DocBook XML. The parent file contains the main structural format of the
book, entities that should be used for this book specifically and more.
The Parent File
Below is a sample parent file:
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY RH "Red Hat"> <!--The generic term "Red Hat" -->
<!ENTITY FORMAL-RHI "&RH;, Inc."> <!--The generic term "Red Hat, Inc. -->
<!ENTITY PROJECT "Fedora project"> <!-- Set the project name -->
<!ENTITY NAME-TITLE "Fedora Project"> <!-- Set the project name, use for titles -->
<!ENTITY DISTRO "Fedora Core"> <!-- Set the distro name -->
<!ENTITY BOOKID "example-tutorial-0.1 (2003-07-07)"> <!-- change version of manual and date here -->
<!ENTITY LEGALNOTICE SYSTEM "../legalnotice.xml">
]>
<article id="example-tutorial" lang="en">
<articleinfo>
<title>Example Tutorial</title>
<copyright>
<year>2003</year>
<holder>&FORMAL-RHI;</holder>
<holder>Tammy Fox</holder>
</copyright>
<authorgroup>
<author>
<surname>Fox</surname>
<firstname>Tammy</firstname>
</author>
</authorgroup>
&LEGALNOTICE;
</articleinfo>
<section id="some-section">
<title>Some Section</title>
<para>
This is an example section. You can also use sect1, sect2, etc.
</para>
<warning>
<title>Warning</title>
<para>
Example of an admonition.
</para>
</warning>
</section>
</article>
Including the License Information
tutorial layout
license
All &PROJECT; manuals must contain the file
legalnotice.xml. This file makes the license for
the file the GNU Free Documentation License (FDL).
The sample parent file shows how it is included.