162 lines
7 KiB
XML
162 lines
7 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!-- Copyright (c) 2000 Nik Clayton, All rights reserved.
|
|
|
|
Redistribution and use in source (SGML DocBook) and 'compiled' forms
|
|
(SGML HTML, PDF, PostScript, RTF and so forth) with or without
|
|
modification, are permitted provided that the following conditions
|
|
are met:
|
|
|
|
1. Redistributions of source code (SGML DocBook) must retain the above
|
|
copyright notice, this list of conditions and the following
|
|
disclaimer as the first lines of this file unmodified.
|
|
|
|
2. Redistributions in compiled form (transformed to other DTDs,
|
|
converted to PDF, PostScript, RTF and other formats) must reproduce
|
|
the above copyright notice, this list of conditions and the
|
|
following disclaimer in the documentation and/or other materials
|
|
provided with the distribution.
|
|
|
|
THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR
|
|
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT,
|
|
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE
|
|
POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
$FreeBSD$
|
|
-->
|
|
<appendix xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
|
xml:id="examples">
|
|
|
|
<title>Examples</title>
|
|
|
|
<para>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 <acronym>XML</acronym> source for this and other
|
|
documents available in the <application>Subversion</application>
|
|
<literal>doc</literal> repository, or available online starting at
|
|
<uri
|
|
xlink:href="http://svnweb.FreeBSD.org/doc/">http://svnweb.FreeBSD.org/doc/</uri>.</para>
|
|
|
|
<sect1 xml:id="examples-docbook-book">
|
|
<title>DocBook <tag>book</tag></title>
|
|
|
|
<example>
|
|
<title>DocBook <tag>book</tag></title>
|
|
|
|
<programlisting><!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
|
|
"http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd">
|
|
|
|
<tag class="starttag">book xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
|
xml:lang="en"</tag>
|
|
|
|
<tag class="starttag">info</tag>
|
|
<tag class="starttag">title</tag>An Example Book<tag class="endtag">title</tag>
|
|
|
|
<tag class="starttag">author</tag>
|
|
<tag class="starttag">personname</tag>
|
|
<tag class="starttag">firstname</tag>Your first name<tag class="endtag">firstname</tag>
|
|
<tag class="starttag">surname</tag>Your surname<tag class="endtag">surname</tag>
|
|
<tag class="endtag">personname</tag>
|
|
|
|
<tag class="starttag">affiliation</tag>
|
|
<tag class="starttag">address</tag>
|
|
<tag class="starttag">email</tag>foo@example.com<tag class="endtag">email</tag>
|
|
<tag class="endtag">address</tag>
|
|
<tag class="endtag">affiliation</tag>
|
|
<tag class="endtag">author</tag>
|
|
|
|
<tag class="starttag">copyright</tag>
|
|
<tag class="starttag">year</tag>2000<tag class="endtag">year</tag>
|
|
<tag class="starttag">holder</tag>Copyright string here<tag class="endtag">holder</tag>
|
|
<tag class="endtag">copyright</tag>
|
|
|
|
<tag class="starttag">abstract</tag>
|
|
<tag class="starttag">para</tag>If your book has an abstract then it should go here.<tag class="endtag">para</tag>
|
|
<tag class="endtag">abstract</tag>
|
|
<tag class="endtag">info</tag>
|
|
|
|
<tag class="starttag">preface</tag>
|
|
<tag class="starttag">title</tag>Preface<tag class="endtag">title</tag>
|
|
|
|
<tag class="starttag">para</tag>Your book may have a preface, in which case it should be placed
|
|
here.<tag class="endtag">para</tag>
|
|
<tag class="endtag">preface</tag>
|
|
|
|
<tag class="starttag">chapter</tag>
|
|
<tag class="starttag">title</tag>My First Chapter<tag class="endtag">title</tag>
|
|
|
|
<tag class="starttag">para</tag>This is the first chapter in my book.<tag class="endtag">para</tag>
|
|
|
|
<tag class="starttag">sect1</tag>
|
|
<tag class="starttag">title</tag>My First Section<tag class="endtag">title</tag>
|
|
|
|
<tag class="starttag">para</tag>This is the first section in my book.<tag class="endtag">para</tag>
|
|
<tag class="endtag">sect1</tag>
|
|
<tag class="endtag">chapter</tag>
|
|
<tag class="endtag">book</tag></programlisting>
|
|
</example>
|
|
</sect1>
|
|
|
|
<sect1 xml:id="examples-docbook-article">
|
|
<title>DocBook <tag>article</tag></title>
|
|
|
|
<example>
|
|
<title>DocBook <tag>article</tag></title>
|
|
|
|
<programlisting><!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
|
|
"http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd">
|
|
|
|
<tag class="starttag">article xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
|
xml:lang="en"</tag>
|
|
|
|
<tag class="starttag">info</tag>
|
|
<tag class="starttag">title</tag>An Example Article<tag class="endtag">title</tag>
|
|
|
|
<tag class="starttag">author</tag>
|
|
<tag class="starttag">personname</tag>
|
|
<tag class="starttag">firstname</tag>Your first name<tag class="endtag">firstname</tag>
|
|
<tag class="starttag">surname</tag>Your surname<tag class="endtag">surname</tag>
|
|
<tag class="endtag">personname</tag>
|
|
|
|
<tag class="starttag">affiliation</tag>
|
|
<tag class="starttag">address</tag>
|
|
<tag class="starttag">email</tag>foo@example.com<tag class="endtag">email</tag>
|
|
<tag class="endtag">address</tag>
|
|
<tag class="endtag">affiliation</tag>
|
|
<tag class="endtag">author</tag>
|
|
|
|
<tag class="starttag">copyright</tag>
|
|
<tag class="starttag">year</tag>2000<tag class="endtag">year</tag>
|
|
<tag class="starttag">holder</tag>Copyright string here<tag class="endtag">holder</tag>
|
|
<tag class="endtag">copyright</tag>
|
|
|
|
<tag class="starttag">abstract</tag>
|
|
<tag class="starttag">para</tag>If your article has an abstract then it should go here.<tag class="endtag">para</tag>
|
|
<tag class="endtag">abstract</tag>
|
|
<tag class="endtag">info</tag>
|
|
|
|
<tag class="starttag">sect1</tag>
|
|
<tag class="starttag">title</tag>My First Section<tag class="endtag">title</tag>
|
|
|
|
<tag class="starttag">para</tag>This is the first section in my article.<tag class="endtag">para</tag>
|
|
|
|
<tag class="starttag">sect2</tag>
|
|
<tag class="starttag">title</tag>My First Sub-Section<tag class="endtag">title</tag>
|
|
|
|
<tag class="starttag">para</tag>This is the first sub-section in my article.<tag class="endtag">para</tag>
|
|
<tag class="endtag">sect2</tag>
|
|
<tag class="endtag">sect1</tag>
|
|
<tag class="endtag">article</tag></programlisting>
|
|
</example>
|
|
</sect1>
|
|
</appendix>
|