%FEDORA-ENTITIES-EN; ]> 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, a link to the entities file that contain common entities that should be used, and an entity to change the version and date of the tutorial.

Below is a sample parent file: <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ <!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../common/fedora-entities-en.xml"> %FEDORA-ENTITIES-EN; <!ENTITY VERSION "0.1"> <!-- change version of tutorial here --> <!ENTITY DOCID "example-tutorial-&VERSION; (2003-07-07)"> <!-- change last modified date here --> <!ENTITY LEGALNOTICE SYSTEM "../common/legalnotice-en.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 section, section, etc. </para> <warning> <title>Warning</title> <para> Example of an admonition. </para> </warning> </section> <index id="generated-index"></index> </article>

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.