LDP/LDP/users/Jason-Evans/Templates/Guide/ldp-guide-main.xml

254 lines
7.3 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY chap1 SYSTEM "ldp-guide-chap1.xml">
<!ENTITY chap2 SYSTEM "ldp-guide-chap2.xml">
<!-- and so on for each of your chapters -->
<!ENTITY app1 SYSTEM "ldp-appendix.xml">
<!ENTITY gloss SYSTEM "ldp-glossary.xml">
]>
<book>
<bookinfo>
<title>Your title</title>
<subtitle>An optional subtitle</subtitle>
<authorgroup>
<author>
<firstname>Your given name</firstname>
<surname>Your last name</surname>
<affiliation>
<orgname>Your organization</orgname>
<address>
<email>you@your.domain</email>
</address>
</affiliation>
</author>
</authorgroup>
<edition>Optional version information</edition>
<keywordset>
<keyword>Add</keyword>
<keyword>as</keyword>
<keyword>many</keyword>
<keyword>keywords</keyword>
<keyword>as</keyword>
<keyword>you</keyword>
<keyword>want</keyword>
<keyword>.</keyword>
</keywordset>
</bookinfo>
<preface>
<title>Introduction</title>
<section id="intro_01">
<title>Why was this document written?</title>
<para>Some explanations.</para>
</section>
<section id="intro_02">
<title>Audience</title>
<para>Explain for whom it has been written.</para>
</section>
<section id="intro_03">
<title>New versions of this doc</title>
<para>Point to <ulink url="http://somewhere.org">the latest version</ulink> of this document.</para>
</section>
<section id="intro_04">
<title>Revision History</title>
<para>
<revhistory>
<revision>
<revnumber>1.2</revnumber>
<date>2003-02-28</date>
<authorinitials>MG</authorinitials>
<revremark>More stuff you changed.</revremark>
</revision>
<revision>
<revnumber>1.1</revnumber>
<date>2003-01-22</date>
<authorinitials>MG</authorinitials>
<revremark>Stuff you changed.</revremark>
</revision>
<revision>
<revnumber>1.0</revnumber>
<date>2002-12-29</date>
<authorinitials>MG</authorinitials>
<revremark>Initial release for TLDP</revremark>
</revision>
</revhistory>
</para>
</section>
<section id="intro_05">
<title>Contributions</title>
<para>Thank people who helped realizing this doc.</para>
</section>
<section id="intro_06">
<title>Feedback</title>
<para>
Missing information, missing links, missing characters? Mail it to the
maintainer of this document: <address><email>you@your.domain</email></address>
</para>
</section>
<section id="intro_07">
<title>Copyright information</title>
<para>Copyright 2002 Your_first_name Your_last_name.
</para>
<para> Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or any later
version published by the Free Software Foundation; with no Invariant
Sections, with no Front-Cover Texts and no Back-Cover Texts. A copy of the
license is included in <xref linkend="app4" /> entitled <quote>GNU Free
Documentation License</quote>.
</para>
<para>Read <ulink url="http://www.fsf.org/gnu/manifesto.html">The GNU Manifesto
</ulink> if you want to know why this license was chosen for this book.
</para>
<para>The author and publisher have made every effort in the preparation of this
book to ensure the accuracy of the information. However, the information
contained in this book is offered without warranty, either express or implied.
Neither the author nor the publisher nor any dealer or distributor will be held
liable for any damages caused or alleged to be caused either directly or
indirectly by this book.
</para>
<para>The logos, trademarks and symbols used in this book are the properties of
their respective owners.
</para>
</section>
<section id="intro_08">
<title>What do you need?</title>
<para>List requirements: materials, knowledge.</para>
</section>
<section id="intro_09">
<title>Conventions used in this document</title>
<para>The following typographic and usage conventions occur in this text:
</para>
<table id="conventions" frame="all"><title>Typographic and usage conventions</title>
<tgroup cols="2" align="left" colsep="1" rowsep="1">
<thead>
<row><entry>Text type</entry><entry>Meaning</entry></row>
</thead>
<tbody>
<row>
<entry><quote>Quoted text</quote></entry>
<entry>Quotes from people, quoted computer output.</entry>
</row>
<row>
<entry><screen>terminal view</screen></entry>
<entry>Literal computer input and output captured from the terminal,
usually rendered with a light grey background.</entry>
</row>
<row>
<entry><command>command</command></entry>
<entry>Name of a command that can be entered on the command line.</entry>
</row>
<row>
<entry><varname>VARIABLE</varname></entry>
<entry>Name of a variable or pointer to content of a variable, as in
<varname>$VARNAME</varname>.</entry>
</row>
<row>
<entry><option>option</option></entry>
<entry>Option to a command, as in <quote>the <option>-a</option> option to the
<command>ls</command> command</quote>.</entry>
</row>
<row>
<entry><parameter>argument</parameter></entry>
<entry>Argument to a command, as in <quote>read
<command>man <parameter>ls</parameter></command></quote>.</entry>
</row>
<row>
<entry><cmdsynopsis><command>command <option>options</option>
<parameter>arguments</parameter></command></cmdsynopsis></entry>
<entry>Command synopsis or general usage, on a separated line.</entry>
</row>
<row>
<entry><filename>filename</filename></entry>
<entry>Name of a file or directory, for example <quote>Change to the
<filename>/usr/bin</filename> directory.</quote></entry>
</row>
<row>
<entry><keycap>Key</keycap></entry>
<entry>Keys to hit on the keyboard, such as <quote>type <keycap>Q</keycap>
to quit</quote>.</entry>
</row>
<row>
<entry><guibutton>Button</guibutton></entry>
<entry>Graphical button to click, like the <guibutton>OK</guibutton>
button.</entry>
</row>
<row>
<entry><menuchoice><guimenu>Menu</guimenu><guimenuitem>Choice</guimenuitem>
</menuchoice></entry>
<entry>Choice to select from a graphical menu, for instance: <quote>Select
<menuchoice><guimenu>Help</guimenu><guimenuitem>About Mozilla</guimenuitem>
</menuchoice> in your browser.</quote></entry>
</row>
<row>
<entry><emphasis>Terminology</emphasis></entry>
<entry>Important term or concept: <quote>The Linux <emphasis>kernel</emphasis>
is the heart of the system.</quote></entry>
</row>
<row>
<entry>See <xref linkend="chap_01" /></entry><entry>link to related subject
within this guide.</entry>
</row>
<row>
<entry><ulink url="http://tille.soti.org">The author</ulink></entry>
<entry>Clickable link to an external web resource.</entry>
</row>
</tbody>
</tgroup>
</table>
</section>
<section id="intro_10">
<title>Organization of this document</title>
<para>List chapters (and optionally, appendices) with a short content for each (only for longer docs).</para>
<itemizedlist>
<listitem><para><xref linkend="chap_01" />: short description.</para></listitem>
<listitem><para><xref linkend="chap_02" />: short description.</para></listitem>
<listitem><para><xref linkend="chap_03" />: short description.</para></listitem>
<listitem><para><xref linkend="chap_04" />: short description.</para></listitem>
<listitem><para><xref linkend="chap_05" />: short description.</para></listitem>
</itemizedlist>
</section>
</preface>
<toc></toc>
&chap1;
&chap2;
&app1;
&gloss;
</book>