In this chapter, you will find an example of a very short tutorial as used by the Fedora Documentation Project. This example is specific to the way the Docs Project uses DocBook XML. The example consists of a set of files used to hold the content and metadata for the tutorial.
Below is a sample article:
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % FEDORA-ENTITIES SYSTEM "fdp-entities.ent">
%FEDORA-ENTITIES;
]>
<article id="sample-tutorial" lang="en_US">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="fdp-info.xml"/>
<section id="some-section">
<title>Some Section</title>
<para>
This is an example section. You can nest sections or make
additional sections as needed.
</para>
<warning>
<title>Warning</title>
<para>
Example of an admonition.
</para>
</warning>
</section>
<index id="generated-index"/>
</article>