|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
-->
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
xmlns:doc="http://nwalsh.com/xsl/documentation/1.0"
|
|
Packit |
e4b6da |
xmlns="http://docbook2x.sourceforge.net/xmlns/Texi-XML"
|
|
Packit |
e4b6da |
version='1.0'
|
|
Packit |
e4b6da |
xml:lang="en">
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
$Id: param.xsl,v 1.38 2006/04/15 14:56:45 stevecheng Exp $
|
|
Packit |
e4b6da |
********************************************************************
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
(C) 2000-2004 Steve Cheng <stevecheng@users.sourceforge.net>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
This file is part of the docbook2X XSLT stylesheets for
|
|
Packit |
e4b6da |
converting DocBook to Texinfo.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
See ../../COPYING for the copyright status of this software.
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
******************************************************************** -->
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:reference xmlns="">
|
|
Packit |
e4b6da |
<title>Stylesheet parameters</title>
|
|
Packit |
e4b6da |
<partintro>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
Stylesheet parameters influence various aspects of the rendering. They
|
|
Packit |
e4b6da |
can be set from the command line (the exact syntax depends on the XSLT
|
|
Packit |
e4b6da |
processor), or in a custom stylesheet.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
To set them in a custom stylesheet, simply copy the definition here and
|
|
Packit |
e4b6da |
change the <sgmltag class="attribute">select</sgmltag> attribute to
|
|
Packit |
e4b6da |
something else.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
If a parameter for what you want to change does not exist, you can write
|
|
Packit |
e4b6da |
templates in the custom stylesheet instead.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</partintro>
|
|
Packit |
e4b6da |
</doc:reference>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="user-message-prefix" select="'docbook2texi:'" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="captions-display-as-headings" select="false()" />
|
|
Packit |
e4b6da |
<doc:param name="captions-display-as-headings" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Use heading markup for minor captions?</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>If true, <sgmltag class="element">title</sgmltag>
|
|
Packit |
e4b6da |
content in some (formal) objects are rendered with the Texinfo
|
|
Packit |
e4b6da |
<markup>@<replaceable>heading</replaceable></markup> commands.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
If false, captions are rendered as an emphasized paragraph.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="links-use-pxref" select="true()" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="links-use-pxref" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Translate <sgmltag class="element">link</sgmltag> using
|
|
Packit |
e4b6da |
<markup>@pxref</markup></refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
If true, <sgmltag class="element">link</sgmltag> is translated
|
|
Packit |
e4b6da |
with the hypertext followed by the cross reference in parentheses.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
Otherwise, the hypertext content serves as the cross-reference name
|
|
Packit |
e4b6da |
marked up using <markup>@ref</markup>. Typically info displays this
|
|
Packit |
e4b6da |
contruct badly.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="explicit-node-names" select="false()" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="explicit-node-names" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Insist on manually constructed Texinfo node
|
|
Packit |
e4b6da |
names</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
Elements in the source document can influence the Texinfo node name
|
|
Packit |
e4b6da |
generation specifying either a
|
|
Packit |
e4b6da |
class="attribute">xreflabel</sgmltag>, or for the sectioning elements,
|
|
Packit |
e4b6da |
a <sgmltag class="element">title</sgmltag> with
|
|
Packit |
e4b6da |
class="attribute">role='texinfo-node'</sgmltag> in the
|
|
Packit |
e4b6da |
<sgmltag class="element"><replaceable>*</replaceable>info</sgmltag> container.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
However, for the majority of source documents, explicit Texinfo node
|
|
Packit |
e4b6da |
names are not available, and the stylesheet tries to generate a
|
|
Packit |
e4b6da |
reasonable one instead, e.g. from the normal title of an element.
|
|
Packit |
e4b6da |
The generated name may not be optimal. If this option is set and the
|
|
Packit |
e4b6da |
stylesheet needs to generate a name, a warning is emitted and
|
|
Packit |
e4b6da |
<function>generate-id</function> is always used for the name.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
When the hashtable extension is not available, the stylesheet cannot
|
|
Packit |
e4b6da |
check for node name collisions, and in this case, setting this option
|
|
Packit |
e4b6da |
and using explicit node names are recommended.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
This option is not set (i.e. false) by default.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<note>
|
|
Packit |
e4b6da |
<para>The absolute fallback for generating node names is using the XSLT
|
|
Packit |
e4b6da |
function <function>generate-id</function>, and the stylesheet always
|
|
Packit |
e4b6da |
emits a warning in this case regardless of the setting of
|
|
Packit |
e4b6da |
<parameter>explicit-node-names</parameter>.</para>
|
|
Packit |
e4b6da |
</note>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="show-comments" select="true()"/>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="show-comments" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Display <sgmltag>comment</sgmltag> elements?</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>If true, comments will be displayed, otherwise they are suppressed.
|
|
Packit |
e4b6da |
Comments here refers to the <sgmltag>comment</sgmltag> element,
|
|
Packit |
e4b6da |
which will be renamed <sgmltag>remark</sgmltag> in DocBook V4.0,
|
|
Packit |
e4b6da |
not XML comments (<-- like this -->) which are unavailable.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="funcsynopsis-decoration" select="true()" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="funcsynopsis-decoration" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Decorate elements of a FuncSynopsis?</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>If true, elements of the FuncSynopsis will be decorated (e.g. bold or
|
|
Packit |
e4b6da |
italic). The decoration is controlled by functions that can be redefined
|
|
Packit |
e4b6da |
in a customization layer.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="function-parens" select="false()" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="function-parens" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Generate parentheses after a function?</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>If true, the formatting of
|
|
Packit |
e4b6da |
a <sgmltag class="starttag">function</sgmltag> element will include
|
|
Packit |
e4b6da |
generated parenthesis.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="refentry-display-name" select="true()"/>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="refentry-display-name" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Output NAME header before 'RefName'(s)?</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>If true, a "NAME" section title is output before the list
|
|
Packit |
e4b6da |
of 'RefName's.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="manvolnum-in-xref" select="true()"/>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="manvolnum-in-xref" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Output <sgmltag>manvolnum</sgmltag> as part of
|
|
Packit |
e4b6da |
<sgmltag>refentry</sgmltag> cross-reference?</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>if true, the <sgmltag>manvolnum</sgmltag> is used when cross-referencing
|
|
Packit |
e4b6da |
<sgmltag>refentry</sgmltag>s, either with <sgmltag>xref</sgmltag>
|
|
Packit |
e4b6da |
or <sgmltag>citerefentry</sgmltag>.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="prefer-textobjects" select="true()" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="prefer-textobjects" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Prefer <sgmltag class="element">textobject</sgmltag>
|
|
Packit |
e4b6da |
over <sgmltag class="element">imageobject</sgmltag>?
|
|
Packit |
e4b6da |
</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
If true, the
|
|
Packit |
e4b6da |
<sgmltag class="element">textobject</sgmltag>
|
|
Packit |
e4b6da |
in a <sgmltag class="element">mediaobject</sgmltag>
|
|
Packit |
e4b6da |
is preferred over any
|
|
Packit |
e4b6da |
<sgmltag class="element">imageobject</sgmltag>.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
(Of course, for output formats other than Texinfo, you usually
|
|
Packit |
e4b6da |
want to prefer the <sgmltag class="element">imageobject</sgmltag>,
|
|
Packit |
e4b6da |
but Info is a text-only format.)
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
In addition to the values true and false, this parameter
|
|
Packit |
e4b6da |
may be set to <literal>2</literal> to indicate that
|
|
Packit |
e4b6da |
both the text and the images should be output.
|
|
Packit |
e4b6da |
You may want to do this because some Texinfo viewers
|
|
Packit |
e4b6da |
can read images. Note that the Texinfo <markup>@image</markup>
|
|
Packit |
e4b6da |
command has its own mechanism for switching between text
|
|
Packit |
e4b6da |
and image output — but we do not use this here.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
The default is true.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="semantic-decorations" select="true()" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="semantic-decorations" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Use Texinfo semantic inline markup?</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
If true, the semantic inline markup of DocBook is translated into
|
|
Packit |
e4b6da |
(the closest) Texinfo equivalent. This is the default.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
However, because the Info format is limited to plain text,
|
|
Packit |
e4b6da |
the semantic inline markup is often distinguished by using
|
|
Packit |
e4b6da |
explicit quotes, which may not look good.
|
|
Packit |
e4b6da |
You can set this option to false to suppress these.
|
|
Packit |
e4b6da |
(For finer control over the inline formatting, you can
|
|
Packit |
e4b6da |
use your own stylesheet.)
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="custom-localization-file" select="''" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="custom-localization-file" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>URI of XML document containing custom localization data</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
This parameter specifies the URI of a XML document
|
|
Packit |
e4b6da |
that describes text translations (and other locale-specific information)
|
|
Packit |
e4b6da |
that is needed by the stylesheet to process the DocBook document.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
The text translations pointed to by this parameter always
|
|
Packit |
e4b6da |
override the default text translations
|
|
Packit |
e4b6da |
(from the internal parameter <parameter>localization-file</parameter>).
|
|
Packit |
e4b6da |
If a particular translation is not present here,
|
|
Packit |
e4b6da |
the corresponding default translation
|
|
Packit |
e4b6da |
is used as a fallback.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
This parameter is primarily for changing certain
|
|
Packit |
e4b6da |
punctuation characters used in formatting the source document.
|
|
Packit |
e4b6da |
The settings for punctuation characters are often specific
|
|
Packit |
e4b6da |
to the source document, but can also be dependent on the locale.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
To not use custom text translations, leave this parameter
|
|
Packit |
e4b6da |
as the empty string.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
select="document($custom-localization-file)" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="custom-l10n-data" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>XML document containing custom localization data</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
This parameter specifies the XML document
|
|
Packit |
e4b6da |
that describes text translations (and other locale-specific information)
|
|
Packit |
e4b6da |
that is needed by the stylesheet to process the DocBook document.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
This parameter is internal to the stylesheet.
|
|
Packit |
e4b6da |
To point to an external XML document with a URI or a file name,
|
|
Packit |
e4b6da |
you should use the <parameter>custom-localization-file</parameter>
|
|
Packit |
e4b6da |
parameter instead.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
However, inside a custom stylesheet
|
|
Packit |
e4b6da |
(<emphasis>not on the command-line</emphasis>)
|
|
Packit |
e4b6da |
this paramter can be set to the XPath expression
|
|
Packit |
e4b6da |
<literal>document('')</literal>,
|
|
Packit |
e4b6da |
which will cause the custom translations
|
|
Packit |
e4b6da |
directly embedded inside the custom stylesheet to be read.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="author-othername-in-middle" select="1"/>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="author-othername-in-middle" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Is <sgmltag>othername</sgmltag> in <sgmltag>author</sgmltag> a
|
|
Packit |
e4b6da |
middle name?</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>If true, the <sgmltag>othername</sgmltag> of an <sgmltag>author</sgmltag>
|
|
Packit |
e4b6da |
appears between the <sgmltag>firstname</sgmltag> and
|
|
Packit |
e4b6da |
<sgmltag>surname</sgmltag>. Otherwise, <sgmltag>othername</sgmltag>
|
|
Packit |
e4b6da |
is suppressed.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="output-file" select="''" />
|
|
Packit |
e4b6da |
<doc:param name="output-file" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Name of the Info file</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<indexterm><primary>Texinfo metadata</primary></indexterm>
|
|
Packit |
e4b6da |
<para>This parameter specifies the name of the final Info file,
|
|
Packit |
e4b6da |
overriding the setting in the document itself and the automatic
|
|
Packit |
e4b6da |
selection in the stylesheet. If the document is a
|
|
Packit |
e4b6da |
class="element">set</sgmltag>, this parameter has no effect. </para>
|
|
Packit |
e4b6da |
<important>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
Do <emphasis>not</emphasis> include the <literal>.info</literal>
|
|
Packit |
e4b6da |
extension in the name.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</important>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
(Note that this parameter has nothing to do with the name of
|
|
Packit |
e4b6da |
the <emphasis>Texi-XML output</emphasis> by the XSLT processor you
|
|
Packit |
e4b6da |
are running this stylesheet from.)
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="directory-category" select="''" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="directory-category" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>The categorization of the document in the Info directory</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<indexterm><primary>Texinfo metadata</primary></indexterm>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
This is set to the category that the document
|
|
Packit |
e4b6da |
should go under in the Info directory of installed Info files.
|
|
Packit |
e4b6da |
For example, <literal>General Commands</literal>.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<note>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
Categories may also be set directly in the source document.
|
|
Packit |
e4b6da |
But if this parameter is not empty, then it always overrides the
|
|
Packit |
e4b6da |
setting in the source document.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</note>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="directory-description" select="''" />
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="directory-description" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>The description of the document in the Info directory</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<indexterm><primary>Texinfo metadata</primary></indexterm>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
This is a short description of the document that appears in
|
|
Packit |
e4b6da |
the Info directory of installed Info files.
|
|
Packit |
e4b6da |
For example, <literal>An Interactive Plotting Program.</literal>
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<note>
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
Menu descriptions may also be set directly in the source document.
|
|
Packit |
e4b6da |
But if this parameter is not empty, then it always overrides the
|
|
Packit |
e4b6da |
setting in the source document.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</note>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="index-category" select="'cp'"/>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="index-category" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>The Texinfo index to use</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>The Texinfo index for <sgmltag class="element">indexterm</sgmltag>
|
|
Packit |
e4b6da |
and <sgmltag class="element">index</sgmltag> is specified using the
|
|
Packit |
e4b6da |
<sgmltag class="attribute">role</sgmltag> attribute. If the above
|
|
Packit |
e4b6da |
elements do not have a <sgmltag class="attribute">role</sgmltag>, then
|
|
Packit |
e4b6da |
the default specified by this parameter is used.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<para>
|
|
Packit |
e4b6da |
The predefined indices are:
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<variablelist>
|
|
Packit |
e4b6da |
<varlistentry>
|
|
Packit |
e4b6da |
<term><literal>c</literal></term>
|
|
Packit |
e4b6da |
<term><literal>cp</literal></term>
|
|
Packit |
e4b6da |
<listitem><para>Concept index</para></listitem>
|
|
Packit |
e4b6da |
</varlistentry>
|
|
Packit |
e4b6da |
<varlistentry>
|
|
Packit |
e4b6da |
<term><literal>f</literal></term>
|
|
Packit |
e4b6da |
<term><literal>fn</literal></term>
|
|
Packit |
e4b6da |
<listitem><para>Function index</para></listitem>
|
|
Packit |
e4b6da |
</varlistentry>
|
|
Packit |
e4b6da |
<varlistentry>
|
|
Packit |
e4b6da |
<term><literal>v</literal></term>
|
|
Packit |
e4b6da |
<term><literal>vr</literal></term>
|
|
Packit |
e4b6da |
<listitem><para>Variable index</para></listitem>
|
|
Packit |
e4b6da |
</varlistentry>
|
|
Packit |
e4b6da |
<varlistentry>
|
|
Packit |
e4b6da |
<term><literal>k</literal></term>
|
|
Packit |
e4b6da |
<term><literal>ky</literal></term>
|
|
Packit |
e4b6da |
<listitem><para>Keystroke index</para></listitem>
|
|
Packit |
e4b6da |
</varlistentry>
|
|
Packit |
e4b6da |
<varlistentry>
|
|
Packit |
e4b6da |
<term><literal>p</literal></term>
|
|
Packit |
e4b6da |
<term><literal>pg</literal></term>
|
|
Packit |
e4b6da |
<listitem><para>Program index</para></listitem>
|
|
Packit |
e4b6da |
</varlistentry>
|
|
Packit |
e4b6da |
<varlistentry>
|
|
Packit |
e4b6da |
<term><literal>d</literal></term>
|
|
Packit |
e4b6da |
<term><literal>tp</literal></term>
|
|
Packit |
e4b6da |
<listitem><para>Data type index</para></listitem>
|
|
Packit |
e4b6da |
</varlistentry>
|
|
Packit |
e4b6da |
</variablelist>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
User-defined indices are not yet supported.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="qanda-defaultlabel">number</xsl:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="qanda-defaultlabel" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Sets the default for defaultlabel on QandASet.</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>If no defaultlabel attribute is specified on a QandASet, this
|
|
Packit |
e4b6da |
value is used. It must be one of the legal values for the defaultlabel
|
|
Packit |
e4b6da |
attribute.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<xsl:param name="qandaset-generate-toc">1</xsl:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
<doc:param name="qandaset-generate-toc" xmlns="">
|
|
Packit |
e4b6da |
<refpurpose>Is a Table of Contents created for QandASets?</refpurpose>
|
|
Packit |
e4b6da |
<refdescription>
|
|
Packit |
e4b6da |
<para>If true, a ToC is constructed for QandASets.
|
|
Packit |
e4b6da |
</para>
|
|
Packit |
e4b6da |
</refdescription>
|
|
Packit |
e4b6da |
</doc:param>
|
|
Packit |
e4b6da |
|
|
Packit |
e4b6da |
</xsl:stylesheet>
|
|
Packit |
e4b6da |
|