This appendix contains example XML files and the commands to convert them from one output format to another. After installing the Documentation Project tools (see Section 2.1, “Required Tools”), these examples can be used directly.
These examples are not exhaustive—they do not contain
all the elements that might be desirable to use, particularly in a
document's front matter. For more examples of DocBook markup,
examine the XML source for this and other
documents available in the svn
doc
repository, or available online starting at
http://svnweb.FreeBSD.org/doc/.
To avoid confusion, these examples use the standard DocBook 4.1 DTD rather than the FreeBSD extension. They also use the stock stylesheets distributed by Norm Walsh, rather than any customizations made to those stylesheets by the FreeBSD Documentation Project. This makes them more useful as generic DocBook examples.
book
<book lang='en'>
<bookinfo>
<title>
An Example Book</title>
<author>
<firstname>
Your first name</firstname>
<surname>
Your surname</surname>
<affiliation>
<address>
<email>
foo@example.com</email>
</address>
</affiliation>
</author>
<copyright>
<year>
2000</year>
<holder>
Copyright string here</holder>
</copyright>
<abstract>
<para>
If your book has an abstract then it should go here.</para>
</abstract>
</bookinfo>
<preface>
<title>
Preface</title>
<para>
Your book may have a preface, in which case it should be placed
here.</para>
</preface>
<chapter>
<title>
My First Chapter</title>
<para>
This is the first chapter in my book.</para>
<sect1>
<title>
My First Section</title>
<para>
This is the first section in my book.</para>
</sect1>
</chapter>
</book>
All FreeBSD documents are available for download at http://ftp.FreeBSD.org/pub/FreeBSD/doc/
Questions that are not answered by the
documentation may be
sent to <freebsd-questions@FreeBSD.org>.
Send questions about this document to <freebsd-doc@FreeBSD.org>.