229 lines
10 KiB
XML
229 lines
10 KiB
XML
<set xmlns="http://docbook.org/ns/docbook" version="5.0"
|
||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||
xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
|
||
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||
xml:base="../docsrc/"
|
||
>
|
||
<!-- * WARNING WARNING WARNING -->
|
||
<!-- * WARNING WARNING WARNING -->
|
||
<!-- * -->
|
||
<!-- * This document has duplicate IDs in it and is intended for -->
|
||
<!-- * processing using the chunk.xsl stylesheet to generate chunked -->
|
||
<!-- * output from it (not for generating a single HTML output file) -->
|
||
<!-- * -->
|
||
<!-- * WARNING WARNING WARNING -->
|
||
<!-- * WARNING WARNING WARNING -->
|
||
<title>DocBook XSL Stylesheets: Reference Documentation</title>
|
||
<info><releaseinfo role="meta">$Id: reference.xml 8321 2009-03-12 18:20:36Z mzjn $ </releaseinfo>
|
||
<xi:include href="./authors.xml"/>
|
||
<xi:include href="./copyright.xml" xpointer="xpointer(//*[local-name() = 'copyright'])"/>
|
||
<xi:include href="./license.xml"/>
|
||
<xi:include href="./warranty.xml"/>
|
||
<abstract xml:id="about">
|
||
<title>About this document</title>
|
||
<para>This is generated reference documentation for the DocBook
|
||
XSL stylesheets. It is available in the following formats:
|
||
<itemizedlist>
|
||
<listitem>
|
||
<para><link
|
||
xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/reference.html"
|
||
>HTML</link>,
|
||
<link
|
||
xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/reference.pdf"
|
||
>PDF</link>,
|
||
<link
|
||
xlink:href="http://docbook.sourceforge.net/release/xsl/current/doc/reference.txt"
|
||
>plain text</link></para>
|
||
</listitem>
|
||
</itemizedlist>
|
||
This is primarily documentation on the parameters and processing instructions you can use
|
||
to control the behavior of the stylesheets.
|
||
<note>
|
||
<para>This is purely reference documentation – not how-to
|
||
documentation. For a thorough step-by-step how-to guide to
|
||
publishing content using the DocBook XSL stylesheets, see
|
||
Bob Stayton’s <link
|
||
xlink:href="http://www.sagehill.net/book-description.html"
|
||
>DocBook XSL: The Complete Guide</link>, available online
|
||
at <link
|
||
xlink:href="http://www.sagehill.net/docbookxsl/index.html"
|
||
>http://www.sagehill.net/docbookxsl/index.html</link>
|
||
</para>
|
||
</note>
|
||
This document is divided into three sets of references:
|
||
the first two sets provides user documentation; the third,
|
||
developer documentation.</para>
|
||
</abstract>
|
||
</info>
|
||
<book xml:id="param"><title>DocBook XSL Stylesheets User Reference: Parameters</title>
|
||
<info>
|
||
<abstract>
|
||
<para>This is generated reference documentation for all
|
||
user-configurable parameters in the DocBook XSL
|
||
stylesheets.
|
||
<note>
|
||
<para>This is purely reference documentation – not how-to
|
||
documentation. For a thorough step-by-step how-to guide to
|
||
publishing content using the DocBook XSL stylesheets, see
|
||
Bob Stayton’s <link
|
||
xlink:href="http://www.sagehill.net/book-description.html"
|
||
>DocBook XSL: The Complete Guide</link>, available online
|
||
at <link
|
||
xlink:href="http://www.sagehill.net/docbookxsl/index.html"
|
||
>http://www.sagehill.net/docbookxsl/index.html</link>
|
||
</para>
|
||
</note>
|
||
</para>
|
||
</abstract>
|
||
</info>
|
||
<part xml:id="html">
|
||
<?dbhtml dir="html"?>
|
||
<?dbhtml filename="index.html"?>
|
||
<xi:include href="../html/param.xml" xpointer="xpointer(/book/info/title)" />
|
||
<partintro xml:id="htmlintro">
|
||
<xi:include href="../html/param.xml" xpointer="xpointer(/book/info/abstract/node())" />
|
||
</partintro>
|
||
<xi:include href="../html/param.xml" xpointer="xpointer(/book/reference)" />
|
||
</part>
|
||
<part xml:id="fo">
|
||
<?dbhtml dir="fo"?>
|
||
<?dbhtml filename="index.html"?>
|
||
<xi:include href="../fo/param.xml" xpointer="xpointer(/book/info/title)" />
|
||
<partintro xml:id="fointro">
|
||
<xi:include href="../fo/param.xml" xpointer="xpointer(/book/info/abstract/node())" />
|
||
</partintro>
|
||
<xi:include href="../fo/param.xml" xpointer="xpointer(/book/reference)" />
|
||
</part>
|
||
<part xml:id="manpages">
|
||
<?dbhtml dir="manpages"?>
|
||
<?dbhtml filename="index.html"?>
|
||
<xi:include href="../manpages/param.xml" xpointer="xpointer(/book/info/title)" />
|
||
<partintro xml:id="manintro">
|
||
<xi:include href="../manpages/param.xml" xpointer="xpointer(/book/info/abstract/node())" />
|
||
</partintro>
|
||
<xi:include href="../manpages/param.xml" xpointer="xpointer(/book/reference)" />
|
||
</part>
|
||
<part xml:id="roundtrip">
|
||
<?dbhtml dir="roundtrip"?>
|
||
<?dbhtml filename="index.html"?>
|
||
<xi:include href="../roundtrip/param.xml" xpointer="xpointer(/book/info/title)" />
|
||
<partintro xml:id="roundtripintro">
|
||
<xi:include href="../roundtrip/param.xml" xpointer="xpointer(/book/info/abstract/node())" />
|
||
</partintro>
|
||
<xi:include href="../roundtrip/param.xml" xpointer="xpointer(/book/reference/node()[not(self::title)])" />
|
||
</part>
|
||
<part xml:id="slides"><title>Slides Parameter Reference</title>
|
||
<?dbhtml dir="slides"?>
|
||
<?dbhtml filename="index.html"?>
|
||
<partintro xml:id="slidesintro">
|
||
<para>This is reference documentation for all
|
||
user-configurable parameters in the DocBook XSL Slides
|
||
stylesheets (for generating HTML and PDF slide
|
||
presentations).</para>
|
||
<note>
|
||
<para>The Slides stylesheet for HTML output is a
|
||
customization layer of the DocBook XSL HTML
|
||
stylesheet; the Slides stylesheet for FO output is a
|
||
customization layer of the DocBook XSL FO stylesheet.
|
||
Therefore, in addition to the slides-specific
|
||
parameters listed in this section, you can also use a
|
||
number of <link xlink:href="../html">HTML stylesheet
|
||
parameters</link> and <link xlink:href="../fo">FO
|
||
stylesheet parameters</link> to control Slides
|
||
output.</para>
|
||
</note>
|
||
</partintro>
|
||
<xi:include href="../slides/html/param.xml" xpointer="xpointer(/book/reference)" />
|
||
<xi:include href="../slides/fo/param.xml" xpointer="xpointer(/book/reference)" />
|
||
</part>
|
||
<part xml:id="website">
|
||
<?dbhtml dir="website"?>
|
||
<?dbhtml filename="index.html"?>
|
||
<xi:include href="../website/param.xml" xpointer="xpointer(/book/info/title)" />
|
||
<partintro xml:id="websiteintro">
|
||
<xi:include href="../website/param.xml" xpointer="xpointer(/book/info/abstract/node())" />
|
||
</partintro>
|
||
<xi:include href="../website/param.xml" xpointer="xpointer(/book/reference)" />
|
||
</part>
|
||
</book>
|
||
<book xml:id="pi"><title>DocBook XSL Stylesheets User Reference: PIs</title>
|
||
<?dbhtml dir="pi"?>
|
||
<?dbhtml filename="index.html"?>
|
||
<info>
|
||
<abstract>
|
||
<para>This is generated reference documentation for all
|
||
user-specifiable processing instructions in the DocBook
|
||
XSL stylesheets.
|
||
<note>
|
||
<para>You add these PIs at particular points in a document to
|
||
cause specific “exceptions” to formatting/output behavior. To
|
||
make global changes in formatting/output behavior across an
|
||
entire document, it’s better to do it by setting an
|
||
appropriate stylesheet parameter (if there is one).</para>
|
||
</note>
|
||
</para>
|
||
</abstract>
|
||
</info>
|
||
<part xml:id="pi-html">
|
||
<xi:include href="../html/pi.xml" xpointer="xpointer(/reference/node())" />
|
||
</part>
|
||
<part xml:id="pi-fo">
|
||
<xi:include href="../fo/pi.xml" xpointer="xpointer(/reference/node())" />
|
||
</part>
|
||
<part xml:id="pi-man">
|
||
<xi:include href="../manpages/pi.xml" xpointer="xpointer(/reference/node())" />
|
||
</part>
|
||
<part xml:id="pi-common">
|
||
<xi:include href="../common/pi.xml" xpointer="xpointer(/reference/node())" />
|
||
</part>
|
||
</book>
|
||
<book xml:id="developer"><title>DocBook XSL Stylesheets Developer Reference</title>
|
||
<info>
|
||
<abstract>
|
||
<para>This is technical reference documentation for
|
||
developers using the DocBook XSL Stylesheets. It is not
|
||
intended to be user documentation, but is instead
|
||
provided for developers writing customization layers for
|
||
the stylesheets.</para>
|
||
</abstract>
|
||
</info>
|
||
<part xml:id="lib">
|
||
<?dbhtml dir="lib"?>
|
||
<?dbhtml filename="index.html"?>
|
||
<xi:include href="../lib/lib.xml" xpointer="xpointer(/book/info/title)" />
|
||
<partintro xml:id="libintro">
|
||
<xi:include href="../lib/lib.xml" xpointer="xpointer(/book/info/abstract/node())" />
|
||
</partintro>
|
||
<xi:include href="../lib/lib.xml" xpointer="xpointer(/book/reference)" />
|
||
</part>
|
||
<part xml:id="common-part"><title>Common Template Reference</title>
|
||
<?dbhtml dir="common"?>
|
||
<?dbhtml filename="index.html"?>
|
||
<info>
|
||
<abstract>
|
||
<para>This is technical reference documentation for the
|
||
“base”, “refentry”, and “utility” sets of common
|
||
templates in the DocBook XSL Stylesheets. These
|
||
templates are “common” in that they are shared across
|
||
output formats (that is, they’re not
|
||
output-format-dependent)</para>
|
||
<para>This documentation is not intended to be user
|
||
documentation. It is provided for developers writing
|
||
customization layers for the stylesheets.</para>
|
||
</abstract>
|
||
</info>
|
||
<xi:include href="../common/common.xml"/>
|
||
<xi:include href="../common/refentry.xml"/>
|
||
<xi:include href="../common/utility.xml"/>
|
||
<xi:include href="../common/charmap.xml"/>
|
||
</part>
|
||
<part xml:id="table-templates">
|
||
<xi:include href="../fo/table.xml" xpointer="xpointer(/reference/node())"/>
|
||
</part>
|
||
<part xml:id="template">
|
||
<xi:include href="../template/titlepage.xml" xpointer="xpointer(/reference/node())"/>
|
||
</part>
|
||
</book>
|
||
</set>
|
||
<!-- * vim: set ft=docbk foldlevel=2: -->
|