diff --git a/src/documentation/docbook-xsl/.CatalogManager.properties.example b/src/documentation/docbook-xsl/.CatalogManager.properties.example new file mode 100644 index 0000000000..23434e1951 --- /dev/null +++ b/src/documentation/docbook-xsl/.CatalogManager.properties.example @@ -0,0 +1,61 @@ +######################################################################## +# CatalogManager provides an interface to the catalog properties. +# Properties can come from two places: from system properties or +# from a CatalogManager.properties file. This class provides a +# transparent interface to both, with system properties preferred +# over property file values. + +####################################################################### +# Catalog Files: +# The semicolon-delimited list of catalog files. +# Example: catalogs=/etc/xml/catalog;~/catalog.xml + +catalogs= + +####################################################################### +# Relative Catalogs: +# If false, relative catalog URIs are made absolute with respect to the +# base URI of the CatalogManager.properties file. This setting only +# applies to catalog URIs obtained from the catalogs property in the +# CatalogManager.properties file +# Example: relative-catalogs = [yes|no] + +relative-catalogs=yes + +####################################################################### +# Verbosity: +# If non-zero, the Catalog classes will print informative and debugging +# messages. The higher the number, the more messages. +# Example: verbosity = [0..99] + +verbosity=0 + +####################################################################### +# Prefer: +# Which identifier is preferred, "public" or "system"? +# Example: xml.catalog.prefer = [public|system] + +prefer=system + +####################################################################### +# Static-catalog: +# Should a single catalog be constructed for all parsing, or should a +# different catalog be created for each parser? +# Example: static-catalog = [yes|no] + +static-catalog=yes + +####################################################################### +# Allow-oasis-xml-catalog-pi +# If the source document contains "oasis-xml-catalog" processing +# instructions, should they be used? +# Example: allow-oasis-xml-catalog-pi = [yes|no] + +allow-oasis-xml-catalog-pi=yes + +####################################################################### +# catalog-class-name +# If you're using the convenience classes +# org.apache.xml.resolver.tools.*, this setting allows you to specify +# an alternate class name to use for the underlying catalog. +# Example: catalog-class-name=org.apache.xml.resolver.Resolver diff --git a/src/documentation/docbook-xsl/.cshrc.incl b/src/documentation/docbook-xsl/.cshrc.incl new file mode 100644 index 0000000000..81da0459c0 --- /dev/null +++ b/src/documentation/docbook-xsl/.cshrc.incl @@ -0,0 +1,32 @@ +if ( ! $?XML_CATALOG_FILES ) then + setenv XML_CATALOG_FILES "/docbook-sandbox/xsl/catalog.xml" +# /docbook-sandbox/xsl/catalog.xml is not in XML_CATALOG_FILES, so add it +else if ( "`echo $XML_CATALOG_FILES | grep -v /docbook-sandbox/xsl/catalog.xml`" != "" ) then + setenv XML_CATALOG_FILES "/docbook-sandbox/xsl/catalog.xml $XML_CATALOG_FILES" +endif +endif +# /etc/xml/catalog exists but is not in XML_CATALOG_FILES, so add it +if ( -f /etc/xml/catalog && "`echo $XML_CATALOG_FILES | grep -v /etc/xml/catalog`" != "" ) then + setenv XML_CATALOG_FILES "$XML_CATALOG_FILES /etc/xml/catalog" +endif + +endif +if ( ! $?SGML_CATALOG_FILES ) then + setenv SGML_CATALOG_FILES "/docbook-sandbox/xsl/catalog" +else if ( "`echo $SGML_CATALOG_FILES | grep -v /docbook-sandbox/xsl/catalog`" != "" ) then + setenv SGML_CATALOG_FILES "/docbook-sandbox/xsl/catalog $SGML_CATALOG_FILES" +endif +endif +# /etc/SGML/catalog exists but is not in SGML_CATALOG_FILES, so add it +if ( -f /etc/sgml/catalog && "`echo $SGML_CATALOG_FILES | grep -v /etc/sgml/catalog`" != "" ) then + setenv SGML_CATALOG_FILES "$SGML_CATALOG_FILES /etc/sgml/catalog" +endif + + +if ( ! $?CLASSPATH ) then + setenv CLASSPATH "/home/mikes/.resolver" +# /home/mikes/.resolver is not in CLASSPATH, so add it +else if ( "`echo $CLASSPATH | grep -v /home/mikes/.resolver`" != "" ) then + setenv CLASSPATH "/home/mikes/.resolver:$CLASSPATH" +endif +endif diff --git a/src/documentation/docbook-xsl/.emacs.el b/src/documentation/docbook-xsl/.emacs.el new file mode 100644 index 0000000000..c2a866cd06 --- /dev/null +++ b/src/documentation/docbook-xsl/.emacs.el @@ -0,0 +1,6 @@ +(add-hook + 'nxml-mode-hook + (lambda () + (setq rng-schema-locating-files-default + (append '("/docbook-sandbox/xsl/locatingrules.xml") + rng-schema-locating-files-default )))) diff --git a/src/documentation/docbook-xsl/.profile.incl b/src/documentation/docbook-xsl/.profile.incl new file mode 100644 index 0000000000..53f08a268f --- /dev/null +++ b/src/documentation/docbook-xsl/.profile.incl @@ -0,0 +1,38 @@ +if [ -z "$XML_CATALOG_FILES" ]; then + XML_CATALOG_FILES="/docbook-sandbox/xsl/catalog.xml" +else + # /docbook-sandbox/xsl/catalog.xml is not in XML_CATALOG_FILES, so add it + if [ "${XML_CATALOG_FILES#*/docbook-sandbox/xsl/catalog.xml*}" = "$XML_CATALOG_FILES" ]; then + XML_CATALOG_FILES="/docbook-sandbox/xsl/catalog.xml $XML_CATALOG_FILES" + fi +fi +# /etc/xml/catalog exists but is not in XML_CATALOG_FILES, so add it +if [ -f /etc/xml/catalog ] && [ "${XML_CATALOG_FILES#*/etc/xml/catalog*}" = "$XML_CATALOG_FILES" ]; then + XML_CATALOG_FILES="$XML_CATALOG_FILES /etc/xml/catalog" +fi +export XML_CATALOG_FILES + +if [ -z "$SGML_CATALOG_FILES" ]; then + SGML_CATALOG_FILES="/docbook-sandbox/xsl/catalog" +else + # /docbook-sandbox/xsl/catalog is not in SGML_CATALOG_FILES, so add it + if [ "${SGML_CATALOG_FILES#*/docbook-sandbox/xsl/catalog}" = "$SGML_CATALOG_FILES" ]; then + SGML_CATALOG_FILES="/docbook-sandbox/xsl/catalog:$SGML_CATALOG_FILES" + fi +fi +# /etc/sgml/catalog exists but is not in SGML_CATALOG_FILES, so add it +if [ -f /etc/sgml/catalog ] && [ "${SGML_CATALOG_FILES#*/etc/sgml/catalog*}" = "$SGML_CATALOG_FILES" ]; then + SGML_CATALOG_FILES="$SGML_CATALOG_FILES:/etc/sgml/catalog" +fi +export SGML_CATALOG_FILES + + +if [ -z "$CLASSPATH" ]; then + CLASSPATH="/home/mikes/.resolver" +else + # /home/mikes/.resolver is not in CLASSPATH, so add it + if [ "${CLASSPATH#*/home/mikes/.resolver*}" = "$CLASSPATH" ]; then + CLASSPATH="/home/mikes/.resolver:$CLASSPATH" + fi +fi +export CLASSPATH diff --git a/src/documentation/docbook-xsl/.urilist b/src/documentation/docbook-xsl/.urilist new file mode 100644 index 0000000000..2751d8da2d --- /dev/null +++ b/src/documentation/docbook-xsl/.urilist @@ -0,0 +1 @@ +. http://docbook.sourceforge.net/release/xsl/current/ diff --git a/src/documentation/docbook-xsl/AUTHORS b/src/documentation/docbook-xsl/AUTHORS new file mode 100644 index 0000000000..780effbb78 --- /dev/null +++ b/src/documentation/docbook-xsl/AUTHORS @@ -0,0 +1,3 @@ +The DocBook XSL stylesheets are maintained by Norman Walsh, +, and members of the DocBook Project, + diff --git a/src/documentation/docbook-xsl/BUGS b/src/documentation/docbook-xsl/BUGS new file mode 100644 index 0000000000..6ca80f1f66 --- /dev/null +++ b/src/documentation/docbook-xsl/BUGS @@ -0,0 +1,5 @@ +For information about open DocBook XSL stylesheets bugs, see the +following: + + http://sourceforge.net/tracker/?atid=373747&group_id=21935&func=browse + http://sourceforge.net/tracker/?atid=516914&group_id=21935&func=browse diff --git a/src/documentation/docbook-xsl/COPYING b/src/documentation/docbook-xsl/COPYING new file mode 100644 index 0000000000..1c91cafa7d --- /dev/null +++ b/src/documentation/docbook-xsl/COPYING @@ -0,0 +1,45 @@ +Copyright +--------- + +Copyright (C) 1999, 2000, 2001, 2002 Norman Walsh + +Permission is hereby granted, free of charge, to any person +obtaining a copy of this software and associated documentation +files (the ``Software''), to deal in the Software without +restriction, including without limitation the rights to use, +copy, modify, merge, publish, distribute, sublicense, and/or +sell copies of the Software, and to permit persons to whom the +Software is furnished to do so, subject to the following +conditions: + +The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software. + +Except as contained in this notice, the names of individuals +credited with contribution to this software shall not be used in +advertising or otherwise to promote the sale, use or other +dealings in this Software without prior written authorization +from the individuals in question. + +Any stylesheet derived from this Software that is publically +distributed will be identified with a different name and the +version strings in any derived Software will be changed so that +no possibility of confusion between the derived package and this +Software will exist. + +Warranty +-------- + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES +OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER +CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +OTHER DEALINGS IN THE SOFTWARE. + +Contacting the Author +--------------------- + +These stylesheets are maintained by Norman Walsh, . diff --git a/src/documentation/docbook-xsl/ChangeHistory.xml.zip b/src/documentation/docbook-xsl/ChangeHistory.xml.zip new file mode 100644 index 0000000000..f2603031f3 Binary files /dev/null and b/src/documentation/docbook-xsl/ChangeHistory.xml.zip differ diff --git a/src/documentation/docbook-xsl/ChangeLog.xml b/src/documentation/docbook-xsl/ChangeLog.xml new file mode 100644 index 0000000000..53af6a4eaa --- /dev/null +++ b/src/documentation/docbook-xsl/ChangeLog.xml @@ -0,0 +1,179 @@ + + + + + +2006-05-26 +Friday + +2006-05-26T05:47:35Z +xmldoc + +Makefile +Exp +1.25 + +Merged Makefile from build branch into trunk. + + + +2006-05-24 +Wednesday + +2006-05-24T14:39:48Z +nwalsh + +Makefile +Exp +1.24 + + +RELEASE-NOTES.xml +Exp +1.51 + + +docsrc/release-notes-fo.xsl +Exp +1.1 + + +docsrc/release-notes.xsl +Exp +1.6 + + +docsrc/tdg-link.xsl +Exp +1.4 + +Tweaked RELEASE-NOTES to make them valid DocBook V5.0 + + + +2006-05-21 +Sunday + +2006-05-21T15:05:10Z +kosek + +htmlhelp/htmlhelp-common.xsl +Exp +1.38 + +htmlhelp.generate.index is now param, not variable. This means that you can override its setting from outside. This is useful when you generate indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?page=3). + + + +2006-05-21 +Sunday + +2006-05-21T13:05:19Z +kosek + +fo/block.xsl +Exp +1.34 + + +fo/param.ent +Exp +1.101 + + +fo/param.xweb +Exp +1.114 + + +fo/titlepage.xsl +Exp +1.41 + + +params/revhistory.table.cell.properties.xml +Exp +1.1 + + +params/revhistory.table.properties.xml +Exp +1.1 + + +params/revhistory.title.properties.xml +Exp +1.1 + +Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output. + + + +2006-05-21 +Sunday + +2006-05-21T12:47:25Z +kosek + +fo/block.xsl +Exp +1.33 + + +fo/titlepage.xsl +Exp +1.40 + +fo/ +Support DBv5 revisions with full author name (not only authorinitials) + + + +2006-05-21 +Sunday + +2006-05-21T12:25:21Z +kosek + +html/block.xsl +Exp +1.23 + + +html/titlepage.xsl +Exp +1.34 + +html/ +Support DBv5 revisions with full author name (not only authorinitials) + + + +2006-05-18 +Thursday + +2006-05-18T07:31:44Z +bobstayton + +RELEASE-NOTES.xml +Exp +1.50 + +added a few items to the list of new features. + + + +2006-05-17 +Wednesday + +2006-05-17T09:57:59Z +kosek + +htmlhelp/htmlhelp-common.xsl +Exp +1.37 + +Support chunk.tocs.and.lots in HTML Help + + + diff --git a/src/documentation/docbook-xsl/INSTALL b/src/documentation/docbook-xsl/INSTALL new file mode 100644 index 0000000000..28000d40a8 --- /dev/null +++ b/src/documentation/docbook-xsl/INSTALL @@ -0,0 +1,88 @@ +$Id: INSTALL,v 1.5 2006/04/13 09:29:22 xmldoc Exp $ + +INSTALL file for the DocBook XSL stylesheets distribution + +---------------------------------------------------------------------- +Case #1: Installation using a package management system +---------------------------------------------------------------------- +If you have installed the DocBook XSL distribution using "apt-get", +"yum", "urpmi", or some similar package-management front-end, +then, as part of the package installation, the stylesheets have +already been automatically installed in the appropriate location +for your system, and your XML catalog environment has probably +been updated to use that location. + +---------------------------------------------------------------------- +Case #2: Installing manually +---------------------------------------------------------------------- +If you have downloaded a docbook-xsl zip, tar.gz, or tar.bz2 +file, use the following steps to install it. + + 1. Move the zip, tar.gz, or tar.bz2 file to the directory where + you'd like to install it (not to a temporary directory). + + 2. unzip or untar/uncompress the file + + That will create a docbook-xsl-$VERSION directory (where + $VERSION is the version number for the release). + +The remaining steps are all OPTIONAL. They are intended to +automatically update your user environment with XML Catalog +information about the DocBook XSL distribution. You are NOT +REQUIRED to complete these remaining steps. However, if you do +not, and you want to use XML catalogs with the DocBook XSL +stylesheets, you will need to manually update your XML catalog +environment + + 3. Change to the docbook-xsl-$VERSION directory and execute the + install.sh script: + + ./install.sh + + That will launch an interactive installer, which will emit a + series of prompts for you to respond to. + + To instead run it non-interactively without being prompted + for confirmation of the changes it makes, invoke it with the + "--batch" switch, like this: + + ./install.sh --batch + + After the process is complete, the installer will emit a + message with a command you need to run in order to source + your environment for use with the stylesheets. + + 4. To test that he installation has updated your environment + correctly, execute the test.sh script: + + ./test.sh + + That will test your XML catalog environment, using both the + xmlcatalog application and the Apache XML Commons Resolver. + + NOTE: The test.sh file is not created until the install.sh + file is run for the first time. + + 5. (UNINSTALLING) If/when you want to uninstall the release, + execute the uninstall.sh script. + + ./uninstall.sh + + To instead run it non-interactively without being prompted + for confirmation of the changes it makes, invoke it with the + "--batch" switch, like this: + + ./uninstall.sh --batch + + NOTE: The uninstall.sh file is not created until the install.sh + file is run for the first time. + + +---------------------------------------------------------------------- +Note to packagers +---------------------------------------------------------------------- +The install.sh, .CatalogManager.properties.example, and .urilist +files should not be packaged. They are useful only to users who +are installing the stylesheets manually. + +The catalog.xml file should be packaged. diff --git a/src/documentation/docbook-xsl/LOG b/src/documentation/docbook-xsl/LOG new file mode 100644 index 0000000000..5e04734232 --- /dev/null +++ b/src/documentation/docbook-xsl/LOG @@ -0,0 +1,25 @@ +cvs2cl \ + --stdout --xml -g -q > ChangeHistory.xml +zip ChangeHistory.xml.zip ChangeHistory.xml +updating: ChangeHistory.xml (deflated 89%) +rm -f ChangeHistory.xml +find . -type f | xargs chmod 0644 +find . -type d | xargs chmod 0755 +chmod 0755 fo/pdf2index install.sh +rm -rf /tmp/docbook-xsl-1.70.1 +rm -f /tmp/tar.exclude +rm -f /tmp/docbook-xsl-1.70.1.tar.gz +rm -f /tmp/docbook-xsl-1.70.1.tar.bz2 +rm -f /tmp/docbook-xsl-1.70.1.zip +umask 022; mkdir -p /tmp/docbook-xsl-1.70.1 +touch /tmp/tar.exclude +for file in extensions/xsltproc saxon8 extensions/build/ extensions/build2/; do \ + find . -print | grep $file | cut -c3- >> /tmp/tar.exclude; \ + done +for file in /CVS$ /CVS/ /debian \.classes ~$ \..*\.pyc \#.* \.\#.* prj\.el \.cvsignore MANIFEST.build Makefile$ Makefile.common Makefile.incl Makefile.param LatestTag README\.CVS RELEASE-NOTES\.fo \.make-catalog\.xsl; do \ + find . -print | grep $file | cut -c3- >> /tmp/tar.exclude; \ + done +for part in doc; do \ + find . -print | grep "^./$part\|^./${part}src" | cut -c3- >> /tmp/tar.exclude; \ + done +tar cfP - -X /tmp/tar.exclude * .[^.]* | (cd /tmp/docbook-xsl-1.70.1; tar xfP -) diff --git a/src/documentation/docbook-xsl/NEWS b/src/documentation/docbook-xsl/NEWS new file mode 100644 index 0000000000..3752113765 --- /dev/null +++ b/src/documentation/docbook-xsl/NEWS @@ -0,0 +1,104 @@ +Changes since the 1.70.0 release + +------------------------------------------------------------------------------ + +Table of Contents + +Release: 1.70.0 + + Common + Extensions + FO + HTML + HTMLHelp + Lib + Manpages + Params + Profiling + Template + Tools + WordML + +Release: 1.70.0 + +The following is a list of changes that have been made since the 1.70.0 +release. + +Common + +The following changes have been made to the common code since the 1.70.0 +release. + +Extensions + +The following changes have been made to the extensions code since the 1.70.0 +release. + +FO + +The following changes have been made to the fo code since the 1.70.0 release. + + * Added three new attribute sets (revhistory.title.properties, revhistory. + table.properties and revhistory.table.cell.properties) for controlling + appearance of revhistory in FO output. + + * Support DBv5 revisions with full author name (not only authorinitials) + +HTML + +The following changes have been made to the html code since the 1.70.0 +release. + + * Support DBv5 revisions with full author name (not only authorinitials) + +HTMLHelp + +The following changes have been made to the htmlhelp code since the 1.70.0 +release. + + * htmlhelp.generate.index is now param, not variable. This means that you + can override its setting from outside. This is useful when you generate + indexterms on the fly (see + http://www.xml.com/pub/a/2004/07/14/dbndx.html?page=3). + + * Support chunk.tocs.and.lots in HTML Help + +Lib + +The following changes have been made to the lib code since the 1.70.0 release. + +Manpages + +The following changes have been made to the manpages code since the 1.70.0 +release. + +Params + +The following changes have been made to the params code since the 1.70.0 +release. + + * Added three new attribute sets (revhistory.title.properties, revhistory. + table.properties and revhistory.table.cell.properties) for controlling + appearance of revhistory in FO output. + +Profiling + +The following changes have been made to the profiling code since the 1.70.0 +release. + +Template + +The following changes have been made to the template code since the 1.70.0 +release. + +Tools + +The following changes have been made to the tools code since the 1.70.0 +release. + +WordML + +The following changes have been made to the wordml code since the 1.70.0 +release. + + diff --git a/src/documentation/docbook-xsl/NEWS.html b/src/documentation/docbook-xsl/NEWS.html new file mode 100644 index 0000000000..310168dc7b --- /dev/null +++ b/src/documentation/docbook-xsl/NEWS.html @@ -0,0 +1,28 @@ + + + Changes since the 1.70.0 release

Changes since the 1.70.0 release

Table of Contents

Release: 1.70.0
Common
Extensions
FO
HTML
HTMLHelp
Lib
Manpages
Params
Profiling
Template
Tools
WordML

Release: 1.70.0

The following is a list of changes that have been made + since the 1.70.0 release.

Common

The following changes have been made to the + common code + since the 1.70.0 release.

    Extensions

    The following changes have been made to the + extensions code + since the 1.70.0 release.

      FO

      The following changes have been made to the + fo code + since the 1.70.0 release.

      HTML

      The following changes have been made to the + html code + since the 1.70.0 release.

      HTMLHelp

      The following changes have been made to the + htmlhelp code + since the 1.70.0 release.

      • htmlhelp.generate.index is now param, not variable. This means that you can override its setting from outside. This is useful when you generate indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?page=3).

      • Support chunk.tocs.and.lots in HTML Help

      Lib

      The following changes have been made to the + lib code + since the 1.70.0 release.

        Manpages

        The following changes have been made to the + manpages code + since the 1.70.0 release.

          Params

          The following changes have been made to the + params code + since the 1.70.0 release.

          Profiling

          The following changes have been made to the + profiling code + since the 1.70.0 release.

            Template

            The following changes have been made to the + template code + since the 1.70.0 release.

              Tools

              The following changes have been made to the + tools code + since the 1.70.0 release.

                WordML

                The following changes have been made to the + wordml code + since the 1.70.0 release.

                  \ No newline at end of file diff --git a/src/documentation/docbook-xsl/NEWS.xml b/src/documentation/docbook-xsl/NEWS.xml new file mode 100644 index 0000000000..0149f76597 --- /dev/null +++ b/src/documentation/docbook-xsl/NEWS.xml @@ -0,0 +1,136 @@ + +
                  +Changes since the 1.70.0 release + +Release: 1.70.0 +The following is a list of changes that have been made + since the 1.70.0 release. + + +Common +The following changes have been made to the + common code + since the 1.70.0 release. + + + + + +Extensions +The following changes have been made to the + extensions code + since the 1.70.0 release. + + + + + +FO +The following changes have been made to the + fo code + since the 1.70.0 release. + + +Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek + + +Support DBv5 revisions with full author name (not only authorinitials)fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek + + + + + +HTML +The following changes have been made to the + html code + since the 1.70.0 release. + + +Support DBv5 revisions with full author name (not only authorinitials)html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek + + + + + +HTMLHelp +The following changes have been made to the + htmlhelp code + since the 1.70.0 release. + + +htmlhelp.generate.index is now param, not variable. This means that you can override its setting from outside. This is useful when you generate indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?page=3).htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek + + +Support chunk.tocs.and.lots in HTML Helphtmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek + + + + + +Lib +The following changes have been made to the + lib code + since the 1.70.0 release. + + + + + +Manpages +The following changes have been made to the + manpages code + since the 1.70.0 release. + + + + + +Params +The following changes have been made to the + params code + since the 1.70.0 release. + + +Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek + + + + + +Profiling +The following changes have been made to the + profiling code + since the 1.70.0 release. + + + + + +Template +The following changes have been made to the + template code + since the 1.70.0 release. + + + + + +Tools +The following changes have been made to the + tools code + since the 1.70.0 release. + + + + + +WordML +The following changes have been made to the + wordml code + since the 1.70.0 release. + + + + + +
                  \ No newline at end of file diff --git a/src/documentation/docbook-xsl/README b/src/documentation/docbook-xsl/README new file mode 100644 index 0000000000..032cfbcb6c --- /dev/null +++ b/src/documentation/docbook-xsl/README @@ -0,0 +1,119 @@ +---------------------------------------------------------------------- + README file for the DocBook XSL Stylesheets +---------------------------------------------------------------------- +$Id: README,v 1.8 2005/06/28 10:35:48 xmldoc Exp $ + +These are XSL stylesheets for transforming DocBook XML document +instances into various output formats. + +This README file provides only very minimal documentation on using +the stylesheets. For more complete information, see Bob Stayton's +book "DocBook XSL: The Complete Guide", available online at: + + http://www.sagehill.net/docbookxsl/ + +---------------------------------------------------------------------- +Installation +---------------------------------------------------------------------- +See the INSTALL file for information about installing this release. + +---------------------------------------------------------------------- +How to use the stylesheets +---------------------------------------------------------------------- +The base canonical URI for these stylesheets is: + + http://docbook.sourceforge.net/release/xsl/current/ + +You call any of the stylesheets in this distribution by doing one +of the following: + + - Use the base canonical URI in combination with one of the + pathnames below. For example, for "chunked" HTML, output: + + http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl + + If your system has a working XML Catalog or SGML Catalog setup + (most Linux systems do), then that URI will automatically be + resolved and replaced with a local pathname on your system. + + - Use a "real" local system base path in combination with one of + the pathnames below. For example, for "chunked" HTML, output: + + /usr/share/xml/docbook/stylesheet/nwalsh/html/chunk.xsl + +To transform documents created with the standard DocBook schema/DTD +(or DocBook NG schema/DTD, use one of the following stylesheets: + + fo/docbook.xsl - for XSL-FO + fo/profile-docbook.xsl - for XSL-FO (single-pass profiled) + + html/docbook.xsl - for HTML (as a single file) + html/chunk.xsl - for HTML (chunked into multiple files) + html/onechunk.xsl - for HTML (chunked output in single file) + html/profile-* - for HTML (single-pass profiled versions) + + xhtml/*.xsl - for XHTML versions of the above + + htmlhelp/htmlhelp.xsl - for HTML Help + javahelp/javahelp.xsl - for JavaHelp + eclipse/eclipse.xsl - for Eclipse Help + + manpages/docbook.xsl - for groff/nroff man pages + +To transform documents created with the DocBook Slides schema/DTD, +use one of the following stylesheets: + + slides/html/*.xsl - for HTML slides of various kinds + slides/xhtml/*.xsl - for XHTML slides of various kinds + slides/fo/plain.xsl - for XSL-FO slides + slides/htmlhelp/... - for HTML Help slides + +To transform documents created with the DocBook Website +schema/DTD, use one of the following stylesheets: + + website/website.xsl - for non-tabular, non-chunked output + website/tabular.xsl - for tabular, non-chunked output + website/chunk-* - for chunked output + +---------------------------------------------------------------------- +Manifest +---------------------------------------------------------------------- +AUTHORS contact information +BUGS about known problems +COPYING copyright information +INSTALL installation instructions +README this file +RELEASE.* per-release cumulative summaries of user-visible changes +TODO about planned features not yet implemented +VERSION the current version number (note that this is an XSL stylesheet, + included by both fo/docbook.xsl and html/docbook.xsl) +NEWS changes since the last public release (for cumulative lists of + changes, see the ChangeLog files in each subdirectory) + +common/ contains code common to both the HTML and FO stylesheets +doc/ documentation +docsrc/ documentation sources +eclipse/ stylesheet that produces Eclipse Help +extensions/ Java extensions +fo/ stylesheets that produce XSL FO +html/ stylesheets that produce HTML +htmlhelp/ stylesheets that produce HTML Help +images/ images +javahelp/ stylesheets that produce Java Help +lib/ contains schema-independent functions +manpages/ stylesheets for producing groff/nroff man pages +profiling/ stylesheets for profiling (omitting/including conditional text) +slides/ stylesheets for producing slides (from DocBook Slides source) +template/ contains templates for building stylesheet customization layers +website/ stylesheets for producing a website (from DocBook Website source) +xhtml/ stylesheets that produce XHTML + +---------------------------------------------------------------------- +Changes +---------------------------------------------------------------------- +See the ChangeLog in each subdirectory for cumulative lists of all changes. + +See the NEWS file for changes made since the previous release. + +See the RELEASE-NOTES.html or RELEASE-NOTES.txt or RELEASE-NOTES.pdf files +for per-release cumulative summaries of significant user-visible changes. diff --git a/src/documentation/docbook-xsl/RELEASE-NOTES.html b/src/documentation/docbook-xsl/RELEASE-NOTES.html new file mode 100644 index 0000000000..85c69a5a2d --- /dev/null +++ b/src/documentation/docbook-xsl/RELEASE-NOTES.html @@ -0,0 +1,3851 @@ + + + Release Notes

                  Release Notes

                  DocBook Project XSL Stylesheets

                  $Revision: 1.51 $ $Date: 2006/05/24 14:39:48 $

                  2006-05-26

                  Table of Contents

                  Release: 1.70.1
                  FO
                  HTML
                  HTMLHelp
                  Params
                  Release: 1.70.0
                  Common
                  Extensions
                  FO
                  HTML
                  Manpages
                  Params
                  Profiling
                  Tools
                  WordML
                  Release 1.69.1
                  Release 1.69.0
                  Common
                  FO
                  Help
                  HTML
                  man
                  Release 1.68.1
                  Release 1.68.0
                  Release 1.67.2
                  Release 1.67.1
                  Release 1.67.0
                  Release 1.66.1
                  Release 1.65.0
                  Release 1.64.1
                  Release 1.61.0
                  Release 1.60.1
                  Release 1.59.2
                  Release 1.59.1
                  Release 1.58.0
                  Release 1.57.0
                  Release 1.56.0
                  Older releases
                  About dot-zero releases
                  + + +

                  These are the release notes for the DocBook XSL Stylesheets +distribution. This document lists enhancements and changes to the +public APIs (user-configurable parameters) and generally excludes +descriptions of bug fixes, which are instead documented in a +separate NEWS file.

                  + +

                  Release: 1.70.1

                  + + +

                  This is a stable release of the 1.70 stylesheets. It includes only a +few small changes from 1.70.0.

                  + +

                  The following is a list of changes that have been made + since the 1.70.0 release.

                  + +

                  FO

                  + +

                  The following changes have been made to the + fo code + since the 1.70.0 release.

                  +
                  • +

                    Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.

                    +

                    Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek

                    +
                  • +

                    Support DBv5 revisions with full author name (not only authorinitials)

                    +

                    Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek

                    +
                  +
                  + +

                  HTML

                  + +

                  The following changes have been made to the + html code + since the 1.70.0 release.

                  +
                  • +

                    Support DBv5 revisions with full author name (not only authorinitials)

                    +

                    Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek

                    +
                  +
                  + +

                  HTMLHelp

                  + +

                  The following changes have been made to the + htmlhelp code + since the 1.70.0 release.

                  +
                  • +

                    htmlhelp.generate.index is now param, not variable. This means that you can override its setting from outside. This is useful when you generate indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?page=3).

                    +

                    Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek

                    +
                  • +

                    Support chunk.tocs.and.lots in HTML Help

                    +

                    Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek

                    +
                  +
                  + +

                  Params

                  + +

                  The following changes have been made to the + params code + since the 1.70.0 release.

                  +
                  • +

                    Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output.

                    +

                    Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek

                    +
                  +
                  + +
                  + +

                  Release: 1.70.0

                  + +

                  As with all DocBook Project dot-zero +releases, this is an experimental release. It will be followed shortly +by a stable release.

                  + +

                  This release adds a number of new features, +including:

                  + +
                  • +

                    support for selecting alternative index-collation methods + (in particular, support for using a collation library developed by + Eliot Kimber)

                    +
                  • +

                    improved handling of DocBook 5 document instances (through a + namespace-stripping mechanism)

                    +
                  • +

                    full support for CALS and HTML tables in manpages + output

                    +
                  • +

                    a mechanism for preserving relative URIs in documents that + make use of XInclude

                    +
                  • +

                    support for the "new" .90 version of + FOP

                    +
                  • +

                    enhanced capabilities for controlling formatting of lists in HTML + and FO output

                    +
                  • +

                    autogeneration of AUTHOR and COPYRIGHT sections in manpages + output

                    +
                  • +

                    support for generating crop marks in FO/PDF output

                    +
                  • +

                    support for qandaset as a root element in FO output

                    +
                  • +

                    support for floatstyle and orient on all table types

                    +
                  • +

                    support for floatstyle in figure, and example

                    +
                  • +

                    pgwide.properties attribute-set supports extending figure, + example and table into the left indent area instead of spanning + multiple columns.

                    +
                  +

                  The following is a detailed list of enhancements and API + changes that have been made since the 1.69.1 release.

                  + +

                  Common

                  + +

                  The following changes have been made to the + common code + since the 1.69.1 release.

                  +
                  • +

                    Add the xsl:key for the kimber +indexing method.

                    +

                    Modified: common/autoidx-ng.xsl,1.2 - Robert +Stayton

                    +
                  • +

                    Add support for +qandaset.

                    +

                    Modified: common/labels.xsl,1.37; +common/subtitles.xsl,1.7; common/titles.xsl,1.35 - Robert +Stayton

                    +
                  • +

                    Support dbhtml/dbfo start PI for +orderedlist numbering in both HTML and +FO

                    +

                    Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman +Walsh

                    +
                  • +

                    Added CVS +header.

                    +

                    Modified: common/stripns.xsl,1.12 - Robert +Stayton

                    +
                  • +

                    Changed content model of text +element to ANY rather than #PCDATA because they could contain +markup.

                    +

                    Modified: common/targetdatabase.dtd,1.7 - Robert +Stayton

                    +
                  • +

                    Added +refentry.meta.get.quietly param.

                    +

                    If zero (the +default), notes and warnings about "missing" markup are generated +during gathering of refentry metadata. If +non-zero, the metadata is gathered "quietly" -- that is, the +notes and warnings are suppressed.

                    +

                    NOTE: If you are +processing a large amount of refentry content, you +may be able to speed up processing significantly by setting a +non-zero value for +refentry.meta.get.quietly.

                    +

                    Modified: common/refentry.xsl,1.17; +manpages/param.ent,1.15; manpages/param.xweb,1.17; +params/refentry.meta.get.quietly.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    After namespace stripping, the +source document is the temporary tree created by the stripping +process and it has the wrong base URI for relative +references. Earlier versions of this code used to try to fix that +by patching the elements with relative @fileref attributes. That +was inadequate because it calculated an absolute base URI +without considering that there might be xml:base attributes +already in effect. It seems obvious now that the right thing to +do is simply to put the xml:base on the root of the document. And +that seems to work.

                    +

                    Modified: common/stripns.xsl,1.7 - Norman +Walsh

                    +
                  • +

                    Added support for "software" and +"sectdesc" class values on refmiscinfo; "software" is +treated identically to "source", and "setdesc" is treated +identically to "manual".

                    +

                    Modified: common/refentry.xsl,1.10; +params/man.th.extra2.max.length.xml,1.3; +params/refentry.source.name.profile.xml,1.4 - Michael(tm) +Smith

                    +
                  • +

                    Added support for DocBook 5 +namespace-stripping in manpages stylesheet. Closes request +#1210692.

                    +

                    Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - +Michael(tm) Smith

                    +
                  • +

                    Added <xsl:template +match="/"> to make stripns.xsl usable as a standalone +stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that +DocBook XSLT drivers that include this stylesheet all override +the match="/" template.

                    +

                    Modified: common/stripns.xsl,1.4 - Michael(tm) +Smith

                    +
                  • +

                    Number figures, examples, and +tables from book if there is no prefix (i.e. if +chapter.autolabel is set to 0). This avoids +having the list of figures where the figures mysteriously restart +their numeration periodically when +chapter.autolabel is set to +0.

                    +

                    Modified: common/labels.xsl,1.36 - David Cramer

                    +
                  • +

                    Add task template in +title.markup mode.

                    +

                    Modified: common/titles.xsl,1.34 - Robert +Stayton

                    +
                  • +

                    Add children (with ids) of formal +objects to target data.

                    +

                    Modified: common/targets.xsl,1.10 - Robert +Stayton

                    +
                  • +

                    Added support for case when +personname doesn't contain specific name markup (as allowed +in DocBook 5.0)

                    +

                    Modified: common/common.xsl,1.54 - Jirka +Kosek

                    +
                  +
                  + +

                  Extensions

                  + +

                  The following changes have been made to the + extensions code + since the 1.69.1 release.

                  +
                  • +

                    Support Xalan +2.7

                    +

                    Modified: extensions/xalan27/.cvsignore,1.1; +extensions/xalan27/build.xml,1.1; +extensions/xalan27/nbproject/.cvsignore,1.1; +extensions/xalan27/nbproject/build-impl.xml,1.1; +extensions/xalan27/nbproject/genfiles.properties,1.1; +extensions/xalan27/nbproject/project.properties,1.1; +extensions/xalan27/nbproject/project.xml,1.1; +extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Callout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Func.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Params.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman +Walsh

                    +
                  • +

                    Handle the case where the imageFn +is actually a URI. This still needs +work.

                    +

                    Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4 +- Norman Walsh

                    +
                  +
                  + +

                  FO

                  + +

                  The following changes have been made to the + fo code + since the 1.69.1 release.

                  +
                  • +

                    Adapted to the new indexing +code. Now works just like a wrapper that calls kosek indexing method, +originally implemented here.

                    +

                    Modified: fo/autoidx-ng.xsl,1.5 - Jirka +Kosek

                    +
                  • +

                    Added parameters for header/footer +table minimum height.

                    +

                    Modified: fo/pagesetup.xsl,1.60; +fo/param.ent,1.100; fo/param.xweb,1.113 - Robert +Stayton

                    +
                  • +

                    Add the index.method +parameter.

                    +

                    Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert +Stayton

                    +
                  • +

                    Integrate support for three +indexing methods: - the original English-only method. - +Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's +method using Saxon extensions. Use the 'index.method' +parameter to select.

                    +

                    Modified: fo/autoidx.xsl,1.38 - Robert +Stayton

                    +
                  • +

                    Add support for TOC for +qandaset in fo output.

                    +

                    Modified: fo/autotoc.xsl,1.30; +fo/qandaset.xsl,1.20 - Robert Stayton

                    +
                  • +

                    Added parameter +ulink.hyphenate.chars. Added parameter +insert.link.page.number.

                    +

                    Modified: fo/param.ent,1.98; +fo/param.xweb,1.111 - Robert Stayton

                    +
                  • +

                    Implemented feature request +#942524 to add insert.link.page.number to allow link +element cross references to have a page number.

                    +

                    Modified: fo/xref.xsl,1.67 - +Robert Stayton

                    +
                  • +

                    Add support for +ulink.hyphenate.chars so more characters +can be break points in urls.

                    +

                    Modified: fo/xref.xsl,1.66 - Robert +Stayton

                    +
                  • +

                    Implemented patch #1075144 to make +the url text in a ulink in FO output an active link as +well.

                    +

                    Modified: fo/xref.xsl,1.65 - Robert Stayton

                    +
                  • +

                    table footnotes now +have their own table.footnote.properties +attribute set.

                    +

                    Modified: fo/footnote.xsl,1.23 - Robert +Stayton

                    +
                  • +

                    Add qandaset to +root.elements.

                    +

                    Modified: fo/docbook.xsl,1.41 - Robert +Stayton

                    +
                  • +

                    Added mode="page.sequence" to make +it easier to put content into a page sequence. First used for +qandaset.

                    +

                    Modified: fo/component.xsl,1.37 - Robert +Stayton

                    +
                  • +

                    Implemented feature request +#1434408 to support formatting +of biblioentry.

                    +

                    Modified: fo/biblio.xsl,1.35 - Robert +Stayton

                    +
                  • +

                    Added +biblioentry.properties.

                    +

                    Modified: fo/param.ent,1.97; +fo/param.xweb,1.110 - Robert Stayton

                    +
                  • +

                    Support PTC/Arbortext +bookmarks

                    +

                    Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman +Walsh

                    +
                  • +

                    Added +table.footnote.properties to permit +table footnotes to format differently from regular +footnotes.

                    +

                    Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert +Stayton

                    +
                  • +

                    Refactored table +templates to unify their processing and support all options in +all types. Now table and informaltable, in +both Cals and Html markup, use the same templates where possible, +and all support pgwide, rotation, and floats. There is also a +placeholder table.container template to +support wrapping a table in a layout table, +so the XEP table title "continued" +extension can be more easily implemented.

                    +

                    Modified: fo/formal.xsl,1.52; +fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 - Robert +Stayton

                    +
                  • +

                    Added new attribute set +toc.line.properties for controlling appearance of lines in +ToC/LoT

                    +

                    Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95; +fo/param.xweb,1.108 - Jirka Kosek

                    +
                  • +

                    Added support for float to example +and equation. Added support for pgwide to +figure, example, and equation (the latter +two via a dbfo pgwide="1" processing +instruction).

                    +

                    Modified: fo/formal.xsl,1.51 - Robert +Stayton

                    +
                  • +

                    Add pgwide.properties +attribute-set.

                    +

                    Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert +Stayton

                    +
                  • +

                    Added refclass.suppress +param.

                    +

                    If the value of refclass.suppress is +non-zero, then display refclass contents is suppressed +in output. Affects HTML and FO output +only.

                    +

                    Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; +html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Improved support for +task subelements

                    +

                    Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - +Jirka Kosek

                    +
                  • +

                    Adjusted spacing around +K&R-formatted Funcdef and Paramdef +output such that it can more easily be discerned where one ends +and the other begins. Closes #1213264.

                    +

                    Modified: fo/synop.xsl,1.18 - +Michael(tm) Smith

                    +
                  • +

                    Made handling of +paramdef/parameter in FO output consistent with that in HTML and +manpages output. Closes #1213259.

                    +

                    Modified: fo/synop.xsl,1.17 - Michael(tm) +Smith

                    +
                  • +

                    Made handling of +Refnamediv consistent with formatting in HTML +and manpages output; specifically, changed so that +Refname (comma-separated list of multiple instances +found) is used (instead of Refentrytitle as +previously), then em-dash, then the Refpurpose. Closes +#1212562.

                    +

                    Modified: fo/refentry.xsl,1.30 - Michael(tm) +Smith

                    +
                  • +

                    Added output of +Releaseinfo to recto titlepage ("copyright" +page) for Book in FO output. This makes it consistent +with HTML output. Closes #1327034. Thanks to Paul DuBois for +reporting.

                    +

                    Modified: fo/titlepage.templates.xml,1.28 - Michael(tm) +Smith

                    +
                  • +

                    Added condition for setting +block-progression-dimension.minimum on table-row, instead of +height, when fop1.extensions is +non-zero. For an explanation of the reason for the change, +see: http://wiki.apache.org/xmlgraphics-fop/Troubleshooting/CommonLogMessages

                    +

                    Modified: fo/pagesetup.xsl,1.59 +- Michael(tm) Smith

                    +
                  • +

                    Added new +refclass.suppress param for suppressing display +of Refclass in HTML and FO output. Did not add it to +manpages because manpages stylesheet is currently just silently +ignoring Refclass anyway. Closes request +#1461065. Thanks to Davor Ocelic (docelic) for +reporting.

                    +

                    Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - +Michael(tm) Smith

                    +
                  • +

                    Add support for keep-together PI +to informal objects.

                    +

                    Modified: fo/formal.xsl,1.50 - Robert +Stayton

                    +
                  • +

                    Add support for +fop1.extensions.

                    +

                    Modified: fo/formal.xsl,1.49; +fo/graphics.xsl,1.44; fo/table.xsl,1.47 - Robert +Stayton

                    +
                  • +

                    Add support for fop1 +bookmarks.

                    +

                    Modified: fo/docbook.xsl,1.39 - Robert +Stayton

                    +
                  • +

                    Add fop1.extentions parameter to +add support for fop development version.

                    +

                    Modified: fo/param.ent,1.92; +fo/param.xweb,1.105 - Robert Stayton

                    +
                  • +

                    Start supporting fop development +version, which will become fop version 1.

                    +

                    Modified: fo/fop1.xsl,1.1 - +Robert Stayton

                    +
                  • +

                    Add template for task +in mode="xref-to".

                    +

                    Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert +Stayton

                    +
                  • +

                    table footnotes now +also get footnote.properties +attribute-set.

                    +

                    Modified: fo/footnote.xsl,1.22 - Robert +Stayton

                    +
                  • +

                    Added index.separator +named template to compute the separator punctuation based on +locale.

                    +

                    Modified: fo/autoidx.xsl,1.36 - Robert Stayton

                    +
                  • +

                    Added support for link, +olink, and xref within OO +Classsynopsis and children. (Because DocBook NG/5 +allows it).

                    +

                    Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) +Smith

                    +
                  • +

                    Support date as an +inline

                    +

                    Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman +Walsh

                    +
                  • +

                    Added new parameter +keep.relative.image.uris

                    +

                    Modified: fo/param.ent,1.91; +fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96; +params/keep.relative.image.uris.xml,1.1 - Norman +Walsh

                    +
                  • +

                    Map Unicode space characters +U+2000-U+200A to fo:leaders.

                    +

                    Modified: fo/docbook.xsl,1.38; +fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 - Jirka +Kosek

                    +
                  • +

                    Output a real em dash for em-dash +dingbat (instead of two hypens).

                    +

                    Modified: fo/fo.xsl,1.7 - Michael(tm) +Smith

                    +
                  • +

                    Support default label +width parameters for itemized and ordered lists

                    +

                    Modified: fo/lists.xsl,1.64; +fo/param.ent,1.90; fo/param.xweb,1.103; +params/itemizedlist.label.width.xml,1.1; +params/orderedlist.label.width.xml,1.1 - Norman +Walsh

                    +
                  • +

                    Generate localized +title for Refsynopsisdiv if no +appropriate Title descendant found in source. Closes +#1212398. This change makes behavior for the Synopsis +title consistent with the behavior of HTML and +manpages output.

                    +

                    Also, added +xsl:use-attribute-sets="normal.para.spacing" to +block generated for Cmdsynopsis output. Previously, +that block had no spacing at all specified, which resulted it +being crammed up to closely to the Synopsis +head.

                    +

                    Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm) +Smith

                    +
                  • +

                    Added parameters to support +localization of index +item punctuation.

                    +

                    Modified: fo/autoidx.xsl,1.35 - Robert +Stayton

                    +
                  • +

                    Added +index.number.separator, +index.range.separator, +and index.term.separator parameters to +support localization of punctuation in index +entries.

                    +

                    Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert +Stayton

                    +
                  • +

                    Added "Cross References" +section in HTML doc (for consistency with the FO +doc). Also, moved the existing FO "Cross +References" section to follow the "Linking" +section.

                    +

                    Modified: fo/param.xweb,1.101; html/param.xweb,1.95 - +Michael(tm) Smith

                    +
                  • +

                    Added ID attribues to all +Reference elements (e.g., id="tables" for the doc for +section on Table params). So pages for +all subsections of ref docs now have stable filenames instead +of arbitrary generated filenames.

                    +

                    Modified: fo/param.xweb,1.100; +html/param.xweb,1.94 - Michael(tm) Smith

                    +
                  • +

                    Added two new parameters for +handling of multi-term +varlistentry elements:

                    +

                    variablelist.term.break.after: +When the variablelist.term.break.after is +non-zero, it will generate a line break after each +term multi-term +varlistentry.

                    +

                    variablelist.term.separator: +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is +placed after each term except the last. The default +is ", " (a comma followed by a space). To suppress rendering of +the separator, set the value of +variablelist.term.separator to the empty +string ("").

                    +

                    These parameters are primarily intended to be +useful if you have multi-term varlistentries that have long +terms.

                    +

                    Closes #1306676. Thanks to Sam Steingold for +providing an example "lots of long terms" doc that demonstrated +the value of having these options.

                    +

                    Also, added +normalize-space() call to processing of each +term.

                    +

                    This change affects all output formats +(HTML, PDF, manpages). The default behavior should pretty much +remain the same as before, but it is possible (as always) that +the change may introduce some +new bugginess.

                    +

                    Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; +fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; +html/param.xweb,1.93; manpages/lists.xsl,1.22; +manpages/param.ent,1.14; manpages/param.xweb,1.16; +params/variablelist.term.break.after.xml,1.1; +params/variablelist.term.separator.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Add sidebar titlepage +placeholder attset for styles.

                    +

                    Modified: fo/titlepage.xsl,1.37 - Robert +Stayton

                    +
                  • +

                    Add titlepage for +sidebar.

                    +

                    Modified: fo/titlepage.templates.xml,1.27 - Robert +Stayton

                    +
                  • +

                    Implemented RFE +#1292615.

                    +

                    Added bunch of new parameters (attribute sets) +that affect list presentation: list.block.properties, +itemizedlist.properties, orderedlist.properties, +itemizedlist.label.properties and +orderedlist.label.properties. Default behaviour +of stylesheets has not been changed but further customizations will be +much more easier.

                    +

                    Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; +fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1; +params/itemizedlist.properties.xml,1.1; +params/list.block.properties.xml,1.1; +params/orderedlist.label.properties.xml,1.1; +params/orderedlist.properties.xml,1.1 - Jirka +Kosek

                    +
                  • +

                    Implemented RFE +#1242092.

                    +

                    You can enable crop marks in your document by +setting crop.marks=1 and xep.extensions=1. Appearance of crop +marks can be controlled by parameters +crop.mark.bleed (6pt), +crop.mark.offset (24pt) and +crop.mark.width (0.5pt).

                    +

                    Also there +is new named template called user-xep-pis. You can overwrite it in +order to produce some PIs that can control XEP as described in +http://www.renderx.com/reference.html#Output_Formats

                    +

                    Modified: fo/docbook.xsl,1.36; +fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23; +params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1; +params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka +Kosek

                    +
                  +
                  + +

                  HTML

                  + +

                  The following changes have been made to the + html code + since the 1.69.1 release.

                  +
                  • +

                    implemented +index.method parameter and three +methods.

                    +

                    Modified: html/autoidx.xsl,1.28 - Robert +Stayton

                    +
                  • +

                    added index.method +parameter to support 3 indexing methods.

                    +

                    Modified: html/param.ent,1.94; +html/param.xweb,1.103 - Robert Stayton

                    +
                  • +

                    Implemented feature request +#1072510 as a processing instruction to permit including external +HTML content into HTML output.

                    +

                    Modified: html/pi.xsl,1.9 - Robert +Stayton

                    +
                  • +

                    Added new parameter +chunk.tocs.and.lots.has.title which +controls presence of title in a separate chunk with +ToC/LoT. Disabling title can be very useful if you are +generating frameset output (well, yes those frames, but some customers +really want them ;-).

                    +

                    Modified: html/chunk-code.xsl,1.15; +html/param.ent,1.93; html/param.xweb,1.102; +params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka +Kosek

                    +
                  • +

                    Support dbhtml/dbfo start PI for +orderedlist numbering in both HTML and +FO

                    +

                    Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman +Walsh

                    +
                  • +

                    Allow ToC without +title also for set and +book.

                    +

                    Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 - +Jirka Kosek

                    +
                  • +

                    Implemented floats uniformly for +figure, example, equation +and informalfigure, informalexample, and +informalequation.

                    +

                    Modified: html/formal.xsl,1.22 - Robert +Stayton

                    +
                  • +

                    Added the +autotoc.label.in.hyperlink param.

                    +

                    If the value +of autotoc.label.in.hyperlink is non-zero, labels +are included in hyperlinked titles in the TOC. If it +is instead zero, labels are still displayed prior to the +hyperlinked titles, but are not hyperlinked along with the +titles.

                    +

                    Closes patch #1065868. Thanks to anatoly techtonik +for the patch.

                    +

                    Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; +html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - +Michael(tm) Smith

                    +
                  • +

                    Added two new params: +html.head.legalnotice.link.types +and html.head.legalnotice.link.multiple.

                    +

                    If +the value of the generate.legalnotice.link is +non-zero, then the stylesheet generates (in the head +section of the HTML source) either a single HTML +link element or, if the value of +the html.head.legalnotice.link.multiple is +non-zero, one link element for each link +type specified. Each link has the +following attributes:

                    +

                    - a rel attribute whose value +is derived from the value of +html.head.legalnotice.link.types

                    +

                    - +an href attribute whose value is set to the URL of the file +containing the legalnotice

                    +

                    - a title +attribute whose value is set to the title of the +corresponding legalnotice (or a title +programatically determined by the stylesheet)

                    +

                    For +example:

                    +

                    <link rel="copyright" +href="ln-id2524073.html" title="Legal Notice">

                    +

                    Closes +#1476450. Thanks to Sam Steingold.

                    +

                    Modified: html/chunk-common.xsl,1.45; +html/param.ent,1.91; html/param.xweb,1.100; +params/generate.legalnotice.link.xml,1.4; +params/html.head.legalnotice.link.multiple.xml,1.1; +params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Added refclass.suppress +param.

                    +

                    If the value of refclass.suppress is +non-zero, then display refclass contents is suppressed +in output. Affects HTML and FO output +only.

                    +

                    Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; +html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Improved support for +task subelements

                    +

                    Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - +Jirka Kosek

                    +
                  • +

                    Added new +refclass.suppress param for suppressing display +of Refclass in HTML and FO output. Did not add it to +manpages because manpages stylesheet is currently just silently +ignoring Refclass anyway. Closes request +#1461065. Thanks to Davor Ocelic (docelic) for +reporting.

                    +

                    Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - +Michael(tm) Smith

                    +
                  • +

                    Process alt text with +normalize-space(). Replace tab indents with +spaces.

                    +

                    Modified: html/graphics.xsl,1.57 - Robert +Stayton

                    +
                  • +

                    Content of citation +element is automatically linked to the bibliographic entry +with the corresponding abbrev.

                    +

                    Modified: html/biblio.xsl,1.26; +html/inline.xsl,1.47; html/xref.xsl,1.58 - Jirka +Kosek

                    +
                  • +

                    Add template for task +in mode="xref-to".

                    +

                    Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert +Stayton

                    +
                  • +

                    Suppress ID warnings if the +.warnings parameter is 0

                    +

                    Modified: html/html.xsl,1.17 - Norman +Walsh

                    +
                  • +

                    Add support for floatstyle to +figure.

                    +

                    Modified: html/formal.xsl,1.21 - Robert +Stayton

                    +
                  • +

                    Handling of xref to +area/areaset need support in extensions code also. I currently have no +time to touch extensions code, so code is here to be enabled when +extension is fixed also.

                    +

                    Modified: html/xref.xsl,1.56 - Jirka +Kosek

                    +
                  • +

                    Added 3 parameters for overriding +gentext for index +punctuation.

                    +

                    Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert +Stayton

                    +
                  • +

                    Added parameters to support +localization of index item punctuation. Added +index.separator named template to compute +the separator punctuation based on +locale.

                    +

                    Modified: html/autoidx.xsl,1.27 - Robert +Stayton

                    +
                  • +

                    Added a <div +class="{$class}-contents"> wrapper around output of contents +of all formal objects. Also, added an optional <br +class="{class}-break"/> linebreak after all formal +objects.

                    +

                    WARNING: Because this change places an additional +DIV between the DIV wrapper for the equation and the +equation contents, it may break some existing CSS +stylesheets that have been created with the assumption that there +would never be an intervening DIV there.

                    +

                    The following is +an example of what Equation output looks like as a +result of the changes described above.

                    +

                    <div +class="equation"> <a name="three" +id="three"></a>

                    +

                    <p +class="title"><b>(1.3)</b></p>

                    +

                    +<div class="equation-contents"> <span +class="mathphrase">1+1=3</span> +</div> </div><br +class="equation-break">

                    +

                    Rationale: These changes allow +CSS control of the placement of the formal-object +title relative to the formal-object +contents. For example, using the CSS "float" property +enables the title and contents to be rendered on the +same line. Example stylesheet:

                    +

                    .equation +{ margin-top: 20px; margin-bottom: 20px; } +.equation-contents { float: left; }

                    +

                    +.equation .title { margin-top: 0; +float: right; margin-right: 200px; }

                    +

                    +.equation .title b { font-weight: +normal; }

                    +

                    .equation-break { clear: both; +}

                    +

                    Note that the purpose of the ".equation-break" class is +to provide a way to clear off the floats.

                    +

                    If you want +to instead have the equation title rendered to +the left of the equation contents, you can do +something like this:

                    +

                    .equation { +margin-top: 20px; width: 300px; margin-bottom: 20px; +} .equation-contents { float: right; }

                    +

                    +.equation .title { margin-top: 0; +float: left; margin-right: 200px; }

                    +

                    +.equation .title b { font-weight: +normal; }

                    +

                    .equation-break { clear: both; +}

                    +

                    Modified: html/formal.xsl,1.20 - Michael(tm) Smith

                    +
                  • +

                    Added a chunker.output.quiet +top-level parameter so that the chunker can be made quiet by +default

                    +

                    Modified: html/chunker.xsl,1.26 - Norman Walsh

                    +
                  • +

                    Added support for link, +olink, and xref within OO +Classsynopsis and children. (Because DocBook NG/5 +allows it).

                    +

                    Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) +Smith

                    +
                  • +

                    New parameter: +id.warnings. If non-zero, warnings are +generated for titled objects that don't have titles. True by default; +I wonder if this will be too aggressive?

                    +

                    Modified: html/biblio.xsl,1.25; +html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19; +html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16; +html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22; +html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman +Walsh

                    +
                  • +

                    If the +keep.relative.image.uris parameter is true, +don't use the absolute URI (as calculated from xml:base) in +the img src attribute, us the value the author +specified. Note that we still have to calculate the absolute +filename for use in the image intrinsics +extension.

                    +

                    Modified: html/graphics.xsl,1.56 - Norman +Walsh

                    +
                  • +

                    Support date as an +inline

                    +

                    Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman +Walsh

                    +
                  • +

                    Added new parameter +keep.relative.image.uris

                    +

                    Modified: fo/param.ent,1.91; +fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96; +params/keep.relative.image.uris.xml,1.1 - Norman +Walsh

                    +
                  • +

                    Added two new parameters for +handling of multi-term +varlistentry elements:

                    +

                    variablelist.term.break.after: +When the variablelist.term.break.after is +non-zero, it will generate a line break after each +term multi-term +varlistentry.

                    +

                    variablelist.term.separator: +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is +placed after each term except the last. The default +is ", " (a comma followed by a space). To suppress rendering of +the separator, set the value of +variablelist.term.separator to the empty +string ("").

                    +

                    These parameters are primarily intended to be +useful if you have multi-term varlistentries that have long +terms.

                    +

                    Closes #1306676. Thanks to Sam Steingold for +providing an example "lots of long terms" doc that demonstrated +the value of having these options.

                    +

                    Also, added +normalize-space() call to processing of each +term.

                    +

                    This change affects all output formats +(HTML, PDF, manpages). The default behavior should pretty much +remain the same as before, but it is possible (as always) that +the change may introduce some +new bugginess.

                    +

                    Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; +fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; +html/param.xweb,1.93; manpages/lists.xsl,1.22; +manpages/param.ent,1.14; manpages/param.xweb,1.16; +params/variablelist.term.break.after.xml,1.1; +params/variablelist.term.separator.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Added "wrapper-name" param to +inline.charseq named template, enabling it to output inlines +other than just "span". Acronym and Abbrev +templates now use inline.charseq to output HTML +"acronym" and "abbr" elements (instead of +"span"). Closes #1305468. Thanks to Sam Steingold for suggesting +the change.

                    +

                    Modified: html/inline.xsl,1.45 - Michael(tm) +Smith

                    +
                  +
                  + +

                  Manpages

                  + +

                  The following changes have been made to the + manpages code + since the 1.69.1 release.

                  +
                  • +

                    Added the following +params:

                    +

                    - man.indent.width (string-valued) - +man.indent.refsect (boolean) - man.indent.blurbs (boolean) +- man.indent.lists (boolean) - man.indent.verbatims +(boolean)

                    +

                    Note that in earlier snapshots, man.indent.width +was named man.indentation.default.value and the boolean params +had names like man.indentation.*.adjust. Also the +man.indent.blurbs param was called man.indentation.authors.adjust +(or something).

                    +

                    The behavior now is: If the value of a +particular man.indent.* boolean param is non-zero, the +corresponding contents (refsect*, list items, +authorblurb/personblurb, vervatims) are displayed with a left +margin indented by a width equal to the value +of man.indent.width.

                    +

                    Modified: params/man.indent.blurbs.xml,1.1; +manpages/docbook.xsl,1.74; manpages/info.xsl,1.20; +manpages/lists.xsl,1.30; manpages/other.xsl,1.20; +manpages/param.ent,1.22; manpages/param.xweb,1.24; +manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; +params/man.indent.refsect.xml,1.1; +params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 - +Michael(tm) Smith

                    +
                  • +

                    Added +man.table.footnotes.divider param.

                    +

                    In each +table that contains footenotes, the string specified +by the man.table.footnotes.divider parameter is output +before the list of footnotes for the +table.

                    +

                    Modified: manpages/docbook.xsl,1.73; +manpages/links.xsl,1.6; manpages/param.ent,1.21; +manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 - +Michael(tm) Smith

                    +
                  • +

                    Added the +man.output.in.separate.dir, +man.output.base.dir, +and man.output.subdirs.enabled parameters.

                    +

                    The +man.output.base.dir parameter specifies the +base directory into which man-page files are +output. The man.output.subdirs.enabled parameter controls whether +the files are output in subdirectories within the base +directory.

                    +

                    The values of the +man.output.base.dir +and man.output.subdirs.enabled parameters are used only if the +value of man.output.in.separate.dir parameter is non-zero. If the +value of man.output.in.separate.dir is zero, man-page files are +not output in a separate +directory.

                    +

                    Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; +manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; +params/man.output.in.separate.dir.xml,1.1; +params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Added +man.font.table.headings and +man.font.table.title params, for +controlling font in table headings and +titles.

                    +

                    Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; +manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; +params/man.font.table.title.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Added +man.font.funcsynopsisinfo and +man.font.funcprototype params, for specifying the roff +font (for example, BI, B, I) for funcsynopsisinfo and +funcprototype output.

                    +

                    Modified: manpages/block.xsl,1.19; +manpages/docbook.xsl,1.69; manpages/param.ent,1.18; +manpages/param.xweb,1.20; manpages/synop.xsl,1.29; +manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1; +params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Added +man.segtitle.suppress param.

                    +

                    If the value of +man.segtitle.suppress is non-zero, then display +of segtitle contents is suppressed in +output.

                    +

                    Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; +manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - +Michael(tm) Smith

                    +
                  • +

                    Added +man.output.manifest.enabled and +man.output.manifest.filename params.

                    +

                    If +man.output.manifest.enabled is non-zero, a list +of filenames for man pages generated by the stylesheet +transformation is written to the file named by +man.output.manifest.filename

                    +

                    Modified: manpages/docbook.xsl,1.67; +manpages/other.xsl,1.19; manpages/param.ent,1.16; +manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1; +params/man.output.manifest.filename.xml,1.1; +tools/make/Makefile.DocBook,1.4 - Michael(tm) +Smith

                    +
                  • +

                    Added +refentry.meta.get.quietly param.

                    +

                    If zero (the +default), notes and warnings about "missing" markup are generated +during gathering of refentry metadata. If +non-zero, the metadata is gathered "quietly" -- that is, the +notes and warnings are suppressed.

                    +

                    NOTE: If you are +processing a large amount of refentry content, you +may be able to speed up processing significantly by setting a +non-zero value for +refentry.meta.get.quietly.

                    +

                    Modified: common/refentry.xsl,1.17; +manpages/param.ent,1.15; manpages/param.xweb,1.17; +params/refentry.meta.get.quietly.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Changed names of all boolean +indentation params to man.indent.* Also discarded individual +man.indent.*.value params and switched to just using a common +man.indent.width param (3n by default).

                    +

                    Modified: manpages/docbook.xsl,1.66; +manpages/info.xsl,1.19; manpages/lists.xsl,1.29; +manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 - Michael(tm) +Smith

                    +
                  • +

                    Added boolean +man.output.in.separate.dir param, to control whether or not man +files are output in separate directory.

                    +

                    Modified: manpages/docbook.xsl,1.65; +manpages/utility.xsl,1.14 - Michael(tm) Smith

                    +
                  • +

                    Added options for controlling +indentation of verbatim output. Controlled through the +man.indentation.verbatims.adjust +and man.indentation.verbatims.value params. Closes +#1242997

                    +

                    Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 - +Michael(tm) Smith

                    +
                  • +

                    Added options for controlling +indentation in lists and in *blurb output in the AUTHORS +section. Controlled through +the man.indentation.lists.adjust, +man.indentation.lists.value, man.indentation.authors.adjust, and +man.indentation.authors.value parameters. Default is 3 characters +(instead of the roff default of 8 characters). Closes +#1449369.

                    +

                    Also, removed the indent that was being set on +informalexample outuput. I will instead add an option +for indenting verbatims, which I think is what the +informalexample indent was intended +for originally.

                    +

                    Modified: manpages/block.xsl,1.14; +manpages/docbook.xsl,1.63; manpages/info.xsl,1.18; +manpages/lists.xsl,1.28 - Michael(tm) Smith

                    +
                  • +

                    Changed line-spacing call before +synopfragment to use ".sp -1n" ("n" units specified) +instead of plain ".sp -1"

                    +

                    Modified: manpages/synop.xsl,1.28 - Michael(tm) +Smith

                    +
                  • +

                    Added support for writing man +files into a specific output directory and into appropriate +subdirectories within that output directory. Controlled through +the man.base.dir parameter (similar to the +base.dir support in the HTML stylesheet) and +the man.subdirs.enabled parameter, which automatically determines +the name of an appropriate subdir (for example, man/man7, +man/man1, etc.) based on the section number/manvolnum +of the source Refentry.

                    +

                    Closes #1255036 and +#1170317. Thanks to Denis Bradford for the original feature +request, and to Costin Stroie for submitting a patch that was +very helpful in implementing the +support.

                    +

                    Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 - +Michael(tm) Smith

                    +
                  • +

                    Refined XPath statements and +notification messages for refentry metadata +handling.

                    +

                    Modified: common/common.xsl,1.59; common/refentry.xsl,1.14; +manpages/docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm) +Smith

                    +
                  • +

                    Added support for +copyright and legalnotice. The manpages +stylesheets now output a COPYRIGHT section, +after the AUTHORS section, if a copyright +or legalnotice is found in the source. The +section contains the copyright contents followed +by the legalnotice contents. Closes +#1450209.

                    +

                    Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 - +Michael(tm) Smith

                    +
                  • +

                    Drastically reworked all of the +XPath expressions used in refentry metadata gathering +-- completely removed $parentinfo and turned $info into a set of +nodes that includes the *info contents of the Refentry +plus the *info contents all all of its ancestor elements. The +basic XPath expression now used throughout is (using the example +of checking for a date):

                    +

                    +(($info[//date])[last()]/date)[1].

                    +

                    That selects the "last" +*info/date date in document order -- that is, the one +eitther on the Refentry itself or on the +closest ancestor to the Refentry.

                    +

                    It's +likely this change may break some things; may need to pick up +some pieces later.

                    +

                    Also, changed the default value for the +man.th.extra2.max.length from 40 to +30.

                    +

                    Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; +params/man.th.extra2.max.length.xml,1.2; +params/refentry.date.profile.xml,1.2; +params/refentry.manual.profile.xml,1.2; +params/refentry.source.name.profile.xml,1.2; +params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; +manpages/other.xsl,1.15 - Michael(tm) Smith

                    +
                  • +

                    Added support for DocBook 5 +namespace-stripping in manpages stylesheet. Closes request +#1210692.

                    +

                    Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - +Michael(tm) Smith

                    +
                  • +

                    Fixed handling of table +footnotes. With this checkin, the table support in the +manpages stylesheet is now basically feature complete. So this +change closes request #619532, "No support for tables" -- the +oldest currently open manpages feature request, submitted by Ben +Secrest (blsecres) on 2002-10-07. Congratulations to me [patting +myself on the back].

                    +

                    Modified: manpages/block.xsl,1.11; +manpages/docbook.xsl,1.55; manpages/table.xsl,1.15 - Michael(tm) +Smith

                    +
                  • +

                    Added handling for +table titles. Also fixed handling of nested tables; +nest tables are now "extracted" and displayed just after their +parent tables.

                    +

                    Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14 +- Michael(tm) Smith

                    +
                  • +

                    Added option for turning off bold +formatting in Funcsynopsis. Boldface formatting in +function synopsis is mandated in the +man(7) man page and is used almost universally in existing man +pages. Despite that, it really does look like crap to have an +entire Funcsynopsis output in bold, so I added params +for turning off the bold formatting and/or replacing it with a +different roff special font (e.g., "RI" for alternating +roman/italic instead of the default "BI" for alternating +bold/italic). The new params +are "man.funcprototype.font" and +"man.funcsynopsisinfo.font". To be documented +later.

                    +

                    Closes #1452247. Thanks to Joe Orton for the feature +request.

                    +

                    Modified: params/man.string.subst.map.xml,1.16; +manpages/block.xsl,1.10; manpages/docbook.xsl,1.51; +manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm) +Smith

                    +
                  • +

                    Use AUTHORS instead of +AUTHOR if we have multiple people to attribute. Also, +fixed checking such that we generate +author section even if we don't have an +author (as long as there is at least one other +person/entity we can put in the +section). Also adjusted assembly of content for +Author metainfo field such that we now not only use +author, but try to find a "best match" if we can't +find an author name to put there.

                    +

                    Closes +#1233592. Thanks to Sam Steingold for the +request.

                    +

                    Modified: manpages/info.xsl,1.12 - Michael(tm) +Smith

                    +
                  • +

                    Changes for request #1243027, +"Impove handling of AUTHOR section." This +adds support for Collab, Corpauthor, Corpcredt, +Orgname, Publishername, and +Publisher. Also adds support for output +of Affiliation and its children, and support for using +gentext strings for auto-attributing roles (Author, +Editor, Publisher, Translator, etc.). Also +did a lot of code cleanup and modularization of all the +AUTHOR handling code. And fixed a bug that was causing +Author info to not be picked up correctly +for metainfo comment we embed in man-page +source.

                    +

                    Modified: manpages/info.xsl,1.11 - Michael(tm) +Smith

                    +
                  • +

                    Support bold output for +"emphasis remap='B'". (because Eric Raymond's +doclifter(1) tool converts groff source marked up with ".B" +request or "\fB" escapes to DocBook "emphasis +remap='B'".)

                    +

                    Modified: manpages/inline.xsl,1.14 - Michael(tm) +Smith

                    +
                  • +

                    Added support for +Segmentedlist. Details: Output is tabular, with no +option for "list" type output. Output for Segtitle +elements can be supressed by +setting man.segtitle.suppress. If Segtitle +content is output, it is rendered in italic type (not bold +because not all terminals support bold and so italic ensures the +stand out on those terminals). Extra space (.sp line) at end of +table code ensures that it gets handled correctly in +the case where its source is the child of a Para. +Closes feature-request #1400097. Thanks to Daniel Leidert for the +patch and push, and to Alastair Rankine for filing the original +feature request.

                    +

                    Modified: manpages/lists.xsl,1.23; +manpages/utility.xsl,1.10 - Michael(tm) Smith

                    +
                  • +

                    Improved handling or +Author/Editor/Othercredit.

                    +

                    Reworked content of +(non-visible) comment added at top of each page (metadata +stuff).

                    +

                    Added support for generating a +manifest file (useful for cleaning up +after builds, etc.)

                    +

                    Modified: manpages/docbook.xsl,1.46; +manpages/info.xsl,1.9; manpages/other.xsl,1.12; +manpages/utility.xsl,1.6 - Michael(tm) Smith

                    +
                  • +

                    Added two new parameters for +handling of multi-term +varlistentry elements:

                    +

                    variablelist.term.break.after: +When the variablelist.term.break.after is +non-zero, it will generate a line break after each +term multi-term +varlistentry.

                    +

                    variablelist.term.separator: +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is +placed after each term except the last. The default +is ", " (a comma followed by a space). To suppress rendering of +the separator, set the value of +variablelist.term.separator to the empty +string ("").

                    +

                    These parameters are primarily intended to be +useful if you have multi-term varlistentries that have long +terms.

                    +

                    Closes #1306676. Thanks to Sam Steingold for +providing an example "lots of long terms" doc that demonstrated +the value of having these options.

                    +

                    Also, added +normalize-space() call to processing of each +term.

                    +

                    This change affects all output formats +(HTML, PDF, manpages). The default behavior should pretty much +remain the same as before, but it is possible (as always) that +the change may introduce some +new bugginess.

                    +

                    Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; +fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; +html/param.xweb,1.93; manpages/lists.xsl,1.22; +manpages/param.ent,1.14; manpages/param.xweb,1.16; +params/variablelist.term.break.after.xml,1.1; +params/variablelist.term.separator.xml,1.1 - Michael(tm) +Smith

                    +
                  +
                  + +

                  Params

                  + +

                  The following changes have been made to the + params code + since the 1.69.1 release.

                  +
                  • +

                    New parameters to set +header/footer table minimum +height.

                    +

                    Modified: params/footer.table.height.xml,1.1; +params/header.table.height.xml,1.1 - Robert +Stayton

                    +
                  • +

                    Support multiple indexing methods +for different languages.

                    +

                    Modified: params/index.method.xml,1.1 - Robert +Stayton

                    +
                  • +

                    Remove qandaset and +qandadiv from generate.toc for fo +output because formerly it wasn't working, but now it is and +the default behavior should stay the +same.

                    +

                    Modified: params/generate.toc.xml,1.8 - Robert +Stayton

                    +
                  • +

                    add support for page number +references to link element +too.

                    +

                    Modified: params/insert.link.page.number.xml,1.1 - Robert +Stayton

                    +
                  • +

                    Add support for more characters to +hyphen on when ulink.hyphenate is turned +on.

                    +

                    Modified: params/ulink.hyphenate.chars.xml,1.1; +params/ulink.hyphenate.xml,1.3 - Robert Stayton

                    +
                  • +

                    New attribute-set to format +biblioentry and +bibliomixed.

                    +

                    Modified: params/biblioentry.properties.xml,1.1 - +Robert Stayton

                    +
                  • +

                    Added new parameter +chunk.tocs.and.lots.has.title which +controls presence of title in a separate chunk with +ToC/LoT. Disabling title can be very useful if you are +generating frameset output (well, yes those frames, but some customers +really want them ;-).

                    +

                    Modified: html/chunk-code.xsl,1.15; +html/param.ent,1.93; html/param.xweb,1.102; +params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka +Kosek

                    +
                  • +

                    Added new attribute set +toc.line.properties for controlling appearance of lines in +ToC/LoT

                    +

                    Modified: params/toc.line.properties.xml,1.1 - Jirka +Kosek

                    +
                  • +

                    Allow table footnotes +to have different properties from regular +footnotes.

                    +

                    Modified: params/table.footnote.properties.xml,1.1 - Robert +Stayton

                    +
                  • +

                    Set properties for pgwide="1" +objects.

                    +

                    Modified: params/pgwide.properties.xml,1.1 - Robert +Stayton

                    +
                  • +

                    Added the +autotoc.label.in.hyperlink param.

                    +

                    If the value +of autotoc.label.in.hyperlink is non-zero, labels +are included in hyperlinked titles in the TOC. If it +is instead zero, labels are still displayed prior to the +hyperlinked titles, but are not hyperlinked along with the +titles.

                    +

                    Closes patch #1065868. Thanks to anatoly techtonik +for the patch.

                    +

                    Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; +html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - +Michael(tm) Smith

                    +
                  • +

                    Added two new params: +html.head.legalnotice.link.types +and html.head.legalnotice.link.multiple.

                    +

                    If +the value of the generate.legalnotice.link is +non-zero, then the stylesheet generates (in the head +section of the HTML source) either a single HTML +link element or, if the value of +the html.head.legalnotice.link.multiple is +non-zero, one link element for each link +type specified. Each link has the +following attributes:

                    +

                    - a rel attribute whose value +is derived from the value of +html.head.legalnotice.link.types

                    +

                    - +an href attribute whose value is set to the URL of the file +containing the legalnotice

                    +

                    - a title +attribute whose value is set to the title of the +corresponding legalnotice (or a title +programatically determined by the stylesheet)

                    +

                    For +example:

                    +

                    <link rel="copyright" +href="ln-id2524073.html" title="Legal Notice">

                    +

                    Closes +#1476450. Thanks to Sam Steingold.

                    +

                    Modified: html/chunk-common.xsl,1.45; +html/param.ent,1.91; html/param.xweb,1.100; +params/generate.legalnotice.link.xml,1.4; +params/html.head.legalnotice.link.multiple.xml,1.1; +params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Added the following +params:

                    +

                    - man.indent.width (string-valued) - +man.indent.refsect (boolean) - man.indent.blurbs (boolean) +- man.indent.lists (boolean) - man.indent.verbatims +(boolean)

                    +

                    Note that in earlier snapshots, man.indent.width +was named man.indentation.default.value and the boolean params +had names like man.indentation.*.adjust. Also the +man.indent.blurbs param was called man.indentation.authors.adjust +(or something).

                    +

                    The behavior now is: If the value of a +particular man.indent.* boolean param is non-zero, the +corresponding contents (refsect*, list items, +authorblurb/personblurb, vervatims) are displayed with a left +margin indented by a width equal to the value +of man.indent.width.

                    +

                    Modified: params/man.indent.blurbs.xml,1.1; +manpages/docbook.xsl,1.74; manpages/info.xsl,1.20; +manpages/lists.xsl,1.30; manpages/other.xsl,1.20; +manpages/param.ent,1.22; manpages/param.xweb,1.24; +manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; +params/man.indent.refsect.xml,1.1; +params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 - +Michael(tm) Smith

                    +
                  • +

                    Added +man.table.footnotes.divider param.

                    +

                    In each +table that contains footenotes, the string specified +by the man.table.footnotes.divider parameter is output +before the list of footnotes for the +table.

                    +

                    Modified: manpages/docbook.xsl,1.73; +manpages/links.xsl,1.6; manpages/param.ent,1.21; +manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 - +Michael(tm) Smith

                    +
                  • +

                    Added the +man.output.in.separate.dir, +man.output.base.dir, +and man.output.subdirs.enabled parameters.

                    +

                    The +man.output.base.dir parameter specifies the +base directory into which man-page files are +output. The man.output.subdirs.enabled parameter controls whether +the files are output in subdirectories within the base +directory.

                    +

                    The values of the +man.output.base.dir +and man.output.subdirs.enabled parameters are used only if the +value of man.output.in.separate.dir parameter is non-zero. If the +value of man.output.in.separate.dir is zero, man-page files are +not output in a separate +directory.

                    +

                    Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; +manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; +params/man.output.in.separate.dir.xml,1.1; +params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Added +man.font.table.headings and +man.font.table.title params, for +controlling font in table headings and +titles.

                    +

                    Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; +manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; +params/man.font.table.title.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Added +man.font.funcsynopsisinfo and +man.font.funcprototype params, for specifying the roff +font (for example, BI, B, I) for funcsynopsisinfo and +funcprototype output.

                    +

                    Modified: manpages/block.xsl,1.19; +manpages/docbook.xsl,1.69; manpages/param.ent,1.18; +manpages/param.xweb,1.20; manpages/synop.xsl,1.29; +manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1; +params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Changed to select="0" in +refclass.suppress (instead of +..>0</..)

                    +

                    Modified: params/refclass.suppress.xml,1.3 - Michael(tm) +Smith

                    +
                  • +

                    Added +man.segtitle.suppress param.

                    +

                    If the value of +man.segtitle.suppress is non-zero, then display +of segtitle contents is suppressed in +output.

                    +

                    Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; +manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - +Michael(tm) Smith

                    +
                  • +

                    Added +man.output.manifest.enabled and +man.output.manifest.filename params.

                    +

                    If +man.output.manifest.enabled is non-zero, a list +of filenames for man pages generated by the stylesheet +transformation is written to the file named by +man.output.manifest.filename

                    +

                    Modified: manpages/docbook.xsl,1.67; +manpages/other.xsl,1.19; manpages/param.ent,1.16; +manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1; +params/man.output.manifest.filename.xml,1.1; +tools/make/Makefile.DocBook,1.4 - Michael(tm) +Smith

                    +
                  • +

                    Added refclass.suppress +param.

                    +

                    If the value of refclass.suppress is +non-zero, then display refclass contents is suppressed +in output. Affects HTML and FO output +only.

                    +

                    Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; +html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Added +refentry.meta.get.quietly param.

                    +

                    If zero (the +default), notes and warnings about "missing" markup are generated +during gathering of refentry metadata. If +non-zero, the metadata is gathered "quietly" -- that is, the +notes and warnings are suppressed.

                    +

                    NOTE: If you are +processing a large amount of refentry content, you +may be able to speed up processing significantly by setting a +non-zero value for +refentry.meta.get.quietly.

                    +

                    Modified: common/refentry.xsl,1.17; +manpages/param.ent,1.15; manpages/param.xweb,1.17; +params/refentry.meta.get.quietly.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Added support for "software" and +"sectdesc" class values on refmiscinfo; "software" is +treated identically to "source", and "setdesc" is treated +identically to "manual".

                    +

                    Modified: common/refentry.xsl,1.10; +params/man.th.extra2.max.length.xml,1.3; +params/refentry.source.name.profile.xml,1.4 - Michael(tm) +Smith

                    +
                  • +

                    Drastically reworked all of the +XPath expressions used in refentry metadata gathering +-- completely removed $parentinfo and turned $info into a set of +nodes that includes the *info contents of the Refentry +plus the *info contents all all of its ancestor elements. The +basic XPath expression now used throughout is (using the example +of checking for a date):

                    +

                    +(($info[//date])[last()]/date)[1].

                    +

                    That selects the "last" +*info/date date in document order -- that is, the one +eitther on the Refentry itself or on the +closest ancestor to the Refentry.

                    +

                    It's +likely this change may break some things; may need to pick up +some pieces later.

                    +

                    Also, changed the default value for the +man.th.extra2.max.length from 40 to +30.

                    +

                    Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; +params/man.th.extra2.max.length.xml,1.2; +params/refentry.date.profile.xml,1.2; +params/refentry.manual.profile.xml,1.2; +params/refentry.source.name.profile.xml,1.2; +params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; +manpages/other.xsl,1.15 - Michael(tm) Smith

                    +
                  • +

                    Added option for turning off bold +formatting in Funcsynopsis. Boldface formatting in +function synopsis is mandated in the +man(7) man page and is used almost universally in existing man +pages. Despite that, it really does look like crap to have an +entire Funcsynopsis output in bold, so I added params +for turning off the bold formatting and/or replacing it with a +different roff special font (e.g., "RI" for alternating +roman/italic instead of the default "BI" for alternating +bold/italic). The new params +are "man.funcprototype.font" and +"man.funcsynopsisinfo.font". To be documented +later.

                    +

                    Closes #1452247. Thanks to Joe Orton for the feature +request.

                    +

                    Modified: params/man.string.subst.map.xml,1.16; +manpages/block.xsl,1.10; manpages/docbook.xsl,1.51; +manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm) +Smith

                    +
                  • +

                    fop.extensions now only +for FOP version 0.20.5 and earlier.

                    +

                    Modified: params/fop.extensions.xml,1.4 +- Robert Stayton

                    +
                  • +

                    Support for fop1 different from +fop 0.20.5 and earlier.

                    +

                    Modified: params/fop1.extensions.xml,1.1 - Robert +Stayton

                    +
                  • +

                    Reset default value to empty +string so template uses gentext first, then the parameter value +if not empty.

                    +

                    Modified: params/index.number.separator.xml,1.2; +params/index.range.separator.xml,1.2; +params/index.term.separator.xml,1.2 - Robert +Stayton

                    +
                  • +

                    New parameter: +id.warnings. If non-zero, warnings are +generated for titled objects that don't have titles. True by default; +I wonder if this will be too aggressive?

                    +

                    Modified: html/biblio.xsl,1.25; +html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19; +html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16; +html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22; +html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman +Walsh

                    +
                  • +

                    Added new parameter +keep.relative.image.uris

                    +

                    Modified: fo/param.ent,1.91; +fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96; +params/keep.relative.image.uris.xml,1.1 - Norman +Walsh

                    +
                  • +

                    Support default label +width parameters for itemized and ordered lists

                    +

                    Modified: fo/lists.xsl,1.64; +fo/param.ent,1.90; fo/param.xweb,1.103; +params/itemizedlist.label.width.xml,1.1; +params/orderedlist.label.width.xml,1.1 - Norman +Walsh

                    +
                  • +

                    Added parameters to localize +punctuation in indexes.

                    +

                    Modified: params/index.number.separator.xml,1.1; +params/index.range.separator.xml,1.1; +params/index.term.separator.xml,1.1 - Robert +Stayton

                    +
                  • +

                    Added two new parameters for +handling of multi-term +varlistentry elements:

                    +

                    variablelist.term.break.after: +When the variablelist.term.break.after is +non-zero, it will generate a line break after each +term multi-term +varlistentry.

                    +

                    variablelist.term.separator: +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is +placed after each term except the last. The default +is ", " (a comma followed by a space). To suppress rendering of +the separator, set the value of +variablelist.term.separator to the empty +string ("").

                    +

                    These parameters are primarily intended to be +useful if you have multi-term varlistentries that have long +terms.

                    +

                    Closes #1306676. Thanks to Sam Steingold for +providing an example "lots of long terms" doc that demonstrated +the value of having these options.

                    +

                    Also, added +normalize-space() call to processing of each +term.

                    +

                    This change affects all output formats +(HTML, PDF, manpages). The default behavior should pretty much +remain the same as before, but it is possible (as always) that +the change may introduce some +new bugginess.

                    +

                    Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; +fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; +html/param.xweb,1.93; manpages/lists.xsl,1.22; +manpages/param.ent,1.14; manpages/param.xweb,1.16; +params/variablelist.term.break.after.xml,1.1; +params/variablelist.term.separator.xml,1.1 - Michael(tm) +Smith

                    +
                  • +

                    Convert 'no' to string in default +value.

                    +

                    Modified: params/olink.doctitle.xml,1.4 - Robert +Stayton

                    +
                  • +

                    Implemented RFE +#1292615.

                    +

                    Added bunch of new parameters (attribute sets) +that affect list presentation: list.block.properties, +itemizedlist.properties, orderedlist.properties, +itemizedlist.label.properties and +orderedlist.label.properties. Default behaviour +of stylesheets has not been changed but further customizations will be +much more easier.

                    +

                    Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; +fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1; +params/itemizedlist.properties.xml,1.1; +params/list.block.properties.xml,1.1; +params/orderedlist.label.properties.xml,1.1; +params/orderedlist.properties.xml,1.1 - Jirka +Kosek

                    +
                  • +

                    Implemented RFE +#1242092.

                    +

                    You can enable crop marks in your document by +setting crop.marks=1 and xep.extensions=1. Appearance of crop +marks can be controlled by parameters +crop.mark.bleed (6pt), +crop.mark.offset (24pt) and +crop.mark.width (0.5pt).

                    +

                    Also there +is new named template called user-xep-pis. You can overwrite it in +order to produce some PIs that can control XEP as described in +http://www.renderx.com/reference.html#Output_Formats

                    +

                    Modified: fo/docbook.xsl,1.36; +fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23; +params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1; +params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka +Kosek

                    +
                  • +

                    Changed short descriptions in doc +for *autolabel* params to match new autolabel +behavior.

                    +

                    Modified: params/appendix.autolabel.xml,1.5; +params/chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5; +params/preface.autolabel.xml,1.4 - Michael(tm) +Smith

                    +
                  +
                  + +

                  Profiling

                  + +

                  The following changes have been made to the + profiling code + since the 1.69.1 release.

                  +
                  • +

                    Profiling now works together with +namespace stripping (V5 documents). Namespace striping should work +with all stylesheets named profile-, even if they are not supporting +namespace stripping in a non-profiling +variant.

                    +

                    Modified: profiling/profile-mode.xsl,1.4; +profiling/xsl2profile.xsl,1.7 - Jirka Kosek

                    +
                  • +

                    Moved profiling stage out of +templates. This make possible to reuse profiled content by several +templates and still maintaing node indentity (needed for example for +HTML Help where content is processed multiple times).

                    +

                    I +don't know why this was not on the top level before. Maybe some XSLT +processors choked on it. I hope this will be OK +now.

                    +

                    Modified: profiling/xsl2profile.xsl,1.5 - Jirka +Kosek

                    +
                  +
                  + +

                  Tools

                  + +

                  The following changes have been made to the + tools code + since the 1.69.1 release.

                  +
                  • +

                    Moved Makefile.DocBook from +contrib module to xsl +module.

                    +

                    Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm) +Smith

                    +
                  +
                  + +

                  WordML

                  + +

                  The following changes have been made to the + wordml code + since the 1.69.1 release.

                  +
                  • +

                    added contrib element, +better handling of default paragraph +style

                    +

                    Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2; +wordml/wordml-final.xsl,1.14 - Steve Ball

                    +
                  • +

                    added +bridgehead

                    +

                    Modified: wordml/docbook-pages.xsl,1.6; +wordml/docbook.xsl,1.17; wordml/pages-normalise.xsl,1.5; +wordml/template-pages.xml,1.7; wordml/template.dot,1.4; +wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 - Steve +Ball

                    +
                  • +

                    added blocks stylesheet to support +bibliographies, glossaries and qandasets

                    +

                    Modified: wordml/Makefile,1.4; +wordml/README,1.3; wordml/blocks-spec.xml,1.1; +wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16; +wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3; +wordml/specifications.xml,1.13; wordml/template-pages.xml,1.6; +wordml/template.dot,1.3; wordml/template.xml,1.13; +wordml/wordml-blocks.xsl,1.1; wordml/wordml-final.xsl,1.12; +wordml/wordml-sections.xsl,1.3 - Steve Ball

                    +
                  • +

                    added mediaobject +caption

                    +

                    Modified: wordml/docbook-pages.xsl,1.4; +wordml/docbook.xsl,1.15; wordml/specifications.xml,1.12; +wordml/template-pages.xml,1.5; wordml/template.dot,1.2; +wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 - Steve +Ball

                    +
                  • +

                    added +callouts

                    +

                    Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14; +wordml/pages-normalise.xsl,1.3; wordml/specifications.xml,1.11; +wordml/template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve +Ball

                    +
                  • +

                    added Word template +file

                    +

                    Modified: wordml/template.dot,1.1 - Steve Ball

                    +
                  • +

                    added abstract, fixed +itemizedlist, ulink

                    +

                    Modified: wordml/specifications.xml,1.10; +wordml/wordml-final.xsl,1.9 - Steve Ball

                    +
                  • +

                    fixed Makefile added many +features to Pages support added revhistory, inlines, +highlights, abstract

                    +

                    Modified: wordml/Makefile,1.2; +wordml/docbook-pages.xsl,1.2; wordml/pages-normalise.xsl,1.2; +wordml/sections-spec.xml,1.2; wordml/specifications.xml,1.9; +wordml/template-pages.xml,1.3; wordml/template.xml,1.11; +wordml/wordml-final.xsl,1.8; wordml/wordml-sections.xsl,1.2 - Steve +Ball

                    +
                  • +

                    fixed handling linebreaks when +generating WordML added Apple Pages +support

                    +

                    Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 - +Steve Ball

                    +
                  +
                  +
                  + +

                  Release 1.69.1

                  + +

                  This release is a minor bug-fix update to the 1.69.0 + release. Along with bug fixes, it includes one + configuration-parameter change: The default value of the + annotation.support parameter is now + 0 (off). The reason for that change is that + there have been reports that annotation handling is + causing a significant performance degradation in processing of + large documents with xsltproc.

                  +
                  + + +

                  Release 1.69.0

                  + +

                  The release includes major feature changes, + particularly in the manpages + stylesheets, as well as a large number of bug fixes.

                  + +

                  As with all DocBook Project “dot zero” releases, this is an + experimental release .

                  + +

                  Common

                  + +
                  • +

                    This release adds localizations for the following + languages: + Albanian, Amharic, Azerbaijani, Hindi, Irish (Gaelic), Gujarati, Kannada, Mongolian, Oriya, Punjabi, Tagalog, Tamil, and Welsh.

                    +
                  • +

                    Added support for specifying number format for auto + labels for chapter, appendix, + part, and preface. Contolled with the + appendix.autolabel, + chapter.autolabel, + part.autolabel, and + preface.autolabel parameters.

                    +
                  • +

                    Added basic support for biblioref cross + referencing.

                    +
                  • +

                    Added support for align + on caption in mediaobject.

                    +
                  • +

                    Added support for processing documents that use the + DocBook V5 namespace.

                    +
                  • +

                    Added support for termdef and + mathphrase.

                    +
                  • +

                    EXPERIMENTAL: Incorporated the Slides and Website + stylesheets into the DocBook XSL stylesheets package. So, + for example, Website documents can now be processed using + the following URI for the driver Website + tabular.xsl file: 

                    http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl
                    +
                  • +

                    A procedure without a title is + now treated as an “informal” procedure (meaning + that it is not added to any generated “list of + procedures” and has no affect on numbering of + generated labels for other procedures).

                    +
                  • +

                    docname is no longer added to + olink when pointing to a root element.

                    +
                  • +

                    Added support for generation of choice separator in + inline simplelist. This enables auto-generation of an + appropriate localized “choice separator” (for + example, “and” or “or”) before the + final item in an inline simplelist.

                    +

                    To indicate that you want a choice separator + generated for a particular list, you need to put a processing + instruction (PI) of the form + <?dbchoice choice="foo"?> as a + child of the list. For example: + 

                      <para>Choose from
+  ONE and ONLY ONE of the following: 
+  <simplelist type="inline">
+  <?dbchoice choice="or" ?>
+  <member>A</member>
+  <member>B</member>
+  <member>C</member>.</simplelist></para>

                    + + Output (for English): +

                    +

                    Choose from ONE and only ONE of the + following choices: A, B, or C.

                    +

                    + As a temporary workaround for the fact that most of the + DocBook non-English locale files don't have a localization for + the word “or”, you can put in a literal string to + be used; example for French: <?dbchoice choice="ou">. That is, use + “ou” instead of “or”.

                    +
                  +
                  +

                  FO

                  + +
                  • +

                    Added content-type property to + external-graphic element, based on + imagedata format + attribute.

                    +
                  • +

                    Added support for generating + <rx:meta-field creator="$VERSION"/> + field for XEP output. This makes the DocBook XSL + stylesheet version information available through the + Document Properties menu in Acrobat + Reader and other PDF viewers.

                    +
                  • +

                    Trademark symbol handling made consistent with + handling of same in HTML stylesheets. Prior to this change, + if you processed a document that contained no value for the + class attribute on the + trademark element, the HTML stylesheets would + default to rendering a superscript TM + symbol after the trademark contents, + but the FO stylesheets would render nothing.

                    +
                  • +

                    Added support for generating XEP bookmarks for + refentry.

                    +
                  • +

                    Added support for HTML markup table border attribute, applied to each + table cell.

                    +
                  • +

                    The table.width template can now + sum column specs if none use % or + *.

                    +
                  • +

                    Added fox:destination extension + inside fox:outline to support linking to + internal destinations.

                    +
                  • +

                    Added support for customizing + abstract with property sets. Controlled + with the abstract.properties and + abstract.title.properties + parameters.

                    +
                  • +

                    Add footnotes in table title to + table footnote set, and add support for table footnotes to + HTML table markup.

                    +
                  • +

                    Added support for title in + glosslist.

                    +
                  • +

                    Added support for itemizedlist symbol + none.

                    +
                  • +

                    Implemented the new + graphical.admonition.properties and + nongraphical.admonition.properties + attribute sets.

                    +
                  • +

                    Added id to + formalpara and some other blocks that were + missing it.

                    +
                  • +

                    Changed the anchor template to output + fo:inline instead of + fo:wrapper.

                    +
                  • +

                    Added support for toc.max.depth + parameter.

                    +
                  +
                  + +

                  Help

                  + +
                  • +

                    Eclipse Help: Added support for generating olink + database.

                    +
                  +
                  + +

                  HTML

                  + +
                  +
                  +

                  man

                  + +

                  This release closes out 44 manpages stylesheet bug reports + and feature requests. It adds more than 35 new configuration + parameters for controlling aspects of man-page output -- + including hyphenation and justification, handling of links, + conversion of Unicode characters, and contents of man-page + headers and footers.

                  +
                  • +

                    New options for globally disabling/enabling + hyphenation and justification: + man.justify and + man.hyphenate.

                    +

                    Note that the default + for the both of those is zero (off), because justified text + looks good only when it is also hyphenated; to quote the + “Hyphenation” node from the groff info page: +

                    +

                    Since the odds are not great for finding a + set of words, for every output line, which fit nicely on a + line without inserting excessive amounts of space between + words, `gtroff' hyphenates words so that it can justify + lines without inserting too much space between + words.

                    +

                    + The problem is that groff can end up hyphenating a lot of + things that you don't want hyphenated (variable names and + command names, for example). Keeping both justification and + hyphenation disabled ensures that hyphens won't get inserted + where you don't want to them, and you don't end up with + lines containing excessive amounts of space between + words. These default settings run counter to how most + existing man pages are formatted. But there are some notable + exceptions, such as the perl man pages.

                    +
                  • +

                    Added parameters for controlling hyphenation of + computer inlines, filenames, and URLs. By default, even when + hyphenation is enabled (globally), hyphenation is now + suppressed for "computer inlines" (currently, just + classname, constant, envar, + errorcode, option, + replaceable, userinput, + type, and varname, and for + filenames, and for URLs from link. It + can be (re)enabled using the + man.hyphenate.computer.inlines, + man.hyphenate.filenames, and + man.hyphenate.urls parameters.

                    +
                  • +

                    Implemented a new system for replacing Unicode + characters. There are two parts to the new system: a + “string substitution map” for doing + “essential” replacements, and a + “character map” that can optionally be disabled + and enabled.

                    +

                    The new system fixes all open bugs that had to do with + literal Unicode numbered entities such as &#8220; and + &#8221; showing up in output, and greatly expands the + ability of the stylesheets to generate “good” roff + equivalents for Unicode symbols and special + characters.

                    +

                    Here are some details...

                    +

                    The previous manpages mechanism for replacing Unicode + symbols and special characters with roff equivalents (the + replace-entities template) was not + scalable and not complete. The mechanism handled a somewhat + arbitrary selection of less than 20 or so Unicode + characters. But there are potentially more than + 800 Unicode special characters that + have some groff equivalent they can be mapped to. And there + are about 34 symbols in the Latin-1 (ISO-8859-1) block + alone. Users might reasonably expect that if they include + any of those Latin-1 characters in their DocBook source + documents, they will get correctly converted to known roff + equivalents in output.

                    +

                    In addition to those common symbols, certain users may + have a need to use symbols from other Unicode blocks. Say, + somebody who is documenting an application related to math + might need to use a bunch of symbols from the + “Mathematical Operators” Unicode block (there + are about 65 characters in that block that have reasonable + roff equivalents). Or somebody else might really like + Dingbats -- such as the checkmark character -- and so might + use a bunch of things from the “Dingbat” block + (141 characters in that that have roff equivalents or that + can at least be “degraded” somewhat gracefully + into roff).

                    +

                    So, the old replace-entities + mechanism was replaced with a completely different mechanism + that is based on use of two “maps”: a + “substitution map” and a “character + map” (the latter in a format compliant with the XSLT + 2.0 spec and therefore completely “forward + compatible” with XSLT 2.0).

                    +

                    The substitution map is controlled through the + man.string.subst.map parameter, and + is used to replace things like the backslash character + (which needs special handling to prevent it from being + interpreted as a roff escape). The substitution map cannot + be disabled, because disabling it will cause the output to + be broken. However, you can add to it and change it if + needed.

                    + +

                    The “character map” mechanism, on the + other hand, can be completely disabled. It is enabled by + default, and, by default, does replacement of all Latin-1 + symbols, along with most special spaces, dashes, and quotes + (about 75 characters by default). Also, you can optionally + enable a “full” character map that provides + support for converting all 800 or so of the characters that + have some reasonable groff equivalent.

                    + +

                    The character-map mechanism is controlled through the + following parameters: +

                    man.charmap.enabled

                    turns character-map support + on/off

                    man.charmap.use.subset

                    specifies that a subset of the character + map is used instead of the full map

                    man.charmap.subset.profile

                    specifies profile of character-map + subset

                    man.charmap.uri

                    specifies an alternate character map to + use instead of the “standard” character map + provided in the distribution

                    +

                    +
                  • +

                    Implemented out-of-line handling of display of URLs + for links (currently, only for ulink). This gives + you three choices for handling of links: +

                    1. +

                      Number and list links. Each link is numbered + inline, with a number in square brackets preceding the + link contents, and a numbered list of all links is added + to the end of the document.

                      +
                    2. +

                      Only list links. Links are not numbered, but an + (unnumbered) list of links is added to the end of the + document.

                      +
                    3. +

                      Suppress links. Don't number links and don't add + any list of links to the end of the document.

                      +

                    + You can also choose whether links should be underlined. The + default is “the works” -- list, number, and + underline links. You can use the + man.links.list.enabled, + man.links.are.numbered, and + man.links.are.underlined parameters + to change the defaults. The default heading for the link + list is REFERENCES. You can be change that using the + man.links.list.heading + parameter.

                    +
                  • +

                    Changed default output encoding to UTF-8. This does not mean that man pages are output in + raw UTF-8, because the character map is applied + before final output, causing all UTF-8 characters covered in + the map to be converted to roff equivalents.

                    +
                  • +

                    Added support for processing refsect3 and + formalpara and nested refsection + elements, down to any arbitrary level of nesting.

                    +
                  • +

                    Output of the NAME and + SYNOPSIS and AUTHOR + headings and the headings for admonitions (note, + caution, etc.) are no longer hard-coded for + English. Instead, headings are generated for those in the + correct locale (just as the FO and HTML stylesheets + do).

                    +
                  • +

                    Re-worked mechanism for assembling page + headers/footers (the contents of the .TH + macro “title line”).

                    + +

                    Here are some details...

                    + +

                    All man pages contain a .TH roff + macro whose contents are used for rendering the “title + line” displayed in the header and footer of each + page. Here are a couple of examples of real-world man pages + that have useful page headers/footers: 

                    +  gtk-options(7)    GTK+ User's Manual   gtk-options(7) <-- header
+  GTK+ 1.2              2003-10-20       gtk-options(7) <-- footer
+
+  svgalib(7)       Svgalib User Manual       svgalib(7) <-- header
+  Svgalib 1.4.1      16 December 1999        svgalib(7) <-- footer
                    + +

                    And here are the terms with which the + groff_man(7) man page refers to the + various parts of the header/footer: 

                    +  title(section)  extra3  title(section)  <- header
+  extra2          extra1  title(section)  <- footer
                    +

                    Or, using the names with which the man(7) + man page refers to those same fields: 

                    +  title(section)  manual  title(section)  <- page header
+  source          date    title(section)  <- page footer
                    + +

                    The easiest way to control the contents of those + fields is to mark up your refentry content like + the following (note that this is a “minimal” + example). 

                    +  <refentry>
+    <info>
+      <date>2003-10-20</date> 1
+    </info>
+    <refmeta>
+      <refentrytitle>gtk-options</refentrytitle> 2
+      <manvolnum>7</manvolnum> 3
+      <refmiscinfo class="source-name">GTK+</refmiscinfo> 4
+      <refmiscinfo class="version">1.2</refmiscinfo> 5
+      <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> 6
+    </refmeta>
+    <refnamediv>
+      <refname>gtk-options</refname>
+      <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose>
+    </refnamediv>
+    <refsect1>
+      <title>Description</title>
+      <para>This manual page describes the command line options, which
+      are common to all GTK+ based applications.</para>
+    </refsect1>
+  </refentry>

                    +

                    1 +

                    Sets the “date” part of the header/footer.

                    +
                    2 +

                    Sets the “title” part.

                    +
                    3 +

                    Sets the “section” part.

                    +
                    4 +

                    Sets the “source name” part.

                    +
                    5 +

                    Sets the “version” part.

                    +
                    6 +

                    Sets the “manual” part.

                    +

                    +

                    +

                    Below are explanations of the steps the stylesheets + take to attempt to assemble and display + “good” headers and footer. [In the + descriptions, note that *info + is the refentry “info” child + (whatever its name), and + parentinfo is the + “info” child of its parent (again, whatever + its name).] +

                    extra1 field (date)
                    +

                    Content of the “extra1” field is + what shows up in the center + footer position of each page. The + man(7) man page describes it as + “the date of the last revision”.

                    +

                    To provide this content, if the + refentry.date.profile.enabled + is non-zero, the stylesheets check the value of + refentry.date.profile.

                    +

                    Otherwise, by default, they check for a + date or pubdate not only in the + *info contents, but also in + the parentinfo + contents.

                    +

                    If a date cannot be found, the stylesheets now + automatically generate a localized “long + format” date, ensuring that this field always + has content in output.

                    +

                    However, if for some reason you want to suppress + this field, you can do so by setting a non-zero value + for man.th.extra1.suppress.

                    +
                    extra2 field (source)
                    +

                    On Linux systems and on systems with a modern + groff, the content of the “extra2” field + are what shows up in the left + footer position of each page.

                    + +

                    The man(7) man page describes + this as “the source of the command”, and + provides the following examples: +

                    • +

                      For binaries, use somwething like: GNU, + NET-2, SLS Distribution, MCC Distribution.

                      +
                    • +

                      For system calls, use the version of the + kernel that you are currently looking at: Linux + 0.99.11.

                      +
                    • +

                      For library calls, use the source of the + function: GNU, BSD 4.3, Linux DLL 4.4.1.

                      +

                    +

                    + +

                    In practice, there are many pages that simply + have a version number in the “source” + field. So, it looks like what we have is a two-part + field, + Name Version, + where: +

                    Name
                    +

                    product name (e.g., BSD) or org. name + (e.g., GNU)

                    +
                    Version
                    +

                    version name

                    +

                    + Each part is optional. If the + Name is a product name, + then the Version is + probably the version of the product. Or there may be + no Name, in which case, if + there is a Version, it is + probably the version of the item itself, not the + product it is part of. Or, if the + Name is an organization + name, then there probably will be no + Version. +

                    +

                    To provide this content, if the + refentry.source.name.profile.enabled + and + refentry.version.profile.enabled + parameter are non-zero, the stylesheets check the + value of refentry.source.name.profile + refentry.version.profile.

                    + +

                    Otherwise, by default, they check the following + places, in the following order: +

                    1. + 
                      *info/productnumber
                      +
                    2. + 
                      *info/productnumber
                      +
                    3. + 
                      refmeta/refmiscinfo[@class = 'version']
                      +
                    4. + 
                      parentinfo/productnumber
                      +
                    5. + 
                      *info/productname
                      +
                    6. + 
                      parentinfo/productname
                      +
                    7. + 
                      refmeta/refmiscinfo
                      +
                    8. +

                      [nothing found, so leave it empty]

                      +

                    +

                    +
                    extra3 field
                    +

                    On Linux systems and on systems with a modern + groff, the content of the “extra3” field + are what shows up in the center + header position of each page. Some man + pages have “extra2” content, some + don't. If a particular man page has it, it is most + often “context” data about some larger + system the documented item belongs to (for example, + the name or description of a group of related + applications). The stylesheets now check the following + places, in the following order, to look for content to + add to the “extra3” field.

                    +
                    1. + 
                      parentinfo/title
                      +
                    2. + 
                      parent's title
                      +
                    3. + 
                      refmeta/refmiscinfo
                      +
                    4. +

                      [nothing found, so leave it empty]

                      +
                    +

                    +

                    +
                  • +

                    Reworked *info gathering. For + each refentry found, the stylesheets now cache its + *info content, then check for any + valid parent of it that might have metainfo content and cache + that, if found; they then then do all further matches against + those node-sets (rather than re-selecting the original + *info nodes each time they are + needed).

                    +
                  • +

                    New option for breaking strings after forward + slashes. This enables long URLs and pathnames to be broken + across lines. Controlled through + man.break.after.slash parameter.

                    +
                  • +

                    Output for servicemark and trademark are now + (SM) and (TM). There is + a groff "\(tm" escape, but output from that + is not acceptable.

                    +
                  • +

                    New option for controlling the length of the title + part of the .TH title line. Controlled + through the man.th.title.max.length + parameter.

                    +
                  • +

                    New option for specifying output encoding of each man + page; controlled with + man.output.encoding (similar to the + HTML chunker.output.encoding + parameter).

                    +
                  • +

                    New option for suppressing filename messages when + generating output; controlled with + man.output.quietly (similar to the HTML + chunk.quietly parameter).

                    +
                  • +

                    The text of cross-references to first-level + refentry (refsect1, top-level + refsection, refnamediv, and + refsynopsisdiv) are now capitalized.

                    +
                  • +

                    Cross-references to refnamediv now use the + localized NAME title instead of using the + first refname child. This makes the output + inconsistent with HTML and FO output, but for man-page output, + it seems to make better sense to have the + NAME. (It may actually make better sense to + do it that way in HTML and FO output as well...)

                    +
                  • +

                    Added support for processing funcparams.

                    +
                  • +

                    Removed the space that was being output between + funcdef and paramdef; example: was: + float rand (void); now: + float rand(void)

                    +
                  • +

                    Turned off bold formatting for the type + element when it occurs within a funcdef or + paramdef

                    +
                  • +

                    Corrected rendering of simplelist. Any + <simplelist type="inline" instance + is now rendered as a comma-separated list (also with an + optional localized “and” or “or” before the last item -- see + description elsewhere in these release notes). Any simplelist + instance whose type is not + inline is rendered as a one-column vertical + list (ignoring the values of the type and columns attributes if present)

                    +
                  • +

                    Comment added at top of roff source for each page now + includes DocBook XSL stylesheets version number (as in the + HTML stylesheets)

                    +
                  • +

                    Made change to prevent “sticky” fonts + changes. Now, when the manpages stylesheets encounter node + sets that need to be boldfaced or italicized, they put the + \fBfoo\fR and \fIbar\fR + groff bold/italic instructions separately around each node in + the set.

                    +
                  • +

                    synop.xsl: Boldface everything in + funcsynopsis output except parameters (which are in + ital). The man(7) man page says: +

                    +

                    For functions, the arguments are always specified + using italics, even in the SYNOPSIS section, where the rest + of the function is specified in bold.

                    +

                    + A look through the contents of the + man/man2 directory shows that most + (all) existing pages do follow this “everything in + funcsynopsis bold” rule. That means the + type content and any punctuation (parens, + semicolons, varargs) also must be bolded.

                    +
                  • +

                    Removed code for adding backslashes before periods/dots + in roff source, because backslashes in front of periods/dots + in roff source are needed only in the very rare case where a + period is the very first character in a line, without any + space in front of it. A better way to deal with that rare case + is for you to add a zero-width space in front of the offending + dot(s) in your source

                    +
                  • +

                    Removed special handling of the quote + element. That was hard-coded to cause anything marked up with + the quote element to be output preceded by two + backticks and followed by two apostrophes -- that is, that + old-school kludge for generating “curly” quotes in Emacs and + in X-Windows fonts. While Emacs still seems to support that, I + don't think X-Windows has for a long time now. And, anyway, it + looks (and has always looked) like crap when viewed on a + normal tty/console. In addition, it breaks localiztion of + quote. By default, quote content is + output with localized quotation marks, which, depending on the + locale, may or may not be left and right double quotation + marks.

                    +
                  • +

                    Changed mappings for left and right single quotation + marks. Those had previously been incorrectly mapped to the + backtick (&#96;) and apostrophe (&39;) characters (for + kludgy reasons -- see above). They are now correctly mapped to + the \(oq and \(cq roff + escapes. If you want the old (broken) behavior, you need to + manually change the mappings for those in the value of the + man.string.subst.map parameter.

                    +
                  • +

                    Removed xref.xsl file. Now, of the + various cross-reference elements, only the ulink + element is handled differently; the rest are handled exactly + as the HTML stylesheets handle them, except that no hypertext + links are generated. (Because there is no equivalent hypertext + mechanism is man pages.)

                    +
                  • +

                    New option for making “subheading dividers” in generated + roff source. The dividers are not visible in the rendered man + page; they are just there to make the source + readable. Controlled using + man.subheading.divider.

                    +
                  • +

                    Fixed many places where too much space was being added + between lines.

                    +
                  + +
                  +
                  + + +

                  Release 1.68.1

                  + +

                  The release adds localization support for Farsi (thanks to + Sina Heshmati) and improved support for the XLink-based DocBook NG + db:link element. Other than that, it is a minor + bug-fix update to the 1.68.0 release. The main thing it fixes is a + build error that caused the XSLT Java extensions to be jarred up + with the wrong package structure. Thanks to Jens Stavnstrup for + quickly reporting the problem, and to Mauritz Jeanson for + investigating and finding the cause.

                  +
                  + + +

                  Release 1.68.0

                  + +

                  This release includes some features changes, particularly + for FO/PDF output, and a number of bug fixes. +

                  FO

                  • +

                    Moved footnote properties to attribute-sets.

                    +
                  • +

                    Added support for side floats, margin notes, and + custom floats.

                    +
                  • +

                    Added new parameters + body.start.indent and + body.end.indent to the + set.flow.properties template.

                    +
                  • +

                    Added support for xml:id

                    +
                  • +

                    Added support for + refdescriptor.

                    +
                  • +

                    Added support for multiple refnamedivs.

                    +
                  • +

                    Added index.entry.properties + attribute-set to support customization of index + entries.

                    +
                  • +

                    Added set.flow.properties + template call to each fo:flow + to support customizations entry point.

                    +
                  • +

                    Add support for @floatstyle in + figure

                    +
                  • +

                    Moved hardcoded properties for index division titles + to the index.div.title.properties + attribute-set.

                    +
                  • +

                    Added support for + table-layout="auto" for XEP.

                    +
                  • +

                    Added index.div.title.properties + attribute-set.

                    +
                  • +

                    $verbose parameter is now + passed to most elements.

                    +
                  • +

                    Added refentry to + toc in part, as it is + permitted by the DocBook schema/DTD.

                    +
                  • +

                    Added backmatter elements and + article to toc in + part, since they are permitted by the + DocBook schema/DTD.

                    +
                  • +

                    Added mode="toc" for + simplesect, since it is now permitted in + the toc if + simplesect.in.toc is set.

                    +
                  • +

                    Moved hard-coded properties to + nongraphical.admonintion.properties + and graphical.admonition.properties + attribute sets.

                    +
                  • +

                    Added support for sidebar-width and + float-type processing instructions in + sidebar.

                    +
                  • +

                    For tables with HTML markup elements, added support + for dbfo bgcolor PI, the attribute-sets + named table.properties, + informaltable.properties, + table.table.properties, and + table.cell.padding. Also added + support for the templates named + table.cell.properties and + table.cell.block.properties so that + tabstyles can be implemented. Also added support for tables + containing only tr instead of + tbody with tr.

                    +
                  • +

                    Added new paramater + hyphenate.verbatim.characters which + can specify characters after which a line break can occur in + verbatim environments. This parameter can be used to extend + the initial set of characters which contain only space and + non-breakable space.

                    +
                  • +

                    Added itemizedlist.label.markup to enable + selection of different bullet symbol. Also added several + potential bullet characters, commented out by default.

                    +
                  • +

                    Enabled all id's in XEP output for external olinking.

                    +

                  + +

                  HTML

                  +

                  Images

                  • +

                    Added new SVG admonition graphics and navigation images.

                    +

                  +

                  +
                  + + +

                  Release 1.67.2

                  + +

                  This release fixes a table bug introduced in the 1.67.1 + release.

                  +
                  +

                  Release 1.67.1

                  + +

                  This release includes a number of bug fixes.

                  +

                  The following lists provide details about API and feature changes. +

                  FO

                  • +

                    Tables: Inherited cell properties are now passed to the + table.cell.properties template so they can + be overridden by a customization.

                    +
                  • +

                    Tables: Added support for bgcolor PI on table row + element.

                    +
                  • +

                    TOCs: Added new parameter + simplesect.in.toc; default value of + 0 causes simplesect to be omitted from TOCs; to + cause simplesect to be included in TOCs, you + must set the value of simplesect.in.toc to + 1.Comment from Norm: + +

                    +

                    Simplesect elements aren't supposed to + appear in the ToC at all... The use case for simplesect + is when, for example, every chapter in a book ends with + "Exercises" or "For More Information" sections and you + don't want those to appear in the ToC.

                    +

                    +

                    +
                  • +

                    Sections: Reverted change that caused a variable reference + to be used in a template match and rewrote code to preserve + intended semantics.

                    +
                  • +

                    Lists: Added workaround to prevent "* 0.60 + 1em" garbage in + list output from PassiveTeX

                    +
                  • +

                    Moved the literal attributes from + component.title to the + component.title.properties attribute-set so + they can be customized.

                    +
                  • +

                    Lists: Added glossdef's first + para to special handling in + fo:list-item-body.

                    +

                  + +

                  HTML

                  +

                  HTML Help

                  • +

                    Added support for generating windows-1252-encoded + output using Saxon; for more details, see the list of XSL Java extensions changes for this release.

                    +

                  +

                  man pages

                  • +

                    Replaced named/numeric character-entity references for + non-breaking space with groff equivalent (backslash-tilde).

                    +

                  +

                  XSL Java extensions

                  • +

                    Saxon extensions: Added the + Windows1252 class. It extends Saxon + 6.5.x with the windows-1252 character set, which is + particularly useful when generating HTML Help for Western + European Languages (code from + Pontus Haglund and contributed to the + DocBook community by Sectra AB, Sweden).

                    +

                    To use: +

                    1. +

                      Make sure that the Saxon 6.5.x jar file and the jar file for + the DocBook XSL Java extensions are in your CLASSPATH

                      +
                    2. +

                      Create a DocBook XSL customization layer -- a file named + mystylesheet.xsl or whatever -- that, at a + minimum, contains the following: + 

                        <xsl:stylesheet
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+    version='1.0'>
+    <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/>
+    <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/>
+    <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param>
+    <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param>
+    <xsl:param name="saxon.character.representation" select="'native'"></xsl:param>
+  </xsl:stylesheet>

                      +

                      +

                      Invoke Saxon with the + encoding.windows-1252 Java system property set + to com.nwalsh.saxon.Windows1252; for example + 

                        java \
+    -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
+  com.icl.saxon.StyleSheet \
+  mydoc.xml mystylesheet.xsl

                      + + Or, for a more complete "real world" case showing other + options you'll typically want to use: + 

                        java \
+    -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \
+    -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
+    -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \
+    -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \
+  com.icl.saxon.StyleSheet \
+    -x org.apache.xml.resolver.tools.ResolvingXMLReader \
+    -y org.apache.xml.resolver.tools.ResolvingXMLReader \
+    -r org.apache.xml.resolver.tools.CatalogResolver \
+  mydoc.xml mystylesheet.xsl

                      + + In both cases, the "mystylesheet.xsl" file should be a + DocBook customization layer containing the parameters + show in step 2.

                      +

                    +

                    +
                  • +

                    Saxon extensions: Removed Saxon 8 extensions from release package

                    +

                  +

                  +
                  +

                  Release 1.67.0

                  + +
                  • +

                    A number of important bug fixes.

                    +
                  • +

                    Added Saxon8 extensions

                    +
                  • +

                    Enabled dbfo table-width on + entrytbl in FO output

                    +
                  • +

                    Added support for role=strong on + emphasis in FO output

                    +
                  • +

                    Added new FO parameter + hyphenate.verbatim that can be used to turn + on "intelligent" wrapping of verbatim environments.

                    +
                  • +

                    Replaced all <tt></tt> output with + <code></code>

                    +
                  • +

                    Changed admon.graphic.width template to a + mode so that different admonitions can have different graphical + widths.

                    +
                  • +

                    Deprecated the HTML shade.verbatim + parameter (use CSS instead)

                    +
                  • +

                    Wrapped ToC + refentrytitle/refname and + refpurpose in span with class values. This + makes it possible to style them using a CSS stylesheet.

                    +
                  • +

                    Use strong/em instead of + b/i in HTML output

                    +
                  • +

                    Added support for converting Emphasis to + groff italic and Emphasis role='bold' to + bold. Controlled by + emphasis.propagates.style param, but not + documented yet using litprog system. Will do that next (planning + to add some other parameter-controllable options for hyphenation + and handling of line spacing).

                    +
                  • +

                    callout.graphics.number.limit.xml + param: Changed the default from 10 to + 15.

                    +
                  • +

                    verbatim.properties: Added + hyphenate=false

                    +
                  • +

                    Saxon and Xalan Text.java extensions: Added support for + URIResolver() on insertfile href's

                    +
                  • +

                    Added generated RELEASE-NOTES.txt + file.

                    +
                  • +

                    Added INSTALL file (executable file for + generating catalog.xml)

                    +
                  • +

                    Removed obsolete tools directory from + package

                    +
                  +
                  +

                  Release 1.66.1

                  + +
                  • +

                    A number of important bug fixes. +

                    +
                  • +

                    +Now xml:base attributes that are generated by an +XInclude processor are resolved for image files. +

                    +
                  • +

                    +Rewrote olink templates to support several new features. +

                    +
                    +
                  • +

                    +Added index.on.type parameter for new type +attribute introduced in DocBook 4.3 for indexterms and index. +This allows you to create multiple indices containing +different categories of entries. +For users of 4.2 and earlier, you can use the new parameter index.on.role +instead. +

                    +
                  • +

                    +Added new +section.autolabel.max.depth parameter to turn off section numbering +below a certain depth. +This permits you to number major section levels and leave minor +section levels unnumbered.

                    +
                  • +

                    +Added footnote.sep.leader.properties attribute set to format +the line separating footnotes in printed output. +

                    +
                  • +

                    +Added parameter img.src.path as a prefix to HTML img src +attributes. +The prefix is added to whatever path is already generated by the +stylesheet for each image file.

                    +
                  • +

                    +Added new attribute-sets +informalequation.properties, +informalexample.properties, +informalfigure.properties, and informaltable.properties, +so each such element type can be formatted +individually if needed. +

                    +
                  • +

                    +Add component.label.includes.part.label +parameter to add any part number to chapter, appendix +and other component labels when +the label.from.part parameter is nonzero. +This permits you to distinguish multiple chapters with the same +chapter number in cross references and the TOC.

                    +
                  • +

                    +Added chunk.separate.lots parameter for HTML output. +This parameter lets you generate separate chunk files for each LOT +(list of tables, list of figures, etc.).

                    +
                  • +

                    Added several table features:

                    +
                    • +

                      +Added table.table.properties attribute set to add +properties to the fo:table element. +

                      +
                    • +

                      +Added placeholder templates named table.cell.properties +and table.cell.block.properties to enable adding properties +to any fo:table-cell or the cell's fo:block, respectively. + These templates are a start for implementing table styles.

                      +
                    +
                  • +

                    +Added new attribute +set component.title.properties for easy modifications of +component's title formatting in FO output. +

                    +
                  • +

                    +Added Saxon support for an encoding attribute on the textdata element. Added new parameter +textdata.default.encoding which specifies encoding when +encoding attribute on +textdata is missing. +

                    +
                  • +

                    +Template label.this.section now controls whole +section label, not only sub-label which corresponds to +particular label. Former behaviour was IMHO bug as it was +not usable. +

                    +
                  • +

                    +Formatting in titleabbrev for TOC and headers +is preserved when there are no hotlink elements in the title. Formerly the title showed only the text of the title, no font changes or other markup. +

                    +
                  • +

                    +Added intial.page.number template to set the initial-page-number +property for page sequences in print output. +Customizing this template lets you change when page numbering restarts. This is similar to the format.page.number template that lets you change how the page number formatting changes in the output. +

                    +
                  • +

                    +Added force.page.count template to set the force-page-count +property for page sequences in print output. +This is similar to the format.page.number template. +

                    +
                  • +

                    +Sort language for localized index sorting in autoidx-ng.xsl is now taken from document +lang, not from system environment. +

                    +
                  • +

                    +Numbering and formatting of normal +and ulink footnotes (if turned on) has been unified. +Now ulink footnotes are mixed in with any other footnotes.

                    +
                  • +

                    +Added support for renderas attribute in section and +sect1 et al. +This permits you to render a given section title as if it were a different level.

                    +
                  • +

                    +Added support for label attribute in footnote to manually +supply the footnote mark. +

                    +
                  • +

                    +Added support for DocBook 4.3 corpcredit element. +

                    +
                  • +

                    +Added support for a dbfo keep-together PI for +formal objects (table, figure, example, equation, programlisting). That permits a formal object to be kept together if it is not already, or to be broken if it +is very long and the +default keep-together is not appropriate. +

                    +
                  • +

                    +For graphics files, made file extension matching case +insensitive, and updated the list of graphics extensions. +

                    +
                  • +

                    +Allow calloutlist to have block content before +the first callout +

                    +
                  • +

                    +Added dbfo-need processing instruction to provide +soft page breaks. +

                    +
                  • +

                    +Added implementation of existing but unused +default.image.width parameter for graphics. +

                    +
                  • +

                    +Support DocBook NG tag inline element. +

                    +
                  • +

                    +It appears that XEP now supports Unicode characters in +bookmarks. There is no further need to strip accents from +characters. +

                    +
                  • +

                    +Make segmentedlist HTML markup +more semantic and available to CSS styles. +

                    +
                  • +

                    +Added user.preroot placeholder template to +permit xsl-stylesheet and other PIs and comments to be +output before the HTML root element. +

                    +
                  • +

                    +Non-chunked legalnotice now gets an <a +name="id"> element in HTML output +so it can be referenced with xref or link. +

                    +
                  • +

                    +In chunked HTML output, changed link rel="home" to rel="start", +and link rel="previous" to rel="prev", per W3C HTML 4.01 +spec. +

                    +
                  • +

                    +Added several patches to htmlhelp from W. Borgert +

                    +
                  • +

                    +Added Bosnian locale file as common/bs.xml. +

                    +
                  +
                  +

                  Release 1.65.0

                  + +
                  • +

                    A number of important bug fixes. +

                    +
                  • +

                    Added a workaround to allow these stylesheets to process DocBook NG +documents. (It’s a hack that pre-processes the document to strip off the +namespace and then uses exsl:node-set to process +the result.) +

                    +
                  • +

                    Added alternative indexing mechanism which has better +internationalization support. New indexing method allows grouping of +accented letters like e, é, ë into the same group under letter "e". It +can also treat special letters (e.g. "ch") as one character and place +them in the correct position (e.g. between "h" and "i" in Czech +language).

                    +

                    In order to use this mechanism you must create customization +layer which imports some base stylesheet (like +fo/docbook.xsl, +html/chunk.xsl) and then includes appropriate +stylesheet with new indexing code +(fo/autoidx-ng.xsl or +html/autoidx-ng.xsl). For example:

                    +
                    <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                version="1.0">
+
+<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
+<xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/>
+
+</xsl:stylesheet>
                    +

                    New method is known to work with Saxon and it should also work +with xsltproc 1.1.1 and later. Currently supported languages are +English, Czech, German, French, Spanish and Danish.

                    +
                  +
                  +

                  Release 1.64.1

                  + +

                  General bug fixes and improvements. Sorry about the failure to produce +an updated release notes file for 1.62.0—1.63.2

                  • +

                    In the course of fixing bug #849787, wrapping Unicode callouts +with an appropriate font change in the Xalan extensions, I discovered +that the Xalan APIs have changed a bit. So xalan2.jar +will work with older Xalan 2 implementations, xalan25.jar +works with Xalan 2.5.

                    +
                  +
                  +

                  Release 1.61.0

                  + +

                  Lots of bug fixes and improvements.

                  • +

                    Initial support for timestamp PI. From now you + can use <?dbtimestamp format="Y-m-d H:M:S"?> to get current + datetime in your document. Added localization support for datetime PI +

                    +
                  • +

                    Added level 6 to test for section depth in +section.level template so that +section.title.level6.properties will be used for sections +that are 6 deep or deeper. This should also cause a h6 to be +created in html output. +

                    +
                  • +

                    Don't use SVG graphics if use.svg=0 +

                    +
                  • +

                    Now uses number-and-title-template for sections + only if section.autolabel is not zero. +

                    +
                  • +

                    Added missing 'english-language-name' attribute to +the l10n element, and the missing 'style' attribute to the +template element so the current gentext documents will +validate. +

                    +
                  • +

                    Corrected several references to parameter + qanda.defaultlabel that were missing the "$". +

                    +
                  • +

                    Now accepts admon.textlabel parameter to turn off + Note, Warning, etc. label. +

                    +
                  • +

                    FeatReq #684561: support more XEP metadata +

                    +
                  • +

                    Added hyphenation support. Added support for coref. +Added beginpage support. (does nothing; see TDG). +

                    +
                  • +

                    Added support for +hyphenation-character, hyphenation-push-character-count, and +hyphenation-remain-character-count +

                    +
                  • +

                    Added root.properties, +ebnf.assignment, +and ebnf.statement.terminator +

                    +
                  • +

                    Support bgcolor PI in table cells; make sure +rowsep and colsep don't have any effect on the last row or +column +

                    +
                  • +

                    Handle othercredit on titlepage a little +better +

                    +
                  • +

                    Applied fix from Jeff Beal that fixed the bug +that put secondary page numbers on primary entries. Same +with tertiary page numbers on secondary entries. +

                    +
                  • +

                    Added definition of missing variable +collection. +

                    +
                  • +

                    Make footnote formatting 'normal' even when it +occurs in a context that has special formatting +

                    +
                  • +

                    Added warning when glossary.collection is not +blank, but it cannot open the specified file. +

                    +
                  • +

                    Pick up the frame attribute on table and +informaltable. +

                    +
                  • +

                    indexdiv/title +in non-autogenerated indexes are +now picked up. +

                    +
                  • +

                    Removed (unused) +component.title.properties +

                    +
                  • +

                    Move IDs from +page-sequences down to titlepage blocks +

                    +
                  • +

                    Use +proportional-column-width(1) on more tables. +

                    +

                    Use proportional-column-width() for +header/footer tables; suppress relative-align when when +using FOP +

                    +
                  • +

                    Check for glossterm.auto.link when linking +firstterms; don't output gl. prefix on glossterm links +

                    +
                  • +

                    Generate Part ToCs +

                    +
                  • +

                    Support glossary, bibliography, +and index in component ToCs. +

                    +
                  • +

                    Refactored chunking code so that +customization of chunk algorithm and chunk elements is more +practical +

                    +
                  • +

                    Support textobject/phrase +on inlinemediaobject. +

                    +
                  • +

                    Support 'start' PI on ordered lists +

                    +
                  • +

                    Fixed test of $toc PI to turn on qandaset TOC. +

                    +
                  • +

                    Added process.chunk.footnotes to sect2 through +5 to fix bug of missing footnotes when chunk level greater +than 1. +

                    +
                  • +

                    Added +paramater toc.max.depth which controls maximal depth of ToC +as requested by PHP-DOC group. +

                    +
                  • +

                    Exempted titleabbrev from preamble processing in +lists, and fixed variablelist preamble code to use the same +syntax as the other lists. +

                    +
                  • +

                    Added support for elements between variablelist +and first varlistentry since DocBook 4.2 supports that now. +

                    +
                  +
                  +

                  Release 1.60.1

                  + +

                  Lots of bug fixes.

                  • +

                    The format of the titlepage.templates.xml files and +the stylesheet that transforms them have been significantly changed. All of the +attributes used to control the templates are now namespace qualified. So what +used to be:

                    +
                    <t:titlepage element="article" wrapper="fo:block">
                    +

                    is now:

                    +
                    <t:titlepage t:element="article" t:wrapper="fo:block">
                    +

                    Attributes from other namespaces (including those that are unqualified) are +now copied directly through. In practice, this means that the names that used +to be “fo:” qualified:

                    +
                    <title named-template="component.title"
+       param:node="ancestor-or-self::article[1]"
+       fo:text-align="center"
+       fo:keep-with-next="always"
+       fo:font-size="&hsize5;"
+       fo:font-weight="bold"
+       fo:font-family="{$title.font.family}"/>
                    +

                    are now unqualified:

                    +
                    <title t:named-template="component.title"
+       param:node="ancestor-or-self::article[1]"
+       text-align="center"
+       keep-with-next="always"
+       font-size="&hsize5;"
+       font-weight="bold"
+       font-family="{$title.font.family}"/>
                    +

                    The t:titlepage and t:titlepage-content +elements both generate wrappers now. And unqualified attributes on those elements +are passed through. This means that you can now make the title font apply to +ane entire titlepage and make the entire “recto” +titlepage centered by specifying the font and alignment on the those elements:

                    +
                    <t:titlepage t:element="article" t:wrapper="fo:block"
+             font-family="{$title.font.family}">
+
+  <t:titlepage-content t:side="recto"
+             text-align="center">
                    + + + + + +
                  • +

                    Support use of titleabbrev in running +headers and footers. +

                    +
                  • +

                    Added (experimental) xref.with.number.and.title +parameter to enable number/title cross references even when the +default would +be just the number. +

                    +
                  • +

                    Generate part ToCs if they're requested. +

                    +
                  • +

                    Use proportional-column-width() in header/footer tables. +

                    +
                  • +

                    Handle alignment correctly when screenshot +wraps a graphic in a figure. +

                    +
                  • +

                    Format chapter and appendix +cross references consistently. +

                    +
                  • +

                    Attempt to support tables with multiple tgroups +in FO. +

                    +
                  • +

                    Output fo:table-columns in +simplelist tables. +

                    +
                  • +

                    Use titlepage.templates.xml for +indexdiv and glossdiv formatting. +

                    +
                  • +

                    Improve support for new bibliography elements. +

                    +
                  • +

                    Added +footnote.number.format, +table.footnote.number.format, +footnote.number.symbols, and +table.footnote.number.symbols for better control of +footnote markers. +

                    +
                  • +

                    Added glossentry.show.acronyms. +

                    +
                  • +

                    Suppress the draft-mode page masters when +draft-mode is “no”. +

                    +
                  • +

                    Make blank pages verso not recto. D'Oh! +

                    +
                  • +

                    Improved formatting of ulink footnotes. +

                    +
                  • +

                    Fixed bugs in graphic width/height calculations. +

                    +
                  • +

                    Added class attributes to inline elements. +

                    +
                  • +

                    Don't add “.html” to the filenames identified +with the “dbhtml” PI. +

                    +
                  • +

                    Don't force a ToC when sections contain refentrys. +

                    +
                  • +

                    Make section title sizes a function of the +body.master.size. +

                    +
                  +
                  +

                  Release 1.59.2

                  + +

                  The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail. +

                  • +

                    Removed the region-name from the region-body of blank pages. There's +no reason to give the body of blank pages a unique name and doing so causes +a mismatch that FOP detects. +

                    +
                  • +

                    Output IDs for the first paragraphs in listitems. +

                    +
                  • +

                    Fixed some small bugs in the handling of page numbers in double-sided mode. +

                    +
                  • +

                    Attempt to prevent duplicated IDs from being produced when +endterm on xref points +to something with nested structure. +

                    +
                  • +

                    Fix aligment problems in equations. +

                    +
                  • +

                    Output the type attribute on unordered lists (UL) in HTML only if +the css.decoration parameter is true. +

                    +
                  • +

                    Calculate the font size in formal.title.properties so that it's 1.2 times +the base font size, not a fixed "12pt". +

                    +
                  +
                  +

                  Release 1.59.1

                  + +

                  The 1.59.1 fixes a few bugs. +

                  • +

                    Added Bulgarian localization. +

                    +
                  • +

                    Indexing improvements; localize book indexes to books but allow setindex +to index an entire set. +

                    +
                  • +

                    The default value for rowsep and colsep is now "1" as per CALS. +

                    +
                  • +

                    Added support for titleabbrev (use them for cross +references). +

                    +
                  • +

                    Improvements to mediaobject for selecting print vs. online +images. +

                    +
                  • +

                    Added seperate property sets for figures, +examples, equations, tabless, +and procedures. +

                    +
                  • +

                    Make lineannotations italic. +

                    +
                  • +

                    Support xrefstyle attribute. +

                    +
                  • +

                    Make endterm on +xref higher priority than +xreflabel target. +

                    +
                  • +

                    Glossary formatting improvements. +

                    +
                  +
                  +

                  Release 1.58.0

                  + +

                  The 1.58.0 adds some initial support for extensions in xsltproc, adds +a few features, and fixes bugs. +

                  • +

                    This release contains the first attempt at extension support for xsltproc. +The only extension available to date is the one that adjusts table column widths. +Run extensions/xsltproc/python/xslt.py. +

                    +
                  • +

                    Fixed bugs in calculation of adjusted column widths to correct for rounding +errors. +

                    +
                  • +

                    Support nested refsection elements correctly. +

                    +
                  • +

                    Reworked gentext.template to take context into consideration. +The name of elements in localization files is now an xpath-like context list, not +just a simple name. +

                    +
                  • +

                    Made some improvements to bibliography formatting. +

                    +
                  • +

                    Improved graphical formatting of admonitions. +

                    +
                  • +

                    Added support for entrytbl. +

                    +
                  • +

                    Support spanning index terms. +

                    +
                  • +

                    Support bibliosource. +

                    +
                  +
                  +

                  Release 1.57.0

                  + +
                  • +

                    The 1.57.0 release wasn't documented here. Oops. +

                    +
                  +
                  +

                  Release 1.56.0

                  + +

                  The 1.56.0 release fixes bugs. +

                  • +

                    Reworked chunking. This will break all existing customizations +layers that change the chunking algorithm. If you're customizing chunking, +look at the new “content” parameter that's passed to +process-chunk-element and friends. +

                    +
                  • +

                    Support continued and inherited numeration in orderedlist +formatting for FOs. +

                    +
                  • +

                    Added Thai localization. +

                    +
                  • +

                    Tweaked stylesheet documentation stylesheets to link to TDG and +the parameter references. +

                    +
                  • +

                    Allow title on tables of contents ("Table of Contents") to be optional. +Added new keyword to generate.toc. +Support tables of contents on sections. +

                    +
                  • +

                    Made separate parameters for table borders and table cell borders: +table.frame.border.color, +table.frame.border.style, +table.frame.border.thickness, +table.cell.border.color, +table.cell.border.style, and +table.cell.border.thickness. +

                    +
                  • +

                    Suppress formatting of “endofrange” indexterms. +This is only half-right. They should generate a range, but I haven't figured out how +to do that yet. +

                    +
                  • +

                    Support revdescription. (Bug #582192) +

                    +
                  • +

                    Added default.float.class and fixed figure +floats. (Bug #497603) +

                    +
                  • +

                    Fixed formatting of sbr in FOs. +

                    +
                  • +

                    Added context to the “missing template” error message. +

                    +
                  • +

                    Process arg correctly in a group. +(Bug #605150) +

                    +
                  • +

                    Removed 'keep-with-next' from formal.title.properties +attribute set now that the stylesheets support the option of putting +such titles below the object. Now the $placement value determines if +'keep-with-next' or 'keep-with-previous' is used in the title block. +

                    +
                  • +

                    Wrap “url()” around external-destinations when appropriate. +

                    +
                  • +

                    Fixed typo in compact list spacing. (Bug #615464) +

                    +
                  • +

                    Removed spurious hash in anchor name. (Bug #617717) +

                    +
                  • +

                    Address is now displayed verbatim on title pages. (Bug #618600) +

                    +
                  • +

                    The bridgehead.in.toc parameter is now properly +supported. +

                    +
                  • +

                    Improved effectiveness of HTML cleanup by increasing the number +of places where it is used. Improve use of HTML cleanup in XHTML stylesheets. +

                    +
                  • +

                    Support table of contents for appendix in +article. (Bug #596599) +

                    +
                  • +

                    Don't duplicate footnotes in bibliographys and +glossarys. (Bug #583282) +

                    +
                  • +

                    Added default.image.width. (Bug #516859) +

                    +
                  • +

                    Totally reworked funcsynopsis code; it now +supports a 'tabular' presentation style for 'wide' prototypes; see +funcsynopsis.tabular.threshold. (HTML only +right now, I think, FO support, uh, real soon now.) +

                    +
                  • +

                    Reworked support for difference marking; toned down the colors a bit +and added a “system.head.content” template so that the diff CSS +wasn't overriding “user.head.content”. (Bug #610660) +

                    +
                  • +

                    Added call to the “*.head.content” elements when writing +out long description chunks. +

                    +
                  • +

                    Make sure legalnotice link is correct even when +chunking to a different base.dir. +

                    +
                  • +

                    Use CSS to set viewport characteristics if +css.decoration is non-zero, use div instead of p for making +graphic a block element; make figure titles the +default alt +text for images in a figure.

                    +
                  • +

                    Added space-after to list.block.spacing. +

                    +
                  • +

                    Reworked section.level template to give “correct” answer +instead of being off by one. +

                    +
                  • +

                    When processing tables, use the tabstyle +attribute as the division class. +

                    +
                  • +

                    Fixed bug in html2xhtml.xsl that was causing the +XHTML chunker to output HTML instead of XHTML. +

                    +
                  +
                  +

                  Older releases

                  + +

                  To view the release notes for older releases, see http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml. Be + aware that there were no release notes for releases prior to the + 1.50.0 release.

                  +
                  +

                  About dot-zero releases

                  + +

                  DocBook Project “dot zero” releases should be + considered experimental and are always + followed by stable “dot one” releases, usually within + two or three weeks. Please help to ensure the stability of + “dot one” releases by carefully testing each + “dot zero” release and reporting back about any + problems you find.

                  +

                  It is not recommended that you use a “dot zero” + release in a production system, or package it for an OS + distro. Instead, you should wait for the “dot one” + version.

                  +
                  +
                  \ No newline at end of file diff --git a/src/documentation/docbook-xsl/RELEASE-NOTES.pdf b/src/documentation/docbook-xsl/RELEASE-NOTES.pdf new file mode 100644 index 0000000000..08a10fb8cb Binary files /dev/null and b/src/documentation/docbook-xsl/RELEASE-NOTES.pdf differ diff --git a/src/documentation/docbook-xsl/RELEASE-NOTES.txt b/src/documentation/docbook-xsl/RELEASE-NOTES.txt new file mode 100644 index 0000000000..6b60df99e1 --- /dev/null +++ b/src/documentation/docbook-xsl/RELEASE-NOTES.txt @@ -0,0 +1,3073 @@ +Release Notes + +DocBook Project XSL Stylesheets + +$Revision: 1.51 $ $Date: 2006/05/24 14:39:48 $ + +2006-05-26 + +------------------------------------------------------------------------------ + +Table of Contents + +Release: 1.70.1 + + FO + HTML + HTMLHelp + Params + +Release: 1.70.0 + + Common + Extensions + FO + HTML + Manpages + Params + Profiling + Tools + WordML + +Release 1.69.1 +Release 1.69.0 + + Common + FO + Help + HTML + man + +Release 1.68.1 +Release 1.68.0 +Release 1.67.2 +Release 1.67.1 +Release 1.67.0 +Release 1.66.1 +Release 1.65.0 +Release 1.64.1 +Release 1.61.0 +Release 1.60.1 +Release 1.59.2 +Release 1.59.1 +Release 1.58.0 +Release 1.57.0 +Release 1.56.0 +Older releases +About dot-zero releases + +These are the release notes for the DocBook XSL Stylesheets distribution. This +document lists enhancements and changes to the public APIs (user-configurable +parameters) and generally excludes descriptions of bug fixes, which are +instead documented in a separate NEWS file. + +Release: 1.70.1 + +This is a stable release of the 1.70 stylesheets. It includes only a few small +changes from 1.70.0. + +The following is a list of changes that have been made since the 1.70.0 +release. + +FO + +The following changes have been made to the fo code since the 1.70.0 release. + + * Added three new attribute sets (revhistory.title.properties, + revhistory.table.properties and revhistory.table.cell.properties) for + controlling appearance of revhistory in FO output. + + Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; + fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; + params/revhistory.table.properties.xml,1.1; + params/revhistory.title.properties.xml,1.1 - Jirka Kosek + + * Support DBv5 revisions with full author name (not only authorinitials) + + Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek + +HTML + +The following changes have been made to the html code since the 1.70.0 +release. + + * Support DBv5 revisions with full author name (not only authorinitials) + + Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek + +HTMLHelp + +The following changes have been made to the htmlhelp code since the 1.70.0 +release. + + * htmlhelp.generate.index is now param, not variable. This means that you + can override its setting from outside. This is useful when you generate + indexterms on the fly (see + http://www.xml.com/pub/a/2004/07/14/dbndx.html?page=3). + + Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek + + * Support chunk.tocs.and.lots in HTML Help + + Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek + +Params + +The following changes have been made to the params code since the 1.70.0 +release. + + * Added three new attribute sets (revhistory.title.properties, + revhistory.table.properties and revhistory.table.cell.properties) for + controlling appearance of revhistory in FO output. + + Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; + fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; + params/revhistory.table.properties.xml,1.1; + params/revhistory.title.properties.xml,1.1 - Jirka Kosek + +Release: 1.70.0 + +As with all DocBook Project dot-zero releases, this is an experimental +release. It will be followed shortly by a stable release. + +This release adds a number of new features, including: + + * support for selecting alternative index-collation methods (in particular, + support for using a collation library developed by Eliot Kimber) + + * improved handling of DocBook 5 document instances (through a + namespace-stripping mechanism) + + * full support for CALS and HTML tables in manpages output + + * a mechanism for preserving relative URIs in documents that make use of + XInclude + + * support for the "new" .90 version of FOP + + * enhanced capabilities for controlling formatting of lists in HTML and FO + output + + * autogeneration of AUTHOR and COPYRIGHT sections in manpages output + + * support for generating crop marks in FO/PDF output + + * support for qandaset as a root element in FO output + + * support for floatstyle and orient on all table types + + * support for floatstyle in figure, and example + + * pgwide.properties attribute-set supports extending figure, example and + table into the left indent area instead of spanning multiple columns. + +The following is a detailed list of enhancements and API changes that have +been made since the 1.69.1 release. + +Common + +The following changes have been made to the common code since the 1.69.1 +release. + + * Add the xsl:key for the kimber indexing method. + + Modified: common/autoidx-ng.xsl,1.2 - Robert Stayton + + * Add support for qandaset. + + Modified: common/labels.xsl,1.37; common/subtitles.xsl,1.7; + common/titles.xsl,1.35 - Robert Stayton + + * Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO + + Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh + + * Added CVS header. + + Modified: common/stripns.xsl,1.12 - Robert Stayton + + * Changed content model of text element to ANY rather than #PCDATA because + they could contain markup. + + Modified: common/targetdatabase.dtd,1.7 - Robert Stayton + + * Added refentry.meta.get.quietly param. + + If zero (the default), notes and warnings about "missing" markup are + generated during gathering of refentry metadata. If non-zero, the metadata + is gathered "quietly" -- that is, the notes and warnings are suppressed. + + NOTE: If you are processing a large amount of refentry content, you may be + able to speed up processing significantly by setting a non-zero value for + refentry.meta.get.quietly. + + Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; + manpages/param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - + Michael(tm) Smith + + * After namespace stripping, the source document is the temporary tree + created by the stripping process and it has the wrong base URI for + relative references. Earlier versions of this code used to try to fix that + by patching the elements with relative @fileref attributes. That was + inadequate because it calculated an absolute base URI without considering + that there might be xml:base attributes already in effect. It seems + obvious now that the right thing to do is simply to put the xml:base on + the root of the document. And that seems to work. + + Modified: common/stripns.xsl,1.7 - Norman Walsh + + * Added support for "software" and "sectdesc" class values on refmiscinfo; + "software" is treated identically to "source", and "setdesc" is treated + identically to "manual". + + Modified: common/refentry.xsl,1.10; + params/man.th.extra2.max.length.xml,1.3; + params/refentry.source.name.profile.xml,1.4 - Michael(tm) Smith + + * Added support for DocBook 5 namespace-stripping in manpages stylesheet. + Closes request #1210692. + + Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm) + Smith + + * Added to make stripns.xsl usable as a standalone + stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that DocBook + XSLT drivers that include this stylesheet all override the match="/" + template. + + Modified: common/stripns.xsl,1.4 - Michael(tm) Smith + + * Number figures, examples, and tables from book if there is no prefix (i.e. + if chapter.autolabel is set to 0). This avoids having the list of figures + where the figures mysteriously restart their numeration periodically when + chapter.autolabel is set to 0. + + Modified: common/labels.xsl,1.36 - David Cramer + + * Add task template in title.markup mode. + + Modified: common/titles.xsl,1.34 - Robert Stayton + + * Add children (with ids) of formal objects to target data. + + Modified: common/targets.xsl,1.10 - Robert Stayton + + * Added support for case when personname doesn't contain specific name + markup (as allowed in DocBook 5.0) + + Modified: common/common.xsl,1.54 - Jirka Kosek + +Extensions + +The following changes have been made to the extensions code since the 1.69.1 +release. + + * Support Xalan 2.7 + + Modified: extensions/xalan27/.cvsignore,1.1; + extensions/xalan27/build.xml,1.1; + extensions/xalan27/nbproject/.cvsignore,1.1; + extensions/xalan27/nbproject/build-impl.xml,1.1; + extensions/xalan27/nbproject/genfiles.properties,1.1; + extensions/xalan27/nbproject/project.properties,1.1; + extensions/xalan27/nbproject/project.xml,1.1; + extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/Callout.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/Func.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/Params.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1; + extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman Walsh + + * Handle the case where the imageFn is actually a URI. This still needs + work. + + Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4 - + Norman Walsh + +FO + +The following changes have been made to the fo code since the 1.69.1 release. + + * Adapted to the new indexing code. Now works just like a wrapper that calls + kosek indexing method, originally implemented here. + + Modified: fo/autoidx-ng.xsl,1.5 - Jirka Kosek + + * Added parameters for header/footer table minimum height. + + Modified: fo/pagesetup.xsl,1.60; fo/param.ent,1.100; fo/param.xweb,1.113 - + Robert Stayton + + * Add the index.method parameter. + + Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert Stayton + + * Integrate support for three indexing methods: - the original English-only + method. - Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's + method using Saxon extensions. Use the 'index.method' parameter to select. + + Modified: fo/autoidx.xsl,1.38 - Robert Stayton + + * Add support for TOC for qandaset in fo output. + + Modified: fo/autotoc.xsl,1.30; fo/qandaset.xsl,1.20 - Robert Stayton + + * Added parameter ulink.hyphenate.chars. Added parameter insert.link + .page.number. + + Modified: fo/param.ent,1.98; fo/param.xweb,1.111 - Robert Stayton + + * Implemented feature request #942524 to add insert.link.page.number to + allow link element cross references to have a page number. + + Modified: fo/xref.xsl,1.67 - Robert Stayton + + * Add support for ulink.hyphenate.chars so more characters can be break + points in urls. + + Modified: fo/xref.xsl,1.66 - Robert Stayton + + * Implemented patch #1075144 to make the url text in a ulink in FO output an + active link as well. + + Modified: fo/xref.xsl,1.65 - Robert Stayton + + * table footnotes now have their own table.footnote.properties attribute + set. + + Modified: fo/footnote.xsl,1.23 - Robert Stayton + + * Add qandaset to root.elements. + + Modified: fo/docbook.xsl,1.41 - Robert Stayton + + * Added mode="page.sequence" to make it easier to put content into a page + sequence. First used for qandaset. + + Modified: fo/component.xsl,1.37 - Robert Stayton + + * Implemented feature request #1434408 to support formatting of biblioentry. + + Modified: fo/biblio.xsl,1.35 - Robert Stayton + + * Added biblioentry.properties. + + Modified: fo/param.ent,1.97; fo/param.xweb,1.110 - Robert Stayton + + * Support PTC/Arbortext bookmarks + + Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman Walsh + + * Added table.footnote.properties to permit table footnotes to format + differently from regular footnotes. + + Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert Stayton + + * Refactored table templates to unify their processing and support all + options in all types. Now table and informaltable, in both Cals and Html + markup, use the same templates where possible, and all support pgwide, + rotation, and floats. There is also a placeholder table.container template + to support wrapping a table in a layout table, so the XEP table title + "continued" extension can be more easily implemented. + + Modified: fo/formal.xsl,1.52; fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 - + Robert Stayton + + * Added new attribute set toc.line.properties for controlling appearance of + lines in ToC/LoT + + Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95; fo/param.xweb,1.108 - + Jirka Kosek + + * Added support for float to example and equation. Added support for pgwide + to figure, example, and equation (the latter two via a dbfo pgwide="1" + processing instruction). + + Modified: fo/formal.xsl,1.51 - Robert Stayton + + * Add pgwide.properties attribute-set. + + Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert Stayton + + * Added refclass.suppress param. + + If the value of refclass.suppress is non-zero, then display refclass + contents is suppressed in output. Affects HTML and FO output only. + + Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; + html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith + + * Improved support for task subelements + + Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek + + * Adjusted spacing around K&R-formatted Funcdef and Paramdef output such + that it can more easily be discerned where one ends and the other begins. + Closes #1213264. + + Modified: fo/synop.xsl,1.18 - Michael(tm) Smith + + * Made handling of paramdef/parameter in FO output consistent with that in + HTML and manpages output. Closes #1213259. + + Modified: fo/synop.xsl,1.17 - Michael(tm) Smith + + * Made handling of Refnamediv consistent with formatting in HTML and + manpages output; specifically, changed so that Refname (comma-separated + list of multiple instances found) is used (instead of Refentrytitle as + previously), then em-dash, then the Refpurpose. Closes #1212562. + + Modified: fo/refentry.xsl,1.30 - Michael(tm) Smith + + * Added output of Releaseinfo to recto titlepage ("copyright" page) for Book + in FO output. This makes it consistent with HTML output. Closes #1327034. + Thanks to Paul DuBois for reporting. + + Modified: fo/titlepage.templates.xml,1.28 - Michael(tm) Smith + + * Added condition for setting block-progression-dimension.minimum on + table-row, instead of height, when fop1.extensions is non-zero. For an + explanation of the reason for the change, see: + http://wiki.apache.org/xmlgraphics-fop/Troubleshooting/CommonLogMessages + + Modified: fo/pagesetup.xsl,1.59 - Michael(tm) Smith + + * Added new refclass.suppress param for suppressing display of Refclass in + HTML and FO output. Did not add it to manpages because manpages stylesheet + is currently just silently ignoring Refclass anyway. Closes request + #1461065. Thanks to Davor Ocelic (docelic) for reporting. + + Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith + + * Add support for keep-together PI to informal objects. + + Modified: fo/formal.xsl,1.50 - Robert Stayton + + * Add support for fop1.extensions. + + Modified: fo/formal.xsl,1.49; fo/graphics.xsl,1.44; fo/table.xsl,1.47 - + Robert Stayton + + * Add support for fop1 bookmarks. + + Modified: fo/docbook.xsl,1.39 - Robert Stayton + + * Add fop1.extentions parameter to add support for fop development version. + + Modified: fo/param.ent,1.92; fo/param.xweb,1.105 - Robert Stayton + + * Start supporting fop development version, which will become fop version 1. + + Modified: fo/fop1.xsl,1.1 - Robert Stayton + + * Add template for task in mode="xref-to". + + Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton + + * table footnotes now also get footnote.properties attribute-set. + + Modified: fo/footnote.xsl,1.22 - Robert Stayton + + * Added index.separator named template to compute the separator punctuation + based on locale. + + Modified: fo/autoidx.xsl,1.36 - Robert Stayton + + * Added support for link, olink, and xref within OO Classsynopsis and + children. (Because DocBook NG/5 allows it). + + Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith + + * Support date as an inline + + Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh + + * Added new parameter keep.relative.image.uris + + Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; + html/param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman + Walsh + + * Map Unicode space characters U+2000-U+200A to fo:leaders. + + Modified: fo/docbook.xsl,1.38; fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 - + Jirka Kosek + + * Output a real em dash for em-dash dingbat (instead of two hypens). + + Modified: fo/fo.xsl,1.7 - Michael(tm) Smith + + * Support default label width parameters for itemized and ordered lists + + Modified: fo/lists.xsl,1.64; fo/param.ent,1.90; fo/param.xweb,1.103; + params/itemizedlist.label.width.xml,1.1; + params/orderedlist.label.width.xml,1.1 - Norman Walsh + + * Generate localized title for Refsynopsisdiv if no appropriate Title + descendant found in source. Closes #1212398. This change makes behavior + for the Synopsis title consistent with the behavior of HTML and manpages + output. + + Also, added xsl:use-attribute-sets="normal.para.spacing" to block + generated for Cmdsynopsis output. Previously, that block had no spacing at + all specified, which resulted it being crammed up to closely to the + Synopsis head. + + Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm) Smith + + * Added parameters to support localization of index item punctuation. + + Modified: fo/autoidx.xsl,1.35 - Robert Stayton + + * Added index.number.separator, index.range.separator, and + index.term.separator parameters to support localization of punctuation in + index entries. + + Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert Stayton + + * Added "Cross References" section in HTML doc (for consistency with the FO + doc). Also, moved the existing FO "Cross References" section to follow the + "Linking" section. + + Modified: fo/param.xweb,1.101; html/param.xweb,1.95 - Michael(tm) Smith + + * Added ID attribues to all Reference elements (e.g., id="tables" for the + doc for section on Table params). So pages for all subsections of ref docs + now have stable filenames instead of arbitrary generated filenames. + + Modified: fo/param.xweb,1.100; html/param.xweb,1.94 - Michael(tm) Smith + + * Added two new parameters for handling of multi-term varlistentry elements: + + variablelist.term.break.after: When the variablelist.term.break.after is + non-zero, it will generate a line break after each term multi-term + varlistentry. + + variablelist.term.separator: When a varlistentry contains multiple term + elements, the string specified in the value of the + variablelist.term.separator parameter is placed after each term except the + last. The default is ", " (a comma followed by a space). To suppress + rendering of the separator, set the value of variablelist.term.separator + to the empty string (""). + + These parameters are primarily intended to be useful if you have + multi-term varlistentries that have long terms. + + Closes #1306676. Thanks to Sam Steingold for providing an example "lots of + long terms" doc that demonstrated the value of having these options. + + Also, added normalize-space() call to processing of each term. + + This change affects all output formats (HTML, PDF, manpages). The default + behavior should pretty much remain the same as before, but it is possible + (as always) that the change may introduce some new bugginess. + + Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; + html/lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; + manpages/lists.xsl,1.22; manpages/param.ent,1.14; + manpages/param.xweb,1.16; params/variablelist.term.break.after.xml,1.1; + params/variablelist.term.separator.xml,1.1 - Michael(tm) Smith + + * Add sidebar titlepage placeholder attset for styles. + + Modified: fo/titlepage.xsl,1.37 - Robert Stayton + + * Add titlepage for sidebar. + + Modified: fo/titlepage.templates.xml,1.27 - Robert Stayton + + * Implemented RFE #1292615. + + Added bunch of new parameters (attribute sets) that affect list + presentation: list.block.properties, itemizedlist.properties, orderedlist + .properties, itemizedlist.label.properties and orderedlist.label + .properties. Default behaviour of stylesheets has not been changed but + further customizations will be much more easier. + + Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; fo/param.xweb,1.98; + params/itemizedlist.label.properties.xml,1.1; + params/itemizedlist.properties.xml,1.1; + params/list.block.properties.xml,1.1; + params/orderedlist.label.properties.xml,1.1; + params/orderedlist.properties.xml,1.1 - Jirka Kosek + + * Implemented RFE #1242092. + + You can enable crop marks in your document by setting crop.marks=1 and + xep.extensions=1. Appearance of crop marks can be controlled by parameters + crop.mark.bleed (6pt), crop.mark.offset (24pt) and crop.mark.width + (0.5pt). + + Also there is new named template called user-xep-pis. You can overwrite it + in order to produce some PIs that can control XEP as described in + http://www.renderx.com/reference.html#Output_Formats + + Modified: fo/docbook.xsl,1.36; fo/param.ent,1.86; fo/param.xweb,1.97; + fo/xep.xsl,1.23; params/crop.mark.bleed.xml,1.1; + params/crop.mark.offset.xml,1.1; params/crop.mark.width.xml,1.1; + params/crop.marks.xml,1.1 - Jirka Kosek + +HTML + +The following changes have been made to the html code since the 1.69.1 +release. + + * implemented index.method parameter and three methods. + + Modified: html/autoidx.xsl,1.28 - Robert Stayton + + * added index.method parameter to support 3 indexing methods. + + Modified: html/param.ent,1.94; html/param.xweb,1.103 - Robert Stayton + + * Implemented feature request #1072510 as a processing instruction to permit + including external HTML content into HTML output. + + Modified: html/pi.xsl,1.9 - Robert Stayton + + * Added new parameter chunk.tocs.and.lots.has.title which controls presence + of title in a separate chunk with ToC/LoT. Disabling title can be very + useful if you are generating frameset output (well, yes those frames, but + some customers really want them ;-). + + Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; + html/param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - + Jirka Kosek + + * Support dbhtml/dbfo start PI for orderedlist numbering in both HTML and FO + + Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman Walsh + + * Allow ToC without title also for set and book. + + Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 - Jirka Kosek + + * Implemented floats uniformly for figure, example, equation and + informalfigure, informalexample, and informalequation. + + Modified: html/formal.xsl,1.22 - Robert Stayton + + * Added the autotoc.label.in.hyperlink param. + + If the value of autotoc.label.in.hyperlink is non-zero, labels are + included in hyperlinked titles in the TOC. If it is instead zero, labels + are still displayed prior to the hyperlinked titles, but are not + hyperlinked along with the titles. + + Closes patch #1065868. Thanks to anatoly techtonik for the patch. + + Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; + html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - + Michael(tm) Smith + + * Added two new params: html.head.legalnotice.link.types and html.head. + legalnotice.link.multiple. + + If the value of the generate.legalnotice.link is non-zero, then the + stylesheet generates (in the head section of the HTML source) either a + single HTML link element or, if the value of the html.head.legalnotice. + link.multiple is non-zero, one link element for each link type specified. + Each link has the following attributes: + + - a rel attribute whose value is derived from the value of html.head. + legalnotice.link.types + + - an href attribute whose value is set to the URL of the file containing + the legalnotice + + - a title attribute whose value is set to the title of the corresponding + legalnotice (or a title programatically determined by the stylesheet) + + For example: + + + + Closes #1476450. Thanks to Sam Steingold. + + Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; + html/param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; + params/html.head.legalnotice.link.multiple.xml,1.1; + params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith + + * Added refclass.suppress param. + + If the value of refclass.suppress is non-zero, then display refclass + contents is suppressed in output. Affects HTML and FO output only. + + Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; + html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) Smith + + * Improved support for task subelements + + Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - Jirka Kosek + + * Added new refclass.suppress param for suppressing display of Refclass in + HTML and FO output. Did not add it to manpages because manpages stylesheet + is currently just silently ignoring Refclass anyway. Closes request + #1461065. Thanks to Davor Ocelic (docelic) for reporting. + + Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - Michael(tm) Smith + + * Process alt text with normalize-space(). Replace tab indents with spaces. + + Modified: html/graphics.xsl,1.57 - Robert Stayton + + * Content of citation element is automatically linked to the bibliographic + entry with the corresponding abbrev. + + Modified: html/biblio.xsl,1.26; html/inline.xsl,1.47; html/xref.xsl,1.58 - + Jirka Kosek + + * Add template for task in mode="xref-to". + + Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert Stayton + + * Suppress ID warnings if the .warnings parameter is 0 + + Modified: html/html.xsl,1.17 - Norman Walsh + + * Add support for floatstyle to figure. + + Modified: html/formal.xsl,1.21 - Robert Stayton + + * Handling of xref to area/areaset need support in extensions code also. I + currently have no time to touch extensions code, so code is here to be + enabled when extension is fixed also. + + Modified: html/xref.xsl,1.56 - Jirka Kosek + + * Added 3 parameters for overriding gentext for index punctuation. + + Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert Stayton + + * Added parameters to support localization of index item punctuation. Added + index.separator named template to compute the separator punctuation based + on locale. + + Modified: html/autoidx.xsl,1.27 - Robert Stayton + + * Added a
                  wrapper around output of contents + of all formal objects. Also, added an optional
                  + linebreak after all formal objects. + + WARNING: Because this change places an additional DIV between the DIV + wrapper for the equation and the equation contents, it may break some + existing CSS stylesheets that have been created with the assumption that + there would never be an intervening DIV there. + + The following is an example of what Equation output looks like as a result + of the changes described above. + +
                  + +

                  (1.3)

                  + +
                  1+1=3 +

                  + + Rationale: These changes allow CSS control of the placement of the + formal-object title relative to the formal-object contents. For example, + using the CSS "float" property enables the title and contents to be + rendered on the same line. Example stylesheet: + + .equation { margin-top: 20px; margin-bottom: 20px; } .equation-contents { + float: left; } + + .equation .title { margin-top: 0; float: right; margin-right: 200px; } + + .equation .title b { font-weight: normal; } + + .equation-break { clear: both; } + + Note that the purpose of the ".equation-break" class is to provide a way + to clear off the floats. + + If you want to instead have the equation title rendered to the left of the + equation contents, you can do something like this: + + .equation { margin-top: 20px; width: 300px; margin-bottom: 20px; } + .equation-contents { float: right; } + + .equation .title { margin-top: 0; float: left; margin-right: 200px; } + + .equation .title b { font-weight: normal; } + + .equation-break { clear: both; } + + Modified: html/formal.xsl,1.20 - Michael(tm) Smith + + * Added a chunker.output.quiet top-level parameter so that the chunker can + be made quiet by default + + Modified: html/chunker.xsl,1.26 - Norman Walsh + + * Added support for link, olink, and xref within OO Classsynopsis and + children. (Because DocBook NG/5 allows it). + + Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) Smith + + * New parameter: id.warnings. If non-zero, warnings are generated for titled + objects that don't have titles. True by default; I wonder if this will be + too aggressive? + + Modified: html/biblio.xsl,1.25; html/component.xsl,1.27; + html/division.xsl,1.11; html/formal.xsl,1.19; html/glossary.xsl,1.20; + html/html.xsl,1.13; html/index.xsl,1.16; html/param.ent,1.88; + html/param.xweb,1.97; html/refentry.xsl,1.22; html/sections.xsl,1.30; + params/id.warnings.xml,1.1 - Norman Walsh + + * If the keep.relative.image.uris parameter is true, don't use the absolute + URI (as calculated from xml:base) in the img src attribute, us the value + the author specified. Note that we still have to calculate the absolute + filename for use in the image intrinsics extension. + + Modified: html/graphics.xsl,1.56 - Norman Walsh + + * Support date as an inline + + Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman Walsh + + * Added new parameter keep.relative.image.uris + + Modified: fo/param.ent,1.91; fo/param.xweb,1.104; html/param.ent,1.87; + html/param.xweb,1.96; params/keep.relative.image.uris.xml,1.1 - Norman + Walsh + + * Added two new parameters for handling of multi-term varlistentry elements: + + variablelist.term.break.after: When the variablelist.term.break.after is + non-zero, it will generate a line break after each term multi-term + varlistentry. + + variablelist.term.separator: When a varlistentry contains multiple term + elements, the string specified in the value of the + variablelist.term.separator parameter is placed after each term except the + last. The default is ", " (a comma followed by a space). To suppress + rendering of the separator, set the value of variablelist.term.separator + to the empty string (""). + + These parameters are primarily intended to be useful if you have + multi-term varlistentries that have long terms. + + Closes #1306676. Thanks to Sam Steingold for providing an example "lots of + long terms" doc that demonstrated the value of having these options. + + Also, added normalize-space() call to processing of each term. + + This change affects all output formats (HTML, PDF, manpages). The default + behavior should pretty much remain the same as before, but it is possible + (as always) that the change may introduce some new bugginess. + + Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; + html/lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; + manpages/lists.xsl,1.22; manpages/param.ent,1.14; + manpages/param.xweb,1.16; params/variablelist.term.break.after.xml,1.1; + params/variablelist.term.separator.xml,1.1 - Michael(tm) Smith + + * Added "wrapper-name" param to inline.charseq named template, enabling it + to output inlines other than just "span". Acronym and Abbrev templates now + use inline.charseq to output HTML "acronym" and "abbr" elements (instead + of "span"). Closes #1305468. Thanks to Sam Steingold for suggesting the + change. + + Modified: html/inline.xsl,1.45 - Michael(tm) Smith + +Manpages + +The following changes have been made to the manpages code since the 1.69.1 +release. + + * Added the following params: + + - man.indent.width (string-valued) - man.indent.refsect (boolean) - + man.indent.blurbs (boolean) - man.indent.lists (boolean) - + man.indent.verbatims (boolean) + + Note that in earlier snapshots, man.indent.width was named + man.indentation.default.value and the boolean params had names like + man.indentation.*.adjust. Also the man.indent.blurbs param was called + man.indentation.authors.adjust (or something). + + The behavior now is: If the value of a particular man.indent.* boolean + param is non-zero, the corresponding contents (refsect*, list items, + authorblurb/personblurb, vervatims) are displayed with a left margin + indented by a width equal to the value of man.indent.width. + + Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74; + manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20; + manpages/param.ent,1.22; manpages/param.xweb,1.24; + manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; + params/man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; + params/man.indent.width.xml,1.1 - Michael(tm) Smith + + * Added man.table.footnotes.divider param. + + In each table that contains footenotes, the string specified by the man. + table.footnotes.divider parameter is output before the list of footnotes + for the table. + + Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; + manpages/param.ent,1.21; manpages/param.xweb,1.23; + params/man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith + + * Added the man.output.in.separate.dir, man.output.base.dir, and + man.output.subdirs.enabled parameters. + + The man.output.base.dir parameter specifies the base directory into which + man-page files are output. The man.output.subdirs.enabled parameter + controls whether the files are output in subdirectories within the base + directory. + + The values of the man.output.base.dir and man.output.subdirs.enabled + parameters are used only if the value of man.output.in.separate.dir + parameter is non-zero. If the value of man.output.in.separate.dir is zero, + man-page files are not output in a separate directory. + + Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; + manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; + params/man.output.in.separate.dir.xml,1.1; + params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith + + * Added man.font.table.headings and man.font.table.title params, for + controlling font in table headings and titles. + + Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; + manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; + params/man.font.table.title.xml,1.1 - Michael(tm) Smith + + * Added man.font.funcsynopsisinfo and man.font.funcprototype params, for + specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and + funcprototype output. + + Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; + manpages/param.ent,1.18; manpages/param.xweb,1.20; + manpages/synop.xsl,1.29; manpages/table.xsl,1.21; + params/man.font.funcprototype.xml,1.1; + params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith + + * Added man.segtitle.suppress param. + + If the value of man.segtitle.suppress is non-zero, then display of + segtitle contents is suppressed in output. + + Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; + manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - + Michael(tm) Smith + + * Added man.output.manifest.enabled and man.output.manifest.filename params. + + If man.output.manifest.enabled is non-zero, a list of filenames for man + pages generated by the stylesheet transformation is written to the file + named by man.output.manifest.filename + + Modified: manpages/docbook.xsl,1.67; manpages/other.xsl,1.19; + manpages/param.ent,1.16; manpages/param.xweb,1.18; + params/man.output.manifest.enabled.xml,1.1; + params/man.output.manifest.filename.xml,1.1; + tools/make/Makefile.DocBook,1.4 - Michael(tm) Smith + + * Added refentry.meta.get.quietly param. + + If zero (the default), notes and warnings about "missing" markup are + generated during gathering of refentry metadata. If non-zero, the metadata + is gathered "quietly" -- that is, the notes and warnings are suppressed. + + NOTE: If you are processing a large amount of refentry content, you may be + able to speed up processing significantly by setting a non-zero value for + refentry.meta.get.quietly. + + Modified: common/refentry.xsl,1.17; manpages/param.ent,1.15; + manpages/param.xweb,1.17; params/refentry.meta.get.quietly.xml,1.1 - + Michael(tm) Smith + + * Changed names of all boolean indentation params to man.indent.* Also + discarded individual man.indent.*.value params and switched to just using + a common man.indent.width param (3n by default). + + Modified: manpages/docbook.xsl,1.66; manpages/info.xsl,1.19; + manpages/lists.xsl,1.29; manpages/other.xsl,1.18; + manpages/refentry.xsl,1.13 - Michael(tm) Smith + + * Added boolean man.output.in.separate.dir param, to control whether or not + man files are output in separate directory. + + Modified: manpages/docbook.xsl,1.65; manpages/utility.xsl,1.14 - + Michael(tm) Smith + + * Added options for controlling indentation of verbatim output. Controlled + through the man.indentation.verbatims.adjust and + man.indentation.verbatims.value params. Closes #1242997 + + Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 - Michael(tm) + Smith + + * Added options for controlling indentation in lists and in *blurb output in + the AUTHORS section. Controlled through the man.indentation.lists.adjust, + man.indentation.lists.value, man.indentation.authors.adjust, and + man.indentation.authors.value parameters. Default is 3 characters (instead + of the roff default of 8 characters). Closes #1449369. + + Also, removed the indent that was being set on informalexample outuput. I + will instead add an option for indenting verbatims, which I think is what + the informalexample indent was intended for originally. + + Modified: manpages/block.xsl,1.14; manpages/docbook.xsl,1.63; + manpages/info.xsl,1.18; manpages/lists.xsl,1.28 - Michael(tm) Smith + + * Changed line-spacing call before synopfragment to use ".sp -1n" ("n" units + specified) instead of plain ".sp -1" + + Modified: manpages/synop.xsl,1.28 - Michael(tm) Smith + + * Added support for writing man files into a specific output directory and + into appropriate subdirectories within that output directory. Controlled + through the man.base.dir parameter (similar to the base.dir support in the + HTML stylesheet) and the man.subdirs.enabled parameter, which + automatically determines the name of an appropriate subdir (for example, + man/man7, man/man1, etc.) based on the section number/manvolnum of the + source Refentry. + + Closes #1255036 and #1170317. Thanks to Denis Bradford for the original + feature request, and to Costin Stroie for submitting a patch that was very + helpful in implementing the support. + + Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 - + Michael(tm) Smith + + * Refined XPath statements and notification messages for refentry metadata + handling. + + Modified: common/common.xsl,1.59; common/refentry.xsl,1.14; + manpages/docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm) Smith + + * Added support for copyright and legalnotice. The manpages stylesheets now + output a COPYRIGHT section, after the AUTHORS section, if a copyright or + legalnotice is found in the source. The section contains the copyright + contents followed by the legalnotice contents. Closes #1450209. + + Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 - Michael(tm) + Smith + + * Drastically reworked all of the XPath expressions used in refentry + metadata gathering -- completely removed $parentinfo and turned $info into + a set of nodes that includes the *info contents of the Refentry plus the + *info contents all all of its ancestor elements. The basic XPath + expression now used throughout is (using the example of checking for a + date): + + (($info[//date])[last()]/date)[1]. + + That selects the "last" *info/date date in document order -- that is, the + one eitther on the Refentry itself or on the closest ancestor to the + Refentry. + + It's likely this change may break some things; may need to pick up some + pieces later. + + Also, changed the default value for the man.th.extra2.max.length from 40 + to 30. + + Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; + params/man.th.extra2.max.length.xml,1.2; + params/refentry.date.profile.xml,1.2; + params/refentry.manual.profile.xml,1.2; + params/refentry.source.name.profile.xml,1.2; + params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; + manpages/other.xsl,1.15 - Michael(tm) Smith + + * Added support for DocBook 5 namespace-stripping in manpages stylesheet. + Closes request #1210692. + + Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - Michael(tm) + Smith + + * Fixed handling of table footnotes. With this checkin, the table support in + the manpages stylesheet is now basically feature complete. So this change + closes request #619532, "No support for tables" -- the oldest currently + open manpages feature request, submitted by Ben Secrest (blsecres) on + 2002-10-07. Congratulations to me [patting myself on the back]. + + Modified: manpages/block.xsl,1.11; manpages/docbook.xsl,1.55; + manpages/table.xsl,1.15 - Michael(tm) Smith + + * Added handling for table titles. Also fixed handling of nested tables; + nest tables are now "extracted" and displayed just after their parent + tables. + + Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14 - Michael(tm) + Smith + + * Added option for turning off bold formatting in Funcsynopsis. Boldface + formatting in function synopsis is mandated in the man(7) man page and is + used almost universally in existing man pages. Despite that, it really + does look like crap to have an entire Funcsynopsis output in bold, so I + added params for turning off the bold formatting and/or replacing it with + a different roff special font (e.g., "RI" for alternating roman/italic + instead of the default "BI" for alternating bold/italic). The new params + are "man.funcprototype.font" and "man.funcsynopsisinfo.font". To be + documented later. + + Closes #1452247. Thanks to Joe Orton for the feature request. + + Modified: params/man.string.subst.map.xml,1.16; manpages/block.xsl,1.10; + manpages/docbook.xsl,1.51; manpages/inline.xsl,1.16; + manpages/synop.xsl,1.27 - Michael(tm) Smith + + * Use AUTHORS instead of AUTHOR if we have multiple people to attribute. + Also, fixed checking such that we generate author section even if we don't + have an author (as long as there is at least one other person/entity we + can put in the section). Also adjusted assembly of content for Author + metainfo field such that we now not only use author, but try to find a + "best match" if we can't find an author name to put there. + + Closes #1233592. Thanks to Sam Steingold for the request. + + Modified: manpages/info.xsl,1.12 - Michael(tm) Smith + + * Changes for request #1243027, "Impove handling of AUTHOR section." This + adds support for Collab, Corpauthor, Corpcredt, Orgname, Publishername, + and Publisher. Also adds support for output of Affiliation and its + children, and support for using gentext strings for auto-attributing roles + (Author, Editor, Publisher, Translator, etc.). Also did a lot of code + cleanup and modularization of all the AUTHOR handling code. And fixed a + bug that was causing Author info to not be picked up correctly for + metainfo comment we embed in man-page source. + + Modified: manpages/info.xsl,1.11 - Michael(tm) Smith + + * Support bold output for "emphasis remap='B'". (because Eric Raymond's + doclifter(1) tool converts groff source marked up with ".B" request or + "\fB" escapes to DocBook "emphasis remap='B'".) + + Modified: manpages/inline.xsl,1.14 - Michael(tm) Smith + + * Added support for Segmentedlist. Details: Output is tabular, with no + option for "list" type output. Output for Segtitle elements can be + supressed by setting man.segtitle.suppress. If Segtitle content is output, + it is rendered in italic type (not bold because not all terminals support + bold and so italic ensures the stand out on those terminals). Extra space + (.sp line) at end of table code ensures that it gets handled correctly in + the case where its source is the child of a Para. Closes feature-request + #1400097. Thanks to Daniel Leidert for the patch and push, and to Alastair + Rankine for filing the original feature request. + + Modified: manpages/lists.xsl,1.23; manpages/utility.xsl,1.10 - Michael(tm) + Smith + + * Improved handling or Author/Editor/Othercredit. + + Reworked content of (non-visible) comment added at top of each page + (metadata stuff). + + Added support for generating a manifest file (useful for cleaning up after + builds, etc.) + + Modified: manpages/docbook.xsl,1.46; manpages/info.xsl,1.9; + manpages/other.xsl,1.12; manpages/utility.xsl,1.6 - Michael(tm) Smith + + * Added two new parameters for handling of multi-term varlistentry elements: + + variablelist.term.break.after: When the variablelist.term.break.after is + non-zero, it will generate a line break after each term multi-term + varlistentry. + + variablelist.term.separator: When a varlistentry contains multiple term + elements, the string specified in the value of the + variablelist.term.separator parameter is placed after each term except the + last. The default is ", " (a comma followed by a space). To suppress + rendering of the separator, set the value of variablelist.term.separator + to the empty string (""). + + These parameters are primarily intended to be useful if you have + multi-term varlistentries that have long terms. + + Closes #1306676. Thanks to Sam Steingold for providing an example "lots of + long terms" doc that demonstrated the value of having these options. + + Also, added normalize-space() call to processing of each term. + + This change affects all output formats (HTML, PDF, manpages). The default + behavior should pretty much remain the same as before, but it is possible + (as always) that the change may introduce some new bugginess. + + Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; fo/param.xweb,1.99; + html/lists.xsl,1.48; html/param.ent,1.86; html/param.xweb,1.93; + manpages/lists.xsl,1.22; manpages/param.ent,1.14; + manpages/param.xweb,1.16; params/variablelist.term.break.after.xml,1.1; + params/variablelist.term.separator.xml,1.1 - Michael(tm) Smith + +Params + +The following changes have been made to the params code since the 1.69.1 +release. + + * New parameters to set header/footer table minimum height. + + Modified: params/footer.table.height.xml,1.1; + params/header.table.height.xml,1.1 - Robert Stayton + + * Support multiple indexing methods for different languages. + + Modified: params/index.method.xml,1.1 - Robert Stayton + + * Remove qandaset and qandadiv from generate.toc for fo output because + formerly it wasn't working, but now it is and the default behavior should + stay the same. + + Modified: params/generate.toc.xml,1.8 - Robert Stayton + + * add support for page number references to link element too. + + Modified: params/insert.link.page.number.xml,1.1 - Robert Stayton + + * Add support for more characters to hyphen on when ulink.hyphenate is + turned on. + + Modified: params/ulink.hyphenate.chars.xml,1.1; + params/ulink.hyphenate.xml,1.3 - Robert Stayton + + * New attribute-set to format biblioentry and bibliomixed. + + Modified: params/biblioentry.properties.xml,1.1 - Robert Stayton + + * Added new parameter chunk.tocs.and.lots.has.title which controls presence + of title in a separate chunk with ToC/LoT. Disabling title can be very + useful if you are generating frameset output (well, yes those frames, but + some customers really want them ;-). + + Modified: html/chunk-code.xsl,1.15; html/param.ent,1.93; + html/param.xweb,1.102; params/chunk.tocs.and.lots.has.title.xml,1.1 - + Jirka Kosek + + * Added new attribute set toc.line.properties for controlling appearance of + lines in ToC/LoT + + Modified: params/toc.line.properties.xml,1.1 - Jirka Kosek + + * Allow table footnotes to have different properties from regular footnotes. + + Modified: params/table.footnote.properties.xml,1.1 - Robert Stayton + + * Set properties for pgwide="1" objects. + + Modified: params/pgwide.properties.xml,1.1 - Robert Stayton + + * Added the autotoc.label.in.hyperlink param. + + If the value of autotoc.label.in.hyperlink is non-zero, labels are + included in hyperlinked titles in the TOC. If it is instead zero, labels + are still displayed prior to the hyperlinked titles, but are not + hyperlinked along with the titles. + + Closes patch #1065868. Thanks to anatoly techtonik for the patch. + + Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; + html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - + Michael(tm) Smith + + * Added two new params: html.head.legalnotice.link.types and html.head. + legalnotice.link.multiple. + + If the value of the generate.legalnotice.link is non-zero, then the + stylesheet generates (in the head section of the HTML source) either a + single HTML link element or, if the value of the html.head.legalnotice. + link.multiple is non-zero, one link element for each link type specified. + Each link has the following attributes: + + - a rel attribute whose value is derived from the value of html.head. + legalnotice.link.types + + - an href attribute whose value is set to the URL of the file containing + the legalnotice + + - a title attribute whose value is set to the title of the corresponding + legalnotice (or a title programatically determined by the stylesheet) + + For example: + + + + Closes #1476450. Thanks to Sam Steingold. + + Modified: html/chunk-common.xsl,1.45; html/param.ent,1.91; + html/param.xweb,1.100; params/generate.legalnotice.link.xml,1.4; + params/html.head.legalnotice.link.multiple.xml,1.1; + params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm) Smith + + * Added the following params: + + - man.indent.width (string-valued) - man.indent.refsect (boolean) - + man.indent.blurbs (boolean) - man.indent.lists (boolean) - + man.indent.verbatims (boolean) + + Note that in earlier snapshots, man.indent.width was named + man.indentation.default.value and the boolean params had names like + man.indentation.*.adjust. Also the man.indent.blurbs param was called + man.indentation.authors.adjust (or something). + + The behavior now is: If the value of a particular man.indent.* boolean + param is non-zero, the corresponding contents (refsect*, list items, + authorblurb/personblurb, vervatims) are displayed with a left margin + indented by a width equal to the value of man.indent.width. + + Modified: params/man.indent.blurbs.xml,1.1; manpages/docbook.xsl,1.74; + manpages/info.xsl,1.20; manpages/lists.xsl,1.30; manpages/other.xsl,1.20; + manpages/param.ent,1.22; manpages/param.xweb,1.24; + manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; + params/man.indent.refsect.xml,1.1; params/man.indent.verbatims.xml,1.1; + params/man.indent.width.xml,1.1 - Michael(tm) Smith + + * Added man.table.footnotes.divider param. + + In each table that contains footenotes, the string specified by the man. + table.footnotes.divider parameter is output before the list of footnotes + for the table. + + Modified: manpages/docbook.xsl,1.73; manpages/links.xsl,1.6; + manpages/param.ent,1.21; manpages/param.xweb,1.23; + params/man.table.footnotes.divider.xml,1.1 - Michael(tm) Smith + + * Added the man.output.in.separate.dir, man.output.base.dir, and + man.output.subdirs.enabled parameters. + + The man.output.base.dir parameter specifies the base directory into which + man-page files are output. The man.output.subdirs.enabled parameter + controls whether the files are output in subdirectories within the base + directory. + + The values of the man.output.base.dir and man.output.subdirs.enabled + parameters are used only if the value of man.output.in.separate.dir + parameter is non-zero. If the value of man.output.in.separate.dir is zero, + man-page files are not output in a separate directory. + + Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; + manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; + params/man.output.in.separate.dir.xml,1.1; + params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) Smith + + * Added man.font.table.headings and man.font.table.title params, for + controlling font in table headings and titles. + + Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; + manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; + params/man.font.table.title.xml,1.1 - Michael(tm) Smith + + * Added man.font.funcsynopsisinfo and man.font.funcprototype params, for + specifying the roff font (for example, BI, B, I) for funcsynopsisinfo and + funcprototype output. + + Modified: manpages/block.xsl,1.19; manpages/docbook.xsl,1.69; + manpages/param.ent,1.18; manpages/param.xweb,1.20; + manpages/synop.xsl,1.29; manpages/table.xsl,1.21; + params/man.font.funcprototype.xml,1.1; + params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) Smith + + * Changed to select="0" in refclass.suppress (instead of ..>0 as a child of the list. For example: + + Choose from + ONE and ONLY ONE of the following: + + + A + B + C. + + Output (for English): + + Choose from ONE and only ONE of the following choices: A, B, or C. + + As a temporary workaround for the fact that most of the DocBook + non-English locale files don't have a localization for the word or, you + can put in a literal string to be used; example for French: + . That is, use ou instead of or. + +FO + + * Added content-type property to external-graphic element, based on + imagedata format attribute. + + * Added support for generating field for + XEP output. This makes the DocBook XSL stylesheet version information + available through the Document Properties menu in Acrobat Reader and other + PDF viewers. + + * Trademark symbol handling made consistent with handling of same in HTML + stylesheets. Prior to this change, if you processed a document that + contained no value for the class attribute on the trademark element, the + HTML stylesheets would default to rendering a superscript TM symbol after + the trademark contents, but the FO stylesheets would render nothing. + + * Added support for generating XEP bookmarks for refentry. + + * Added support for HTML markup table border attribute, applied to each + table cell. + + * The table.width template can now sum column specs if none use % or *. + + * Added fox:destination extension inside fox:outline to support linking to + internal destinations. + + * Added support for customizing abstract with property sets. Controlled with + the abstract.properties and abstract.title.properties parameters. + + * Add footnotes in table title to table footnote set, and add support for + table footnotes to HTML table markup. + + * Added support for title in glosslist. + + * Added support for itemizedlist symbol none. + + * Implemented the new graphical.admonition.properties and + nongraphical.admonition.properties attribute sets. + + * Added id to formalpara and some other blocks that were missing it. + + * Changed the anchor template to output fo:inline instead of fo:wrapper. + + * Added support for toc.max.depth parameter. + +Help + + * Eclipse Help: Added support for generating olink database. + +HTML + + * Added a first cut at support in HTML output for DocBook 5 style annotation + s. Controlled using the annotation.support parameter, and implemented + using JavaScript and CSS styling. For more details, see the documentation + for the annotation.js, annotation.css, annotation.graphic.open, and + annotation.graphic.close parameters. + + * Generate client-side image map for imageobjectco with areas using calspair + units + + * Added support for PI. + + * Added support for passing img.src.path to DocBook Java XSLT image + extensions when appropriate. Controlled using the + graphicsize.use.img.src.path parameter. + + * Added support for (not valid for DocBook 4) xlink:href on area and (not + valid for DocBook 4) alt in area. + + * Added new parameter default.table.frame to control table framing if there + is no frame attribute on a table. + + * Added initial, experimental support for generating content for the HTML + title attribute from content of the alt element. This change adds support + for the following inline elements only (none of them are block elements): + abbrev, accel, acronym, action, application, authorinitials, beginpage, + citation, citerefentry, citetitle, city, classname, code, command, + computeroutput, constant, country, database, email, envar, errorcode, + errorname, errortext, errortype, exceptionname, fax, filename, firstname, + firstterm, foreignphrase, function, glossterm, guibutton, guiicon, + guilabel, guimenu, guimenuitem, guisubmenu, hardware, honorific, + interface, interfacename, keycap, keycode, keysym, lineage, lineannotation + , literal, markup, medialabel, methodname, mousebutton, option, optional, + otheraddr, othername, package, parameter, personname, phone, pob, postcode + , productname, productnumber, prompt, property, quote, refentrytitle, + remark, replaceable, returnvalue, tag, shortcut, state, street, + structfield, structname, subscript, superscript, surname, symbol, + systemitem, tag, termdef, token, trademark, type, uri, userinput, varname, + and wordasword + + * Added support for chunking revhistory into separate file (similar to the + support for doing same with legalnotice). Patch from Thomas Schraitle. + Controlled through new generate.revhistory.link parameter. + + * l10n.xsl: Made language codes RFC compliant. Added a new boolean config + parameter, l10n.lang.value.rfc.compliant. If it is non-zero (the default), + any underscore in a language code will be converted to a hyphen in HTML + output. If it is zero, the language code will be left as-is. + +man + +This release closes out 44 manpages stylesheet bug reports and feature +requests. It adds more than 35 new configuration parameters for controlling +aspects of man-page output -- including hyphenation and justification, +handling of links, conversion of Unicode characters, and contents of man-page +headers and footers. + + * New options for globally disabling/enabling hyphenation and justification: + man.justify and man.hyphenate. + + Note that the default for the both of those is zero (off), because + justified text looks good only when it is also hyphenated; to quote the + Hyphenation node from the groff info page: + + Since the odds are not great for finding a set of words, for every + output line, which fit nicely on a line without inserting excessive + amounts of space between words, `gtroff' hyphenates words so that it + can justify lines without inserting too much space between words. + + The problem is that groff can end up hyphenating a lot of things that you + don't want hyphenated (variable names and command names, for example). + Keeping both justification and hyphenation disabled ensures that hyphens + won't get inserted where you don't want to them, and you don't end up with + lines containing excessive amounts of space between words. These default + settings run counter to how most existing man pages are formatted. But + there are some notable exceptions, such as the perl man pages. + + * Added parameters for controlling hyphenation of computer inlines, + filenames, and URLs. By default, even when hyphenation is enabled + (globally), hyphenation is now suppressed for "computer inlines" + (currently, just classname, constant, envar, errorcode, option, + replaceable, userinput, type, and varname, and for filenames, and for URLs + from link. It can be (re)enabled using the man.hyphenate.computer.inlines, + man.hyphenate.filenames, and man.hyphenate.urls parameters. + + * Implemented a new system for replacing Unicode characters. There are two + parts to the new system: a string substitution map for doing essential + replacements, and a character map that can optionally be disabled and + enabled. + + The new system fixes all open bugs that had to do with literal Unicode + numbered entities such as “ and ” showing up in output, and + greatly expands the ability of the stylesheets to generate good roff + equivalents for Unicode symbols and special characters. + + Here are some details... + + The previous manpages mechanism for replacing Unicode symbols and special + characters with roff equivalents (the replace-entities template) was not + scalable and not complete. The mechanism handled a somewhat arbitrary + selection of less than 20 or so Unicode characters. But there are + potentially more than 800 Unicode special characters that have some groff + equivalent they can be mapped to. And there are about 34 symbols in the + Latin-1 (ISO-8859-1) block alone. Users might reasonably expect that if + they include any of those Latin-1 characters in their DocBook source + documents, they will get correctly converted to known roff equivalents in + output. + + In addition to those common symbols, certain users may have a need to use + symbols from other Unicode blocks. Say, somebody who is documenting an + application related to math might need to use a bunch of symbols from the + Mathematical Operators Unicode block (there are about 65 characters in + that block that have reasonable roff equivalents). Or somebody else might + really like Dingbats -- such as the checkmark character -- and so might + use a bunch of things from the Dingbat block (141 characters in that + that have roff equivalents or that can at least be degraded somewhat + gracefully into roff). + + So, the old replace-entities mechanism was replaced with a completely + different mechanism that is based on use of two maps: a substitution + map and a character map (the latter in a format compliant with the XSLT + 2.0 spec and therefore completely forward compatible with XSLT 2.0). + + The substitution map is controlled through the man.string.subst.map + parameter, and is used to replace things like the backslash character + (which needs special handling to prevent it from being interpreted as a + roff escape). The substitution map cannot be disabled, because disabling + it will cause the output to be broken. However, you can add to it and + change it if needed. + + The character map mechanism, on the other hand, can be completely + disabled. It is enabled by default, and, by default, does replacement of + all Latin-1 symbols, along with most special spaces, dashes, and quotes + (about 75 characters by default). Also, you can optionally enable a full + character map that provides support for converting all 800 or so of the + characters that have some reasonable groff equivalent. + + The character-map mechanism is controlled through the following + parameters: + + man.charmap.enabled + + turns character-map support on/off + + man.charmap.use.subset + + specifies that a subset of the character map is used instead of the + full map + + man.charmap.subset.profile + + specifies profile of character-map subset + + man.charmap.uri + + specifies an alternate character map to use instead of the standard + character map provided in the distribution + + * Implemented out-of-line handling of display of URLs for links (currently, + only for ulink). This gives you three choices for handling of links: + + 1. Number and list links. Each link is numbered inline, with a number in + square brackets preceding the link contents, and a numbered list of + all links is added to the end of the document. + + 2. Only list links. Links are not numbered, but an (unnumbered) list of + links is added to the end of the document. + + 3. Suppress links. Don't number links and don't add any list of links to + the end of the document. + + You can also choose whether links should be underlined. The default is + the works -- list, number, and underline links. You can use the + man.links.list.enabled, man.links.are.numbered, and + man.links.are.underlined parameters to change the defaults. The default + heading for the link list is REFERENCES. You can be change that using the + man.links.list.heading parameter. + + * Changed default output encoding to UTF-8. This does not mean that man + pages are output in raw UTF-8, because the character map is applied before + final output, causing all UTF-8 characters covered in the map to be + converted to roff equivalents. + + * Added support for processing refsect3 and formalpara and nested refsection + elements, down to any arbitrary level of nesting. + + * Output of the NAME and SYNOPSIS and AUTHOR headings and the headings for + admonitions (note, caution, etc.) are no longer hard-coded for English. + Instead, headings are generated for those in the correct locale (just as + the FO and HTML stylesheets do). + + * Re-worked mechanism for assembling page headers/footers (the contents of + the .TH macro title line). + + Here are some details... + + All man pages contain a .TH roff macro whose contents are used for + rendering the title line displayed in the header and footer of each + page. Here are a couple of examples of real-world man pages that have + useful page headers/footers: + + gtk-options(7) GTK+ User's Manual gtk-options(7) <-- header + GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer + + svgalib(7) Svgalib User Manual svgalib(7) <-- header + Svgalib 1.4.1 16 December 1999 svgalib(7) <-- footer + + And here are the terms with which the groff_man(7) man page refers to the + various parts of the header/footer: + + title(section) extra3 title(section) <- header + extra2 extra1 title(section) <- footer + + Or, using the names with which the man(7) man page refers to those same + fields: + + title(section) manual title(section) <- page header + source date title(section) <- page footer + + The easiest way to control the contents of those fields is to mark up your + refentry content like the following (note that this is a minimal + example). + + + + 2003-10-20 1 + + + gtk-options 2 + 7 3 + GTK+ 4 + 1.2 5 + GTK+ User's Manual 6 + + + gtk-options + Standard Command Line Options for GTK+ Programs + + + Description + This manual page describes the command line options, which + are common to all GTK+ based applications. + + + + 1 Sets the date part of the header/footer. + + 2 Sets the title part. + + 3 Sets the section part. + + 4 Sets the source name part. + + 5 Sets the version part. + + 6 Sets the manual part. + + Below are explanations of the steps the stylesheets take to attempt to + assemble and display good headers and footer. [In the descriptions, note + that *info is the refentry info child (whatever its name), and + parentinfo is the info child of its parent (again, whatever its name).] + + extra1 field (date) + + Content of the extra1 field is what shows up in the center footer + position of each page. The man(7) man page describes it as the date + of the last revision. + + To provide this content, if the refentry.date.profile.enabled is + non-zero, the stylesheets check the value of refentry.date.profile. + + Otherwise, by default, they check for a date or pubdate not only in + the *info contents, but also in the parentinfo contents. + + If a date cannot be found, the stylesheets now automatically generate + a localized long format date, ensuring that this field always has + content in output. + + However, if for some reason you want to suppress this field, you can + do so by setting a non-zero value for man.th.extra1.suppress. + + extra2 field (source) + + On Linux systems and on systems with a modern groff, the content of + the extra2 field are what shows up in the left footer position of + each page. + + The man(7) man page describes this as the source of the command, and + provides the following examples: + + o For binaries, use somwething like: GNU, NET-2, SLS Distribution, + MCC Distribution. + + o For system calls, use the version of the kernel that you are + currently looking at: Linux 0.99.11. + + o For library calls, use the source of the function: GNU, BSD 4.3, + Linux DLL 4.4.1. + + In practice, there are many pages that simply have a version number in + the source field. So, it looks like what we have is a two-part + field, Name Version, where: + + Name + + product name (e.g., BSD) or org. name (e.g., GNU) + + Version + + version name + + Each part is optional. If the Name is a product name, then the Version + is probably the version of the product. Or there may be no Name, in + which case, if there is a Version, it is probably the version of the + item itself, not the product it is part of. Or, if the Name is an + organization name, then there probably will be no Version. + + To provide this content, if the refentry.source.name.profile.enabled + and refentry.version.profile.enabled parameter are non-zero, the + stylesheets check the value of refentry.source.name.profile + refentry.version.profile. + + Otherwise, by default, they check the following places, in the + following order: + + 1. *info/productnumber + + 2. *info/productnumber + + 3. refmeta/refmiscinfo[@class = 'version'] + + 4. parentinfo/productnumber + + 5. *info/productname + + 6. parentinfo/productname + + 7. refmeta/refmiscinfo + + 8. [nothing found, so leave it empty] + + extra3 field + + On Linux systems and on systems with a modern groff, the content of + the extra3 field are what shows up in the center header position of + each page. Some man pages have extra2 content, some don't. If a + particular man page has it, it is most often context data about some + larger system the documented item belongs to (for example, the name or + description of a group of related applications). The stylesheets now + check the following places, in the following order, to look for + content to add to the extra3 field. + + 1. parentinfo/title + + 2. parent's title + + 3. refmeta/refmiscinfo + + 4. [nothing found, so leave it empty] + + * Reworked *info gathering. For each refentry found, the stylesheets now + cache its *info content, then check for any valid parent of it that might + have metainfo content and cache that, if found; they then then do all + further matches against those node-sets (rather than re-selecting the + original *info nodes each time they are needed). + + * New option for breaking strings after forward slashes. This enables long + URLs and pathnames to be broken across lines. Controlled through + man.break.after.slash parameter. + + * Output for servicemark and trademark are now (SM) and (TM). There is a + groff "\(tm" escape, but output from that is not acceptable. + + * New option for controlling the length of the title part of the .TH title + line. Controlled through the man.th.title.max.length parameter. + + * New option for specifying output encoding of each man page; controlled + with man.output.encoding (similar to the HTML chunker.output.encoding + parameter). + + * New option for suppressing filename messages when generating output; + controlled with man.output.quietly (similar to the HTML chunk.quietly + parameter). + + * The text of cross-references to first-level refentry (refsect1, top-level + refsection, refnamediv, and refsynopsisdiv) are now capitalized. + + * Cross-references to refnamediv now use the localized NAME title instead of + using the first refname child. This makes the output inconsistent with + HTML and FO output, but for man-page output, it seems to make better sense + to have the NAME. (It may actually make better sense to do it that way in + HTML and FO output as well...) + + * Added support for processing funcparams. + + * Removed the space that was being output between funcdef and paramdef; + example: was: float rand (void); now: float rand(void) + + * Turned off bold formatting for the type element when it occurs within a + funcdef or paramdef + + * Corrected rendering of simplelist. Any + + + + + + + + Invoke Saxon with the encoding.windows-1252 Java system property set + to com.nwalsh.saxon.Windows1252; for example + + java \ + -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ + com.icl.saxon.StyleSheet \ + mydoc.xml mystylesheet.xsl + + Or, for a more complete "real world" case showing other options you'll + typically want to use: + + java \ + -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ + -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \ + -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \ + -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \ + com.icl.saxon.StyleSheet \ + -x org.apache.xml.resolver.tools.ResolvingXMLReader \ + -y org.apache.xml.resolver.tools.ResolvingXMLReader \ + -r org.apache.xml.resolver.tools.CatalogResolver \ + mydoc.xml mystylesheet.xsl + + In both cases, the "mystylesheet.xsl" file should be a DocBook + customization layer containing the parameters show in step 2. + + * Saxon extensions: Removed Saxon 8 extensions from release package + +Release 1.67.0 + + * A number of important bug fixes. + + * Added Saxon8 extensions + + * Enabled dbfo table-width on entrytbl in FO output + + * Added support for role=strong on emphasis in FO output + + * Added new FO parameter hyphenate.verbatim that can be used to turn on + "intelligent" wrapping of verbatim environments. + + * Replaced all output with + + * Changed admon.graphic.width template to a mode so that different + admonitions can have different graphical widths. + + * Deprecated the HTML shade.verbatim parameter (use CSS instead) + + * Wrapped ToC refentrytitle/refname and refpurpose in span with class + values. This makes it possible to style them using a CSS stylesheet. + + * Use strong/em instead of b/i in HTML output + + * Added support for converting Emphasis to groff italic and Emphasis + role='bold' to bold. Controlled by emphasis.propagates.style param, but + not documented yet using litprog system. Will do that next (planning to + add some other parameter-controllable options for hyphenation and handling + of line spacing). + + * callout.graphics.number.limit.xml param: Changed the default from 10 to + 15. + + * verbatim.properties: Added hyphenate=false + + * Saxon and Xalan Text.java extensions: Added support for URIResolver() on + insertfile href's + + * Added generated RELEASE-NOTES.txt file. + + * Added INSTALL file (executable file for generating catalog.xml) + + * Removed obsolete tools directory from package + +Release 1.66.1 + + * A number of important bug fixes. + + * Now xml:base attributes that are generated by an XInclude processor are + resolved for image files. + + * Rewrote olink templates to support several new features. + + o Extended full olink support to FO output. + + o Add support for xrefstyle attribute in olinks. + + o New parameters to support new olink features: insert.olink.page.number + , insert.olink.pdf.frag, olink.debug, olink.lang.fallback.sequence, + olink.properties, prefer.internal.olink. See the reference page for + each parameter for more information. + + * Added index.on.type parameter for new type attribute introduced in DocBook + 4.3 for indexterms and index. This allows you to create multiple indices + containing different categories of entries. For users of 4.2 and earlier, + you can use the new parameter index.on.role instead. + + * Added new section.autolabel.max.depth parameter to turn off section + numbering below a certain depth. This permits you to number major section + levels and leave minor section levels unnumbered. + + * Added footnote.sep.leader.properties attribute set to format the line + separating footnotes in printed output. + + * Added parameter img.src.path as a prefix to HTML img src attributes. The + prefix is added to whatever path is already generated by the stylesheet + for each image file. + + * Added new attribute-sets informalequation.properties, + informalexample.properties, informalfigure.properties, and + informaltable.properties, so each such element type can be formatted + individually if needed. + + * Add component.label.includes.part.label parameter to add any part number + to chapter, appendix and other component labels when the label.from.part + parameter is nonzero. This permits you to distinguish multiple chapters + with the same chapter number in cross references and the TOC. + + * Added chunk.separate.lots parameter for HTML output. This parameter lets + you generate separate chunk files for each LOT (list of tables, list of + figures, etc.). + + * Added several table features: + + o Added table.table.properties attribute set to add properties to the + fo:table element. + + o Added placeholder templates named table.cell.properties and + table.cell.block.properties to enable adding properties to any + fo:table-cell or the cell's fo:block, respectively. These templates + are a start for implementing table styles. + + * Added new attribute set component.title.properties for easy modifications + of component's title formatting in FO output. + + * Added Saxon support for an encoding attribute on the textdata element. + Added new parameter textdata.default.encoding which specifies encoding + when encoding attribute on textdata is missing. + + * Template label.this.section now controls whole section label, not only + sub-label which corresponds to particular label. Former behaviour was IMHO + bug as it was not usable. + + * Formatting in titleabbrev for TOC and headers is preserved when there are + no hotlink elements in the title. Formerly the title showed only the text + of the title, no font changes or other markup. + + * Added intial.page.number template to set the initial-page-number property + for page sequences in print output. Customizing this template lets you + change when page numbering restarts. This is similar to the + format.page.number template that lets you change how the page number + formatting changes in the output. + + * Added force.page.count template to set the force-page-count property for + page sequences in print output. This is similar to the format.page.number + template. + + * Sort language for localized index sorting in autoidx-ng.xsl is now taken + from document lang, not from system environment. + + * Numbering and formatting of normal and ulink footnotes (if turned on) has + been unified. Now ulink footnotes are mixed in with any other footnotes. + + * Added support for renderas attribute in section and sect1 et al. This + permits you to render a given section title as if it were a different + level. + + * Added support for label attribute in footnote to manually supply the + footnote mark. + + * Added support for DocBook 4.3 corpcredit element. + + * Added support for a dbfo keep-together PI for formal objects (table, + figure, example, equation, programlisting). That permits a formal object + to be kept together if it is not already, or to be broken if it is very + long and the default keep-together is not appropriate. + + * For graphics files, made file extension matching case insensitive, and + updated the list of graphics extensions. + + * Allow calloutlist to have block content before the first callout + + * Added dbfo-need processing instruction to provide soft page breaks. + + * Added implementation of existing but unused default.image.width parameter + for graphics. + + * Support DocBook NG tag inline element. + + * It appears that XEP now supports Unicode characters in bookmarks. There is + no further need to strip accents from characters. + + * Make segmentedlist HTML markup more semantic and available to CSS styles. + + * Added user.preroot placeholder template to permit xsl-stylesheet and other + PIs and comments to be output before the HTML root element. + + * Non-chunked legalnotice now gets an element in HTML output + so it can be referenced with xref or link. + + * In chunked HTML output, changed link rel="home" to rel="start", and link + rel="previous" to rel="prev", per W3C HTML 4.01 spec. + + * Added several patches to htmlhelp from W. Borgert + + * Added Bosnian locale file as common/bs.xml. + +Release 1.65.0 + + * A number of important bug fixes. + + * Added a workaround to allow these stylesheets to process DocBook NG + documents. (Its a hack that pre-processes the document to strip off the + namespace and then uses exsl:node-set to process the result.) + + * Added alternative indexing mechanism which has better internationalization + support. New indexing method allows grouping of accented letters like e, + , into the same group under letter "e". It can also treat special + letters (e.g. "ch") as one character and place them in the correct + position (e.g. between "h" and "i" in Czech language). + + In order to use this mechanism you must create customization layer which + imports some base stylesheet (like fo/docbook.xsl, html/chunk.xsl) and + then includes appropriate stylesheet with new indexing code + (fo/autoidx-ng.xsl or html/autoidx-ng.xsl). For example: + + + + + + + + + New method is known to work with Saxon and it should also work with + xsltproc 1.1.1 and later. Currently supported languages are English, + Czech, German, French, Spanish and Danish. + +Release 1.64.1 + +General bug fixes and improvements. Sorry about the failure to produce an +updated release notes file for 1.62.01.63.2 + + * In the course of fixing bug #849787, wrapping Unicode callouts with an + appropriate font change in the Xalan extensions, I discovered that the + Xalan APIs have changed a bit. So xalan2.jar will work with older Xalan 2 + implementations, xalan25.jar works with Xalan 2.5. + +Release 1.61.0 + +Lots of bug fixes and improvements. + + * Initial support for timestamp PI. From now you can use to get current datetime in your document. Added + localization support for datetime PI + + * Added level 6 to test for section depth in section.level template so that + section.title.level6.properties will be used for sections that are 6 deep + or deeper. This should also cause a h6 to be created in html output. + + * Don't use SVG graphics if use.svg=0 + + * Now uses number-and-title-template for sections only if section.autolabel + is not zero. + + * Added missing 'english-language-name' attribute to the l10n element, and + the missing 'style' attribute to the template element so the current + gentext documents will validate. + + * Corrected several references to parameter qanda.defaultlabel that were + missing the "$". + + * Now accepts admon.textlabel parameter to turn off Note, Warning, etc. + label. + + * FeatReq #684561: support more XEP metadata + + * Added hyphenation support. Added support for coref. Added beginpage + support. (does nothing; see TDG). + + * Added support for hyphenation-character, hyphenation-push-character-count, + and hyphenation-remain-character-count + + * Added root.properties, ebnf.assignment, and ebnf.statement.terminator + + * Support bgcolor PI in table cells; make sure rowsep and colsep don't have + any effect on the last row or column + + * Handle othercredit on titlepage a little better + + * Applied fix from Jeff Beal that fixed the bug that put secondary page + numbers on primary entries. Same with tertiary page numbers on secondary + entries. + + * Added definition of missing variable collection. + + * Make footnote formatting 'normal' even when it occurs in a context that + has special formatting + + * Added warning when glossary.collection is not blank, but it cannot open + the specified file. + + * Pick up the frame attribute on table and informaltable. + + * indexdiv/title in non-autogenerated indexes are now picked up. + + * Removed (unused) component.title.properties + + * Move IDs from page-sequences down to titlepage blocks + + * Use proportional-column-width(1) on more tables. + + Use proportional-column-width() for header/footer tables; suppress + relative-align when when using FOP + + * Check for glossterm.auto.link when linking firstterms; don't output gl. + prefix on glossterm links + + * Generate Part ToCs + + * Support glossary, bibliography, and index in component ToCs. + + * Refactored chunking code so that customization of chunk algorithm and + chunk elements is more practical + + * Support textobject/phrase on inlinemediaobject. + + * Support 'start' PI on ordered lists + + * Fixed test of $toc PI to turn on qandaset TOC. + + * Added process.chunk.footnotes to sect2 through 5 to fix bug of missing + footnotes when chunk level greater than 1. + + * Added paramater toc.max.depth which controls maximal depth of ToC as + requested by PHP-DOC group. + + * Exempted titleabbrev from preamble processing in lists, and fixed + variablelist preamble code to use the same syntax as the other lists. + + * Added support for elements between variablelist and first varlistentry + since DocBook 4.2 supports that now. + +Release 1.60.1 + +Lots of bug fixes. + + * The format of the titlepage.templates.xml files and the stylesheet that + transforms them have been significantly changed. All of the attributes + used to control the templates are now namespace qualified. So what used to + be: + + + + is now: + + + + Attributes from other namespaces (including those that are unqualified) + are now copied directly through. In practice, this means that the names + that used to be fo: qualified: + + + + are now unqualified: + + <title t:named-template="component.title" + param:node="ancestor-or-self::article[1]" + text-align="center" + keep-with-next="always" + font-size="&hsize5;" + font-weight="bold" + font-family="{$title.font.family}"/> + + The t:titlepage and t:titlepage-content elements both generate wrappers + now. And unqualified attributes on those elements are passed through. This + means that you can now make the title font apply to ane entire titlepage + and make the entire recto titlepage centered by specifying the font and + alignment on the those elements: + + <t:titlepage t:element="article" t:wrapper="fo:block" + font-family="{$title.font.family}"> + + <t:titlepage-content t:side="recto" + text-align="center"> + + * Support use of titleabbrev in running headers and footers. + + * Added (experimental) xref.with.number.and.title parameter to enable + number/title cross references even when the default would be just the + number. + + * Generate part ToCs if they're requested. + + * Use proportional-column-width() in header/footer tables. + + * Handle alignment correctly when screenshot wraps a graphic in a figure. + + * Format chapter and appendix cross references consistently. + + * Attempt to support tables with multiple tgroups in FO. + + * Output fo:table-columns in simplelist tables. + + * Use titlepage.templates.xml for indexdiv and glossdiv formatting. + + * Improve support for new bibliography elements. + + * Added footnote.number.format, table.footnote.number.format, + footnote.number.symbols, and table.footnote.number.symbols for better + control of footnote markers. + + * Added glossentry.show.acronyms. + + * Suppress the draft-mode page masters when draft-mode is no. + + * Make blank pages verso not recto. D'Oh! + + * Improved formatting of ulink footnotes. + + * Fixed bugs in graphic width/height calculations. + + * Added class attributes to inline elements. + + * Don't add .html to the filenames identified with the dbhtml PI. + + * Don't force a ToC when sections contain refentrys. + + * Make section title sizes a function of the body.master.size. + +Release 1.59.2 + +The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail. + + * Removed the region-name from the region-body of blank pages. There's no + reason to give the body of blank pages a unique name and doing so causes a + mismatch that FOP detects. + + * Output IDs for the first paragraphs in listitems. + + * Fixed some small bugs in the handling of page numbers in double-sided + mode. + + * Attempt to prevent duplicated IDs from being produced when endterm on xref + points to something with nested structure. + + * Fix aligment problems in equations. + + * Output the type attribute on unordered lists (UL) in HTML only if the + css.decoration parameter is true. + + * Calculate the font size in formal.title.properties so that it's 1.2 times + the base font size, not a fixed "12pt". + +Release 1.59.1 + +The 1.59.1 fixes a few bugs. + + * Added Bulgarian localization. + + * Indexing improvements; localize book indexes to books but allow setindex + to index an entire set. + + * The default value for rowsep and colsep is now "1" as per CALS. + + * Added support for titleabbrev (use them for cross references). + + * Improvements to mediaobject for selecting print vs. online images. + + * Added seperate property sets for figures, examples, equations, tabless, + and procedures. + + * Make lineannotations italic. + + * Support xrefstyle attribute. + + * Make endterm on xref higher priority than xreflabel target. + + * Glossary formatting improvements. + +Release 1.58.0 + +The 1.58.0 adds some initial support for extensions in xsltproc, adds a few +features, and fixes bugs. + + * This release contains the first attempt at extension support for xsltproc. + The only extension available to date is the one that adjusts table column + widths. Run extensions/xsltproc/python/xslt.py. + + * Fixed bugs in calculation of adjusted column widths to correct for + rounding errors. + + * Support nested refsection elements correctly. + + * Reworked gentext.template to take context into consideration. The name of + elements in localization files is now an xpath-like context list, not just + a simple name. + + * Made some improvements to bibliography formatting. + + * Improved graphical formatting of admonitions. + + * Added support for entrytbl. + + * Support spanning index terms. + + * Support bibliosource. + +Release 1.57.0 + + * The 1.57.0 release wasn't documented here. Oops. + +Release 1.56.0 + +The 1.56.0 release fixes bugs. + + * Reworked chunking. This will break all existing customizations layers that + change the chunking algorithm. If you're customizing chunking, look at the + new content parameter that's passed to process-chunk-element and + friends. + + * Support continued and inherited numeration in orderedlist formatting for + FOs. + + * Added Thai localization. + + * Tweaked stylesheet documentation stylesheets to link to TDG and the + parameter references. + + * Allow title on tables of contents ("Table of Contents") to be optional. + Added new keyword to generate.toc. Support tables of contents on sections. + + * Made separate parameters for table borders and table cell borders: + table.frame.border.color, table.frame.border.style, + table.frame.border.thickness, table.cell.border.color, + table.cell.border.style, and table.cell.border.thickness. + + * Suppress formatting of endofrange indexterms. This is only half-right. + They should generate a range, but I haven't figured out how to do that + yet. + + * Support revdescription. (Bug #582192) + + * Added default.float.class and fixed figure floats. (Bug #497603) + + * Fixed formatting of sbr in FOs. + + * Added context to the missing template error message. + + * Process arg correctly in a group. (Bug #605150) + + * Removed 'keep-with-next' from formal.title.properties attribute set now + that the stylesheets support the option of putting such titles below the + object. Now the $placement value determines if 'keep-with-next' or + 'keep-with-previous' is used in the title block. + + * Wrap url() around external-destinations when appropriate. + + * Fixed typo in compact list spacing. (Bug #615464) + + * Removed spurious hash in anchor name. (Bug #617717) + + * Address is now displayed verbatim on title pages. (Bug #618600) + + * The bridgehead.in.toc parameter is now properly supported. + + * Improved effectiveness of HTML cleanup by increasing the number of places + where it is used. Improve use of HTML cleanup in XHTML stylesheets. + + * Support table of contents for appendix in article. (Bug #596599) + + * Don't duplicate footnotes in bibliographys and glossarys. (Bug #583282) + + * Added default.image.width. (Bug #516859) + + * Totally reworked funcsynopsis code; it now supports a 'tabular' + presentation style for 'wide' prototypes; see + funcsynopsis.tabular.threshold. (HTML only right now, I think, FO support, + uh, real soon now.) + + * Reworked support for difference marking; toned down the colors a bit and + added a system.head.content template so that the diff CSS wasn't + overriding user.head.content. (Bug #610660) + + * Added call to the *.head.content elements when writing out long + description chunks. + + * Make sure legalnotice link is correct even when chunking to a different + base.dir. + + * Use CSS to set viewport characteristics if css.decoration is non-zero, use + div instead of p for making graphic a block element; make figure titles + the default alt text for images in a figure. + + * Added space-after to list.block.spacing. + + * Reworked section.level template to give correct answer instead of being + off by one. + + * When processing tables, use the tabstyle attribute as the division class. + + * Fixed bug in html2xhtml.xsl that was causing the XHTML chunker to output + HTML instead of XHTML. + +Older releases + +To view the release notes for older releases, see +http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml. Be aware +that there were no release notes for releases prior to the 1.50.0 release. + +About dot-zero releases + +DocBook Project dot zero releases should be considered experimental and are +always followed by stable dot one releases, usually within two or three +weeks. Please help to ensure the stability of dot one releases by carefully +testing each dot zero release and reporting back about any problems you +find. + +It is not recommended that you use a dot zero release in a production +system, or package it for an OS distro. Instead, you should wait for the dot +one version. + + diff --git a/src/documentation/docbook-xsl/RELEASE-NOTES.xml b/src/documentation/docbook-xsl/RELEASE-NOTES.xml new file mode 100644 index 0000000000..bb95d4ae4d --- /dev/null +++ b/src/documentation/docbook-xsl/RELEASE-NOTES.xml @@ -0,0 +1,4588 @@ +<article xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns:xi="http://www.w3.org/2001/XInclude" + xml:lang="en" xml:id="releasenotes" + version="5.0"> +<info> + <title>Release Notes + DocBook Project XSL Stylesheets + + $Revision: 1.51 $ $Date: 2006/05/24 14:39:48 $ + DocBook Project Development Team + + +These are the release notes for the DocBook XSL Stylesheets +distribution. This document lists enhancements and changes to the +public APIs (user-configurable parameters) and generally excludes +descriptions of bug fixes, which are instead documented in a +separate file. + + +Release: 1.70.1 + +This is a stable release of the 1.70 stylesheets. It includes only a +few small changes from 1.70.0. + +The following is a list of changes that have been made + since the 1.70.0 release. + + +FO +The following changes have been made to the + fo code + since the 1.70.0 release. + + +Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output. +Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek + + +Support DBv5 revisions with full author name (not only authorinitials) +Modified: fo/block.xsl,1.33; fo/titlepage.xsl,1.40 - Jirka Kosek + + + + + +HTML +The following changes have been made to the + html code + since the 1.70.0 release. + + +Support DBv5 revisions with full author name (not only authorinitials) +Modified: html/block.xsl,1.23; html/titlepage.xsl,1.34 - Jirka Kosek + + + + + +HTMLHelp +The following changes have been made to the + htmlhelp code + since the 1.70.0 release. + + +htmlhelp.generate.index is now param, not variable. This means that you can override its setting from outside. This is useful when you generate indexterms on the fly (see http://www.xml.com/pub/a/2004/07/14/dbndx.html?page=3). +Modified: htmlhelp/htmlhelp-common.xsl,1.38 - Jirka Kosek + + +Support chunk.tocs.and.lots in HTML Help +Modified: htmlhelp/htmlhelp-common.xsl,1.37 - Jirka Kosek + + + + + +Params +The following changes have been made to the + params code + since the 1.70.0 release. + + +Added three new attribute sets (revhistory.title.properties, revhistory.table.properties and revhistory.table.cell.properties) for controlling appearance of revhistory in FO output. +Modified: fo/block.xsl,1.34; fo/param.ent,1.101; fo/param.xweb,1.114; fo/titlepage.xsl,1.41; params/revhistory.table.cell.properties.xml,1.1; params/revhistory.table.properties.xml,1.1; params/revhistory.title.properties.xml,1.1 - Jirka Kosek + + + + + + + +Release: 1.70.0 +As with all DocBook Project dot-zero +releases, this is an experimental release. It will be followed shortly +by a stable release. + +This release adds a number of new features, +including: + + + + support for selecting alternative index-collation methods + (in particular, support for using a collation library developed by + Eliot Kimber) + + + improved handling of DocBook 5 document instances (through a + namespace-stripping mechanism) + + + full support for CALS and HTML tables in manpages + output + + + a mechanism for preserving relative URIs in documents that + make use of XInclude + + + support for the "new" .90 version of + FOP + + + enhanced capabilities for controlling formatting of lists in HTML + and FO output + + + autogeneration of AUTHOR and COPYRIGHT sections in manpages + output + + + support for generating crop marks in FO/PDF output + + + support for qandaset as a root element in FO output + + + support for floatstyle and orient on all table types + + + support for floatstyle in figure, and example + + + pgwide.properties attribute-set supports extending figure, + example and table into the left indent area instead of spanning + multiple columns. + + + The following is a detailed list of enhancements and API + changes that have been made since the 1.69.1 release. + + +Common +The following changes have been made to the + common code + since the 1.69.1 release. + + +Add the xsl:key for the kimber +indexing method. +Modified: common/autoidx-ng.xsl,1.2 - Robert +Stayton + + +Add support for +qandaset. +Modified: common/labels.xsl,1.37; +common/subtitles.xsl,1.7; common/titles.xsl,1.35 - Robert +Stayton + + +Support dbhtml/dbfo start PI for +orderedlist numbering in both HTML and +FO +Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman +Walsh + + +Added CVS +header. +Modified: common/stripns.xsl,1.12 - Robert +Stayton + + +Changed content model of text +element to ANY rather than #PCDATA because they could contain +markup. +Modified: common/targetdatabase.dtd,1.7 - Robert +Stayton + + +Added +refentry.meta.get.quietly param. +If zero (the +default), notes and warnings about "missing" markup are generated +during gathering of refentry metadata. If +non-zero, the metadata is gathered "quietly" -- that is, the +notes and warnings are suppressed. +NOTE: If you are +processing a large amount of refentry content, you +may be able to speed up processing significantly by setting a +non-zero value for +refentry.meta.get.quietly. +Modified: common/refentry.xsl,1.17; +manpages/param.ent,1.15; manpages/param.xweb,1.17; +params/refentry.meta.get.quietly.xml,1.1 - Michael(tm) +Smith + + +After namespace stripping, the +source document is the temporary tree created by the stripping +process and it has the wrong base URI for relative +references. Earlier versions of this code used to try to fix that +by patching the elements with relative @fileref attributes. That +was inadequate because it calculated an absolute base URI +without considering that there might be xml:base attributes +already in effect. It seems obvious now that the right thing to +do is simply to put the xml:base on the root of the document. And +that seems to work. +Modified: common/stripns.xsl,1.7 - Norman +Walsh + + +Added support for "software" and +"sectdesc" class values on refmiscinfo; "software" is +treated identically to "source", and "setdesc" is treated +identically to "manual". +Modified: common/refentry.xsl,1.10; +params/man.th.extra2.max.length.xml,1.3; +params/refentry.source.name.profile.xml,1.4 - Michael(tm) +Smith + + +Added support for DocBook 5 +namespace-stripping in manpages stylesheet. Closes request +#1210692. +Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - +Michael(tm) Smith + + +Added <xsl:template +match="/"> to make stripns.xsl usable as a standalone +stylesheet for stripping out DocBook 5/NG to DocBook 4. Note that +DocBook XSLT drivers that include this stylesheet all override +the match="/" template. +Modified: common/stripns.xsl,1.4 - Michael(tm) +Smith + + +Number figures, examples, and +tables from book if there is no prefix (i.e. if +chapter.autolabel is set to 0). This avoids +having the list of figures where the figures mysteriously restart +their numeration periodically when +chapter.autolabel is set to +0. +Modified: common/labels.xsl,1.36 - David Cramer + + +Add task template in +title.markup mode. +Modified: common/titles.xsl,1.34 - Robert +Stayton + + +Add children (with ids) of formal +objects to target data. +Modified: common/targets.xsl,1.10 - Robert +Stayton + + +Added support for case when +personname doesn't contain specific name markup (as allowed +in DocBook 5.0) +Modified: common/common.xsl,1.54 - Jirka +Kosek + + + + + +Extensions +The following changes have been made to the + extensions code + since the 1.69.1 release. + + +Support Xalan +2.7 +Modified: extensions/xalan27/.cvsignore,1.1; +extensions/xalan27/build.xml,1.1; +extensions/xalan27/nbproject/.cvsignore,1.1; +extensions/xalan27/nbproject/build-impl.xml,1.1; +extensions/xalan27/nbproject/genfiles.properties,1.1; +extensions/xalan27/nbproject/project.properties,1.1; +extensions/xalan27/nbproject/project.xml,1.1; +extensions/xalan27/src/com/nwalsh/xalan/CVS.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Callout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Func.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Params.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Table.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Text.java,1.1; +extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java,1.1 - Norman +Walsh + + +Handle the case where the imageFn +is actually a URI. This still needs +work. +Modified: extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java,1.4 +- Norman Walsh + + + + + +FO +The following changes have been made to the + fo code + since the 1.69.1 release. + + +Adapted to the new indexing +code. Now works just like a wrapper that calls kosek indexing method, +originally implemented here. +Modified: fo/autoidx-ng.xsl,1.5 - Jirka +Kosek + + +Added parameters for header/footer +table minimum height. +Modified: fo/pagesetup.xsl,1.60; +fo/param.ent,1.100; fo/param.xweb,1.113 - Robert +Stayton + + +Add the index.method +parameter. +Modified: fo/param.ent,1.99; fo/param.xweb,1.112 - Robert +Stayton + + +Integrate support for three +indexing methods: - the original English-only method. - +Jirka Kosek's method using EXSLT extensions. - Eliot Kimber's +method using Saxon extensions. Use the 'index.method' +parameter to select. +Modified: fo/autoidx.xsl,1.38 - Robert +Stayton + + +Add support for TOC for +qandaset in fo output. +Modified: fo/autotoc.xsl,1.30; +fo/qandaset.xsl,1.20 - Robert Stayton + + +Added parameter +ulink.hyphenate.chars. Added parameter +insert.link.page.number. +Modified: fo/param.ent,1.98; +fo/param.xweb,1.111 - Robert Stayton + + +Implemented feature request +#942524 to add insert.link.page.number to allow link +element cross references to have a page number. +Modified: fo/xref.xsl,1.67 - +Robert Stayton + + +Add support for +ulink.hyphenate.chars so more characters +can be break points in urls. +Modified: fo/xref.xsl,1.66 - Robert +Stayton + + +Implemented patch #1075144 to make +the url text in a ulink in FO output an active link as +well. +Modified: fo/xref.xsl,1.65 - Robert Stayton + + +table footnotes now +have their own table.footnote.properties +attribute set. +Modified: fo/footnote.xsl,1.23 - Robert +Stayton + + +Add qandaset to +root.elements. +Modified: fo/docbook.xsl,1.41 - Robert +Stayton + + +Added mode="page.sequence" to make +it easier to put content into a page sequence. First used for +qandaset. +Modified: fo/component.xsl,1.37 - Robert +Stayton + + +Implemented feature request +#1434408 to support formatting +of biblioentry. +Modified: fo/biblio.xsl,1.35 - Robert +Stayton + + +Added +biblioentry.properties. +Modified: fo/param.ent,1.97; +fo/param.xweb,1.110 - Robert Stayton + + +Support PTC/Arbortext +bookmarks +Modified: fo/docbook.xsl,1.40; fo/ptc.xsl,1.1 - Norman +Walsh + + +Added +table.footnote.properties to permit +table footnotes to format differently from regular +footnotes. +Modified: fo/param.ent,1.96; fo/param.xweb,1.109 - Robert +Stayton + + +Refactored table +templates to unify their processing and support all options in +all types. Now table and informaltable, in +both Cals and Html markup, use the same templates where possible, +and all support pgwide, rotation, and floats. There is also a +placeholder table.container template to +support wrapping a table in a layout table, +so the XEP table title "continued" +extension can be more easily implemented. +Modified: fo/formal.xsl,1.52; +fo/htmltbl.xsl,1.9; fo/table.xsl,1.48 - Robert +Stayton + + +Added new attribute set +toc.line.properties for controlling appearance of lines in +ToC/LoT +Modified: fo/autotoc.xsl,1.29; fo/param.ent,1.95; +fo/param.xweb,1.108 - Jirka Kosek + + +Added support for float to example +and equation. Added support for pgwide to +figure, example, and equation (the latter +two via a dbfo pgwide="1" processing +instruction). +Modified: fo/formal.xsl,1.51 - Robert +Stayton + + +Add pgwide.properties +attribute-set. +Modified: fo/param.ent,1.94; fo/param.xweb,1.107 - Robert +Stayton + + +Added refclass.suppress +param. +If the value of refclass.suppress is +non-zero, then display refclass contents is suppressed +in output. Affects HTML and FO output +only. +Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; +html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) +Smith + + +Improved support for +task subelements +Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - +Jirka Kosek + + +Adjusted spacing around +K&R-formatted Funcdef and Paramdef +output such that it can more easily be discerned where one ends +and the other begins. Closes #1213264. +Modified: fo/synop.xsl,1.18 - +Michael(tm) Smith + + +Made handling of +paramdef/parameter in FO output consistent with that in HTML and +manpages output. Closes #1213259. +Modified: fo/synop.xsl,1.17 - Michael(tm) +Smith + + +Made handling of +Refnamediv consistent with formatting in HTML +and manpages output; specifically, changed so that +Refname (comma-separated list of multiple instances +found) is used (instead of Refentrytitle as +previously), then em-dash, then the Refpurpose. Closes +#1212562. +Modified: fo/refentry.xsl,1.30 - Michael(tm) +Smith + + +Added output of +Releaseinfo to recto titlepage ("copyright" +page) for Book in FO output. This makes it consistent +with HTML output. Closes #1327034. Thanks to Paul DuBois for +reporting. +Modified: fo/titlepage.templates.xml,1.28 - Michael(tm) +Smith + + +Added condition for setting +block-progression-dimension.minimum on table-row, instead of +height, when fop1.extensions is +non-zero. For an explanation of the reason for the change, +see: http://wiki.apache.org/xmlgraphics-fop/Troubleshooting/CommonLogMessages +Modified: fo/pagesetup.xsl,1.59 +- Michael(tm) Smith + + +Added new +refclass.suppress param for suppressing display +of Refclass in HTML and FO output. Did not add it to +manpages because manpages stylesheet is currently just silently +ignoring Refclass anyway. Closes request +#1461065. Thanks to Davor Ocelic (docelic) for +reporting. +Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - +Michael(tm) Smith + + +Add support for keep-together PI +to informal objects. +Modified: fo/formal.xsl,1.50 - Robert +Stayton + + +Add support for +fop1.extensions. +Modified: fo/formal.xsl,1.49; +fo/graphics.xsl,1.44; fo/table.xsl,1.47 - Robert +Stayton + + +Add support for fop1 +bookmarks. +Modified: fo/docbook.xsl,1.39 - Robert +Stayton + + +Add fop1.extentions parameter to +add support for fop development version. +Modified: fo/param.ent,1.92; +fo/param.xweb,1.105 - Robert Stayton + + +Start supporting fop development +version, which will become fop version 1. +Modified: fo/fop1.xsl,1.1 - +Robert Stayton + + +Add template for task +in mode="xref-to". +Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert +Stayton + + +table footnotes now +also get footnote.properties +attribute-set. +Modified: fo/footnote.xsl,1.22 - Robert +Stayton + + +Added index.separator +named template to compute the separator punctuation based on +locale. +Modified: fo/autoidx.xsl,1.36 - Robert Stayton + + +Added support for link, +olink, and xref within OO +Classsynopsis and children. (Because DocBook NG/5 +allows it). +Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) +Smith + + +Support date as an +inline +Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman +Walsh + + +Added new parameter +keep.relative.image.uris +Modified: fo/param.ent,1.91; +fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96; +params/keep.relative.image.uris.xml,1.1 - Norman +Walsh + + +Map Unicode space characters +U+2000-U+200A to fo:leaders. +Modified: fo/docbook.xsl,1.38; +fo/passivetex.xsl,1.4; fo/spaces.xsl,1.1 - Jirka +Kosek + + +Output a real em dash for em-dash +dingbat (instead of two hypens). +Modified: fo/fo.xsl,1.7 - Michael(tm) +Smith + + +Support default label +width parameters for itemized and ordered lists +Modified: fo/lists.xsl,1.64; +fo/param.ent,1.90; fo/param.xweb,1.103; +params/itemizedlist.label.width.xml,1.1; +params/orderedlist.label.width.xml,1.1 - Norman +Walsh + + +Generate localized +title for Refsynopsisdiv if no +appropriate Title descendant found in source. Closes +#1212398. This change makes behavior for the Synopsis +title consistent with the behavior of HTML and +manpages output. +Also, added +xsl:use-attribute-sets="normal.para.spacing" to +block generated for Cmdsynopsis output. Previously, +that block had no spacing at all specified, which resulted it +being crammed up to closely to the Synopsis +head. +Modified: fo/refentry.xsl,1.28; fo/synop.xsl,1.13 - Michael(tm) +Smith + + +Added parameters to support +localization of index +item punctuation. +Modified: fo/autoidx.xsl,1.35 - Robert +Stayton + + +Added +index.number.separator, +index.range.separator, +and index.term.separator parameters to +support localization of punctuation in index +entries. +Modified: fo/param.ent,1.89; fo/param.xweb,1.102 - Robert +Stayton + + +Added "Cross References" +section in HTML doc (for consistency with the FO +doc). Also, moved the existing FO "Cross +References" section to follow the "Linking" +section. +Modified: fo/param.xweb,1.101; html/param.xweb,1.95 - +Michael(tm) Smith + + +Added ID attribues to all +Reference elements (e.g., id="tables" for the doc for +section on Table params). So pages for +all subsections of ref docs now have stable filenames instead +of arbitrary generated filenames. +Modified: fo/param.xweb,1.100; +html/param.xweb,1.94 - Michael(tm) Smith + + +Added two new parameters for +handling of multi-term +varlistentry elements: +variablelist.term.break.after: +When the variablelist.term.break.after is +non-zero, it will generate a line break after each +term multi-term +varlistentry. +variablelist.term.separator: +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is +placed after each term except the last. The default +is ", " (a comma followed by a space). To suppress rendering of +the separator, set the value of +variablelist.term.separator to the empty +string (""). +These parameters are primarily intended to be +useful if you have multi-term varlistentries that have long +terms. +Closes #1306676. Thanks to Sam Steingold for +providing an example "lots of long terms" doc that demonstrated +the value of having these options. +Also, added +normalize-space() call to processing of each +term. +This change affects all output formats +(HTML, PDF, manpages). The default behavior should pretty much +remain the same as before, but it is possible (as always) that +the change may introduce some +new bugginess. +Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; +fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; +html/param.xweb,1.93; manpages/lists.xsl,1.22; +manpages/param.ent,1.14; manpages/param.xweb,1.16; +params/variablelist.term.break.after.xml,1.1; +params/variablelist.term.separator.xml,1.1 - Michael(tm) +Smith + + +Add sidebar titlepage +placeholder attset for styles. +Modified: fo/titlepage.xsl,1.37 - Robert +Stayton + + +Add titlepage for +sidebar. +Modified: fo/titlepage.templates.xml,1.27 - Robert +Stayton + + +Implemented RFE +#1292615. +Added bunch of new parameters (attribute sets) +that affect list presentation: list.block.properties, +itemizedlist.properties, orderedlist.properties, +itemizedlist.label.properties and +orderedlist.label.properties. Default behaviour +of stylesheets has not been changed but further customizations will be +much more easier. +Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; +fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1; +params/itemizedlist.properties.xml,1.1; +params/list.block.properties.xml,1.1; +params/orderedlist.label.properties.xml,1.1; +params/orderedlist.properties.xml,1.1 - Jirka +Kosek + + +Implemented RFE +#1242092. +You can enable crop marks in your document by +setting crop.marks=1 and xep.extensions=1. Appearance of crop +marks can be controlled by parameters +crop.mark.bleed (6pt), +crop.mark.offset (24pt) and +crop.mark.width (0.5pt). +Also there +is new named template called user-xep-pis. You can overwrite it in +order to produce some PIs that can control XEP as described in +http://www.renderx.com/reference.html#Output_Formats +Modified: fo/docbook.xsl,1.36; +fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23; +params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1; +params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka +Kosek + + + + + +HTML +The following changes have been made to the + html code + since the 1.69.1 release. + + +implemented +index.method parameter and three +methods. +Modified: html/autoidx.xsl,1.28 - Robert +Stayton + + +added index.method +parameter to support 3 indexing methods. +Modified: html/param.ent,1.94; +html/param.xweb,1.103 - Robert Stayton + + +Implemented feature request +#1072510 as a processing instruction to permit including external +HTML content into HTML output. +Modified: html/pi.xsl,1.9 - Robert +Stayton + + +Added new parameter +chunk.tocs.and.lots.has.title which +controls presence of title in a separate chunk with +ToC/LoT. Disabling title can be very useful if you are +generating frameset output (well, yes those frames, but some customers +really want them ;-). +Modified: html/chunk-code.xsl,1.15; +html/param.ent,1.93; html/param.xweb,1.102; +params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka +Kosek + + +Support dbhtml/dbfo start PI for +orderedlist numbering in both HTML and +FO +Modified: common/common.xsl,1.61; html/lists.xsl,1.50 - Norman +Walsh + + +Allow ToC without +title also for set and +book. +Modified: html/autotoc.xsl,1.37; html/division.xsl,1.12 - +Jirka Kosek + + +Implemented floats uniformly for +figure, example, equation +and informalfigure, informalexample, and +informalequation. +Modified: html/formal.xsl,1.22 - Robert +Stayton + + +Added the +autotoc.label.in.hyperlink param. +If the value +of autotoc.label.in.hyperlink is non-zero, labels +are included in hyperlinked titles in the TOC. If it +is instead zero, labels are still displayed prior to the +hyperlinked titles, but are not hyperlinked along with the +titles. +Closes patch #1065868. Thanks to anatoly techtonik +for the patch. +Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; +html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - +Michael(tm) Smith + + +Added two new params: +html.head.legalnotice.link.types +and html.head.legalnotice.link.multiple. +If +the value of the generate.legalnotice.link is +non-zero, then the stylesheet generates (in the head +section of the HTML source) either a single HTML +link element or, if the value of +the html.head.legalnotice.link.multiple is +non-zero, one link element for each link +type specified. Each link has the +following attributes: + - a rel attribute whose value +is derived from the value of +html.head.legalnotice.link.types + - +an href attribute whose value is set to the URL of the file +containing the legalnotice + - a title +attribute whose value is set to the title of the +corresponding legalnotice (or a title +programatically determined by the stylesheet) +For +example: + <link rel="copyright" +href="ln-id2524073.html" title="Legal Notice"> +Closes +#1476450. Thanks to Sam Steingold. +Modified: html/chunk-common.xsl,1.45; +html/param.ent,1.91; html/param.xweb,1.100; +params/generate.legalnotice.link.xml,1.4; +params/html.head.legalnotice.link.multiple.xml,1.1; +params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm) +Smith + + +Added refclass.suppress +param. +If the value of refclass.suppress is +non-zero, then display refclass contents is suppressed +in output. Affects HTML and FO output +only. +Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; +html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) +Smith + + +Improved support for +task subelements +Modified: fo/task.xsl,1.3; html/task.xsl,1.3 - +Jirka Kosek + + +Added new +refclass.suppress param for suppressing display +of Refclass in HTML and FO output. Did not add it to +manpages because manpages stylesheet is currently just silently +ignoring Refclass anyway. Closes request +#1461065. Thanks to Davor Ocelic (docelic) for +reporting. +Modified: fo/refentry.xsl,1.29; html/refentry.xsl,1.23 - +Michael(tm) Smith + + +Process alt text with +normalize-space(). Replace tab indents with +spaces. +Modified: html/graphics.xsl,1.57 - Robert +Stayton + + +Content of citation +element is automatically linked to the bibliographic entry +with the corresponding abbrev. +Modified: html/biblio.xsl,1.26; +html/inline.xsl,1.47; html/xref.xsl,1.58 - Jirka +Kosek + + +Add template for task +in mode="xref-to". +Modified: fo/xref.xsl,1.63; html/xref.xsl,1.57 - Robert +Stayton + + +Suppress ID warnings if the +.warnings parameter is 0 +Modified: html/html.xsl,1.17 - Norman +Walsh + + +Add support for floatstyle to +figure. +Modified: html/formal.xsl,1.21 - Robert +Stayton + + +Handling of xref to +area/areaset need support in extensions code also. I currently have no +time to touch extensions code, so code is here to be enabled when +extension is fixed also. +Modified: html/xref.xsl,1.56 - Jirka +Kosek + + +Added 3 parameters for overriding +gentext for index +punctuation. +Modified: html/param.ent,1.89; html/param.xweb,1.98 - Robert +Stayton + + +Added parameters to support +localization of index item punctuation. Added +index.separator named template to compute +the separator punctuation based on +locale. +Modified: html/autoidx.xsl,1.27 - Robert +Stayton + + +Added a <div +class="{$class}-contents"> wrapper around output of contents +of all formal objects. Also, added an optional <br +class="{class}-break"/> linebreak after all formal +objects. +WARNING: Because this change places an additional +DIV between the DIV wrapper for the equation and the +equation contents, it may break some existing CSS +stylesheets that have been created with the assumption that there +would never be an intervening DIV there. +The following is +an example of what Equation output looks like as a +result of the changes described above. + <div +class="equation"> <a name="three" +id="three"></a> + <p +class="title"><b>(1.3)</b></p> + +<div class="equation-contents"> <span +class="mathphrase">1+1=3</span> +</div> </div><br +class="equation-break"> +Rationale: These changes allow +CSS control of the placement of the formal-object +title relative to the formal-object +contents. For example, using the CSS "float" property +enables the title and contents to be rendered on the +same line. Example stylesheet: + .equation +{ margin-top: 20px; margin-bottom: 20px; } +.equation-contents { float: left; } + +.equation .title { margin-top: 0; +float: right; margin-right: 200px; } + +.equation .title b { font-weight: +normal; } + .equation-break { clear: both; +} +Note that the purpose of the ".equation-break" class is +to provide a way to clear off the floats. +If you want +to instead have the equation title rendered to +the left of the equation contents, you can do +something like this: + .equation { +margin-top: 20px; width: 300px; margin-bottom: 20px; +} .equation-contents { float: right; } + +.equation .title { margin-top: 0; +float: left; margin-right: 200px; } + +.equation .title b { font-weight: +normal; } + .equation-break { clear: both; +} +Modified: html/formal.xsl,1.20 - Michael(tm) Smith + + +Added a chunker.output.quiet +top-level parameter so that the chunker can be made quiet by +default +Modified: html/chunker.xsl,1.26 - Norman Walsh + + +Added support for link, +olink, and xref within OO +Classsynopsis and children. (Because DocBook NG/5 +allows it). +Modified: fo/synop.xsl,1.15; html/synop.xsl,1.19 - Michael(tm) +Smith + + +New parameter: +id.warnings. If non-zero, warnings are +generated for titled objects that don't have titles. True by default; +I wonder if this will be too aggressive? +Modified: html/biblio.xsl,1.25; +html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19; +html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16; +html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22; +html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman +Walsh + + +If the +keep.relative.image.uris parameter is true, +don't use the absolute URI (as calculated from xml:base) in +the img src attribute, us the value the author +specified. Note that we still have to calculate the absolute +filename for use in the image intrinsics +extension. +Modified: html/graphics.xsl,1.56 - Norman +Walsh + + +Support date as an +inline +Modified: fo/inline.xsl,1.43; html/inline.xsl,1.46 - Norman +Walsh + + +Added new parameter +keep.relative.image.uris +Modified: fo/param.ent,1.91; +fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96; +params/keep.relative.image.uris.xml,1.1 - Norman +Walsh + + +Added two new parameters for +handling of multi-term +varlistentry elements: +variablelist.term.break.after: +When the variablelist.term.break.after is +non-zero, it will generate a line break after each +term multi-term +varlistentry. +variablelist.term.separator: +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is +placed after each term except the last. The default +is ", " (a comma followed by a space). To suppress rendering of +the separator, set the value of +variablelist.term.separator to the empty +string (""). +These parameters are primarily intended to be +useful if you have multi-term varlistentries that have long +terms. +Closes #1306676. Thanks to Sam Steingold for +providing an example "lots of long terms" doc that demonstrated +the value of having these options. +Also, added +normalize-space() call to processing of each +term. +This change affects all output formats +(HTML, PDF, manpages). The default behavior should pretty much +remain the same as before, but it is possible (as always) that +the change may introduce some +new bugginess. +Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; +fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; +html/param.xweb,1.93; manpages/lists.xsl,1.22; +manpages/param.ent,1.14; manpages/param.xweb,1.16; +params/variablelist.term.break.after.xml,1.1; +params/variablelist.term.separator.xml,1.1 - Michael(tm) +Smith + + +Added "wrapper-name" param to +inline.charseq named template, enabling it to output inlines +other than just "span". Acronym and Abbrev +templates now use inline.charseq to output HTML +"acronym" and "abbr" elements (instead of +"span"). Closes #1305468. Thanks to Sam Steingold for suggesting +the change. +Modified: html/inline.xsl,1.45 - Michael(tm) +Smith + + + + + +Manpages +The following changes have been made to the + manpages code + since the 1.69.1 release. + + +Added the following +params: + - man.indent.width (string-valued) - +man.indent.refsect (boolean) - man.indent.blurbs (boolean) +- man.indent.lists (boolean) - man.indent.verbatims +(boolean) +Note that in earlier snapshots, man.indent.width +was named man.indentation.default.value and the boolean params +had names like man.indentation.*.adjust. Also the +man.indent.blurbs param was called man.indentation.authors.adjust +(or something). +The behavior now is: If the value of a +particular man.indent.* boolean param is non-zero, the +corresponding contents (refsect*, list items, +authorblurb/personblurb, vervatims) are displayed with a left +margin indented by a width equal to the value +of man.indent.width. +Modified: params/man.indent.blurbs.xml,1.1; +manpages/docbook.xsl,1.74; manpages/info.xsl,1.20; +manpages/lists.xsl,1.30; manpages/other.xsl,1.20; +manpages/param.ent,1.22; manpages/param.xweb,1.24; +manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; +params/man.indent.refsect.xml,1.1; +params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 - +Michael(tm) Smith + + +Added +man.table.footnotes.divider param. +In each +table that contains footenotes, the string specified +by the man.table.footnotes.divider parameter is output +before the list of footnotes for the +table. +Modified: manpages/docbook.xsl,1.73; +manpages/links.xsl,1.6; manpages/param.ent,1.21; +manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 - +Michael(tm) Smith + + +Added the +man.output.in.separate.dir, +man.output.base.dir, +and man.output.subdirs.enabled parameters. +The +man.output.base.dir parameter specifies the +base directory into which man-page files are +output. The man.output.subdirs.enabled parameter controls whether +the files are output in subdirectories within the base +directory. +The values of the +man.output.base.dir +and man.output.subdirs.enabled parameters are used only if the +value of man.output.in.separate.dir parameter is non-zero. If the +value of man.output.in.separate.dir is zero, man-page files are +not output in a separate +directory. +Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; +manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; +params/man.output.in.separate.dir.xml,1.1; +params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) +Smith + + +Added +man.font.table.headings and +man.font.table.title params, for +controlling font in table headings and +titles. +Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; +manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; +params/man.font.table.title.xml,1.1 - Michael(tm) +Smith + + +Added +man.font.funcsynopsisinfo and +man.font.funcprototype params, for specifying the roff +font (for example, BI, B, I) for funcsynopsisinfo and +funcprototype output. +Modified: manpages/block.xsl,1.19; +manpages/docbook.xsl,1.69; manpages/param.ent,1.18; +manpages/param.xweb,1.20; manpages/synop.xsl,1.29; +manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1; +params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) +Smith + + +Added +man.segtitle.suppress param. +If the value of +man.segtitle.suppress is non-zero, then display +of segtitle contents is suppressed in +output. +Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; +manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - +Michael(tm) Smith + + +Added +man.output.manifest.enabled and +man.output.manifest.filename params. +If +man.output.manifest.enabled is non-zero, a list +of filenames for man pages generated by the stylesheet +transformation is written to the file named by +man.output.manifest.filename +Modified: manpages/docbook.xsl,1.67; +manpages/other.xsl,1.19; manpages/param.ent,1.16; +manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1; +params/man.output.manifest.filename.xml,1.1; +tools/make/Makefile.DocBook,1.4 - Michael(tm) +Smith + + +Added +refentry.meta.get.quietly param. +If zero (the +default), notes and warnings about "missing" markup are generated +during gathering of refentry metadata. If +non-zero, the metadata is gathered "quietly" -- that is, the +notes and warnings are suppressed. +NOTE: If you are +processing a large amount of refentry content, you +may be able to speed up processing significantly by setting a +non-zero value for +refentry.meta.get.quietly. +Modified: common/refentry.xsl,1.17; +manpages/param.ent,1.15; manpages/param.xweb,1.17; +params/refentry.meta.get.quietly.xml,1.1 - Michael(tm) +Smith + + +Changed names of all boolean +indentation params to man.indent.* Also discarded individual +man.indent.*.value params and switched to just using a common +man.indent.width param (3n by default). +Modified: manpages/docbook.xsl,1.66; +manpages/info.xsl,1.19; manpages/lists.xsl,1.29; +manpages/other.xsl,1.18; manpages/refentry.xsl,1.13 - Michael(tm) +Smith + + +Added boolean +man.output.in.separate.dir param, to control whether or not man +files are output in separate directory. +Modified: manpages/docbook.xsl,1.65; +manpages/utility.xsl,1.14 - Michael(tm) Smith + + +Added options for controlling +indentation of verbatim output. Controlled through the +man.indentation.verbatims.adjust +and man.indentation.verbatims.value params. Closes +#1242997 +Modified: manpages/block.xsl,1.15; manpages/docbook.xsl,1.64 - +Michael(tm) Smith + + +Added options for controlling +indentation in lists and in *blurb output in the AUTHORS +section. Controlled through +the man.indentation.lists.adjust, +man.indentation.lists.value, man.indentation.authors.adjust, and +man.indentation.authors.value parameters. Default is 3 characters +(instead of the roff default of 8 characters). Closes +#1449369. +Also, removed the indent that was being set on +informalexample outuput. I will instead add an option +for indenting verbatims, which I think is what the +informalexample indent was intended +for originally. +Modified: manpages/block.xsl,1.14; +manpages/docbook.xsl,1.63; manpages/info.xsl,1.18; +manpages/lists.xsl,1.28 - Michael(tm) Smith + + +Changed line-spacing call before +synopfragment to use ".sp -1n" ("n" units specified) +instead of plain ".sp -1" +Modified: manpages/synop.xsl,1.28 - Michael(tm) +Smith + + +Added support for writing man +files into a specific output directory and into appropriate +subdirectories within that output directory. Controlled through +the man.base.dir parameter (similar to the +base.dir support in the HTML stylesheet) and +the man.subdirs.enabled parameter, which automatically determines +the name of an appropriate subdir (for example, man/man7, +man/man1, etc.) based on the section number/manvolnum +of the source Refentry. +Closes #1255036 and +#1170317. Thanks to Denis Bradford for the original feature +request, and to Costin Stroie for submitting a patch that was +very helpful in implementing the +support. +Modified: manpages/docbook.xsl,1.62; manpages/utility.xsl,1.13 - +Michael(tm) Smith + + +Refined XPath statements and +notification messages for refentry metadata +handling. +Modified: common/common.xsl,1.59; common/refentry.xsl,1.14; +manpages/docbook.xsl,1.61; manpages/other.xsl,1.17 - Michael(tm) +Smith + + +Added support for +copyright and legalnotice. The manpages +stylesheets now output a COPYRIGHT section, +after the AUTHORS section, if a copyright +or legalnotice is found in the source. The +section contains the copyright contents followed +by the legalnotice contents. Closes +#1450209. +Modified: manpages/docbook.xsl,1.59; manpages/info.xsl,1.17 - +Michael(tm) Smith + + +Drastically reworked all of the +XPath expressions used in refentry metadata gathering +-- completely removed $parentinfo and turned $info into a set of +nodes that includes the *info contents of the Refentry +plus the *info contents all all of its ancestor elements. The +basic XPath expression now used throughout is (using the example +of checking for a date): + +(($info[//date])[last()]/date)[1]. +That selects the "last" +*info/date date in document order -- that is, the one +eitther on the Refentry itself or on the +closest ancestor to the Refentry. +It's +likely this change may break some things; may need to pick up +some pieces later. +Also, changed the default value for the +man.th.extra2.max.length from 40 to +30. +Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; +params/man.th.extra2.max.length.xml,1.2; +params/refentry.date.profile.xml,1.2; +params/refentry.manual.profile.xml,1.2; +params/refentry.source.name.profile.xml,1.2; +params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; +manpages/other.xsl,1.15 - Michael(tm) Smith + + +Added support for DocBook 5 +namespace-stripping in manpages stylesheet. Closes request +#1210692. +Modified: common/common.xsl,1.56; manpages/docbook.xsl,1.57 - +Michael(tm) Smith + + +Fixed handling of table +footnotes. With this checkin, the table support in the +manpages stylesheet is now basically feature complete. So this +change closes request #619532, "No support for tables" -- the +oldest currently open manpages feature request, submitted by Ben +Secrest (blsecres) on 2002-10-07. Congratulations to me [patting +myself on the back]. +Modified: manpages/block.xsl,1.11; +manpages/docbook.xsl,1.55; manpages/table.xsl,1.15 - Michael(tm) +Smith + + +Added handling for +table titles. Also fixed handling of nested tables; +nest tables are now "extracted" and displayed just after their +parent tables. +Modified: manpages/docbook.xsl,1.54; manpages/table.xsl,1.14 +- Michael(tm) Smith + + +Added option for turning off bold +formatting in Funcsynopsis. Boldface formatting in +function synopsis is mandated in the +man(7) man page and is used almost universally in existing man +pages. Despite that, it really does look like crap to have an +entire Funcsynopsis output in bold, so I added params +for turning off the bold formatting and/or replacing it with a +different roff special font (e.g., "RI" for alternating +roman/italic instead of the default "BI" for alternating +bold/italic). The new params +are "man.funcprototype.font" and +"man.funcsynopsisinfo.font". To be documented +later. +Closes #1452247. Thanks to Joe Orton for the feature +request. +Modified: params/man.string.subst.map.xml,1.16; +manpages/block.xsl,1.10; manpages/docbook.xsl,1.51; +manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm) +Smith + + +Use AUTHORS instead of +AUTHOR if we have multiple people to attribute. Also, +fixed checking such that we generate +author section even if we don't have an +author (as long as there is at least one other +person/entity we can put in the +section). Also adjusted assembly of content for +Author metainfo field such that we now not only use +author, but try to find a "best match" if we can't +find an author name to put there. +Closes +#1233592. Thanks to Sam Steingold for the +request. +Modified: manpages/info.xsl,1.12 - Michael(tm) +Smith + + +Changes for request #1243027, +"Impove handling of AUTHOR section." This +adds support for Collab, Corpauthor, Corpcredt, +Orgname, Publishername, and +Publisher. Also adds support for output +of Affiliation and its children, and support for using +gentext strings for auto-attributing roles (Author, +Editor, Publisher, Translator, etc.). Also +did a lot of code cleanup and modularization of all the +AUTHOR handling code. And fixed a bug that was causing +Author info to not be picked up correctly +for metainfo comment we embed in man-page +source. +Modified: manpages/info.xsl,1.11 - Michael(tm) +Smith + + +Support bold output for +"emphasis remap='B'". (because Eric Raymond's +doclifter(1) tool converts groff source marked up with ".B" +request or "\fB" escapes to DocBook "emphasis +remap='B'".) +Modified: manpages/inline.xsl,1.14 - Michael(tm) +Smith + + +Added support for +Segmentedlist. Details: Output is tabular, with no +option for "list" type output. Output for Segtitle +elements can be supressed by +setting man.segtitle.suppress. If Segtitle +content is output, it is rendered in italic type (not bold +because not all terminals support bold and so italic ensures the +stand out on those terminals). Extra space (.sp line) at end of +table code ensures that it gets handled correctly in +the case where its source is the child of a Para. +Closes feature-request #1400097. Thanks to Daniel Leidert for the +patch and push, and to Alastair Rankine for filing the original +feature request. +Modified: manpages/lists.xsl,1.23; +manpages/utility.xsl,1.10 - Michael(tm) Smith + + +Improved handling or +Author/Editor/Othercredit. +Reworked content of +(non-visible) comment added at top of each page (metadata +stuff). +Added support for generating a +manifest file (useful for cleaning up +after builds, etc.) +Modified: manpages/docbook.xsl,1.46; +manpages/info.xsl,1.9; manpages/other.xsl,1.12; +manpages/utility.xsl,1.6 - Michael(tm) Smith + + +Added two new parameters for +handling of multi-term +varlistentry elements: +variablelist.term.break.after: +When the variablelist.term.break.after is +non-zero, it will generate a line break after each +term multi-term +varlistentry. +variablelist.term.separator: +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is +placed after each term except the last. The default +is ", " (a comma followed by a space). To suppress rendering of +the separator, set the value of +variablelist.term.separator to the empty +string (""). +These parameters are primarily intended to be +useful if you have multi-term varlistentries that have long +terms. +Closes #1306676. Thanks to Sam Steingold for +providing an example "lots of long terms" doc that demonstrated +the value of having these options. +Also, added +normalize-space() call to processing of each +term. +This change affects all output formats +(HTML, PDF, manpages). The default behavior should pretty much +remain the same as before, but it is possible (as always) that +the change may introduce some +new bugginess. +Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; +fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; +html/param.xweb,1.93; manpages/lists.xsl,1.22; +manpages/param.ent,1.14; manpages/param.xweb,1.16; +params/variablelist.term.break.after.xml,1.1; +params/variablelist.term.separator.xml,1.1 - Michael(tm) +Smith + + + + + +Params +The following changes have been made to the + params code + since the 1.69.1 release. + + +New parameters to set +header/footer table minimum +height. +Modified: params/footer.table.height.xml,1.1; +params/header.table.height.xml,1.1 - Robert +Stayton + + +Support multiple indexing methods +for different languages. +Modified: params/index.method.xml,1.1 - Robert +Stayton + + +Remove qandaset and +qandadiv from generate.toc for fo +output because formerly it wasn't working, but now it is and +the default behavior should stay the +same. +Modified: params/generate.toc.xml,1.8 - Robert +Stayton + + +add support for page number +references to link element +too. +Modified: params/insert.link.page.number.xml,1.1 - Robert +Stayton + + +Add support for more characters to +hyphen on when ulink.hyphenate is turned +on. +Modified: params/ulink.hyphenate.chars.xml,1.1; +params/ulink.hyphenate.xml,1.3 - Robert Stayton + + +New attribute-set to format +biblioentry and +bibliomixed. +Modified: params/biblioentry.properties.xml,1.1 - +Robert Stayton + + +Added new parameter +chunk.tocs.and.lots.has.title which +controls presence of title in a separate chunk with +ToC/LoT. Disabling title can be very useful if you are +generating frameset output (well, yes those frames, but some customers +really want them ;-). +Modified: html/chunk-code.xsl,1.15; +html/param.ent,1.93; html/param.xweb,1.102; +params/chunk.tocs.and.lots.has.title.xml,1.1 - Jirka +Kosek + + +Added new attribute set +toc.line.properties for controlling appearance of lines in +ToC/LoT +Modified: params/toc.line.properties.xml,1.1 - Jirka +Kosek + + +Allow table footnotes +to have different properties from regular +footnotes. +Modified: params/table.footnote.properties.xml,1.1 - Robert +Stayton + + +Set properties for pgwide="1" +objects. +Modified: params/pgwide.properties.xml,1.1 - Robert +Stayton + + +Added the +autotoc.label.in.hyperlink param. +If the value +of autotoc.label.in.hyperlink is non-zero, labels +are included in hyperlinked titles in the TOC. If it +is instead zero, labels are still displayed prior to the +hyperlinked titles, but are not hyperlinked along with the +titles. +Closes patch #1065868. Thanks to anatoly techtonik +for the patch. +Modified: html/autotoc.xsl,1.36; html/param.ent,1.92; +html/param.xweb,1.101; params/autotoc.label.in.hyperlink.xml,1.1 - +Michael(tm) Smith + + +Added two new params: +html.head.legalnotice.link.types +and html.head.legalnotice.link.multiple. +If +the value of the generate.legalnotice.link is +non-zero, then the stylesheet generates (in the head +section of the HTML source) either a single HTML +link element or, if the value of +the html.head.legalnotice.link.multiple is +non-zero, one link element for each link +type specified. Each link has the +following attributes: + - a rel attribute whose value +is derived from the value of +html.head.legalnotice.link.types + - +an href attribute whose value is set to the URL of the file +containing the legalnotice + - a title +attribute whose value is set to the title of the +corresponding legalnotice (or a title +programatically determined by the stylesheet) +For +example: + <link rel="copyright" +href="ln-id2524073.html" title="Legal Notice"> +Closes +#1476450. Thanks to Sam Steingold. +Modified: html/chunk-common.xsl,1.45; +html/param.ent,1.91; html/param.xweb,1.100; +params/generate.legalnotice.link.xml,1.4; +params/html.head.legalnotice.link.multiple.xml,1.1; +params/html.head.legalnotice.link.types.xml,1.1 - Michael(tm) +Smith + + +Added the following +params: + - man.indent.width (string-valued) - +man.indent.refsect (boolean) - man.indent.blurbs (boolean) +- man.indent.lists (boolean) - man.indent.verbatims +(boolean) +Note that in earlier snapshots, man.indent.width +was named man.indentation.default.value and the boolean params +had names like man.indentation.*.adjust. Also the +man.indent.blurbs param was called man.indentation.authors.adjust +(or something). +The behavior now is: If the value of a +particular man.indent.* boolean param is non-zero, the +corresponding contents (refsect*, list items, +authorblurb/personblurb, vervatims) are displayed with a left +margin indented by a width equal to the value +of man.indent.width. +Modified: params/man.indent.blurbs.xml,1.1; +manpages/docbook.xsl,1.74; manpages/info.xsl,1.20; +manpages/lists.xsl,1.30; manpages/other.xsl,1.20; +manpages/param.ent,1.22; manpages/param.xweb,1.24; +manpages/refentry.xsl,1.14; params/man.indent.lists.xml,1.1; +params/man.indent.refsect.xml,1.1; +params/man.indent.verbatims.xml,1.1; params/man.indent.width.xml,1.1 - +Michael(tm) Smith + + +Added +man.table.footnotes.divider param. +In each +table that contains footenotes, the string specified +by the man.table.footnotes.divider parameter is output +before the list of footnotes for the +table. +Modified: manpages/docbook.xsl,1.73; +manpages/links.xsl,1.6; manpages/param.ent,1.21; +manpages/param.xweb,1.23; params/man.table.footnotes.divider.xml,1.1 - +Michael(tm) Smith + + +Added the +man.output.in.separate.dir, +man.output.base.dir, +and man.output.subdirs.enabled parameters. +The +man.output.base.dir parameter specifies the +base directory into which man-page files are +output. The man.output.subdirs.enabled parameter controls whether +the files are output in subdirectories within the base +directory. +The values of the +man.output.base.dir +and man.output.subdirs.enabled parameters are used only if the +value of man.output.in.separate.dir parameter is non-zero. If the +value of man.output.in.separate.dir is zero, man-page files are +not output in a separate +directory. +Modified: manpages/docbook.xsl,1.72; manpages/param.ent,1.20; +manpages/param.xweb,1.22; params/man.output.base.dir.xml,1.1; +params/man.output.in.separate.dir.xml,1.1; +params/man.output.subdirs.enabled.xml,1.1 - Michael(tm) +Smith + + +Added +man.font.table.headings and +man.font.table.title params, for +controlling font in table headings and +titles. +Modified: manpages/docbook.xsl,1.71; manpages/param.ent,1.19; +manpages/param.xweb,1.21; params/man.font.table.headings.xml,1.1; +params/man.font.table.title.xml,1.1 - Michael(tm) +Smith + + +Added +man.font.funcsynopsisinfo and +man.font.funcprototype params, for specifying the roff +font (for example, BI, B, I) for funcsynopsisinfo and +funcprototype output. +Modified: manpages/block.xsl,1.19; +manpages/docbook.xsl,1.69; manpages/param.ent,1.18; +manpages/param.xweb,1.20; manpages/synop.xsl,1.29; +manpages/table.xsl,1.21; params/man.font.funcprototype.xml,1.1; +params/man.font.funcsynopsisinfo.xml,1.1 - Michael(tm) +Smith + + +Changed to select="0" in +refclass.suppress (instead of +..>0</..) +Modified: params/refclass.suppress.xml,1.3 - Michael(tm) +Smith + + +Added +man.segtitle.suppress param. +If the value of +man.segtitle.suppress is non-zero, then display +of segtitle contents is suppressed in +output. +Modified: manpages/docbook.xsl,1.68; manpages/param.ent,1.17; +manpages/param.xweb,1.19; params/man.segtitle.suppress.xml,1.1 - +Michael(tm) Smith + + +Added +man.output.manifest.enabled and +man.output.manifest.filename params. +If +man.output.manifest.enabled is non-zero, a list +of filenames for man pages generated by the stylesheet +transformation is written to the file named by +man.output.manifest.filename +Modified: manpages/docbook.xsl,1.67; +manpages/other.xsl,1.19; manpages/param.ent,1.16; +manpages/param.xweb,1.18; params/man.output.manifest.enabled.xml,1.1; +params/man.output.manifest.filename.xml,1.1; +tools/make/Makefile.DocBook,1.4 - Michael(tm) +Smith + + +Added refclass.suppress +param. +If the value of refclass.suppress is +non-zero, then display refclass contents is suppressed +in output. Affects HTML and FO output +only. +Modified: fo/param.ent,1.93; fo/param.xweb,1.106; html/param.ent,1.90; +html/param.xweb,1.99; params/refclass.suppress.xml,1.1 - Michael(tm) +Smith + + +Added +refentry.meta.get.quietly param. +If zero (the +default), notes and warnings about "missing" markup are generated +during gathering of refentry metadata. If +non-zero, the metadata is gathered "quietly" -- that is, the +notes and warnings are suppressed. +NOTE: If you are +processing a large amount of refentry content, you +may be able to speed up processing significantly by setting a +non-zero value for +refentry.meta.get.quietly. +Modified: common/refentry.xsl,1.17; +manpages/param.ent,1.15; manpages/param.xweb,1.17; +params/refentry.meta.get.quietly.xml,1.1 - Michael(tm) +Smith + + +Added support for "software" and +"sectdesc" class values on refmiscinfo; "software" is +treated identically to "source", and "setdesc" is treated +identically to "manual". +Modified: common/refentry.xsl,1.10; +params/man.th.extra2.max.length.xml,1.3; +params/refentry.source.name.profile.xml,1.4 - Michael(tm) +Smith + + +Drastically reworked all of the +XPath expressions used in refentry metadata gathering +-- completely removed $parentinfo and turned $info into a set of +nodes that includes the *info contents of the Refentry +plus the *info contents all all of its ancestor elements. The +basic XPath expression now used throughout is (using the example +of checking for a date): + +(($info[//date])[last()]/date)[1]. +That selects the "last" +*info/date date in document order -- that is, the one +eitther on the Refentry itself or on the +closest ancestor to the Refentry. +It's +likely this change may break some things; may need to pick up +some pieces later. +Also, changed the default value for the +man.th.extra2.max.length from 40 to +30. +Modified: common/common.xsl,1.58; common/refentry.xsl,1.7; +params/man.th.extra2.max.length.xml,1.2; +params/refentry.date.profile.xml,1.2; +params/refentry.manual.profile.xml,1.2; +params/refentry.source.name.profile.xml,1.2; +params/refentry.version.profile.xml,1.2; manpages/docbook.xsl,1.58; +manpages/other.xsl,1.15 - Michael(tm) Smith + + +Added option for turning off bold +formatting in Funcsynopsis. Boldface formatting in +function synopsis is mandated in the +man(7) man page and is used almost universally in existing man +pages. Despite that, it really does look like crap to have an +entire Funcsynopsis output in bold, so I added params +for turning off the bold formatting and/or replacing it with a +different roff special font (e.g., "RI" for alternating +roman/italic instead of the default "BI" for alternating +bold/italic). The new params +are "man.funcprototype.font" and +"man.funcsynopsisinfo.font". To be documented +later. +Closes #1452247. Thanks to Joe Orton for the feature +request. +Modified: params/man.string.subst.map.xml,1.16; +manpages/block.xsl,1.10; manpages/docbook.xsl,1.51; +manpages/inline.xsl,1.16; manpages/synop.xsl,1.27 - Michael(tm) +Smith + + +fop.extensions now only +for FOP version 0.20.5 and earlier. +Modified: params/fop.extensions.xml,1.4 +- Robert Stayton + + +Support for fop1 different from +fop 0.20.5 and earlier. +Modified: params/fop1.extensions.xml,1.1 - Robert +Stayton + + +Reset default value to empty +string so template uses gentext first, then the parameter value +if not empty. +Modified: params/index.number.separator.xml,1.2; +params/index.range.separator.xml,1.2; +params/index.term.separator.xml,1.2 - Robert +Stayton + + +New parameter: +id.warnings. If non-zero, warnings are +generated for titled objects that don't have titles. True by default; +I wonder if this will be too aggressive? +Modified: html/biblio.xsl,1.25; +html/component.xsl,1.27; html/division.xsl,1.11; html/formal.xsl,1.19; +html/glossary.xsl,1.20; html/html.xsl,1.13; html/index.xsl,1.16; +html/param.ent,1.88; html/param.xweb,1.97; html/refentry.xsl,1.22; +html/sections.xsl,1.30; params/id.warnings.xml,1.1 - Norman +Walsh + + +Added new parameter +keep.relative.image.uris +Modified: fo/param.ent,1.91; +fo/param.xweb,1.104; html/param.ent,1.87; html/param.xweb,1.96; +params/keep.relative.image.uris.xml,1.1 - Norman +Walsh + + +Support default label +width parameters for itemized and ordered lists +Modified: fo/lists.xsl,1.64; +fo/param.ent,1.90; fo/param.xweb,1.103; +params/itemizedlist.label.width.xml,1.1; +params/orderedlist.label.width.xml,1.1 - Norman +Walsh + + +Added parameters to localize +punctuation in indexes. +Modified: params/index.number.separator.xml,1.1; +params/index.range.separator.xml,1.1; +params/index.term.separator.xml,1.1 - Robert +Stayton + + +Added two new parameters for +handling of multi-term +varlistentry elements: +variablelist.term.break.after: +When the variablelist.term.break.after is +non-zero, it will generate a line break after each +term multi-term +varlistentry. +variablelist.term.separator: +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is +placed after each term except the last. The default +is ", " (a comma followed by a space). To suppress rendering of +the separator, set the value of +variablelist.term.separator to the empty +string (""). +These parameters are primarily intended to be +useful if you have multi-term varlistentries that have long +terms. +Closes #1306676. Thanks to Sam Steingold for +providing an example "lots of long terms" doc that demonstrated +the value of having these options. +Also, added +normalize-space() call to processing of each +term. +This change affects all output formats +(HTML, PDF, manpages). The default behavior should pretty much +remain the same as before, but it is possible (as always) that +the change may introduce some +new bugginess. +Modified: fo/lists.xsl,1.62; fo/param.ent,1.88; +fo/param.xweb,1.99; html/lists.xsl,1.48; html/param.ent,1.86; +html/param.xweb,1.93; manpages/lists.xsl,1.22; +manpages/param.ent,1.14; manpages/param.xweb,1.16; +params/variablelist.term.break.after.xml,1.1; +params/variablelist.term.separator.xml,1.1 - Michael(tm) +Smith + + +Convert 'no' to string in default +value. +Modified: params/olink.doctitle.xml,1.4 - Robert +Stayton + + +Implemented RFE +#1292615. +Added bunch of new parameters (attribute sets) +that affect list presentation: list.block.properties, +itemizedlist.properties, orderedlist.properties, +itemizedlist.label.properties and +orderedlist.label.properties. Default behaviour +of stylesheets has not been changed but further customizations will be +much more easier. +Modified: fo/lists.xsl,1.61; fo/param.ent,1.87; +fo/param.xweb,1.98; params/itemizedlist.label.properties.xml,1.1; +params/itemizedlist.properties.xml,1.1; +params/list.block.properties.xml,1.1; +params/orderedlist.label.properties.xml,1.1; +params/orderedlist.properties.xml,1.1 - Jirka +Kosek + + +Implemented RFE +#1242092. +You can enable crop marks in your document by +setting crop.marks=1 and xep.extensions=1. Appearance of crop +marks can be controlled by parameters +crop.mark.bleed (6pt), +crop.mark.offset (24pt) and +crop.mark.width (0.5pt). +Also there +is new named template called user-xep-pis. You can overwrite it in +order to produce some PIs that can control XEP as described in +http://www.renderx.com/reference.html#Output_Formats +Modified: fo/docbook.xsl,1.36; +fo/param.ent,1.86; fo/param.xweb,1.97; fo/xep.xsl,1.23; +params/crop.mark.bleed.xml,1.1; params/crop.mark.offset.xml,1.1; +params/crop.mark.width.xml,1.1; params/crop.marks.xml,1.1 - Jirka +Kosek + + +Changed short descriptions in doc +for *autolabel* params to match new autolabel +behavior. +Modified: params/appendix.autolabel.xml,1.5; +params/chapter.autolabel.xml,1.4; params/part.autolabel.xml,1.5; +params/preface.autolabel.xml,1.4 - Michael(tm) +Smith + + + + + +Profiling +The following changes have been made to the + profiling code + since the 1.69.1 release. + + +Profiling now works together with +namespace stripping (V5 documents). Namespace striping should work +with all stylesheets named profile-, even if they are not supporting +namespace stripping in a non-profiling +variant. +Modified: profiling/profile-mode.xsl,1.4; +profiling/xsl2profile.xsl,1.7 - Jirka Kosek + + +Moved profiling stage out of +templates. This make possible to reuse profiled content by several +templates and still maintaing node indentity (needed for example for +HTML Help where content is processed multiple times). +I +don't know why this was not on the top level before. Maybe some XSLT +processors choked on it. I hope this will be OK +now. +Modified: profiling/xsl2profile.xsl,1.5 - Jirka +Kosek + + + + + +Tools +The following changes have been made to the + tools code + since the 1.69.1 release. + + +Moved Makefile.DocBook from +contrib module to xsl +module. +Modified: tools/make/Makefile.DocBook,1.1 - Michael(tm) +Smith + + + + + +WordML +The following changes have been made to the + wordml code + since the 1.69.1 release. + + +added contrib element, +better handling of default paragraph +style +Modified: wordml/pages-normalise.xsl,1.6; wordml/supported.xml,1.2; +wordml/wordml-final.xsl,1.14 - Steve Ball + + +added +bridgehead +Modified: wordml/docbook-pages.xsl,1.6; +wordml/docbook.xsl,1.17; wordml/pages-normalise.xsl,1.5; +wordml/template-pages.xml,1.7; wordml/template.dot,1.4; +wordml/template.xml,1.14; wordml/wordml-final.xsl,1.13 - Steve +Ball + + +added blocks stylesheet to support +bibliographies, glossaries and qandasets +Modified: wordml/Makefile,1.4; +wordml/README,1.3; wordml/blocks-spec.xml,1.1; +wordml/docbook-pages.xsl,1.5; wordml/docbook.xsl,1.16; +wordml/pages-normalise.xsl,1.4; wordml/sections-spec.xml,1.3; +wordml/specifications.xml,1.13; wordml/template-pages.xml,1.6; +wordml/template.dot,1.3; wordml/template.xml,1.13; +wordml/wordml-blocks.xsl,1.1; wordml/wordml-final.xsl,1.12; +wordml/wordml-sections.xsl,1.3 - Steve Ball + + +added mediaobject +caption +Modified: wordml/docbook-pages.xsl,1.4; +wordml/docbook.xsl,1.15; wordml/specifications.xml,1.12; +wordml/template-pages.xml,1.5; wordml/template.dot,1.2; +wordml/template.xml,1.12; wordml/wordml-final.xsl,1.11 - Steve +Ball + + +added +callouts +Modified: wordml/docbook-pages.xsl,1.3; wordml/docbook.xsl,1.14; +wordml/pages-normalise.xsl,1.3; wordml/specifications.xml,1.11; +wordml/template-pages.xml,1.4; wordml/wordml-final.xsl,1.10 - Steve +Ball + + +added Word template +file +Modified: wordml/template.dot,1.1 - Steve Ball + + +added abstract, fixed +itemizedlist, ulink +Modified: wordml/specifications.xml,1.10; +wordml/wordml-final.xsl,1.9 - Steve Ball + + +fixed Makefile added many +features to Pages support added revhistory, inlines, +highlights, abstract +Modified: wordml/Makefile,1.2; +wordml/docbook-pages.xsl,1.2; wordml/pages-normalise.xsl,1.2; +wordml/sections-spec.xml,1.2; wordml/specifications.xml,1.9; +wordml/template-pages.xml,1.3; wordml/template.xml,1.11; +wordml/wordml-final.xsl,1.8; wordml/wordml-sections.xsl,1.2 - Steve +Ball + + +fixed handling linebreaks when +generating WordML added Apple Pages +support +Modified: wordml/docbook.xsl,1.13; wordml/template-pages.xml,1.2 - +Steve Ball + + + + + + + Release 1.69.1 + This release is a minor bug-fix update to the 1.69.0 + release. Along with bug fixes, it includes one + configuration-parameter change: The default value of the + annotation.support parameter is now + 0 (off). The reason for that change is that + there have been reports that annotation handling is + causing a significant performance degradation in processing of + large documents with xsltproc. + + + + + Release 1.69.0 + The release includes major feature changes, + particularly in the manpages + stylesheets, as well as a large number of bug fixes. + + As with all DocBook Project dot zero releases, this is an + experimental release . + + + Common + + + This release adds localizations for the following + languages: + + + Albanian + Amharic + Azerbaijani + Hindi + Irish (Gaelic) + Gujarati + Kannada + Mongolian + Oriya + Punjabi + Tagalog + Tamil + Welsh + . + + + Added support for specifying number format for auto + labels for chapter, appendix, + part, and preface. Contolled with the + appendix.autolabel, + chapter.autolabel, + part.autolabel, and + preface.autolabel parameters. + + + Added basic support for biblioref cross + referencing. + + + Added support for align + on caption in mediaobject. + + + Added support for processing documents that use the + DocBook V5 namespace. + + + Added support for termdef and + mathphrase. + + + EXPERIMENTAL: Incorporated the Slides and Website + stylesheets into the DocBook XSL stylesheets package. So, + for example, Website documents can now be processed using + the following URI for the driver Website + tabular.xsl file: http://docbook.sourceforge.net/release/xsl/current/website/tabular.xsl + + + A procedure without a title is + now treated as an informal procedure (meaning + that it is not added to any generated list of + procedures and has no affect on numbering of + generated labels for other procedures). + + + docname is no longer added to + olink when pointing to a root element. + + + + Added support for generation of choice separator in + inline simplelist. This enables auto-generation of an + appropriate localized choice separator (for + example, and or or) before the + final item in an inline simplelist. + To indicate that you want a choice separator + generated for a particular list, you need to put a processing + instruction (PI) of the form + dbchoice choice="foo" as a + child of the list. For example: + <para>Choose from + ONE and ONLY ONE of the following: + <simplelist type="inline"> + <?dbchoice choice="or" ?> + <member>A</member> + <member>B</member> + <member>C</member>.</simplelist></para> + + Output (for English): +
                  + Choose from ONE and only ONE of the + following choices: A, B, or C. +
                  + As a temporary workaround for the fact that most of the + DocBook non-English locale files don't have a localization for + the word or, you can put in a literal string to + be used; example for French: dbchoice choice="ou". That is, use + ou instead of or.                   +                   +                   +                   + + FO + + + Added content-type property to + external-graphic element, based on + imagedata format + attribute. + + + Added support for generating + <rx:meta-field creator="$VERSION"/> + field for XEP output. This makes the DocBook XSL + stylesheet version information available through the + Document Properties menu in Acrobat + Reader and other PDF viewers. + + + Trademark symbol handling made consistent with + handling of same in HTML stylesheets. Prior to this change, + if you processed a document that contained no value for the + class attribute on the + trademark element, the HTML stylesheets would + default to rendering a superscript TM + symbol after the trademark contents, + but the FO stylesheets would render nothing. + + + Added support for generating XEP bookmarks for + refentry. + + + Added support for HTML markup table border attribute, applied to each + table cell. + + + The table.width template can now + sum column specs if none use % or + *. + + + Added fox:destination extension + inside fox:outline to support linking to + internal destinations. + + + Added support for customizing + abstract with property sets. Controlled + with the abstract.properties and + abstract.title.properties + parameters. + + + Add footnotes in table title to + table footnote set, and add support for table footnotes to + HTML table markup. + + + Added support for title in + glosslist. + + + Added support for itemizedlist symbol + none. + + + Implemented the new + graphical.admonition.properties and + nongraphical.admonition.properties + attribute sets. + + + Added id to + formalpara and some other blocks that were + missing it. + + + Changed the anchor template to output + fo:inline instead of + fo:wrapper. + + + Added support for toc.max.depth + parameter. + + + + + + Help + + + Eclipse Help: Added support for generating olink + database. + + + + + + HTML + + + Added a first cut at support in HTML output for + DocBook 5 style annotations. Controlled using the + annotation.support parameter, and + implemented using JavaScript and CSS styling. For more + details, see the documentation for the + annotation.js, + annotation.css, + annotation.graphic.open, and + annotation.graphic.close + parameters. + + + Generate client-side image map for + imageobjectco with areas using + calspair units + + + Added support for img.src.path PI. + + + Added support for passing + img.src.path to DocBook Java XSLT + image extensions when appropriate. Controlled using the + graphicsize.use.img.src.path + parameter. + + + Added support for (not + valid for DocBook 4) xlink:href + on area and (not valid for DocBook 4) + alt in area. + + + Added new parameter + default.table.frame to control table + framing if there is no frame + attribute on a table. + + + Added initial, experimental support for generating + content for the HTML title attribute from + content of the alt element. This change adds + support for the following inline elements only (none of them + are block elements): + + + abbrev + accel + acronym + action + application + authorinitials + beginpage + citation + citerefentry + citetitle + city + classname + code + command + computeroutput + constant + country + database + email + envar + errorcode + errorname + errortext + errortype + exceptionname + fax + filename + firstname + firstterm + foreignphrase + function + glossterm + guibutton + guiicon + guilabel + guimenu + guimenuitem + guisubmenu + hardware + honorific + interface + interfacename + keycap + keycode + keysym + lineage + lineannotation + literal + markup + medialabel + methodname + mousebutton + option + optional + otheraddr + othername + package + parameter + personname + phone + pob + postcode + productname + productnumber + prompt + property + quote + refentrytitle + remark + replaceable + returnvalue + tag + shortcut + state + street + structfield + structname + subscript + superscript + surname + symbol + systemitem + tag + termdef + token + trademark + type + uri + userinput + varname + wordasword + + + + + Added support for chunking revhistory into + separate file (similar to the support for doing same with + legalnotice). Patch from Thomas + Schraitle. Controlled through new + generate.revhistory.link parameter. + + + l10n.xsl: Made language codes RFC compliant. Added a + new boolean config parameter, + l10n.lang.value.rfc.compliant. If it + is non-zero (the default), any underscore in a language code + will be converted to a hyphen in HTML output. If it is zero, + the language code will be left as-is. + + + + + man + This release closes out 44 manpages stylesheet bug reports + and feature requests. It adds more than 35 new configuration + parameters for controlling aspects of man-page output -- + including hyphenation and justification, handling of links, + conversion of Unicode characters, and contents of man-page + headers and footers. + + + + New options for globally disabling/enabling + hyphenation and justification: + man.justify and + man.hyphenate. + Note that the default + for the both of those is zero (off), because justified text + looks good only when it is also hyphenated; to quote the + Hyphenation node from the groff info page: +
                  + Since the odds are not great for finding a + set of words, for every output line, which fit nicely on a + line without inserting excessive amounts of space between + words, `gtroff' hyphenates words so that it can justify + lines without inserting too much space between + words. +
                  + The problem is that groff can end up hyphenating a lot of + things that you don't want hyphenated (variable names and + command names, for example). Keeping both justification and + hyphenation disabled ensures that hyphens won't get inserted + where you don't want to them, and you don't end up with + lines containing excessive amounts of space between + words. These default settings run counter to how most + existing man pages are formatted. But there are some notable + exceptions, such as the perl man pages.                   +                   + + Added parameters for controlling hyphenation of + computer inlines, filenames, and URLs. By default, even when + hyphenation is enabled (globally), hyphenation is now + suppressed for "computer inlines" (currently, just + classname, constant, envar, + errorcode, option, + replaceable, userinput, + type, and varname, and for + filenames, and for URLs from link. It + can be (re)enabled using the + man.hyphenate.computer.inlines, + man.hyphenate.filenames, and + man.hyphenate.urls parameters. + + + + Implemented a new system for replacing Unicode + characters. There are two parts to the new system: a + string substitution map for doing + essential replacements, and a + character map that can optionally be disabled + and enabled. + The new system fixes all open bugs that had to do with + literal Unicode numbered entities such as &#8220; and + &#8221; showing up in output, and greatly expands the + ability of the stylesheets to generate good roff + equivalents for Unicode symbols and special + characters. + Here are some details... + The previous manpages mechanism for replacing Unicode + symbols and special characters with roff equivalents (the + replace-entities template) was not + scalable and not complete. The mechanism handled a somewhat + arbitrary selection of less than 20 or so Unicode + characters. But there are potentially more than + 800 Unicode special characters that + have some groff equivalent they can be mapped to. And there + are about 34 symbols in the Latin-1 (ISO-8859-1) block + alone. Users might reasonably expect that if they include + any of those Latin-1 characters in their DocBook source + documents, they will get correctly converted to known roff + equivalents in output. + In addition to those common symbols, certain users may + have a need to use symbols from other Unicode blocks. Say, + somebody who is documenting an application related to math + might need to use a bunch of symbols from the + Mathematical Operators Unicode block (there + are about 65 characters in that block that have reasonable + roff equivalents). Or somebody else might really like + Dingbats -- such as the checkmark character -- and so might + use a bunch of things from the Dingbat block + (141 characters in that that have roff equivalents or that + can at least be degraded somewhat gracefully + into roff). + So, the old replace-entities + mechanism was replaced with a completely different mechanism + that is based on use of two maps: a + substitution map and a character + map (the latter in a format compliant with the XSLT + 2.0 spec and therefore completely forward + compatible with XSLT 2.0). + The substitution map is controlled through the + man.string.subst.map parameter, and + is used to replace things like the backslash character + (which needs special handling to prevent it from being + interpreted as a roff escape). The substitution map cannot + be disabled, because disabling it will cause the output to + be broken. However, you can add to it and change it if + needed. + + The character map mechanism, on the + other hand, can be completely disabled. It is enabled by + default, and, by default, does replacement of all Latin-1 + symbols, along with most special spaces, dashes, and quotes + (about 75 characters by default). Also, you can optionally + enable a full character map that provides + support for converting all 800 or so of the characters that + have some reasonable groff equivalent. + + The character-map mechanism is controlled through the + following parameters: + + + man.charmap.enabled + turns character-map support + on/off + + + man.charmap.use.subset + specifies that a subset of the character + map is used instead of the full map + + + man.charmap.subset.profile + specifies profile of character-map + subset + + + man.charmap.uri + specifies an alternate character map to + use instead of the standard character map + provided in the distribution + + + + + + + Implemented out-of-line handling of display of URLs + for links (currently, only for ulink). This gives + you three choices for handling of links: + + + Number and list links. Each link is numbered + inline, with a number in square brackets preceding the + link contents, and a numbered list of all links is added + to the end of the document. + + + Only list links. Links are not numbered, but an + (unnumbered) list of links is added to the end of the + document. + + + Suppress links. Don't number links and don't add + any list of links to the end of the document. + + + You can also choose whether links should be underlined. The + default is the works -- list, number, and + underline links. You can use the + man.links.list.enabled, + man.links.are.numbered, and + man.links.are.underlined parameters + to change the defaults. The default heading for the link + list is REFERENCES. You can be change that using the + man.links.list.heading + parameter. + + + Changed default output encoding to UTF-8. This does not mean that man pages are output in + raw UTF-8, because the character map is applied + before final output, causing all UTF-8 characters covered in + the map to be converted to roff equivalents. + + + + Added support for processing refsect3 and + formalpara and nested refsection + elements, down to any arbitrary level of nesting. + + + + Output of the NAME and + SYNOPSIS and AUTHOR + headings and the headings for admonitions (note, + caution, etc.) are no longer hard-coded for + English. Instead, headings are generated for those in the + correct locale (just as the FO and HTML stylesheets + do). + + + + Re-worked mechanism for assembling page + headers/footers (the contents of the .TH + macro title line). + + Here are some details... + + All man pages contain a .TH roff + macro whose contents are used for rendering the title + line displayed in the header and footer of each + page. Here are a couple of examples of real-world man pages + that have useful page headers/footers: + gtk-options(7) GTK+ User's Manual gtk-options(7) <-- header + GTK+ 1.2 2003-10-20 gtk-options(7) <-- footer + + svgalib(7) Svgalib User Manual svgalib(7) <-- header + Svgalib 1.4.1 16 December 1999 svgalib(7) <-- footer + + And here are the terms with which the + groff_man(7) man page refers to the + various parts of the header/footer: + title(section) extra3 title(section) <- header + extra2 extra1 title(section) <- footer + Or, using the names with which the man(7) + man page refers to those same fields: + title(section) manual title(section) <- page header + source date title(section) <- page footer + + The easiest way to control the contents of those + fields is to mark up your refentry content like + the following (note that this is a minimal + example). + <refentry> + <info> + <date>2003-10-20</date> + </info> + <refmeta> + <refentrytitle>gtk-options</refentrytitle> + <manvolnum>7</manvolnum> + <refmiscinfo class="source-name">GTK+</refmiscinfo> + <refmiscinfo class="version">1.2</refmiscinfo> + <refmiscinfo class="manual">GTK+ User's Manual</refmiscinfo> + </refmeta> + <refnamediv> + <refname>gtk-options</refname> + <refpurpose>Standard Command Line Options for GTK+ Programs</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>This manual page describes the command line options, which + are common to all GTK+ based applications.</para> + </refsect1> + </refentry> + + + Sets the date part of the header/footer. + + + Sets the title part. + + + Sets the section part. + + + Sets the source name part. + + + Sets the version part. + + + Sets the manual part. + + + + Below are explanations of the steps the stylesheets + take to attempt to assemble and display + good headers and footer. [In the + descriptions, note that *info + is the refentry info child + (whatever its name), and + parentinfo is the + info child of its parent (again, whatever + its name).] + + + extra1 field (date) + + Content of the extra1 field is + what shows up in the center + footer position of each page. The + man(7) man page describes it as + the date of the last revision. + To provide this content, if the + refentry.date.profile.enabled + is non-zero, the stylesheets check the value of + refentry.date.profile. + Otherwise, by default, they check for a + date or pubdate not only in the + *info contents, but also in + the parentinfo + contents. + If a date cannot be found, the stylesheets now + automatically generate a localized long + format date, ensuring that this field always + has content in output. + However, if for some reason you want to suppress + this field, you can do so by setting a non-zero value + for man.th.extra1.suppress. + + + + extra2 field (source) + + On Linux systems and on systems with a modern + groff, the content of the extra2 field + are what shows up in the left + footer position of each page. + + The man(7) man page describes + this as the source of the command, and + provides the following examples: + + + For binaries, use somwething like: GNU, + NET-2, SLS Distribution, MCC Distribution. + + + For system calls, use the version of the + kernel that you are currently looking at: Linux + 0.99.11. + + + For library calls, use the source of the + function: GNU, BSD 4.3, Linux DLL 4.4.1. + + + + + In practice, there are many pages that simply + have a version number in the source + field. So, it looks like what we have is a two-part + field, + Name Version, + where: + + + Name + + product name (e.g., BSD) or org. name + (e.g., GNU) + + + + Version + + version name + + + + Each part is optional. If the + Name is a product name, + then the Version is + probably the version of the product. Or there may be + no Name, in which case, if + there is a Version, it is + probably the version of the item itself, not the + product it is part of. Or, if the + Name is an organization + name, then there probably will be no + Version. + + To provide this content, if the + refentry.source.name.profile.enabled + and + refentry.version.profile.enabled + parameter are non-zero, the stylesheets check the + value of refentry.source.name.profile + refentry.version.profile. + + Otherwise, by default, they check the following + places, in the following order: + + + *info/productnumber + + + *info/productnumber + + + refmeta/refmiscinfo[@class = 'version'] + + + parentinfo/productnumber + + + *info/productname + + + parentinfo/productname + + + refmeta/refmiscinfo + + + [nothing found, so leave it empty] + + + + + + + extra3 field + + On Linux systems and on systems with a modern + groff, the content of the extra3 field + are what shows up in the center + header position of each page. Some man + pages have extra2 content, some + don't. If a particular man page has it, it is most + often context data about some larger + system the documented item belongs to (for example, + the name or description of a group of related + applications). The stylesheets now check the following + places, in the following order, to look for content to + add to the extra3 field. + + + parentinfo/title + + + parent's title + + + refmeta/refmiscinfo + + + [nothing found, so leave it empty] + + + + + + + + + + Reworked *info gathering. For + each refentry found, the stylesheets now cache its + *info content, then check for any + valid parent of it that might have metainfo content and cache + that, if found; they then then do all further matches against + those node-sets (rather than re-selecting the original + *info nodes each time they are + needed). + + + + New option for breaking strings after forward + slashes. This enables long URLs and pathnames to be broken + across lines. Controlled through + man.break.after.slash parameter. + + + + Output for servicemark and trademark are now + (SM) and (TM). There is + a groff "\(tm" escape, but output from that + is not acceptable. + + + + New option for controlling the length of the title + part of the .TH title line. Controlled + through the man.th.title.max.length + parameter. + + + + New option for specifying output encoding of each man + page; controlled with + man.output.encoding (similar to the + HTML chunker.output.encoding + parameter). + + + + New option for suppressing filename messages when + generating output; controlled with + man.output.quietly (similar to the HTML + chunk.quietly parameter). + + + + The text of cross-references to first-level + refentry (refsect1, top-level + refsection, refnamediv, and + refsynopsisdiv) are now capitalized. + + + + Cross-references to refnamediv now use the + localized NAME title instead of using the + first refname child. This makes the output + inconsistent with HTML and FO output, but for man-page output, + it seems to make better sense to have the + NAME. (It may actually make better sense to + do it that way in HTML and FO output as well...) + + + + Added support for processing funcparams. + + + + Removed the space that was being output between + funcdef and paramdef; example: was: + float rand (void); now: + float rand(void) + + + + Turned off bold formatting for the type + element when it occurs within a funcdef or + paramdef + + + + Corrected rendering of simplelist. Any + <simplelist type="inline" instance + is now rendered as a comma-separated list (also with an + optional localized and or or before the last item -- see + description elsewhere in these release notes). Any simplelist + instance whose type is not + inline is rendered as a one-column vertical + list (ignoring the values of the type and columns attributes if present) + + + + Comment added at top of roff source for each page now + includes DocBook XSL stylesheets version number (as in the + HTML stylesheets) + + + + Made change to prevent sticky fonts + changes. Now, when the manpages stylesheets encounter node + sets that need to be boldfaced or italicized, they put the + \fBfoo\fR and \fIbar\fR + groff bold/italic instructions separately around each node in + the set. + + + synop.xsl: Boldface everything in + funcsynopsis output except parameters (which are in + ital). The man(7) man page says: +
                  + For functions, the arguments are always specified + using italics, even in the SYNOPSIS section, where the rest + of the function is specified in bold. +
                  + A look through the contents of the + man/man2 directory shows that most + (all) existing pages do follow this everything in + funcsynopsis bold rule. That means the + type content and any punctuation (parens, + semicolons, varargs) also must be bolded.                   +                   + + + Removed code for adding backslashes before periods/dots + in roff source, because backslashes in front of periods/dots + in roff source are needed only in the very rare case where a + period is the very first character in a line, without any + space in front of it. A better way to deal with that rare case + is for you to add a zero-width space in front of the offending + dot(s) in your source + + + + Removed special handling of the quote + element. That was hard-coded to cause anything marked up with + the quote element to be output preceded by two + backticks and followed by two apostrophes -- that is, that + old-school kludge for generating curly quotes in Emacs and + in X-Windows fonts. While Emacs still seems to support that, I + don't think X-Windows has for a long time now. And, anyway, it + looks (and has always looked) like crap when viewed on a + normal tty/console. In addition, it breaks localiztion of + quote. By default, quote content is + output with localized quotation marks, which, depending on the + locale, may or may not be left and right double quotation + marks. + + + + Changed mappings for left and right single quotation + marks. Those had previously been incorrectly mapped to the + backtick (&#96;) and apostrophe (&39;) characters (for + kludgy reasons -- see above). They are now correctly mapped to + the \(oq and \(cq roff + escapes. If you want the old (broken) behavior, you need to + manually change the mappings for those in the value of the + man.string.subst.map parameter. + + + Removed xref.xsl file. Now, of the + various cross-reference elements, only the ulink + element is handled differently; the rest are handled exactly + as the HTML stylesheets handle them, except that no hypertext + links are generated. (Because there is no equivalent hypertext + mechanism is man pages.) + + + + New option for making subheading dividers in generated + roff source. The dividers are not visible in the rendered man + page; they are just there to make the source + readable. Controlled using + man.subheading.divider. + + + + Fixed many places where too much space was being added + between lines. + +                   + +                   +                   + + + + Release 1.68.1 + The release adds localization support for Farsi (thanks to + Sina Heshmati) and improved support for the XLink-based DocBook NG + db:link element. Other than that, it is a minor + bug-fix update to the 1.68.0 release. The main thing it fixes is a + build error that caused the XSLT Java extensions to be jarred up + with the wrong package structure. Thanks to Jens Stavnstrup for + quickly reporting the problem, and to Mauritz Jeanson for + investigating and finding the cause. + + + + + Release 1.68.0 + This release includes some features changes, particularly + for FO/PDF output, and a number of bug fixes. + + FO + + Moved footnote properties to attribute-sets. + + + Added support for side floats, margin notes, and + custom floats. + + + Added new parameters + body.start.indent and + body.end.indent to the + set.flow.properties template. + + + Added support for xml:id + + + Added support for + refdescriptor. + + + Added support for multiple refnamedivs. + + + Added index.entry.properties + attribute-set to support customization of index + entries. + + + Added set.flow.properties + template call to each fo:flow + to support customizations entry point. + + + Add support for @floatstyle in + figure + + + Moved hardcoded properties for index division titles + to the index.div.title.properties + attribute-set. + + + Added support for + table-layout="auto" for XEP. + + + Added index.div.title.properties + attribute-set. + + + $verbose parameter is now + passed to most elements. + + + Added refentry to + toc in part, as it is + permitted by the DocBook schema/DTD. + + + Added backmatter elements and + article to toc in + part, since they are permitted by the + DocBook schema/DTD. + + + Added mode="toc" for + simplesect, since it is now permitted in + the toc if + simplesect.in.toc is set. + + + Moved hard-coded properties to + nongraphical.admonintion.properties + and graphical.admonition.properties + attribute sets. + + + Added support for sidebar-width and + float-type processing instructions in + sidebar. + + + For tables with HTML markup elements, added support + for dbfo bgcolor PI, the attribute-sets + named table.properties, + informaltable.properties, + table.table.properties, and + table.cell.padding. Also added + support for the templates named + table.cell.properties and + table.cell.block.properties so that + tabstyles can be implemented. Also added support for tables + containing only tr instead of + tbody with tr. + + + Added new paramater + hyphenate.verbatim.characters which + can specify characters after which a line break can occur in + verbatim environments. This parameter can be used to extend + the initial set of characters which contain only space and + non-breakable space. + + + Added itemizedlist.label.markup to enable + selection of different bullet symbol. Also added several + potential bullet characters, commented out by default. + + + Enabled all id's in XEP output for external olinking. + + + + + HTML + + Added support for + refdescriptor. + + + Added support for multiple refnamedivs. + + + Added support for xml:id + + + refsynopsisdiv as a section for + counting section levels + + + + Images + + Added new SVG admonition graphics and navigation images. + + + + + + + + Release 1.67.2 + This release fixes a table bug introduced in the 1.67.1 + release. + + + Release 1.67.1 + This release includes a number of bug fixes. + The following lists provide details about API and feature changes. + + FO + + Tables: Inherited cell properties are now passed to the + table.cell.properties template so they can + be overridden by a customization. + + + Tables: Added support for bgcolor PI on table row + element. + + + TOCs: Added new parameter + simplesect.in.toc; default value of + 0 causes simplesect to be omitted from TOCs; to + cause simplesect to be included in TOCs, you + must set the value of simplesect.in.toc to + 1.Comment from Norm: + +
                  + Simplesect elements aren't supposed to + appear in the ToC at all... The use case for simplesect + is when, for example, every chapter in a book ends with + "Exercises" or "For More Information" sections and you + don't want those to appear in the ToC. +
                  +                   +                   + + Sections: Reverted change that caused a variable reference + to be used in a template match and rewrote code to preserve + intended semantics. + + + Lists: Added workaround to prevent "* 0.60 + 1em" garbage in + list output from PassiveTeX + + + Moved the literal attributes from + component.title to the + component.title.properties attribute-set so + they can be customized. + + + Lists: Added glossdef's first + para to special handling in + fo:list-item-body. + +                   + + + HTML + + TOCs: Added new parameter + simplesect.in.toc; for details, see + the list of changes for this + release. + + + Indexing: Added new parameter + index.prefer.titleabbrev; when set to + 1, index references will use + titleabbrev instead of + title when available. + + + + HTML Help + + Added support for generating windows-1252-encoded + output using Saxon; for more details, see the list of changes for this release. + + + + man pages + + Replaced named/numeric character-entity references for + non-breaking space with groff equivalent (backslash-tilde). + + + + XSL Java extensions + + Saxon extensions: Added the + Windows1252 class. It extends Saxon + 6.5.x with the windows-1252 character set, which is + particularly useful when generating HTML Help for Western + European Languages (code from + Pontus + Haglund and contributed to the + DocBook community by Sectra AB, Sweden). + To use: + + + Make sure that the Saxon 6.5.x jar file and the jar file for + the DocBook XSL Java extensions are in your CLASSPATH + + + Create a DocBook XSL customization layer -- a file named + mystylesheet.xsl or whatever -- that, at a + minimum, contains the following: + <xsl:stylesheet + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/htmlhelp/htmlhelp.xsl"/> + <xsl:output method="html" encoding="WINDOWS-1252" indent="no"/> + <xsl:param name="htmlhelp.encoding" select="'WINDOWS-1252'"></xsl:param> + <xsl:param name="chunker.output.encoding" select="'WINDOWS-1252'"></xsl:param> + <xsl:param name="saxon.character.representation" select="'native'"></xsl:param> + </xsl:stylesheet> + + Invoke Saxon with the + encoding.windows-1252 Java system property set + to com.nwalsh.saxon.Windows1252; for example + java \ + -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ + com.icl.saxon.StyleSheet \ + mydoc.xml mystylesheet.xsl + + Or, for a more complete "real world" case showing other + options you'll typically want to use: + java \ + -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ + -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \ + -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \ + -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \ + com.icl.saxon.StyleSheet \ + -x org.apache.xml.resolver.tools.ResolvingXMLReader \ + -y org.apache.xml.resolver.tools.ResolvingXMLReader \ + -r org.apache.xml.resolver.tools.CatalogResolver \ + mydoc.xml mystylesheet.xsl + + In both cases, the "mystylesheet.xsl" file should be a + DocBook customization layer containing the parameters + show in step 2. + + + + + + Saxon extensions: Removed Saxon 8 extensions from release package + + +                   +                   + + Release 1.67.0 + + + A number of important bug fixes. + + + Added Saxon8 extensions + + + Enabled dbfo table-width on + entrytbl in FO output + + + Added support for role=strong on + emphasis in FO output + + + Added new FO parameter + hyphenate.verbatim that can be used to turn + on "intelligent" wrapping of verbatim environments. + + + Replaced all <tt></tt> output with + <code></code> + + + Changed admon.graphic.width template to a + mode so that different admonitions can have different graphical + widths. + + + Deprecated the HTML shade.verbatim + parameter (use CSS instead) + + + Wrapped ToC + refentrytitle/refname and + refpurpose in span with class values. This + makes it possible to style them using a CSS stylesheet. + + + Use strong/em instead of + b/i in HTML output + + + Added support for converting Emphasis to + groff italic and Emphasis role='bold' to + bold. Controlled by + emphasis.propagates.style param, but not + documented yet using litprog system. Will do that next (planning + to add some other parameter-controllable options for hyphenation + and handling of line spacing). + + + callout.graphics.number.limit.xml + param: Changed the default from 10 to + 15. + + + verbatim.properties: Added + hyphenate=false + + + Saxon and Xalan Text.java extensions: Added support for + URIResolver() on insertfile href's + + + Added generated RELEASE-NOTES.txt + file. + + + Added INSTALL file (executable file for + generating catalog.xml) + + + Removed obsolete tools directory from + package + + + + +Release 1.66.1 + + +A number of important bug fixes. + + + + +Now xml:base attributes that are generated by an +XInclude processor are resolved for image files. + + + + +Rewrote olink templates to support several new features. + + + + +Extended full olink support to FO output. + + + + +Add support for xrefstyle attribute in olinks. + + + + +New parameters to support new olink features: +insert.olink.page.number, insert.olink.pdf.frag, +olink.debug, olink.lang.fallback.sequence, olink.properties, +prefer.internal.olink. +See the reference page for each parameter for more +information. + + + + + +Added index.on.type parameter for new type +attribute introduced in DocBook 4.3 for indexterms and index. +This allows you to create multiple indices containing +different categories of entries. +For users of 4.2 and earlier, you can use the new parameter index.on.role +instead. + + + + +Added new +section.autolabel.max.depth parameter to turn off section numbering +below a certain depth. +This permits you to number major section levels and leave minor +section levels unnumbered. + + + +Added footnote.sep.leader.properties attribute set to format +the line separating footnotes in printed output. + + + + +Added parameter img.src.path as a prefix to HTML img src +attributes. +The prefix is added to whatever path is already generated by the +stylesheet for each image file. + + + +Added new attribute-sets +informalequation.properties, +informalexample.properties, +informalfigure.properties, and informaltable.properties, +so each such element type can be formatted +individually if needed. + + + + +Add component.label.includes.part.label +parameter to add any part number to chapter, appendix +and other component labels when +the label.from.part parameter is nonzero. +This permits you to distinguish multiple chapters with the same +chapter number in cross references and the TOC. + + + +Added chunk.separate.lots parameter for HTML output. +This parameter lets you generate separate chunk files for each LOT +(list of tables, list of figures, etc.). + + +Added several table features: + + + +Added table.table.properties attribute set to add +properties to the fo:table element. + + + + +Added placeholder templates named table.cell.properties +and table.cell.block.properties to enable adding properties +to any fo:table-cell or the cell's fo:block, respectively. + These templates are a start for implementing table styles. + + + + + +Added new attribute +set component.title.properties for easy modifications of +component's title formatting in FO output. + + + + +Added Saxon support for an encoding attribute on the textdata element. Added new parameter +textdata.default.encoding which specifies encoding when +encoding attribute on +textdata is missing. + + + + +Template label.this.section now controls whole +section label, not only sub-label which corresponds to +particular label. Former behaviour was IMHO bug as it was +not usable. + + + + +Formatting in titleabbrev for TOC and headers +is preserved when there are no hotlink elements in the title. Formerly the title showed only the text of the title, no font changes or other markup. + + + + +Added intial.page.number template to set the initial-page-number +property for page sequences in print output. +Customizing this template lets you change when page numbering restarts. This is similar to the format.page.number template that lets you change how the page number formatting changes in the output. + + + + +Added force.page.count template to set the force-page-count +property for page sequences in print output. +This is similar to the format.page.number template. + + + + +Sort language for localized index sorting in autoidx-ng.xsl is now taken from document +lang, not from system environment. + + + + +Numbering and formatting of normal +and ulink footnotes (if turned on) has been unified. +Now ulink footnotes are mixed in with any other footnotes. + + + +Added support for renderas attribute in section and +sect1 et al. +This permits you to render a given section title as if it were a different level. + + + +Added support for label attribute in footnote to manually +supply the footnote mark. + + + + +Added support for DocBook 4.3 corpcredit element. + + + + +Added support for a dbfo keep-together PI for +formal objects (table, figure, example, equation, programlisting). That permits a formal object to be kept together if it is not already, or to be broken if it +is very long and the +default keep-together is not appropriate. + + + + +For graphics files, made file extension matching case +insensitive, and updated the list of graphics extensions. + + + + +Allow calloutlist to have block content before +the first callout + + + + +Added dbfo-need processing instruction to provide +soft page breaks. + + + + +Added implementation of existing but unused +default.image.width parameter for graphics. + + + + +Support DocBook NG tag inline element. + + + + +It appears that XEP now supports Unicode characters in +bookmarks. There is no further need to strip accents from +characters. + + + + +Make segmentedlist HTML markup +more semantic and available to CSS styles. + + + + +Added user.preroot placeholder template to +permit xsl-stylesheet and other PIs and comments to be +output before the HTML root element. + + + + +Non-chunked legalnotice now gets an <a +name="id"> element in HTML output +so it can be referenced with xref or link. + + + + +In chunked HTML output, changed link rel="home" to rel="start", +and link rel="previous" to rel="prev", per W3C HTML 4.01 +spec. + + + + +Added several patches to htmlhelp from W. Borgert + + + + +Added Bosnian locale file as common/bs.xml. + + + + + +Release 1.65.0 + + +A number of important bug fixes. + + + +Added a workaround to allow these stylesheets to process DocBook NG +documents. (It’s a hack that pre-processes the document to strip off the +namespace and then uses exsl:node-set to process +the result.) + + + +Added alternative indexing mechanism which has better +internationalization support. New indexing method allows grouping of +accented letters like e, é, ë into the same group under letter "e". It +can also treat special letters (e.g. "ch") as one character and place +them in the correct position (e.g. between "h" and "i" in Czech +language). +In order to use this mechanism you must create customization +layer which imports some base stylesheet (like +fo/docbook.xsl, +html/chunk.xsl) and then includes appropriate +stylesheet with new indexing code +(fo/autoidx-ng.xsl or +html/autoidx-ng.xsl). For example: +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/> +<xsl:include href="http://docbook.sourceforge.net/release/xsl/current/fo/autoidx-ng.xsl"/> + +</xsl:stylesheet> +New method is known to work with Saxon and it should also work +with xsltproc 1.1.1 and later. Currently supported languages are +English, Czech, German, French, Spanish and Danish. + + + + +Release 1.64.1 + +General bug fixes and improvements. Sorry about the failure to produce +an updated release notes file for 1.62.0—1.63.2 + +In the course of fixing bug #849787, wrapping Unicode callouts +with an appropriate font change in the Xalan extensions, I discovered +that the Xalan APIs have changed a bit. So xalan2.jar +will work with older Xalan 2 implementations, xalan25.jar +works with Xalan 2.5. + + + + +Release 1.61.0 + +Lots of bug fixes and improvements. + +Initial support for timestamp PI. From now you + can use <?dbtimestamp format="Y-m-d H:M:S"?> to get current + datetime in your document. Added localization support for datetime PI + + + +Added level 6 to test for section depth in +section.level template so that +section.title.level6.properties will be used for sections +that are 6 deep or deeper. This should also cause a h6 to be +created in html output. + + + +Don't use SVG graphics if use.svg=0 + + + +Now uses number-and-title-template for sections + only if section.autolabel is not zero. + + + +Added missing 'english-language-name' attribute to +the l10n element, and the missing 'style' attribute to the +template element so the current gentext documents will +validate. + + + +Corrected several references to parameter + qanda.defaultlabel that were missing the "$". + + + +Now accepts admon.textlabel parameter to turn off + Note, Warning, etc. label. + + + +FeatReq #684561: support more XEP metadata + + + +Added hyphenation support. Added support for coref. +Added beginpage support. (does nothing; see TDG). + + + +Added support for +hyphenation-character, hyphenation-push-character-count, and +hyphenation-remain-character-count + + + +Added root.properties, +ebnf.assignment, +and ebnf.statement.terminator + + + +Support bgcolor PI in table cells; make sure +rowsep and colsep don't have any effect on the last row or +column + + + +Handle othercredit on titlepage a little +better + + + +Applied fix from Jeff Beal that fixed the bug +that put secondary page numbers on primary entries. Same +with tertiary page numbers on secondary entries. + + + +Added definition of missing variable +collection. + + + +Make footnote formatting 'normal' even when it +occurs in a context that has special formatting + + + +Added warning when glossary.collection is not +blank, but it cannot open the specified file. + + + +Pick up the frame attribute on table and +informaltable. + + + +indexdiv/title +in non-autogenerated indexes are +now picked up. + + + +Removed (unused) +component.title.properties + + + +Move IDs from +page-sequences down to titlepage blocks + + + +Use +proportional-column-width(1) on more tables. + +Use proportional-column-width() for +header/footer tables; suppress relative-align when when +using FOP + + + +Check for glossterm.auto.link when linking +firstterms; don't output gl. prefix on glossterm links + + + +Generate Part ToCs + + + +Support glossary, bibliography, +and index in component ToCs. + + + +Refactored chunking code so that +customization of chunk algorithm and chunk elements is more +practical + + + +Support textobject/phrase +on inlinemediaobject. + + + +Support 'start' PI on ordered lists + + + +Fixed test of $toc PI to turn on qandaset TOC. + + + +Added process.chunk.footnotes to sect2 through +5 to fix bug of missing footnotes when chunk level greater +than 1. + + + +Added +paramater toc.max.depth which controls maximal depth of ToC +as requested by PHP-DOC group. + + + +Exempted titleabbrev from preamble processing in +lists, and fixed variablelist preamble code to use the same +syntax as the other lists. + + + +Added support for elements between variablelist +and first varlistentry since DocBook 4.2 supports that now. + + + + + +Release 1.60.1 + +Lots of bug fixes. + +The format of the titlepage.templates.xml files and +the stylesheet that transforms them have been significantly changed. All of the +attributes used to control the templates are now namespace qualified. So what +used to be: +<t:titlepage element="article" wrapper="fo:block"> +is now: +<t:titlepage t:element="article" t:wrapper="fo:block"> +Attributes from other namespaces (including those that are unqualified) are +now copied directly through. In practice, this means that the names that used +to be fo: qualified: +<title named-template="component.title" + param:node="ancestor-or-self::article[1]" + fo:text-align="center" + fo:keep-with-next="always" + fo:font-size="&hsize5;" + fo:font-weight="bold" + fo:font-family="{$title.font.family}"/> +are now unqualified: +<title t:named-template="component.title" + param:node="ancestor-or-self::article[1]" + text-align="center" + keep-with-next="always" + font-size="&hsize5;" + font-weight="bold" + font-family="{$title.font.family}"/> +The t:titlepage and t:titlepage-content +elements both generate wrappers now. And unqualified attributes on those elements +are passed through. This means that you can now make the title font apply to +ane entire titlepage and make the entire recto +titlepage centered by specifying the font and alignment on the those elements: +<t:titlepage t:element="article" t:wrapper="fo:block" + font-family="{$title.font.family}"> + + <t:titlepage-content t:side="recto" + text-align="center"> + + + + + + + +Support use of titleabbrev in running +headers and footers. + + + +Added (experimental) xref.with.number.and.title +parameter to enable number/title cross references even when the +default would +be just the number. + + + +Generate part ToCs if they're requested. + + + +Use proportional-column-width() in header/footer tables. + + + +Handle alignment correctly when screenshot +wraps a graphic in a figure. + + + +Format chapter and appendix +cross references consistently. + + + +Attempt to support tables with multiple tgroups +in FO. + + + +Output fo:table-columns in +simplelist tables. + + + +Use titlepage.templates.xml for +indexdiv and glossdiv formatting. + + + +Improve support for new bibliography elements. + + + +Added +footnote.number.format, +table.footnote.number.format, +footnote.number.symbols, and +table.footnote.number.symbols for better control of +footnote markers. + + + +Added glossentry.show.acronyms. + + + +Suppress the draft-mode page masters when +draft-mode is no. + + + +Make blank pages verso not recto. D'Oh! + + + +Improved formatting of ulink footnotes. + + + +Fixed bugs in graphic width/height calculations. + + + +Added class attributes to inline elements. + + + +Don't add .html to the filenames identified +with the dbhtml PI. + + + +Don't force a ToC when sections contain refentrys. + + + +Make section title sizes a function of the +body.master.size. + + + + + +Release 1.59.2 + +The 1.59.2 fixes an FO bug in the page masters that causes FOP to fail. + + +Removed the region-name from the region-body of blank pages. There's +no reason to give the body of blank pages a unique name and doing so causes +a mismatch that FOP detects. + + + +Output IDs for the first paragraphs in listitems. + + + +Fixed some small bugs in the handling of page numbers in double-sided mode. + + + +Attempt to prevent duplicated IDs from being produced when +endterm on xref points +to something with nested structure. + + + +Fix aligment problems in equations. + + + +Output the type attribute on unordered lists (UL) in HTML only if +the css.decoration parameter is true. + + + +Calculate the font size in formal.title.properties so that it's 1.2 times +the base font size, not a fixed "12pt". + + + + + +Release 1.59.1 + +The 1.59.1 fixes a few bugs. + + +Added Bulgarian localization. + + + +Indexing improvements; localize book indexes to books but allow setindex +to index an entire set. + + + +The default value for rowsep and colsep is now "1" as per CALS. + + + +Added support for titleabbrev (use them for cross +references). + + + +Improvements to mediaobject for selecting print vs. online +images. + + + +Added seperate property sets for figures, +examples, equations, tabless, +and procedures. + + + +Make lineannotations italic. + + + +Support xrefstyle attribute. + + + +Make endterm on +xref higher priority than +xreflabel target. + + + +Glossary formatting improvements. + + + + + +Release 1.58.0 + +The 1.58.0 adds some initial support for extensions in xsltproc, adds +a few features, and fixes bugs. + + +This release contains the first attempt at extension support for xsltproc. +The only extension available to date is the one that adjusts table column widths. +Run extensions/xsltproc/python/xslt.py. + + + +Fixed bugs in calculation of adjusted column widths to correct for rounding +errors. + + + +Support nested refsection elements correctly. + + + +Reworked gentext.template to take context into consideration. +The name of elements in localization files is now an xpath-like context list, not +just a simple name. + + + +Made some improvements to bibliography formatting. + + + +Improved graphical formatting of admonitions. + + + +Added support for entrytbl. + + + +Support spanning index terms. + + + +Support bibliosource. + + + + + +Release 1.57.0 + + +The 1.57.0 release wasn't documented here. Oops. + + + + + +Release 1.56.0 + +The 1.56.0 release fixes bugs. + + +Reworked chunking. This will break all existing customizations +layers that change the chunking algorithm. If you're customizing chunking, +look at the new content parameter that's passed to +process-chunk-element and friends. + + + +Support continued and inherited numeration in orderedlist +formatting for FOs. + + + +Added Thai localization. + + + +Tweaked stylesheet documentation stylesheets to link to TDG and +the parameter references. + + + +Allow title on tables of contents ("Table of Contents") to be optional. +Added new keyword to generate.toc. +Support tables of contents on sections. + + + +Made separate parameters for table borders and table cell borders: +table.frame.border.color, +table.frame.border.style, +table.frame.border.thickness, +table.cell.border.color, +table.cell.border.style, and +table.cell.border.thickness. + + + +Suppress formatting of endofrange indexterms. +This is only half-right. They should generate a range, but I haven't figured out how +to do that yet. + + + +Support revdescription. (Bug #582192) + + + +Added default.float.class and fixed figure +floats. (Bug #497603) + + + +Fixed formatting of sbr in FOs. + + + +Added context to the missing template error message. + + + +Process arg correctly in a group. +(Bug #605150) + + + +Removed 'keep-with-next' from formal.title.properties +attribute set now that the stylesheets support the option of putting +such titles below the object. Now the $placement value determines if +'keep-with-next' or 'keep-with-previous' is used in the title block. + + + +Wrap url() around external-destinations when appropriate. + + + +Fixed typo in compact list spacing. (Bug #615464) + + + +Removed spurious hash in anchor name. (Bug #617717) + + + +Address is now displayed verbatim on title pages. (Bug #618600) + + + +The bridgehead.in.toc parameter is now properly +supported. + + + +Improved effectiveness of HTML cleanup by increasing the number +of places where it is used. Improve use of HTML cleanup in XHTML stylesheets. + + + +Support table of contents for appendix in +article. (Bug #596599) + + + +Don't duplicate footnotes in bibliographys and +glossarys. (Bug #583282) + + + +Added default.image.width. (Bug #516859) + + + +Totally reworked funcsynopsis code; it now +supports a 'tabular' presentation style for 'wide' prototypes; see +funcsynopsis.tabular.threshold. (HTML only +right now, I think, FO support, uh, real soon now.) + + + +Reworked support for difference marking; toned down the colors a bit +and added a system.head.content template so that the diff CSS +wasn't overriding user.head.content. (Bug #610660) + + + +Added call to the *.head.content elements when writing +out long description chunks. + + + +Make sure legalnotice link is correct even when +chunking to a different base.dir. + + + +Use CSS to set viewport characteristics if +css.decoration is non-zero, use div instead of p for making +graphic a block element; make figure titles the +default alt +text for images in a figure. + + +Added space-after to list.block.spacing. + + + +Reworked section.level template to give correct answer +instead of being off by one. + + + +When processing tables, use the tabstyle +attribute as the division class. + + + +Fixed bug in html2xhtml.xsl that was causing the +XHTML chunker to output HTML instead of XHTML. + + + + + + Older releases + To view the release notes for older releases, see http://cvs.sourceforge.net/viewcvs.py/docbook/xsl/RELEASE-NOTES.xml. Be + aware that there were no release notes for releases prior to the + 1.50.0 release. + + + About dot-zero releases + DocBook Project dot zero releases should be + considered experimental and are always + followed by stable dot one releases, usually within + two or three weeks. Please help to ensure the stability of + dot one releases by carefully testing each + dot zero release and reporting back about any + problems you find. + It is not recommended that you use a dot zero + release in a production system, or package it for an OS + distro. Instead, you should wait for the dot one + version. + + \ No newline at end of file diff --git a/src/documentation/docbook-xsl/TODO b/src/documentation/docbook-xsl/TODO new file mode 100644 index 0000000000..404c75431e --- /dev/null +++ b/src/documentation/docbook-xsl/TODO @@ -0,0 +1,5 @@ +For information about pending DocBook XSL stylesheets feature +requests, see the following: + + http://sourceforge.net/tracker/?atid=373750&group_id=21935&func=browse + http://sourceforge.net/tracker/?atid=516914&group_id=21935&func=browse diff --git a/src/documentation/docbook-xsl/VERSION b/src/documentation/docbook-xsl/VERSION new file mode 100644 index 0000000000..4f587689b0 --- /dev/null +++ b/src/documentation/docbook-xsl/VERSION @@ -0,0 +1,86 @@ + + + + + + + + + DocBook + XSL Stylesheets + 1.70.1 + + + + + + Minor feature enhancements + + + + + + + http://sourceforge.net/projects/docbook/ + http://prdownloads.sourceforge.net/docbook/docbook-xsl-{VERSION}.tar.gz?download + http://prdownloads.sourceforge.net/docbook/docbook-xsl-{VERSION}.zip?download + http://prdownloads.sourceforge.net/docbook/docbook-xsl-{VERSION}.bz2?download + http://sourceforge.net/project/shownotes.php?release_id={SFRELID} + http://docbook.cvs.sourceforge.net/docbook/ + http://lists.oasis-open.org/archives/docbook-apps/ + This is a stable release of the 1.70 stylesheets. It + includes only a few small changes from 1.70.0. + + + + + + + You must specify the sf-relid as a parameter. + + + + + + + + + + + + + + + + + + : + + + + + + + + + : + + + + + + + + + : + + + + + diff --git a/src/documentation/docbook-xsl/catalog.xml b/src/documentation/docbook-xsl/catalog.xml new file mode 100644 index 0000000000..3a33b946d5 --- /dev/null +++ b/src/documentation/docbook-xsl/catalog.xml @@ -0,0 +1,8 @@ + + + + + + + + \ No newline at end of file diff --git a/src/documentation/docbook-xsl/common/af.xml b/src/documentation/docbook-xsl/common/af.xml new file mode 100644 index 0000000000..48e856df31 --- /dev/null +++ b/src/documentation/docbook-xsl/common/af.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/am.xml b/src/documentation/docbook-xsl/common/am.xml new file mode 100644 index 0000000000..8f73569755 --- /dev/null +++ b/src/documentation/docbook-xsl/common/am.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ምልክቶች + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/ar.xml b/src/documentation/docbook-xsl/common/ar.xml new file mode 100644 index 0000000000..f9c33af546 --- /dev/null +++ b/src/documentation/docbook-xsl/common/ar.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/autoidx-ng.xsl b/src/documentation/docbook-xsl/common/autoidx-ng.xsl new file mode 100644 index 0000000000..abddb6fc63 --- /dev/null +++ b/src/documentation/docbook-xsl/common/autoidx-ng.xsl @@ -0,0 +1,146 @@ + + + + + + +]> + + + + + + + + + + + + + + + + + + + + + + + + + + + No " + + " localization of index grouping letters exists + + + . + + + ; using "en". + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + No " + + " localization of index grouping letters exists + + + . + + + ; using "en". + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/common/az.xml b/src/documentation/docbook-xsl/common/az.xml new file mode 100644 index 0000000000..edc66e55fe --- /dev/null +++ b/src/documentation/docbook-xsl/common/az.xml @@ -0,0 +1,632 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + İşarələr + A + a + B + b + C + c + Ç + ç + D + d + E + e + e + e + Ə + ə + G + g + Ğ + ğ + H + h + X + x + I + ı + İ + i + J + j + K + k + Q + q + L + l + M + m + N + n + O + o + Ö + ö + P + p + R + r + S + s + Ş + ş + T + t + U + u + Ü + ü + V + v + Y + y + Z + z + + diff --git a/src/documentation/docbook-xsl/common/bg.xml b/src/documentation/docbook-xsl/common/bg.xml new file mode 100644 index 0000000000..cc1f45244a --- /dev/null +++ b/src/documentation/docbook-xsl/common/bg.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/bn.xml b/src/documentation/docbook-xsl/common/bn.xml new file mode 100644 index 0000000000..d5a94620f6 --- /dev/null +++ b/src/documentation/docbook-xsl/common/bn.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/bs.xml b/src/documentation/docbook-xsl/common/bs.xml new file mode 100644 index 0000000000..dde47ea950 --- /dev/null +++ b/src/documentation/docbook-xsl/common/bs.xml @@ -0,0 +1,622 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Simboli + A + a + B + b + C + c + Ć + ć + Č + č + D + d + Đ + đ + E + e + F + f + G + g + H + h + I + i + J + j + K + k + L + l + M + m + N + n + O + o + P + p + R + r + S + s + Š + š + T + t + U + u + V + v + Z + z + Ž + ž + + diff --git a/src/documentation/docbook-xsl/common/ca.xml b/src/documentation/docbook-xsl/common/ca.xml new file mode 100644 index 0000000000..215e491b83 --- /dev/null +++ b/src/documentation/docbook-xsl/common/ca.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/common.xsl b/src/documentation/docbook-xsl/common/common.xsl new file mode 100644 index 0000000000..0cd0c98026 --- /dev/null +++ b/src/documentation/docbook-xsl/common/common.xsl @@ -0,0 +1,2090 @@ + + + + + + + + +$Id: common.xsl,v 1.61 2006/05/04 12:28:02 nwalsh Exp $ + +Walsh +Norman +19992000 +Norman Walsh + + +Common Template Reference + + +
                  Introduction + +This is technical reference documentation for the DocBook XSL +Stylesheets; it documents (some of) the parameters, templates, and +other elements of the stylesheets. + +This is not intended to be user documentation. +It is provided for developers writing customization layers for the +stylesheets, and for anyone who's interested in how it +works. + +Although I am trying to be thorough, this documentation is known +to be incomplete. Don't forget to read the source, too :-) +
                  +                   + +                   + + + + + + + + + + +Tests if a given node is a component-level element + + +This template returns '1' if the specified node is a component +(Chapter, Appendix, etc.), and '0' otherwise. + + + + +node + +The node which is to be tested. + + + + + + +This template returns '1' if the specified node is a component +(Chapter, Appendix, etc.), and '0' otherwise. + + + + + + + 1 + 0 + + + + + + +Tests if a given node is a section-level element + + +This template returns '1' if the specified node is a section +(Section, Sect1, Sect2, etc.), and '0' otherwise. + + + + +node + +The node which is to be tested. + + + + + + +This template returns '1' if the specified node is a section +(Section, Sect1, Sect2, etc.), and '0' otherwise. + + + + + + + 1 + 0 + + + + + + +Returns the hierarchical level of a section + + +This template calculates the hierarchical level of a section. +The element sect1 is at level 1, sect2 is +at level 2, etc. + +Recursive sections are calculated down to the fifth level. + + + + +node + +The section node for which the level should be calculated. +Defaults to the context node. + + + + + + +The section level, 1, 2, etc. + + + + + + + + 1 + 2 + 3 + 4 + 5 + + + 6 + 5 + 4 + 3 + 2 + 1 + + + + + + + + + + 2 + 3 + 4 + 5 + 5 + + + 5 + 4 + 3 + 2 + + + 1 + + + 1 + + + + +Returns the hierarchical level of a QandASet + + +This template calculates the hierarchical level of a QandASet. + + + + +The level, 1, 2, etc. + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + 1 + 1 + 2 + 3 + + + 5 + 4 + 3 + 2 + 1 + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + question + answer + qandadiv + qandaset + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [FAMILY Given] + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +[ +] +{ +} + + +[ +] +... + + + | +4pi + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Selects and processes an appropriate media object from a list + + +This template takes a list of media objects (usually the +children of a mediaobject or inlinemediaobject) and processes +the "right" object. + +This template relies on a template named +"select.mediaobject.index" to determine which object +in the list is appropriate. + +If no acceptable object is located, nothing happens. + + + + +olist + +The node list of potential objects to examine. + + + + + + +Calls <xsl:apply-templates> on the selected object. + + + + + + + + + + + + + + + + + + + + + +Selects the position of the appropriate media object from a list + + +This template takes a list of media objects (usually the +children of a mediaobject or inlinemediaobject) and determines +the "right" object. It returns the position of that object +to be used by the calling template. + +If the parameter use.role.for.mediaobject +is nonzero, then it first checks for an object with +a role attribute of the appropriate value. It takes the first +of those. Otherwise, it takes the first acceptable object +through a recursive pass through the list. + +This template relies on a template named "is.acceptable.mediaobject" +to determine if a given object is an acceptable graphic. The semantics +of media objects is that the first acceptable graphic should be used. + + +If no acceptable object is located, no index is returned. + + + + +olist + +The node list of potential objects to examine. + + +count + +The position in the list currently being considered by the +recursive process. + + + + + + +Returns the position in the original list of the selected object. + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + 0 + + + + 0 + + + + 1 + + + + 0 + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Returns '1' if the specified media object is recognized + + +This template examines a media object and returns '1' if the +object is recognized as a graphic. + + + + +object + +The media object to consider. + + + + + + +0 or 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 1 + 1 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + . + + + + + + + + + + + + . + + + + + + + + + + + + + + + + +Warn users about references to non-unique IDs + +If passed an ID in linkend, +check.id.unique prints +a warning message to the user if either the ID does not exist or +the ID is not unique. + + + + + + + + + + + + Error: no ID for constraint linkend: + + . + + + + + + + Warning: multiple "IDs" for constraint linkend: + + . + + + + + + +Warn users about incorrectly typed references + +If passed an ID in linkend, +check.idref.targets makes sure that the element +pointed to by the link is one of the elements listed in +element-list and warns the user otherwise. + + + + + + + + + + + + + + Error: linkend ( + + ) points to " + + " not (one of): + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unexpected context in procedure.step.numeration: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + 2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + loweralpha + lowerroman + upperalpha + upperroman + arabic + arabic + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + circle + square + disc + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Print a set of years with collapsed ranges + + +This template prints a list of year elements with consecutive +years printed as a range. In other words: + +1992 +1993 +1994]]> + +is printed 1992-1994, whereas: + +1992 +1994]]> + +is printed 1992, 1994. + +This template assumes that all the year elements contain only +decimal year numbers, that the elements are sorted in increasing +numerical order, that there are no duplicates, and that all the years +are expressed in full century+year +(1999 not 99) notation. + + + + +years + +The initial set of year elements. + + +print.ranges + +If non-zero, multi-year ranges are collapsed. If zero, all years +are printed discretely. + + +single.year.ranges + +If non-zero, two consecutive years will be printed as a range, +otherwise, they will be printed discretely. In other words, a single +year range is 1991-1992 but discretely it's +1991, 1992. + + + + + + +This template returns the formatted list of years. + + + + + + + + + + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + , + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + , + + + + , + + , + + + + - + + , + + + + + + + + + + + + + + + + +Search in a table for the "best" match for the node + + +This template searches in a table for the value that most-closely +(in the typical best-match sense of XSLT) matches the current (element) +node location. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + +Converts a string to all uppercase letters + + +Given a string, this template does a language-aware conversion +of that string to all uppercase letters, based on the values of the +lowercase.alpha and +uppercase.alpha gentext keys for the current +locale. It affects only those characters found in the values of +lowercase.alpha and +uppercase.alpha. All other characters are left +unchanged. + + + + +string + +The string to convert to uppercase. + + + + + + + + + + + + + + + + + + + + + + + + +Converts a string to all lowercase letters + + +Given a string, this template does a language-aware conversion +of that string to all lowercase letters, based on the values of the +uppercase.alpha and +lowercase.alpha gentext keys for the current +locale. It affects only those characters found in the values of +uppercase.alpha and +lowercase.alpha. All other characters are left +unchanged. + + + + +string + +The string to convert to lowercase. + + + + + + + + + + + + + + + + + + + + + + + + + Returns localized choice separator + + This template enables auto-generation of an appropriate + localized "choice" separator (for example, "and" or "or") before + the final item in an inline list (though it could also be useful + for generating choice separators for non-inline lists). + + It currently works by evaluating a processing instruction + (PI) of the form <?dbchoice choice="foo"?> : + + + + if the value of the choice + pseudo-attribute is "and" or "or", returns a localized "and" + or "or" + + + otherwise returns the literal value of the + choice pseudo-attribute + + + + The latter is provided only as a temporary workaround because the + locale files do not currently have translations for the word + or. So if you want to generate a a + logical "or" separator in French (for example), you currently need + to do this: + + <?dbchoice choice="ou"?> + + + + The dbchoice processing instruction is + an unfortunate hack; support for it may disappear in the future + (particularly if and when a more appropriate means for marking + up "choice" lists becomes available in DocBook). + + + + + + + + + + choice + + + + + + + + + + + + + + + + + + + + + + Evaluates an info profile + + This function evaluates an "info profile" matching the XPath + expression given by the profile + parameter. It relies on the XSLT evaluate() + extension function. + + The value of the profile parameter + can include the literal string $info. If found + in the value of the profile parameter, the + literal string $info string is replaced with + the value of the info parameter, which + should be a set of *info nodes; the + expression is then evaluated using the XSLT + evaluate() extension function. + + + + + profile + + A string representing an XPath expression + + + + info + + A set of *info nodes + + + + + + + Returns a node (the result of evaluating the + profile parameter) + + + + + + + + + + + + + + + + + +Error: The "info profiling" mechanism currently requires an XSLT +engine that supports the evaluate() XSLT extension function. Your XSLT +engine does not support it. + + + + + + + + + Logs/emits formatted notes and warnings + + + The log.message function is a utility + function for logging/emitting formatted messages – that is, + notes and warnings, along with a given log "level" and an + identifier for the "source" that the message relates to. + + + + + + level + + Text to indicate the message level + (Note or + Warning) + + + + source + + Text to identify source element the + notification/warning relates to + + + + message + + Message to lot/emit + + + + message-width + + Expected maximum message width + + + + + + Outputs a message (generally, to standard error). + + + + + + + 50 + : + + + + + +                   diff --git a/src/documentation/docbook-xsl/common/cs.xml b/src/documentation/docbook-xsl/common/cs.xml new file mode 100644 index 0000000000..04e74154cb --- /dev/null +++ b/src/documentation/docbook-xsl/common/cs.xml @@ -0,0 +1,660 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symboly + A + a + Á + á + B + b + C + c + Č + č + D + d + Ď + ď + E + e + É + é + Ě + ě + Ë + ë + F + f + G + g + H + h + Ch + ch + cH + CH + I + i + Í + í + J + j + K + k + L + l + M + m + N + n + Ň + ň + O + o + Ó + ó + Ö + ö + P + p + Q + q + R + r + Ř + ř + S + s + Š + š + T + t + Ť + ť + U + u + Ú + ú + Ů + ů + Ü + ü + V + v + W + w + X + x + Y + y + Ý + ý + Z + z + Ž + ž + + diff --git a/src/documentation/docbook-xsl/common/cy.xml b/src/documentation/docbook-xsl/common/cy.xml new file mode 100644 index 0000000000..e5073cedce --- /dev/null +++ b/src/documentation/docbook-xsl/common/cy.xml @@ -0,0 +1,1205 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + Ch + ch + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + Dd + dd + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + Ff + ff + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + Ng + ng + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + Ll + ll + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Ph + ph + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + Rh + rh + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + Th + th + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/da.xml b/src/documentation/docbook-xsl/common/da.xml new file mode 100644 index 0000000000..92be3d8fa5 --- /dev/null +++ b/src/documentation/docbook-xsl/common/da.xml @@ -0,0 +1,624 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A + a + B + b + C + c + D + d + E + e + F + f + G + g + H + h + I + i + J + j + K + k + L + l + M + m + N + n + O + o + P + p + Q + q + R + r + S + s + T + t + U + u + V + v + W + w + X + x + Y + y + Z + z + Æ + æ + Ø + ø + Å + å + + diff --git a/src/documentation/docbook-xsl/common/de.xml b/src/documentation/docbook-xsl/common/de.xml new file mode 100644 index 0000000000..8d71106c8c --- /dev/null +++ b/src/documentation/docbook-xsl/common/de.xml @@ -0,0 +1,626 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbole + A + a + Ä + ä + B + b + C + c + D + d + E + e + F + f + G + g + H + h + I + i + J + j + K + k + L + l + M + m + N + n + O + o + Ö + ö + P + p + Q + q + R + r + S + s + T + t + U + u + Ü + ü + V + v + W + w + X + x + Y + y + Z + z + + diff --git a/src/documentation/docbook-xsl/common/el.xml b/src/documentation/docbook-xsl/common/el.xml new file mode 100644 index 0000000000..2306a121e0 --- /dev/null +++ b/src/documentation/docbook-xsl/common/el.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/en.xml b/src/documentation/docbook-xsl/common/en.xml new file mode 100644 index 0000000000..4a6470a617 --- /dev/null +++ b/src/documentation/docbook-xsl/common/en.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/es.xml b/src/documentation/docbook-xsl/common/es.xml new file mode 100644 index 0000000000..632573d0a5 --- /dev/null +++ b/src/documentation/docbook-xsl/common/es.xml @@ -0,0 +1,636 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Símbolos + A + a + á + Á + B + b + C + c + CH + ch + D + d + E + e + É + é + F + f + G + g + H + h + I + i + Í + í + J + j + K + k + L + l + LL + ll + M + m + N + n + Ñ + ñ + O + o + Ó + ó + P + p + Q + q + R + r + S + s + T + t + U + u + Ú + ú + V + v + W + w + X + x + Y + y + Z + z + + diff --git a/src/documentation/docbook-xsl/common/et.xml b/src/documentation/docbook-xsl/common/et.xml new file mode 100644 index 0000000000..4e2b81e5a4 --- /dev/null +++ b/src/documentation/docbook-xsl/common/et.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/eu.xml b/src/documentation/docbook-xsl/common/eu.xml new file mode 100644 index 0000000000..b1405c6865 --- /dev/null +++ b/src/documentation/docbook-xsl/common/eu.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/fa.xml b/src/documentation/docbook-xsl/common/fa.xml new file mode 100644 index 0000000000..36a63409b9 --- /dev/null +++ b/src/documentation/docbook-xsl/common/fa.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/fi.xml b/src/documentation/docbook-xsl/common/fi.xml new file mode 100644 index 0000000000..ed991ad012 --- /dev/null +++ b/src/documentation/docbook-xsl/common/fi.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/fr.xml b/src/documentation/docbook-xsl/common/fr.xml new file mode 100644 index 0000000000..17ba447cef --- /dev/null +++ b/src/documentation/docbook-xsl/common/fr.xml @@ -0,0 +1,650 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symboles + A + a + à + À + â +  + Æ + æ + B + b + C + c + ç + D + d + E + e + ê + Ê + é + É + è + È + ë + Ë + € + F + f + G + g + H + h + I + i + Î + î + Ï + ï + J + j + K + k + L + l + M + m + N + n + O + o + Ö + ö + Œ + œ + P + p + Q + q + R + r + S + s + T + t + U + u + Ù + ù + Û + û + Ü + ü + V + v + W + w + X + x + Y + y + Z + z + + diff --git a/src/documentation/docbook-xsl/common/ga.xml b/src/documentation/docbook-xsl/common/ga.xml new file mode 100644 index 0000000000..b5382c47bf --- /dev/null +++ b/src/documentation/docbook-xsl/common/ga.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Siombailí + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/gentext.xsl b/src/documentation/docbook-xsl/common/gentext.xsl new file mode 100644 index 0000000000..25edce5ca1 --- /dev/null +++ b/src/documentation/docbook-xsl/common/gentext.xsl @@ -0,0 +1,831 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + .formal + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + object.xref.markup: empty xref template + for linkend=" + + " and @xrefstyle=" + + " + + + + + + + + + + + + + + + + + + + + + + + + + + + Xref is only supported to listitems in an + orderedlist: + + + ??? + + + + + + + + + + + + + + + + + + + + + + + + %n + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + Attempt to use %d in gentext with no referrer! + + + + + + + % + + + % + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + labelnumber + + + labelname + + + label + + + + + + + + quotedtitle + + + title + + + + + + + + + + + + + + nopage + + + pagenumber + + + pageabbrev + + + Page + + + page + + + + + + + + + + + nodocname + + + docnamelong + + + docname + + + + + + + + + + + + + + + + + + + + + + %n + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + %t + + + + + + %t + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + %p + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/common/gu.xml b/src/documentation/docbook-xsl/common/gu.xml new file mode 100644 index 0000000000..a5fcc15dc2 --- /dev/null +++ b/src/documentation/docbook-xsl/common/gu.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/he.xml b/src/documentation/docbook-xsl/common/he.xml new file mode 100644 index 0000000000..04397593ea --- /dev/null +++ b/src/documentation/docbook-xsl/common/he.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/hi.xml b/src/documentation/docbook-xsl/common/hi.xml new file mode 100644 index 0000000000..a2cc63b593 --- /dev/null +++ b/src/documentation/docbook-xsl/common/hi.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/hr.xml b/src/documentation/docbook-xsl/common/hr.xml new file mode 100644 index 0000000000..cd713a7ad9 --- /dev/null +++ b/src/documentation/docbook-xsl/common/hr.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/hu.xml b/src/documentation/docbook-xsl/common/hu.xml new file mode 100644 index 0000000000..0ff17d4c70 --- /dev/null +++ b/src/documentation/docbook-xsl/common/hu.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/id.xml b/src/documentation/docbook-xsl/common/id.xml new file mode 100644 index 0000000000..a4e77a469c --- /dev/null +++ b/src/documentation/docbook-xsl/common/id.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/insertfile.xsl b/src/documentation/docbook-xsl/common/insertfile.xsl new file mode 100644 index 0000000000..66d2b36c3c --- /dev/null +++ b/src/documentation/docbook-xsl/common/insertfile.xsl @@ -0,0 +1,111 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/common/it.xml b/src/documentation/docbook-xsl/common/it.xml new file mode 100644 index 0000000000..7849b0254e --- /dev/null +++ b/src/documentation/docbook-xsl/common/it.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/ja.xml b/src/documentation/docbook-xsl/common/ja.xml new file mode 100644 index 0000000000..d0de2c0933 --- /dev/null +++ b/src/documentation/docbook-xsl/common/ja.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/kn.xml b/src/documentation/docbook-xsl/common/kn.xml new file mode 100644 index 0000000000..94c4e95403 --- /dev/null +++ b/src/documentation/docbook-xsl/common/kn.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/ko.xml b/src/documentation/docbook-xsl/common/ko.xml new file mode 100644 index 0000000000..90bbbcc850 --- /dev/null +++ b/src/documentation/docbook-xsl/common/ko.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/l10n.dtd b/src/documentation/docbook-xsl/common/l10n.dtd new file mode 100644 index 0000000000..1d6f8361eb --- /dev/null +++ b/src/documentation/docbook-xsl/common/l10n.dtd @@ -0,0 +1,63 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/common/l10n.xml b/src/documentation/docbook-xsl/common/l10n.xml new file mode 100644 index 0000000000..39de81366f --- /dev/null +++ b/src/documentation/docbook-xsl/common/l10n.xml @@ -0,0 +1,123 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]> + +⁡ +&am; +&ar; +&az; +&bg; +&bn; +&bs; +&ca; +&cs; +&cy; +&da; +&de; +⪙ +&en; +&es; +&et; +&eu; +&fa; +&fi; +&fr; +&ga; +&gu; +&he; +&hi; +&hr; +&hu; +&id; +⁢ +&ja; +&kn; +&ko; +&la; +&lit; +&mn; +&nl; +&nn; +&no; +∨ +&pa; +&pl; +&pt; +&pt_br; +&ro; +&ru; +&sk; +&sl; +&sq; +&sr; +&sr_Latn; +&sv; +&ta; +&th; +&tl; +&tr; +&uk; +&vi; +&xh; +&zh_cn; +&zh_tw; + diff --git a/src/documentation/docbook-xsl/common/l10n.xsl b/src/documentation/docbook-xsl/common/l10n.xsl new file mode 100644 index 0000000000..69d4bee14b --- /dev/null +++ b/src/documentation/docbook-xsl/common/l10n.xsl @@ -0,0 +1,461 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + _ + + + + + + + + + + + + + + + + + + + + No localization exists for " + + " or " + + ". Using default " + + ". + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No " + + " localization of " + + " exists + + + . + + + ; using "en". + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + bullet + + + + + + + + + + + + + + + + + + No " + + " localization of dingbat + + exists; using "en". + + + + + + + + + + startquote + + + + + + endquote + + + + + + nestedstartquote + + + + + + nestedendquote + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No " + + " localization exists. + + + + + + + + + + No context named " + + " exists in the " + + " localization. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No template for " + + " (or any of its leaves) exists +in the context named " + + " in the " + + " localization. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + 1 + + + + + + + + + + + + + + 0 + + + + + + + diff --git a/src/documentation/docbook-xsl/common/la.xml b/src/documentation/docbook-xsl/common/la.xml new file mode 100644 index 0000000000..81b66243ea --- /dev/null +++ b/src/documentation/docbook-xsl/common/la.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/labels.xsl b/src/documentation/docbook-xsl/common/labels.xsl new file mode 100644 index 0000000000..8465279ee0 --- /dev/null +++ b/src/documentation/docbook-xsl/common/labels.xsl @@ -0,0 +1,840 @@ + + + + + + + + + + +Provides access to element labels + +Processing an element in the +label.markup mode produces the +element label. +Trailing punctuation is not added to the label. + + + + + + . + + + + + + + Request for label of unexpected element: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + label.markup: this can't happen! + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + a + i + A + I + + + + Unexpected numeration: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + +Returns true if $section should be labelled + +Returns true if the specified section should be labelled. +By default, this template returns zero unless +the section level is less than or equal to the value of the +$section.autolabel.max.depth parameter, in +which case it returns +$section.autolabel. +Custom stylesheets may override it to get more selective behavior. + + + + + + + + + + + + + + + 1 + + + + + + + + + + + 1 + + + + + + + + + + + + + + + Unexpected .autolabel value: + ; using default. + + + + + + + + + +Returns format for autolabel parameters + +Returns format passed as parameter if non zero. Supported + format are 'arabic' or '1', 'loweralpha' or 'a', 'lowerroman' or 'i', + 'uppoerlapha' or 'A', 'upperroman' or 'I'. If its not one of these then + returns the default format. + + + + + + diff --git a/src/documentation/docbook-xsl/common/lt.xml b/src/documentation/docbook-xsl/common/lt.xml new file mode 100644 index 0000000000..b1da912096 --- /dev/null +++ b/src/documentation/docbook-xsl/common/lt.xml @@ -0,0 +1,638 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Simboliai + A + a + Ą + ą + B + b + C + c + Č + č + D + d + E + e + Ę + ę + Ė + ė + F + f + G + g + H + h + I + i + Į + į + Y + y + J + j + K + k + L + l + M + m + N + n + O + o + P + p + R + r + S + s + Š + š + T + t + U + u + Ų + ų + Ū + ū + V + v + Z + z + Ž + ž + Q + q + W + w + X + x + + diff --git a/src/documentation/docbook-xsl/common/mn.xml b/src/documentation/docbook-xsl/common/mn.xml new file mode 100644 index 0000000000..510324e833 --- /dev/null +++ b/src/documentation/docbook-xsl/common/mn.xml @@ -0,0 +1,638 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbole + А + а + Б + б + В + в + Г + г + Д + д + Е + е + Ё + ё + Ж + ж + З + з + И + и + Й + й + К + к + Л + л + М + м + Н + н + О + о + Ө + ө + П + п + Р + р + С + с + Т + т + У + у + Ү + ү + Ф + ф + Х + х + Ц + ц + Ч + ч + Ш + ш + Щ + щ + Ъ + ъ + Ы + ы + Ь + ь + Э + э + Ю + ю + Я + я + + diff --git a/src/documentation/docbook-xsl/common/nl.xml b/src/documentation/docbook-xsl/common/nl.xml new file mode 100644 index 0000000000..88148884b4 --- /dev/null +++ b/src/documentation/docbook-xsl/common/nl.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/nn.xml b/src/documentation/docbook-xsl/common/nn.xml new file mode 100644 index 0000000000..9cecd08518 --- /dev/null +++ b/src/documentation/docbook-xsl/common/nn.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/no.xml b/src/documentation/docbook-xsl/common/no.xml new file mode 100644 index 0000000000..ae96b2068e --- /dev/null +++ b/src/documentation/docbook-xsl/common/no.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/olink.xsl b/src/documentation/docbook-xsl/common/olink.xsl new file mode 100644 index 0000000000..a5e447ff2c --- /dev/null +++ b/src/documentation/docbook-xsl/common/olink.xsl @@ -0,0 +1,1080 @@ + + + + + + + + + + + + + + + + + + + + + + + Olinks not processed: must specify a + $target.database.document parameter + when using olinks with targetdoc + and targetptr attributes. + + + + + + Olink error: could not open target database ' + + '. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Olink debug: cases for targetdoc=' + + ' and targetptr=' + + ' in language ' + + '. + + + + + + + + + + + + + + Olink debug: CaseA matched. + + + + Olink debug: CaseA NOT matched + + + + + + + + + + + + + + + + Olink debug: CaseB matched. + + + + Olink debug: CaseB NOT matched + + + + + + + + + + + + + + + + + Olink debug: CaseC matched. + + + + Olink debug: CaseC NOT matched. + + + + + + + + + + + + + + + + + Olink debug: CaseD matched. + + + + Olink debug: CaseD NOT matched + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Olink debug: CaseE matched. + + + + Olink debug: CaseE NOT matched. + + + + + + + + + + + + + + + + + + + + + + + + + + + + Olink debug: CaseF matched. + + + + Olink debug: CaseF NOT matched. + + + + + + + + + + + + + + Olink debug: CaseB key is the final selection: + + + + + + + + + Olink debug: CaseA key is the final selection: + + + + + + + + + Olink debug: CaseC key is the final selection: + + + + + + + + + Olink debug: CaseD key is the final selection: + + + + + + + + + Olink debug: CaseF key is the final selection: + + + + + + + + + Olink debug: CaseE key is the final selection: + + + + + + + + Olink debug: No case matched for lang ' + + '. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Olink error: cannot compute relative + sitemap path because $current.docid ' + + ' not found in target database. + + + + + + + Olink warning: cannot compute relative + sitemap path without $current.docid parameter + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + xrefstyle is ' + + '. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Olink error: no gentext template + exists for xrefstyle ' + + ' for element ' + + ' in language ' + + ' in context 'xref-number-and-title + '. Using template without @style. + + + + + + + + Olink error: no gentext template + exists for xrefstyle ' + + ' for element ' + + ' in language ' + + ' in context 'xref-number + '. Using template without @style. + + + + + + + + Olink error: no gentext template + exists for xrefstyle ' + + ' for element ' + + ' in language ' + + ' in context 'xref + '. Using template without @style. + + + + + + Olink error: no gentext template + exists for xrefstyle ' + + ' for element ' + + ' in language ' + + '. Trying '%t'. + + + + + + + + + + + Olink debug: xrefstyle template is ' + + '. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Olink error: no generated text for + targetdoc/targetptr/lang = ' + + '. + + ???? + + + + + + + Olink error: no generated text for + targetdoc/targetptr/lang = ' + + '. + + + ???? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Olink error: cannot locate targetdoc in sitemap + + + + + + + / + + + + + + + + + + + ../ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/common/or.xml b/src/documentation/docbook-xsl/common/or.xml new file mode 100644 index 0000000000..89955deda0 --- /dev/null +++ b/src/documentation/docbook-xsl/common/or.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/pa.xml b/src/documentation/docbook-xsl/common/pa.xml new file mode 100644 index 0000000000..a7075d5f33 --- /dev/null +++ b/src/documentation/docbook-xsl/common/pa.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/pi.xsl b/src/documentation/docbook-xsl/common/pi.xsl new file mode 100644 index 0000000000..0e5097fb5e --- /dev/null +++ b/src/documentation/docbook-xsl/common/pi.xsl @@ -0,0 +1,209 @@ + + + + + + + + + + + + + + + + format + + + + + + + + + + + + + + + + + + + + padding + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + Timestamp processing requires XSLT processor with EXSLT date support. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + 0 + + + + + + + 0 + + + + 0 + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + Timestamp processing requires an XSLT processor with support + for the EXSLT node-set() function. + + + + + + + + diff --git a/src/documentation/docbook-xsl/common/pl.xml b/src/documentation/docbook-xsl/common/pl.xml new file mode 100644 index 0000000000..51d3b304bd --- /dev/null +++ b/src/documentation/docbook-xsl/common/pl.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/pt.xml b/src/documentation/docbook-xsl/common/pt.xml new file mode 100644 index 0000000000..042de3308b --- /dev/null +++ b/src/documentation/docbook-xsl/common/pt.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/pt_br.xml b/src/documentation/docbook-xsl/common/pt_br.xml new file mode 100644 index 0000000000..22aad4cb8a --- /dev/null +++ b/src/documentation/docbook-xsl/common/pt_br.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á +  + â + à + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/refentry.xsl b/src/documentation/docbook-xsl/common/refentry.xsl new file mode 100644 index 0000000000..edbcb7493a --- /dev/null +++ b/src/documentation/docbook-xsl/common/refentry.xsl @@ -0,0 +1,1277 @@ + + + + + + + + + + + $Id: refentry.xsl,v 1.17 2006/04/24 05:52:56 xmldoc Exp $ + + The DocBook Project + 2005 + The DocBook Project + + + Refentry Metadata-Gathering Template Reference + + +
                  Introduction + + This is technical reference documentation for the "refentry + metadata gathering" templates in the DocBook XSL Stylesheets. + + This is not intended to be user documentation. It is provided + for developers writing customization layers for the + stylesheets. + + + Currently, only the manpages stylesheets make use of these + templates. They are, however, potentially useful elsewhere. + + +
                  +                   + +                   + + + + + Gathers metadata from a refentry and its ancestors + + + Reference documentation for particular commands, functions, + etc., is sometimes viewed in isolation from its greater "context". For + example, users view Unix man pages as, well, individual pages, not as + part of a "book" of some kind. Therefore, it is sometimes necessary to + embed "context" information in output for each refentry. + + However, one problem is that different users mark up that + context information in different ways. Often (usually), the + context information is not actually part of the content of the + refentry itself, but instead part of the content of a + parent or ancestor element to the the refentry. And + even then, DocBook provides a variety of elements that users might + potentially use to mark up the same kind of information. One user + might use the productnumber element to mark up version + information about a particular product, while another might use + the releaseinfo element. + + Taking all that in mind, the + get.refentry.info function tries to gather + metadata from a refentry element and its ancestor + elements in an intelligent and user-configurable way. The basic + mechanism used in the XPath expressions throughout this stylesheet + is to select the relevant metadata from the *info element that is + closest to the actual refentry – either on the + refentry itself, or on its nearest ancestor. + + + The get.refentry.info function is + actually just sort of a "driver" function; it calls other + functions that do the actual data collection, then returns the + data as a set. + + + + + + + + refname + + The first refname in the refentry + + + + info + + A set of info nodes (from a refentry + element and its ancestors) + + + + prefs + + A node containing user preferences (from global + stylesheet parameters) + + + + + + + Returns a node set with the following elements. The + descriptions are verbatim from the man(7) man + page. + + + title + + the title of the man page (e.g., MAN) + + + + section + + the section number the man page should be placed in (e.g., + 7) + + + + date + + the date of the last revision + + + + source + + the source of the command + + + + manual + + the title of the manual (e.g., Linux + Programmer's Manual) + + + + + + + + + + + + + <xsl:call-template name="get.refentry.title"> + <xsl:with-param name="refname" select="$refname"/> + </xsl:call-template> + +
                  + + + +
                  + + + + + + + + + + + + + + + + + + + + + +                   + + + + + Gets title metadata for a refentry + + + The man(7) man page describes this as "the + title of the man page (e.g., MAN). This differs + from refname in that, if the refentry has a + refentrytitle, we use that as the title; + otherwise, we just use first refname in the first + refnamediv in the source. + + + + + + refname + + The first refname in the refentry + + + + + + + Returns a title node. + + + + + + + + + + + + + + + + + + + + Gets section metadata for a refentry + + + The man(7) man page describes this as "the + section number the man page should be placed in (e.g., + 7)". If we do not find a manvolnum + specified in the source, and we find that the refentry is + for a function, we use the section number 3 + ["Library calls (functions within program libraries)"]; otherwise, we + default to using 1 ["Executable programs or shell + commands"]. + + + + + + refname + + The first refname in the refentry + + + + quiet + + If non-zero, no "missing" message is emitted + + + + + + + Returns a string representing a section number. + + + + + + + + + + + + + Note + + meta manvol : No manvolnum + + + + + + + + + Note + + meta manvol : Setting man section to 3 + + + + 3 + + + 1 + + + + + + + + + + Gets date metadata for a refentry + + + The man(7) man page describes this as "the + date of the last revision". If we cannot find a date in the source, we + generate one. + + + + + + refname + + The first refname in the refentry + + + + info + + A set of info nodes (from a refentry + element and its ancestors) + + + + prefs + + A node containing users preferences (from global stylesheet parameters) + + + + + + Returns a date node. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Note + + meta date : No date. Using generated date + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Gets source metadata for a refentry + + + The man(7) man page describes this as "the + source of the command", and provides the following examples: + + + For binaries, use something like: GNU, NET-2, SLS + Distribution, MCC Distribution. + + + For system calls, use the version of the kernel that you are + currently looking at: Linux 0.99.11. + + + For library calls, use the source of the function: GNU, BSD + 4.3, Linux DLL 4.4.1. + + + + + The solbook(5) man page describes + something very much like what man(7) calls + "source", except that solbook(5) names it + "software" and describes it like this: +
                  + This is the name of the software product that the topic + discussed on the reference page belongs to. For example UNIX + commands are part of the SunOS x.x + release. +
                  +                   + + In practice, there are many pages that simply have a version + number in the "source" field. So, it looks like what we have is a + two-part field, + Name Version, + where: + + + Name + + product name (e.g., BSD) or org. name (e.g., GNU) + + + + Version + + version name + + + + Each part is optional. If the Name is a + product name, then the Version is probably + the version of the product. Or there may be no + Name, in which case, if there is a + Version, it is probably the version of the + item itself, not the product it is part of. Or, if the + Name is an organization name, then there + probably will be no Version. + +                   + + + + + refname + + The first refname in the refentry + + + + info + + A set of info nodes (from a refentry + element and its ancestors) + + + + prefs + + A node containing users preferences (from global + stylesheet parameters) + + + + + + Returns a source node. +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warn + + meta source : No valid fallback. Leaving empty + + + + + + + + + Warn + + meta source : No fallback specified; leaving empty. + + + + + + + + + + Gets source-name metadata for a refentry + + + A "source name" is one part of a (potentially) two-part + Name Version + source field. For more details, see the documentation for the + get.refentry.source template. + + + + + + refname + + The first refname in the refentry + + + + info + + A set of info nodes (from a refentry + element and its ancestors) + + + + prefs + + A node containing users preferences (from global + stylesheet parameters) + + + + + + Depending on what output method is used for the + current stylesheet, either returns a text node or possibly an element + node, containing "source name" data. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + source + + + + + + + + source + productname + + + + + + + + source + productname + + + + + + + + source + productname + + + + + + + + source + productname + + + + + + + + source + productname + + + + + + Note + + meta source : No productname or alternative + + + Note + + meta source : No refmiscinfo@class=source + + + + + + + + + + + + + + Gets version metadata for a refentry + + + A "version" is one part of a (potentially) two-part + Name Version + source field. For more details, see the documentation for the + get.refentry.source template. + + + + + + refname + + The first refname in the refentry + + + + info + + A set of info nodes (from a refentry + element and its ancestors) + + + + prefs + + A node containing users preferences (from global + stylesheet parameters) + + + + + + Depending on what output method is used for the + current stylesheet, either returns a text node or possibly an element + node, containing "version" data. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + version + + + + + + + + version + productnumber + + + + + + + + version + productnumber + + + + + + Note + + meta version: No productnumber or alternative + + + Note + + meta version: No refmiscinfo@class=version + + + + + + + + + + + + + + Gets source metadata for a refentry + + + The man(7) man page describes this as "the + title of the manual (e.g., Linux Programmer's + Manual)". Here are some examples from existing man pages: + + + dpkg utilities + (dpkg-name) + + + User Contributed Perl Documentation + (GET) + + + GNU Development Tools + (ld) + + + Emperor Norton Utilities + (ddate) + + + Debian GNU/Linux manual + (faked) + + + GIMP Manual Pages + (gimp) + + + KDOC Documentation System + (qt2kdoc) + + + + + The solbook(5) man page describes + something very much like what man(7) calls + "manual", except that solbook(5) names it + "sectdesc" and describes it like this: +
                  + This is the section title of the reference page; for + example User Commands. +
                  +                   + +                   + + + + + refname + + The first refname in the refentry + + + + info + + A set of info nodes (from a refentry + element and its ancestors) + + + + prefs + + A node containing users preferences (from global + stylesheet parameters) + + + + + + Returns a manual node. +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + manual + + + + + + + + manual + + + + + + Note + + meta manual : No ancestor with title + + + Note + + meta manual : No refmiscinfo@class=manual + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warn + + meta manual : No valid fallback. Leaving empty + + + + + + + + + + Warn + + meta manual : No fallback specified; leaving empty. + + + + + + + + + + Gets user preferences for refentry metadata gathering + + + The DocBook XSL stylesheets include several user-configurable + global stylesheet parameters for controlling refentry + metadata gathering. Those parameters are not read directly by the + other refentry metadata-gathering functions. Instead, they + are read only by the get.refentry.metadata.prefs + function, which assembles them into a structure that is then passed to + the other refentry metadata-gathering functions. + + So the, get.refentry.metadata.prefs + function is the only interface to collecting stylesheet parameters for + controlling refentry metadata gathering. + + + + There are no local parameters for this function; however, it + does rely on a number of global parameters. + + + Returns a manual node. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Sets content of a refentry metadata item + + + The set.refentry.metadata function is + called each time a suitable source element is found for a certain + metadata field. + + + + + + refname + + The first refname in the refentry + + + + info + + A single *info node that contains the selected source element. + + + + contents + + A node containing the selected source element. + + + + context + + A string describing the metadata context in which the + set.refentry.metadata function was + called: either "date", "source", "version", or "manual". + + + + + + Returns formatted contents of a selected source element. + + + + + + + + + + + + Note + + meta + + + : No + + + Note + + meta + + + : No refmiscinfo@class= + + + Note + + meta + + + : Using + + + + + + +                   diff --git a/src/documentation/docbook-xsl/common/ro.xml b/src/documentation/docbook-xsl/common/ro.xml new file mode 100644 index 0000000000..e87f6895a9 --- /dev/null +++ b/src/documentation/docbook-xsl/common/ro.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/ru.xml b/src/documentation/docbook-xsl/common/ru.xml new file mode 100644 index 0000000000..3bf523607a --- /dev/null +++ b/src/documentation/docbook-xsl/common/ru.xml @@ -0,0 +1,686 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + A + a + B + b + C + c + D + d + E + e + F + f + G + g + H + h + I + i + J + j + K + k + L + l + M + m + N + n + O + o + P + p + Q + q + R + r + S + s + T + t + U + u + V + v + W + w + X + x + Y + y + Z + z + А + а + Б + б + В + в + Г + г + Д + д + Е + е + Ё + ё + Ж + ж + З + з + И + и + Й + й + К + к + Л + л + М + м + Н + н + О + о + П + п + Р + р + С + с + Т + т + У + у + Ф + ф + Х + х + Ц + ц + Ч + ч + Ш + ш + Щ + щ + Ъ + ъ + Ы + ы + Ь + ь + Э + э + Ю + ю + Я + я + + diff --git a/src/documentation/docbook-xsl/common/sk.xml b/src/documentation/docbook-xsl/common/sk.xml new file mode 100644 index 0000000000..d3304974da --- /dev/null +++ b/src/documentation/docbook-xsl/common/sk.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/sl.xml b/src/documentation/docbook-xsl/common/sl.xml new file mode 100644 index 0000000000..6ab1e327a2 --- /dev/null +++ b/src/documentation/docbook-xsl/common/sl.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/sq.xml b/src/documentation/docbook-xsl/common/sq.xml new file mode 100644 index 0000000000..6cd17d35e1 --- /dev/null +++ b/src/documentation/docbook-xsl/common/sq.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/sr.xml b/src/documentation/docbook-xsl/common/sr.xml new file mode 100644 index 0000000000..ab1f8a5c06 --- /dev/null +++ b/src/documentation/docbook-xsl/common/sr.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/sr_Latn.xml b/src/documentation/docbook-xsl/common/sr_Latn.xml new file mode 100644 index 0000000000..a81c54d0d7 --- /dev/null +++ b/src/documentation/docbook-xsl/common/sr_Latn.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/stripns.xsl b/src/documentation/docbook-xsl/common/stripns.xsl new file mode 100644 index 0000000000..c6bdffe698 --- /dev/null +++ b/src/documentation/docbook-xsl/common/stripns.xsl @@ -0,0 +1,315 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + info + + + objectinfo + + blockinfo + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + Stripping NS from DocBook 5/NG document. + + + + Processing stripped document. + + + + + + + + + diff --git a/src/documentation/docbook-xsl/common/subtitles.xsl b/src/documentation/docbook-xsl/common/subtitles.xsl new file mode 100644 index 0000000000..127ac1c3bc --- /dev/null +++ b/src/documentation/docbook-xsl/common/subtitles.xsl @@ -0,0 +1,155 @@ + + + + + + + + + + +Provides access to element subtitles + +Processing an element in the +subtitle.markup mode produces the +subtitle of the element. + + + + + + + Request for subtitle of unexpected element: + + + ???SUBTITLE??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/common/sv.xml b/src/documentation/docbook-xsl/common/sv.xml new file mode 100644 index 0000000000..660870a499 --- /dev/null +++ b/src/documentation/docbook-xsl/common/sv.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/ta.xml b/src/documentation/docbook-xsl/common/ta.xml new file mode 100644 index 0000000000..8bef4d2f44 --- /dev/null +++ b/src/documentation/docbook-xsl/common/ta.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/table.xsl b/src/documentation/docbook-xsl/common/table.xsl new file mode 100644 index 0000000000..d0493ea7c3 --- /dev/null +++ b/src/documentation/docbook-xsl/common/table.xsl @@ -0,0 +1,464 @@ + + + + + + + + + + + 0: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0: + + + : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + +Determine the column number in which a given entry occurs + +If an entry has a +colname or +namest attribute, this template +will determine the number of the column in which the entry should occur. +For other entrys, nothing is returned. + + + +entry + +The entry-element which is to be tested. + + + + + + +This template returns the column number if it can be determined, +or 0 (the empty string) + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/common/targetdatabase.dtd b/src/documentation/docbook-xsl/common/targetdatabase.dtd new file mode 100644 index 0000000000..2ace1e0030 --- /dev/null +++ b/src/documentation/docbook-xsl/common/targetdatabase.dtd @@ -0,0 +1,49 @@ + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/common/targets.xsl b/src/documentation/docbook-xsl/common/targets.xsl new file mode 100644 index 0000000000..7ca1c846d3 --- /dev/null +++ b/src/documentation/docbook-xsl/common/targets.xsl @@ -0,0 +1,271 @@ + + + + + + + + + + +Collects information for potential cross reference targets + +Processing the root element in the +collect.targets mode produces +a set of target database elements that can be used by +the olink mechanism to resolve external cross references. +The collection process is controlled by the +collect.xref.targets parameter, which can be +yes to collect targets and process +the document for output, only to +only collect the targets, and no +(default) to not collect the targets and only process the document. + + +A targets.filename parameter must be +specified to receive the output if +collect.xref.targets is +set to yes so as to +redirect the target data to a file separate from the +document output. + + + + + + + + + + + Must specify a $targets.filename parameter when + $collect.xref.targets is set to 'yes'. + The xref targets were not collected. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/common/th.xml b/src/documentation/docbook-xsl/common/th.xml new file mode 100644 index 0000000000..63f66e0d1d --- /dev/null +++ b/src/documentation/docbook-xsl/common/th.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/titles.xsl b/src/documentation/docbook-xsl/common/titles.xsl new file mode 100644 index 0000000000..b9e12dac7e --- /dev/null +++ b/src/documentation/docbook-xsl/common/titles.xsl @@ -0,0 +1,708 @@ + + + + + + + + + + +Provides access to element titles + +Processing an element in the +title.markup mode produces the +title of the element. This does not include the label. + + + + + + + + + + + + + + + + + + + + + + Request for title of element with no title: + + + (id=" + + ") + + + + ???TITLE??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + REFENTRY WITHOUT TITLE??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Note + Important + Caution + Warning + Tip + + + + + + + + + + Question + + + + + Answer + + + + + Question + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + XRef to nonexistent id: + + + ??? + + + + + + + + + + Endterm points to nonexistent ID: + + + ??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/common/tl.xml b/src/documentation/docbook-xsl/common/tl.xml new file mode 100644 index 0000000000..0fcdeb041f --- /dev/null +++ b/src/documentation/docbook-xsl/common/tl.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/tr.xml b/src/documentation/docbook-xsl/common/tr.xml new file mode 100644 index 0000000000..68778070cf --- /dev/null +++ b/src/documentation/docbook-xsl/common/tr.xml @@ -0,0 +1,626 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Semboller + A + a + B + b + C + c + Ç + ç + D + d + E + e + F + f + G + g + Ğ + ğ + H + h + I + ı + İ + i + J + j + K + k + L + l + M + m + N + n + O + o + Ö + ö + P + p + R + r + S + s + Ş + ş + T + t + U + u + Ü + ü + V + v + Y + y + Z + z + + diff --git a/src/documentation/docbook-xsl/common/uk.xml b/src/documentation/docbook-xsl/common/uk.xml new file mode 100644 index 0000000000..56b8965cb7 --- /dev/null +++ b/src/documentation/docbook-xsl/common/uk.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/vi.xml b/src/documentation/docbook-xsl/common/vi.xml new file mode 100644 index 0000000000..d36f4a5221 --- /dev/null +++ b/src/documentation/docbook-xsl/common/vi.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/xh.xml b/src/documentation/docbook-xsl/common/xh.xml new file mode 100644 index 0000000000..0223b360a4 --- /dev/null +++ b/src/documentation/docbook-xsl/common/xh.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/common/zh_cn.xml b/src/documentation/docbook-xsl/common/zh_cn.xml new file mode 100644 index 0000000000..a6cdc49db1 --- /dev/null +++ b/src/documentation/docbook-xsl/common/zh_cn.xml @@ -0,0 +1,620 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 其它 + A + a + B + b + C + c + D + d + E + e + F + f + G + g + H + h + I + i + J + j + K + k + L + l + M + m + N + n + O + o + P + p + Q + q + R + r + S + s + T + t + U + u + V + v + W + w + X + x + Y + y + Z + z + + diff --git a/src/documentation/docbook-xsl/common/zh_tw.xml b/src/documentation/docbook-xsl/common/zh_tw.xml new file mode 100644 index 0000000000..bff4893cb3 --- /dev/null +++ b/src/documentation/docbook-xsl/common/zh_tw.xml @@ -0,0 +1,1189 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Symbols + A + a + À + à + Á + á + Â + â + Ã + ã + Ä + ä + Å + å + Ā + ā + Ă + ă + Ą + ą + Ǎ + ǎ + Ǟ + ǟ + Ǡ + ǡ + Ǻ + ǻ + Ȁ + ȁ + Ȃ + ȃ + Ȧ + ȧ + Ḁ + ḁ + ẚ + Ạ + ạ + Ả + ả + Ấ + ấ + Ầ + ầ + Ẩ + ẩ + Ẫ + ẫ + Ậ + ậ + Ắ + ắ + Ằ + ằ + Ẳ + ẳ + Ẵ + ẵ + Ặ + ặ + B + b + ƀ + Ɓ + ɓ + Ƃ + ƃ + Ḃ + ḃ + Ḅ + ḅ + Ḇ + ḇ + C + c + Ç + ç + Ć + ć + Ĉ + ĉ + Ċ + ċ + Č + č + Ƈ + ƈ + ɕ + Ḉ + ḉ + D + d + Ď + ď + Đ + đ + Ɗ + ɗ + Ƌ + ƌ + Dž + Dz + ȡ + ɖ + Ḋ + ḋ + Ḍ + ḍ + Ḏ + ḏ + Ḑ + ḑ + Ḓ + ḓ + E + e + È + è + É + é + Ê + ê + Ë + ë + Ē + ē + Ĕ + ĕ + Ė + ė + Ę + ę + Ě + ě + Ȅ + ȅ + Ȇ + ȇ + Ȩ + ȩ + Ḕ + ḕ + Ḗ + ḗ + Ḙ + ḙ + Ḛ + ḛ + Ḝ + ḝ + Ẹ + ẹ + Ẻ + ẻ + Ẽ + ẽ + Ế + ế + Ề + ề + Ể + ể + Ễ + ễ + Ệ + ệ + F + f + Ƒ + ƒ + Ḟ + ḟ + G + g + Ĝ + ĝ + Ğ + ğ + Ġ + ġ + Ģ + ģ + Ɠ + ɠ + Ǥ + ǥ + Ǧ + ǧ + Ǵ + ǵ + Ḡ + ḡ + H + h + Ĥ + ĥ + Ħ + ħ + Ȟ + ȟ + ɦ + Ḣ + ḣ + Ḥ + ḥ + Ḧ + ḧ + Ḩ + ḩ + Ḫ + ḫ + ẖ + I + i + Ì + ì + Í + í + Î + î + Ï + ï + Ĩ + ĩ + Ī + ī + Ĭ + ĭ + Į + į + İ + Ɨ + ɨ + Ǐ + ǐ + Ȉ + ȉ + Ȋ + ȋ + Ḭ + ḭ + Ḯ + ḯ + Ỉ + ỉ + Ị + ị + J + j + Ĵ + ĵ + ǰ + ʝ + K + k + Ķ + ķ + Ƙ + ƙ + Ǩ + ǩ + Ḱ + ḱ + Ḳ + ḳ + Ḵ + ḵ + L + l + Ĺ + ĺ + Ļ + ļ + Ľ + ľ + Ŀ + ŀ + Ł + ł + ƚ + Lj + ȴ + ɫ + ɬ + ɭ + Ḷ + ḷ + Ḹ + ḹ + Ḻ + ḻ + Ḽ + ḽ + M + m + ɱ + Ḿ + ḿ + Ṁ + ṁ + Ṃ + ṃ + N + n + Ñ + ñ + Ń + ń + Ņ + ņ + Ň + ň + Ɲ + ɲ + ƞ + Ƞ + Nj + Ǹ + ǹ + ȵ + ɳ + Ṅ + ṅ + Ṇ + ṇ + Ṉ + ṉ + Ṋ + ṋ + O + o + Ò + ò + Ó + ó + Ô + ô + Õ + õ + Ö + ö + Ø + ø + Ō + ō + Ŏ + ŏ + Ő + ő + Ɵ + Ơ + ơ + Ǒ + ǒ + Ǫ + ǫ + Ǭ + ǭ + Ǿ + ǿ + Ȍ + ȍ + Ȏ + ȏ + Ȫ + ȫ + Ȭ + ȭ + Ȯ + ȯ + Ȱ + ȱ + Ṍ + ṍ + Ṏ + ṏ + Ṑ + ṑ + Ṓ + ṓ + Ọ + ọ + Ỏ + ỏ + Ố + ố + Ồ + ồ + Ổ + ổ + Ỗ + ỗ + Ộ + ộ + Ớ + ớ + Ờ + ờ + Ở + ở + Ỡ + ỡ + Ợ + ợ + P + p + Ƥ + ƥ + Ṕ + ṕ + Ṗ + ṗ + Q + q + ʠ + R + r + Ŕ + ŕ + Ŗ + ŗ + Ř + ř + Ȑ + ȑ + Ȓ + ȓ + ɼ + ɽ + ɾ + Ṙ + ṙ + Ṛ + ṛ + Ṝ + ṝ + Ṟ + ṟ + S + s + Ś + ś + Ŝ + ŝ + Ş + ş + Š + š + Ș + ș + ʂ + Ṡ + ṡ + Ṣ + ṣ + Ṥ + ṥ + Ṧ + ṧ + Ṩ + ṩ + T + t + Ţ + ţ + Ť + ť + Ŧ + ŧ + ƫ + Ƭ + ƭ + Ʈ + ʈ + Ț + ț + ȶ + Ṫ + ṫ + Ṭ + ṭ + Ṯ + ṯ + Ṱ + ṱ + ẗ + U + u + Ù + ù + Ú + ú + Û + û + Ü + ü + Ũ + ũ + Ū + ū + Ŭ + ŭ + Ů + ů + Ű + ű + Ų + ų + Ư + ư + Ǔ + ǔ + Ǖ + ǖ + Ǘ + ǘ + Ǚ + ǚ + Ǜ + ǜ + Ȕ + ȕ + Ȗ + ȗ + Ṳ + ṳ + Ṵ + ṵ + Ṷ + ṷ + Ṹ + ṹ + Ṻ + ṻ + Ụ + ụ + Ủ + ủ + Ứ + ứ + Ừ + ừ + Ử + ử + Ữ + ữ + Ự + ự + V + v + Ʋ + ʋ + Ṽ + ṽ + Ṿ + ṿ + W + w + Ŵ + ŵ + Ẁ + ẁ + Ẃ + ẃ + Ẅ + ẅ + Ẇ + ẇ + Ẉ + ẉ + ẘ + X + x + Ẋ + ẋ + Ẍ + ẍ + Y + y + Ý + ý + ÿ + Ÿ + Ŷ + ŷ + Ƴ + ƴ + Ȳ + ȳ + Ẏ + ẏ + ẙ + Ỳ + ỳ + Ỵ + ỵ + Ỷ + ỷ + Ỹ + ỹ + Z + z + Ź + ź + Ż + ż + Ž + ž + Ƶ + ƶ + Ȥ + ȥ + ʐ + ʑ + Ẑ + ẑ + Ẓ + ẓ + Ẕ + ẕ + + diff --git a/src/documentation/docbook-xsl/eclipse/eclipse.xsl b/src/documentation/docbook-xsl/eclipse/eclipse.xsl new file mode 100644 index 0000000000..9bb0666cc3 --- /dev/null +++ b/src/documentation/docbook-xsl/eclipse/eclipse.xsl @@ -0,0 +1,177 @@ + + + + + + + + + + + + + + ID ' + + ' not found in document. + + + + + + + + Formatting from + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/extensions/build.xml b/src/documentation/docbook-xsl/extensions/build.xml new file mode 100644 index 0000000000..12bf450e0a --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/build.xml @@ -0,0 +1,115 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/extensions/saxon643.jar b/src/documentation/docbook-xsl/extensions/saxon643.jar new file mode 100644 index 0000000000..1ef6c88f3b Binary files /dev/null and b/src/documentation/docbook-xsl/extensions/saxon643.jar differ diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/CVS.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/CVS.java new file mode 100644 index 0000000000..98f8f67e98 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/CVS.java @@ -0,0 +1,90 @@ +package com.nwalsh.saxon; + +import java.io.*; +import java.util.Calendar; +import java.util.GregorianCalendar; +import java.util.Date; +import java.util.Locale; +import java.util.TimeZone; +import java.text.DateFormat; +import java.text.ParseException; + +/** + *

                  Saxon extension to convert CVS date strings into local time

                  + * + *

                  $Id: CVS.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Saxon + * extension to turn the CVS date strings, which are UTC:

                  + * + * 
                  $Date: 2000/11/09 02:34:20 $
                  + * + *

                  into legibly formatted local time:

                  + * + * 
                  Wed Nov 08 18:34:20 PST 2000
                  + * + *

                  (I happened to be in California when I wrote this documentation.)

                  + + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: CVS.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class CVS { + /** + *

                  Constructor for CVS

                  + * + *

                  All of the methods are static, so the constructor does nothing.

                  + */ + public CVS() { + } + + /** + *

                  Convert a CVS date string into local time.

                  + * + * @param cvsDate The CVS date string. + * + * @return The date, converted to local time and reformatted. + */ + public static String localTime (String cvsDate) { + // A cvsDate has the following form "$Date: 2006/04/27 08:26:47 $" + if (!cvsDate.startsWith("$Date: ")) { + return cvsDate; + } + + String yrS = cvsDate.substring(7,11); + String moS = cvsDate.substring(12,14); + String daS = cvsDate.substring(15,17); + String hrS = cvsDate.substring(18,20); + String miS = cvsDate.substring(21,23); + String seS = cvsDate.substring(24,26); + + TimeZone tz = TimeZone.getTimeZone("GMT+0"); + GregorianCalendar gmtCal = new GregorianCalendar(tz); + + try { + gmtCal.set(Integer.parseInt(yrS), + Integer.parseInt(moS)-1, + Integer.parseInt(daS), + Integer.parseInt(hrS), + Integer.parseInt(miS), + Integer.parseInt(seS)); + } catch (NumberFormatException e) { + // nop + } + + Date d = gmtCal.getTime(); + + return d.toString(); + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Callout.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Callout.java new file mode 100644 index 0000000000..cffa054fe3 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Callout.java @@ -0,0 +1,90 @@ +package com.nwalsh.saxon; + +import org.w3c.dom.*; + +/** + *

                  A class for maintaining information about callouts.

                  + * + *

                  To make processing callouts easier, they are parsed out of the + * input structure and stored in a sorted array. (The array is sorted + * according to the order in which the callouts occur.)

                  + * + *

                  This class is just the little record + * that we store in the array for each callout.

                  + */ +public class Callout implements Comparable { + /** The callout number. */ + private int callout = 0; + /** The area Element item that generated this callout. */ + private Element area = null; + /** The line on which this callout occurs. */ + private int line = 0; + /** The column in which this callout appears. */ + private int col = 0; + + /** The constructor; initialize the private data structures. */ + public Callout(int callout, Element area, int line, int col) { + this.callout = callout; + this.area = area; + this.line = line; + this.col = col; + } + + /** + *

                  The compareTo method compares this Callout with another.

                  + * + *

                  Given two Callouts, A and B, A < B if:

                  + * + *
                    + *
                  1. A.line < B.line, or
                    2. + *
                  2. A.line = B.line && A.col < B.col, or
                    3. + *
                  3. A.line = B.line && A.col = B.col && A.callout < B.callout
                    4. + *
                  4. Otherwise, they're equal.
                    5. + *
                  + */ + public int compareTo (Object o) { + Callout c = (Callout) o; + + if (line == c.getLine()) { + if (col > c.getColumn()) { + return 1; + } else if (col < c.getColumn()) { + return -1; + } else { + if (callout < c.getCallout()) { + return -1; + } else if (callout > c.getCallout()) { + return 1; + } else { + return 0; + } + } + } else { + if (line > c.getLine()) { + return 1; + } else { + return -1; + } + } + } + + /** Access the Callout's area. */ + public Element getArea() { + return area; + } + + /** Access the Callout's line. */ + public int getLine() { + return line; + } + + /** Access the Callout's column. */ + public int getColumn() { + return col; + } + + /** Access the Callout's callout number. */ + public int getCallout() { + return callout; + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/CalloutEmitter.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/CalloutEmitter.java new file mode 100644 index 0000000000..bb91d4ea4f --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/CalloutEmitter.java @@ -0,0 +1,532 @@ +package com.nwalsh.saxon; + +import java.util.Stack; +import java.util.StringTokenizer; +import org.xml.sax.*; +import org.w3c.dom.*; +import javax.xml.transform.TransformerException; +import com.icl.saxon.Controller; +import com.icl.saxon.om.NamePool; +import com.icl.saxon.output.Emitter; +import com.icl.saxon.tree.AttributeCollection; + +/** + *

                  Saxon extension to decorate a result tree fragment with callouts.

                  + * + *

                  $Id: CalloutEmitter.java,v 1.3 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides the guts of a + * Saxon 6.* + * implementation of callouts for verbatim environments. (It is used + * by the Verbatim class.)

                  + * + *

                  The general design is this: the stylesheets construct a result tree + * fragment for some verbatim environment. The Verbatim class initializes + * a CalloutEmitter with information about the callouts that should be applied + * to the verbatim environment in question. Then the result tree fragment + * is "replayed" through the CalloutEmitter; the CalloutEmitter builds a + * new result tree fragment from this event stream, decorated with callouts, + * and that is returned.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @see Verbatim + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: CalloutEmitter.java,v 1.3 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class CalloutEmitter extends CopyEmitter { + /** A stack for the preserving information about open elements. */ + protected Stack elementStack = null; + + /** A stack for holding information about temporarily closed elements. */ + protected Stack tempStack = null; + + /** Is the next element absolutely the first element in the fragment? */ + protected boolean firstElement = false; + + /** The FO namespace name. */ + protected static String foURI = "http://www.w3.org/1999/XSL/Format"; + + /** The XHTML namespace name. */ + protected static String xhURI = "http://www.w3.org/1999/xhtml"; + + /** The default column for callouts that specify only a line. */ + protected int defaultColumn = 60; + + /** Is the stylesheet currently running an FO stylesheet? */ + protected boolean foStylesheet = false; + + /** The current line number. */ + private static int lineNumber = 0; + + /** The current column number. */ + private static int colNumber = 0; + + /** The (sorted) array of callouts obtained from the areaspec. */ + private static Callout callout[] = null; + + /** The number of callouts in the callout array. */ + private static int calloutCount = 0; + + /** A pointer used to keep track of our position in the callout array. */ + private static int calloutPos = 0; + + /** The FormatCallout object to use for formatting callouts. */ + private static FormatCallout fCallout = null; + + /**

                  Constructor for the CalloutEmitter.

                  + * + * @param controller + * @param namePool The name pool to use for constructing elements and attributes. + * @param defaultColumn The default column for callouts. + * @param foStylesheet Is this an FO stylesheet? + * @param fCallout + */ + public CalloutEmitter(Controller controller, + NamePool namePool, + int defaultColumn, + boolean foStylesheet, + FormatCallout fCallout) { + super(controller, namePool); + elementStack = new Stack(); + firstElement = true; + + this.defaultColumn = defaultColumn; + this.foStylesheet = foStylesheet; + this.fCallout = fCallout; + } + + /** + *

                  Examine the areaspec and determine the number and position of + * callouts.

                  + * + *

                  The areaspecNodeSet + * is examined and a sorted list of the callouts is constructed.

                  + * + *

                  This data structure is used to augment the result tree fragment + * with callout bullets.

                  + * + * @param areaspecNodeList The source document <areaspec> element. + */ + public void setupCallouts (NodeList areaspecNodeList) { + callout = new Callout[10]; + calloutCount = 0; + calloutPos = 0; + lineNumber = 1; + colNumber = 1; + + // First we walk through the areaspec to calculate the position + // of the callouts + // + // + // + // + // + // + // + // + int pos = 0; + int coNum = 0; + boolean inAreaSet = false; + Node areaspec = areaspecNodeList.item(0); + NodeList children = areaspec.getChildNodes(); + + for (int count = 0; count < children.getLength(); count++) { + Node node = children.item(count); + if (node.getNodeType() == Node.ELEMENT_NODE) { + if (node.getNodeName().equalsIgnoreCase("areaset")) { + coNum++; + NodeList areas = node.getChildNodes(); + for (int acount = 0; acount < areas.getLength(); acount++) { + Node area = areas.item(acount); + if (area.getNodeType() == Node.ELEMENT_NODE) { + if (area.getNodeName().equalsIgnoreCase("area")) { + addCallout(coNum, area, defaultColumn); + } else { + System.out.println("Unexpected element in areaset: " + + area.getNodeName()); + } + } + } + } else if (node.getNodeName().equalsIgnoreCase("area")) { + coNum++; + addCallout(coNum, node, defaultColumn); + } else { + System.out.println("Unexpected element in areaspec: " + + node.getNodeName()); + } + } + } + + // Now sort them + java.util.Arrays.sort(callout, 0, calloutCount); + } + + /** Process characters. */ + public void characters(char[] chars, int start, int len) + throws TransformerException { + + // If we hit characters, then there's no first element... + firstElement = false; + + if (lineNumber == 0) { + // if there are any text nodes, there's at least one line + lineNumber++; + colNumber = 1; + } + + // Walk through the text node looking for callout positions + char[] newChars = new char[len]; + int pos = 0; + for (int count = start; count < start+len; count++) { + if (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() == colNumber) { + if (pos > 0) { + rtfEmitter.characters(newChars, 0, pos); + pos = 0; + } + + closeOpenElements(rtfEmitter); + + while (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() == colNumber) { + fCallout.formatCallout(rtfEmitter, callout[calloutPos]); + calloutPos++; + } + + openClosedElements(rtfEmitter); + } + + if (chars[count] == '\n') { + // What if we need to pad this line? + if (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() > colNumber) { + + if (pos > 0) { + rtfEmitter.characters(newChars, 0, pos); + pos = 0; + } + + closeOpenElements(rtfEmitter); + + while (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() > colNumber) { + formatPad(callout[calloutPos].getColumn() - colNumber); + colNumber = callout[calloutPos].getColumn(); + while (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() == colNumber) { + fCallout.formatCallout(rtfEmitter, callout[calloutPos]); + calloutPos++; + } + } + + openClosedElements(rtfEmitter); + } + + lineNumber++; + colNumber = 1; + } else { + colNumber++; + } + newChars[pos++] = chars[count]; + } + + if (pos > 0) { + rtfEmitter.characters(newChars, 0, pos); + } + } + + /** + *

                  Add blanks to the result tree fragment.

                  + * + *

                  This method adds numBlanks to the result tree fragment. + * It's used to pad lines when callouts occur after the last existing + * characater in a line.

                  + * + * @param numBlanks The number of blanks to add. + */ + protected void formatPad(int numBlanks) { + char chars[] = new char[numBlanks]; + for (int count = 0; count < numBlanks; count++) { + chars[count] = ' '; + } + + try { + rtfEmitter.characters(chars, 0, numBlanks); + } catch (TransformerException e) { + System.out.println("Transformer Exception in formatPad"); + } + } + + /** + *

                  Add a callout to the global callout array

                  + * + *

                  This method examines a callout area and adds it to + * the global callout array if it can be interpreted.

                  + * + *

                  Only the linecolumn and linerange units are + * supported. If no unit is specifed, linecolumn is assumed. + * If only a line is specified, the callout decoration appears in + * the defaultColumn.

                  + * + * @param coNum The callout number. + * @param node The area. + * @param defaultColumn The default column for callouts. + */ + protected void addCallout (int coNum, + Node node, + int defaultColumn) { + + Element area = (Element) node; + String units = null; + String coords = null; + + if (area.hasAttribute("units")) { + units = area.getAttribute("units"); + } + + if (area.hasAttribute("coords")) { + coords = area.getAttribute("coords"); + } + + if (units != null + && !units.equalsIgnoreCase("linecolumn") + && !units.equalsIgnoreCase("linerange")) { + System.out.println("Only linecolumn and linerange units are supported"); + return; + } + + if (coords == null) { + System.out.println("Coords must be specified"); + return; + } + + // Now let's see if we can interpret the coordinates... + StringTokenizer st = new StringTokenizer(coords); + int tokenCount = 0; + int c1 = 0; + int c2 = 0; + while (st.hasMoreTokens()) { + tokenCount++; + if (tokenCount > 2) { + System.out.println("Unparseable coordinates"); + return; + } + try { + String token = st.nextToken(); + int coord = Integer.parseInt(token); + c2 = coord; + if (tokenCount == 1) { + c1 = coord; + } + } catch (NumberFormatException e) { + System.out.println("Unparseable coordinate"); + return; + } + } + + // Make sure we aren't going to blow past the end of our array + if (calloutCount == callout.length) { + Callout bigger[] = new Callout[calloutCount+10]; + for (int count = 0; count < callout.length; count++) { + bigger[count] = callout[count]; + } + callout = bigger; + } + + // Ok, add the callout + if (tokenCount == 2) { + if (units != null && units.equalsIgnoreCase("linerange")) { + for (int count = c1; count <= c2; count++) { + callout[calloutCount++] = new Callout(coNum, area, + count, defaultColumn); + } + } else { + // assume linecolumn + callout[calloutCount++] = new Callout(coNum, area, c1, c2); + } + } else { + // if there's only one number, assume it's the line + callout[calloutCount++] = new Callout(coNum, area, c1, defaultColumn); + } + } + + /** Process end element events. */ + public void endElement(int nameCode) + throws TransformerException { + + if (!elementStack.empty()) { + // if we didn't push the very first element (an fo:block or + // pre or div surrounding the whole block), then the stack will + // be empty when we get to the end of the first element... + elementStack.pop(); + } + rtfEmitter.endElement(nameCode); + } + + /** Process start element events. */ + public void startElement(int nameCode, + org.xml.sax.Attributes attributes, + int[] namespaces, + int nscount) + throws TransformerException { + + if (!skipThisElement(nameCode)) { + StartElementInfo sei = new StartElementInfo(nameCode, attributes, + namespaces, nscount); + elementStack.push(sei); + } + + firstElement = false; + + rtfEmitter.startElement(nameCode, attributes, namespaces, nscount); + } + + /** + *

                  Protect the outer-most block wrapper.

                  + * + *

                  Open elements in the result tree fragment are closed and reopened + * around callouts (so that callouts don't appear inside links or other + * environments). But if the result tree fragment is a single block + * (a div or pre in HTML, an fo:block in FO), that outer-most block is + * treated specially.

                  + * + *

                  This method returns true if the element in question is that + * outermost block.

                  + * + * @param nameCode The name code for the element + * + * @return True if the element is the outer-most block, false otherwise. + */ + protected boolean skipThisElement(int nameCode) { + // FIXME: This is such a gross hack... + if (firstElement) { + int thisFingerprint = namePool.getFingerprint(nameCode); + int foBlockFingerprint = namePool.getFingerprint(foURI, "block"); + int htmlPreFingerprint = namePool.getFingerprint("", "pre"); + int htmlDivFingerprint = namePool.getFingerprint("", "div"); + int xhtmlPreFingerprint = namePool.getFingerprint(xhURI, "pre"); + int xhtmlDivFingerprint = namePool.getFingerprint(xhURI, "div"); + + if ((foStylesheet && thisFingerprint == foBlockFingerprint) + || (!foStylesheet && (thisFingerprint == htmlPreFingerprint + || thisFingerprint == htmlDivFingerprint + || thisFingerprint == xhtmlPreFingerprint + || thisFingerprint == xhtmlDivFingerprint))) { + // Don't push the outer-most wrapping div, pre, or fo:block + return true; + } + } + + return false; + } + + private void closeOpenElements(Emitter rtfEmitter) + throws TransformerException { + // Close all the open elements... + tempStack = new Stack(); + while (!elementStack.empty()) { + StartElementInfo elem = (StartElementInfo) elementStack.pop(); + rtfEmitter.endElement(elem.getNameCode()); + tempStack.push(elem); + } + } + + private void openClosedElements(Emitter rtfEmitter) + throws TransformerException { + // Now "reopen" the elements that we closed... + while (!tempStack.empty()) { + StartElementInfo elem = (StartElementInfo) tempStack.pop(); + AttributeCollection attr = (AttributeCollection) elem.getAttributes(); + AttributeCollection newAttr = new AttributeCollection(namePool); + + for (int acount = 0; acount < attr.getLength(); acount++) { + String localName = attr.getLocalName(acount); + int nameCode = attr.getNameCode(acount); + String type = attr.getType(acount); + String value = attr.getValue(acount); + String uri = attr.getURI(acount); + String prefix = ""; + + if (localName.indexOf(':') > 0) { + prefix = localName.substring(0, localName.indexOf(':')); + localName = localName.substring(localName.indexOf(':')+1); + } + + if (uri.equals("") + && ((foStylesheet + && localName.equals("id")) + || (!foStylesheet + && (localName.equals("id") + || localName.equals("name"))))) { + // skip this attribute + } else { + newAttr.addAttribute(prefix, uri, localName, type, value); + } + } + + rtfEmitter.startElement(elem.getNameCode(), + newAttr, + elem.getNamespaces(), + elem.getNSCount()); + + elementStack.push(elem); + } + } + + /** + *

                  A private class for maintaining the information required to call + * the startElement method.

                  + * + *

                  In order to close and reopen elements, information about those + * elements has to be maintained. This class is just the little record + * that we push on the stack to keep track of that info.

                  + */ + private class StartElementInfo { + private int _nameCode; + org.xml.sax.Attributes _attributes; + int[] _namespaces; + int _nscount; + + public StartElementInfo(int nameCode, + org.xml.sax.Attributes attributes, + int[] namespaces, + int nscount) { + _nameCode = nameCode; + _attributes = attributes; + _namespaces = namespaces; + _nscount = nscount; + } + + public int getNameCode() { + return _nameCode; + } + + public org.xml.sax.Attributes getAttributes() { + return _attributes; + } + + public int[] getNamespaces() { + return _namespaces; + } + + public int getNSCount() { + return _nscount; + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/ColumnScanEmitter.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/ColumnScanEmitter.java new file mode 100644 index 0000000000..ff51eb7d1f --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/ColumnScanEmitter.java @@ -0,0 +1,170 @@ +package com.nwalsh.saxon; + +import org.xml.sax.*; +import javax.xml.transform.TransformerException; +import com.icl.saxon.output.*; +import com.icl.saxon.om.*; +import com.icl.saxon.expr.FragmentValue; + +/** + *

                  Saxon extension to scan the column widths in a result tree fragment.

                  + * + *

                  $Id: ColumnScanEmitter.java,v 1.3 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Saxon 6.* + * implementation to scan the column widths in a result tree + * fragment.

                  + * + *

                  The general design is this: the stylesheets construct a result tree + * fragment for some colgroup environment. That result tree fragment + * is "replayed" through the ColumnScanEmitter; the ColumnScanEmitter watches + * the cols go by and extracts the column widths that it sees. These + * widths are then made available.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: ColumnScanEmitter.java,v 1.3 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class ColumnScanEmitter extends com.icl.saxon.output.Emitter { + /** The number of columns seen. */ + protected int numColumns = 0; + protected String width[] = new String[5]; + protected NamePool namePool = null; + + /** The FO namespace name. */ + protected static String foURI = "http://www.w3.org/1999/XSL/Format"; + + /** Construct a new ColumnScanEmitter. */ + public ColumnScanEmitter(NamePool namePool) { + numColumns = 0; + this.namePool = namePool; + } + + /** Return the number of columns. */ + public int columnCount() { + return numColumns; + } + + /** Return the number of columns. */ + public String[] columnWidths() { + // Return a width array with exactly the right number of columns + String rWidth[] = new String[numColumns]; + for (int count = 0; count < numColumns; count++) { + rWidth[count] = width[count]; + } + return rWidth; + } + + /** Discarded. */ + public void characters(char[] chars, int start, int len) + throws TransformerException { + // nop + } + + /** Discarded. */ + public void comment(char[] chars, int start, int length) + throws TransformerException { + // nop + } + + /** Discarded. */ + public void endDocument() + throws TransformerException { + // nop + } + + /** Discarded. */ + public void endElement(int nameCode) + throws TransformerException { + // nop + } + + /** Discarded. */ + public void processingInstruction(java.lang.String name, + java.lang.String data) + throws TransformerException { + // nop + } + + /** Discarded. */ + public void setDocumentLocator(org.xml.sax.Locator locator) { + // nop + } + + /** Discarded. */ + public void setEscaping(boolean escaping) + throws TransformerException { + // nop + } + + /** Discarded. */ + public void setNamePool(NamePool namePool) { + // nop + } + + /** Discarded. */ + public void setUnparsedEntity(java.lang.String name, java.lang.String uri) + throws TransformerException { + // nop + } + + /** Discarded. */ + public void setWriter(java.io.Writer writer) { + // nop + } + + /** Discarded. */ + public void startDocument() + throws TransformerException { + // nop + } + + /** Examine for column info. */ + public void startElement(int nameCode, + org.xml.sax.Attributes attributes, + int[] namespaces, int nscount) + throws TransformerException { + + int thisFingerprint = namePool.getFingerprint(nameCode); + int colFingerprint = namePool.getFingerprint("", "col"); + int foColFingerprint = namePool.getFingerprint(foURI, "table-column"); + + if (thisFingerprint == colFingerprint + || thisFingerprint == foColFingerprint) { + if (numColumns >= width.length) { + String newWidth[] = new String[width.length+10]; + for (int count = 0; count < width.length; count++) { + newWidth[count] = width[count]; + } + width = newWidth; + } + + if (thisFingerprint == colFingerprint) { + if (attributes.getValue("width") == null) { + width[numColumns++] = "1*"; + } else { + width[numColumns++] = attributes.getValue("width"); + } + } else { + if (attributes.getValue("column-width") == null) { + width[numColumns++] = "1*"; + } else { + width[numColumns++] = attributes.getValue("column-width"); + } + } + } + } +} + + diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/ColumnUpdateEmitter.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/ColumnUpdateEmitter.java new file mode 100644 index 0000000000..d2786c8013 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/ColumnUpdateEmitter.java @@ -0,0 +1,96 @@ +package com.nwalsh.saxon; + +import org.xml.sax.*; +import com.icl.saxon.output.*; +import com.icl.saxon.Controller; +import com.icl.saxon.om.*; +import javax.xml.transform.TransformerException; +import com.icl.saxon.expr.FragmentValue; +import com.icl.saxon.tree.AttributeCollection; + +/** + *

                  Saxon extension to scan the column widths in a result tree fragment.

                  + * + *

                  $Id: ColumnUpdateEmitter.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Saxon 6.* + * implementation to scan the column widths in a result tree + * fragment.

                  + * + *

                  The general design is this: the stylesheets construct a result tree + * fragment for some colgroup environment. That result tree fragment + * is "replayed" through the ColumnUpdateEmitter; the ColumnUpdateEmitter watches + * the cols go by and extracts the column widths that it sees. These + * widths are then made available.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: ColumnUpdateEmitter.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class ColumnUpdateEmitter extends CopyEmitter { + /** The number of columns seen. */ + protected int numColumns = 0; + protected String width[] = null; + protected NamePool namePool = null; + + /** The FO namespace name. */ + protected static String foURI = "http://www.w3.org/1999/XSL/Format"; + + /** Construct a new ColumnUpdateEmitter. */ + public ColumnUpdateEmitter(Controller controller, + NamePool namePool, + String width[]) { + super(controller, namePool); + numColumns = 0; + this.width = width; + this.namePool = namePool; + } + + /** Examine for column info. */ + public void startElement(int nameCode, + org.xml.sax.Attributes attributes, + int[] namespaces, int nscount) + throws TransformerException { + + int thisFingerprint = namePool.getFingerprint(nameCode); + int colFingerprint = namePool.getFingerprint("", "col"); + int foColFingerprint = namePool.getFingerprint(foURI, "table-column"); + + if (thisFingerprint == colFingerprint) { + AttributeCollection attr = new AttributeCollection(namePool, attributes); + int widthFingerprint = namePool.getFingerprint("", "width"); + + if (attr.getValueByFingerprint(widthFingerprint) == null) { + attr.addAttribute(widthFingerprint, "CDATA", width[numColumns++]); + } else { + attr.setAttribute(widthFingerprint, "CDATA", width[numColumns++]); + } + attributes = attr; + } else if (thisFingerprint == foColFingerprint) { + AttributeCollection attr = new AttributeCollection(namePool, attributes); + int widthFingerprint = namePool.getFingerprint("", "column-width"); + + if (attr.getValueByFingerprint(widthFingerprint) == null) { + attr.addAttribute(widthFingerprint, "CDATA", width[numColumns++]); + } else { + attr.setAttribute(widthFingerprint, "CDATA", width[numColumns++]); + } + attributes = attr; + } + + rtfEmitter.startElement(nameCode, attributes, namespaces, nscount); + } +} + + diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/CopyEmitter.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/CopyEmitter.java new file mode 100644 index 0000000000..0a8d5ec1aa --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/CopyEmitter.java @@ -0,0 +1,150 @@ +package com.nwalsh.saxon; + +import java.util.Stack; +import java.util.StringTokenizer; +import org.xml.sax.*; +import org.w3c.dom.*; +import javax.xml.transform.TransformerException; +import com.icl.saxon.Context; +import com.icl.saxon.expr.*; +import com.icl.saxon.expr.FragmentValue; +import com.icl.saxon.Controller; +import com.icl.saxon.functions.Extensions; +import com.icl.saxon.om.*; +import com.icl.saxon.output.*; +import com.icl.saxon.pattern.*; +import com.icl.saxon.tree.*; + +/** + *

                  A Saxon 6.0 Emitter that clones its input.

                  + * + *

                  $Id: CopyEmitter.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Saxon 6.* + * implementation of an emitter that manufactures a cloned result + * tree fragment.

                  + * + *

                  The purpose of this emitter is to provide something for + * CalloutEmitter and NumberLinesEmitter to extend. + * This emitter simply copies all input to a new result tree fragment.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @see CalloutEmitter + * @see NumberLinesEmitter + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: CopyEmitter.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class CopyEmitter extends com.icl.saxon.output.Emitter { + /** The result tree fragment containing the copied fragment. */ + protected FragmentValue rtf = null; + protected Emitter rtfEmitter = null; + + /**

                  The namePool.

                  + * + *

                  Copied from the caller, it should be the runtime name pool.

                  + */ + protected NamePool namePool = null; + + /**

                  Constructor for the CopyEmitter.

                  + * + * @param namePool The name pool to use for constructing elements and attributes. + */ + public CopyEmitter(Controller controller, NamePool namePool) { + rtf = new FragmentValue(controller); + rtfEmitter = rtf.getEmitter(); + this.namePool = namePool; + } + + /** + *

                  Return the result tree fragment constructed by replaying events + * through this emitter.

                  + */ + public FragmentValue getResultTreeFragment() { + return rtf; + } + + /** Copy characters. */ + public void characters(char[] chars, int start, int len) + throws TransformerException { + rtfEmitter.characters(chars, start, len); + } + + /** Copy comments. */ + public void comment(char[] chars, int start, int length) + throws TransformerException { + rtfEmitter.comment(chars, start, length); + } + + /** Copy end document events. */ + public void endDocument() + throws TransformerException { + rtfEmitter.endDocument(); + } + + /** Copy end element events. */ + public void endElement(int nameCode) + throws TransformerException { + rtfEmitter.endElement(nameCode); + } + + /** Copy processing instructions. */ + public void processingInstruction(java.lang.String name, + java.lang.String data) + throws TransformerException { + rtfEmitter.processingInstruction(name, data); + } + + /** Copy set document locator events. */ + public void setDocumentLocator(org.xml.sax.Locator locator) { + rtfEmitter.setDocumentLocator(locator); + } + + /** Copy set escaping events. */ + public void setEscaping(boolean escaping) + throws TransformerException { + rtfEmitter.setEscaping(escaping); + } + + /** Copy set name pool events. */ + public void setNamePool(NamePool namePool) { + rtfEmitter.setNamePool(namePool); + } + + /** Copy set unparsed entity events. */ + public void setUnparsedEntity(java.lang.String name, java.lang.String uri) + throws TransformerException { + rtfEmitter.setUnparsedEntity(name, uri); + } + + /** Copy set writer events. */ + public void setWriter(java.io.Writer writer) { + rtfEmitter.setWriter(writer); + } + + /** Copy start document events. */ + public void startDocument() + throws TransformerException { + rtfEmitter.startDocument(); + } + + /** Copy start element events. */ + public void startElement(int nameCode, + org.xml.sax.Attributes attributes, + int[] namespaces, + int nscount) + throws TransformerException { + rtfEmitter.startElement(nameCode, attributes, namespaces, nscount); + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatCallout.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatCallout.java new file mode 100644 index 0000000000..94e63b5bc2 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatCallout.java @@ -0,0 +1,111 @@ +package com.nwalsh.saxon; + +import org.xml.sax.SAXException; +import org.w3c.dom.*; + +import javax.xml.transform.TransformerException; + +import com.icl.saxon.om.NamePool; +import com.icl.saxon.output.Emitter; +import com.icl.saxon.tree.AttributeCollection; + +import com.nwalsh.saxon.Callout; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatCallout.java,v 1.2 2001/07/31 18:35:35 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatCallout.java,v 1.2 2001/07/31 18:35:35 nwalsh Exp $ + **/ + +public abstract class FormatCallout { + protected static final String foURI = "http://www.w3.org/1999/XSL/Format"; + protected static final String xhURI = "http://www.w3.org/1999/xhtml"; + protected boolean foStylesheet = false; + protected NamePool namePool = null; + + public FormatCallout(NamePool nPool, boolean fo) { + namePool = nPool; + foStylesheet = fo; + } + + public String areaLabel(Element area) { + String label = null; + + if (area.hasAttribute("label")) { + // If this area has a label, use it + label = area.getAttribute("label"); + } else { + // Otherwise, if its parent is an areaset and it has a label, use that + Element parent = (Element) area.getParentNode(); + if (parent != null + && parent.getLocalName().equalsIgnoreCase("areaset") + && parent.hasAttribute("label")) { + label = parent.getAttribute("label"); + } + } + + return label; + } + + public void startSpan(Emitter rtf) + throws TransformerException { + // no point in doing this for FO, right? + if (!foStylesheet && namePool != null) { + int spanName = namePool.allocate("", "", "span"); + AttributeCollection spanAttr = new AttributeCollection(namePool); + int namespaces[] = new int[1]; + spanAttr.addAttribute("", "", "class", "CDATA", "co"); + rtf.startElement(spanName, spanAttr, namespaces, 0); + } + } + + public void endSpan(Emitter rtf) + throws TransformerException { + // no point in doing this for FO, right? + if (!foStylesheet && namePool != null) { + int spanName = namePool.allocate("", "", "span"); + rtf.endElement(spanName); + } + } + + public void formatTextCallout(Emitter rtfEmitter, + Callout callout) { + Element area = callout.getArea(); + int num = callout.getCallout(); + String userLabel = areaLabel(area); + String label = "(" + num + ")"; + + if (userLabel != null) { + label = userLabel; + } + + char chars[] = label.toCharArray(); + + try { + startSpan(rtfEmitter); + rtfEmitter.characters(chars, 0, label.length()); + endSpan(rtfEmitter); + } catch (TransformerException e) { + System.out.println("Transformer Exception in formatTextCallout"); + } + } + + public abstract void formatCallout(Emitter rtfEmitter, + Callout callout); +} + diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatGraphicCallout.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatGraphicCallout.java new file mode 100644 index 0000000000..ac0695a84b --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatGraphicCallout.java @@ -0,0 +1,88 @@ +package com.nwalsh.saxon; + +import org.xml.sax.SAXException; +import org.w3c.dom.*; + +import javax.xml.transform.TransformerException; + +import com.icl.saxon.om.NamePool; +import com.icl.saxon.output.Emitter; +import com.icl.saxon.tree.AttributeCollection; + +import com.nwalsh.saxon.Callout; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatGraphicCallout.java,v 1.1 2001/07/16 21:23:57 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatGraphicCallout.java,v 1.1 2001/07/16 21:23:57 nwalsh Exp $ + **/ + +public class FormatGraphicCallout extends FormatCallout { + String graphicsPath = ""; + String graphicsExt = ""; + int graphicsMax = 0; + + public FormatGraphicCallout(NamePool nPool, String path, String ext, int max, boolean fo) { + super(nPool, fo); + graphicsPath = path; + graphicsExt = ext; + graphicsMax = max; + } + + public void formatCallout(Emitter rtfEmitter, + Callout callout) { + Element area = callout.getArea(); + int num = callout.getCallout(); + String userLabel = areaLabel(area); + String label = "(" + num + ")"; + + if (userLabel != null) { + label = userLabel; + } + + try { + if (userLabel == null && num <= graphicsMax) { + int imgName = 0; + AttributeCollection imgAttr = null; + int namespaces[] = new int[1]; + + if (foStylesheet) { + imgName = namePool.allocate("fo", foURI, "external-graphic"); + imgAttr = new AttributeCollection(namePool); + imgAttr.addAttribute("", "", "src", "CDATA", + graphicsPath + num + graphicsExt); + } else { + imgName = namePool.allocate("", "", "img"); + imgAttr = new AttributeCollection(namePool); + imgAttr.addAttribute("", "", "src", "CDATA", + graphicsPath + num + graphicsExt); + imgAttr.addAttribute("", "", "alt", "CDATA", label); + } + + startSpan(rtfEmitter); + rtfEmitter.startElement(imgName, imgAttr, namespaces, 0); + rtfEmitter.endElement(imgName); + endSpan(rtfEmitter); + } else { + formatTextCallout(rtfEmitter, callout); + } + } catch (TransformerException e) { + System.out.println("Transformer Exception in graphic formatCallout"); + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatTextCallout.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatTextCallout.java new file mode 100644 index 0000000000..2cc5554c45 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatTextCallout.java @@ -0,0 +1,43 @@ +package com.nwalsh.saxon; + +import org.xml.sax.SAXException; +import org.w3c.dom.*; + +import javax.xml.transform.TransformerException; + +import com.icl.saxon.om.NamePool; +import com.icl.saxon.output.Emitter; + +import com.nwalsh.saxon.Callout; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatTextCallout.java,v 1.1 2001/07/16 21:23:57 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatTextCallout.java,v 1.1 2001/07/16 21:23:57 nwalsh Exp $ + **/ + +public class FormatTextCallout extends FormatCallout { + public FormatTextCallout(NamePool nPool, boolean fo) { + super(nPool, fo); + } + + public void formatCallout(Emitter rtfEmitter, + Callout callout) { + formatTextCallout(rtfEmitter, callout); + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatUnicodeCallout.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatUnicodeCallout.java new file mode 100644 index 0000000000..4299be0494 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/FormatUnicodeCallout.java @@ -0,0 +1,98 @@ +package com.nwalsh.saxon; + +import org.xml.sax.SAXException; +import org.w3c.dom.*; + +import javax.xml.transform.TransformerException; + +import com.icl.saxon.om.NamePool; +import com.icl.saxon.output.Emitter; +import com.icl.saxon.tree.AttributeCollection; + +import com.nwalsh.saxon.Callout; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatUnicodeCallout.java,v 1.2 2001/08/05 22:35:38 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatUnicodeCallout.java,v 1.2 2001/08/05 22:35:38 nwalsh Exp $ + **/ + +public class FormatUnicodeCallout extends FormatCallout { + int unicodeMax = 0; + int unicodeStart = 0; + String unicodeFont = ""; + + public FormatUnicodeCallout(NamePool nPool, + String font, + int start, + int max, + boolean fo) { + super(nPool, fo); + unicodeFont = font; + unicodeMax = max; + unicodeStart = start; + } + + public void formatCallout(Emitter rtfEmitter, + Callout callout) { + Element area = callout.getArea(); + int num = callout.getCallout(); + String userLabel = areaLabel(area); + String label = ""; + + if (userLabel != null) { + label = userLabel; + } + + try { + if (userLabel == null && num <= unicodeMax) { + int inName = 0; + AttributeCollection inAttr = null; + int namespaces[] = new int[1]; + + if (!unicodeFont.equals("")) { + if (foStylesheet) { + inName = namePool.allocate("fo", foURI, "inline"); + inAttr = new AttributeCollection(namePool); + inAttr.addAttribute("", "", "font-family", "CDATA", unicodeFont); + } else { + inName = namePool.allocate("", "", "font"); + inAttr = new AttributeCollection(namePool); + inAttr.addAttribute("", "", "face", "CDATA", unicodeFont); + } + + startSpan(rtfEmitter); + rtfEmitter.startElement(inName, inAttr, namespaces, 0); + } + + char chars[] = new char[1]; + chars[0] = (char) (unicodeStart + num - 1); + rtfEmitter.characters(chars, 0, 1); + + if (!unicodeFont.equals("")) { + rtfEmitter.endElement(inName); + endSpan(rtfEmitter); + } + } else { + formatTextCallout(rtfEmitter, callout); + } + } catch (TransformerException e) { + System.out.println("Transformer Exception in graphic formatCallout"); + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java new file mode 100644 index 0000000000..d4e0f96cfa --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/ImageIntrinsics.java @@ -0,0 +1,189 @@ +package com.nwalsh.saxon; + +import java.io.File; +import java.io.BufferedReader; +import java.io.FileReader; +import java.io.IOException; +import java.net.URL; +import java.net.MalformedURLException; +import java.awt.Toolkit; +import java.awt.Image; +import java.awt.image.ImageObserver; +import java.lang.Thread; +import java.util.StringTokenizer; + +/** + *

                  Saxon extension to examine intrinsic size of images

                  + * + *

                  $Id: ImageIntrinsics.java,v 1.5 2005/12/06 18:56:52 kosek Exp $

                  + * + *

                  Copyright (C) 2002 Norman Walsh.

                  + * + *

                  This class provides a + * Saxon + * extension to find the intrinsic size of images.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: ImageIntrinsics.java,v 1.5 2005/12/06 18:56:52 kosek Exp $ + * + */ +public class ImageIntrinsics implements ImageObserver { + boolean imageLoaded = false; + boolean imageFailed = false; + Image image = null; + int width = -1; + int depth = -1; + + /** + *

                  Constructor for ImageIntrinsics

                  + */ + public ImageIntrinsics(String imageFn) { + System.setProperty("java.awt.headless","true"); + + // Hack. I expect the right way to do this is to always use a URL. + // However, that means getting the base URI correct and dealing + // with the various permutations of the file: URI scheme on different + // platforms. So instead, what we're going to do is cheat. If it + // starts with http: or ftp:, call it a URI. Otherwise, call it + // a file. Also call it a file if the URI is malformed. + + URL imageUrl = null; + + if (imageFn.startsWith("http:") || imageFn.startsWith("ftp:") || imageFn.startsWith("file:")) { + try { + imageUrl = new URL(imageFn); + } catch (MalformedURLException mue) { + imageUrl = null; + } + } + + if (imageUrl != null) { + image = Toolkit.getDefaultToolkit().getImage (imageUrl); + } else { + image = Toolkit.getDefaultToolkit().getImage (imageFn); + } + + width = image.getWidth(this); + + while (!imageFailed && (width == -1 || depth == -1)) { + try { + java.lang.Thread.currentThread().sleep(50); + } catch (Exception e) { + // nop; + } + width = image.getWidth(this); + depth = image.getHeight(this); + } + + if (imageFailed) { + // Maybe it's an EPS or PDF? + // FIXME: this code is crude (and doesn't handle the URL case!!!) + BufferedReader ir = null; + String line = null; + int lineLimit = 100; + + try { + ir = new BufferedReader(new FileReader(new File(imageFn))); + line = ir.readLine(); + + if (line != null && line.startsWith("%PDF-")) { + // We've got a PDF! + while (lineLimit > 0 && line != null) { + lineLimit--; + if (line.startsWith("/CropBox [")) { + line = line.substring(10); + if (line.indexOf("]") >= 0) { + line = line.substring(0, line.indexOf("]")); + } + parseBox(line); + lineLimit = 0; + } + line = ir.readLine(); + } + } else if (line != null && line.startsWith("%!") && line.indexOf(" EPSF-") > 0) { + // We've got an EPS! + while (lineLimit > 0 && line != null) { + lineLimit--; + if (line.startsWith("%%BoundingBox: ")) { + line = line.substring(15); + parseBox(line); + lineLimit = 0; + } + line = ir.readLine(); + } + } else { + System.err.println("Failed to interpret image: " + imageFn); + } + } catch (Exception e) { + System.err.println("Failed to load image: " + imageFn); + } + + if (ir != null) { + try { + ir.close(); + } catch (Exception e) { + // nop; + } + } + } + } + + public int getWidth(int defaultWidth) { + if (width >= 0) { + return width; + } else { + return defaultWidth; + } + } + + public int getDepth(int defaultDepth) { + if (depth >= 0) { + return depth; + } else { + return defaultDepth; + } + } + + private void parseBox(String line) { + int [] corners = new int [4]; + int count = 0; + + StringTokenizer st = new StringTokenizer(line); + while (count < 4 && st.hasMoreTokens()) { + try { + corners[count++] = Integer.parseInt(st.nextToken()); + } catch (Exception e) { + // nop; + } + } + + width = corners[2] - corners[0]; + depth = corners[3] - corners[1]; + } + + public boolean imageUpdate(Image img, int infoflags, + int x, int y, int width, int height) { + if ((infoflags & ImageObserver.ERROR) == ImageObserver.ERROR) { + imageFailed = true; + return false; + } + + // I really only care about the width and height, but if I return false as + // soon as those are available, the BufferedInputStream behind the loader + // gets closed too early. + int flags = ImageObserver.ALLBITS; + if ((infoflags & flags) == flags) { + return false; + } else { + return true; + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/LineCountEmitter.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/LineCountEmitter.java new file mode 100644 index 0000000000..4e86539ae8 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/LineCountEmitter.java @@ -0,0 +1,141 @@ +package com.nwalsh.saxon; + +import org.xml.sax.*; +import javax.xml.transform.TransformerException; +import com.icl.saxon.output.*; +import com.icl.saxon.om.*; +import com.icl.saxon.expr.FragmentValue; + +/** + *

                  Saxon extension to count the lines in a result tree fragment.

                  + * + *

                  $Id: LineCountEmitter.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Saxon 6.* + * implementation to count the number of lines in a result tree + * fragment.

                  + * + *

                  The general design is this: the stylesheets construct a result tree + * fragment for some verbatim environment. That result tree fragment + * is "replayed" through the LineCountEmitter; the LineCountEmitter watches + * characters go by and counts the number of line feeds that it sees. + * That number is then returned.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @see Verbatim + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: LineCountEmitter.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class LineCountEmitter extends com.icl.saxon.output.Emitter { + /** The number of lines seen. */ + protected int numLines = 0; + + /** Construct a new LineCountEmitter. */ + public LineCountEmitter() { + numLines = 0; + } + + /** Reset the number of lines. */ + public void reset() { + numLines = 0; + } + + /** Return the number of lines. */ + public int lineCount() { + return numLines; + } + + /** Process characters. */ + public void characters(char[] chars, int start, int len) + throws javax.xml.transform.TransformerException { + + if (numLines == 0) { + // If there are any characters at all, there's at least one line + numLines++; + } + + for (int count = start; count < start+len; count++) { + if (chars[count] == '\n') { + numLines++; + } + } + } + + /** Discarded. */ + public void comment(char[] chars, int start, int length) + throws javax.xml.transform.TransformerException { + // nop + } + + /** Discarded. */ + public void endDocument() + throws javax.xml.transform.TransformerException { + // nop + } + + /** Discarded. */ + public void endElement(int nameCode) + throws javax.xml.transform.TransformerException { + // nop + } + + /** Discarded. */ + public void processingInstruction(java.lang.String name, + java.lang.String data) + throws javax.xml.transform.TransformerException { + // nop + } + + /** Discarded. */ + public void setDocumentLocator(org.xml.sax.Locator locator) { + // nop + } + + /** Discarded. */ + public void setEscaping(boolean escaping) + throws javax.xml.transform.TransformerException { + // nop + } + + /** Discarded. */ + public void setNamePool(NamePool namePool) { + // nop + } + + /** Discarded. */ + public void setUnparsedEntity(java.lang.String name, java.lang.String uri) + throws javax.xml.transform.TransformerException { + // nop + } + + /** Discarded. */ + public void setWriter(java.io.Writer writer) { + // nop + } + + /** Discarded. */ + public void startDocument() + throws javax.xml.transform.TransformerException { + // nop + } + + /** Discarded. */ + public void startElement(int nameCode, + org.xml.sax.Attributes attributes, + int[] namespaces, int nscount) + throws javax.xml.transform.TransformerException { + // nop + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/NumberLinesEmitter.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/NumberLinesEmitter.java new file mode 100644 index 0000000000..d66ffed9b7 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/NumberLinesEmitter.java @@ -0,0 +1,338 @@ +package com.nwalsh.saxon; + +import java.util.Stack; +import java.util.StringTokenizer; +import org.xml.sax.*; +import org.w3c.dom.*; +import javax.xml.transform.TransformerException; +import com.icl.saxon.output.*; +import com.icl.saxon.om.*; +import com.icl.saxon.Controller; +import com.icl.saxon.tree.AttributeCollection; +import com.icl.saxon.expr.FragmentValue; + +/** + *

                  Saxon extension to decorate a result tree fragment with line numbers.

                  + * + *

                  $Id: NumberLinesEmitter.java,v 1.4 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides the guts of a + * Saxon 6.* + * implementation of line numbering for verbatim environments. (It is used + * by the Verbatim class.)

                  + * + *

                  The general design is this: the stylesheets construct a result tree + * fragment for some verbatim environment. The Verbatim class initializes + * a NumberLinesEmitter with information about what lines should be + * numbered and how. Then the result tree fragment + * is "replayed" through the NumberLinesEmitter; the NumberLinesEmitter + * builds a + * new result tree fragment from this event stream, decorated with line + * numbers, + * and that is returned.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @see Verbatim + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: NumberLinesEmitter.java,v 1.4 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class NumberLinesEmitter extends CopyEmitter { + /** A stack for the preserving information about open elements. */ + protected Stack elementStack = null; + + /** The current line number. */ + protected int lineNumber = 0; + + /** Is the next element absolutely the first element in the fragment? */ + protected boolean firstElement = false; + + /** The FO namespace name. */ + protected static String foURI = "http://www.w3.org/1999/XSL/Format"; + + /** The XHTML namespace name. */ + protected static String xhURI = "http://www.w3.org/1999/xhtml"; + + /** The first line number will be startinglinenumber. */ + protected int startinglinenumber = 1; + + /** Every modulus line will be numbered. */ + protected int modulus = 5; + + /** Line numbers are width characters wide. */ + protected int width = 3; + + /** Line numbers are separated from the listing by separator. */ + protected String separator = " "; + + /** Is the stylesheet currently running an FO stylesheet? */ + protected boolean foStylesheet = false; + + /**

                  Constructor for the NumberLinesEmitter.

                  + * + * @param namePool The name pool to use for constructing elements and attributes. + * @param modulus The modulus to use for this listing. + * @param width The width to use for line numbers in this listing. + * @param separator The separator to use for this listing. + * @param foStylesheet Is this an FO stylesheet? + */ + public NumberLinesEmitter(Controller controller, + NamePool namePool, + int startingLineNumber, + int modulus, + int width, + String separator, + boolean foStylesheet) { + super(controller,namePool); + elementStack = new Stack(); + firstElement = true; + + this.modulus = modulus; + this.startinglinenumber = startingLineNumber; + this.width = width; + this.separator = separator; + this.foStylesheet = foStylesheet; + } + + /** Process characters. */ + public void characters(char[] chars, int start, int len) + throws TransformerException { + + // If we hit characters, then there's no first element... + firstElement = false; + + if (lineNumber == 0) { + // The first line is always numbered + lineNumber = startinglinenumber; + formatLineNumber(lineNumber); + } + + // Walk through the text node looking for newlines + char[] newChars = new char[len]; + int pos = 0; + for (int count = start; count < start+len; count++) { + if (chars[count] == '\n') { + // This is the tricky bit; if we find a newline, make sure + // it doesn't occur inside any markup. + + if (pos > 0) { + // Output any characters that preceded this newline + rtfEmitter.characters(newChars, 0, pos); + pos = 0; + } + + // Close all the open elements... + Stack tempStack = new Stack(); + while (!elementStack.empty()) { + StartElementInfo elem = (StartElementInfo) elementStack.pop(); + rtfEmitter.endElement(elem.getNameCode()); + tempStack.push(elem); + } + + // Copy the newline to the output + newChars[pos++] = chars[count]; + rtfEmitter.characters(newChars, 0, pos); + pos = 0; + + // Add the line number + formatLineNumber(++lineNumber); + + // Now "reopen" the elements that we closed... + while (!tempStack.empty()) { + StartElementInfo elem = (StartElementInfo) tempStack.pop(); + AttributeCollection attr = (AttributeCollection)elem.getAttributes(); + AttributeCollection newAttr = new AttributeCollection(namePool); + + for (int acount = 0; acount < attr.getLength(); acount++) { + String localName = attr.getLocalName(acount); + int nameCode = attr.getNameCode(acount); + String type = attr.getType(acount); + String value = attr.getValue(acount); + String uri = attr.getURI(acount); + String prefix = ""; + + if (localName.indexOf(':') > 0) { + prefix = localName.substring(0, localName.indexOf(':')); + localName = localName.substring(localName.indexOf(':')+1); + } + + if (uri.equals("") + && ((foStylesheet + && localName.equals("id")) + || (!foStylesheet + && (localName.equals("id") + || localName.equals("name"))))) { + // skip this attribute + } else { + newAttr.addAttribute(prefix, uri, localName, type, value); + } + } + + rtfEmitter.startElement(elem.getNameCode(), + newAttr, + elem.getNamespaces(), + elem.getNSCount()); + + elementStack.push(elem); + } + } else { + newChars[pos++] = chars[count]; + } + } + + if (pos > 0) { + rtfEmitter.characters(newChars, 0, pos); + pos = 0; + } + } + + /** + *

                  Add a formatted line number to the result tree fragment.

                  + * + * @param lineNumber The number of the current line. + */ + protected void formatLineNumber(int lineNumber) + throws TransformerException { + + char ch = 160; //   + + String lno = ""; + if (lineNumber == 1 + || (modulus >= 1 && (lineNumber % modulus == 0))) { + lno = "" + lineNumber; + } + + while (lno.length() < width) { + lno = ch + lno; + } + + lno += separator; + + char chars[] = new char[lno.length()]; + for (int count = 0; count < lno.length(); count++) { + chars[count] = lno.charAt(count); + } + + characters(chars, 0, lno.length()); + } + + /** Process end element events. */ + public void endElement(int nameCode) + throws TransformerException { + if (!elementStack.empty()) { + // if we didn't push the very first element (an fo:block or + // pre or div surrounding the whole block), then the stack will + // be empty when we get to the end of the first element... + elementStack.pop(); + } + rtfEmitter.endElement(nameCode); + } + + /** Process start element events. */ + public void startElement(int nameCode, + org.xml.sax.Attributes attributes, + int[] namespaces, + int nscount) + throws TransformerException { + + if (!skipThisElement(nameCode)) { + StartElementInfo sei = new StartElementInfo(nameCode, attributes, + namespaces, nscount); + elementStack.push(sei); + } + + firstElement = false; + + rtfEmitter.startElement(nameCode, attributes, namespaces, nscount); + } + + /** + *

                  Protect the outer-most block wrapper.

                  + * + *

                  Open elements in the result tree fragment are closed and reopened + * around callouts (so that callouts don't appear inside links or other + * environments). But if the result tree fragment is a single block + * (a div or pre in HTML, an fo:block in FO), that outer-most block is + * treated specially.

                  + * + *

                  This method returns true if the element in question is that + * outermost block.

                  + * + * @param nameCode The name code for the element + * + * @return True if the element is the outer-most block, false otherwise. + */ + protected boolean skipThisElement(int nameCode) { + // FIXME: This is such a gross hack... + if (firstElement) { + int thisFingerprint = namePool.getFingerprint(nameCode); + int foBlockFingerprint = namePool.getFingerprint(foURI, "block"); + int htmlPreFingerprint = namePool.getFingerprint("", "pre"); + int htmlDivFingerprint = namePool.getFingerprint("", "div"); + int xhtmlPreFingerprint = namePool.getFingerprint(xhURI, "pre"); + int xhtmlDivFingerprint = namePool.getFingerprint(xhURI, "div"); + + if ((foStylesheet && thisFingerprint == foBlockFingerprint) + || (!foStylesheet && (thisFingerprint == htmlPreFingerprint + || thisFingerprint == htmlDivFingerprint + || thisFingerprint == xhtmlPreFingerprint + || thisFingerprint == xhtmlDivFingerprint))) { + // Don't push the outer-most wrapping div, pre, or fo:block + return true; + } + } + + return false; + } + + /** + *

                  A private class for maintaining the information required to call + * the startElement method.

                  + * + *

                  In order to close and reopen elements, information about those + * elements has to be maintained. This class is just the little record + * that we push on the stack to keep track of that info.

                  + */ + private class StartElementInfo { + private int _nameCode; + org.xml.sax.Attributes _attributes; + int[] _namespaces; + int _nscount; + + public StartElementInfo(int nameCode, + org.xml.sax.Attributes attributes, + int[] namespaces, + int nscount) { + _nameCode = nameCode; + _attributes = attributes; + _namespaces = namespaces; + _nscount = nscount; + } + + public int getNameCode() { + return _nameCode; + } + + public org.xml.sax.Attributes getAttributes() { + return _attributes; + } + + public int[] getNamespaces() { + return _namespaces; + } + + public int getNSCount() { + return _nscount; + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Table.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Table.java new file mode 100644 index 0000000000..c5cc96a26f --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Table.java @@ -0,0 +1,477 @@ +// Verbatim.java - Saxon extensions supporting DocBook verbatim environments + +package com.nwalsh.saxon; + +import java.util.Hashtable; +import org.xml.sax.*; +import org.w3c.dom.*; +import javax.xml.transform.TransformerException; +import com.icl.saxon.Controller; +import com.icl.saxon.expr.*; +import com.icl.saxon.om.*; +import com.icl.saxon.pattern.*; +import com.icl.saxon.Context; +import com.icl.saxon.tree.*; +import com.icl.saxon.functions.Extensions; + +/** + *

                  Saxon extensions supporting Tables

                  + * + *

                  $Id: Table.java,v 1.3 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Saxon + * implementation of some code to adjust CALS Tables to HTML + * Tables.

                  + * + *

                  Column Widths

                  + *

                  The adjustColumnWidths method takes a result tree + * fragment (assumed to contain the colgroup of an HTML Table) + * and returns the result tree fragment with the column widths + * adjusted to HTML terms.

                  + * + *

                  Convert Lengths

                  + *

                  The convertLength method takes a length specification + * of the form 9999.99xx (where "xx" is a unit) and returns that length + * as an integral number of pixels. For convenience, percentage lengths + * are returned unchanged.

                  + *

                  The recognized units are: inches (in), centimeters (cm), + * millimeters (mm), picas (pc, 1pc=12pt), points (pt), and pixels (px). + * A number with no units is assumed to be pixels.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: Table.java,v 1.3 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class Table { + /** The number of pixels per inch */ + private static int pixelsPerInch = 96; + + /** The nominal table width (6in by default). */ + private static int nominalWidth = 6 * pixelsPerInch; + + /** The default table width (100% by default). */ + private static String tableWidth = "100%"; + + /** Is this an FO stylesheet? */ + private static boolean foStylesheet = false; + + /** The hash used to associate units with a length in pixels. */ + protected static Hashtable unitHash = null; + + /** + *

                  Constructor for Verbatim

                  + * + *

                  All of the methods are static, so the constructor does nothing.

                  + */ + public Table() { + } + + /** Initialize the internal hash table with proper values. */ + protected static void initializeHash() { + unitHash = new Hashtable(); + unitHash.put("in", new Float(pixelsPerInch)); + unitHash.put("cm", new Float(pixelsPerInch / 2.54)); + unitHash.put("mm", new Float(pixelsPerInch / 25.4)); + unitHash.put("pc", new Float((pixelsPerInch / 72) * 12)); + unitHash.put("pt", new Float(pixelsPerInch / 72)); + unitHash.put("px", new Float(1)); + } + + /** Set the pixels-per-inch value. Only positive values are legal. */ + public static void setPixelsPerInch(int value) { + if (value > 0) { + pixelsPerInch = value; + initializeHash(); + } + } + + /** Return the current pixels-per-inch value. */ + public int getPixelsPerInch() { + return pixelsPerInch; + } + + /** + *

                  Convert a length specification to a number of pixels.

                  + * + *

                  The specified length should be of the form [+/-]999.99xx, + * where xx is a valid unit.

                  + */ + public static int convertLength(String length) { + // The format of length should be 999.999xx + int sign = 1; + String digits = ""; + String units = ""; + char lench[] = length.toCharArray(); + float flength = 0; + boolean done = false; + int pos = 0; + float factor = 1; + int pixels = 0; + + if (unitHash == null) { + initializeHash(); + } + + if (lench[pos] == '+' || lench[pos] == '-') { + if (lench[pos] == '-') { + sign = -1; + } + pos++; + } + + while (!done) { + if (pos >= lench.length) { + done = true; + } else { + if ((lench[pos] > '9' || lench[pos] < '0') && lench[pos] != '.') { + done = true; + units = length.substring(pos); + } else { + digits += lench[pos++]; + } + } + } + + try { + flength = Float.parseFloat(digits); + } catch (NumberFormatException e) { + System.out.println(digits + " is not a number; 1 used instead."); + flength = 1; + } + + Float f = null; + + if (!units.equals("")) { + f = (Float) unitHash.get(units); + if (f == null) { + System.out.println(units + " is not a known unit; 1 used instead."); + factor = 1; + } else { + factor = f.floatValue(); + } + } else { + factor = 1; + } + + f = new Float(flength * factor); + + pixels = f.intValue() * sign; + + return pixels; + } + + /** + *

                  Find the string value of a stylesheet variable or parameter

                  + * + *

                  Returns the string value of varName in the current + * context. Returns the empty string if the variable is + * not defined.

                  + * + * @param context The current stylesheet context + * @param varName The name of the variable (without the dollar sign) + * + * @return The string value of the variable + */ + protected static String getVariable(Context context, String varName) + throws TransformerException { + Value variable = null; + String varString = null; + + try { + variable = Extensions.evaluate(context, "$" + varName); + varString = variable.asString(); + return varString; + } catch (IllegalArgumentException e) { + System.out.println("Undefined variable: " + varName); + return ""; + } + } + + /** + *

                  Setup the parameters associated with column width calculations

                  + * + *

                  This method queries the stylesheet for the variables + * associated with table column widths. It is called automatically before + * column widths are adjusted. The context is used to retrieve the values, + * this allows templates to redefine these variables.

                  + * + *

                  The following variables are queried. If the variables do not + * exist, builtin defaults will be used (but you may also get a bunch + * of messages from the Java interpreter).

                  + * + *
                  + *
                  nominal.table.width
                  + *
                  The "normal" width for tables. This must be an absolute length.
                  + *
                  table.width
                  + *
                  The width for tables. This may be either an absolute + * length or a percentage.
                  + *
                  + * + * @param context The current stylesheet context + * + */ + private static void setupColumnWidths(Context context) { + // Hardcoded defaults + nominalWidth = 6 * pixelsPerInch; + tableWidth = "100%"; + + String varString = null; + + try { + // Get the stylesheet type + varString = getVariable(context, "stylesheet.result.type"); + foStylesheet = varString.equals("fo"); + + // Get the nominal table width + varString = getVariable(context, "nominal.table.width"); + nominalWidth = convertLength(varString); + + // Get the table width + varString = getVariable(context, "table.width"); + tableWidth = varString; + } catch (TransformerException e) { + //nop, can't happen + } + } + + /** + *

                  Adjust column widths in an HTML table.

                  + * + *

                  The specification of column widths in CALS (a relative width + * plus an optional absolute width) are incompatible with HTML column + * widths. This method adjusts CALS column width specifiers in an + * attempt to produce equivalent HTML specifiers.

                  + * + *

                  In order for this method to work, the CALS width specifications + * should be placed in the "width" attribute of the <col>s within + * a <colgroup>. Then the colgroup result tree fragment is passed + * to this method.

                  + * + *

                  This method makes use of two parameters from the XSL stylesheet + * that calls it: nominal.table.width and + * table.width. The value of nominal.table.width + * must be an absolute distance. The value of table.width + * can be either absolute or relative.

                  + * + *

                  Presented with a mixture of relative and + * absolute lengths, the table width is used to calculate + * appropriate values. If the table.width is relative, + * the nominal width is used for this calculation.

                  + * + *

                  There are three possible combinations of values:

                  + * + *
                    + *
                  1. There are no relative widths; in this case the absolute widths + * are used in the HTML table.
                    2. + *
                  2. There are no absolute widths; in this case the relative widths + * are used in the HTML table.
                    3. + *
                  3. There are a mixture of absolute and relative widths: + *
                      + *
                    1. If the table width is absolute, all widths become absolute.
                      2. + *
                    2. If the table width is relative, make all the widths absolute + * relative to the nominal table width then turn them all + * back into relative widths.
                      3. + *
                    + *
                    4. + *
                  + * + * @param context The stylesheet context; supplied automatically by Saxon + * @param rtf_ns The result tree fragment containing the colgroup. + * + * @return The result tree fragment containing the adjusted colgroup. + * + */ + public static NodeSetValue adjustColumnWidths (Context context, + NodeSetValue rtf_ns) { + + FragmentValue rtf = (FragmentValue) rtf_ns; + + setupColumnWidths(context); + + try { + Controller controller = context.getController(); + NamePool namePool = controller.getNamePool(); + + ColumnScanEmitter csEmitter = new ColumnScanEmitter(namePool); + rtf.replay(csEmitter); + + int numColumns = csEmitter.columnCount(); + String widths[] = csEmitter.columnWidths(); + + float relTotal = 0; + float relParts[] = new float[numColumns]; + + float absTotal = 0; + float absParts[] = new float[numColumns]; + + for (int count = 0; count < numColumns; count++) { + String width = widths[count]; + + int pos = width.indexOf("*"); + if (pos >= 0) { + String relPart = width.substring(0, pos); + String absPart = width.substring(pos+1); + + try { + float rel = Float.parseFloat(relPart); + relTotal += rel; + relParts[count] = rel; + } catch (NumberFormatException e) { + System.out.println(relPart + " is not a valid relative unit."); + } + + int pixels = 0; + if (absPart != null && !absPart.equals("")) { + pixels = convertLength(absPart); + } + + absTotal += pixels; + absParts[count] = pixels; + } else { + relParts[count] = 0; + + int pixels = 0; + if (width != null && !width.equals("")) { + pixels = convertLength(width); + } + + absTotal += pixels; + absParts[count] = pixels; + } + } + + // Ok, now we have the relative widths and absolute widths in + // two parallel arrays. + // + // - If there are no relative widths, output the absolute widths + // - If there are no absolute widths, output the relative widths + // - If there are a mixture of relative and absolute widths, + // - If the table width is absolute, turn these all into absolute + // widths. + // - If the table width is relative, turn these all into absolute + // widths in the nominalWidth and then turn them back into + // percentages. + + if (relTotal == 0) { + for (int count = 0; count < numColumns; count++) { + Float f = new Float(absParts[count]); + if (foStylesheet) { + int pixels = f.intValue(); + float inches = (float) pixels / pixelsPerInch; + widths[count] = inches + "in"; + } else { + widths[count] = Integer.toString(f.intValue()); + } + } + } else if (absTotal == 0) { + for (int count = 0; count < numColumns; count++) { + float rel = relParts[count] / relTotal * 100; + Float f = new Float(rel); + widths[count] = Integer.toString(f.intValue()); + } + widths = correctRoundingError(widths); + } else { + int pixelWidth = nominalWidth; + + if (tableWidth.indexOf("%") <= 0) { + pixelWidth = convertLength(tableWidth); + } + + if (pixelWidth <= absTotal) { + System.out.println("Table is wider than table width."); + } else { + pixelWidth -= absTotal; + } + + absTotal = 0; + for (int count = 0; count < numColumns; count++) { + float rel = relParts[count] / relTotal * pixelWidth; + relParts[count] = rel + absParts[count]; + absTotal += rel + absParts[count]; + } + + if (tableWidth.indexOf("%") <= 0) { + for (int count = 0; count < numColumns; count++) { + Float f = new Float(relParts[count]); + if (foStylesheet) { + int pixels = f.intValue(); + float inches = (float) pixels / pixelsPerInch; + widths[count] = inches + "in"; + } else { + widths[count] = Integer.toString(f.intValue()); + } + } + } else { + for (int count = 0; count < numColumns; count++) { + float rel = relParts[count] / absTotal * 100; + Float f = new Float(rel); + widths[count] = Integer.toString(f.intValue()); + } + widths = correctRoundingError(widths); + } + } + + ColumnUpdateEmitter cuEmitter = new ColumnUpdateEmitter(controller, + namePool, + widths); + + rtf.replay(cuEmitter); + return cuEmitter.getResultTreeFragment(); + } catch (TransformerException e) { + // This "can't" happen. + System.out.println("Transformer Exception in adjustColumnWidths"); + return rtf; + } + } + + /** + * Correct rounding errors introduced in calculating the width of each + * column. Make sure they sum to 100% in the end. + */ + protected static String[] correctRoundingError(String widths[]) { + int totalWidth = 0; + + for (int count = 0; count < widths.length; count++) { + try { + int width = Integer.parseInt(widths[count]); + totalWidth += width; + } catch (NumberFormatException nfe) { + // nop; "can't happen" + } + } + + float totalError = 100 - totalWidth; + float columnError = totalError / widths.length; + float error = 0; + + for (int count = 0; count < widths.length; count++) { + try { + int width = Integer.parseInt(widths[count]); + error = error + columnError; + if (error >= 1.0) { + int adj = (int) Math.round(Math.floor(error)); + error = error - (float) Math.floor(error); + width = width + adj; + widths[count] = Integer.toString(width) + "%"; + } else { + widths[count] = Integer.toString(width) + "%"; + } + } catch (NumberFormatException nfe) { + // nop; "can't happen" + } + } + + return widths; + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Text.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Text.java new file mode 100644 index 0000000000..6c2a91d479 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Text.java @@ -0,0 +1,203 @@ +// Text - Saxon extension element for inserting text + +package com.nwalsh.saxon; + +import java.io.BufferedReader; +import java.io.InputStreamReader; +import java.io.InputStream; +import java.io.IOException; +import java.io.FileNotFoundException; +import java.net.URL; +import java.net.MalformedURLException; + +import javax.xml.transform.TransformerException; +import javax.xml.transform.TransformerConfigurationException; +import javax.xml.transform.URIResolver; +import javax.xml.transform.Source; + +import com.icl.saxon.Context; +import com.icl.saxon.style.StyleElement; +import com.icl.saxon.output.Outputter; +import com.icl.saxon.expr.Expression; + +import org.xml.sax.AttributeList; + +/** + *

                  Saxon extension element for inserting text + * + *

                  $Id: Text.java,v 1.5 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Saxon + * extension element for inserting text into a result tree.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: Text.java,v 1.5 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class Text extends StyleElement { + /** + *

                  Constructor for Text

                  + * + *

                  Does nothing.

                  + */ + public Text() { + } + + /** + *

                  Is this element an instruction?

                  + * + *

                  Yes, it is.

                  + * + * @return true + */ + public boolean isInstruction() { + return true; + } + + /** + *

                  Can this element contain a template-body?

                  + * + *

                  Yes, it can, but only so that it can contain xsl:fallback.

                  + * + * @return true + */ + public boolean mayContainTemplateBody() { + return true; + } + + /** + *

                  Validate the arguments

                  + * + *

                  The element must have an href attribute.

                  + */ + public void prepareAttributes() throws TransformerConfigurationException { + // Get mandatory href attribute + String fnAtt = getAttribute("href"); + if (fnAtt == null) { + reportAbsence("href"); + } + } + + /** Validate that the element occurs in a reasonable place. */ + public void validate() throws TransformerConfigurationException { + checkWithinTemplate(); + } + + /** + *

                  Insert the text of the file into the result tree

                  + * + *

                  Processing this element inserts the contents of the URL named + * by the href attribute into the result tree as plain text.

                  + * + *

                  Optional encoding attribute can specify encoding of resource. + * If not specified default system encoding is used.

                  + * + */ + public void process( Context context ) throws TransformerException { + Outputter out = context.getOutputter(); + + String hrefAtt = getAttribute("href"); + Expression hrefExpr = makeAttributeValueTemplate(hrefAtt); + String href = hrefExpr.evaluateAsString(context); + + String encodingAtt = getAttribute("encoding"); + Expression encodingExpr = makeAttributeValueTemplate(encodingAtt); + String encoding = encodingExpr.evaluateAsString(context); + + String baseURI = context.getContextNodeInfo().getBaseURI(); + + URIResolver resolver = context.getController().getURIResolver(); + + if (resolver != null) { + Source source = resolver.resolve(href, baseURI); + href = source.getSystemId(); + } + + URL baseURL = null; + URL fileURL = null; + + try { + baseURL = new URL(baseURI); + } catch (MalformedURLException e0) { + // what the!? + baseURL = null; + } + + try { + try { + fileURL = new URL(baseURL, href); + } catch (MalformedURLException e1) { + try { + fileURL = new URL(baseURL, "file:" + href); + } catch (MalformedURLException e2) { + System.out.println("Cannot open " + href); + return; + } + } + + InputStreamReader isr = null; + if (encoding.equals("") == true) + isr = new InputStreamReader(fileURL.openStream()); + else + isr = new InputStreamReader(fileURL.openStream(), encoding); + + BufferedReader is = new BufferedReader(isr); + + final int BUFFER_SIZE = 4096; + char chars[] = new char[BUFFER_SIZE]; + char nchars[] = new char[BUFFER_SIZE]; + int len = 0; + int i = 0; + int carry = -1; + + while ((len = is.read(chars)) > 0) { + // various new lines are normalized to LF to prevent blank lines + // between lines + + int nlen = 0; + for (i=0; i LF to normalize MAC line endings + nchars[nlen] = '\n'; + nlen++; + continue; + } else { + // if CR is last char of buffer we must look ahead + carry = is.read(); + nchars[nlen] = '\n'; + nlen++; + if (carry == '\n') { + carry = -1; + } + break; + } + } + nchars[nlen] = chars[i]; + nlen++; + } + out.writeContent(nchars, 0, nlen); + // handle look aheaded character + if (carry != -1) out.writeContent(String.valueOf((char)carry)); + carry = -1; + } + is.close(); + } catch (Exception e) { + System.out.println("Cannot read " + href); + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/TextFactory.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/TextFactory.java new file mode 100644 index 0000000000..17d87eb1bc --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/TextFactory.java @@ -0,0 +1,67 @@ +// TextFactory - Saxon extension element factory + +package com.nwalsh.saxon; + +import com.icl.saxon.style.ExtensionElementFactory; +import org.xml.sax.SAXException; + +/** + *

                  Saxon extension element factory + * + *

                  $Id: TextFactory.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Saxon + * extension element factory for the Text extension element + * family.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: TextFactory.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $ + * + * @see Text + * + */ +public class TextFactory implements ExtensionElementFactory { + /** + *

                  Constructor for TextFactory

                  + * + *

                  Does nothing.

                  + */ + public TextFactory() { + } + + /** + *

                  Return the class that implements a particular extension element.

                  + * + * @param localname The local name of the extension element. + * + * @return The class that handles that extension element. + * + * @exception SAXException("Unknown Text extension element") + */ + public Class getExtensionClass(String localname) { + if (localname.equals("insertfile")) { + try { + return Class.forName("com.nwalsh.saxon.Text"); + } catch (ClassNotFoundException e) { + return null; + } + } + return null; + } +} + + + + + diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/UnwrapLinks.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/UnwrapLinks.java new file mode 100644 index 0000000000..def73fb4ae --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/UnwrapLinks.java @@ -0,0 +1,132 @@ +// UnwrapLinks.java - Saxon extension for unwrapping nested links + +package com.nwalsh.saxon; + +import java.util.Stack; +import java.util.StringTokenizer; +import org.xml.sax.*; +import org.w3c.dom.*; +import javax.xml.transform.TransformerException; +import com.icl.saxon.Controller; +import com.icl.saxon.expr.*; +import com.icl.saxon.om.*; +import com.icl.saxon.pattern.*; +import com.icl.saxon.Context; +import com.icl.saxon.tree.*; +import com.icl.saxon.functions.Extensions; +import com.nwalsh.saxon.UnwrapLinksEmitter; + +/** + *

                  Saxon extension for unwrapping nested links

                  + * + *

                  $Id: UnwrapLinks.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000, 2002 Norman Walsh.

                  + * + *

                  This class provides a + * Saxon 6.* + * implementation of a link unwrapper.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: UnwrapLinks.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class UnwrapLinks { + /** True if the stylesheet is producing formatting objects */ + private static boolean foStylesheet = false; + + /** + *

                  Constructor for UnwrapLinks

                  + * + *

                  All of the methods are static, so the constructor does nothing.

                  + */ + public UnwrapLinks() { + } + + /** + *

                  Find the string value of a stylesheet variable or parameter

                  + * + *

                  Returns the string value of varName in the current + * context. Returns the empty string if the variable is + * not defined.

                  + * + * @param context The current stylesheet context + * @param varName The name of the variable (without the dollar sign) + * + * @return The string value of the variable + */ + protected static String getVariable(Context context, String varName) { + Value variable = null; + String varString = null; + + try { + variable = Extensions.evaluate(context, "$" + varName); + varString = variable.asString(); + return varString; + } catch (TransformerException te) { + System.out.println("Undefined variable: " + varName); + return ""; + } catch (IllegalArgumentException iae) { + System.out.println("Undefined variable: " + varName); + return ""; + } + } + + /** + *

                  Setup the parameters associated with unwrapping links

                  + * + * @param context The current stylesheet context + * + */ + private static void setupUnwrapLinks(Context context) { + // Get the stylesheet type + String varString = getVariable(context, "stylesheet.result.type"); + foStylesheet = (varString.equals("fo")); + } + + /** + *

                  Unwrap links

                  + * + * @param context The current stylesheet context. + * @param rtf_ns The result tree fragment of the verbatim environment. + * + * @return The modified result tree fragment. + */ + public static NodeSetValue unwrapLinks (Context context, + NodeSetValue rtf_ns) { + + FragmentValue rtf = (FragmentValue) rtf_ns; + boolean tryAgain = true; + + setupUnwrapLinks(context); + + try { + Controller controller = context.getController(); + NamePool namePool = controller.getNamePool(); + + while (tryAgain) { + UnwrapLinksEmitter ulEmitter = new UnwrapLinksEmitter(controller, + namePool, + foStylesheet); + rtf.replay(ulEmitter); + tryAgain = ulEmitter.tryAgain(); + rtf = (FragmentValue) ulEmitter.getResultTreeFragment(); + } + + return rtf; + + } catch (TransformerException e) { + // This "can't" happen. + System.out.println("Transformer Exception in unwrapLinks"); + return rtf; + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/UnwrapLinksEmitter.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/UnwrapLinksEmitter.java new file mode 100644 index 0000000000..ea08239ba3 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/UnwrapLinksEmitter.java @@ -0,0 +1,233 @@ +package com.nwalsh.saxon; + +import java.util.Stack; +import org.xml.sax.*; +import org.w3c.dom.*; +import javax.xml.transform.TransformerException; +import com.icl.saxon.output.*; +import com.icl.saxon.om.*; +import com.icl.saxon.Controller; +import com.icl.saxon.tree.AttributeCollection; + +/** + *

                  Saxon extension to unwrap links in a result tree fragment.

                  + * + *

                  $Id: UnwrapLinksEmitter.java,v 1.1 2002/06/26 11:02:05 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2002 Norman Walsh.

                  + * + *

                  This class provides the guts of a + * Saxon 6.* + * implementation of a link unwrapper.

                  + * + *

                  The general design is this: the stylesheets construct a result tree + * fragment for some environment. Then the result tree fragment + * is "replayed" through the UnwrapLinksEmitter; the UnwrapLinksEmitter + * builds a + * new result tree fragment from this event stream with top-level links unwrapped. + * That RTF is returned. Note that only a single level of unwrapping + * is performed. This is clearly a crude implementation. + *

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: UnwrapLinksEmitter.java,v 1.1 2002/06/26 11:02:05 nwalsh Exp $ + * + */ +public class UnwrapLinksEmitter extends CopyEmitter { + /** A stack for the preserving information about open elements. */ + protected Stack elementStack = null; + protected Stack saveStack = null; + + /** The FO namespace name. */ + protected static String foURI = "http://www.w3.org/1999/XSL/Format"; + + /** The XHTML namespace name. */ + protected static String xhURI = "http://www.w3.org/1999/xhtml"; + + /** Is the stylesheet currently running an FO stylesheet? */ + protected boolean foStylesheet = false; + + /** Are we currently in a link? How deep? */ + protected int linkDepth = 0; + protected int skipDepth = 0; + + protected int htmlAFingerprint = 0; + protected int xhtmlAFingerprint = 0; + protected boolean inSkip = false; + protected boolean tryAgain = false; + + + /**

                  Constructor for the UnwrapLinksEmitter.

                  + * + * @param namePool The name pool to use for constructing elements and attributes. + * @param foStylesheet Is this an FO stylesheet? + */ + public UnwrapLinksEmitter(Controller controller, + NamePool namePool, + boolean foStylesheet) { + super(controller,namePool); + elementStack = new Stack(); + this.foStylesheet = foStylesheet; + + htmlAFingerprint = namePool.getFingerprint("", "a"); + xhtmlAFingerprint = namePool.getFingerprint(xhURI, "a"); + } + + /** Process start element events. */ + public void startElement(int nameCode, + org.xml.sax.Attributes attributes, + int[] namespaces, + int nscount) + throws TransformerException { + + int thisFingerprint = namePool.getFingerprint(nameCode); + boolean isLink = (thisFingerprint == htmlAFingerprint + || thisFingerprint == xhtmlAFingerprint); + + if (isLink) { + linkDepth++; + tryAgain = tryAgain || inSkip; + } + + if (isLink && linkDepth > 1 && !inSkip) { + inSkip = true; + + // Close all the open elements + saveStack = new Stack(); + Stack tempStack = new Stack(); + while (!elementStack.empty()) { + StartElementInfo elem = (StartElementInfo) elementStack.pop(); + rtfEmitter.endElement(elem.getNameCode()); + saveStack.push(elem); + tempStack.push(elem); + } + + while (!tempStack.empty()) { + StartElementInfo elem = (StartElementInfo) tempStack.pop(); + elementStack.push(elem); + } + } + + if (inSkip) { + skipDepth++; + } else { + } + + rtfEmitter.startElement(nameCode,attributes,namespaces,nscount); + + StartElementInfo sei = new StartElementInfo(nameCode, attributes, + namespaces, nscount); + elementStack.push(sei); + } + + /** Process end element events. */ + public void endElement(int nameCode) throws TransformerException { + int thisFingerprint = namePool.getFingerprint(nameCode); + boolean isLink = (thisFingerprint == htmlAFingerprint + || thisFingerprint == xhtmlAFingerprint); + + rtfEmitter.endElement(nameCode); + elementStack.pop(); + + if (isLink) { + linkDepth--; + } + + if (inSkip) { + skipDepth--; + inSkip = (skipDepth > 0); + if (!inSkip) { + // Reopen all the ones we closed before... + while (!saveStack.empty()) { + StartElementInfo elem = (StartElementInfo) saveStack.pop(); + + AttributeCollection attr = (AttributeCollection)elem.getAttributes(); + AttributeCollection newAttr = new AttributeCollection(namePool); + + for (int acount = 0; acount < attr.getLength(); acount++) { + String localName = attr.getLocalName(acount); + String type = attr.getType(acount); + String value = attr.getValue(acount); + String uri = attr.getURI(acount); + String prefix = ""; + + if (localName.indexOf(':') > 0) { + prefix = localName.substring(0, localName.indexOf(':')); + localName = localName.substring(localName.indexOf(':')+1); + } + + if (uri.equals("") + && ((foStylesheet + && localName.equals("id")) + || (!foStylesheet + && (localName.equals("id") + || localName.equals("name"))))) { + // skip this attribute + } else { + newAttr.addAttribute(prefix, uri, localName, type, value); + } + } + + rtfEmitter.startElement(elem.getNameCode(), + newAttr, + elem.getNamespaces(), + elem.getNSCount()); + } + } + } + } + + public boolean tryAgain() + throws TransformerException { + return tryAgain; + } + + /** + *

                  A private class for maintaining the information required to call + * the startElement method.

                  + * + *

                  In order to close and reopen elements, information about those + * elements has to be maintained. This class is just the little record + * that we push on the stack to keep track of that info.

                  + */ + private class StartElementInfo { + private int _nameCode; + org.xml.sax.Attributes _attributes; + int[] _namespaces; + int _nscount; + + public StartElementInfo(int nameCode, + org.xml.sax.Attributes attributes, + int[] namespaces, + int nscount) { + _nameCode = nameCode; + _attributes = attributes; + _namespaces = namespaces; + _nscount = nscount; + } + + public int getNameCode() { + return _nameCode; + } + + public org.xml.sax.Attributes getAttributes() { + return _attributes; + } + + public int[] getNamespaces() { + return _namespaces; + } + + public int getNSCount() { + return _nscount; + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Verbatim.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Verbatim.java new file mode 100644 index 0000000000..8e275461fc --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Verbatim.java @@ -0,0 +1,491 @@ +// Verbatim.java - Saxon extensions supporting DocBook verbatim environments + +package com.nwalsh.saxon; + +import java.util.Stack; +import java.util.StringTokenizer; +import org.xml.sax.*; +import org.w3c.dom.*; +import javax.xml.transform.TransformerException; +import com.icl.saxon.Controller; +import com.icl.saxon.expr.*; +import com.icl.saxon.om.*; +import com.icl.saxon.pattern.*; +import com.icl.saxon.Context; +import com.icl.saxon.tree.*; +import com.icl.saxon.functions.Extensions; +import com.nwalsh.saxon.NumberLinesEmitter; +import com.nwalsh.saxon.CalloutEmitter; + +/** + *

                  Saxon extensions supporting DocBook verbatim environments

                  + * + *

                  $Id: Verbatim.java,v 1.4 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Saxon + * implementation of two features that would be impractical to + * implement directly in XSLT: line numbering and callouts.

                  + * + *

                  Line Numbering

                  + *

                  The numberLines method takes a result tree + * fragment (assumed to contain the contents of a formatted verbatim + * element in DocBook: programlisting, screen, address, literallayout, + * or synopsis) and returns a result tree fragment decorated with + * line numbers.

                  + * + *

                  Callouts

                  + *

                  The insertCallouts method takes an + * areaspec and a result tree fragment + * (assumed to contain the contents of a formatted verbatim + * element in DocBook: programlisting, screen, address, literallayout, + * or synopsis) and returns a result tree fragment decorated with + * callouts.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: Verbatim.java,v 1.4 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class Verbatim { + /** True if the stylesheet is producing formatting objects */ + private static boolean foStylesheet = false; + /** The modulus for line numbering (every 'modulus' line is numbered). */ + private static int modulus = 0; + /** The width (in characters) of line numbers (for padding). */ + private static int width = 0; + /** The starting line number. */ + private static int startinglinenumber = 1; + /** The separator between the line number and the verbatim text. */ + private static String separator = ""; + + /** True if callouts have been setup */ + private static boolean calloutsSetup = false; + /** The default column for callouts that have only a line or line range */ + private static int defaultColumn = 60; + /** The path to use for graphical callout decorations. */ + private static String graphicsPath = null; + /** The extension to use for graphical callout decorations. */ + private static String graphicsExt = null; + /** The largest callout number that can be represented graphically. */ + private static int graphicsMax = 10; + + /** The FormatCallout object to use for formatting callouts. */ + private static FormatCallout fCallout = null; + + /** + *

                  Constructor for Verbatim

                  + * + *

                  All of the methods are static, so the constructor does nothing.

                  + */ + public Verbatim() { + } + + /** + *

                  Find the string value of a stylesheet variable or parameter

                  + * + *

                  Returns the string value of varName in the current + * context. Returns the empty string if the variable is + * not defined.

                  + * + * @param context The current stylesheet context + * @param varName The name of the variable (without the dollar sign) + * + * @return The string value of the variable + */ + protected static String getVariable(Context context, String varName) { + Value variable = null; + String varString = null; + + try { + variable = Extensions.evaluate(context, "$" + varName); + varString = variable.asString(); + return varString; + } catch (TransformerException te) { + System.out.println("Undefined variable: " + varName); + return ""; + } catch (IllegalArgumentException iae) { + System.out.println("Undefined variable: " + varName); + return ""; + } + } + + /** + *

                  Setup the parameters associated with line numbering

                  + * + *

                  This method queries the stylesheet for the variables + * associated with line numbering. It is called automatically before + * lines are numbered. The context is used to retrieve the values, + * this allows templates to redefine these variables.

                  + * + *

                  The following variables are queried. If the variables do not + * exist, builtin defaults will be used (but you may also get a bunch + * of messages from the Java interpreter).

                  + * + *
                  + *
                  linenumbering.everyNth
                  + *
                  Specifies the lines that will be numbered. The first line is + * always numbered. (builtin default: 5).
                  + *
                  linenumbering.width
                  + *
                  Specifies the width of the numbers. If the specified width is too + * narrow for the largest number needed, it will automatically be made + * wider. (builtin default: 3).
                  + *
                  linenumbering.separator
                  + *
                  Specifies the string that separates line numbers from lines + * in the program listing. (builtin default: " ").
                  + *
                  linenumbering.startinglinenumber
                  + *
                  Specifies the initial line number + * in the program listing. (builtin default: "1").
                  + *
                  stylesheet.result.type
                  + *
                  Specifies the stylesheet result type. The value is either 'fo' + * (for XSL Formatting Objects) or it isn't. (builtin default: html).
                  + *
                  + * + * @param context The current stylesheet context + * + */ + private static void setupLineNumbering(Context context) { + // Hardcoded defaults + modulus = 5; + width = 3; + startinglinenumber = 1; + separator = " "; + foStylesheet = false; + + String varString = null; + + // Get the modulus + varString = getVariable(context, "linenumbering.everyNth"); + try { + modulus = Integer.parseInt(varString); + } catch (NumberFormatException nfe) { + System.out.println("$linenumbering.everyNth is not a number: " + varString); + } + + // Get the width + varString = getVariable(context, "linenumbering.width"); + try { + width = Integer.parseInt(varString); + } catch (NumberFormatException nfe) { + System.out.println("$linenumbering.width is not a number: " + varString); + } + + // Get the startinglinenumber + varString = getVariable(context, "linenumbering.startinglinenumber"); + try { + startinglinenumber = Integer.parseInt(varString); + } catch (NumberFormatException nfe) { + System.out.println("$linenumbering.startinglinenumber is not a number: " + varString); + } + + // Get the separator + varString = getVariable(context, "linenumbering.separator"); + separator = varString; + + // Get the stylesheet type + varString = getVariable(context, "stylesheet.result.type"); + foStylesheet = (varString.equals("fo")); + } + + /** + *

                  Number lines in a verbatim environment

                  + * + *

                  The extension function expects the following variables to be + * available in the calling context: $linenumbering.everyNth, + * $linenumbering.width, $linenumbering.separator, and + * $stylesheet.result.type.

                  + * + *

                  This method adds line numbers to a result tree fragment. Each + * newline that occurs in a text node is assumed to start a new line. + * The first line is always numbered, every subsequent 'everyNth' line + * is numbered (so if everyNth=5, lines 1, 5, 10, 15, etc. will be + * numbered. If there are fewer than everyNth lines in the environment, + * every line is numbered.

                  + * + *

                  Every line number will be right justified in a string 'width' + * characters long. If the line number of the last line in the + * environment is too long to fit in the specified width, the width + * is automatically increased to the smallest value that can hold the + * number of the last line. (In other words, if you specify the value 2 + * and attempt to enumerate the lines of an environment that is 100 lines + * long, the value 3 will automatically be used for every line in the + * environment.)

                  + * + *

                  The 'separator' string is inserted between the line + * number and the original program listing. Lines that aren't numbered + * are preceded by a 'width' blank string and the separator.

                  + * + *

                  If inline markup extends across line breaks, markup changes are + * required. All the open elements are closed before the line break and + * "reopened" afterwards. The reopened elements will have the same + * attributes as the originals, except that 'name' and 'id' attributes + * are not duplicated if the stylesheet.result.type is "html" and + * 'id' attributes will not be duplicated if the result type is "fo".

                  + * + * @param context The current stylesheet context. + * @param rtf_ns The result tree fragment of the verbatim environment. + * + * @return The modified result tree fragment. + */ + public static NodeSetValue numberLines (Context context, + NodeSetValue rtf_ns) { + + FragmentValue rtf = (FragmentValue) rtf_ns; + + setupLineNumbering(context); + + try { + LineCountEmitter lcEmitter = new LineCountEmitter(); + rtf.replay(lcEmitter); + int numLines = lcEmitter.lineCount(); + + int listingModulus = numLines < modulus ? 1 : modulus; + + double log10numLines = Math.log(numLines) / Math.log(10); + + int listingWidth = width < log10numLines+1 + ? (int) Math.floor(log10numLines + 1) + : width; + + Controller controller = context.getController(); + NamePool namePool = controller.getNamePool(); + NumberLinesEmitter nlEmitter = new NumberLinesEmitter(controller, + namePool, + startinglinenumber, + listingModulus, + listingWidth, + separator, + foStylesheet); + rtf.replay(nlEmitter); + return nlEmitter.getResultTreeFragment(); + } catch (TransformerException e) { + // This "can't" happen. + System.out.println("Transformer Exception in numberLines"); + return rtf; + } + } + + /** + *

                  Setup the parameters associated with callouts

                  + * + *

                  This method queries the stylesheet for the variables + * associated with line numbering. It is called automatically before + * callouts are processed. The context is used to retrieve the values, + * this allows templates to redefine these variables.

                  + * + *

                  The following variables are queried. If the variables do not + * exist, builtin defaults will be used (but you may also get a bunch + * of messages from the Java interpreter).

                  + * + *
                  + *
                  callout.graphics
                  + *
                  Are we using callout graphics? A value of 0 or "" is false, + * any other value is true. If callout graphics are not used, the + * parameters related to graphis are not queried.
                  + *
                  callout.graphics.path
                  + *
                  Specifies the path to callout graphics.
                  + *
                  callout.graphics.extension
                  + *
                  Specifies the extension ot use for callout graphics.
                  + *
                  callout.graphics.number.limit
                  + *
                  Identifies the largest number that can be represented as a + * graphic. Larger callout numbers will be represented using text.
                  + *
                  callout.defaultcolumn
                  + *
                  Specifies the default column for callout bullets that do not + * specify a column.
                  + *
                  stylesheet.result.type
                  + *
                  Specifies the stylesheet result type. The value is either 'fo' + * (for XSL Formatting Objects) or it isn't. (builtin default: html).
                  + *
                  + * + * @param context The current stylesheet context + * + */ + private static void setupCallouts(Context context) { + NamePool namePool = context.getController().getNamePool(); + + boolean useGraphics = false; + boolean useUnicode = false; + + int unicodeStart = 49; + int unicodeMax = 0; + + String unicodeFont = ""; + + // Hardcoded defaults + defaultColumn = 60; + graphicsPath = null; + graphicsExt = null; + graphicsMax = 0; + foStylesheet = false; + calloutsSetup = true; + + Value variable = null; + String varString = null; + + // Get the stylesheet type + varString = getVariable(context, "stylesheet.result.type"); + foStylesheet = (varString.equals("fo")); + + // Get the default column + varString = getVariable(context, "callout.defaultcolumn"); + try { + defaultColumn = Integer.parseInt(varString); + } catch (NumberFormatException nfe) { + System.out.println("$callout.defaultcolumn is not a number: " + + varString); + } + + // Use graphics at all? + varString = getVariable(context, "callout.graphics"); + useGraphics = !(varString.equals("0") || varString.equals("")); + + // Use unicode at all? + varString = getVariable(context, "callout.unicode"); + useUnicode = !(varString.equals("0") || varString.equals("")); + + if (useGraphics) { + // Get the graphics path + varString = getVariable(context, "callout.graphics.path"); + graphicsPath = varString; + + // Get the graphics extension + varString = getVariable(context, "callout.graphics.extension"); + graphicsExt = varString; + + // Get the number limit + varString = getVariable(context, "callout.graphics.number.limit"); + try { + graphicsMax = Integer.parseInt(varString); + } catch (NumberFormatException nfe) { + System.out.println("$callout.graphics.number.limit is not a number: " + + varString); + graphicsMax = 0; + } + + fCallout = new FormatGraphicCallout(namePool, + graphicsPath, + graphicsExt, + graphicsMax, + foStylesheet); + } else if (useUnicode) { + // Get the starting character + varString = getVariable(context, "callout.unicode.start.character"); + try { + unicodeStart = Integer.parseInt(varString); + } catch (NumberFormatException nfe) { + System.out.println("$callout.unicode.start.character is not a number: " + + varString); + unicodeStart = 48; + } + + // Get the number limit + varString = getVariable(context, "callout.unicode.number.limit"); + try { + unicodeMax = Integer.parseInt(varString); + } catch (NumberFormatException nfe) { + System.out.println("$callout.unicode.number.limit is not a number: " + + varString); + unicodeStart = 0; + } + + // Get the font + unicodeFont = getVariable(context, "callout.unicode.font"); + if (unicodeFont == null) { + unicodeFont = ""; + } + + fCallout = new FormatUnicodeCallout(namePool, + unicodeFont, + unicodeStart, + unicodeMax, + foStylesheet); + } else { + fCallout = new FormatTextCallout(namePool, foStylesheet); + } + } + + /** + *

                  Insert text callouts into a verbatim environment.

                  + * + *

                  This method examines the areaset and area elements + * in the supplied areaspec and decorates the supplied + * result tree fragment with appropriate callout markers.

                  + * + *

                  If a label attribute is supplied on an area, + * its content will be used for the label, otherwise the callout + * number will be used, surrounded by parenthesis. Callout numbers may + * also be represented as graphics. Callouts are + * numbered in document order. All of the areas in an + * areaset get the same number.

                  + * + *

                  Only the linecolumn and linerange units are + * supported. If no unit is specifed, linecolumn is assumed. + * If only a line is specified, the callout decoration appears in + * the defaultColumn. Lines will be padded with blanks to reach the + * necessary column, but callouts that are located beyond the last + * line of the verbatim environment will be ignored.

                  + * + *

                  Callouts are inserted before the character at the line/column + * where they are to occur.

                  + * + *

                  If graphical callouts are used, and the callout number is less + * than or equal to the $callout.graphics.number.limit, the following image + * will be generated for HTML: + * + * 

                  +   * <img src="$callout.graphics.path/999$callout.graphics.ext"
+   *         alt="conumber">
+   *
                  + * + * If the $stylesheet.result.type is 'fo', the following image will + * be generated: + * + * 
                  +   * <fo:external-graphic src="$callout.graphics.path/999$callout.graphics.ext"/>
+   *
                  + * + *

                  If the callout number exceeds $callout.graphics.number.limit, + * the callout will be the callout number surrounded by + * parenthesis.

                  + * + * @param context The stylesheet context. + * @param areaspecNodeList The source node set that contains the areaspec. + * @param rtf_ns The result tree fragment of the verbatim environment. + * + * @return The modified result tree fragment. + */ + public static NodeSetValue insertCallouts (Context context, + NodeList areaspecNodeList, + NodeSetValue rtf_ns) { + + FragmentValue rtf = (FragmentValue) rtf_ns; + + setupCallouts(context); + + try { + Controller controller = context.getController(); + NamePool namePool = controller.getNamePool(); + CalloutEmitter cEmitter = new CalloutEmitter(controller, + namePool, + defaultColumn, + foStylesheet, + fCallout); + cEmitter.setupCallouts(areaspecNodeList); + rtf.replay(cEmitter); + return cEmitter.getResultTreeFragment(); + } catch (TransformerException e) { + // This "can't" happen. + System.out.println("Transformer Exception in insertCallouts"); + return rtf; + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Windows1252.java b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Windows1252.java new file mode 100644 index 0000000000..a8df5148b0 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/Windows1252.java @@ -0,0 +1,110 @@ +/* This file was kindly provided by Sectra AB, Sweden to DocBook community */ +package com.nwalsh.saxon; + +import com.icl.saxon.charcode.PluggableCharacterSet; + +/** + * + * $Id: Windows1252.java,v 1.3 2004/12/06 04:24:20 xmldoc Exp $ + * + * File: Windows1252CharacterSet.java + * Created: May 26 2004 + * Author: Pontus Haglund + * Project: Venus + * + * This class extends Saxon 6.5.x with the windows-1252 character set. + * + * It is particularly useful when generating HTML Help for + * Western European Languages. + * + * To use this class for generating HTML Help output with the + * DocBook XSL stylesheets, complete the following steps; + * + * 1. Make sure that the Saxon 6.5.x jar file and the jar file for + * the DocBook XSL Java extensions are in your CLASSPATH + * + * 2. Create a DocBook XSL customization layer -- a file named + * "mystylesheet.xsl" or whatever -- that, at a minimum, + * contains the following: + * + * + * + * + * + * + * + * + * + * 3. Invoke Saxon with the "encoding.windows-1252" Java system + * property set to "com.nwalsh.saxon.Windows1252"; for example: + * + * java \ + * -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ + * com.icl.saxon.StyleSheet \ + * mydoc.xml mystylesheet.xsl + * + * Or, for a more complete "real world" case showing other + * options you'll typically want to use: + * + * java \ + * -Dencoding.windows-1252=com.nwalsh.saxon.Windows1252 \ + * -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \ + * -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl \ + * -Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl \ + * com.icl.saxon.StyleSheet \ + * -x org.apache.xml.resolver.tools.ResolvingXMLReader \ + * -y org.apache.xml.resolver.tools.ResolvingXMLReader \ + * -r org.apache.xml.resolver.tools.CatalogResolver \ + * mydoc.xml mystylesheet.xsl + * + * In both cases, the "mystylesheet.xsl" file should be a DocBook + * customization layer containing the parameters show in step 2. + * + */ + + + +public class Windows1252 implements PluggableCharacterSet { + + public final boolean inCharset(int c) { + + return (c >= 0x00 && c <= 0x7F) || + (c >= 0xA0 && c <= 0xFF) || + (c == 0x20AC) || + (c == 0x201A) || + (c == 0x0192) || + (c == 0x201E) || + (c == 0x2026) || + (c == 0x2020) || + (c == 0x2021) || + (c == 0x02C6) || + (c == 0x2030) || + (c == 0x0160) || + (c == 0x2039) || + (c == 0x0152) || + (c == 0x017D) || + (c == 0x2018) || + (c == 0x2019) || + (c == 0x201C) || + (c == 0x201D) || + (c == 0x2022) || + (c == 0x2013) || + (c == 0x2014) || + (c == 0x02DC) || + (c == 0x2122) || + (c == 0x0161) || + (c == 0x203A) || + (c == 0x0153) || + (c == 0x017E) || + (c == 0x0178); + + + } + + public String getEncodingName() { + return "WINDOWS-1252"; + } + +} diff --git a/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/package.html b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/package.html new file mode 100644 index 0000000000..b05a46709b --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/saxon643/com/nwalsh/saxon/package.html @@ -0,0 +1,48 @@ + + +Norman Walsh's Saxon Extensions Package + + +

                  Norman Walsh's Saxon Extensions Package for Saxon 6.*

                  + +

                  This package implements Saxon extensions for XSLT.

                  + +

                  Copyright (C) 2000 Norman Walsh

                  +

                  Permission is hereby granted, free of charge, to any person +obtaining a copy of this software and associated documentation +files (the "Software"), to deal in the Software without +restriction, including without limitation the rights to use, copy, +modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions:

                  + +

                  The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software.

                  + +

                  Except as contained in this notice, the names of individuals +credited with contribution to this software shall not be used in +advertising or otherwise to promote the sale, use or other dealings +in this Software without prior written authorization from the +individuals in question.

                  + +

                  Anything derived from this Software that is publically +distributed will be identified with a different name and the +version strings in any derived Software will be changed so that no +possibility of confusion between the derived package and this +Software will exist.

                  + + +
                  +

                  Warranty

                  +

                  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER +CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +DEALINGS IN THE SOFTWARE.

                  +
                  + + + diff --git a/src/documentation/docbook-xsl/extensions/saxon644.jar b/src/documentation/docbook-xsl/extensions/saxon644.jar new file mode 100644 index 0000000000..1ef6c88f3b Binary files /dev/null and b/src/documentation/docbook-xsl/extensions/saxon644.jar differ diff --git a/src/documentation/docbook-xsl/extensions/saxon65.jar b/src/documentation/docbook-xsl/extensions/saxon65.jar new file mode 100644 index 0000000000..1ef6c88f3b Binary files /dev/null and b/src/documentation/docbook-xsl/extensions/saxon65.jar differ diff --git a/src/documentation/docbook-xsl/extensions/saxon651.jar b/src/documentation/docbook-xsl/extensions/saxon651.jar new file mode 100644 index 0000000000..1ef6c88f3b Binary files /dev/null and b/src/documentation/docbook-xsl/extensions/saxon651.jar differ diff --git a/src/documentation/docbook-xsl/extensions/saxon652.jar b/src/documentation/docbook-xsl/extensions/saxon652.jar new file mode 100644 index 0000000000..1ef6c88f3b Binary files /dev/null and b/src/documentation/docbook-xsl/extensions/saxon652.jar differ diff --git a/src/documentation/docbook-xsl/extensions/saxon653.jar b/src/documentation/docbook-xsl/extensions/saxon653.jar new file mode 100644 index 0000000000..1ef6c88f3b Binary files /dev/null and b/src/documentation/docbook-xsl/extensions/saxon653.jar differ diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/CVS.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/CVS.java new file mode 100644 index 0000000000..c09094979d --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/CVS.java @@ -0,0 +1,90 @@ +package com.nwalsh.xalan; + +import java.io.*; +import java.util.Calendar; +import java.util.GregorianCalendar; +import java.util.Date; +import java.util.Locale; +import java.util.TimeZone; +import java.text.DateFormat; +import java.text.ParseException; + +/** + *

                  Xalan extension to convert CVS date strings into local time

                  + * + *

                  $Id: CVS.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Xalan + * extension to turn the CVS date strings, which are UTC:

                  + * + * 
                  $Date: 2000/11/09 02:34:20 $
                  + * + *

                  into legibly formatted local time:

                  + * + * 
                  Wed Nov 08 18:34:20 PST 2000
                  + * + *

                  (I happened to be in California when I wrote this documentation.)

                  + + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: CVS.java,v 1.2 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class CVS { + /** + *

                  Constructor for CVS

                  + * + *

                  All of the methods are static, so the constructor does nothing.

                  + */ + public CVS() { + } + + /** + *

                  Convert a CVS date string into local time.

                  + * + * @param cvsDate The CVS date string. + * + * @return The date, converted to local time and reformatted. + */ + public String localTime (String cvsDate) { + // A cvsDate has the following form "$Date: 2006/04/27 08:26:47 $" + if (!cvsDate.startsWith("$Date: ")) { + return cvsDate; + } + + String yrS = cvsDate.substring(7,11); + String moS = cvsDate.substring(12,14); + String daS = cvsDate.substring(15,17); + String hrS = cvsDate.substring(18,20); + String miS = cvsDate.substring(21,23); + String seS = cvsDate.substring(24,26); + + TimeZone tz = TimeZone.getTimeZone("GMT+0"); + GregorianCalendar gmtCal = new GregorianCalendar(tz); + + try { + gmtCal.set(Integer.parseInt(yrS), + Integer.parseInt(moS)-1, + Integer.parseInt(daS), + Integer.parseInt(hrS), + Integer.parseInt(miS), + Integer.parseInt(seS)); + } catch (NumberFormatException e) { + // nop + } + + Date d = gmtCal.getTime(); + + return d.toString(); + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Callout.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Callout.java new file mode 100644 index 0000000000..4242510250 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Callout.java @@ -0,0 +1,143 @@ +package com.nwalsh.xalan; + +import org.w3c.dom.*; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: Callout.java,v 1.1 2001/04/02 13:03:45 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class is just for book keeping in the Verbatim class. + * It stores information about the location of callouts.

                  + * + *

                  Only line/column based callouts are supported. This class + * implements the Comparable interface so that callouts can be sorted. + * Callouts are sorted so that they occur in left-to-right, + * top-to-bottom order based on line/column.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: Callout.java,v 1.1 2001/04/02 13:03:45 nwalsh Exp $ + * */ +public class Callout implements Comparable { + /** The callout number. */ + private int callout = 0; + /** The area Element item that generated this callout. */ + private Element area = null; + /** The line on which this callout occurs. */ + private int line = 0; + /** The column in which this callout appears. */ + private int col = 0; + /** The type of callout. */ + private int type = 0; + /** The other type of callout. */ + private String otherType = null; + + public static final int CALS_PAIR = 1; + public static final int LINE_COLUMN = 2; + public static final int LINE_COLUMN_PAIR = 3; + public static final int LINE_RANGE = 4; + public static final int OTHER = 5; + + /** The constructor; initialize the private data structures. */ + public Callout(int callout, Element area, int line, int col, int type) { + this.callout = callout; + this.area = area; + this.line = line; + this.col = col; + this.type = type; + this.otherType = null; + } + + /** The constructor; initialize the private data structures. */ + public Callout(int callout, Element area, int line, int col, String otherType) { + this.callout = callout; + this.area = area; + this.line = line; + this.col = col; + this.type = Callout.OTHER; + this.otherType = otherType; + } + + /** + *

                  The compareTo method compares this Callout with another.

                  + * + *

                  Given two Callouts, A and B, A < B if:

                  + * + *
                    + *
                  1. A.line < B.line, or
                    2. + *
                  2. A.line = B.line && A.col < B.col, or
                    3. + *
                  3. A.line = B.line && A.col = B.col && A.callout < B.callout
                    4. + *
                  4. Otherwise, they're equal.
                    5. + *
                  + */ + public int compareTo (Object o) { + Callout c = (Callout) o; + + if (line == c.getLine()) { + if (col > c.getColumn()) { + return 1; + } else if (col < c.getColumn()) { + return -1; + } else { + if (callout < c.getCallout()) { + return -1; + } else if (callout > c.getCallout()) { + return 1; + } else { + return 0; + } + } + } else { + if (line > c.getLine()) { + return 1; + } else { + return -1; + } + } + } + + /** Access the Callout's area. */ + public Element getArea() { + return area; + } + + /** Access the Callout's line. */ + public int getLine() { + return line; + } + + /** Access the Callout's column. */ + public int getColumn() { + return col; + } + + /** Access the Callout's callout number. */ + public int getCallout() { + return callout; + } + + /** Access the Callout's type. */ + public int getType() { + return type; + } + + /** Access the Callout's otherType. */ + public String getOtherType() { + return otherType; + } + + +} + diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatCallout.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatCallout.java new file mode 100644 index 0000000000..ef9134bc38 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatCallout.java @@ -0,0 +1,101 @@ +package com.nwalsh.xalan; + +import org.xml.sax.SAXException; +import org.xml.sax.helpers.AttributesImpl; +import org.w3c.dom.*; +import org.apache.xml.utils.DOMBuilder; +import com.nwalsh.xalan.Callout; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatCallout.java,v 1.4 2004/09/01 20:55:38 bobstayton Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatCallout.java,v 1.4 2004/09/01 20:55:38 bobstayton Exp $ + **/ + +public abstract class FormatCallout { + protected static final String foURI = "http://www.w3.org/1999/XSL/Format"; + protected static final String xhURI = "http://www.w3.org/1999/xhtml"; + protected boolean stylesheetFO = false; + + public FormatCallout() { + //nop; + } + + public String areaLabel(Element area) { + String label = null; + + if (area.getAttribute("label") != null) { + // If this area has a label, use it + label = area.getAttribute("label"); + } else { + // Otherwise, if its parent is an areaset and it has a label, use that + Element parent = (Element) area.getParentNode(); + if (parent != null + && parent.getNodeName().equals("areaset") + && parent.getAttribute("label") != null) { + label = parent.getAttribute("label"); + } + } + + return label; + } + + public void startSpan(DOMBuilder rtf) + throws SAXException { + // no point in doing this for FO, right? + if (!stylesheetFO) { + AttributesImpl spanAttr = new AttributesImpl(); + spanAttr.addAttribute("", "class", "class", "CDATA", "co"); + rtf.startElement("", "span", "span", spanAttr); + } + } + + public void endSpan(DOMBuilder rtf) + throws SAXException { + // no point in doing this for FO, right? + if (!stylesheetFO) { + rtf.endElement("", "span", "span"); + } + } + + public void formatTextCallout(DOMBuilder rtf, + Callout callout) { + Element area = callout.getArea(); + int num = callout.getCallout(); + String userLabel = areaLabel(area); + String label = "(" + num + ")"; + + if (userLabel != null) { + label = userLabel; + } + + char chars[] = label.toCharArray(); + + try { + startSpan(rtf); + rtf.characters(chars, 0, label.length()); + endSpan(rtf); + } catch (SAXException e) { + System.out.println("SAX Exception in text formatCallout"); + } + } + + public abstract void formatCallout(DOMBuilder rtf, + Callout callout); +} + diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatDingbatCallout.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatDingbatCallout.java new file mode 100644 index 0000000000..5b62e9108b --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatDingbatCallout.java @@ -0,0 +1,82 @@ +package com.nwalsh.xalan; + +import org.xml.sax.helpers.AttributesImpl; +import org.xml.sax.SAXException; +import org.w3c.dom.*; +import org.apache.xml.utils.DOMBuilder; +import com.nwalsh.xalan.Callout; +import org.apache.xml.utils.AttList; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatDingbatCallout.java,v 1.1 2001/07/07 22:11:12 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatDingbatCallout.java,v 1.1 2001/07/07 22:11:12 nwalsh Exp $ + **/ + +public class FormatDingbatCallout extends FormatCallout { + int graphicsMax = 0; + + public FormatDingbatCallout(int max, boolean fo) { + graphicsMax = max; + stylesheetFO = fo; + } + + public void formatCallout(DOMBuilder rtf, + Callout callout) { + Element area = callout.getArea(); + int num = callout.getCallout(); + String label = areaLabel(area); + + try { + if (label == null && num <= graphicsMax) { + AttributesImpl imgAttr = new AttributesImpl(); + String ns = ""; + String prefix = ""; + String imgName = ""; + + if (stylesheetFO) { + ns = foURI; + prefix = "fo:"; // FIXME: this could be a problem... + imgName = "inline"; + imgAttr.addAttribute("", "font-family", "font-family", "CDATA", + "ZapfDingbats"); + } else { + ns = ""; + prefix = ""; + imgName = "font"; + imgAttr.addAttribute("", "face", "face", "CDATA", + "ZapfDingbats"); + } + + startSpan(rtf); + rtf.startElement(ns, imgName, prefix+imgName, imgAttr); + + char chars[] = new char[1]; + chars[0] = (char) (0x2775 + num); + rtf.characters(chars, 0, 1); + + rtf.endElement(ns, imgName, prefix+imgName); + endSpan(rtf); + } else { + formatTextCallout(rtf, callout); + } + } catch (SAXException e) { + System.out.println("SAX Exception in graphics formatCallout"); + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatGraphicCallout.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatGraphicCallout.java new file mode 100644 index 0000000000..1160442740 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatGraphicCallout.java @@ -0,0 +1,83 @@ +package com.nwalsh.xalan; + +import org.xml.sax.helpers.AttributesImpl; +import org.xml.sax.SAXException; +import org.w3c.dom.*; +import org.apache.xml.utils.DOMBuilder; +import com.nwalsh.xalan.Callout; +import org.apache.xml.utils.AttList; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatGraphicCallout.java,v 1.1 2001/04/02 13:03:45 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatGraphicCallout.java,v 1.1 2001/04/02 13:03:45 nwalsh Exp $ + **/ + +public class FormatGraphicCallout extends FormatCallout { + String graphicsPath = ""; + String graphicsExt = ""; + int graphicsMax = 0; + + public FormatGraphicCallout(String path, String ext, int max, boolean fo) { + graphicsPath = path; + graphicsExt = ext; + graphicsMax = max; + stylesheetFO = fo; + } + + public void formatCallout(DOMBuilder rtf, + Callout callout) { + Element area = callout.getArea(); + int num = callout.getCallout(); + String label = areaLabel(area); + + try { + if (label == null && num <= graphicsMax) { + AttributesImpl imgAttr = new AttributesImpl(); + String ns = ""; + String prefix = ""; + String imgName = ""; + + if (stylesheetFO) { + ns = foURI; + prefix = "fo:"; // FIXME: this could be a problem... + imgName = "external-graphic"; + imgAttr.addAttribute("", "src", "src", "CDATA", + graphicsPath + num + graphicsExt); + imgAttr.addAttribute("", "alt", "alt", "CDATA", label); + } else { + ns = ""; + prefix = ""; + imgName = "img"; + imgAttr.addAttribute("", "src", "src", "CDATA", + graphicsPath + num + graphicsExt); + imgAttr.addAttribute("", "alt", "alt", "CDATA", label); + } + + startSpan(rtf); + rtf.startElement(ns, imgName, prefix+imgName, imgAttr); + rtf.endElement(ns, imgName, prefix+imgName); + endSpan(rtf); + } else { + formatTextCallout(rtf, callout); + } + } catch (SAXException e) { + System.out.println("SAX Exception in graphics formatCallout"); + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatTextCallout.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatTextCallout.java new file mode 100644 index 0000000000..3a517e3850 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatTextCallout.java @@ -0,0 +1,38 @@ +package com.nwalsh.xalan; + +import org.w3c.dom.*; +import org.apache.xml.utils.DOMBuilder; +import com.nwalsh.xalan.Callout; +import org.apache.xml.utils.AttList; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatTextCallout.java,v 1.1 2001/04/02 13:03:45 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatTextCallout.java,v 1.1 2001/04/02 13:03:45 nwalsh Exp $ + **/ + +public class FormatTextCallout extends FormatCallout { + public FormatTextCallout(boolean fo) { + stylesheetFO = fo; + } + + public void formatCallout(DOMBuilder rtf, + Callout callout) { + formatTextCallout(rtf, callout); + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatUnicodeCallout.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatUnicodeCallout.java new file mode 100644 index 0000000000..b57dfba9d2 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/FormatUnicodeCallout.java @@ -0,0 +1,87 @@ +package com.nwalsh.xalan; + +import org.xml.sax.helpers.AttributesImpl; +import org.xml.sax.SAXException; +import org.w3c.dom.*; +import org.apache.xml.utils.DOMBuilder; +import com.nwalsh.xalan.Callout; +import org.apache.xml.utils.AttList; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatUnicodeCallout.java,v 1.2 2003/12/17 01:01:34 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatUnicodeCallout.java,v 1.2 2003/12/17 01:01:34 nwalsh Exp $ + **/ + +public class FormatUnicodeCallout extends FormatCallout { + int unicodeMax = 0; + int unicodeStart = 0; + String unicodeFont = ""; + + public FormatUnicodeCallout(String font, int start, int max, boolean fo) { + unicodeFont = font; + unicodeMax = max; + unicodeStart = start; + stylesheetFO = fo; + } + + public void formatCallout(DOMBuilder rtf, + Callout callout) { + Element area = callout.getArea(); + int num = callout.getCallout(); + String label = areaLabel(area); + + try { + if (label == null && num <= unicodeMax) { + AttributesImpl inAttr = new AttributesImpl(); + String ns = ""; + String prefix = ""; + String inName = ""; + + if (!unicodeFont.equals("")) { + if (stylesheetFO) { + ns = foURI; + prefix = "fo:"; + inName = "inline"; + inAttr.addAttribute("", "", "font-family", "CDATA", unicodeFont); + } else { + inName = "font"; + inAttr.addAttribute("", "", "face", "CDATA", unicodeFont); + } + } + + char chars[] = new char[1]; + chars[0] = (char) (unicodeStart + num - 1); + + startSpan(rtf); + if (!unicodeFont.equals("")) { + rtf.startElement(ns, inName, prefix+inName, inAttr); + } + rtf.characters(chars, 0, 1); + if (!unicodeFont.equals("")) { + rtf.endElement(ns, inName, prefix+inName); + } + endSpan(rtf); + } else { + formatTextCallout(rtf, callout); + } + } catch (SAXException e) { + System.out.println("SAX Exception in unicode formatCallout"); + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Func.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Func.java new file mode 100644 index 0000000000..e03ae6bd27 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Func.java @@ -0,0 +1,59 @@ +// Func - Xalann extension function test + +package com.nwalsh.xalan; + +import org.xml.sax.SAXException; +import org.xml.sax.AttributeList; +import org.xml.sax.ContentHandler; + +import org.w3c.dom.*; +import org.w3c.dom.traversal.NodeIterator; +import org.apache.xerces.dom.*; + +import org.apache.xpath.objects.XObject; +import org.apache.xpath.objects.XRTreeFrag; +import org.apache.xpath.XPath; +import org.apache.xpath.NodeSet; +import org.apache.xalan.extensions.XSLProcessorContext; +import org.apache.xalan.extensions.ExpressionContext; +import org.apache.xalan.transformer.TransformerImpl; +import org.apache.xalan.templates.StylesheetRoot; +import org.apache.xalan.templates.ElemExtensionCall; +import org.apache.xalan.templates.OutputProperties; +import org.apache.xalan.res.XSLTErrorResources; + +import javax.xml.transform.stream.StreamResult; +import javax.xml.transform.TransformerException; + +public class Func { + public Func() { + } + + public DocumentFragment doSomething(NodeIterator rtf) { + System.out.println("Got here 2: " + rtf); + + DocumentFragment df = (DocumentFragment) rtf.nextNode(); + Element node = (Element) df.getFirstChild(); + + System.out.println("node=" + node); + System.out.println("namesp uri: " + node.getNamespaceURI()); + System.out.println("local name: " + node.getLocalName()); + + return df; + } + + public DocumentFragment doSomething(DocumentFragment rtf) { + System.out.println("Got here: " + rtf); + + return rtf; + /* + Element node = (Element) rtf.getFirstChild(); + + System.out.println("node=" + node); + System.out.println("namesp uri: " + node.getNamespaceURI()); + System.out.println("local name: " + node.getLocalName()); + + return rtf; + */ + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/ImageIntrinsics.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/ImageIntrinsics.java new file mode 100644 index 0000000000..3ad6414750 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/ImageIntrinsics.java @@ -0,0 +1,160 @@ +package com.nwalsh.xalan; + +import java.io.*; +import java.awt.*; +import java.awt.image.*; +import java.lang.Thread; +import java.util.StringTokenizer; + +import org.apache.xalan.extensions.ExpressionContext; + +/** + *

                  Xalan extension to examine intrinsic size of images

                  + * + *

                  $Id: ImageIntrinsics.java,v 1.3 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2002 Norman Walsh.

                  + * + *

                  This class provides a + * Xalan + * extension to find the intrinsic size of images.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: ImageIntrinsics.java,v 1.3 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class ImageIntrinsics implements ImageObserver { + boolean imageLoaded = false; + boolean imageFailed = false; + Image image = null; + int width = -1; + int depth = -1; + + /** + *

                  Constructor for ImageIntrinsics

                  + */ + public ImageIntrinsics(ExpressionContext context, String imageFn) { + System.setProperty("java.awt.headless","true"); + image = Toolkit.getDefaultToolkit().getImage (imageFn); + width = image.getWidth(this); + + while (!imageFailed && (width == -1 || depth == -1)) { + try { + java.lang.Thread.currentThread().sleep(50); + } catch (Exception e) { + // nop; + } + width = image.getWidth(this); + depth = image.getHeight(this); + } + + if (imageFailed) { + // Maybe it's an EPS or PDF? + // FIXME: this code is crude + BufferedReader ir = null; + String line = null; + int lineLimit = 100; + + try { + ir = new BufferedReader(new FileReader(new File(imageFn))); + line = ir.readLine(); + + if (line != null && line.startsWith("%PDF-")) { + // We've got a PDF! + while (lineLimit > 0 && line != null) { + lineLimit--; + if (line.startsWith("/CropBox [")) { + line = line.substring(10); + if (line.indexOf("]") >= 0) { + line = line.substring(0, line.indexOf("]")); + } + parseBox(line); + lineLimit = 0; + } + line = ir.readLine(); + } + } else if (line != null && line.startsWith("%!") && line.indexOf(" EPSF-") > 0) { + // We've got an EPS! + while (lineLimit > 0 && line != null) { + lineLimit--; + if (line.startsWith("%%BoundingBox: ")) { + line = line.substring(15); + parseBox(line); + lineLimit = 0; + } + line = ir.readLine(); + } + } + } catch (Exception e) { + // nop; + } + + if (ir != null) { + try { + ir.close(); + } catch (Exception e) { + // nop; + } + } + } + } + + public int getWidth(ExpressionContext context, int defaultWidth) { + if (width >= 0) { + return width; + } else { + return defaultWidth; + } + } + + public int getDepth(ExpressionContext context, int defaultDepth) { + if (depth >= 0) { + return depth; + } else { + return defaultDepth; + } + } + + private void parseBox(String line) { + int [] corners = new int [4]; + int count = 0; + + StringTokenizer st = new StringTokenizer(line); + while (count < 4 && st.hasMoreTokens()) { + try { + corners[count++] = Integer.parseInt(st.nextToken()); + } catch (Exception e) { + // nop; + } + } + + width = corners[2] - corners[0]; + depth = corners[3] - corners[1]; + } + + public boolean imageUpdate(Image img, int infoflags, + int x, int y, int width, int height) { + if ((infoflags & ImageObserver.ERROR) == ImageObserver.ERROR) { + imageFailed = true; + return false; + } + + // I really only care about the width and height, but if I return false as + // soon as those are available, the BufferedInputStream behind the loader + // gets closed too early. + int flags = ImageObserver.ALLBITS; + if ((infoflags & flags) == flags) { + return false; + } else { + return true; + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Params.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Params.java new file mode 100644 index 0000000000..20261261dc --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Params.java @@ -0,0 +1,58 @@ +// Params.java - Read stylesheet parameters in Xalan + +package com.nwalsh.xalan; + +import org.apache.xpath.objects.XObject; +import org.apache.xpath.XPathContext; +import org.apache.xalan.extensions.ExpressionContext; +import org.apache.xml.utils.QName; + +import javax.xml.transform.TransformerException; + +public class Params { + + public static String getString(ExpressionContext context, + String varName) { + try { + XObject var = context.getVariableOrParam(new QName(varName)); + if (var != null) { + return var.toString(); + } else { + System.out.println("$" + varName + " is not a defined parameter."); + return ""; + } + } catch (TransformerException te) { + // Nevermind the warning + // System.out.println("Transformer exception getting value of $" + varName); + return ""; + } + } + + public static int getInt(ExpressionContext context, + String varName) { + String stringValue = getString(context, varName); + if (stringValue != null) { + try { + int value = Integer.parseInt(stringValue); + return value; + } catch (NumberFormatException e) { + System.out.println("$" + varName + " is not an integer."); + } + } + return 0; + } + + public static boolean getBoolean(ExpressionContext context, + String varName) { + String stringValue = getString(context, varName); + if (stringValue != null) { + if (stringValue.equals("0") || stringValue.equals("")) { + return false; + } else { + return true; + } + } else { + return false; + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Table.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Table.java new file mode 100644 index 0000000000..0c68896089 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Table.java @@ -0,0 +1,531 @@ +// Verbatim.java - Xalan extensions supporting DocBook verbatim environments + +package com.nwalsh.xalan; + +import java.util.Hashtable; +import org.xml.sax.*; +import org.xml.sax.helpers.AttributesImpl; +import org.w3c.dom.*; +import org.w3c.dom.traversal.NodeIterator; + +import javax.xml.transform.TransformerException; + +import org.apache.xpath.objects.XObject; +import org.apache.xpath.XPathContext; +import org.apache.xalan.extensions.ExpressionContext; +import org.apache.xml.utils.DOMBuilder; +import javax.xml.parsers.DocumentBuilder; +import javax.xml.parsers.DocumentBuilderFactory; +import javax.xml.parsers.ParserConfigurationException; +import org.apache.xml.utils.QName; +import org.apache.xpath.DOMHelper; +import org.apache.xml.utils.AttList; + +/** + *

                  Xalan extensions supporting Tables

                  + * + *

                  $Id: Table.java,v 1.6 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Xalan + * implementation of some code to adjust CALS Tables to HTML + * Tables.

                  + * + *

                  Column Widths

                  + *

                  The adjustColumnWidths method takes a result tree + * fragment (assumed to contain the colgroup of an HTML Table) + * and returns the result tree fragment with the column widths + * adjusted to HTML terms.

                  + * + *

                  Convert Lengths

                  + *

                  The convertLength method takes a length specification + * of the form 9999.99xx (where "xx" is a unit) and returns that length + * as an integral number of pixels. For convenience, percentage lengths + * are returned unchanged.

                  + *

                  The recognized units are: inches (in), centimeters (cm), + * millimeters (mm), picas (pc, 1pc=12pt), points (pt), and pixels (px). + * A number with no units is assumed to be pixels.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: Table.java,v 1.6 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class Table { + /** The number of pixels per inch */ + private static int pixelsPerInch = 96; + + /** The hash used to associate units with a length in pixels. */ + protected static Hashtable unitHash = null; + + /** The FO namespace name. */ + protected static String foURI = "http://www.w3.org/1999/XSL/Format"; + + /** + *

                  Constructor for Verbatim

                  + * + *

                  All of the methods are static, so the constructor does nothing.

                  + */ + public Table() { + } + + /** Initialize the internal hash table with proper values. */ + protected static void initializeHash() { + unitHash = new Hashtable(); + unitHash.put("in", new Float(pixelsPerInch)); + unitHash.put("cm", new Float(pixelsPerInch / 2.54)); + unitHash.put("mm", new Float(pixelsPerInch / 25.4)); + unitHash.put("pc", new Float((pixelsPerInch / 72) * 12)); + unitHash.put("pt", new Float(pixelsPerInch / 72)); + unitHash.put("px", new Float(1)); + } + + /** Set the pixels-per-inch value. Only positive values are legal. */ + public static void setPixelsPerInch(int value) { + if (value > 0) { + pixelsPerInch = value; + initializeHash(); + } + } + + /** Return the current pixels-per-inch value. */ + public int getPixelsPerInch() { + return pixelsPerInch; + } + + /** + *

                  Convert a length specification to a number of pixels.

                  + * + *

                  The specified length should be of the form [+/-]999.99xx, + * where xx is a valid unit.

                  + */ + public static int convertLength(String length) { + // The format of length should be 999.999xx + int sign = 1; + String digits = ""; + String units = ""; + char lench[] = length.toCharArray(); + float flength = 0; + boolean done = false; + int pos = 0; + float factor = 1; + int pixels = 0; + + if (unitHash == null) { + initializeHash(); + } + + if (lench[pos] == '+' || lench[pos] == '-') { + if (lench[pos] == '-') { + sign = -1; + } + pos++; + } + + while (!done) { + if (pos >= lench.length) { + done = true; + } else { + if ((lench[pos] > '9' || lench[pos] < '0') && lench[pos] != '.') { + done = true; + units = length.substring(pos); + } else { + digits += lench[pos++]; + } + } + } + + try { + flength = Float.parseFloat(digits); + } catch (NumberFormatException e) { + System.out.println(digits + " is not a number; 1 used instead."); + flength = 1; + } + + Float f = null; + + if (!units.equals("")) { + f = (Float) unitHash.get(units); + if (f == null) { + System.out.println(units + " is not a known unit; 1 used instead."); + factor = 1; + } else { + factor = f.floatValue(); + } + } else { + factor = 1; + } + + f = new Float(flength * factor); + + pixels = f.intValue() * sign; + + return pixels; + } + + /** + *

                  Adjust column widths in an HTML table.

                  + * + *

                  The specification of column widths in CALS (a relative width + * plus an optional absolute width) are incompatible with HTML column + * widths. This method adjusts CALS column width specifiers in an + * attempt to produce equivalent HTML specifiers.

                  + * + *

                  In order for this method to work, the CALS width specifications + * should be placed in the "width" attribute of the <col>s within + * a <colgroup>. Then the colgroup result tree fragment is passed + * to this method.

                  + * + *

                  This method makes use of two parameters from the XSL stylesheet + * that calls it: nominal.table.width and + * table.width. The value of nominal.table.width + * must be an absolute distance. The value of table.width + * can be either absolute or relative.

                  + * + *

                  Presented with a mixture of relative and + * absolute lengths, the table width is used to calculate + * appropriate values. If the table.width is relative, + * the nominal width is used for this calculation.

                  + * + *

                  There are three possible combinations of values:

                  + * + *
                    + *
                  1. There are no relative widths; in this case the absolute widths + * are used in the HTML table.
                    2. + *
                  2. There are no absolute widths; in this case the relative widths + * are used in the HTML table.
                    3. + *
                  3. There are a mixture of absolute and relative widths: + *
                      + *
                    1. If the table width is absolute, all widths become absolute.
                      2. + *
                    2. If the table width is relative, make all the widths absolute + * relative to the nominal table width then turn them all + * back into relative widths.
                      3. + *
                    + *
                    4. + *
                  + * + * @param context The stylesheet context; supplied automatically by Xalan + * @param xalanNI + * + * @return The result tree fragment containing the adjusted colgroup. + * + */ + + public DocumentFragment adjustColumnWidths (ExpressionContext context, + NodeIterator xalanNI) { + + int nominalWidth = convertLength(Params.getString(context, + "nominal.table.width")); + String tableWidth = Params.getString(context, "table.width"); + String styleType = Params.getString(context, "stylesheet.result.type"); + boolean foStylesheet = styleType.equals("fo"); + + DocumentFragment xalanRTF = (DocumentFragment) xalanNI.nextNode(); + Element colgroup = (Element) xalanRTF.getFirstChild(); + + // N.B. ...stree.ElementImpl doesn't implement getElementsByTagName() + + Node firstCol = null; + // If this is an FO tree, there might be no colgroup... + if (colgroup.getLocalName().equals("colgroup")) { + firstCol = colgroup.getFirstChild(); + } else { + firstCol = colgroup; + } + + // Count the number of columns... + Node child = firstCol; + int numColumns = 0; + while (child != null) { + if (child.getNodeType() == Node.ELEMENT_NODE + && (child.getNodeName().equals("col") + || (child.getNamespaceURI().equals(foURI) + && child.getLocalName().equals("table-column")))) { + numColumns++; + } + + child = child.getNextSibling(); + } + + String widths[] = new String[numColumns]; + Element columns[] = new Element[numColumns]; + int colnum = 0; + + child = firstCol; + while (child != null) { + if (child.getNodeType() == Node.ELEMENT_NODE + && (child.getNodeName().equals("col") + || (child.getNamespaceURI().equals(foURI) + && child.getLocalName().equals("table-column")))) { + Element col = (Element) child; + + columns[colnum] = col; + + if (foStylesheet) { + if (col.getAttribute("column-width") == null) { + widths[colnum] = "1*"; + } else { + widths[colnum] = col.getAttribute("column-width"); + } + } else { + if (col.getAttribute("width") == null) { + widths[colnum] = "1*"; + } else { + widths[colnum] = col.getAttribute("width"); + } + } + + colnum++; + } + child = child.getNextSibling(); + } + + float relTotal = 0; + float relParts[] = new float[numColumns]; + + float absTotal = 0; + float absParts[] = new float[numColumns]; + + for (int count = 0; count < numColumns; count++) { + String width = widths[count]; + int pos = width.indexOf("*"); + if (pos >= 0) { + String relPart = width.substring(0, pos); + String absPart = width.substring(pos+1); + + try { + float rel = Float.parseFloat(relPart); + relTotal += rel; + relParts[count] = rel; + } catch (NumberFormatException e) { + System.out.println(relPart + " is not a valid relative unit."); + } + + int pixels = 0; + if (absPart != null && !absPart.equals("")) { + pixels = convertLength(absPart); + } + + absTotal += pixels; + absParts[count] = pixels; + } else { + relParts[count] = 0; + + int pixels = 0; + if (width != null && !width.equals("")) { + pixels = convertLength(width); + } + + absTotal += pixels; + absParts[count] = pixels; + } + } + + // Ok, now we have the relative widths and absolute widths in + // two parallel arrays. + // + // - If there are no relative widths, output the absolute widths + // - If there are no absolute widths, output the relative widths + // - If there are a mixture of relative and absolute widths, + // - If the table width is absolute, turn these all into absolute + // widths. + // - If the table width is relative, turn these all into absolute + // widths in the nominalWidth and then turn them back into + // percentages. + + if (relTotal == 0) { + for (int count = 0; count < numColumns; count++) { + Float f = new Float(absParts[count]); + if (foStylesheet) { + int pixels = f.intValue(); + float inches = (float) pixels / pixelsPerInch; + widths[count] = inches + "in"; + } else { + widths[count] = Integer.toString(f.intValue()); + } + } + } else if (absTotal == 0) { + for (int count = 0; count < numColumns; count++) { + float rel = relParts[count] / relTotal * 100; + Float f = new Float(rel); + widths[count] = Integer.toString(f.intValue()); + } + widths = correctRoundingError(widths); + } else { + int pixelWidth = nominalWidth; + + if (tableWidth.indexOf("%") <= 0) { + pixelWidth = convertLength(tableWidth); + } + + if (pixelWidth <= absTotal) { + System.out.println("Table is wider than table width."); + } else { + pixelWidth -= absTotal; + } + + absTotal = 0; + for (int count = 0; count < numColumns; count++) { + float rel = relParts[count] / relTotal * pixelWidth; + relParts[count] = rel + absParts[count]; + absTotal += rel + absParts[count]; + } + + if (tableWidth.indexOf("%") <= 0) { + for (int count = 0; count < numColumns; count++) { + Float f = new Float(relParts[count]); + if (foStylesheet) { + int pixels = f.intValue(); + float inches = (float) pixels / pixelsPerInch; + widths[count] = inches + "in"; + } else { + widths[count] = Integer.toString(f.intValue()); + } + } + } else { + for (int count = 0; count < numColumns; count++) { + float rel = relParts[count] / absTotal * 100; + Float f = new Float(rel); + widths[count] = Integer.toString(f.intValue()); + } + widths = correctRoundingError(widths); + } + } + + // Now rebuild the colgroup with the right widths + + DocumentBuilderFactory docFactory = DocumentBuilderFactory.newInstance(); + DocumentBuilder docBuilder = null; + + try { + docBuilder = docFactory.newDocumentBuilder(); + } catch (ParserConfigurationException e) { + System.out.println("PCE!"); + return xalanRTF; + } + Document doc = docBuilder.newDocument(); + DocumentFragment df = doc.createDocumentFragment(); + DOMBuilder rtf = new DOMBuilder(doc, df); + + try { + String ns = colgroup.getNamespaceURI(); + String localName = colgroup.getLocalName(); + String name = colgroup.getTagName(); + + if (colgroup.getLocalName().equals("colgroup")) { + rtf.startElement(ns, localName, name, + copyAttributes(colgroup)); + } + + for (colnum = 0; colnum < numColumns; colnum++) { + Element col = columns[colnum]; + + NamedNodeMap domAttr = col.getAttributes(); + + AttributesImpl attr = new AttributesImpl(); + for (int acount = 0; acount < domAttr.getLength(); acount++) { + Node a = domAttr.item(acount); + String a_ns = a.getNamespaceURI(); + String a_localName = a.getLocalName(); + + if ((foStylesheet && !a_localName.equals("column-width")) + || !a_localName.equalsIgnoreCase("width")) { + attr.addAttribute(a.getNamespaceURI(), + a.getLocalName(), + a.getNodeName(), + "CDATA", + a.getNodeValue()); + } + } + + if (foStylesheet) { + attr.addAttribute("", "column-width", "column-width", "CDATA", widths[colnum]); + } else { + attr.addAttribute("", "width", "width", "CDATA", widths[colnum]); + } + + rtf.startElement(col.getNamespaceURI(), + col.getLocalName(), + col.getTagName(), + attr); + rtf.endElement(col.getNamespaceURI(), + col.getLocalName(), + col.getTagName()); + } + + if (colgroup.getLocalName().equals("colgroup")) { + rtf.endElement(ns, localName, name); + } + } catch (SAXException se) { + System.out.println("SE!"); + return xalanRTF; + } + + return df; + } + + private Attributes copyAttributes(Element node) { + AttributesImpl attrs = new AttributesImpl(); + NamedNodeMap nnm = node.getAttributes(); + for (int count = 0; count < nnm.getLength(); count++) { + Attr attr = (Attr) nnm.item(count); + String name = attr.getName(); + if (name.startsWith("xmlns:") || name.equals("xmlns")) { + // Skip it; (don't ya just love it!!) + } else { + attrs.addAttribute(attr.getNamespaceURI(), attr.getName(), + attr.getName(), "CDATA", attr.getValue()); + } + } + return attrs; + } + + /** + * Correct rounding errors introduced in calculating the width of each + * column. Make sure they sum to 100% in the end. + */ + protected String[] correctRoundingError(String widths[]) { + int totalWidth = 0; + + for (int count = 0; count < widths.length; count++) { + try { + int width = Integer.parseInt(widths[count]); + totalWidth += width; + } catch (NumberFormatException nfe) { + // nop; "can't happen" + } + } + + float totalError = 100 - totalWidth; + float columnError = totalError / widths.length; + float error = 0; + + for (int count = 0; count < widths.length; count++) { + try { + int width = Integer.parseInt(widths[count]); + error = error + columnError; + if (error >= 1.0) { + int adj = (int) Math.round(Math.floor(error)); + error = error - (float) Math.floor(error); + width = width + adj; + widths[count] = Integer.toString(width) + "%"; + } else { + widths[count] = Integer.toString(width) + "%"; + } + } catch (NumberFormatException nfe) { + // nop; "can't happen" + } + } + + return widths; + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Text.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Text.java new file mode 100644 index 0000000000..c35adbc585 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Text.java @@ -0,0 +1,209 @@ +// Text - Xalan extension element for inserting text + +package com.nwalsh.xalan; + +import java.io.BufferedReader; +import java.io.InputStreamReader; +import java.io.InputStream; +import java.io.IOException; +import java.io.FileNotFoundException; +import java.net.URL; +import java.net.MalformedURLException; + +import org.xml.sax.SAXException; +import org.xml.sax.AttributeList; +import org.xml.sax.ContentHandler; + +import org.w3c.dom.*; +import org.apache.xerces.dom.*; + +import org.apache.xpath.objects.XObject; +import org.apache.xpath.XPath; +import org.apache.xpath.NodeSet; +import org.apache.xalan.extensions.XSLProcessorContext; +import org.apache.xalan.transformer.TransformerImpl; +import org.apache.xalan.templates.StylesheetRoot; +import org.apache.xalan.templates.ElemExtensionCall; +import org.apache.xalan.templates.OutputProperties; +import org.apache.xalan.res.XSLTErrorResources; + +import javax.xml.transform.stream.StreamResult; +import javax.xml.transform.TransformerException; +import javax.xml.transform.URIResolver; +import javax.xml.transform.Source; + +/** + *

                  Xalan extension element for inserting text + * + *

                  $Id: Text.java,v 1.3 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2001 Norman Walsh.

                  + * + *

                  This class provides a + * Xalan + * extension element for inserting text into a result tree.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: Text.java,v 1.3 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class Text { + /** + *

                  Constructor for Text

                  + * + *

                  Does nothing.

                  + */ + public Text() { + } + + public String insertfile(XSLProcessorContext context, + ElemExtensionCall elem) + throws MalformedURLException, + FileNotFoundException, + IOException, + TransformerException { + String href = getFilename(context, elem); + String encoding = getEncoding(context, elem); + + String baseURI = context.getTransformer().getBaseURLOfSource(); + URIResolver resolver = context.getTransformer().getURIResolver(); + + if (resolver != null) { + Source source = resolver.resolve(href, baseURI); + href = source.getSystemId(); + } + + URL baseURL = null; + URL fileURL = null; + + try { + baseURL = new URL(baseURI); + } catch (MalformedURLException e1) { + try { + baseURL = new URL("file:" + baseURI); + } catch (MalformedURLException e2) { + System.out.println("Cannot find base URI for " + baseURI); + baseURL = null; + } + } + + String text = ""; + + try { + try { + fileURL = new URL(baseURL, href); + } catch (MalformedURLException e1) { + try { + fileURL = new URL(baseURL, "file:" + href); + } catch (MalformedURLException e2) { + System.out.println("Cannot open " + href); + return ""; + } + } + + InputStreamReader isr = null; + if (encoding.equals("") == true) + isr = new InputStreamReader(fileURL.openStream()); + else + isr = new InputStreamReader(fileURL.openStream(), encoding); + + BufferedReader is = new BufferedReader(isr); + + final int BUFFER_SIZE = 4096; + char chars[] = new char[BUFFER_SIZE]; + char nchars[] = new char[BUFFER_SIZE]; + int len = 0; + int i = 0; + int carry = -1; + + while ((len = is.read(chars)) > 0) { + // various new lines are normalized to LF to prevent blank lines + // between lines + + int nlen = 0; + for (i=0; i LF to normalize MAC line endings + nchars[nlen] = '\n'; + nlen++; + continue; + } else { + // if CR is last char of buffer we must look ahead + carry = is.read(); + nchars[nlen] = '\n'; + nlen++; + if (carry == '\n') { + carry = -1; + } + break; + } + } + nchars[nlen] = chars[i]; + nlen++; + } + + text += String.valueOf(nchars, 0, nlen); + + // handle look aheaded character + if (carry != -1) text += String.valueOf((char)carry); + carry = -1; + } + is.close(); + } catch (Exception e) { + System.out.println("Cannot read " + href); + } + + return text; + } + + private String getFilename(XSLProcessorContext context, ElemExtensionCall elem) + throws java.net.MalformedURLException, + java.io.FileNotFoundException, + java.io.IOException, + javax.xml.transform.TransformerException { + + String fileName; + + fileName = ((ElemExtensionCall)elem).getAttribute ("href", + context.getContextNode(), + context.getTransformer()); + + if(fileName == null) { + context.getTransformer().getMsgMgr().error(elem, + "No 'href' on text, or not a filename"); + } + + return fileName; + } + + private String getEncoding(XSLProcessorContext context, ElemExtensionCall elem) + throws java.net.MalformedURLException, + java.io.FileNotFoundException, + java.io.IOException, + javax.xml.transform.TransformerException { + + String encoding; + + encoding = ((ElemExtensionCall)elem).getAttribute ("encoding", + context.getContextNode(), + context.getTransformer()); + + if (encoding == null) { + return ""; + } else { + return encoding; + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Verbatim.java b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Verbatim.java new file mode 100644 index 0000000000..c9b977e192 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/Verbatim.java @@ -0,0 +1,925 @@ +// Verbatim.java - Xalan extensions supporting DocBook verbatim environments + +package com.nwalsh.xalan; + +import java.util.Stack; +import java.util.StringTokenizer; + +import org.xml.sax.*; +import org.xml.sax.helpers.AttributesImpl; +import org.w3c.dom.*; +import org.w3c.dom.traversal.NodeIterator; +import org.apache.xerces.dom.*; + +import org.apache.xpath.objects.XObject; +import org.apache.xpath.XPath; +import org.apache.xpath.XPathContext; +import org.apache.xpath.NodeSet; +import org.apache.xpath.DOMHelper; +import org.apache.xalan.extensions.XSLProcessorContext; +import org.apache.xalan.extensions.ExpressionContext; +import org.apache.xalan.transformer.TransformerImpl; +import org.apache.xalan.templates.StylesheetRoot; +import org.apache.xalan.templates.ElemExtensionCall; +import org.apache.xalan.templates.OutputProperties; +import org.apache.xalan.res.XSLTErrorResources; +import org.apache.xml.utils.DOMBuilder; +import org.apache.xml.utils.AttList; +import org.apache.xml.utils.QName; + +import javax.xml.transform.stream.StreamResult; +import javax.xml.transform.TransformerException; +import javax.xml.parsers.DocumentBuilder; +import javax.xml.parsers.DocumentBuilderFactory; +import javax.xml.parsers.ParserConfigurationException; + +import com.nwalsh.xalan.Callout; +import com.nwalsh.xalan.Params; + +/** + *

                  Xalan extensions supporting DocBook verbatim environments

                  + * + *

                  $Id: Verbatim.java,v 1.6 2006/04/27 08:26:47 xmldoc Exp $

                  + * + *

                  Copyright (C) 2001 Norman Walsh.

                  + * + *

                  This class provides a + * Xalan + * implementation of two features that would be impractical to + * implement directly in XSLT: line numbering and callouts.

                  + * + *

                  Line Numbering

                  + *

                  The numberLines family of functions takes a result tree + * fragment (assumed to contain the contents of a formatted verbatim + * element in DocBook: programlisting, screen, address, literallayout, + * or synopsis) and returns a result tree fragment decorated with + * line numbers.

                  + * + *

                  Callouts

                  + *

                  The insertCallouts family of functions takes an + * areaspec and a result tree fragment + * (assumed to contain the contents of a formatted verbatim + * element in DocBook: programlisting, screen, address, literallayout, + * or synopsis) and returns a result tree fragment decorated with + * callouts.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: Verbatim.java,v 1.6 2006/04/27 08:26:47 xmldoc Exp $ + * + */ +public class Verbatim { + /** A stack to hold the open elements while walking through a RTF. */ + private Stack elementStack = null; + /** A stack to hold the temporarily closed elements. */ + private Stack tempStack = null; + /** The current line number. */ + private int lineNumber = 0; + /** The current column number. */ + private int colNumber = 0; + /** The modulus for line numbering (every 'modulus' line is numbered). */ + private int modulus = 0; + /** The width (in characters) of line numbers (for padding). */ + private int width = 0; + /** The separator between the line number and the verbatim text. */ + private String separator = ""; + /** The (sorted) array of callouts obtained from the areaspec. */ + private Callout callout[] = null; + /** The number of callouts in the callout array. */ + private int calloutCount = 0; + /** A pointer used to keep track of our position in the callout array. */ + private int calloutPos = 0; + /** The path to use for graphical callout decorations. */ + private String graphicsPath = null; + /** The extension to use for graphical callout decorations. */ + private String graphicsExt = null; + /** The largest callout number that can be represented graphically. */ + private int graphicsMax = 10; + /** Should graphic callouts use fo:external-graphics or imgs. */ + private boolean graphicsFO = false; + + private static final String foURI = "http://www.w3.org/1999/XSL/Format"; + private static final String xhURI = "http://www.w3.org/1999/xhtml"; + + /** + *

                  Constructor for Verbatim

                  + * + *

                  All of the methods are static, so the constructor does nothing.

                  + */ + public Verbatim() { + } + + /** + *

                  Number lines in a verbatim environment.

                  + * + *

                  This method adds line numbers to a result tree fragment. Each + * newline that occurs in a text node is assumed to start a new line. + * The first line is always numbered, every subsequent xalanMod line + * is numbered (so if xalanMod=5, lines 1, 5, 10, 15, etc. will be + * numbered. If there are fewer than xalanMod lines in the environment, + * every line is numbered.

                  + * + *

                  xalanMod is taken from the $linenumbering.everyNth parameter.

                  + * + *

                  Every line number will be right justified in a string xalanWidth + * characters long. If the line number of the last line in the + * environment is too long to fit in the specified width, the width + * is automatically increased to the smallest value that can hold the + * number of the last line. (In other words, if you specify the value 2 + * and attempt to enumerate the lines of an environment that is 100 lines + * long, the value 3 will automatically be used for every line in the + * environment.)

                  + * + *

                  xalanWidth is taken from the $linenumbering.width parameter.

                  + * + *

                  The xalanSep string is inserted between the line + * number and the original program listing. Lines that aren't numbered + * are preceded by a xalanWidth blank string and the separator.

                  + * + *

                  xalanSep is taken from the $linenumbering.separator parameter.

                  + * + *

                  If inline markup extends across line breaks, markup changes are + * required. All the open elements are closed before the line break and + * "reopened" afterwards. The reopened elements will have the same + * attributes as the originals, except that 'name' and 'id' attributes + * are not duplicated.

                  + * + * @param context + * @param xalanNI + * + * @return The modified result tree fragment. + */ + public DocumentFragment numberLines (ExpressionContext context, + NodeIterator xalanNI) { + + int xalanMod = Params.getInt(context, "linenumbering.everyNth"); + int xalanWidth = Params.getInt(context, "linenumbering.width"); + String xalanSep = Params.getString(context, "linenumbering.separator"); + + DocumentFragment xalanRTF = (DocumentFragment) xalanNI.nextNode(); + int numLines = countLineBreaks(xalanRTF) + 1; + + DocumentBuilderFactory docFactory = DocumentBuilderFactory.newInstance(); + DocumentBuilder docBuilder = null; + + try { + docBuilder = docFactory.newDocumentBuilder(); + } catch (ParserConfigurationException e) { + System.out.println("PCE!"); + return xalanRTF; + } + Document doc = docBuilder.newDocument(); + DocumentFragment df = doc.createDocumentFragment(); + DOMBuilder db = new DOMBuilder(doc, df); + + elementStack = new Stack(); + lineNumber = 0; + modulus = numLines < xalanMod ? 1 : xalanMod; + width = xalanWidth; + separator = xalanSep; + + double log10numLines = Math.log(numLines) / Math.log(10); + + if (width < log10numLines + 1) { + width = (int) Math.floor(log10numLines + 1); + } + + lineNumberFragment(db, xalanRTF); + return df; + } + + /** + *

                  Count the number of lines in a verbatim environment.

                  + * + *

                  This method walks over the nodes of a DocumentFragment and + * returns the number of lines breaks that it contains.

                  + * + * @param node The root of the tree walk over. + */ + private int countLineBreaks(Node node) { + int numLines = 0; + + if (node.getNodeType() == Node.DOCUMENT_FRAGMENT_NODE + || node.getNodeType() == Node.DOCUMENT_NODE + || node.getNodeType() == Node.ELEMENT_NODE) { + Node child = node.getFirstChild(); + while (child != null) { + numLines += countLineBreaks(child); + child = child.getNextSibling(); + } + } else if (node.getNodeType() == Node.TEXT_NODE) { + String text = node.getNodeValue(); + + // Walk through the text node looking for newlines + int pos = 0; + for (int count = 0; count < text.length(); count++) { + if (text.charAt(count) == '\n') { + numLines++; + } + } + } else { + // nop + } + + return numLines; + } + + /** + *

                  Build a DocumentFragment with numbered lines.

                  + * + *

                  This is the method that actually does the work of numbering + * lines in a verbatim environment. It recursively walks through a + * tree of nodes, copying the structure into the rtf. Text nodes + * are examined for new lines and modified as requested by the + * global line numbering parameters.

                  + * + *

                  When called, rtf should be an empty DocumentFragment and node + * should be the first child of the result tree fragment that contains + * the existing, formatted verbatim text.

                  + * + * @param rtf The resulting verbatim environment with numbered lines. + * @param node The root of the tree to copy. + */ + private void lineNumberFragment(DOMBuilder rtf, + Node node) { + try { + if (node.getNodeType() == Node.DOCUMENT_FRAGMENT_NODE + || node.getNodeType() == Node.DOCUMENT_NODE) { + Node child = node.getFirstChild(); + while (child != null) { + lineNumberFragment(rtf, child); + child = child.getNextSibling(); + } + } else if (node.getNodeType() == Node.ELEMENT_NODE) { + String ns = node.getNamespaceURI(); + String localName = node.getLocalName(); + String name = ((Element) node).getTagName(); + + rtf.startElement(ns, localName, name, + copyAttributes((Element) node)); + + elementStack.push(node); + + Node child = node.getFirstChild(); + while (child != null) { + lineNumberFragment(rtf, child); + child = child.getNextSibling(); + } + } else if (node.getNodeType() == Node.TEXT_NODE) { + String text = node.getNodeValue(); + + if (lineNumber == 0) { + // The first line is always numbered + formatLineNumber(rtf, ++lineNumber); + } + + // Walk through the text node looking for newlines + char chars[] = text.toCharArray(); + int pos = 0; + for (int count = 0; count < text.length(); count++) { + if (text.charAt(count) == '\n') { + // This is the tricky bit; if we find a newline, make sure + // it doesn't occur inside any markup. + + if (pos > 0) { + rtf.characters(chars, 0, pos); + pos = 0; + } + + closeOpenElements(rtf); + + // Copy the newline to the output + chars[pos++] = text.charAt(count); + rtf.characters(chars, 0, pos); + pos = 0; + + // Add the line number + formatLineNumber(rtf, ++lineNumber); + + openClosedElements(rtf); + } else { + chars[pos++] = text.charAt(count); + } + } + + if (pos > 0) { + rtf.characters(chars, 0, pos); + } + } else if (node.getNodeType() == Node.COMMENT_NODE) { + String text = node.getNodeValue(); + char chars[] = text.toCharArray(); + rtf.comment(chars, 0, text.length()); + } else if (node.getNodeType() == Node.PROCESSING_INSTRUCTION_NODE) { + rtf.processingInstruction(node.getNodeName(), node.getNodeValue()); + } else { + System.out.println("Warning: unexpected node type in lineNumberFragment"); + } + + if (node.getNodeType() == Node.ELEMENT_NODE) { + String ns = node.getNamespaceURI(); + String localName = node.getLocalName(); + String name = ((Element) node).getTagName(); + rtf.endElement(ns, localName, name); + elementStack.pop(); + } + } catch (SAXException e) { + System.out.println("SAX Exception in lineNumberFragment"); + } + } + + /** + *

                  Add a formatted line number to the result tree fragment.

                  + * + *

                  This method examines the global parameters that control line + * number presentation (modulus, width, and separator) and adds + * the appropriate text to the result tree fragment.

                  + * + * @param rtf The resulting verbatim environment with numbered lines. + * @param lineNumber The number of the current line. + */ + private void formatLineNumber(DOMBuilder rtf, + int lineNumber) { + char ch = 160; + String lno = ""; + if (lineNumber == 1 + || (modulus >= 1 && (lineNumber % modulus == 0))) { + lno = "" + lineNumber; + } + + while (lno.length() < width) { + lno = ch + lno; + } + + lno += separator; + + char chars[] = lno.toCharArray(); + try { + rtf.characters(chars, 0, lno.length()); + } catch (SAXException e) { + System.out.println("SAX Exception in formatLineNumber"); + } + } + + /** + *

                  Insert text callouts into a verbatim environment.

                  + * + *

                  This method examines the areaset and area elements + * in the supplied areaspec and decorates the supplied + * result tree fragment with appropriate callout markers.

                  + * + *

                  If a label attribute is supplied on an area, + * its content will be used for the label, otherwise the callout + * number will be used, surrounded by parenthesis. Callouts are + * numbered in document order. All of the areas in an + * areaset get the same number.

                  + * + *

                  Only the linecolumn and linerange units are + * supported. If no unit is specifed, linecolumn is assumed. + * If only a line is specified, the callout decoration appears in + * the defaultColumn. Lines will be padded with blanks to reach the + * necessary column, but callouts that are located beyond the last + * line of the verbatim environment will be ignored.

                  + * + *

                  Callouts are inserted before the character at the line/column + * where they are to occur.

                  + * + * @param areaspecNodeSet The source node set that contains the areaspec. + * @param xalanRTF The result tree fragment of the verbatim environment. + * @param defaultColumn The column for callouts that specify only a line. + * + * @return The modified result tree fragment. */ + + /** + *

                  Insert graphical callouts into a verbatim environment.

                  + * + *

                  This method examines the areaset and area elements + * in the supplied areaspec and decorates the supplied + * result tree fragment with appropriate callout markers.

                  + * + *

                  If a label attribute is supplied on an area, + * its content will be used for the label, otherwise the callout + * number will be used. Callouts are + * numbered in document order. All of the areas in an + * areaset get the same number.

                  + * + *

                  If the callout number is not greater than gMax, the + * callout generated will be:

                  + * + * 
                  +   * <img src="$gPath/conumber$gExt" alt="conumber">
+   *
                  + * + *

                  Otherwise, it will be the callout number surrounded by + * parenthesis.

                  + * + *

                  Only the linecolumn and linerange units are + * supported. If no unit is specifed, linecolumn is assumed. + * If only a line is specified, the callout decoration appears in + * the defaultColumn. Lines will be padded with blanks to reach the + * necessary column, but callouts that are located beyond the last + * line of the verbatim environment will be ignored.

                  + * + *

                  Callouts are inserted before the character at the line/column + * where they are to occur.

                  + * + * @param context + * @param areaspecNodeSet The source node set that contains the areaspec. + * @param xalanNI + * + * @return The modified result tree fragment. + */ + public DocumentFragment insertCallouts (ExpressionContext context, + NodeIterator areaspecNodeSet, + NodeIterator xalanNI) { + String type = Params.getString(context, "stylesheet.result.type"); + boolean useFO = type.equals("fo"); + int defaultColumn = Params.getInt(context, "callout.defaultcolumn"); + + if (Params.getBoolean(context, "callout.graphics")) { + String gPath = Params.getString(context, "callout.graphics.path"); + String gExt = Params.getString(context, "callout.graphics.extension"); + int gMax = Params.getInt(context, "callout.graphics.number.limit"); + return insertGraphicCallouts(areaspecNodeSet, xalanNI, defaultColumn, + gPath, gExt, gMax, useFO); + } else if (Params.getBoolean(context, "callout.unicode")) { + int uStart = Params.getInt(context, "callout.unicode.start.character"); + int uMax = Params.getInt(context, "callout.unicode.number.limit"); + String uFont = Params.getString(context, "callout.unicode.font"); + return insertUnicodeCallouts(areaspecNodeSet, xalanNI, defaultColumn, + uFont, uStart, uMax, useFO); + } else if (Params.getBoolean(context, "callout.dingbats")) { + int dMax = 10; + return insertDingbatCallouts(areaspecNodeSet, xalanNI, defaultColumn, + dMax, useFO); + } else { + return insertTextCallouts(areaspecNodeSet, xalanNI, defaultColumn, useFO); + } + } + + public DocumentFragment insertGraphicCallouts (NodeIterator areaspecNodeSet, + NodeIterator xalanNI, + int defaultColumn, + String gPath, + String gExt, + int gMax, + boolean useFO) { + FormatGraphicCallout fgc = new FormatGraphicCallout(gPath,gExt,gMax,useFO); + return insertCallouts(areaspecNodeSet, xalanNI, defaultColumn, fgc); + } + + public DocumentFragment insertUnicodeCallouts (NodeIterator areaspecNodeSet, + NodeIterator xalanNI, + int defaultColumn, + String uFont, + int uStart, + int uMax, + boolean useFO) { + FormatUnicodeCallout fuc = new FormatUnicodeCallout(uFont, uStart, uMax, useFO); + return insertCallouts(areaspecNodeSet, xalanNI, defaultColumn, fuc); + } + + public DocumentFragment insertDingbatCallouts (NodeIterator areaspecNodeSet, + NodeIterator xalanNI, + int defaultColumn, + int gMax, + boolean useFO) { + FormatDingbatCallout fdc = new FormatDingbatCallout(gMax,useFO); + return insertCallouts(areaspecNodeSet, xalanNI, defaultColumn, fdc); + } + + public DocumentFragment insertTextCallouts (NodeIterator areaspecNodeSet, + NodeIterator xalanNI, + int defaultColumn, + boolean useFO) { + FormatTextCallout ftc = new FormatTextCallout(useFO); + return insertCallouts(areaspecNodeSet, xalanNI, defaultColumn, ftc); + } + + public DocumentFragment insertCallouts (NodeIterator areaspecNodeSet, + NodeIterator xalanNI, + int defaultColumn, + FormatCallout fCallout) { + + DocumentFragment xalanRTF = (DocumentFragment) xalanNI.nextNode(); + + callout = new Callout[10]; + calloutCount = 0; + calloutPos = 0; + lineNumber = 1; + colNumber = 1; + + // First we walk through the areaspec to calculate the position + // of the callouts + // + // + // + // + // + // + // + // + int pos = 0; + int coNum = 0; + boolean inAreaSet = false; + Node node = areaspecNodeSet.nextNode(); + node = node.getFirstChild(); + while (node != null) { + if (node.getNodeType() == Node.ELEMENT_NODE) { + if (node.getNodeName().equals("areaset")) { + coNum++; + Node area = node.getFirstChild(); + while (area != null) { + if (area.getNodeType() == Node.ELEMENT_NODE) { + if (area.getNodeName().equals("area")) { + addCallout(coNum, area, defaultColumn); + } else { + System.out.println("Unexpected element in areaset: " + + area.getNodeName()); + } + } + area = area.getNextSibling(); + } + } else if (node.getNodeName().equalsIgnoreCase("area")) { + coNum++; + addCallout(coNum, node, defaultColumn); + } else { + System.out.println("Unexpected element in areaspec: " + + node.getNodeName()); + } + } + + node = node.getNextSibling(); + } + + // Now sort them + java.util.Arrays.sort(callout, 0, calloutCount); + + DocumentBuilderFactory docFactory = DocumentBuilderFactory.newInstance(); + DocumentBuilder docBuilder = null; + + try { + docBuilder = docFactory.newDocumentBuilder(); + } catch (ParserConfigurationException e) { + System.out.println("PCE 2!"); + return xalanRTF; + } + Document doc = docBuilder.newDocument(); + DocumentFragment df = doc.createDocumentFragment(); + DOMBuilder db = new DOMBuilder(doc, df); + + elementStack = new Stack(); + calloutFragment(db, xalanRTF, fCallout); + return df; + } + + /** + *

                  Build a FragmentValue with callout decorations.

                  + * + *

                  This is the method that actually does the work of adding + * callouts to a verbatim environment. It recursively walks through a + * tree of nodes, copying the structure into the rtf. Text nodes + * are examined for the position of callouts as described by the + * global callout parameters.

                  + * + *

                  When called, rtf should be an empty FragmentValue and node + * should be the first child of the result tree fragment that contains + * the existing, formatted verbatim text.

                  + * + * @param rtf The resulting verbatim environment with numbered lines. + * @param node The root of the tree to copy. + */ + private void calloutFragment(DOMBuilder rtf, + Node node, + FormatCallout fCallout) { + try { + if (node.getNodeType() == Node.DOCUMENT_FRAGMENT_NODE + || node.getNodeType() == Node.DOCUMENT_NODE) { + Node child = node.getFirstChild(); + while (child != null) { + calloutFragment(rtf, child, fCallout); + child = child.getNextSibling(); + } + } else if (node.getNodeType() == Node.ELEMENT_NODE) { + String ns = node.getNamespaceURI(); + String localName = node.getLocalName(); + String name = ((Element) node).getTagName(); + + rtf.startElement(ns, localName, name, + copyAttributes((Element) node)); + + elementStack.push(node); + + Node child = node.getFirstChild(); + while (child != null) { + calloutFragment(rtf, child, fCallout); + child = child.getNextSibling(); + } + } else if (node.getNodeType() == Node.TEXT_NODE) { + String text = node.getNodeValue(); + + char chars[] = text.toCharArray(); + int pos = 0; + for (int count = 0; count < text.length(); count++) { + if (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() == colNumber) { + if (pos > 0) { + rtf.characters(chars, 0, pos); + pos = 0; + } + + closeOpenElements(rtf); + + while (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() == colNumber) { + fCallout.formatCallout(rtf, callout[calloutPos]); + calloutPos++; + } + + openClosedElements(rtf); + } + + if (text.charAt(count) == '\n') { + // What if we need to pad this line? + if (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() > colNumber) { + + if (pos > 0) { + rtf.characters(chars, 0, pos); + pos = 0; + } + + closeOpenElements(rtf); + + while (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() > colNumber) { + formatPad(rtf, callout[calloutPos].getColumn() - colNumber); + colNumber = callout[calloutPos].getColumn(); + while (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() == colNumber) { + fCallout.formatCallout(rtf, callout[calloutPos]); + calloutPos++; + } + } + + openClosedElements(rtf); + } + + lineNumber++; + colNumber = 1; + } else { + colNumber++; + } + chars[pos++] = text.charAt(count); + } + + if (pos > 0) { + rtf.characters(chars, 0, pos); + } + } else if (node.getNodeType() == Node.COMMENT_NODE) { + String text = node.getNodeValue(); + char chars[] = text.toCharArray(); + rtf.comment(chars, 0, text.length()); + } else if (node.getNodeType() == Node.PROCESSING_INSTRUCTION_NODE) { + rtf.processingInstruction(node.getNodeName(), node.getNodeValue()); + } else { + System.out.println("Warning: unexpected node type in calloutFragment: " + node.getNodeType() + ": " + node.getNodeName()); + } + + if (node.getNodeType() == Node.ELEMENT_NODE) { + String ns = node.getNamespaceURI(); + String localName = node.getLocalName(); + String name = ((Element) node).getTagName(); + rtf.endElement(ns, localName, name); + elementStack.pop(); + } else { + // nop + } + } catch (SAXException e) { + System.out.println("SAX Exception in calloutFragment"); + } + } + + /** + *

                  Add a callout to the global callout array

                  + * + *

                  This method examines a callout area and adds it to + * the global callout array if it can be interpreted.

                  + * + *

                  Only the linecolumn and linerange units are + * supported. If no unit is specifed, linecolumn is assumed. + * If only a line is specified, the callout decoration appears in + * the defaultColumn.

                  + * + * @param coNum The callout number. + * @param node The area. + * @param defaultColumn The default column for callouts. + */ + private void addCallout (int coNum, + Node node, + int defaultColumn) { + Element area = (Element) node; + + String units = area.getAttribute("units"); + String otherUnits = area.getAttribute("otherunits"); + String coords = area.getAttribute("coords"); + int type = 0; + String otherType = null; + + if (units == null || units.equals("linecolumn")) { + type = Callout.LINE_COLUMN; // the default + } else if (units.equals("linerange")) { + type = Callout.LINE_RANGE; + } else if (units.equals("linecolumnpair")) { + type = Callout.LINE_COLUMN_PAIR; + } else if (units.equals("calspair")) { + type = Callout.CALS_PAIR; + } else { + type = Callout.OTHER; + otherType = otherUnits; + } + + if (type != Callout.LINE_COLUMN + && type != Callout.LINE_RANGE) { + System.out.println("Only linecolumn and linerange units are supported"); + return; + } + + if (coords == null) { + System.out.println("Coords must be specified"); + return; + } + + // Now let's see if we can interpret the coordinates... + StringTokenizer st = new StringTokenizer(coords); + int tokenCount = 0; + int c1 = 0; + int c2 = 0; + while (st.hasMoreTokens()) { + tokenCount++; + if (tokenCount > 2) { + System.out.println("Unparseable coordinates"); + return; + } + try { + String token = st.nextToken(); + int coord = Integer.parseInt(token); + c2 = coord; + if (tokenCount == 1) { + c1 = coord; + } + } catch (NumberFormatException e) { + System.out.println("Unparseable coordinate"); + return; + } + } + + // Make sure we aren't going to blow past the end of our array + if (calloutCount == callout.length) { + Callout bigger[] = new Callout[calloutCount+10]; + for (int count = 0; count < callout.length; count++) { + bigger[count] = callout[count]; + } + callout = bigger; + } + + // Ok, add the callout + if (tokenCount == 2) { + if (type == Callout.LINE_RANGE) { + for (int count = c1; count <= c2; count++) { + callout[calloutCount++] = new Callout(coNum, area, + count, defaultColumn, + type); + } + } else { + // assume linecolumn + callout[calloutCount++] = new Callout(coNum, area, c1, c2, type); + } + } else { + // if there's only one number, assume it's the line + callout[calloutCount++] = new Callout(coNum, area, c1, defaultColumn, type); + } + } + + /** + *

                  Add blanks to the result tree fragment.

                  + * + *

                  This method adds numBlanks to the result tree fragment. + * It's used to pad lines when callouts occur after the last existing + * characater in a line.

                  + * + * @param rtf The resulting verbatim environment with numbered lines. + * @param numBlanks The number of blanks to add. + */ + private void formatPad(DOMBuilder rtf, + int numBlanks) { + char chars[] = new char[numBlanks]; + for (int count = 0; count < numBlanks; count++) { + chars[count] = ' '; + } + + try { + rtf.characters(chars, 0, numBlanks); + } catch (SAXException e) { + System.out.println("SAX Exception in formatCallout"); + } + } + + private void closeOpenElements(DOMBuilder rtf) + throws SAXException { + // Close all the open elements... + tempStack = new Stack(); + while (!elementStack.empty()) { + Node elem = (Node) elementStack.pop(); + + String ns = elem.getNamespaceURI(); + String localName = elem.getLocalName(); + String name = ((Element) elem).getTagName(); + + // If this is the bottom of the stack and it's an fo:block + // or an HTML pre or div, don't duplicate it... + if (elementStack.empty() + && (((ns != null) + && ns.equals(foURI) + && localName.equals("block")) + || (((ns == null) + && localName.equalsIgnoreCase("pre")) + || ((ns != null) + && ns.equals(xhURI) + && localName.equals("pre"))) + || (((ns == null) + && localName.equalsIgnoreCase("div")) + || ((ns != null) + && ns.equals(xhURI) + && localName.equals("div"))))) { + elementStack.push(elem); + break; + } else { + rtf.endElement(ns, localName, name); + tempStack.push(elem); + } + } + } + + private void openClosedElements(DOMBuilder rtf) + throws SAXException { + // Now "reopen" the elements that we closed... + while (!tempStack.empty()) { + Node elem = (Node) tempStack.pop(); + + String ns = elem.getNamespaceURI(); + String localName = elem.getLocalName(); + String name = ((Element) elem).getTagName(); + NamedNodeMap domAttr = elem.getAttributes(); + + AttributesImpl attr = new AttributesImpl(); + for (int acount = 0; acount < domAttr.getLength(); acount++) { + Node a = domAttr.item(acount); + + if (((ns == null || ns == "http://www.w3.org/1999/xhtml") + && localName.equalsIgnoreCase("a")) + || (a.getLocalName().equalsIgnoreCase("id"))) { + // skip this attribute + } else { + attr.addAttribute(a.getNamespaceURI(), + a.getLocalName(), + a.getNodeName(), + "CDATA", + a.getNodeValue()); + } + } + + rtf.startElement(ns, localName, name, attr); + elementStack.push(elem); + } + + tempStack = null; + } + + private Attributes copyAttributes(Element node) { + AttributesImpl attrs = new AttributesImpl(); + NamedNodeMap nnm = node.getAttributes(); + for (int count = 0; count < nnm.getLength(); count++) { + Attr attr = (Attr) nnm.item(count); + String name = attr.getName(); + if (name.startsWith("xmlns:") || name.equals("xmlns")) { + // Skip it; (don't ya just love it!!) + } else { + attrs.addAttribute(attr.getNamespaceURI(), attr.getName(), + attr.getName(), "CDATA", attr.getValue()); + } + } + return attrs; + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/package.html b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/package.html new file mode 100644 index 0000000000..92224fa857 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan2/com/nwalsh/xalan/package.html @@ -0,0 +1,48 @@ + + +Norman Walsh's Xalan Extensions Package + + +

                  Norman Walsh's Xalan Extensions Package for Xalan2

                  + +

                  This package implements Xalan extensions for XSLT.

                  + +

                  Copyright (C) 2000 Norman Walsh

                  +

                  Permission is hereby granted, free of charge, to any person +obtaining a copy of this software and associated documentation +files (the "Software"), to deal in the Software without +restriction, including without limitation the rights to use, copy, +modify, merge, publish, distribute, sublicense, and/or sell copies +of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions:

                  + +

                  The above copyright notice and this permission notice shall be +included in all copies or substantial portions of the Software.

                  + +

                  Except as contained in this notice, the names of individuals +credited with contribution to this software shall not be used in +advertising or otherwise to promote the sale, use or other dealings +in this Software without prior written authorization from the +individuals in question.

                  + +

                  Anything derived from this Software that is publically +distributed will be identified with a different name and the +version strings in any derived Software will be changed so that no +possibility of confusion between the derived package and this +Software will exist.

                  + + +
                  +

                  Warranty

                  +

                  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +NONINFRINGEMENT. IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER +CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +DEALINGS IN THE SOFTWARE.

                  +
                  + + + diff --git a/src/documentation/docbook-xsl/extensions/xalan25.jar b/src/documentation/docbook-xsl/extensions/xalan25.jar new file mode 100644 index 0000000000..3c8c45d5a2 Binary files /dev/null and b/src/documentation/docbook-xsl/extensions/xalan25.jar differ diff --git a/src/documentation/docbook-xsl/extensions/xalan27.jar b/src/documentation/docbook-xsl/extensions/xalan27.jar new file mode 100644 index 0000000000..e46c50bd55 Binary files /dev/null and b/src/documentation/docbook-xsl/extensions/xalan27.jar differ diff --git a/src/documentation/docbook-xsl/extensions/xalan27/build.xml b/src/documentation/docbook-xsl/extensions/xalan27/build.xml new file mode 100644 index 0000000000..c39733b62e --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/build.xml @@ -0,0 +1,69 @@ + + + + + + Builds, tests, and runs the project xalan27. + + + diff --git a/src/documentation/docbook-xsl/extensions/xalan27/nbproject/build-impl.xml b/src/documentation/docbook-xsl/extensions/xalan27/nbproject/build-impl.xml new file mode 100644 index 0000000000..fa2628e4df --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/nbproject/build-impl.xml @@ -0,0 +1,541 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Must set src.dir + Must set test.src.dir + Must set build.dir + Must set dist.dir + Must set build.classes.dir + Must set dist.javadoc.dir + Must set build.test.classes.dir + Must set build.test.results.dir + Must set build.classes.excludes + Must set dist.jar + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Must select some files in the IDE or set javac.includes + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + To run this application from the command line without Ant, try: + + + + + + + java -cp "${run.classpath.with.dist.jar}" ${main.class} + + + + + + + + + + + + + + + + + + + + + + + To run this application from the command line without Ant, try: + + java -jar "${dist.jar.resolved}" + + + + + + + + + + + + + + + + Must select one file in the IDE or set run.class + + + + + + + + + + + + + + + + + + + + Must select one file in the IDE or set debug.class + + + + + Must set fix.includes + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Must select some files in the IDE or set javac.includes + + + + + + + + + + + + + + + + + + + + + + + Some tests failed; see details above. + + + + + + + + + Must select some files in the IDE or set test.includes + + + + Some tests failed; see details above. + + + + + Must select one file in the IDE or set test.class + + + + + + + + + + + + + + + + + Must select one file in the IDE or set applet.url + + + + + + + + + Must select one file in the IDE or set applet.url + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/extensions/xalan27/nbproject/genfiles.properties b/src/documentation/docbook-xsl/extensions/xalan27/nbproject/genfiles.properties new file mode 100644 index 0000000000..fd61ced981 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/nbproject/genfiles.properties @@ -0,0 +1,8 @@ +build.xml.data.CRC32=f1bed978 +build.xml.script.CRC32=3c6d9e2a +build.xml.stylesheet.CRC32=d5b6853a +# This file is used by a NetBeans-based IDE to track changes in generated files such as build-impl.xml. +# Do not edit this file. You may delete it but then the IDE will never regenerate such files for you. +nbproject/build-impl.xml.data.CRC32=f1bed978 +nbproject/build-impl.xml.script.CRC32=df1e1cd8 +nbproject/build-impl.xml.stylesheet.CRC32=99b91518 diff --git a/src/documentation/docbook-xsl/extensions/xalan27/nbproject/project.properties b/src/documentation/docbook-xsl/extensions/xalan27/nbproject/project.properties new file mode 100644 index 0000000000..f6e21137a0 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/nbproject/project.properties @@ -0,0 +1,56 @@ +application.args= +build.classes.dir=${build.dir}/classes +build.classes.excludes=**/*.java,**/*.form +# This directory is removed when the project is cleaned: +build.dir=build +build.generated.dir=${build.dir}/generated +# Only compile against the classpath explicitly listed here: +build.sysclasspath=ignore +build.test.classes.dir=${build.dir}/test/classes +build.test.results.dir=${build.dir}/test/results +debug.classpath=\ + ${run.classpath} +debug.test.classpath=\ + ${run.test.classpath} +# This directory is removed when the project is cleaned: +dist.dir=dist +dist.jar=${dist.dir}/xalan27.jar +dist.javadoc.dir=${dist.dir}/javadoc +file.reference.xalan.jar=../../../../../usr/local/java/xalan2/xalan.jar +jar.compress=false +javac.classpath=\ + ${file.reference.xalan.jar} +# Space-separated list of extra javac options +javac.compilerargs= +javac.deprecation=false +javac.source=1.5 +javac.target=1.5 +javac.test.classpath=\ + ${javac.classpath}:\ + ${build.classes.dir}:\ + ${libs.junit.classpath} +javadoc.additionalparam= +javadoc.author=false +javadoc.encoding= +javadoc.noindex=false +javadoc.nonavbar=false +javadoc.notree=false +javadoc.private=false +javadoc.splitindex=true +javadoc.use=true +javadoc.version=false +javadoc.windowtitle= +meta.inf.dir=${src.dir}/META-INF +platform.active=default_platform +run.classpath=\ + ${javac.classpath}:\ + ${build.classes.dir} +# Space-separated list of JVM arguments used when running the project +# (you may also define separate properties like run-sys-prop.name=value instead of -Dname=value +# or test-sys-prop.name=value to set system properties for unit tests): +run.jvmargs= +run.test.classpath=\ + ${javac.test.classpath}:\ + ${build.test.classes.dir} +src.dir=src +test.src.dir=test diff --git a/src/documentation/docbook-xsl/extensions/xalan27/nbproject/project.xml b/src/documentation/docbook-xsl/extensions/xalan27/nbproject/project.xml new file mode 100644 index 0000000000..687ff026d7 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/nbproject/project.xml @@ -0,0 +1,16 @@ + + + org.netbeans.modules.java.j2seproject + + + xalan27 + 1.6.5 + + + + + + + + + diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/CVS.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/CVS.java new file mode 100644 index 0000000000..2199412b9a --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/CVS.java @@ -0,0 +1,90 @@ +package com.nwalsh.xalan; + +import java.io.*; +import java.util.Calendar; +import java.util.GregorianCalendar; +import java.util.Date; +import java.util.Locale; +import java.util.TimeZone; +import java.text.DateFormat; +import java.text.ParseException; + +/** + *

                  Xalan extension to convert CVS date strings into local time

                  + * + *

                  $Id: CVS.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Xalan + * extension to turn the CVS date strings, which are UTC:

                  + * + * 
                  $Date: 2000/11/09 02:34:20 $
                  + * + *

                  into legibly formatted local time:

                  + * + * 
                  Wed Nov 08 18:34:20 PST 2000
                  + * + *

                  (I happened to be in California when I wrote this documentation.)

                  + + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: CVS.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $ + * + */ +public class CVS { + /** + *

                  Constructor for CVS

                  + * + *

                  All of the methods are static, so the constructor does nothing.

                  + */ + public CVS() { + } + + /** + *

                  Convert a CVS date string into local time.

                  + * + * @param cvsDate The CVS date string. + * + * @return The date, converted to local time and reformatted. + */ + public String localTime (String cvsDate) { + // A cvsDate has the following form "$Date: 2006/05/04 13:23:51 $" + if (!cvsDate.startsWith("$Date: ")) { + return cvsDate; + } + + String yrS = cvsDate.substring(7,11); + String moS = cvsDate.substring(12,14); + String daS = cvsDate.substring(15,17); + String hrS = cvsDate.substring(18,20); + String miS = cvsDate.substring(21,23); + String seS = cvsDate.substring(24,26); + + TimeZone tz = TimeZone.getTimeZone("GMT+0"); + GregorianCalendar gmtCal = new GregorianCalendar(tz); + + try { + gmtCal.set(Integer.parseInt(yrS), + Integer.parseInt(moS)-1, + Integer.parseInt(daS), + Integer.parseInt(hrS), + Integer.parseInt(miS), + Integer.parseInt(seS)); + } catch (NumberFormatException e) { + // nop + } + + Date d = gmtCal.getTime(); + + return d.toString(); + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Callout.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Callout.java new file mode 100644 index 0000000000..468587e02f --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Callout.java @@ -0,0 +1,143 @@ +package com.nwalsh.xalan; + +import org.w3c.dom.*; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: Callout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class is just for book keeping in the Verbatim class. + * It stores information about the location of callouts.

                  + * + *

                  Only line/column based callouts are supported. This class + * implements the Comparable interface so that callouts can be sorted. + * Callouts are sorted so that they occur in left-to-right, + * top-to-bottom order based on line/column.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: Callout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $ + * */ +public class Callout implements Comparable { + /** The callout number. */ + private int callout = 0; + /** The area Element item that generated this callout. */ + private Element area = null; + /** The line on which this callout occurs. */ + private int line = 0; + /** The column in which this callout appears. */ + private int col = 0; + /** The type of callout. */ + private int type = 0; + /** The other type of callout. */ + private String otherType = null; + + public static final int CALS_PAIR = 1; + public static final int LINE_COLUMN = 2; + public static final int LINE_COLUMN_PAIR = 3; + public static final int LINE_RANGE = 4; + public static final int OTHER = 5; + + /** The constructor; initialize the private data structures. */ + public Callout(int callout, Element area, int line, int col, int type) { + this.callout = callout; + this.area = area; + this.line = line; + this.col = col; + this.type = type; + this.otherType = null; + } + + /** The constructor; initialize the private data structures. */ + public Callout(int callout, Element area, int line, int col, String otherType) { + this.callout = callout; + this.area = area; + this.line = line; + this.col = col; + this.type = Callout.OTHER; + this.otherType = otherType; + } + + /** + *

                  The compareTo method compares this Callout with another.

                  + * + *

                  Given two Callouts, A and B, A < B if:

                  + * + *
                    + *
                  1. A.line < B.line, or
                    2. + *
                  2. A.line = B.line && A.col < B.col, or
                    3. + *
                  3. A.line = B.line && A.col = B.col && A.callout < B.callout
                    4. + *
                  4. Otherwise, they're equal.
                    5. + *
                  + */ + public int compareTo (Object o) { + Callout c = (Callout) o; + + if (line == c.getLine()) { + if (col > c.getColumn()) { + return 1; + } else if (col < c.getColumn()) { + return -1; + } else { + if (callout < c.getCallout()) { + return -1; + } else if (callout > c.getCallout()) { + return 1; + } else { + return 0; + } + } + } else { + if (line > c.getLine()) { + return 1; + } else { + return -1; + } + } + } + + /** Access the Callout's area. */ + public Element getArea() { + return area; + } + + /** Access the Callout's line. */ + public int getLine() { + return line; + } + + /** Access the Callout's column. */ + public int getColumn() { + return col; + } + + /** Access the Callout's callout number. */ + public int getCallout() { + return callout; + } + + /** Access the Callout's type. */ + public int getType() { + return type; + } + + /** Access the Callout's otherType. */ + public String getOtherType() { + return otherType; + } + + +} + diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java new file mode 100644 index 0000000000..59cf83c9a1 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatCallout.java @@ -0,0 +1,101 @@ +package com.nwalsh.xalan; + +import org.xml.sax.SAXException; +import org.xml.sax.helpers.AttributesImpl; +import org.w3c.dom.*; +import org.apache.xml.utils.DOMBuilder; +import com.nwalsh.xalan.Callout; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatCallout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatCallout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $ + **/ + +public abstract class FormatCallout { + protected static final String foURI = "http://www.w3.org/1999/XSL/Format"; + protected static final String xhURI = "http://www.w3.org/1999/xhtml"; + protected boolean stylesheetFO = false; + + public FormatCallout() { + //nop; + } + + public String areaLabel(Element area) { + String label = null; + + if (!"".equals(area.getAttribute("label"))) { + // If this area has a label, use it + label = area.getAttribute("label"); + } else { + // Otherwise, if its parent is an areaset and it has a label, use that + Element parent = (Element) area.getParentNode(); + if (parent != null + && parent.getNodeName().equals("areaset") + && !"".equals(parent.getAttribute("label"))) { + label = parent.getAttribute("label"); + } + } + + return label; + } + + public void startSpan(DOMBuilder rtf) + throws SAXException { + // no point in doing this for FO, right? + if (!stylesheetFO) { + AttributesImpl spanAttr = new AttributesImpl(); + spanAttr.addAttribute("", "class", "class", "CDATA", "co"); + rtf.startElement("", "span", "span", spanAttr); + } + } + + public void endSpan(DOMBuilder rtf) + throws SAXException { + // no point in doing this for FO, right? + if (!stylesheetFO) { + rtf.endElement("", "span", "span"); + } + } + + public void formatTextCallout(DOMBuilder rtf, + Callout callout) { + Element area = callout.getArea(); + int num = callout.getCallout(); + String userLabel = areaLabel(area); + String label = "(" + num + ")"; + + if (userLabel != null) { + label = userLabel; + } + + char chars[] = label.toCharArray(); + + try { + startSpan(rtf); + rtf.characters(chars, 0, label.length()); + endSpan(rtf); + } catch (SAXException e) { + System.out.println("SAX Exception in text formatCallout"); + } + } + + public abstract void formatCallout(DOMBuilder rtf, + Callout callout); +} + diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java new file mode 100644 index 0000000000..8254a34da4 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatDingbatCallout.java @@ -0,0 +1,82 @@ +package com.nwalsh.xalan; + +import org.xml.sax.helpers.AttributesImpl; +import org.xml.sax.SAXException; +import org.w3c.dom.*; +import org.apache.xml.utils.DOMBuilder; +import com.nwalsh.xalan.Callout; +import org.apache.xml.utils.AttList; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatDingbatCallout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatDingbatCallout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $ + **/ + +public class FormatDingbatCallout extends FormatCallout { + int graphicsMax = 0; + + public FormatDingbatCallout(int max, boolean fo) { + graphicsMax = max; + stylesheetFO = fo; + } + + public void formatCallout(DOMBuilder rtf, + Callout callout) { + Element area = callout.getArea(); + int num = callout.getCallout(); + String label = areaLabel(area); + + try { + if (label == null && num <= graphicsMax) { + AttributesImpl imgAttr = new AttributesImpl(); + String ns = ""; + String prefix = ""; + String imgName = ""; + + if (stylesheetFO) { + ns = foURI; + prefix = "fo:"; // FIXME: this could be a problem... + imgName = "inline"; + imgAttr.addAttribute("", "font-family", "font-family", "CDATA", + "ZapfDingbats"); + } else { + ns = ""; + prefix = ""; + imgName = "font"; + imgAttr.addAttribute("", "face", "face", "CDATA", + "ZapfDingbats"); + } + + startSpan(rtf); + rtf.startElement(ns, imgName, prefix+imgName, imgAttr); + + char chars[] = new char[1]; + chars[0] = (char) (0x2775 + num); + rtf.characters(chars, 0, 1); + + rtf.endElement(ns, imgName, prefix+imgName); + endSpan(rtf); + } else { + formatTextCallout(rtf, callout); + } + } catch (SAXException e) { + System.out.println("SAX Exception in graphics formatCallout"); + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java new file mode 100644 index 0000000000..750f7ebd8e --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatGraphicCallout.java @@ -0,0 +1,83 @@ +package com.nwalsh.xalan; + +import org.xml.sax.helpers.AttributesImpl; +import org.xml.sax.SAXException; +import org.w3c.dom.*; +import org.apache.xml.utils.DOMBuilder; +import com.nwalsh.xalan.Callout; +import org.apache.xml.utils.AttList; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatGraphicCallout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatGraphicCallout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $ + **/ + +public class FormatGraphicCallout extends FormatCallout { + String graphicsPath = ""; + String graphicsExt = ""; + int graphicsMax = 0; + + public FormatGraphicCallout(String path, String ext, int max, boolean fo) { + graphicsPath = path; + graphicsExt = ext; + graphicsMax = max; + stylesheetFO = fo; + } + + public void formatCallout(DOMBuilder rtf, + Callout callout) { + Element area = callout.getArea(); + int num = callout.getCallout(); + String label = areaLabel(area); + + try { + if (label == null && num <= graphicsMax) { + AttributesImpl imgAttr = new AttributesImpl(); + String ns = ""; + String prefix = ""; + String imgName = ""; + + if (stylesheetFO) { + ns = foURI; + prefix = "fo:"; // FIXME: this could be a problem... + imgName = "external-graphic"; + imgAttr.addAttribute("", "src", "src", "CDATA", + graphicsPath + num + graphicsExt); + imgAttr.addAttribute("", "alt", "alt", "CDATA", label); + } else { + ns = ""; + prefix = ""; + imgName = "img"; + imgAttr.addAttribute("", "src", "src", "CDATA", + graphicsPath + num + graphicsExt); + imgAttr.addAttribute("", "alt", "alt", "CDATA", label); + } + + startSpan(rtf); + rtf.startElement(ns, imgName, prefix+imgName, imgAttr); + rtf.endElement(ns, imgName, prefix+imgName); + endSpan(rtf); + } else { + formatTextCallout(rtf, callout); + } + } catch (SAXException e) { + System.out.println("SAX Exception in graphics formatCallout"); + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java new file mode 100644 index 0000000000..f1521fe473 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatTextCallout.java @@ -0,0 +1,38 @@ +package com.nwalsh.xalan; + +import org.w3c.dom.*; +import org.apache.xml.utils.DOMBuilder; +import com.nwalsh.xalan.Callout; +import org.apache.xml.utils.AttList; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatTextCallout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatTextCallout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $ + **/ + +public class FormatTextCallout extends FormatCallout { + public FormatTextCallout(boolean fo) { + stylesheetFO = fo; + } + + public void formatCallout(DOMBuilder rtf, + Callout callout) { + formatTextCallout(rtf, callout); + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java new file mode 100644 index 0000000000..78cda85def --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/FormatUnicodeCallout.java @@ -0,0 +1,87 @@ +package com.nwalsh.xalan; + +import org.xml.sax.helpers.AttributesImpl; +import org.xml.sax.SAXException; +import org.w3c.dom.*; +import org.apache.xml.utils.DOMBuilder; +import com.nwalsh.xalan.Callout; +import org.apache.xml.utils.AttList; + +/** + *

                  Utility class for the Verbatim extension (ignore this).

                  + * + *

                  $Id: FormatUnicodeCallout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000, 2001 Norman Walsh.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @see Verbatim + * + * @version $Id: FormatUnicodeCallout.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $ + **/ + +public class FormatUnicodeCallout extends FormatCallout { + int unicodeMax = 0; + int unicodeStart = 0; + String unicodeFont = ""; + + public FormatUnicodeCallout(String font, int start, int max, boolean fo) { + unicodeFont = font; + unicodeMax = max; + unicodeStart = start; + stylesheetFO = fo; + } + + public void formatCallout(DOMBuilder rtf, + Callout callout) { + Element area = callout.getArea(); + int num = callout.getCallout(); + String label = areaLabel(area); + + try { + if (label == null && num <= unicodeMax) { + AttributesImpl inAttr = new AttributesImpl(); + String ns = ""; + String prefix = ""; + String inName = ""; + + if (!unicodeFont.equals("")) { + if (stylesheetFO) { + ns = foURI; + prefix = "fo:"; + inName = "inline"; + inAttr.addAttribute("", "", "font-family", "CDATA", unicodeFont); + } else { + inName = "font"; + inAttr.addAttribute("", "", "face", "CDATA", unicodeFont); + } + } + + char chars[] = new char[1]; + chars[0] = (char) (unicodeStart + num - 1); + + startSpan(rtf); + if (!unicodeFont.equals("")) { + rtf.startElement(ns, inName, prefix+inName, inAttr); + } + rtf.characters(chars, 0, 1); + if (!unicodeFont.equals("")) { + rtf.endElement(ns, inName, prefix+inName); + } + endSpan(rtf); + } else { + formatTextCallout(rtf, callout); + } + } catch (SAXException e) { + System.out.println("SAX Exception in unicode formatCallout"); + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Func.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Func.java new file mode 100644 index 0000000000..771bd13ac6 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Func.java @@ -0,0 +1,58 @@ +// Func - Xalann extension function test + +package com.nwalsh.xalan; + +import org.xml.sax.SAXException; +import org.xml.sax.ContentHandler; + +import org.w3c.dom.DocumentFragment; +import org.w3c.dom.Element; +import org.w3c.dom.traversal.NodeIterator; + +import org.apache.xpath.objects.XObject; +import org.apache.xpath.objects.XRTreeFrag; +import org.apache.xpath.XPath; +import org.apache.xpath.NodeSet; +import org.apache.xalan.extensions.XSLProcessorContext; +import org.apache.xalan.extensions.ExpressionContext; +import org.apache.xalan.transformer.TransformerImpl; +import org.apache.xalan.templates.StylesheetRoot; +import org.apache.xalan.templates.ElemExtensionCall; +import org.apache.xalan.templates.OutputProperties; +import org.apache.xalan.res.XSLTErrorResources; + +import javax.xml.transform.stream.StreamResult; +import javax.xml.transform.TransformerException; + +public class Func { + public Func() { + } + + public DocumentFragment doSomething(NodeIterator rtf) { + System.out.println("Got here 2: " + rtf); + + DocumentFragment df = (DocumentFragment) rtf.nextNode(); + Element node = (Element) df.getFirstChild(); + + System.out.println("node=" + node); + System.out.println("namesp uri: " + node.getNamespaceURI()); + System.out.println("local name: " + node.getLocalName()); + + return df; + } + + public DocumentFragment doSomething(DocumentFragment rtf) { + System.out.println("Got here: " + rtf); + + return rtf; + /* + Element node = (Element) rtf.getFirstChild(); + + System.out.println("node=" + node); + System.out.println("namesp uri: " + node.getNamespaceURI()); + System.out.println("local name: " + node.getLocalName()); + + return rtf; + */ + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java new file mode 100644 index 0000000000..2571abdd8c --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/ImageIntrinsics.java @@ -0,0 +1,160 @@ +package com.nwalsh.xalan; + +import java.io.*; +import java.awt.*; +import java.awt.image.*; +import java.lang.Thread; +import java.util.StringTokenizer; + +import org.apache.xalan.extensions.ExpressionContext; + +/** + *

                  Xalan extension to examine intrinsic size of images

                  + * + *

                  $Id: ImageIntrinsics.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $

                  + * + *

                  Copyright (C) 2002 Norman Walsh.

                  + * + *

                  This class provides a + * Xalan + * extension to find the intrinsic size of images.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: ImageIntrinsics.java,v 1.1 2006/05/04 13:23:51 nwalsh Exp $ + * + */ +public class ImageIntrinsics implements ImageObserver { + boolean imageLoaded = false; + boolean imageFailed = false; + Image image = null; + int width = -1; + int depth = -1; + + /** + *

                  Constructor for ImageIntrinsics

                  + */ + public ImageIntrinsics(ExpressionContext context, String imageFn) { + System.setProperty("java.awt.headless","true"); + image = Toolkit.getDefaultToolkit().getImage (imageFn); + width = image.getWidth(this); + + while (!imageFailed && (width == -1 || depth == -1)) { + try { + java.lang.Thread.currentThread().sleep(50); + } catch (Exception e) { + // nop; + } + width = image.getWidth(this); + depth = image.getHeight(this); + } + + if (imageFailed) { + // Maybe it's an EPS or PDF? + // FIXME: this code is crude + BufferedReader ir = null; + String line = null; + int lineLimit = 100; + + try { + ir = new BufferedReader(new FileReader(new File(imageFn))); + line = ir.readLine(); + + if (line != null && line.startsWith("%PDF-")) { + // We've got a PDF! + while (lineLimit > 0 && line != null) { + lineLimit--; + if (line.startsWith("/CropBox [")) { + line = line.substring(10); + if (line.indexOf("]") >= 0) { + line = line.substring(0, line.indexOf("]")); + } + parseBox(line); + lineLimit = 0; + } + line = ir.readLine(); + } + } else if (line != null && line.startsWith("%!") && line.indexOf(" EPSF-") > 0) { + // We've got an EPS! + while (lineLimit > 0 && line != null) { + lineLimit--; + if (line.startsWith("%%BoundingBox: ")) { + line = line.substring(15); + parseBox(line); + lineLimit = 0; + } + line = ir.readLine(); + } + } + } catch (Exception e) { + // nop; + } + + if (ir != null) { + try { + ir.close(); + } catch (Exception e) { + // nop; + } + } + } + } + + public int getWidth(ExpressionContext context, int defaultWidth) { + if (width >= 0) { + return width; + } else { + return defaultWidth; + } + } + + public int getDepth(ExpressionContext context, int defaultDepth) { + if (depth >= 0) { + return depth; + } else { + return defaultDepth; + } + } + + private void parseBox(String line) { + int [] corners = new int [4]; + int count = 0; + + StringTokenizer st = new StringTokenizer(line); + while (count < 4 && st.hasMoreTokens()) { + try { + corners[count++] = Integer.parseInt(st.nextToken()); + } catch (Exception e) { + // nop; + } + } + + width = corners[2] - corners[0]; + depth = corners[3] - corners[1]; + } + + public boolean imageUpdate(Image img, int infoflags, + int x, int y, int width, int height) { + if ((infoflags & ImageObserver.ERROR) == ImageObserver.ERROR) { + imageFailed = true; + return false; + } + + // I really only care about the width and height, but if I return false as + // soon as those are available, the BufferedInputStream behind the loader + // gets closed too early. + int flags = ImageObserver.ALLBITS; + if ((infoflags & flags) == flags) { + return false; + } else { + return true; + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Params.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Params.java new file mode 100644 index 0000000000..20261261dc --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Params.java @@ -0,0 +1,58 @@ +// Params.java - Read stylesheet parameters in Xalan + +package com.nwalsh.xalan; + +import org.apache.xpath.objects.XObject; +import org.apache.xpath.XPathContext; +import org.apache.xalan.extensions.ExpressionContext; +import org.apache.xml.utils.QName; + +import javax.xml.transform.TransformerException; + +public class Params { + + public static String getString(ExpressionContext context, + String varName) { + try { + XObject var = context.getVariableOrParam(new QName(varName)); + if (var != null) { + return var.toString(); + } else { + System.out.println("$" + varName + " is not a defined parameter."); + return ""; + } + } catch (TransformerException te) { + // Nevermind the warning + // System.out.println("Transformer exception getting value of $" + varName); + return ""; + } + } + + public static int getInt(ExpressionContext context, + String varName) { + String stringValue = getString(context, varName); + if (stringValue != null) { + try { + int value = Integer.parseInt(stringValue); + return value; + } catch (NumberFormatException e) { + System.out.println("$" + varName + " is not an integer."); + } + } + return 0; + } + + public static boolean getBoolean(ExpressionContext context, + String varName) { + String stringValue = getString(context, varName); + if (stringValue != null) { + if (stringValue.equals("0") || stringValue.equals("")) { + return false; + } else { + return true; + } + } else { + return false; + } + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Table.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Table.java new file mode 100644 index 0000000000..b5dd3ce3cb --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Table.java @@ -0,0 +1,538 @@ +// Verbatim.java - Xalan extensions supporting DocBook verbatim environments + +package com.nwalsh.xalan; + +import java.util.Hashtable; + +import org.xml.sax.Attributes; +import org.xml.sax.SAXException; +import org.xml.sax.helpers.AttributesImpl; + +import org.w3c.dom.Attr; +import org.w3c.dom.Document; +import org.w3c.dom.DocumentFragment; +import org.w3c.dom.Element; +import org.w3c.dom.NamedNodeMap; +import org.w3c.dom.Node; +import org.w3c.dom.traversal.NodeIterator; + +import javax.xml.transform.TransformerException; + +import org.apache.xpath.objects.XObject; +import org.apache.xpath.XPathContext; +import org.apache.xalan.extensions.ExpressionContext; +import org.apache.xml.utils.DOMBuilder; +import javax.xml.parsers.DocumentBuilder; +import javax.xml.parsers.DocumentBuilderFactory; +import javax.xml.parsers.ParserConfigurationException; +import org.apache.xml.utils.QName; +import org.apache.xml.utils.AttList; + +/** + *

                  Xalan extensions supporting Tables

                  + * + *

                  $Id: Table.java,v 1.2 2006/05/15 11:14:03 nwalsh Exp $

                  + * + *

                  Copyright (C) 2000 Norman Walsh.

                  + * + *

                  This class provides a + * Xalan + * implementation of some code to adjust CALS Tables to HTML + * Tables.

                  + * + *

                  Column Widths

                  + *

                  The adjustColumnWidths method takes a result tree + * fragment (assumed to contain the colgroup of an HTML Table) + * and returns the result tree fragment with the column widths + * adjusted to HTML terms.

                  + * + *

                  Convert Lengths

                  + *

                  The convertLength method takes a length specification + * of the form 9999.99xx (where "xx" is a unit) and returns that length + * as an integral number of pixels. For convenience, percentage lengths + * are returned unchanged.

                  + *

                  The recognized units are: inches (in), centimeters (cm), + * millimeters (mm), picas (pc, 1pc=12pt), points (pt), and pixels (px). + * A number with no units is assumed to be pixels.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: Table.java,v 1.2 2006/05/15 11:14:03 nwalsh Exp $ + * + */ +public class Table { + /** The number of pixels per inch */ + private static int pixelsPerInch = 96; + + /** The hash used to associate units with a length in pixels. */ + protected static Hashtable unitHash = null; + + /** The FO namespace name. */ + protected static String foURI = "http://www.w3.org/1999/XSL/Format"; + + /** + *

                  Constructor for Verbatim

                  + * + *

                  All of the methods are static, so the constructor does nothing.

                  + */ + public Table() { + } + + /** Initialize the internal hash table with proper values. */ + protected static void initializeHash() { + unitHash = new Hashtable(); + unitHash.put("in", new Float(pixelsPerInch)); + unitHash.put("cm", new Float(pixelsPerInch / 2.54)); + unitHash.put("mm", new Float(pixelsPerInch / 25.4)); + unitHash.put("pc", new Float((pixelsPerInch / 72) * 12)); + unitHash.put("pt", new Float(pixelsPerInch / 72)); + unitHash.put("px", new Float(1)); + } + + /** Set the pixels-per-inch value. Only positive values are legal. */ + public static void setPixelsPerInch(int value) { + if (value > 0) { + pixelsPerInch = value; + initializeHash(); + } + } + + /** Return the current pixels-per-inch value. */ + public int getPixelsPerInch() { + return pixelsPerInch; + } + + /** + *

                  Convert a length specification to a number of pixels.

                  + * + *

                  The specified length should be of the form [+/-]999.99xx, + * where xx is a valid unit.

                  + */ + public static int convertLength(String length) { + // The format of length should be 999.999xx + int sign = 1; + String digits = ""; + String units = ""; + char lench[] = length.toCharArray(); + float flength = 0; + boolean done = false; + int pos = 0; + float factor = 1; + int pixels = 0; + + if (unitHash == null) { + initializeHash(); + } + + if (lench[pos] == '+' || lench[pos] == '-') { + if (lench[pos] == '-') { + sign = -1; + } + pos++; + } + + while (!done) { + if (pos >= lench.length) { + done = true; + } else { + if ((lench[pos] > '9' || lench[pos] < '0') && lench[pos] != '.') { + done = true; + units = length.substring(pos); + } else { + digits += lench[pos++]; + } + } + } + + try { + flength = Float.parseFloat(digits); + } catch (NumberFormatException e) { + System.out.println(digits + " is not a number; 1 used instead."); + flength = 1; + } + + Float f = null; + + if (!units.equals("")) { + f = (Float) unitHash.get(units); + if (f == null) { + System.out.println(units + " is not a known unit; 1 used instead."); + factor = 1; + } else { + factor = f.floatValue(); + } + } else { + factor = 1; + } + + f = new Float(flength * factor); + + pixels = f.intValue() * sign; + + return pixels; + } + + /** + *

                  Adjust column widths in an HTML table.

                  + * + *

                  The specification of column widths in CALS (a relative width + * plus an optional absolute width) are incompatible with HTML column + * widths. This method adjusts CALS column width specifiers in an + * attempt to produce equivalent HTML specifiers.

                  + * + *

                  In order for this method to work, the CALS width specifications + * should be placed in the "width" attribute of the <col>s within + * a <colgroup>. Then the colgroup result tree fragment is passed + * to this method.

                  + * + *

                  This method makes use of two parameters from the XSL stylesheet + * that calls it: nominal.table.width and + * table.width. The value of nominal.table.width + * must be an absolute distance. The value of table.width + * can be either absolute or relative.

                  + * + *

                  Presented with a mixture of relative and + * absolute lengths, the table width is used to calculate + * appropriate values. If the table.width is relative, + * the nominal width is used for this calculation.

                  + * + *

                  There are three possible combinations of values:

                  + * + *
                    + *
                  1. There are no relative widths; in this case the absolute widths + * are used in the HTML table.
                    2. + *
                  2. There are no absolute widths; in this case the relative widths + * are used in the HTML table.
                    3. + *
                  3. There are a mixture of absolute and relative widths: + *
                      + *
                    1. If the table width is absolute, all widths become absolute.
                      2. + *
                    2. If the table width is relative, make all the widths absolute + * relative to the nominal table width then turn them all + * back into relative widths.
                      3. + *
                    + *
                    4. + *
                  + * + * @param context The stylesheet context; supplied automatically by Xalan + * @param xalanNI + * + * @return The result tree fragment containing the adjusted colgroup. + * + */ + + public DocumentFragment adjustColumnWidths (ExpressionContext context, + NodeIterator xalanNI) { + + int nominalWidth = convertLength(Params.getString(context, + "nominal.table.width")); + String tableWidth = Params.getString(context, "table.width"); + String styleType = Params.getString(context, "stylesheet.result.type"); + boolean foStylesheet = styleType.equals("fo"); + + DocumentFragment xalanRTF = (DocumentFragment) xalanNI.nextNode(); + Element colgroup = (Element) xalanRTF.getFirstChild(); + + // N.B. ...stree.ElementImpl doesn't implement getElementsByTagName() + + Node firstCol = null; + // If this is an FO tree, there might be no colgroup... + if (colgroup.getLocalName().equals("colgroup")) { + firstCol = colgroup.getFirstChild(); + } else { + firstCol = colgroup; + } + + // Count the number of columns... + Node child = firstCol; + int numColumns = 0; + while (child != null) { + if (child.getNodeType() == Node.ELEMENT_NODE + && (child.getNodeName().equals("col") + || (child.getNamespaceURI().equals(foURI) + && child.getLocalName().equals("table-column")))) { + numColumns++; + } + + child = child.getNextSibling(); + } + + String widths[] = new String[numColumns]; + Element columns[] = new Element[numColumns]; + int colnum = 0; + + child = firstCol; + while (child != null) { + if (child.getNodeType() == Node.ELEMENT_NODE + && (child.getNodeName().equals("col") + || (child.getNamespaceURI().equals(foURI) + && child.getLocalName().equals("table-column")))) { + Element col = (Element) child; + + columns[colnum] = col; + + if (foStylesheet) { + if ("".equals(col.getAttribute("column-width"))) { + widths[colnum] = "1*"; + } else { + widths[colnum] = col.getAttribute("column-width"); + } + } else { + if ("".equals(col.getAttribute("width"))) { + widths[colnum] = "1*"; + } else { + widths[colnum] = col.getAttribute("width"); + } + } + + colnum++; + } + child = child.getNextSibling(); + } + + float relTotal = 0; + float relParts[] = new float[numColumns]; + + float absTotal = 0; + float absParts[] = new float[numColumns]; + + for (int count = 0; count < numColumns; count++) { + String width = widths[count]; + int pos = width.indexOf("*"); + if (pos >= 0) { + String relPart = width.substring(0, pos); + String absPart = width.substring(pos+1); + + try { + float rel = Float.parseFloat(relPart); + relTotal += rel; + relParts[count] = rel; + } catch (NumberFormatException e) { + System.out.println(relPart + " is not a valid relative unit."); + } + + int pixels = 0; + if (absPart != null && !absPart.equals("")) { + pixels = convertLength(absPart); + } + + absTotal += pixels; + absParts[count] = pixels; + } else { + relParts[count] = 0; + + int pixels = 0; + if (width != null && !width.equals("")) { + pixels = convertLength(width); + } + + absTotal += pixels; + absParts[count] = pixels; + } + } + + // Ok, now we have the relative widths and absolute widths in + // two parallel arrays. + // + // - If there are no relative widths, output the absolute widths + // - If there are no absolute widths, output the relative widths + // - If there are a mixture of relative and absolute widths, + // - If the table width is absolute, turn these all into absolute + // widths. + // - If the table width is relative, turn these all into absolute + // widths in the nominalWidth and then turn them back into + // percentages. + + if (relTotal == 0) { + for (int count = 0; count < numColumns; count++) { + Float f = new Float(absParts[count]); + if (foStylesheet) { + int pixels = f.intValue(); + float inches = (float) pixels / pixelsPerInch; + widths[count] = inches + "in"; + } else { + widths[count] = Integer.toString(f.intValue()); + } + } + } else if (absTotal == 0) { + for (int count = 0; count < numColumns; count++) { + float rel = relParts[count] / relTotal * 100; + Float f = new Float(rel); + widths[count] = Integer.toString(f.intValue()); + } + widths = correctRoundingError(widths); + } else { + int pixelWidth = nominalWidth; + + if (tableWidth.indexOf("%") <= 0) { + pixelWidth = convertLength(tableWidth); + } + + if (pixelWidth <= absTotal) { + System.out.println("Table is wider than table width."); + } else { + pixelWidth -= absTotal; + } + + absTotal = 0; + for (int count = 0; count < numColumns; count++) { + float rel = relParts[count] / relTotal * pixelWidth; + relParts[count] = rel + absParts[count]; + absTotal += rel + absParts[count]; + } + + if (tableWidth.indexOf("%") <= 0) { + for (int count = 0; count < numColumns; count++) { + Float f = new Float(relParts[count]); + if (foStylesheet) { + int pixels = f.intValue(); + float inches = (float) pixels / pixelsPerInch; + widths[count] = inches + "in"; + } else { + widths[count] = Integer.toString(f.intValue()); + } + } + } else { + for (int count = 0; count < numColumns; count++) { + float rel = relParts[count] / absTotal * 100; + Float f = new Float(rel); + widths[count] = Integer.toString(f.intValue()); + } + widths = correctRoundingError(widths); + } + } + + // Now rebuild the colgroup with the right widths + + DocumentBuilderFactory docFactory = DocumentBuilderFactory.newInstance(); + DocumentBuilder docBuilder = null; + + try { + docBuilder = docFactory.newDocumentBuilder(); + } catch (ParserConfigurationException e) { + System.out.println("PCE!"); + return xalanRTF; + } + Document doc = docBuilder.newDocument(); + DocumentFragment df = doc.createDocumentFragment(); + DOMBuilder rtf = new DOMBuilder(doc, df); + + try { + String ns = colgroup.getNamespaceURI(); + String localName = colgroup.getLocalName(); + String name = colgroup.getTagName(); + + if (colgroup.getLocalName().equals("colgroup")) { + rtf.startElement(ns, localName, name, + copyAttributes(colgroup)); + } + + for (colnum = 0; colnum < numColumns; colnum++) { + Element col = columns[colnum]; + + NamedNodeMap domAttr = col.getAttributes(); + + AttributesImpl attr = new AttributesImpl(); + for (int acount = 0; acount < domAttr.getLength(); acount++) { + Node a = domAttr.item(acount); + String a_ns = a.getNamespaceURI(); + String a_localName = a.getLocalName(); + + if ((foStylesheet && !a_localName.equals("column-width")) + || !a_localName.equalsIgnoreCase("width")) { + attr.addAttribute(a.getNamespaceURI(), + a.getLocalName(), + a.getNodeName(), + "CDATA", + a.getNodeValue()); + } + } + + if (foStylesheet) { + attr.addAttribute("", "column-width", "column-width", "CDATA", widths[colnum]); + } else { + attr.addAttribute("", "width", "width", "CDATA", widths[colnum]); + } + + rtf.startElement(col.getNamespaceURI(), + col.getLocalName(), + col.getTagName(), + attr); + rtf.endElement(col.getNamespaceURI(), + col.getLocalName(), + col.getTagName()); + } + + if (colgroup.getLocalName().equals("colgroup")) { + rtf.endElement(ns, localName, name); + } + } catch (SAXException se) { + System.out.println("SE!"); + return xalanRTF; + } + + return df; + } + + private Attributes copyAttributes(Element node) { + AttributesImpl attrs = new AttributesImpl(); + NamedNodeMap nnm = node.getAttributes(); + for (int count = 0; count < nnm.getLength(); count++) { + Attr attr = (Attr) nnm.item(count); + String name = attr.getName(); + if (name.startsWith("xmlns:") || name.equals("xmlns")) { + // Skip it; (don't ya just love it!!) + } else { + attrs.addAttribute(attr.getNamespaceURI(), attr.getName(), + attr.getName(), "CDATA", attr.getValue()); + } + } + return attrs; + } + + /** + * Correct rounding errors introduced in calculating the width of each + * column. Make sure they sum to 100% in the end. + */ + protected String[] correctRoundingError(String widths[]) { + int totalWidth = 0; + + for (int count = 0; count < widths.length; count++) { + try { + int width = Integer.parseInt(widths[count]); + totalWidth += width; + } catch (NumberFormatException nfe) { + // nop; "can't happen" + } + } + + float totalError = 100 - totalWidth; + float columnError = totalError / widths.length; + float error = 0; + + for (int count = 0; count < widths.length; count++) { + try { + int width = Integer.parseInt(widths[count]); + error = error + columnError; + if (error >= 1.0) { + int adj = (int) Math.round(Math.floor(error)); + error = error - (float) Math.floor(error); + width = width + adj; + widths[count] = Integer.toString(width) + "%"; + } else { + widths[count] = Integer.toString(width) + "%"; + } + } catch (NumberFormatException nfe) { + // nop; "can't happen" + } + } + + return widths; + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Text.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Text.java new file mode 100644 index 0000000000..708b8cd277 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Text.java @@ -0,0 +1,201 @@ +// Text - Xalan extension element for inserting text + +package com.nwalsh.xalan; + +import java.io.BufferedReader; +import java.io.InputStreamReader; +import java.io.InputStream; +import java.io.IOException; +import java.io.FileNotFoundException; +import java.net.URL; +import java.net.MalformedURLException; + +import org.xml.sax.SAXException; +import org.xml.sax.ContentHandler; + +import org.apache.xpath.objects.XObject; +import org.apache.xpath.XPath; +import org.apache.xpath.NodeSet; +import org.apache.xalan.extensions.XSLProcessorContext; +import org.apache.xalan.transformer.TransformerImpl; +import org.apache.xalan.templates.StylesheetRoot; +import org.apache.xalan.templates.ElemExtensionCall; +import org.apache.xalan.templates.OutputProperties; +import org.apache.xalan.res.XSLTErrorResources; + +import javax.xml.transform.stream.StreamResult; +import javax.xml.transform.TransformerException; +import javax.xml.transform.URIResolver; +import javax.xml.transform.Source; + +/** + *

                  Xalan extension element for inserting text + * + *

                  $Id: Text.java,v 1.2 2006/05/15 11:14:03 nwalsh Exp $

                  + * + *

                  Copyright (C) 2001 Norman Walsh.

                  + * + *

                  This class provides a + * Xalan + * extension element for inserting text into a result tree.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: Text.java,v 1.2 2006/05/15 11:14:03 nwalsh Exp $ + * + */ +public class Text { + /** + *

                  Constructor for Text

                  + * + *

                  Does nothing.

                  + */ + public Text() { + } + + public String insertfile(XSLProcessorContext context, + ElemExtensionCall elem) + throws MalformedURLException, + FileNotFoundException, + IOException, + TransformerException { + String href = getFilename(context, elem); + String encoding = getEncoding(context, elem); + + String baseURI = context.getTransformer().getBaseURLOfSource(); + URIResolver resolver = context.getTransformer().getURIResolver(); + + if (resolver != null) { + Source source = resolver.resolve(href, baseURI); + href = source.getSystemId(); + } + + URL baseURL = null; + URL fileURL = null; + + try { + baseURL = new URL(baseURI); + } catch (MalformedURLException e1) { + try { + baseURL = new URL("file:" + baseURI); + } catch (MalformedURLException e2) { + System.out.println("Cannot find base URI for " + baseURI); + baseURL = null; + } + } + + String text = ""; + + try { + try { + fileURL = new URL(baseURL, href); + } catch (MalformedURLException e1) { + try { + fileURL = new URL(baseURL, "file:" + href); + } catch (MalformedURLException e2) { + System.out.println("Cannot open " + href); + return ""; + } + } + + InputStreamReader isr = null; + if (encoding.equals("") == true) + isr = new InputStreamReader(fileURL.openStream()); + else + isr = new InputStreamReader(fileURL.openStream(), encoding); + + BufferedReader is = new BufferedReader(isr); + + final int BUFFER_SIZE = 4096; + char chars[] = new char[BUFFER_SIZE]; + char nchars[] = new char[BUFFER_SIZE]; + int len = 0; + int i = 0; + int carry = -1; + + while ((len = is.read(chars)) > 0) { + // various new lines are normalized to LF to prevent blank lines + // between lines + + int nlen = 0; + for (i=0; i LF to normalize MAC line endings + nchars[nlen] = '\n'; + nlen++; + continue; + } else { + // if CR is last char of buffer we must look ahead + carry = is.read(); + nchars[nlen] = '\n'; + nlen++; + if (carry == '\n') { + carry = -1; + } + break; + } + } + nchars[nlen] = chars[i]; + nlen++; + } + + text += String.valueOf(nchars, 0, nlen); + + // handle look aheaded character + if (carry != -1) text += String.valueOf((char)carry); + carry = -1; + } + is.close(); + } catch (Exception e) { + System.out.println("Cannot read " + href); + } + + return text; + } + + private String getFilename(XSLProcessorContext context, ElemExtensionCall elem) + throws java.net.MalformedURLException, + java.io.FileNotFoundException, + java.io.IOException, + javax.xml.transform.TransformerException { + + String fileName; + + fileName = ((ElemExtensionCall)elem).getAttribute ("href", + context.getContextNode(), + context.getTransformer()); + + if ("".equals(fileName)) { + context.getTransformer().getMsgMgr().error(elem, + "No 'href' on text, or not a filename"); + } + + return fileName; + } + + private String getEncoding(XSLProcessorContext context, ElemExtensionCall elem) + throws java.net.MalformedURLException, + java.io.FileNotFoundException, + java.io.IOException, + javax.xml.transform.TransformerException { + + String encoding; + + encoding = ((ElemExtensionCall)elem).getAttribute ("encoding", + context.getContextNode(), + context.getTransformer()); + + return encoding; + } +} diff --git a/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java new file mode 100644 index 0000000000..417b16d123 --- /dev/null +++ b/src/documentation/docbook-xsl/extensions/xalan27/src/com/nwalsh/xalan/Verbatim.java @@ -0,0 +1,931 @@ +// Verbatim.java - Xalan extensions supporting DocBook verbatim environments + +package com.nwalsh.xalan; + +import java.util.Stack; +import java.util.StringTokenizer; + +import org.xml.sax.Attributes; +import org.xml.sax.SAXException; + +import org.w3c.dom.Attr; +import org.w3c.dom.Document; +import org.w3c.dom.DocumentFragment; +import org.w3c.dom.NamedNodeMap; +import org.w3c.dom.Node; +import org.w3c.dom.Element; +import org.w3c.dom.traversal.NodeIterator; + +import org.apache.xpath.objects.XObject; +import org.apache.xpath.XPath; +import org.apache.xpath.XPathContext; +import org.apache.xpath.NodeSet; +import org.apache.xalan.extensions.XSLProcessorContext; +import org.apache.xalan.extensions.ExpressionContext; +import org.apache.xalan.transformer.TransformerImpl; +import org.apache.xalan.templates.StylesheetRoot; +import org.apache.xalan.templates.ElemExtensionCall; +import org.apache.xalan.templates.OutputProperties; +import org.apache.xalan.res.XSLTErrorResources; +import org.apache.xml.utils.DOMBuilder; +import org.apache.xml.utils.AttList; +import org.apache.xml.utils.QName; + +import javax.xml.transform.stream.StreamResult; +import javax.xml.transform.TransformerException; +import javax.xml.parsers.DocumentBuilder; +import javax.xml.parsers.DocumentBuilderFactory; +import javax.xml.parsers.ParserConfigurationException; + +import com.nwalsh.xalan.Callout; +import com.nwalsh.xalan.Params; +import org.xml.sax.helpers.AttributesImpl; + +/** + *

                  Xalan extensions supporting DocBook verbatim environments

                  + * + *

                  $Id: Verbatim.java,v 1.2 2006/05/15 11:14:03 nwalsh Exp $

                  + * + *

                  Copyright (C) 2001 Norman Walsh.

                  + * + *

                  This class provides a + * Xalan + * implementation of two features that would be impractical to + * implement directly in XSLT: line numbering and callouts.

                  + * + *

                  Line Numbering

                  + *

                  The numberLines family of functions takes a result tree + * fragment (assumed to contain the contents of a formatted verbatim + * element in DocBook: programlisting, screen, address, literallayout, + * or synopsis) and returns a result tree fragment decorated with + * line numbers.

                  + * + *

                  Callouts

                  + *

                  The insertCallouts family of functions takes an + * areaspec and a result tree fragment + * (assumed to contain the contents of a formatted verbatim + * element in DocBook: programlisting, screen, address, literallayout, + * or synopsis) and returns a result tree fragment decorated with + * callouts.

                  + * + *

                  Change Log:

                  + *
                  + *
                  1.0
                  + *

                  Initial release.

                  + *
                  + * + * @author Norman Walsh + * ndw@nwalsh.com + * + * @version $Id: Verbatim.java,v 1.2 2006/05/15 11:14:03 nwalsh Exp $ + * + */ +public class Verbatim { + /** A stack to hold the open elements while walking through a RTF. */ + private Stack elementStack = null; + /** A stack to hold the temporarily closed elements. */ + private Stack tempStack = null; + /** The current line number. */ + private int lineNumber = 0; + /** The current column number. */ + private int colNumber = 0; + /** The modulus for line numbering (every 'modulus' line is numbered). */ + private int modulus = 0; + /** The width (in characters) of line numbers (for padding). */ + private int width = 0; + /** The separator between the line number and the verbatim text. */ + private String separator = ""; + /** The (sorted) array of callouts obtained from the areaspec. */ + private Callout callout[] = null; + /** The number of callouts in the callout array. */ + private int calloutCount = 0; + /** A pointer used to keep track of our position in the callout array. */ + private int calloutPos = 0; + /** The path to use for graphical callout decorations. */ + private String graphicsPath = null; + /** The extension to use for graphical callout decorations. */ + private String graphicsExt = null; + /** The largest callout number that can be represented graphically. */ + private int graphicsMax = 10; + /** Should graphic callouts use fo:external-graphics or imgs. */ + private boolean graphicsFO = false; + + private static final String foURI = "http://www.w3.org/1999/XSL/Format"; + private static final String xhURI = "http://www.w3.org/1999/xhtml"; + + /** + *

                  Constructor for Verbatim

                  + * + *

                  All of the methods are static, so the constructor does nothing.

                  + */ + public Verbatim() { + } + + /** + *

                  Number lines in a verbatim environment.

                  + * + *

                  This method adds line numbers to a result tree fragment. Each + * newline that occurs in a text node is assumed to start a new line. + * The first line is always numbered, every subsequent xalanMod line + * is numbered (so if xalanMod=5, lines 1, 5, 10, 15, etc. will be + * numbered. If there are fewer than xalanMod lines in the environment, + * every line is numbered.

                  + * + *

                  xalanMod is taken from the $linenumbering.everyNth parameter.

                  + * + *

                  Every line number will be right justified in a string xalanWidth + * characters long. If the line number of the last line in the + * environment is too long to fit in the specified width, the width + * is automatically increased to the smallest value that can hold the + * number of the last line. (In other words, if you specify the value 2 + * and attempt to enumerate the lines of an environment that is 100 lines + * long, the value 3 will automatically be used for every line in the + * environment.)

                  + * + *

                  xalanWidth is taken from the $linenumbering.width parameter.

                  + * + *

                  The xalanSep string is inserted between the line + * number and the original program listing. Lines that aren't numbered + * are preceded by a xalanWidth blank string and the separator.

                  + * + *

                  xalanSep is taken from the $linenumbering.separator parameter.

                  + * + *

                  If inline markup extends across line breaks, markup changes are + * required. All the open elements are closed before the line break and + * "reopened" afterwards. The reopened elements will have the same + * attributes as the originals, except that 'name' and 'id' attributes + * are not duplicated.

                  + * + * @param context + * @param xalanNI + * + * @return The modified result tree fragment. + */ + public DocumentFragment numberLines (ExpressionContext context, + NodeIterator xalanNI) { + + int xalanMod = Params.getInt(context, "linenumbering.everyNth"); + int xalanWidth = Params.getInt(context, "linenumbering.width"); + String xalanSep = Params.getString(context, "linenumbering.separator"); + + DocumentFragment xalanRTF = (DocumentFragment) xalanNI.nextNode(); + int numLines = countLineBreaks(xalanRTF) + 1; + + DocumentBuilderFactory docFactory = DocumentBuilderFactory.newInstance(); + DocumentBuilder docBuilder = null; + + try { + docBuilder = docFactory.newDocumentBuilder(); + } catch (ParserConfigurationException e) { + System.out.println("PCE!"); + return xalanRTF; + } + Document doc = docBuilder.newDocument(); + DocumentFragment df = doc.createDocumentFragment(); + DOMBuilder db = new DOMBuilder(doc, df); + + elementStack = new Stack(); + lineNumber = 0; + modulus = numLines < xalanMod ? 1 : xalanMod; + width = xalanWidth; + separator = xalanSep; + + double log10numLines = Math.log(numLines) / Math.log(10); + + if (width < log10numLines + 1) { + width = (int) Math.floor(log10numLines + 1); + } + + lineNumberFragment(db, xalanRTF); + return df; + } + + /** + *

                  Count the number of lines in a verbatim environment.

                  + * + *

                  This method walks over the nodes of a DocumentFragment and + * returns the number of lines breaks that it contains.

                  + * + * @param node The root of the tree walk over. + */ + private int countLineBreaks(Node node) { + int numLines = 0; + + if (node.getNodeType() == Node.DOCUMENT_FRAGMENT_NODE + || node.getNodeType() == Node.DOCUMENT_NODE + || node.getNodeType() == Node.ELEMENT_NODE) { + Node child = node.getFirstChild(); + while (child != null) { + numLines += countLineBreaks(child); + child = child.getNextSibling(); + } + } else if (node.getNodeType() == Node.TEXT_NODE) { + String text = node.getNodeValue(); + + // Walk through the text node looking for newlines + int pos = 0; + for (int count = 0; count < text.length(); count++) { + if (text.charAt(count) == '\n') { + numLines++; + } + } + } else { + // nop + } + + return numLines; + } + + /** + *

                  Build a DocumentFragment with numbered lines.

                  + * + *

                  This is the method that actually does the work of numbering + * lines in a verbatim environment. It recursively walks through a + * tree of nodes, copying the structure into the rtf. Text nodes + * are examined for new lines and modified as requested by the + * global line numbering parameters.

                  + * + *

                  When called, rtf should be an empty DocumentFragment and node + * should be the first child of the result tree fragment that contains + * the existing, formatted verbatim text.

                  + * + * @param rtf The resulting verbatim environment with numbered lines. + * @param node The root of the tree to copy. + */ + private void lineNumberFragment(DOMBuilder rtf, + Node node) { + try { + if (node.getNodeType() == Node.DOCUMENT_FRAGMENT_NODE + || node.getNodeType() == Node.DOCUMENT_NODE) { + Node child = node.getFirstChild(); + while (child != null) { + lineNumberFragment(rtf, child); + child = child.getNextSibling(); + } + } else if (node.getNodeType() == Node.ELEMENT_NODE) { + String ns = node.getNamespaceURI(); + String localName = node.getLocalName(); + String name = ((Element) node).getTagName(); + + rtf.startElement(ns, localName, name, + copyAttributes((Element) node)); + + elementStack.push(node); + + Node child = node.getFirstChild(); + while (child != null) { + lineNumberFragment(rtf, child); + child = child.getNextSibling(); + } + } else if (node.getNodeType() == Node.TEXT_NODE) { + String text = node.getNodeValue(); + + if (lineNumber == 0) { + // The first line is always numbered + formatLineNumber(rtf, ++lineNumber); + } + + // Walk through the text node looking for newlines + char chars[] = text.toCharArray(); + int pos = 0; + for (int count = 0; count < text.length(); count++) { + if (text.charAt(count) == '\n') { + // This is the tricky bit; if we find a newline, make sure + // it doesn't occur inside any markup. + + if (pos > 0) { + rtf.characters(chars, 0, pos); + pos = 0; + } + + closeOpenElements(rtf); + + // Copy the newline to the output + chars[pos++] = text.charAt(count); + rtf.characters(chars, 0, pos); + pos = 0; + + // Add the line number + formatLineNumber(rtf, ++lineNumber); + + openClosedElements(rtf); + } else { + chars[pos++] = text.charAt(count); + } + } + + if (pos > 0) { + rtf.characters(chars, 0, pos); + } + } else if (node.getNodeType() == Node.COMMENT_NODE) { + String text = node.getNodeValue(); + char chars[] = text.toCharArray(); + rtf.comment(chars, 0, text.length()); + } else if (node.getNodeType() == Node.PROCESSING_INSTRUCTION_NODE) { + rtf.processingInstruction(node.getNodeName(), node.getNodeValue()); + } else { + System.out.println("Warning: unexpected node type in lineNumberFragment"); + } + + if (node.getNodeType() == Node.ELEMENT_NODE) { + String ns = node.getNamespaceURI(); + String localName = node.getLocalName(); + String name = ((Element) node).getTagName(); + rtf.endElement(ns, localName, name); + elementStack.pop(); + } + } catch (SAXException e) { + System.out.println("SAX Exception in lineNumberFragment"); + } + } + + /** + *

                  Add a formatted line number to the result tree fragment.

                  + * + *

                  This method examines the global parameters that control line + * number presentation (modulus, width, and separator) and adds + * the appropriate text to the result tree fragment.

                  + * + * @param rtf The resulting verbatim environment with numbered lines. + * @param lineNumber The number of the current line. + */ + private void formatLineNumber(DOMBuilder rtf, + int lineNumber) { + char ch = 160; + String lno = ""; + if (lineNumber == 1 + || (modulus >= 1 && (lineNumber % modulus == 0))) { + lno = "" + lineNumber; + } + + while (lno.length() < width) { + lno = ch + lno; + } + + lno += separator; + + char chars[] = lno.toCharArray(); + try { + rtf.characters(chars, 0, lno.length()); + } catch (SAXException e) { + System.out.println("SAX Exception in formatLineNumber"); + } + } + + /** + *

                  Insert text callouts into a verbatim environment.

                  + * + *

                  This method examines the areaset and area elements + * in the supplied areaspec and decorates the supplied + * result tree fragment with appropriate callout markers.

                  + * + *

                  If a label attribute is supplied on an area, + * its content will be used for the label, otherwise the callout + * number will be used, surrounded by parenthesis. Callouts are + * numbered in document order. All of the areas in an + * areaset get the same number.

                  + * + *

                  Only the linecolumn and linerange units are + * supported. If no unit is specifed, linecolumn is assumed. + * If only a line is specified, the callout decoration appears in + * the defaultColumn. Lines will be padded with blanks to reach the + * necessary column, but callouts that are located beyond the last + * line of the verbatim environment will be ignored.

                  + * + *

                  Callouts are inserted before the character at the line/column + * where they are to occur.

                  + * + * @param areaspecNodeSet The source node set that contains the areaspec. + * @param xalanRTF The result tree fragment of the verbatim environment. + * @param defaultColumn The column for callouts that specify only a line. + * + * @return The modified result tree fragment. */ + + /** + *

                  Insert graphical callouts into a verbatim environment.

                  + * + *

                  This method examines the areaset and area elements + * in the supplied areaspec and decorates the supplied + * result tree fragment with appropriate callout markers.

                  + * + *

                  If a label attribute is supplied on an area, + * its content will be used for the label, otherwise the callout + * number will be used. Callouts are + * numbered in document order. All of the areas in an + * areaset get the same number.

                  + * + *

                  If the callout number is not greater than gMax, the + * callout generated will be:

                  + * + * 
                  +   * <img src="$gPath/conumber$gExt" alt="conumber">
+   *
                  + * + *

                  Otherwise, it will be the callout number surrounded by + * parenthesis.

                  + * + *

                  Only the linecolumn and linerange units are + * supported. If no unit is specifed, linecolumn is assumed. + * If only a line is specified, the callout decoration appears in + * the defaultColumn. Lines will be padded with blanks to reach the + * necessary column, but callouts that are located beyond the last + * line of the verbatim environment will be ignored.

                  + * + *

                  Callouts are inserted before the character at the line/column + * where they are to occur.

                  + * + * @param context + * @param areaspecNodeSet The source node set that contains the areaspec. + * @param xalanNI + * + * @return The modified result tree fragment. + */ + public DocumentFragment insertCallouts (ExpressionContext context, + NodeIterator areaspecNodeSet, + NodeIterator xalanNI) { + String type = Params.getString(context, "stylesheet.result.type"); + boolean useFO = type.equals("fo"); + int defaultColumn = Params.getInt(context, "callout.defaultcolumn"); + + if (Params.getBoolean(context, "callout.graphics")) { + String gPath = Params.getString(context, "callout.graphics.path"); + String gExt = Params.getString(context, "callout.graphics.extension"); + int gMax = Params.getInt(context, "callout.graphics.number.limit"); + return insertGraphicCallouts(areaspecNodeSet, xalanNI, defaultColumn, + gPath, gExt, gMax, useFO); + } else if (Params.getBoolean(context, "callout.unicode")) { + int uStart = Params.getInt(context, "callout.unicode.start.character"); + int uMax = Params.getInt(context, "callout.unicode.number.limit"); + String uFont = Params.getString(context, "callout.unicode.font"); + return insertUnicodeCallouts(areaspecNodeSet, xalanNI, defaultColumn, + uFont, uStart, uMax, useFO); + } else if (Params.getBoolean(context, "callout.dingbats")) { + int dMax = 10; + return insertDingbatCallouts(areaspecNodeSet, xalanNI, defaultColumn, + dMax, useFO); + } else { + return insertTextCallouts(areaspecNodeSet, xalanNI, defaultColumn, useFO); + } + } + + public DocumentFragment insertGraphicCallouts (NodeIterator areaspecNodeSet, + NodeIterator xalanNI, + int defaultColumn, + String gPath, + String gExt, + int gMax, + boolean useFO) { + FormatGraphicCallout fgc = new FormatGraphicCallout(gPath,gExt,gMax,useFO); + return insertCallouts(areaspecNodeSet, xalanNI, defaultColumn, fgc); + } + + public DocumentFragment insertUnicodeCallouts (NodeIterator areaspecNodeSet, + NodeIterator xalanNI, + int defaultColumn, + String uFont, + int uStart, + int uMax, + boolean useFO) { + FormatUnicodeCallout fuc = new FormatUnicodeCallout(uFont, uStart, uMax, useFO); + return insertCallouts(areaspecNodeSet, xalanNI, defaultColumn, fuc); + } + + public DocumentFragment insertDingbatCallouts (NodeIterator areaspecNodeSet, + NodeIterator xalanNI, + int defaultColumn, + int gMax, + boolean useFO) { + FormatDingbatCallout fdc = new FormatDingbatCallout(gMax,useFO); + return insertCallouts(areaspecNodeSet, xalanNI, defaultColumn, fdc); + } + + public DocumentFragment insertTextCallouts (NodeIterator areaspecNodeSet, + NodeIterator xalanNI, + int defaultColumn, + boolean useFO) { + FormatTextCallout ftc = new FormatTextCallout(useFO); + return insertCallouts(areaspecNodeSet, xalanNI, defaultColumn, ftc); + } + + public DocumentFragment insertCallouts (NodeIterator areaspecNodeSet, + NodeIterator xalanNI, + int defaultColumn, + FormatCallout fCallout) { + + DocumentFragment xalanRTF = (DocumentFragment) xalanNI.nextNode(); + + callout = new Callout[10]; + calloutCount = 0; + calloutPos = 0; + lineNumber = 1; + colNumber = 1; + + // First we walk through the areaspec to calculate the position + // of the callouts + // + // + // + // + // + // + // + // + int pos = 0; + int coNum = 0; + boolean inAreaSet = false; + Node node = areaspecNodeSet.nextNode(); + node = node.getFirstChild(); + while (node != null) { + if (node.getNodeType() == Node.ELEMENT_NODE) { + if (node.getNodeName().equals("areaset")) { + coNum++; + Node area = node.getFirstChild(); + while (area != null) { + if (area.getNodeType() == Node.ELEMENT_NODE) { + if (area.getNodeName().equals("area")) { + addCallout(coNum, area, defaultColumn); + } else { + System.out.println("Unexpected element in areaset: " + + area.getNodeName()); + } + } + area = area.getNextSibling(); + } + } else if (node.getNodeName().equalsIgnoreCase("area")) { + coNum++; + addCallout(coNum, node, defaultColumn); + } else { + System.out.println("Unexpected element in areaspec: " + + node.getNodeName()); + } + } + + node = node.getNextSibling(); + } + + // Now sort them + java.util.Arrays.sort(callout, 0, calloutCount); + + DocumentBuilderFactory docFactory = DocumentBuilderFactory.newInstance(); + DocumentBuilder docBuilder = null; + + try { + docBuilder = docFactory.newDocumentBuilder(); + } catch (ParserConfigurationException e) { + System.out.println("PCE 2!"); + return xalanRTF; + } + Document doc = docBuilder.newDocument(); + DocumentFragment df = doc.createDocumentFragment(); + DOMBuilder db = new DOMBuilder(doc, df); + + elementStack = new Stack(); + calloutFragment(db, xalanRTF, fCallout); + return df; + } + + /** + *

                  Build a FragmentValue with callout decorations.

                  + * + *

                  This is the method that actually does the work of adding + * callouts to a verbatim environment. It recursively walks through a + * tree of nodes, copying the structure into the rtf. Text nodes + * are examined for the position of callouts as described by the + * global callout parameters.

                  + * + *

                  When called, rtf should be an empty FragmentValue and node + * should be the first child of the result tree fragment that contains + * the existing, formatted verbatim text.

                  + * + * @param rtf The resulting verbatim environment with numbered lines. + * @param node The root of the tree to copy. + */ + private void calloutFragment(DOMBuilder rtf, + Node node, + FormatCallout fCallout) { + try { + if (node.getNodeType() == Node.DOCUMENT_FRAGMENT_NODE + || node.getNodeType() == Node.DOCUMENT_NODE) { + Node child = node.getFirstChild(); + while (child != null) { + calloutFragment(rtf, child, fCallout); + child = child.getNextSibling(); + } + } else if (node.getNodeType() == Node.ELEMENT_NODE) { + String ns = node.getNamespaceURI(); + String localName = node.getLocalName(); + String name = ((Element) node).getTagName(); + + rtf.startElement(ns, localName, name, + copyAttributes((Element) node)); + + elementStack.push(node); + + Node child = node.getFirstChild(); + while (child != null) { + calloutFragment(rtf, child, fCallout); + child = child.getNextSibling(); + } + } else if (node.getNodeType() == Node.TEXT_NODE) { + String text = node.getNodeValue(); + + char chars[] = text.toCharArray(); + int pos = 0; + for (int count = 0; count < text.length(); count++) { + if (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() == colNumber) { + + if (pos > 0) { + rtf.characters(chars, 0, pos); + pos = 0; + } + + closeOpenElements(rtf); + + while (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() == colNumber) { + fCallout.formatCallout(rtf, callout[calloutPos]); + calloutPos++; + } + + openClosedElements(rtf); + } + + if (text.charAt(count) == '\n') { + // What if we need to pad this line? + if (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() > colNumber) { + + if (pos > 0) { + rtf.characters(chars, 0, pos); + pos = 0; + } + + closeOpenElements(rtf); + + while (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() > colNumber) { + formatPad(rtf, callout[calloutPos].getColumn() - colNumber); + colNumber = callout[calloutPos].getColumn(); + while (calloutPos < calloutCount + && callout[calloutPos].getLine() == lineNumber + && callout[calloutPos].getColumn() == colNumber) { + fCallout.formatCallout(rtf, callout[calloutPos]); + calloutPos++; + } + } + + openClosedElements(rtf); + } + + lineNumber++; + colNumber = 1; + } else { + colNumber++; + } + chars[pos++] = text.charAt(count); + } + + if (pos > 0) { + rtf.characters(chars, 0, pos); + } + } else if (node.getNodeType() == Node.COMMENT_NODE) { + String text = node.getNodeValue(); + char chars[] = text.toCharArray(); + rtf.comment(chars, 0, text.length()); + } else if (node.getNodeType() == Node.PROCESSING_INSTRUCTION_NODE) { + rtf.processingInstruction(node.getNodeName(), node.getNodeValue()); + } else { + System.out.println("Warning: unexpected node type in calloutFragment: " + node.getNodeType() + ": " + node.getNodeName()); + } + + if (node.getNodeType() == Node.ELEMENT_NODE) { + String ns = node.getNamespaceURI(); + String localName = node.getLocalName(); + String name = ((Element) node).getTagName(); + rtf.endElement(ns, localName, name); + elementStack.pop(); + } else { + // nop + } + } catch (SAXException e) { + System.out.println("SAX Exception in calloutFragment"); + } + } + + /** + *

                  Add a callout to the global callout array

                  + * + *

                  This method examines a callout area and adds it to + * the global callout array if it can be interpreted.

                  + * + *

                  Only the linecolumn and linerange units are + * supported. If no unit is specifed, linecolumn is assumed. + * If only a line is specified, the callout decoration appears in + * the defaultColumn.

                  + * + * @param coNum The callout number. + * @param node The area. + * @param defaultColumn The default column for callouts. + */ + private void addCallout (int coNum, + Node node, + int defaultColumn) { + Element area = (Element) node; + + String units = area.getAttribute("units"); + String otherUnits = area.getAttribute("otherunits"); + String coords = area.getAttribute("coords"); + int type = 0; + String otherType = null; + + if ("".equals(units) || units.equals("linecolumn")) { + type = Callout.LINE_COLUMN; // the default + } else if (units.equals("linerange")) { + type = Callout.LINE_RANGE; + } else if (units.equals("linecolumnpair")) { + type = Callout.LINE_COLUMN_PAIR; + } else if (units.equals("calspair")) { + type = Callout.CALS_PAIR; + } else { + type = Callout.OTHER; + otherType = otherUnits; + } + + if (type != Callout.LINE_COLUMN + && type != Callout.LINE_RANGE) { + System.out.println("Only linecolumn and linerange units are supported"); + return; + } + + if (coords == null) { + System.out.println("Coords must be specified"); + return; + } + + // Now let's see if we can interpret the coordinates... + StringTokenizer st = new StringTokenizer(coords); + int tokenCount = 0; + int c1 = 0; + int c2 = 0; + while (st.hasMoreTokens()) { + tokenCount++; + if (tokenCount > 2) { + System.out.println("Unparseable coordinates"); + return; + } + try { + String token = st.nextToken(); + int coord = Integer.parseInt(token); + c2 = coord; + if (tokenCount == 1) { + c1 = coord; + } + } catch (NumberFormatException e) { + System.out.println("Unparseable coordinate"); + return; + } + } + + // Make sure we aren't going to blow past the end of our array + if (calloutCount == callout.length) { + Callout bigger[] = new Callout[calloutCount+10]; + for (int count = 0; count < callout.length; count++) { + bigger[count] = callout[count]; + } + callout = bigger; + } + + // Ok, add the callout + if (tokenCount == 2) { + if (type == Callout.LINE_RANGE) { + for (int count = c1; count <= c2; count++) { + callout[calloutCount++] = new Callout(coNum, area, + count, defaultColumn, + type); + } + } else { + // assume linecolumn + callout[calloutCount++] = new Callout(coNum, area, c1, c2, type); + } + } else { + // if there's only one number, assume it's the line + callout[calloutCount++] = new Callout(coNum, area, c1, defaultColumn, type); + } + } + + /** + *

                  Add blanks to the result tree fragment.

                  + * + *

                  This method adds numBlanks to the result tree fragment. + * It's used to pad lines when callouts occur after the last existing + * characater in a line.

                  + * + * @param rtf The resulting verbatim environment with numbered lines. + * @param numBlanks The number of blanks to add. + */ + private void formatPad(DOMBuilder rtf, + int numBlanks) { + char chars[] = new char[numBlanks]; + for (int count = 0; count < numBlanks; count++) { + chars[count] = ' '; + } + + try { + rtf.characters(chars, 0, numBlanks); + } catch (SAXException e) { + System.out.println("SAX Exception in formatCallout"); + } + } + + private void closeOpenElements(DOMBuilder rtf) + throws SAXException { + // Close all the open elements... + tempStack = new Stack(); + while (!elementStack.empty()) { + Node elem = (Node) elementStack.pop(); + + String ns = elem.getNamespaceURI(); + String localName = elem.getLocalName(); + String name = ((Element) elem).getTagName(); + + // If this is the bottom of the stack and it's an fo:block + // or an HTML pre or div, don't duplicate it... + if (elementStack.empty() + && (((ns != null) + && ns.equals(foURI) + && localName.equals("block")) + || (((ns == null) + && localName.equalsIgnoreCase("pre")) + || ((ns != null) + && ns.equals(xhURI) + && localName.equals("pre"))) + || (((ns == null) + && localName.equalsIgnoreCase("div")) + || ((ns != null) + && ns.equals(xhURI) + && localName.equals("div"))))) { + elementStack.push(elem); + break; + } else { + rtf.endElement(ns, localName, name); + tempStack.push(elem); + } + } + } + + private void openClosedElements(DOMBuilder rtf) + throws SAXException { + // Now "reopen" the elements that we closed... + while (!tempStack.empty()) { + Node elem = (Node) tempStack.pop(); + + String ns = elem.getNamespaceURI(); + String localName = elem.getLocalName(); + String name = ((Element) elem).getTagName(); + NamedNodeMap domAttr = elem.getAttributes(); + + AttributesImpl attr = new AttributesImpl(); + for (int acount = 0; acount < domAttr.getLength(); acount++) { + Node a = domAttr.item(acount); + + if (((ns == null || ns == "http://www.w3.org/1999/xhtml") + && localName.equalsIgnoreCase("a")) + || (a.getLocalName().equalsIgnoreCase("id"))) { + // skip this attribute + } else { + attr.addAttribute(a.getNamespaceURI(), + a.getLocalName(), + a.getNodeName(), + "CDATA", + a.getNodeValue()); + } + } + + rtf.startElement(ns, localName, name, attr); + elementStack.push(elem); + } + + tempStack = null; + } + + private Attributes copyAttributes(Element node) { + AttributesImpl attrs = new AttributesImpl(); + NamedNodeMap nnm = node.getAttributes(); + for (int count = 0; count < nnm.getLength(); count++) { + Attr attr = (Attr) nnm.item(count); + String name = attr.getName(); + if (name.startsWith("xmlns:") || name.equals("xmlns")) { + // Skip it; (don't ya just love it!!) + } else { + attrs.addAttribute(attr.getNamespaceURI(), attr.getName(), + attr.getName(), "CDATA", attr.getValue()); + } + } + return attrs; + } +} diff --git a/src/documentation/docbook-xsl/fo/admon.xsl b/src/documentation/docbook-xsl/fo/admon.xsl new file mode 100644 index 0000000000..a25f6370e4 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/admon.xsl @@ -0,0 +1,126 @@ + + + + + + + + + + + + + + + + + + + 36pt + + + + + + + + + note + warning + caution + tip + important + note + + + + + + + + + + url( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/autoidx-ng.xsl b/src/documentation/docbook-xsl/fo/autoidx-ng.xsl new file mode 100644 index 0000000000..0f84c79436 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/autoidx-ng.xsl @@ -0,0 +1,20 @@ + + + + + + + + +kosek + + diff --git a/src/documentation/docbook-xsl/fo/autoidx.xsl b/src/documentation/docbook-xsl/fo/autoidx.xsl new file mode 100644 index 0000000000..bb6bec1fc0 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/autoidx.xsl @@ -0,0 +1,1500 @@ + + + + + + + + + + + + + + +]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ERROR: the 'kosek' index method does not + work with the xsltproc XSLT processor. + + + + + + + ERROR: the 'kosek' index method requires the + exslt:node-set() function. Use a processor that + has it, or use a different index method. + + + + + + ERROR: the 'kosek' index method requires the + index extension functions be imported: + xsl:import href="common/autoidx-ng.xsl" + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ERROR: the 'kimber' index method requires the + Saxon version 6 XSLT processor. + + + + + + ERROR: the 'kimber' index method requires the + Innodata Isogen Java extensions for + internationalized indexes. Install those + extensions, or use a different index method. + For more information, see: + http://www.innodata-isogen.com/knowledge_center/tools_downloads/i18nsupport + + + + + + ERROR: the 'kimber' index method requires the + index extension functions be imported: + xsl:import href="common/autoidx-ng.xsl" + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + true + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + true + + + + + + + + + + + + + + + + , + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + true + + + + + + + + + + + + + + + + + , + + , + + + + + + + + + , + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ( + + + + + + ) + + + + + + + + + + + + ( + + + + + + ) + + + + + + + + + + + + + + + + + <index> + + <indexdiv> + <title> + + + + </title> + + + + + + + </indexdiv> + + + + + + + + + </index> + + + + + + + + < + + > + + + + + + + + + + + + + <indexdiv> + <title> + + </title> + + + + + + + + </indexdiv> + + + + + + + + + + + + + + + + + + + + + + + + + <indexentry> + <primaryie> + <phrase> + + + + </phrase> + , + + + + + + + + + + + </primaryie> + + + + + + + + + + + + + + + + + + + + + + + + </indexentry> + + + + + + + + + + + <secondaryie> + <phrase> + + + + </phrase> + , + + + + + + + + + + + </secondaryie> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <tertiaryie> + <phrase> + + + + </phrase> + , + + + + + + + + + + + </tertiaryie> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <phrase role="pageno"> + <link linkend=" + + "> + + + - + + + </link> + </phrase> + + + <phrase role="pageno"> + + <link linkend=" + + "> + + + + + + </link> + + </phrase> + + + + + + + + + + + + + + + + + + + + + + + <phrase fole="pageno"> + + <link linkend=" + + "> + + + + + + </link> + + </phrase> + + + + + + + + + + + + + + + + + + + <phrase role="pageno"> + + <link linkend=" + + "> + + + + + + </link> + + </phrase> + + + + + + + + + + <seeie> + <phrase> + + + + </phrase> + </seeie> + + + + + + + + + <seealsoie> + <phrase> + + + + </phrase> + </seealsoie> + + + + + + + + + + + + + &lt; + + + + + + + + &amp; + + + + + + + + &lt; + + + + + + + + &amp; + + + + + + + + + + + + + + + + + + + + + + + + + + + + index + term-separator + + + + + + + + + + + + + + index + number-separator + + + + + + + + + + + + + + index + range-separator + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/autotoc.xsl b/src/documentation/docbook-xsl/fo/autotoc.xsl new file mode 100644 index 0000000000..ca4894369a --- /dev/null +++ b/src/documentation/docbook-xsl/fo/autotoc.xsl @@ -0,0 +1,773 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + false + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + false + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/axf.xsl b/src/documentation/docbook-xsl/fo/axf.xsl new file mode 100644 index 0000000000..76099b0080 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/axf.xsl @@ -0,0 +1,86 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + author + + + + + + + + + + + + + + + + + + + + + keywords + + + + + , + + + + + + + + + subject + + + + + , + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/biblio.xsl b/src/documentation/docbook-xsl/fo/biblio.xsl new file mode 100644 index 0000000000..62e73d3fb4 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/biblio.xsl @@ -0,0 +1,1157 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No bibliography entry: + + found in + + + + Error: no bibliography entry: + + found in + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No bibliography entry: + + found in + + + + Error: no bibliography entry: + + found in + + + + + + + + + + + + + + + + + + + + [ + + ] + + + [ + + ] + + + [ + + ] + + + [ + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + copyright + + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/block.xsl b/src/documentation/docbook-xsl/fo/block.xsl new file mode 100644 index 0000000000..32fa87fbf4 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/block.xsl @@ -0,0 +1,620 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + + + + + + + + + + + + — + + + + + + + + + + + + + -- + + + + + + + + + + + + + + + + + + 0pt + 0pt + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0pt + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0pt + 0.5em + 0pt + + + + + 0.5em + 0pt + 0pt + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0pt + 0.5em + 0pt + + + + + 0.5em + 0pt + 0pt + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/callout.xsl b/src/documentation/docbook-xsl/fo/callout.xsl new file mode 100644 index 0000000000..6e8aaec1af --- /dev/null +++ b/src/documentation/docbook-xsl/fo/callout.xsl @@ -0,0 +1,233 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Don't know how to do callouts with + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Error: coref link is broken: + + + + + + Error: coref doesn't point to a co: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + url( + + ) + + + + + + + + + + + + ❶ + ❷ + ❸ + ❹ + ❺ + ❻ + ❼ + ❽ + ❾ + ❿ + + + + + Don't know how to generate Unicode callouts + when $callout.unicode.start.character is + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/component.xsl b/src/documentation/docbook-xsl/fo/component.xsl new file mode 100644 index 0000000000..cde9a35eec --- /dev/null +++ b/src/documentation/docbook-xsl/fo/component.xsl @@ -0,0 +1,761 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 6 + 5 + 4 + 3 + 2 + 1 + + + + + + + + + + + + + inherit + + + + + + + + + + + + + + + + + + + + + false + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + false + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/division.xsl b/src/documentation/docbook-xsl/fo/division.xsl new file mode 100644 index 0000000000..917f46f352 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/division.xsl @@ -0,0 +1,957 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + false + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/docbook.xsl b/src/documentation/docbook-xsl/fo/docbook.xsl new file mode 100644 index 0000000000..a1167bb54a --- /dev/null +++ b/src/documentation/docbook-xsl/fo/docbook.xsl @@ -0,0 +1,296 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + encountered + + in + + + , but no template matches. + + + < + + > + + </ + + > + + + + + + + + + + + + + + + + + + + + + + + ID ' + + ' not found in document. + + + + + ERROR: Document root element ($rootid= + + ) for FO output + must be one of the following elements: + + + + + + + + + + + + + + + + + + + + + ERROR: Document root element for FO output + must be one of the following elements: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [could not find document title] + + + + + + false + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Making + + pages on + + paper ( + + x + + ) + + + + + + diff --git a/src/documentation/docbook-xsl/fo/docbookng.xsl b/src/documentation/docbook-xsl/fo/docbookng.xsl new file mode 100644 index 0000000000..a201338eee --- /dev/null +++ b/src/documentation/docbook-xsl/fo/docbookng.xsl @@ -0,0 +1,8 @@ + + + + + + diff --git a/src/documentation/docbook-xsl/fo/ebnf.xsl b/src/documentation/docbook-xsl/fo/ebnf.xsl new file mode 100644 index 0000000000..d8569d85ba --- /dev/null +++ b/src/documentation/docbook-xsl/fo/ebnf.xsl @@ -0,0 +1,325 @@ + + + + + + + + +$Id: ebnf.xsl,v 1.6 2005/08/09 09:30:43 bobstayton Exp $ + +Walsh +Norman +199920002001 +Norman Walsh + + +HTML EBNF Reference + + +
                  Introduction + +This is technical reference documentation for the DocBook XSL +Stylesheets; it documents (some of) the parameters, templates, and +other elements of the stylesheets. + +This reference describes the templates and parameters relevant +to formatting EBNF markup. + +This is not intended to be user documentation. +It is provided for developers writing customization layers for the +stylesheets, and for anyone who's interested in how it +works. + +Although I am trying to be thorough, this documentation is known +to be incomplete. Don't forget to read the source, too :-) +
                  +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [ + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + + Error: no ID for productionrecap linkend: + + . + + + + + + Warning: multiple "IDs" for productionrecap linkend: + + . + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + production + + + + + + + + + Non-terminals with no content must point to + production elements in the current document. + + + Invalid xpointer for empty nt: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ??? + + + + + + + + + + + + + /*  + +  */ + + + + + + + + + + constraintdef + + + + + + + + + + + + + + [  + + + + + : + + + + + + + : + + + + + + + + + +  ] + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/fo/fo-patch-for-fop.xsl b/src/documentation/docbook-xsl/fo/fo-patch-for-fop.xsl new file mode 100644 index 0000000000..75854848a6 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/fo-patch-for-fop.xsl @@ -0,0 +1,64 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + % + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/fo-rtf.xsl b/src/documentation/docbook-xsl/fo/fo-rtf.xsl new file mode 100644 index 0000000000..25f52cea95 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/fo-rtf.xsl @@ -0,0 +1,154 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/fo.xsl b/src/documentation/docbook-xsl/fo/fo.xsl new file mode 100644 index 0000000000..090c54f783 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/fo.xsl @@ -0,0 +1,71 @@ + + + + + + + + + + + + + + + + + + + + bullet + + + o + © + ™ + ™ + ® + (SM) + " + " + ' + ' + — + - + o + + + + + + + + + + + + + + + + + + + # + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/footnote.xsl b/src/documentation/docbook-xsl/fo/footnote.xsl new file mode 100644 index 0000000000..9dd1a4bf6d --- /dev/null +++ b/src/documentation/docbook-xsl/fo/footnote.xsl @@ -0,0 +1,186 @@ + + + + + + + + + + + super + + + super + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: footnote number may not be generated + correctly; + + unexpected as first child of footnote. + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/fop.xsl b/src/documentation/docbook-xsl/fo/fop.xsl new file mode 100644 index 0000000000..83c8ab01cd --- /dev/null +++ b/src/documentation/docbook-xsl/fo/fop.xsl @@ -0,0 +1,89 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/fop1.xsl b/src/documentation/docbook-xsl/fo/fop1.xsl new file mode 100644 index 0000000000..4e262e57c7 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/fop1.xsl @@ -0,0 +1,71 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/formal.xsl b/src/documentation/docbook-xsl/fo/formal.xsl new file mode 100644 index 0000000000..4aa01898d9 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/formal.xsl @@ -0,0 +1,550 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + always + + + always + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Broken table: tr descendent of CALS Table. + The text in the first tr is: + + + + + + Broken table: row descendent of HTML table. + The text in the first row is: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/glossary.xsl b/src/documentation/docbook-xsl/fo/glossary.xsl new file mode 100644 index 0000000000..e5ba9e4c4d --- /dev/null +++ b/src/documentation/docbook-xsl/fo/glossary.xsl @@ -0,0 +1,956 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: processing automatic glossary + without a glossary.collection file. + + + + + + Warning: processing automatic glossary but unable to + open glossary.collection file ' + + ' + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: processing automatic glossary + without a glossary.collection file. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: processing automatic glossary + without a glossary.collection file. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 1 + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + , + + + + + , + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: glosssee @otherterm reference not found: + + + + + + + + + + + + + + + . + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: glossseealso @otherterm reference not found: + + + + + + + + + + + + . + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 1 + + + + + + + + + + ( + + ) + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + , + + + + + , + + + + + , + + + + + + + + + + + + + + + + + + + + + + + Warning: glosssee @otherterm reference not found: + + + + + + + + + + + + + + + . + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: glossseealso @otherterm reference not found: + + + + + + + + + + + + . + + + , + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/graphics.xsl b/src/documentation/docbook-xsl/fo/graphics.xsl new file mode 100644 index 0000000000..1bcd7655c4 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/graphics.xsl @@ -0,0 +1,631 @@ + + + + ]> + + + + + + + + + + + + PNG PDF JPG JPEG linespecific + + + BMP GIF TIFF SVG PNG EPS JPG JPEG linespecific + + + BMP GIF TIFF SVG PNG EPS JPG JPEG linespecific + + + PNG PDF JPG JPEG linespecific GIF GIF87a GIF89a TIFF BMP + + + SVG PNG PDF JPG JPEG linespecific GIF GIF87a GIF89a TIFF BMP + + + PNG PDF JPG JPEG linespecific GIF GIF87a GIF89a TIFF BMP + + + + + + + 1 + + + + + + + png pdf jpg jpeg + + + bmp gif tif tiff svg png pdf jpg jpeg eps + + + bmp gif tif tiff svg png pdf jpg jpeg eps + + + png pdf jpg jpeg gif tif tiff bmp + + + svg png pdf jpg jpeg gif tif tiff bmp eps + + + svg png pdf jpg jpeg gif tif tiff bmp eps + + + + + + + + + 1 + + + + + + + + + + + + + + application/postscript + application/pdf + image/png + image/svg+xml + image/jpeg + image/gif + image/gif + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 0 + 0 + 0 + + 1 + 0 + + + + + + 0 + 1.0 + + + + 1.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + auto + + + + + + + + + + + + + + + + auto + + + + + + auto + + + + + + + + + + auto + + + + + + auto + + + + + + + + + + + + % + + scale-to-fit + auto + + + + + + auto + + + + + + + + + + + + % + + scale-to-fit + auto + + + + + + + + + + + + + + + + + + + + + + + + + before + center + after + auto + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Don't know how to insert files with + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Don't know how to insert files with + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No insertfile extension available. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/htmltbl.xsl b/src/documentation/docbook-xsl/fo/htmltbl.xsl new file mode 100644 index 0000000000..1e9a057f3b --- /dev/null +++ b/src/documentation/docbook-xsl/fo/htmltbl.xsl @@ -0,0 +1,235 @@ + + + + + + + + + bold + + + + + + + + + + + + + + + + + + + + + fixed + + + + + + + + + + + 100% + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/index.xsl b/src/documentation/docbook-xsl/fo/index.xsl new file mode 100644 index 0000000000..16f27e4842 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/index.xsl @@ -0,0 +1,479 @@ + + + + +]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + body + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + body + index + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +.tnacifingis + + + + + + + + + fo:wrapper + + + + + + + + + + + + + + , + + + + , + + + + + + + + + + + , + + + + , + + + + + + + + + + + + + + + + + + + + + + , + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ( + + + + + + ) + + + + + + + + + ( + + + + + + ) + + + + + + + + + ( + + + + + + ) + + + + + + + + + + + + + + + 3pc + 2pc + 1pc + + + ( + + + + + + ) + + + + + + + + + + + + + fo:block + fo:inline + + + + diff --git a/src/documentation/docbook-xsl/fo/info.xsl b/src/documentation/docbook-xsl/fo/info.xsl new file mode 100644 index 0000000000..32fb2b99cf --- /dev/null +++ b/src/documentation/docbook-xsl/fo/info.xsl @@ -0,0 +1,34 @@ + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/inline.xsl b/src/documentation/docbook-xsl/fo/inline.xsl new file mode 100644 index 0000000000..bec3a5b713 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/inline.xsl @@ -0,0 +1,1086 @@ + + +]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + XLink to nonexistent id: + + + ??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ltr + rtl + + + + + + + + + + + + + + + + + + + + ltr + rtl + + + + + + + + + + + + + + + + ltr + rtl + + + + + + + + + + + + + + + + + + + + + ltr + rtl + + + + + + + + + + + + + + + + + + + + + ltr + rtl + + + + + + + + + + + + + + + + + + + + + ltr + rtl + + + + + + + + + + + + + + + + + + + + + + ltr + rtl + + + + + + super + + + super + + + + + + + + + + + + + + + + + + + + + ltr + rtl + + + + + + sub + + + sub + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + , + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + There's no entry for + + in + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Error: no glossentry for glossterm: + + . + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + element + + + + + + + + + + + + + + + + + </ + + > + + + + + + + & + + ; + + + + + + + &# + + ; + + + + + + + % + + ; + + + + + + + <? + + > + + + + + + + <? + + ?> + + + + + + + < + + > + + + + + + + < + + /> + + + + + + + <!-- + + --> + + + + + + + + + + + + + + < + + > + + + + + + + + + + + + + - + - + - + + - + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [ + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/keywords.xsl b/src/documentation/docbook-xsl/fo/keywords.xsl new file mode 100644 index 0000000000..a41fb15d46 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/keywords.xsl @@ -0,0 +1,21 @@ + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/lists.xsl b/src/documentation/docbook-xsl/fo/lists.xsl new file mode 100644 index 0000000000..80c917d046 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/lists.xsl @@ -0,0 +1,1259 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + • + • + – + — + + + • + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1. + a. + i. + A. + I. + + + + Unexpected numeration: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + em + + + em * 0.60 + + + + + + + + + + + + + + em + + + em * 0.60 + + + + + + + + + 1em + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + 100% + + + + + + + + + + + auto + + + + + + fixed + + + + + + + + + + 1 + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + 1 + 1 + + + + + + + + + + + + + + + + + + + + 1 + 1 + + 1 + + + + + + + + + + + + + + + + + + + + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + 1 + 1 + 1 + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + • + + + + + . + + + + + + + + + + + + + + + + + + + + + + + + + + + • + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + : ??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ??? + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/math.xsl b/src/documentation/docbook-xsl/fo/math.xsl new file mode 100644 index 0000000000..518e3a5b37 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/math.xsl @@ -0,0 +1,118 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + $ + + + + $ + + + + + + + + + + + + + $$ + + + + $$ + + + + + + + + + Your equation is misplaced. It should be in inlineequation, equation or informalequation. + + + + + + + + + + + + + + 0 + 0 + 1 + + + + + + diff --git a/src/documentation/docbook-xsl/fo/pagesetup.xsl b/src/documentation/docbook-xsl/fo/pagesetup.xsl new file mode 100644 index 0000000000..89815bec20 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/pagesetup.xsl @@ -0,0 +1,2111 @@ + + + + + + + + + + , + + + + + + , + + + + + + + + + + + + - + + + + + + + + + + + + + - + + + + + + + + + + + + blank-body + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + fixed + no-repeat + center + center + + + + + + + + + + + + + + + + + titlepage-even + titlepage-odd + + + + + + + + + + + + + + + + lot-even + lot-odd + + + + + + + + + + + + + + + + front-even + front-odd + + + + + + + + + + + + + + + + body-even + body-odd + + + + + + + + + + + + + + + + back-even + back-odd + + + + + + + + + + + + + + + + index-even + index-odd + + + + + + + + + + + + + + + + + titlepage-even-draft + titlepage-odd-draft + + + + + + + + + + + + + + + + lot-even-draft + lot-odd-draft + + + + + + + + + + + + + + + + front-even-draft + front-odd-draft + + + + + + + + + + + + + + + + body-even-draft + body-odd-draft + + + + + + + + + + + + + + + + back-even-draft + back-odd-draft + + + + + + + + + + + + + + + + index-even-draft + index-odd-draft + + + + + + + + + + + + + + + + + + + + + + + + + + + + lot + front + front + back + back + back + index + back + body + + + + + -draft + + + + + + -draft + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0.5pt + solid + black + + + + + + + + + + 0.5pt + solid + black + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0pt + + + + + + 1 + 1 + 3 + + + + + + 3 + 3 + 1 + + + + + + + + + + + + + + proportional-column-width( + + header + + + ) + + + + + proportional-column-width( + + header + + + ) + + + + + proportional-column-width( + + header + + + ) + + + + + + + + + + + baseline + + + + + + + + + + + + + baseline + + + + + + + + + + + + + baseline + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Error: value in .column.widths at position is not a number. + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0pt + + + + + + 1 + 1 + 3 + + + + + + 3 + 3 + 1 + + + + + + + + + + + + + proportional-column-width( + + footer + + + ) + + + + + proportional-column-width( + + footer + + + ) + + + + + proportional-column-width( + + footer + + + ) + + + + + + + + + + + baseline + + + + + + + + + + + + + baseline + + + + + + + + + + + + + baseline + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + i + i + i + 1 + + + + + + + + + + + + + + auto-odd + 1 + + + auto-odd + 1 + 1 + auto-odd + + + + + + + auto + 1 + auto + 1 + 1 + auto + + + + + + + + + + + + end-on-even + + no-force + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/param.ent b/src/documentation/docbook-xsl/fo/param.ent new file mode 100644 index 0000000000..c003ea464d --- /dev/null +++ b/src/documentation/docbook-xsl/fo/param.ent @@ -0,0 +1,311 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/param.xml b/src/documentation/docbook-xsl/fo/param.xml new file mode 100644 index 0000000000..b826daeb4a --- /dev/null +++ b/src/documentation/docbook-xsl/fo/param.xml @@ -0,0 +1,10582 @@ + + + + +FO Parameter Reference + +$Id: param.xweb,v 1.114 2006/05/21 13:05:19 kosek Exp $ + + + Walsh + Norman + + + 1999 + 2000 + 2001 + Norman Walsh + + + +Introduction + +This is reference documentation for all user-configurable +parameters in the DocBook XSL FO stylesheets (for generating +XSL-FO output destined for final print/PDF otutput). + +This reference describes each of the XSL FO Stylesheet parameters. +These are the easily customizable parts of the stylesheet. +If you want to specify an alternate value for one or more of these +parameters, you can do so in a driver stylesheet. + +For example, if you want to change the html.stylesheet +to reference.css, you might create a driver +stylesheet like this: + +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + + <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/> + + <xsl:param name="html.stylesheet">reference.css</xsl:param> + +</xsl:stylesheet> + +Naturally, you have to change the +href attribute on +<xsl:import> to point to +docbook.xsl on your system. (Or +chunk.xsl, if you're using chunking.) + + + +Admonitions + + +admon.graphics +boolean + + +admon.graphics +Use graphics in admonitions? + + + + +<xsl:param name="admon.graphics" select="0"></xsl:param> + + + +Description + +If true (non-zero), admonitions are presented in an alternate style that uses +a graphic. Default graphics are provided in the distribution. + + + + + + + +admon.graphics.extension +string + + +admon.graphics.extension +Extension for admonition graphics + + + +<xsl:param name="admon.graphics.extension" select="'.png'"></xsl:param> + + +Description + +Sets the extension to use on admonition graphics. + + + + + + +admon.graphics.path +string + + +admon.graphics.path +Path to admonition graphics + + + +<xsl:param name="admon.graphics.path">images/</xsl:param> + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the admonition graphics. + + + + + + + +admon.textlabel +boolean + + +admon.textlabel +Use text label in admonitions? + + + + +<xsl:param name="admon.textlabel" select="1"></xsl:param> + + + +Description + +If true (non-zero), admonitions are presented with a generated +text label such as Note or Warning in the appropriate language. +If zero, such labels are turned off, but any title child +of the admonition element are still output. +The default value is 1. + + + + + + + + +admonition.title.properties +To set the style for admonitions titles. + + + + +<xsl:attribute-set name="admonition.title.properties"> + <xsl:attribute name="font-size">14pt</xsl:attribute> + <xsl:attribute name="font-weight">bold</xsl:attribute> + <xsl:attribute name="hyphenate">false</xsl:attribute> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> +</xsl:attribute-set> + + +Description +How do you want admonitions titles styled? +Set the font-size, weight etc to the style required. + + + + + + +admonition.properties +To set the style for admonitions. + + + +<xsl:attribute-set name="admonition.properties"></xsl:attribute-set> + + +Description +How do you want admonitions styled? +Set the font-size, weight, etc. to the style required + + + + + + +graphical.admonition.properties +To add properties to the outer block of a graphical admonition. + + + +<xsl:attribute-set name="graphical.admonition.properties"> + <xsl:attribute name="space-before.optimum">1em</xsl:attribute> + <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> + <xsl:attribute name="space-after.optimum">1em</xsl:attribute> + <xsl:attribute name="space-after.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-after.maximum">1.2em</xsl:attribute> +</xsl:attribute-set> + + +Description +These properties are added to the outer block containing the +entire graphical admonition, including its title. +It is used when the parameter +admon.graphics is set to nonzero. +Use this attribute-set to set the space above and below, +and any indent for the whole admonition. + +In addition to these properties, a graphical admonition +also applies the admonition.title.properties +attribute-set to the title, and applies the +admonition.properties attribute-set +to the rest of the content. + + + + + + +nongraphical.admonition.properties +To add properties to the outer block of a nongraphical admonition. + + + +<xsl:attribute-set name="nongraphical.admonition.properties"> + <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-before.optimum">1em</xsl:attribute> + <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> + <xsl:attribute name="margin-left">0.25in</xsl:attribute> + <xsl:attribute name="margin-right">0.25in</xsl:attribute> +</xsl:attribute-set> + + +Description +These properties are added to the outer block containing the +entire nongraphical admonition, including its title. +It is used when the parameter +admon.graphics is set to zero. +Use this attribute-set to set the space above and below, +and any indent for the whole admonition. + +In addition to these properties, a nongraphical admonition +also applies the admonition.title.properties +attribute-set to the title, and the +admonition.properties attribute-set +to the rest of the content. + + + + + + +Callouts + + +callout.defaultcolumn +integer + + +callout.defaultcolumn +Indicates what column callouts appear in by default + + + +<xsl:param name="callout.defaultcolumn" select="'60'"></xsl:param> + + +Description + +If a callout does not identify a column (for example, if it uses +the linerange unit), +it will appear in the default column. + + + + + + + +callout.graphics +boolean + + +callout.graphics +Use graphics for callouts? + + + + +<xsl:param name="callout.graphics" select="'1'"></xsl:param> + + + +Description + +If non-zero, callouts are presented with graphics (e.g., reverse-video +circled numbers instead of "(1)", "(2)", etc.). +Default graphics are provided in the distribution. + + + + + + + +callout.graphics.extension +string + + +callout.graphics.extension +Extension for callout graphics + + + +<xsl:param name="callout.graphics.extension" select="'.png'"></xsl:param> + + +Description + +Sets the extension to use on callout graphics. + + + + + + +callout.graphics.number.limit +integer + + +callout.graphics.number.limit +Number of the largest callout graphic + + + +<xsl:param name="callout.graphics.number.limit" select="'15'"></xsl:param> + + +Description + +If callout.graphics +is non-zero, graphics are used to represent +callout numbers. The value of +callout.graphics.number.limit +is +the largest number for which a graphic exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + + + + +callout.graphics.path +string + + +callout.graphics.path +Path to callout graphics + + + + +<xsl:param name="callout.graphics.path" select="'images/callouts/'"></xsl:param> + + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the callout graphics. + + + + + + + +callout.unicode +boolean + + +callout.unicode +Use Unicode characters rather than images for callouts. + + + +<xsl:param name="callout.unicode" select="0"></xsl:param> + + +Description + +The stylesheets can use either an image of the numbers one to ten, or the single Unicode character which represents the numeral, in white on a black background. Use this to select the Unicode character option. + + + + + + + +callout.unicode.font + + + +callout.unicode.font +Specify a font for Unicode glyphs + + + +<xsl:param name="callout.unicode.font" select="'ZapfDingbats'"></xsl:param> + + +Description + +The name of the font to specify around Unicode callout glyphs. +If set to the empty string, no font change will occur. + + + + + + + +callout.unicode.number.limit +integer + + +callout.unicode.number.limit +Number of the largest callout graphic + + + +<xsl:param name="callout.unicode.number.limit" select="'10'"></xsl:param> + + +Description + +If callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.number.limit +is +the largest number for which a unicode character exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + + + + +callout.unicode.start.character +integer + + +callout.unicode.start.character +First Unicode character to use, decimal value. + + + +<xsl:param name="callout.unicode.start.character" select="10102"></xsl:param> + + +Description + +If callout.graphics is zero and callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.start.character +is the decimal unicode value used for callout number one. Currently, +only 10102 is supported in the stylesheets for this parameter. + + + + + + + +callouts.extension +boolean + + +callouts.extension +Enable the callout extension + + + +<xsl:param name="callouts.extension" select="'1'"></xsl:param> + + +Description + +The callouts extension processes areaset +elements in ProgramListingCO and other text-based +callout elements. + + + + + + + +ToC/LoT/Index Generation + + +autotoc.label.separator +string + + +autotoc.label.separator +Separator between labels and titles in the ToC + + + +<xsl:param name="autotoc.label.separator" select="'. '"></xsl:param> + + +Description + +String to use to seperate labels and title in a table of contents. + + + + + + +process.empty.source.toc +boolean + + +process.empty.source.toc +Generate automated TOC if toc element occurs in a source document? + + + +<xsl:param name="process.empty.source.toc" select="0"></xsl:param> + + +Description + +Specifies that if an empty toc element is +found in a source document, an automated TOC is generated. + + Depending on what the value of the + generate.toc parameter is, setting this + parameter to 1 could result in generation of + duplicate automated TOCs. So the + process.empty.source.toc is primarily useful + as an "override": by placing an empty toc in your + document and setting this parameter to 1, you can + force a TOC to be generated even if generate.toc + says not to. + + + + + + + + +process.source.toc +boolean + + +process.source.toc +Process a non-empty toc element if it occurs in a source document? + + + +<xsl:param name="process.source.toc" select="0"></xsl:param> + + +Description + +Specifies that the contents of a non-empty "hard-coded" +toc element in a source document are processed to +generate a TOC in output. + + This parameter has no effect on automated generation of + TOCs. An automated TOC may still be generated along with the + "hard-coded" TOC. To suppress automated TOC generation, adjust the + value of the generate.toc paramameter. + + The process.source.toc parameter also has + no effect if the toc element is empty; handling + for empty toc is controlled by the + process.empty.source.toc parameter. + + + + + + + + +generate.toc +table + + +generate.toc +Control generation of ToCs and LoTs + + + + + +<xsl:param name="generate.toc"> +/appendix toc,title +article/appendix nop +/article toc,title +book toc,title,figure,table,example,equation +/chapter toc,title +part toc,title +/preface toc,title +reference toc,title +/sect1 toc +/sect2 toc +/sect3 toc +/sect4 toc +/sect5 toc +/section toc +set toc,title +</xsl:param> + + + +Description + +This parameter has a structured value. It is a table of space-delimited +path/value pairs. Each path identifies some element in the source document +using a restricted subset of XPath (only the implicit child axis, no wildcards, +no predicates). Paths can be either relative or absolute. + +When processing a particular element, the stylesheets consult this table to +determine if a ToC (or LoT(s)) should be generated. + +For example, consider the entry: + +book toc,figure + +This indicates that whenever a book is formatted, a +Table Of Contents and a List of Figures should be generated. Similarly, + +/chapter toc + +indicates that whenever a document that has a root +of chapter is formatted, a Table of +Contents should be generated. The entry chapter would match +all chapters, but /chapter matches only chapter +document elements. + +Generally, the longest match wins. So, for example, if you want to distinguish +articles in books from articles in parts, you could use these two entries: + +book/article toc,figure +part/article toc + +Note that an article in a part can never match a book/article, +so if you want nothing to be generated for articles in parts, you can simply leave +that rule out. + +If you want to leave the rule in, to make it explicit that you're turning +something off, use the value nop. For example, the following +entry disables ToCs and LoTs for articles: + +article nop + +Do not simply leave the word article in the file +without a matching value. That'd be just begging the silly little +path/value parser to get confused. + +Section ToCs are further controlled by the +generate.section.toc.level parameter. +For a given section level to have a ToC, it must have both an entry in +generate.toc and be within the range enabled by +generate.section.toc.level. + + + + + +generate.index +boolean + + +generate.index +Do you want an index? + + + +<xsl:param name="generate.index" select="1"></xsl:param> + + +Description + +Specify if an index should be generated. + + + + + + +make.index.markup +boolean + + +make.index.markup +Generate XML index markup in the index? + + + + +<xsl:param name="make.index.markup" select="0"></xsl:param> + + + +Description + +This parameter enables a very neat trick for getting properly +merged, collated back-of-the-book indexes. G. Ken Holman suggested +this trick at Extreme Markup Languages 2002 and I'm indebted to him +for it. + +Jeni Tennison's excellent code in +autoidx.xsl does a great job of merging and +sorting indexterms in the document and building a +back-of-the-book index. However, there's one thing that it cannot +reasonably be expected to do: merge page numbers into ranges. (I would +not have thought that it could collate and suppress duplicate page +numbers, but in fact it appears to manage that task somehow.) + +Ken's trick is to produce a document in which the index at the +back of the book is displayed in XML. Because the index +is generated by the FO processor, all of the page numbers have been resolved. +It's a bit hard to explain, but what it boils down to is that instead of having +an index at the back of the book that looks like this: + +
                  +A +ap1, 1, 2, 3 + +
                  + +you get one that looks like this: + +
                  +<indexdiv>A</indexdiv> +<indexentry> +<primaryie>ap1</primaryie>, +<phrase role="pageno">1</phrase>, +<phrase role="pageno">2</phrase>, +<phrase role="pageno">3</phrase> +</indexentry> +
                  + +After building a PDF file with this sort of odd-looking index, you can +extract the text from the PDF file and the result is a proper index expressed in +XML. + +Now you have data that's amenable to processing and a simple Perl script +(such as fo/pdf2index) can +merge page ranges and generate a proper index. + +Finally, reformat your original document using this literal index instead of +an automatically generated one and bingo! + +                   +                   + + + +index.method +string + + +index.method +Select method used to group index entries in an index + + + + +<xsl:param name="index.method" select="'english'"></xsl:param> + + + +Description + +This parameter lets you select which method should be +used to sort and group index entries in an index. +Indexes in languages that have accented characters typically +sort together accented words and unaccented words. +So Á (A acute) would sort together +with A, so both would appear in the A +section of the index. + + +The default indexing method does not sort accented characters this way. +Words that start with an accented character will instead appear in the +Symbols section of the index. +As such, the default method is only suitable for +English and other unaccented languages. +The other indexing methods require extensions of one type or +another, which is why there are not used by default. + +The three choices for indexing method are: + + +english + + +(default) Sort and groups words based only on the Latin alphabet. +Accented words and words in non-Latin alphabets will be +put in the Symbols section of the index. + + + + +kosek + + +Sort and groups words based on letter groups configured in +the DocBook locale file for the given language. +For example, the French locale file is common/fr.xml. +This method requires support for EXSLT extensions in +the XSL processor. It also requires support for using +user-defined functions in xsl:key (xsltproc does not). + +This method is suitable for any language for which you can +list all the individual characters that should appear +in each letter group in an index. +It is probably not practical to use it for ideographic languages +such as Chinese that have hundreds or thousands of characters. + +To use this method, your customization must set this +parameter and import an additional stylesheet module: +<xsl:import href="[path-to-stylesheets]/common/autoidx-ng.xsl"/> +<xsl:param name="index.method">kosek</xsl:param> + + +The stylesheet module defines functions and adds an xsl:key +used by the method. + + + + +kimber + + +This method uses extensions to the Saxon processor to implement +sophisticated indexing processes. It uses its own +configuration file, which can include information for any number of +languages. Each language's configuration can group +words using either an +enumerated method similar to the kosek method, or it can +designate the first character in each group when viewed in sort order. +The latter configuration is useful for ideographic languages +such as Chinese, Japanese, and Korean. +You can also define your own collation algorithms and where you +want Latin-alphabet words sorted. + + +For a whitepaper describing the extensions, see: +. + + + +To download the extension library, see +. + + + + +To use this method, you must: + + + +Use Saxon as your XSLT processor. + + + +Install and configure the Innodata Isogen library, using +the documentation that comes with it. + + + +Set this parameter's value to kimber. + + + +Import the index extensions stylesheet module +common/autoidx-ng.xsl into your +customization. + + + + + + + + + + + + + +index.on.type +boolean + + +index.on.type +Select indexterms based on type +attribute value + + + + +<xsl:param name="index.on.type" select="0"></xsl:param> + + + +Description + + +If non-zero, +then an index element that has a +type attribute +value will contain only those indexterm +elements with a matching type attribute value. +If an index has no type +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + + +If index.on.type is zero, then the +type attribute has no effect +on selecting indexterms for an index. + + +For those using DocBook version 4.2 or earlier, +the type attribute is not available +for index terms. However, you can achieve the same +effect by using the role attribute +in the same manner on indexterm +and index, and setting the stylesheet parameter +index.on.role to a nonzero value. + + + + + + + +index.on.role +boolean + + +index.on.role +Select indexterms based on role value + + + + +<xsl:param name="index.on.role" select="0"></xsl:param> + + + +Description + + +If non-zero, +then an index element that has a +role attribute +value will contain only those indexterm +elements with a matching role value. +If an index has no role +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + +If index.on.role is zero, then the +role attribute has no effect +on selecting indexterms for an index. + + +If you are using DocBook version 4.3 or later, you should +use the type attribute instead of role +on indexterm and index, +and set the index.on.type to a nonzero +value. + + + + + + + +index.preferred.page.properties +Properties used to emphasize page number references for +significant index terms + + + + +<xsl:attribute-set name="index.preferred.page.properties"> + <xsl:attribute name="font-weight">bold</xsl:attribute> +</xsl:attribute-set> + + + +Description + +Properties used to emphasize page number references for +significant index terms (significance=preffered). Currently works only with +XEP. + + + + + + + +index.entry.properties +Properties applied to the formatted entries +in an index + + + + +<xsl:attribute-set name="index.entry.properties"> + <xsl:attribute name="start-indent">0pt</xsl:attribute> +</xsl:attribute-set> + + + +Description + +This attribute set is applied to the block containing +the entries in a letter division in an index. It can be used to set the +font-size, font-family, and other inheritable properties that will be +applied to all index entries. + + + + + + +index.div.title.properties +Properties associated with the letter headings in an +index + + + + +<xsl:attribute-set name="index.div.title.properties"> + <xsl:attribute name="margin-left">0pt</xsl:attribute> + <xsl:attribute name="font-size">14.4pt</xsl:attribute> + <xsl:attribute name="font-family"><xsl:value-of select="$title.fontset"></xsl:value-of></xsl:attribute> + <xsl:attribute name="font-weight">bold</xsl:attribute> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> + <xsl:attribute name="space-before.optimum"><xsl:value-of select="concat($body.font.master,'pt')"></xsl:value-of></xsl:attribute> + <xsl:attribute name="space-before.minimum"><xsl:value-of select="concat($body.font.master,'pt * 0.8')"></xsl:value-of></xsl:attribute> + <xsl:attribute name="space-before.optimum"><xsl:value-of select="concat($body.font.master,'pt * 1.2')"></xsl:value-of></xsl:attribute> + <xsl:attribute name="start-indent">0pt</xsl:attribute> +</xsl:attribute-set> + + + +Description + +This attribute set is used on the letter headings that separate +the divisions in an index. + + + + + + +index.number.separator +string + + +index.number.separator +Override for punctuation separating page numbers in index + + + + +<xsl:param name="index.number.separator" select="''"></xsl:param> + + + +Description + +This parameter permits you to override the text to insert between +page references in a formatted index entry. Typically +that would be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'number-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. This punctuation appears between +such section titles in an HTML index. + + + + + + + +index.range.separator +string + + +index.range.separator +Override for punctuation separating the two numbers +in a page range in index + + + + +<xsl:param name="index.range.separator" select="''"></xsl:param> + + + +Description + +This parameter permits you +to override the text to insert between +the two numbers of a page range in an index. +This parameter is only used by those XSL-FO processors +that support an extension for generating such page ranges +(such as XEP). + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'range-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. So there are no page ranges +and this parameter has no effect. + + + + + + + +index.term.separator +string + + +index.term.separator +Override for punctuation separating an index term +from its list of page references in an index + + + + +<xsl:param name="index.term.separator" select="''"></xsl:param> + + + +Description + +This parameter permits you to override +the text to insert between +the end of an index term and its list of page references. +Typically that might be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'term-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +fill in the content for this normally empty +override parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. +For fo output, it could be an fo:leader +element to provide space of a specific length, or a dot leader. + + + + + + + +xep.index.item.properties +Properties associated with XEP index-items + + + + +<xsl:attribute-set name="xep.index.item.properties"> + <xsl:attribute name="merge-subsequent-page-numbers">true</xsl:attribute> + <xsl:attribute name="link-back">true</xsl:attribute> +</xsl:attribute-set> + + + +Description + +Properties associated with XEP index-items. For more info see +the section "Indexes" in +. + + + + + + +toc.section.depth +integer + + +toc.section.depth +How deep should recursive sections appear +in the TOC? + + + +<xsl:param name="toc.section.depth">2</xsl:param> + + +Description + +Specifies the depth to which recursive sections should appear in the +TOC. + + + + + + + +toc.max.depth +integer + + +toc.max.depth +How maximaly deep should be each TOC? + + + +<xsl:param name="toc.max.depth">8</xsl:param> + + +Description + +Specifies the maximal depth of TOC on all levels. + + + + + + +toc.indent.width +float + + +toc.indent.width +Amount of indentation for TOC entries + + + + +<xsl:param name="toc.indent.width" select="24"></xsl:param> + + + +Description + +Specifies, in points, the distance by which each level of the +TOC is indented from its parent. + +This value is expressed in points, without +a unit (in other words, it is a bare number). Using a bare number allows the stylesheet +to perform calculations that would otherwise have to be performed by the FO processor +because not all processors support expressions. + + + + + + +toc.line.properties +attribute set + + +toc.line.properties +Properties for lines in ToC and LoTs + + + + +<xsl:attribute-set name="toc.line.properties"> + <xsl:attribute name="text-align-last">justify</xsl:attribute> + <xsl:attribute name="text-align">start</xsl:attribute> +</xsl:attribute-set> + + + +Description + +Properties which are applied to every line in ToC (or LoT). You can +modify them in order to change appearance of all, or some lines. For +example in order to make lines for chapters in bold specify the +following in your customization layer. + +<xsl:attribute-set name="toc.line.properties"> + <xsl:attribute name="font-weight"> + <xsl:when test="self::chapter | self::preface | self::appendix">bold</xsl:when> + <xsl:otherwise>normal</xsl:otherwise> + </xsl:attribute> +</xsl:attribute-set> + + + + + + +toc.margin.properties +Margin properties used on Tables of Contents + + + + +<xsl:attribute-set name="toc.margin.properties"> + <xsl:attribute name="space-before.minimum">0.5em</xsl:attribute> + <xsl:attribute name="space-before.optimum">1em</xsl:attribute> + <xsl:attribute name="space-before.maximum">2em</xsl:attribute> + <xsl:attribute name="space-after.minimum">0.5em</xsl:attribute> + <xsl:attribute name="space-after.optimum">1em</xsl:attribute> + <xsl:attribute name="space-after.maximum">2em</xsl:attribute> +</xsl:attribute-set> + + + +Description +This attribute set is used on Tables of Contents. These attributes are set +on the wrapper that surrounds the ToC block, not on each individual lines. + + + + + +bridgehead.in.toc +boolean + + +bridgehead.in.toc +Should bridgehead elements appear in the TOC? + + + +<xsl:param name="bridgehead.in.toc" select="0"></xsl:param> + + +Description + +If non-zero, bridgeheads appear in the TOC. Note that this option +is not fully supported and may be removed in a future version of the +stylesheets. + + + + + + + +simplesect.in.toc +boolean + + +simplesect.in.toc +Should simplesect elements appear in the TOC? + + + +<xsl:param name="simplesect.in.toc" select="0"></xsl:param> + + +Description + +If non-zero, simplesects appear in the TOC. + + + + + + + +generate.section.toc.level +integer + + +generate.section.toc.level +Control depth of TOC generation in sections + + + + +<xsl:param name="generate.section.toc.level" select="0"></xsl:param> + + + +Description + +The generate.section.toc.level parameter +controls the depth of section in which TOCs will be generated. Note +that this is related to, but not the same as +toc.section.depth, which controls the depth to +which TOC entries will be generated in a given TOC. +If, for example, generate.section.toc.level +is 3, TOCs will be generated in first, second, and third +level sections, but not in fourth level sections. + + + + + + + + +                   + +Processor Extensions + + +arbortext.extensions +boolean + + +arbortext.extensions +Enable Arbortext extensions? + + + +<xsl:param name="arbortext.extensions" select="0"></xsl:param> + + +Description + +If non-zero, +Arbortext +extensions will be used. + +This parameter can also affect which graphics file formats +are supported + + + + + + +axf.extensions +boolean + + +axf.extensions +Enable XSL Formatter extensions? + + + + +<xsl:param name="axf.extensions" select="0"></xsl:param> + + + +Description + +If non-zero, +XSL Formatter +extensions will be used. XSL Formatter extensions consists of PDF bookmarks, +document information and better index processing. + +This parameter can also affect which graphics file formats +are supported + + + + + + +fop.extensions +boolean + + +fop.extensions +Enable FOP extensions for version 0.20.5 and earlier + + + +<xsl:param name="fop.extensions" select="0"></xsl:param> + + +Description + +If non-zero, extensions intended for +FOP +version 0.20.5 and earlier will be used. +At present, this consists of PDF bookmarks. + + +This parameter can also affect which graphics file formats +are supported + +If you are using a version of FOP beyond +version 0.20.5, then use the fop1.extensions +instead. + + + + + + +fop1.extensions +boolean + + +fop1.extensions +Enable extensions for FOP version 1 and later + + + +<xsl:param name="fop1.extensions" select="0"></xsl:param> + + +Description + +If non-zero, extensions for +FOP +version 1 and later will be used. + + +This parameter can also affect which graphics file formats +are supported + +The original fop.extensions +should still be used for FOP version 0.20.5 and earlier. + + + + + + +passivetex.extensions +boolean + + +passivetex.extensions +Enable PassiveTeX extensions? + + + +<xsl:param name="passivetex.extensions" select="0"></xsl:param> + + +Description + +If non-zero, +PassiveTeX +extensions will be used. At present, this consists of PDF bookmarks +and sorted index terms. + + +This parameter can also affect which graphics file formats +are supported + + + + + +tex.math.in.alt +string + + +tex.math.in.alt +TeX notation used for equations + + + + +<xsl:param name="tex.math.in.alt" select="''"></xsl:param> + + + +Description + +If you want type math directly in TeX notation in equations, +this parameter specifies notation used. Currently are supported two +values -- plain and latex. Empty +value means that you are not using TeX math at all. + +Preferred way for including TeX alternative of math is inside of +textobject element. Eg.: + +<inlineequation> +<inlinemediaobject> +<imageobject> +<imagedata fileref="eq1.gif"/> +</imageobject> +<textobject><phrase>E=mc squared</phrase></textobject> +<textobject role="tex"><phrase>E=mc^2</phrase></textobject> +</inlinemediaobject> +</inlineequation> + +If you are using graphic element, you can +store TeX inside alt element: + +<inlineequation> +<alt role="tex">a^2+b^2=c^2</alt> +<graphic fileref="a2b2c2.gif"/> +</inlineequation> + +If you want use this feature, you should process your FO with +PassiveTeX, which only supports TeX math notation. When calling +stylsheet, don't forget to specify also +passivetex.extensions=1. + +If you want equations in HTML, just process generated file +tex-math-equations.tex by TeX or LaTeX. Then run +dvi2bitmap program on result DVI file. You will get images for +equations in your document. + + + + + + +tex.math.delims +boolean + + +tex.math.delims +Should be equations outputed for processing by TeX +automatically surrounded by math mode delimiters + + + + +<xsl:param name="tex.math.delims" select="'1'"></xsl:param> + + + +Description + +For compatibility with DSSSL based DBTeXMath from Allin Cottrell +you should set this parameter to 0. + + + + + + +xep.extensions +boolean + + +xep.extensions +Enable XEP extensions? + + + +<xsl:param name="xep.extensions" select="0"></xsl:param> + + +Description + +If non-zero, +XEP +extensions will be used. XEP extensions consists of PDF bookmarks, +document information and better index processing. + + +This parameter can also affect which graphics file formats +are supported + + + + + +Stylesheet Extensions + + +linenumbering.everyNth +integer + + +linenumbering.everyNth +Indicate which lines should be numbered + + + +<xsl:param name="linenumbering.everyNth" select="'5'"></xsl:param> + + +Description + +If line numbering is enabled, everyNth line will be numbered. + + + + + + + +linenumbering.extension +boolean + + +linenumbering.extension +Enable the line numbering extension + + + +<xsl:param name="linenumbering.extension" select="'1'"></xsl:param> + + +Description + +If true, verbatim environments (elements that have the +format='linespecific' notation attribute: address, literallayout, +programlisting, screen, synopsis) that specify line numbering will +have, surprise, line numbers. + + + + + + + +linenumbering.separator +string + + +linenumbering.separator +Specify a separator between line numbers and lines + + + +<xsl:param name="linenumbering.separator" select="' '"></xsl:param> + + +Description + +The separator is inserted between line numbers and lines in +the verbatim environment. + + + + + + + +linenumbering.width +integer + + +linenumbering.width +Indicates the width of line numbers + + + +<xsl:param name="linenumbering.width" select="'3'"></xsl:param> + + +Description + +If line numbering is enabled, line numbers will appear right +justified in a field "width" characters wide. + + + + + + + +tablecolumns.extension +boolean + + +tablecolumns.extension +Enable the table columns extension function + + + +<xsl:param name="tablecolumns.extension" select="'1'"></xsl:param> + + +Description + +The table columns extension function adjusts the widths of table +columns in the HTML result to more accurately reflect the specifications +in the CALS table. + + + + + + + +textinsert.extension +boolean + + +textinsert.extension +Enable the textinsert extension element + + + +<xsl:param name="textinsert.extension" select="'1'"></xsl:param> + + +Description + +The textinsert extension element inserts the contents of a +a file into the result tree (as text). + + + + + + + +textdata.default.encoding +string + + +textdata.default.encoding +Default encoding of external text files which are included +using textdata element + + + + +<xsl:param name="textdata.default.encoding" select="''"></xsl:param> + + + +Description + +Default encoding of external text files which are included using +textdata element. This value is used only when you do not specify +encoding by appropriate attribute directly on textdata. Default +encoding (empty string) is interpreted as system default +encoding. + + + + + + + +use.extensions +boolean + + +use.extensions +Enable extensions + + + +<xsl:param name="use.extensions" select="'0'"></xsl:param> + + +Description + +If non-zero, extensions may be used. Each extension is +further controlled by its own parameter. But if +use.extensions is zero, no extensions will +be used. + + + + + + + +Automatic labelling + + +appendix.autolabel +boolean + + +appendix.autolabel +Specifies the labeling format for Appendix titles + + + + +<xsl:param name="appendix.autolabel" select="'A'"></xsl:param> + + + +Description + +If zero, then appendices will not be numbered. +Otherwise appendices will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperalpha). + + + + + + + +chapter.autolabel +boolean + + +chapter.autolabel +Specifies the labeling format for Chapter titles + + + +<xsl:param name="chapter.autolabel" select="1"></xsl:param> + + +Description + +If zero, then chapters will not be numbered. +Otherwise chapters will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + + + + +part.autolabel +boolean + + +part.autolabel +Specifies the labeling format for Part titles + + + +<xsl:param name="part.autolabel" select="'I'"></xsl:param> + + +Description + +If zero, then parts will not be numbered. +Otherwise parts will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperroman). + + + + + + + + +preface.autolabel +boolean + + +preface.autolabel +Specifices the labeling format for Preface titles + + + +<xsl:param name="preface.autolabel" select="0"></xsl:param> + + +Description + +If zero (default), then prefaces will not be numbered. +Otherwise prefaces will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + + + + + +section.autolabel +boolean + + +section.autolabel +Are sections enumerated? + + + +<xsl:param name="section.autolabel" select="0"></xsl:param> + + +Description + +If true (non-zero), unlabeled sections will be enumerated. + + + + + + + +section.autolabel.max.depth +integer + + +section.autolabel.max.depth +The deepest level of sections that are numbered. + + + +<xsl:param name="section.autolabel.max.depth" select="8"></xsl:param> + + +Description + +When section numbering is turned on by the +section.autolabel parameter, +then this parameter controls the depth of section nesting +that is numbered. +Sections nested to a level deeper than this value will +not be numbered. + + + + + + + +section.label.includes.component.label +boolean + + +section.label.includes.component.label +Do section labels include the component label? + + + +<xsl:param name="section.label.includes.component.label" select="0"></xsl:param> + + +Description + +If true (non-zero), section labels are prefixed with the label of the +component that contains them. + + + + + + + +label.from.part +boolean + + +label.from.part +Renumber chapters in each part? + + + +<xsl:param name="label.from.part" select="'0'"></xsl:param> + + +Description + +If label.from.part is non-zero, components +(chapters, appendixes, etc.) +will be numbered from 1 in each part. Otherwise, +they will be numbered monotonically throughout each +book. + + + + + + + +component.label.includes.part.label +boolean + + +component.label.includes.part.label +Do component labels include the part label? + + + +<xsl:param name="component.label.includes.part.label" select="0"></xsl:param> + + +Description + +If true (non-zero), number labels for chapters, appendices, and other component +elements are prefixed with the label of the +part element that contains them. +So you might see Chapter II.3 instead of Chapter 3. +Also, the labels for formal elements such as table and figure will +include the part label. +If there is no part element container, then no prefix is generated. + + +This feature is most useful when the +label.from.part parameter is turned on. +In that case, there would be more than one chapter +1, and the extra part label prefix will identify +each chapter unambiguously. + + + + + + + +XSLT Processing + + +rootid +string + + +rootid +Specify the root element to format + + + +<xsl:param name="rootid" select="''"></xsl:param> + + +Description + +If rootid is specified, it must be the +value of an ID that occurs in the document being formatted. The entire +document will be loaded and parsed, but formatting will begin at the +element identified, rather than at the root. For example, this allows +you to process only chapter 4 of a book. +Because the entire document is available to the processor, automatic +numbering, cross references, and other dependencies are correctly +resolved. + + + + + + +Meta/*Info + + +make.single.year.ranges +boolean + + +make.single.year.ranges +Print single-year ranges (e.g., 1998-1999) + + + +<xsl:param name="make.single.year.ranges" select="0"></xsl:param> + + +Description + +If non-zero, year ranges that span a single year will be printed +in range notation (1998-1999) instead of discrete notation +(1998, 1999). + + + + + + +make.year.ranges +boolean + + +make.year.ranges +Collate copyright years into ranges? + + + +<xsl:param name="make.year.ranges" select="0"></xsl:param> + + +Description + +If non-zero, copyright years will be collated into ranges. + + + + + + +author.othername.in.middle +boolean + + +author.othername.in.middle +Is othername in author a +middle name? + + + +<xsl:param name="author.othername.in.middle" select="1"></xsl:param> + + +Description + +If true (non-zero), the othername of an author +appears between the firstname and +surname. Otherwise, othername +is suppressed. + + + + + + + +Reference Pages + + +funcsynopsis.decoration +boolean + + +funcsynopsis.decoration +Decorate elements of a FuncSynopsis? + + + +<xsl:param name="funcsynopsis.decoration" select="1"></xsl:param> + + +Description + +If true (non-zero), elements of the FuncSynopsis will be decorated (e.g. bold or +italic). The decoration is controlled by functions that can be redefined +in a customization layer. + + + + + + + +funcsynopsis.style +list +ansi +kr + + +funcsynopsis.style +What style of 'FuncSynopsis' should be generated? + + + +<xsl:param name="funcsynopsis.style">kr</xsl:param> + + +Description + +If funcsynopsis.style is ansi, +ANSI-style function synopses are generated for a +funcsynopsis, otherwise K&R-style +function synopses are generated. + + + + + + + +function.parens +boolean + + +function.parens +Generate parens after a function? + + + +<xsl:param name="function.parens">0</xsl:param> + + +Description + +If not 0, the formatting of +a function element will include +generated parenthesis. + + + + + + + +refentry.generate.name +boolean + + +refentry.generate.name +Output NAME header before 'RefName'(s)? + + + +<xsl:param name="refentry.generate.name" select="1"></xsl:param> + + +Description + +If true (non-zero), a "NAME" section title is output before the list +of 'RefName's. This parameter and +refentry.generate.title are mutually +exclusive. This means that if you change this parameter to zero, you +should set refentry.generate.title to 1 unless +you want get quite strange output. + + + + + + + +refentry.generate.title +boolean + + +refentry.generate.title +Output title before 'RefName'(s)? + + + + +<xsl:param name="refentry.generate.title" select="0"></xsl:param> + + + +Description + +If true (non-zero), the reference page title or first name is +output before the list of 'RefName's. This parameter and +refentry.generate.name are mutually exclusive. +This means that if you change this parameter to 1, you +should set refentry.generate.name to 0 unless +you want get quite strange output. + + + + + + + +refentry.pagebreak +boolean + + +refentry.pagebreak +Start each refentry on a new page + + + +<xsl:param name="refentry.pagebreak" select="1"></xsl:param> + + +Description + +If non-zero (the default), each refentry +element will start on a new page. If zero, a page +break will not be generated between refentry elements. +The exception is when the refentry elements are children of +a part element, in which case the page breaks are always +retained. That is because a part element does not generate +a page-sequence for its children, so each refentry must +start its own page-sequence. + + + + + + + +refentry.title.properties +attribute set + + +refentry.title.properties +Title properties for a refentry title + + + + +<xsl:attribute-set name="refentry.title.properties"> + <xsl:attribute name="font-family"> + <xsl:value-of select="$title.font.family"></xsl:value-of> + </xsl:attribute> + <xsl:attribute name="font-size">18pt</xsl:attribute> + <xsl:attribute name="font-weight">bold</xsl:attribute> + <xsl:attribute name="space-after">1em</xsl:attribute> + <xsl:attribute name="hyphenate">false</xsl:attribute> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> + <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-before.optimum">1.0em</xsl:attribute> + <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> + <xsl:attribute name="space-after.optimum">0.5em</xsl:attribute> + <xsl:attribute name="space-after.minimum">0.4em</xsl:attribute> + <xsl:attribute name="space-after.maximum">0.6em</xsl:attribute> + <xsl:attribute name="start-indent"><xsl:value-of select="$title.margin.left"></xsl:value-of></xsl:attribute> +</xsl:attribute-set> + + + +Description + +Formatting properties applied to the title generated for the +refnamediv part of output for +refentry when the value of the +refentry.generate.title parameter is +non-zero. The font size is supplied by the appropriate section.levelX.title.properties +attribute-set, computed from the location of the +refentry in the section hierarchy. + + + This parameter has no effect on the the title generated for + the refnamediv part of output for + refentry when the value of the + refentry.generate.name parameter is + non-zero. By default, that title is formatted with the same + properties as the titles for all other first-level children of + refentry. + + + + + + + +refentry.xref.manvolnum +boolean + + +refentry.xref.manvolnum +Output manvolnum as part of +refentry cross-reference? + + + +<xsl:param name="refentry.xref.manvolnum" select="1"></xsl:param> + + +Description + +if true (non-zero), the manvolnum is used when cross-referencing +refentrys, either with xref +or citerefentry. + + + + + + + +refclass.suppress +boolean + + +refclass.suppress +Suppress display of refclass contents? + + + + +<xsl:param name="refclass.suppress" select="0"></xsl:param> + + +Description + +If the value of refclass.suppress is +non-zero, then display of refclass contents is +suppressed in output. + + + + + + +Tables + + +default.table.width +length + + +default.table.width +The default width of tables + + + +<xsl:param name="default.table.width" select="''"></xsl:param> + + +Description + +If specified, this value will be used for the WIDTH attribute on +tables that do not specify an alternate width (with the dbhtml processing +instruction). + + + + + + +nominal.table.width +length + + +nominal.table.width +The (absolute) nominal width of tables + + + +<xsl:param name="nominal.table.width" select="'6in'"></xsl:param> + + +Description + +In order to convert CALS column widths into HTML column widths, it +is sometimes necessary to have an absolute table width to use for conversion +of mixed absolute and relative widths. This value must be an absolute +length (not a percentag). + + + + + + +table.cell.padding + + + +table.cell.padding + + + + + +<xsl:attribute-set name="table.cell.padding"> + <xsl:attribute name="padding-left">2pt</xsl:attribute> + <xsl:attribute name="padding-right">2pt</xsl:attribute> + <xsl:attribute name="padding-top">2pt</xsl:attribute> + <xsl:attribute name="padding-bottom">2pt</xsl:attribute> +</xsl:attribute-set> + + + +Description + +FIXME: + + + + + + +table.frame.border.thickness + + + +table.frame.border.thickness +Specifies the thickness of the frame border + + + + +<xsl:param name="table.frame.border.thickness" select="'0.5pt'"></xsl:param> + + + +Description + +Specifies the thickness of the border on the table's frame. + + + + + + +table.frame.border.style + + + +table.frame.border.style + + + + + +<xsl:param name="table.frame.border.style" select="'solid'"></xsl:param> + + + +Description + +FIXME: + + + + + + +table.frame.border.color + + + +table.frame.border.color + + + + + + +<xsl:param name="table.frame.border.color" select="'black'"></xsl:param> + + + +Description + +FIXME: + + + + + + +table.cell.border.thickness + + + +table.cell.border.thickness + + + + + +<xsl:param name="table.cell.border.thickness" select="'0.5pt'"></xsl:param> + + + +Description + +FIXME: + + + + + + +table.cell.border.style + + + +table.cell.border.style + + + + + +<xsl:param name="table.cell.border.style" select="'solid'"></xsl:param> + + + +Description + +FIXME: + + + + + + +table.cell.border.color + + + +table.cell.border.color + + + + + + +<xsl:param name="table.cell.border.color" select="'black'"></xsl:param> + + + +Description + +FIXME: + + + + + + +table.table.properties +Properties associated with a table + + + + +<xsl:attribute-set name="table.table.properties"> + <xsl:attribute name="border-before-width.conditionality">retain</xsl:attribute> + <xsl:attribute name="border-collapse">collapse</xsl:attribute> +</xsl:attribute-set> + + + +Description + +The styling for tables. This parameter should really +have been called table.properties, but that parameter +name was inadvertantly established for the block-level properties +of the table as a whole. + + +See also table.properties. + + + + + + +Linking + + +current.docid +string + + +current.docid +targetdoc identifier for the document being +processed + + +<xsl:param name="current.docid" select="''"></xsl:param> + + +Description +When olinks between documents are resolved for HTML output, the stylesheet can compute the relative path between the current document and the target document. The stylesheet needs to know the targetdoc identifiers for both documents, as they appear in the target.database.document database file. This parameter passes to the stylesheet +the targetdoc identifier of the current document, since that +identifier does not appear in the document itself. +This parameter can also be used for print output. If an olink's targetdoc id differs from the current.docid, then the stylesheet can append the target document's title to the generated olink text. That identifies to the reader that the link is to a different document, not the current document. See also olink.doctitle to enable that feature. + + + + + +collect.xref.targets +string + + +collect.xref.targets +Controls whether cross reference data is +collected + + +<xsl:param name="collect.xref.targets" select="'no'"></xsl:param> + + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter determines whether the collection process is run when the document is processed by the stylesheet. The default value is no, which means the data file is not generated during processing. The other choices are yes, which means the data file is created and the document is processed for output, and only, which means the data file is created but the document is not processed for output. +See also targets.filename. + + + + + + +insert.olink.page.number +string + + +insert.olink.page.number +Turns page numbers in olinks on and off + + + + +<xsl:param name="insert.olink.page.number">no</xsl:param> + + + +Description + +The value of this parameter determines if +cross references made between documents with +olink will +include page number citations. +In most cases this is only applicable to references in printed output. + +The parameter has three possible values. + + + +no +No page number references will be generated for olinks. + + + +yes +Page number references will be generated +for all olink references. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an olink element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + +Olinks that point to targets within the same document +are treated as xrefs, and controlled by +the insert.xref.page.number parameter. + + +Page number references for olinks to +external documents can only be inserted if the +information exists in the olink database. +This means each olink target element +(div or obj) +must have a page attribute +whose value is its page number in the target document. +The XSL stylesheets are not able to extract that information +during processing because pages have not yet been created in +XSLT transformation. Only the XSL-FO processor knows what +page each element is placed on. +Therefore some postprocessing must take place to populate +page numbers in the olink database. + + + + + + + + + +insert.olink.pdf.frag +boolean + + +insert.olink.pdf.frag +Add fragment identifiers for links into PDF files + + + + +<xsl:param name="insert.olink.pdf.frag" select="0"></xsl:param> + + + +Description + +The value of this parameter determines whether +the cross reference URIs to PDF documents made with +olink will +include fragment identifiers. + + +When forming a URI to link to a PDF document, +a fragment identifier (typically a '#' followed by an +id value) appended to the PDF filename can be used by +the PDF viewer to open +the PDF file to a location within the document instead of +the first page. +However, not all PDF files have id +values embedded in them, and not all PDF viewers can +handle fragment identifiers. + + +If insert.olink.pdf.frag is set +to a non-zero value, then any olink targeting a +PDF file will have the fragment identifier appended to the URI. +The URI is formed by concatenating the value of the +olink.base.uri parameter, the +value of the baseuri +attribute from the document +element in the olink database with the matching +targetdoc value, +and the value of the href +attribute for the targeted element in the olink database. +The href attribute +contains the fragment identifier. + + +If insert.olink.pdf.frag is set +to zero (the default value), then +the href attribute +from the olink database +is not appended to PDF olinks, so the fragment identifier is left off. +A PDF olink is any olink for which the +baseuri attribute +from the matching document +element in the olink database ends with '.pdf'. +Any other olinks will still have the fragment identifier added. + + + + + + +olink.base.uri +uri + + +olink.base.uri +Base URI used in olink hrefs + + +<xsl:param name="olink.base.uri" select="''"></xsl:param> + + +Description +When cross reference data is collected for resolving olinks, it may be necessary to prepend a base URI to each target's href. This parameter lets you set that base URI when cross reference data is collected. This feature is needed when you want to link to a document that is processed without chunking. The output filename for such a document is not known to the XSL stylesheet; the only target information consists of fragment identifiers such as #idref. To enable the resolution of olinks between documents, you should pass the name of the HTML output file as the value of this parameter. Then the hrefs recorded in the cross reference data collection look like outfile.html#idref, which can be reached as links from other documents. + + + + + +olink.debug +boolean + + +olink.debug +Turn on debugging messages for olinks + + + + +<xsl:param name="olink.debug" select="0"></xsl:param> + + + +Description + +If non-zero, then each olink will generate several +messages about how it is being resolved during processing. +This is useful when an olink does not resolve properly +and the standard error messages are not sufficient to +find the problem. + + +You may need to read through the olink XSL templates +to understand the context for some of the debug messages. + + + + + + + +olink.doctitle +string + + +olink.doctitle +show the document title for external olinks? + + + +<xsl:param name="olink.doctitle" select="'no'"></xsl:param> + + +Description +When olinks between documents are resolved, the generated text +may not make it clear that the reference is to another document. +It is possible for the stylesheets to append the other document's +title to external olinks. For this to happen, two parameters must +be set. + + +This olink.doctitle parameter +should be set to either yes or maybe +to enable this feature. + + + +And you should also set the current.docid +parameter to the document id for the document currently +being processed for output. + + + + + +Then if an olink's targetdoc id differs from +the current.docid value, the stylesheet knows +that it is a reference to another document and can +append the target document's +title to the generated olink text. + +The text for the target document's title is copied from the +olink database from the ttl element +of the top-level div for that document. +If that ttl element is missing or empty, +no title is output. + + +The supported values for olink.doctitle are: + + + +yes + + +Always insert the title to the target document if it is not +the current document. + + + + +no + + +Never insert the title to the target document, even if requested +in an xrefstyle attribute. + + + + +maybe + + +Only insert the title to the target document, if requested +in an xrefstyle attribute. + + + + +An xrefstyle attribute +may override the global setting for individual olinks. +The following values are supported in an +xrefstyle +attribute using the select: syntax: + + + + +docname + + +Insert the target document name for this olink using the +docname gentext template, but only +if the value of olink.doctitle +is not no. + + + + +docnamelong + + +Insert the target document name for this olink using the +docnamelong gentext template, but only +if the value of olink.doctitle +is not no. + + + + +nodocname + + +Omit the target document name even if +the value of olink.doctitle +is yes. + + + + +Another way of inserting the target document name +for a single olink is to employ an +xrefstyle +attribute using the template: syntax. +The %o placeholder (the letter o, not zero) +in such a template +will be filled in with the target document's title when it is processed. +This will occur regardless of +the value of olink.doctitle. + +Note that prior to version 1.66 of the XSL stylesheets, +the allowed values for this parameter were 0 and 1. Those +values are still supported and mapped to 'no' and 'yes', respectively. + + + + + + +olink.lang.fallback.sequence +string + + +olink.lang.fallback.sequence +look up translated documents if olink not found? + + + +<xsl:param name="olink.lang.fallback.sequence" select="''"></xsl:param> + + +Description + +This parameter defines a list of lang values +to search among to resolve olinks. + + +Normally an olink tries to resolve to a document in the same +language as the olink itself. The language of an olink +is determined by its nearest ancestor element with a +lang attribute, otherwise the +value of the l10n.gentext.default.lang +parameter. + + +An olink database can contain target data for the same +document in multiple languages. Each set of data has the +same value for the targetdoc attribute in +the document element in the database, but with a +different lang attribute value. + + +When an olink is being resolved, the target is first +sought in the document with the same language as the olink. +If no match is found there, then this parameter is consulted +for additional languages to try. + +The olink.lang.fallback.sequence +must be a whitespace separated list of lang values to +try. The first one with a match in the olink database is used. +The default value is empty. + +For example, a document might be written in German +and contain an olink with +targetdoc="adminguide". +When the document is processed, the processor +first looks for a target dataset in the +olink database starting with: + +<document targetdoc="adminguide" lang="de">. + + +If there is no such element, then the +olink.lang.fallback.sequence +parameter is consulted. +If its value is, for example, fr en, then the processor next +looks for targetdoc="adminguide" lang="fr", and +then for targetdoc="adminguide" lang="en". +If there is still no match, it looks for +targetdoc="adminguide" with no +lang attribute. + + +This parameter is useful when a set of documents is only +partially translated, or is in the process of being translated. +If a target of an olink has not yet been translated, then this +parameter permits the processor to look for the document in +other languages. This assumes the reader would rather have +a link to a document in a different language than to have +a broken link. + + + + + + + +olink.properties +Properties associated with the cross-reference +text of an olink. + + + + +<xsl:attribute-set name="olink.properties"> +</xsl:attribute-set> + + + +Description + +This attribute set is used on cross reference text +from an olink. It is not applied to the +optional page number or +optional title of the external document. + + + + + + +prefer.internal.olink +boolean + + +prefer.internal.olink +Prefer a local olink reference to an external reference + + + + +<xsl:param name="prefer.internal.olink" select="0"></xsl:param> + + + +Description + +If you are re-using XML content modules in multiple documents, +you may want to redirect some of your olinks. This parameter +permits you to redirect an olink to the current document. + + +For example: you are writing documentation for a product, +which includes 3 manuals: a little installation +booklet (booklet.xml), a user +guide (user.xml), and a reference manual (reference.xml). +All 3 documents begin with the same introduction section (intro.xml) that +contains a reference to the customization section (custom.xml) which is +included in both user.xml and reference.xml documents. + + +How do you write the link to custom.xml in intro.xml +so that it is interpreted correctly in all 3 documents? + +If you use xref, it will fail in user.xml. + +If you use olink (pointing to reference.xml), +the reference in user.xml +will point to the customization section of the reference manual, while it is +actually available in user.xml. + + + +If you set the prefer.internal.olink +parameter to a non-zero value, then the processor will +first look in the olink database +for the olink's targetptr attribute value +in document matching the current.docid +parameter value. If it isn't found there, then +it tries the document in the database +with the targetdoc +value that matches the olink's targetdoc +attribute. + + +This feature permits an olink reference to resolve to +the current document if there is an element +with an id matching the olink's targetptr +value. The current document's olink data must be +included in the target database for this to work. + + +There is a potential for incorrect links if +the same id attribute value is used for different +content in different documents. +Some of your olinks may be redirected to the current document +when they shouldn't be. It is not possible to control +individual olink instances. + + + + + + + +target.database.document +uri + + +target.database.document +Name of master database file for resolving +olinks + + +<xsl:param name="target.database.document" select="''"></xsl:param> + + + +Description + +To resolve olinks between documents, the stylesheets use +a master database document that identifies the target datafiles for all the documents within the scope +of the olinks. This parameter value is the URI of +the master document to be read during processing to resolve olinks. +The default value is olinkdb.xml. +The data structure of the file is defined in the targetdatabase.dtd DTD. The database file provides the high level elements to record the identifiers, locations, and relationships of documents. The cross reference data for individual documents is generally pulled into the database using system entity references or XIncludes. See also targets.filename. + + + + + + + +targets.filename +string + + +targets.filename +Name of cross reference targets data file + + +<xsl:param name="targets.filename" select="'target.db'"></xsl:param> + + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter lets you change the name of the generated +file from the default name target.db. +The name must agree with that used in the target database +used to resolve olinks during processing. +See also target.database.document. + + + + + + +use.local.olink.style +boolean + + +use.local.olink.style +Process olinks using xref style of current +document + + +<xsl:param name="use.local.olink.style" select="0"></xsl:param> + + +Description +When cross reference data is collected for use by olinks, the data for each potential target includes one field containing a completely assembled cross reference string, as if it were an xref generated in that document. Other fields record the separate title, number, and element name of each target. When an olink is formed to a target from another document, the olink resolves to that preassembled string by default. If the use.local.olink.style parameter is set to non-zero, then instead the cross +reference string is formed again from the target title, number, and +element name, using the stylesheet processing the targeting document. +Then olinks will match the xref style in the targeting document +rather than in the target document. If both documents are processed +with the same stylesheet, then the results will be the same. + + + + + +Cross References + + +insert.xref.page.number +string + + +insert.xref.page.number +Turns page numbers in xrefs on and off + + + + +<xsl:param name="insert.xref.page.number">no</xsl:param> + + + +Description + +The value of this parameter determines if +cross references (xrefs) in +printed output will +include page number citations. +It has three possible values. + + + +no +No page number references will be generated. + + + +yes +Page number references will be generated +for all xref elements. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an xref element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + + + + + + + +xref.properties +Properties associated with cross-reference text + + + + +<xsl:attribute-set name="xref.properties"> +</xsl:attribute-set> + + + +Description + +This attribute set is used to set properties +on cross reference text. + + + + + + +xref.label-title.separator +string + + +xref.label-title.separator +Punctuation or space separating label from title in xref + + + +<xsl:param name="xref.label-title.separator">: </xsl:param> + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and title, +then the value of this parameter is inserted between +label and title in the output. + + + + + + + +xref.label-page.separator +string + + +xref.label-page.separator +Punctuation or space separating label from page number in xref + + + +<xsl:param name="xref.label-page.separator"><xsl:text> </xsl:text></xsl:param> + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and page +but no title, +then the value of this parameter is inserted between +label and page number in the output. +If a title is included, then other separators are used. + + + + + + + +xref.title-page.separator +string + + +xref.title-page.separator +Punctuation or space separating title from page number in xref + + + +<xsl:param name="xref.title-page.separator"><xsl:text> </xsl:text></xsl:param> + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both title and page number, +then the value of this parameter is inserted between +title and page number in the output. + + + + + + + +insert.link.page.number +string + + +insert.link.page.number +Turns page numbers in link elements on and off + + + + +<xsl:param name="insert.link.page.number">no</xsl:param> + + + +Description + +The value of this parameter determines if +cross references using the link element in +printed output will +include standard page number citations. +It has three possible values. + + + +no +No page number references will be generated. + + + +yes +Page number references will be generated +for all link elements. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for a link element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + + +Although the xrefstyle attribute +can be used to turn the page reference on or off, it cannot be +used to control the formatting of the page number as it +can in xref. +In link it will always format with +the style established by the +gentext template with name="page.citation" +in the l:context name="xref". + + + + + + +Lists + + +compact.list.item.spacing +What space do you want between list items (when spacing=compact)? + + + +<xsl:attribute-set name="compact.list.item.spacing"> + <xsl:attribute name="space-before.optimum">0em</xsl:attribute> + <xsl:attribute name="space-before.minimum">0em</xsl:attribute> + <xsl:attribute name="space-before.maximum">0.2em</xsl:attribute> +</xsl:attribute-set> + +Description +Specify what spacing you want between each list item when +spacing is +compact. + + + + + +itemizedlist.properties +Properties that apply to each list-block generated by itemizedlist. + + + +<xsl:attribute-set name="itemizedlist.properties" use-attribute-sets="list.block.properties"> +</xsl:attribute-set> + +Description +Properties that apply to each fo:list-block generated by itemizedlist. + + + + + +itemizedlist.label.properties +Properties that apply to each label inside itemized list. + + + +<xsl:attribute-set name="itemizedlist.label.properties"> +</xsl:attribute-set> + +Description +Properties that apply to each label inside itemized list. E.g.: +<xsl:attribute-set name="itemizedlist.label.properties"> + <xsl:attribute name="text-align">right</xsl:attribute> +</xsl:attribute-set> + + + + + +itemizedlist.label.width +The default width of the label (bullet) in an itemized list. + + + + +<xsl:param name="itemizedlist.label.width" select="'1.0em'"></xsl:param> + + + +Description +Specifies the default width of the label (usually a bullet or other +symbol) in an itemized list. You can override the default value on any +particular list with the “dbfo” processing instruction using the +“label-width” pseudoattribute. + + + + + +list.block.properties +Properties that apply to each list-block generated by list. + + + +<xsl:attribute-set name="list.block.properties"> + <xsl:attribute name="provisional-label-separation">0.2em</xsl:attribute> + <xsl:attribute name="provisional-distance-between-starts">1.5em</xsl:attribute> +</xsl:attribute-set> + +Description +Properties that apply to each fo:list-block generated by itemizedlist/orderedlist. + + + + + +list.block.spacing +What spacing do you want before and after lists? + + + +<xsl:attribute-set name="list.block.spacing"> + <xsl:attribute name="space-before.optimum">1em</xsl:attribute> + <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> + <xsl:attribute name="space-after.optimum">1em</xsl:attribute> + <xsl:attribute name="space-after.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-after.maximum">1.2em</xsl:attribute> +</xsl:attribute-set> + +Description +Specify the spacing required before and after a list. It is necessary to specify the space after a list block because lists can come inside of paras. + + + + + +list.item.spacing +What space do you want between list items? + + + +<xsl:attribute-set name="list.item.spacing"> + <xsl:attribute name="space-before.optimum">1em</xsl:attribute> + <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> +</xsl:attribute-set> + +Description +Specify what spacing you want between each list item. + + + + + +orderedlist.properties +Properties that apply to each list-block generated by orderedlist. + + + +<xsl:attribute-set name="orderedlist.properties" use-attribute-sets="list.block.properties"> + <xsl:attribute name="provisional-distance-between-starts">2em</xsl:attribute> +</xsl:attribute-set> + +Description +Properties that apply to each fo:list-block generated by orderedlist. + + + + + +orderedlist.label.properties +Properties that apply to each label inside ordered list. + + + +<xsl:attribute-set name="orderedlist.label.properties"> +</xsl:attribute-set> + +Description +Properties that apply to each label inside ordered list. E.g.: +<xsl:attribute-set name="orderedlist.label.properties"> + <xsl:attribute name="text-align">right</xsl:attribute> +</xsl:attribute-set> + + + + + +orderedlist.label.width +The default width of the label (number) in an ordered list. + + + + +<xsl:param name="orderedlist.label.width" select="'1.2em'"></xsl:param> + + + +Description +Specifies the default width of the label (usually a number or +sequence of numbers) in an ordered list. You can override the default +value on any particular list with the “dbfo” processing instruction +using the “label-width” pseudoattribute. + + + + + +variablelist.max.termlength + + + +variablelist.max.termlength +Specifies the longest term in variablelists + + + + +<xsl:param name="variablelist.max.termlength">24</xsl:param> + + + +Description + +In variablelists, the listitem +is indented to leave room for the +term elements. That indent may be computed +if it is not specified with a termlength +attribute on the variablelist element. + + +The computation counts characters in the +term elements in the list +to find the longest term. However, some terms are very long +and would produce extreme indents. This parameter lets you +set a maximum character count. Any terms longer than the maximum +would line wrap. The default value is 24. + + +The character counts are converted to physical widths +by multiplying by 0.50em. There will be some variability +in how many actual characters fit in the space +since some characters are wider than others. + + + + + + + +variablelist.term.separator +string + + +variablelist.term.separator +Text to separate terms within a multi-term +varlistentry + + + + +<xsl:param name="variablelist.term.separator">, </xsl:param> + + +Description + +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is placed +after each term except the last. + + + To generate a line break between multiple terms in + a varlistentry, set a non-zero value for the + variablelist.term.break.after parameter. If + you do so, you may also want to set the value of the + variablelist.term.separator parameter to an + empty string (to suppress rendering of the default comma and space + after each term). + + + + + + + +variablelist.term.break.after +boolean + + +variablelist.term.break.after +Generate line break after each term within a +multi-term varlistentry? + + + + +<xsl:param name="variablelist.term.break.after">0</xsl:param> + + +Description + +Set a non-zero value for the +variablelist.term.break.after parameter to +generate a line break between terms in a +multi-term varlistentry. + + +If you set a non-zero value for +variablelist.term.break.after, you may also +want to set the value of the +variablelist.term.separator parameter to an +empty string (to suppress rendering of the default comma and space +after each term). + + + + + + + +QAndASet + + +qandadiv.autolabel +boolean + + +qandadiv.autolabel +Are divisions in QAndASets enumerated? + + + +<xsl:param name="qandadiv.autolabel" select="1"></xsl:param> + + +Description + +If true (non-zero), unlabeled qandadivs will be enumerated. + + + + + + + +qanda.inherit.numeration +boolean + + +qanda.inherit.numeration +Does enumeration of QandASet components inherit the numeration of parent elements? + + + +<xsl:param name="qanda.inherit.numeration" select="1"></xsl:param> + + +Description + +If true (non-zero), numbered QandADiv elements and Questions and Answers inherit +the numeration of the ancestors of the QandASet. + + + + + + + +qanda.defaultlabel +boolean + + +qanda.defaultlabel +Sets the default for defaultlabel on QandASet. + + + +<xsl:param name="qanda.defaultlabel">number</xsl:param> + + +Description + +If no defaultlabel attribute is specified on a QandASet, this +value is used. It must be one of the legal values for the defaultlabel +attribute. + + + + + + + +Bibliography + + +biblioentry.item.separator +string + + +biblioentry.item.separator +Text to separate bibliography entries + + + +<xsl:param name="biblioentry.item.separator">. </xsl:param> + + +Description + +Text to separate bibliography entries + + + + + + + +bibliography.collection +string + + +bibliography.collection +Name of the bibliography collection file + + + +<xsl:param name="bibliography.collection" select="'http://docbook.sourceforge.net/release/bibliography/bibliography.xml'"></xsl:param> + + +Description + +Maintaining bibliography entries across a set of documents is tedious, time +consuming, and error prone. It makes much more sense, usually, to store all of +the bibliography entries in a single place and simply extract +the ones you need in each document. + +That's the purpose of the +bibliography.collection parameter. To setup a global +bibliography database, follow these steps: + +First, create a stand-alone bibliography document that contains all of +the documents that you wish to reference. Make sure that each bibliography +entry (whether you use biblioentry or bibliomixed) +has an ID. + +My global bibliography, ~/bibliography.xml begins +like this: + + +<!DOCTYPE bibliography + PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<bibliography><title>References</title> + +<bibliomixed id="xml-rec"><abbrev>XML 1.0</abbrev>Tim Bray, +Jean Paoli, C. M. Sperberg-McQueen, and Eve Maler, editors. +<citetitle><ulink url="http://www.w3.org/TR/REC-xml">Extensible Markup +Language (XML) 1.0 Second Edition</ulink></citetitle>. +World Wide Web Consortium, 2000. +</bibliomixed> + +<bibliomixed id="xml-names"><abbrev>Namespaces</abbrev>Tim Bray, +Dave Hollander, +and Andrew Layman, editors. +<citetitle><ulink url="http://www.w3.org/TR/REC-xml-names/">Namespaces in +XML</ulink></citetitle>. +World Wide Web Consortium, 1999. +</bibliomixed> + +<!-- ... --> +</bibliography> + + + +When you create a bibliography in your document, simply +provide empty bibliomixed +entries for each document that you wish to cite. Make sure that these +elements have the same ID as the corresponding real +entry in your global bibliography. + +For example: + + +<bibliography><title>Bibliography</title> + +<bibliomixed id="xml-rec"/> +<bibliomixed id="xml-names"/> +<bibliomixed id="DKnuth86">Donald E. Knuth. <citetitle>Computers and +Typesetting: Volume B, TeX: The Program</citetitle>. Addison-Wesley, +1986. ISBN 0-201-13437-3. +</bibliomixed> +<bibliomixed id="relaxng"/> + +</bibliography> + + +Note that it's perfectly acceptable to mix entries from your +global bibliography with normal entries. You can use +xref or other elements to cross-reference your +bibliography entries in exactly the same way you do now. + +Finally, when you are ready to format your document, simply set the +bibliography.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global bibliography. + +The stylesheets will format the bibliography in your document as if +all of the entries referenced appeared there literally. + + + + + + +bibliography.numbered +boolean + + +bibliography.numbered +Should bibliography entries be numbered? + + + + +<xsl:param name="bibliography.numbered" select="0"></xsl:param> + + + +Description + +If non-zero bibliography entries will be numbered + + + + + + +biblioentry.properties +To set the style for biblioentry. + + + +<xsl:attribute-set name="biblioentry.properties" use-attribute-sets="normal.para.spacing"> + <xsl:attribute name="start-indent">0.5in</xsl:attribute> + <xsl:attribute name="text-indent">-0.5in</xsl:attribute> +</xsl:attribute-set> + + +Description +How do you want biblioentry styled? +Set the font-size, weight, space-above and space-below, indents, etc. to the style required + + + + + + +Glossary + + +glossterm.auto.link +boolean + + +glossterm.auto.link +Generate links from glossterm to glossentry automaticaly? + + + + +<xsl:param name="glossterm.auto.link" select="0"></xsl:param> + + + +Description + +If true, a link will be automatically created from glossterm +to glossentry for that glossary term. This is usefull when your +glossterm names are consistent and you don't want to add links +manually. +If there is linkend on +glossterm then is used instead of autogeneration of +link. + + + + + + +firstterm.only.link +boolean + + +firstterm.only.link +Does automatic glossterm linking only apply to firstterms? + + + + +<xsl:param name="firstterm.only.link" select="0"></xsl:param> + + + +Description + +If true, only firstterms will be automatically linked +to the glossary. If glossary linking is not enabled, this parameter +has no effect. + + + + + + +glossary.collection +string + + +glossary.collection +Name of the glossary collection file + + + + +<xsl:param name="glossary.collection" select="''"></xsl:param> + + + +Description + +Glossaries maintained independently across a set of documents +are likely to become inconsistent unless considerable effort is +expended to keep them in sync. It makes much more sense, usually, to +store all of the glossary entries in a single place and simply +extract the ones you need in each document. + +That's the purpose of the +glossary.collection parameter. To setup a global +glossary database, follow these steps: + +Setting Up the Glossary Database + +First, create a stand-alone glossary document that contains all of +the entries that you wish to reference. Make sure that each glossary +entry has an ID. + +Here's an example glossary: + + + +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE glossary + PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<glossary> +<glossaryinfo> +<editor><firstname>Eric</firstname><surname>Raymond</surname></editor> +<title>Jargon File 4.2.3 (abridged)</title> +<releaseinfo>Just some test data</releaseinfo> +</glossaryinfo> + +<glossdiv><title>0</title> + +<glossentry> +<glossterm>0</glossterm> +<glossdef> +<para>Numeric zero, as opposed to the letter `O' (the 15th letter of +the English alphabet). In their unmodified forms they look a lot +alike, and various kluges invented to make them visually distinct have +compounded the confusion. If your zero is center-dotted and letter-O +is not, or if letter-O looks almost rectangular but zero looks more +like an American football stood on end (or the reverse), you're +probably looking at a modern character display (though the dotted zero +seems to have originated as an option on IBM 3270 controllers). If +your zero is slashed but letter-O is not, you're probably looking at +an old-style ASCII graphic set descended from the default typewheel on +the venerable ASR-33 Teletype (Scandinavians, for whom /O is a letter, +curse this arrangement). (Interestingly, the slashed zero long +predates computers; Florian Cajori's monumental "A History of +Mathematical Notations" notes that it was used in the twelfth and +thirteenth centuries.) If letter-O has a slash across it and the zero +does not, your display is tuned for a very old convention used at IBM +and a few other early mainframe makers (Scandinavians curse <emphasis>this</emphasis> +arrangement even more, because it means two of their letters collide). +Some Burroughs/Unisys equipment displays a zero with a <emphasis>reversed</emphasis> +slash. Old CDC computers rendered letter O as an unbroken oval and 0 +as an oval broken at upper right and lower left. And yet another +convention common on early line printers left zero unornamented but +added a tail or hook to the letter-O so that it resembled an inverted +Q or cursive capital letter-O (this was endorsed by a draft ANSI +standard for how to draw ASCII characters, but the final standard +changed the distinguisher to a tick-mark in the upper-left corner). +Are we sufficiently confused yet?</para> +</glossdef> +</glossentry> + +<glossentry> +<glossterm>1TBS</glossterm> +<glossdef> +<para role="accidence"> +<phrase role="pronounce"></phrase> +<phrase role="partsofspeach">n</phrase> +</para> +<para>The "One True Brace Style"</para> +<glossseealso>indent style</glossseealso> +</glossdef> +</glossentry> + +<!-- ... --> + +</glossdiv> + +<!-- ... --> + +</glossary> + + + + +Marking Up Glossary Terms + +That takes care of the glossary database, now you have to get the entries +into your document. Unlike bibliography entries, which can be empty, creating +placeholder glossary entries would be very tedious. So instead, +support for glossary.collection relies on implicit linking. + +In your source document, simply use firstterm and +glossterm to identify the terms you wish to have included +in the glossary. The stylesheets assume that you will either set the +baseform attribute correctly, or that the +content of the element exactly matches a term in your glossary. + +If you're using a glossary.collection, don't +make explicit links on the terms in your document. + +So, in your document, you might write things like this: + + +<para>This is dummy text, without any real meaning. +The point is simply to reference glossary terms like <glossterm>0</glossterm> +and the <firstterm baseform="1TBS">One True Brace Style (1TBS)</firstterm>. +The <glossterm>1TBS</glossterm>, as you can probably imagine, is a nearly +religious issue.</para> + + +If you set the firstterm.only.link parameter, +only the terms marked with firstterm will be links. +Otherwise, all the terms will be linked. + + + +Marking Up the Glossary + +The glossary itself has to be identified for the stylesheets. For lack +of a better choice, the role is used. +To identify the glossary as the target for automatic processing, set +the role to auto. The title of this +glossary (and any other information from the glossaryinfo +that's rendered by your stylesheet) will be displayed, but the entries will +come from the database. + + +Unfortunately, the glossary can't be empty, so you must put in +at least one glossentry. The content of this entry +is irrelevant, it will not be rendered: + + +<glossary role="auto"> +<glossentry> +<glossterm>Irrelevant</glossterm> +<glossdef> +<para>If you can see this, the document was processed incorrectly. Use +the <parameter>glossary.collection</parameter> parameter.</para> +</glossdef> +</glossentry> +</glossary> + + +What about glossary divisions? If your glossary database has glossary +divisions and your automatic glossary contains at least +one glossdiv, the automic glossary will have divisions. +If the glossdiv is missing from either location, no divisions +will be rendered. + +Glossary entries (and divisions, if appropriate) in the glossary will +occur in precisely the order they occur in your database. + + + +Formatting the Document + +Finally, when you are ready to format your document, simply set the +glossary.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global glossary. + +The stylesheets will format the glossary in your document as if +all of the entries implicilty referenced appeared there literally. + + +Limitations + +Glossary cross-references within the glossary are +not supported. For example, this will not work: + + +<glossentry> +<glossterm>gloss-1</glossterm> +<glossdef><para>A description that references <glossterm>gloss-2</glossterm>.</para> +<glossseealso>gloss-2</glossseealso> +</glossdef> +</glossentry> + + +If you put glossary cross-references in your glossary that way, +you'll get the cryptic error: Warning: +glossary.collection specified, but there are 0 automatic +glossaries. + +Instead, you must do two things: + + + +Markup your glossary using glossseealso: + + +<glossentry> +<glossterm>gloss-1</glossterm> +<glossdef><para>A description that references <glossterm>gloss-2</glossterm>.</para> +<glossseealso>gloss-2</glossseealso> +</glossdef> +</glossentry> + + + + +Make sure there is at least one glossterm reference to +gloss-2 in your document. The +easiest way to do that is probably within a remark in your +automatic glossary: + + +<glossary role="auto"> +<remark>Make sure there's a reference to <glossterm>gloss-2</glossterm>.</remark> +<glossentry> +<glossterm>Irrelevant</glossterm> +<glossdef> +<para>If you can see this, the document was processed incorrectly. Use +the <parameter>glossary.collection</parameter> parameter.</para> +</glossdef> +</glossentry> +</glossary> + + + + + + + + + + +glossterm.separation +length + + +glossterm.separation +Separation between glossary terms and descriptions in list mode + + + + +<xsl:param name="glossterm.separation" select="'0.25in'"></xsl:param> + + + +Description + +Specifies the separation between glossary terms and descriptions when +glossarys are presented using lists. + + + + + + +glossterm.width +length + + +glossterm.width +Width of glossterm in list presentation mode + + + + +<xsl:param name="glossterm.width" select="'2in'"></xsl:param> + + + +Description + +This parameter specifies the width reserved for glossary terms when +a list presentation is used. + + + + + + +glossary.as.blocks +boolean + + +glossary.as.blocks +Present glossarys using blocks instead of lists? + + + + +<xsl:param name="glossary.as.blocks" select="0"></xsl:param> + + + +Description + +If non-zero, glossarys will be formatted as +blocks. + +If you have long glossterms, proper list +markup in the FO case may produce unattractive lists. By setting this +parameter, you can force the stylesheets to produce block markup +instead of proper lists. + +You can override this setting with a processing instruction as the +child of glossary: dbfo +glossary-presentation="blocks" or dbfo +glossary-presentation="list" + + + + + + +glosslist.as.blocks +boolean + + +glosslist.as.blocks +Use blocks for glosslists? + + + + +<xsl:param name="glosslist.as.blocks" select="0"></xsl:param> + + + +Description + +See glossary.as.blocks. + + + + + + +glossentry.show.acronym +list + + +glossentry.show.acronym +Display glossentry acronyms? + + + + +<xsl:param name="glossentry.show.acronym" select="'no'"></xsl:param> + + + +Description + +A setting of yes means they should be displayed; +no means they shouldn't. If primary is used, +then they are shown as the primary text for the entry. + + +This setting controls both acronym and +abbrev elements in the glossentry. + + + + + + + +Miscellaneous + + +formal.procedures +boolean + + +formal.procedures +Selects formal or informal procedures + + + + +<xsl:param name="formal.procedures" select="1"></xsl:param> + + + +Description + +Formal procedures are numbered and always have a title. + + + + + + + +formal.title.placement + + + +formal.title.placement +Specifies where formal object titles should occur + + + + +<xsl:param name="formal.title.placement"> +figure before +example before +equation before +table before +procedure before +task before +</xsl:param> + + + +Description + +Specifies where formal object titles should occur. For each formal object +type (figure, +example, +equation, +table, and procedure) +you can specify either the keyword +before or +after. + + + + + + +runinhead.default.title.end.punct +string + + +runinhead.default.title.end.punct +Default punctuation character on a run-in-head + + + +<xsl:param name="runinhead.default.title.end.punct" select="'.'"></xsl:param> + + +Description + +FIXME: + + + + + + + +runinhead.title.end.punct +string + + +runinhead.title.end.punct +Characters that count as punctuation on a run-in-head + + + +<xsl:param name="runinhead.title.end.punct" select="'.!?:'"></xsl:param> + + +Description + +FIXME: + + + + + + + +show.comments +boolean + + +show.comments +Display comment elements? + + + +<xsl:param name="show.comments">1</xsl:param> + + +Description + +If true (non-zero), comments will be displayed, otherwise they are suppressed. +Comments here refers to the comment element, +which will be renamed remark in DocBook V4.0, +not XML comments (<-- like this -->) which are unavailable. + + + + + + + +punct.honorific +string + + +punct.honorific +Punctuation after an honorific in a personal name. + + + + +<xsl:param name="punct.honorific" select="'.'"></xsl:param> + + + +Description + +This parameter specifies the punctuation that should be added after an +honorific in a personal name. + + + + + + +segmentedlist.as.table +boolean + + +segmentedlist.as.table +Format segmented lists as tables? + + + + +<xsl:param name="segmentedlist.as.table" select="0"></xsl:param> + + + +Description + +If non-zero, segmentedlists will be formatted as +tables. + + + + + + +variablelist.as.blocks +boolean + + +variablelist.as.blocks +Format variablelists lists as blocks? + + + + +<xsl:param name="variablelist.as.blocks" select="0"></xsl:param> + + + +Description + +If non-zero, variablelists will be formatted as +blocks. + +If you have long terms, proper list markup in the FO case may produce +unattractive lists. By setting this parameter, you can force the stylesheets +to produce block markup instead of proper lists. + +You can override this setting with a processing instruction as the +child of variablelist: dbfo +list-presentation="blocks" or dbfo +list-presentation="list". + +When using list-presentation="list", +you can also control the amount of space used for the terms with +the dbfo term-width=".25in" processing instruction, +the termlength attribute on variablelist, +or allow the stylesheets to attempt to calculate the amount of space to leave based on the +number of letters in the longest term. + + + <variablelist> + <?dbfo list-presentation="list"?> + <?dbfo term-width="1.5in"?> + <?dbhtml list-presentation="table"?> + <?dbhtml term-width="1.5in"?> + <varlistentry> + <term>list</term> + <listitem> + <para> + Formatted as a list even if variablelist.as.blocks is set to 1. + </para> + </listitem> + </varlistentry> + </variablelist> + + + + + + + + +blockquote.properties +To set the style for block quotations. + + + + +<xsl:attribute-set name="blockquote.properties"> +<xsl:attribute name="margin-left">0.5in</xsl:attribute> +<xsl:attribute name="margin-right">0.5in</xsl:attribute> +<xsl:attribute name="space-after.minimum">0.5em</xsl:attribute> +<xsl:attribute name="space-after.optimum">1em</xsl:attribute> +<xsl:attribute name="space-after.maximum">2em</xsl:attribute> +</xsl:attribute-set> + + + +Description + +The blockquote.properties attribute set specifies +the formating properties of block quotations. + + + + + + +ulink.show +boolean + + +ulink.show +Display URLs after ulinks? + + + + +<xsl:param name="ulink.show" select="1"></xsl:param> + + + +Description + +If non-zero, the URL of each ULink will +appear after the text of the link. If the text of the link and the URL +are identical, the URL is suppressed. + + + + + + +ulink.footnotes +boolean + + +ulink.footnotes +Generate footnotes for ULinks? + + + + +<xsl:param name="ulink.footnotes" select="0"></xsl:param> + + + +Description + +If non-zero, the URL of each ULink will +appear as a footnote. + + + + + + + +ulink.hyphenate +string + + +ulink.hyphenate +Allow URLs to be automatically hyphenated + + + + +<xsl:param name="ulink.hyphenate" select="''"></xsl:param> + + + +Description + +If not empty, the specified character (or more generally, content) is +added to URLs after every character included in the string +in the ulink.hyphenate.chars parameter (default +is /). If the character in this parameter is a +Unicode soft hyphen (0x00AD) or Unicode zero-width space (0x200B), some FO +processors will be able to reasonably hyphenate long URLs. + +As of 28 Jan 2002, discretionary hyphens are more widely and correctly +supported than zero-width spaces for this purpose. + + + + + + +ulink.hyphenate.chars +string + + +ulink.hyphenate.chars +List of characters to allow ulink URLs to be automatically hyphenated on + + + + +<xsl:param name="ulink.hyphenate.chars" select="'/'"></xsl:param> + + + +Description + +If the ulink.hyphenate is not empty, then +hyphenation of ulinks is turned on, and any +character contained in this parameter is treated as an allowable +hyphenation point. + +The default value is /, but the parameter +could be customized +to contain other URL characters, as for example: + +<xsl:param name="ulink.hyphenate.chars">:/@&?.#</xsl:param> + + + + + + + +shade.verbatim +boolean + + +shade.verbatim +Should verbatim environments be shaded? + + + +<xsl:param name="shade.verbatim" select="0"></xsl:param> + + +Description + +In the FO stylesheet, if this parameter is non-zero then the +shade.verbatim.style properties will be applied +to verbatim environments. + +In the HTML stylesheet, this parameter is now deprecated. Use +CSS instead. + + + + + + +shade.verbatim.style + + + +shade.verbatim.style +Properties that specify the style of shaded verbatim listings + + + + + +<xsl:attribute-set name="shade.verbatim.style"> + <xsl:attribute name="background-color">#E0E0E0</xsl:attribute> +</xsl:attribute-set> + + + +Description + +FIXME: + + + + + + +hyphenate.verbatim +boolean + + +hyphenate.verbatim +Should verbatim environments be hyphenated on space characters? + + + +<xsl:param name="hyphenate.verbatim" select="0"></xsl:param> + + +Description + +If the lines of program listing are too long to fit into one +line it is quite common to split them at space and indicite by hook +arrow that code continues on the next line. You can turn on this +behaviour for programlisting, +screen and synopsis elements by +using this parameter. + +Note that you must also enable line wrapping for verbatim environments and +select appropriate hyphenation character (e.g. hook arrow). This can +be done using monospace.verbatim.properties +attribute set: + +<xsl:attribute-set name="monospace.verbatim.properties" + use-attribute-sets="verbatim.properties monospace.properties"> + <xsl:attribute name="wrap-option">wrap</xsl:attribute> + <xsl:attribute name="hyphenation-character">&#x25BA;</xsl:attribute> +</xsl:attribute-set> + +For a list of arrows available in Unicode see and and make sure that +selected character is available in the font you are using for verbatim +environments. + + + + + + +hyphenate.verbatim.characters +string + + +hyphenate.verbatim.characters +List of characters after which line break can occur in listings + + + +<xsl:param name="hyphenate.verbatim.characters" select="''"></xsl:param> + + +Description + +If you enable hyphenate.verbatim line +breaks are allowed only on space characters. If this is not enough for +your document, you can specify list of additional characters after +which line break is allowed in this parameter. + + + + + + +use.svg +boolean + + +use.svg +Allow SVG in the result tree? + + + + +<xsl:param name="use.svg" select="1"></xsl:param> + + + +Description + +If non-zero, SVG will be considered an acceptable image format. SVG +is passed through to the result tree, so correct rendering of the resulting +diagram depends on the formatter (FO processor or web browser) that is used +to process the output from the stylesheet. + + + + + + +use.role.as.xrefstyle +boolean + + +use.role.as.xrefstyle +Use role attribute for +xrefstyle on xref? + + + + +<xsl:param name="use.role.as.xrefstyle" select="1"></xsl:param> + + + +Description + +If non-zero, the role attribute on +xref will be used to select the cross reference style. +The DocBook +Technical Committee recently added an +xrefstyle attribute for this purpose. +If the xrefstyle attribute +is present, role will be ignored, regardless +of this setting. + +Until an official DocBook release that includes the new +attribute, this flag allows role +to serve that purpose. + + + +Example + +The following small stylesheet shows how to configure the stylesheets to make +use of the cross reference style: + +<?xml version="1.0"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<xsl:import href="../xsl/html/docbook.xsl"/> + +<xsl:output method="html"/> + +<xsl:param name="local.l10n.xml" select="document('')"/> +<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"> + <l:l10n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" language="en"> + <l:context name="xref"> + <l:template name="chapter" style="title" text="Chapter %n, %t"/> + <l:template name="chapter" text="Chapter %n"/> + </l:context> + </l:l10n> +</l:i18n> + +</xsl:stylesheet> + +With this stylesheet, the cross references in the following document: + +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> +<book id="book"><title>Book</title> + +<preface> +<title>Preface</title> + +<para>Normal: <xref linkend="ch1"/>.</para> +<para>Title: <xref xrefstyle="title" linkend="ch1"/>.</para> + +</preface> + +<chapter id="ch1"> +<title>First Chapter</title> + +<para>Irrelevant.</para> + +</chapter> +</book> + +will appear as: + + +Normal: Chapter 1. +Title: Chapter 1, First Chapter. + + + + + + + +menuchoice.separator + + + +menuchoice.separator +Separator between items of a menuchoice +other than guimenuitem and +guisubmenu + + + + +<xsl:param name="menuchoice.separator" select="'+'"></xsl:param> + + + +Description + +Separator used to connect items of a menuchoice other +than guimenuitem and guisubmenu. The latter +elements are linked with menuchoice.menu.separator. + + + + + + + +menuchoice.menu.separator + + + +menuchoice.menu.separator +Separator between items of a menuchoice +with guimenuitem or +guisubmenu + + + + +<xsl:param name="menuchoice.menu.separator"> → </xsl:param> + + + +Description + +Separator used to connect items of a menuchoice with +guimenuitem or guisubmenu. Other elements +are linked with menuchoice.separator. + +The default value is &#x2192;, which is the +&rarr; (right arrow) character entity. +The current FOP (0.20.5) requires setting the font-family +explicitly. + +The default value also includes spaces around the arrow, +which will allow a line to break. Replace the spaces with +&#xA0; (nonbreaking space) if you don't want those +spaces to break. + + + + + + + +default.float.class +string + + +default.float.class +Specifies the default float class + + + + +<xsl:param name="default.float.class"> + <xsl:choose> + <xsl:when test="contains($stylesheet.result.type,'html')">left</xsl:when> + <xsl:otherwise>before</xsl:otherwise> + </xsl:choose> +</xsl:param> + + + +Description + +FIXME: + + + + + + +footnote.number.format +string + + +footnote.number.format +Identifies the format used for footnote numbers + + + + +<xsl:param name="footnote.number.format" select="'1'"></xsl:param> + + + +Description + +The footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A). + + + + + + +table.footnote.number.format +string + + +table.footnote.number.format +Identifies the format used for footnote numbers in tables + + + + +<xsl:param name="table.footnote.number.format" select="'a'"></xsl:param> + + + +Description + +The table.footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A) in tables. + + + + + + +footnote.number.symbols + + + +footnote.number.symbols +Special characters to use as footnote markers + + + + +<xsl:param name="footnote.number.symbols" select="''"></xsl:param> + + + +Description + +If footnote.number.symbols is not the empty string, +footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + + + + +table.footnote.number.symbols + + + +table.footnote.number.symbols +Special characters to use a footnote markers in tables + + + + +<xsl:param name="table.footnote.number.symbols" select="''"></xsl:param> + + + +Description + +If table.footnote.number.symbols is not the empty string, +table footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +table.footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + + + + +footnote.properties +Properties applied to each footnote body + + + + + +<xsl:attribute-set name="footnote.properties"> + <xsl:attribute name="font-family"><xsl:value-of select="$body.fontset"></xsl:value-of></xsl:attribute> + <xsl:attribute name="font-size"><xsl:value-of select="$footnote.font.size"></xsl:value-of></xsl:attribute> + <xsl:attribute name="font-weight">normal</xsl:attribute> + <xsl:attribute name="font-style">normal</xsl:attribute> + <xsl:attribute name="text-align"><xsl:value-of select="$alignment"></xsl:value-of></xsl:attribute> + <xsl:attribute name="start-indent">0pt</xsl:attribute> + <xsl:attribute name="text-indent">0pt</xsl:attribute> +</xsl:attribute-set> + + + +Description + +This attribute set is applied to the footnote-block +for each footnote. +It can be used to set the +font-size, font-family, and other inheritable properties that will be +applied to all footnotes. + + + + + + +table.footnote.properties +Properties applied to each table footnote body + + + + + +<xsl:attribute-set name="table.footnote.properties"> + <xsl:attribute name="font-family"><xsl:value-of select="$body.fontset"></xsl:value-of></xsl:attribute> + <xsl:attribute name="font-size"><xsl:value-of select="$footnote.font.size"></xsl:value-of></xsl:attribute> + <xsl:attribute name="font-weight">normal</xsl:attribute> + <xsl:attribute name="font-style">normal</xsl:attribute> + <xsl:attribute name="space-before">2pt</xsl:attribute> + <xsl:attribute name="text-align"><xsl:value-of select="$alignment"></xsl:value-of></xsl:attribute> +</xsl:attribute-set> + + + +Description + +This attribute set is applied to the footnote-block +for each table footnote. +It can be used to set the +font-size, font-family, and other inheritable properties that will be +applied to all table footnotes. + + + + + + +footnote.mark.properties +Properties applied to each footnote mark + + + + + +<xsl:attribute-set name="footnote.mark.properties"> + <xsl:attribute name="font-size">75%</xsl:attribute> + <xsl:attribute name="font-weight">normal</xsl:attribute> + <xsl:attribute name="font-style">normal</xsl:attribute> +</xsl:attribute-set> + + + +Description + +This attribute set is applied to the footnote mark used +for each footnote. +It should contain only inline properties. + + +The property to make the mark a superscript is contained in the +footnote template itself, because the current version of FOP reports +an error if baseline-shift is used. + + + + + + + +footnote.sep.leader.properties +Properties associated with a procedure + + + + +<xsl:attribute-set name="footnote.sep.leader.properties"> + <xsl:attribute name="color">black</xsl:attribute> + <xsl:attribute name="leader-pattern">rule</xsl:attribute> + <xsl:attribute name="leader-length">1in</xsl:attribute> +</xsl:attribute-set> + + + +Description + +The styling for the rule line that separates the +footnotes from the body text. +These are properties applied to the fo:leader used as +the separator. + +If you want to do more than just set properties on +the leader element, then you can customize the template +named footnote.separator in +fo/pagesetup.xsl. + + + + + + +xref.with.number.and.title +boolean + + +xref.with.number.and.title +Use number and title in cross references + + + + +<xsl:param name="xref.with.number.and.title" select="1"></xsl:param> + + + +Description + +FIXME: + + + + + + +superscript.properties + + + +superscript.properties +Properties associated with superscripts + + + + +<xsl:attribute-set name="superscript.properties"> + <xsl:attribute name="font-size">75%</xsl:attribute> +</xsl:attribute-set> + + + +Description + +Specifies styling properties for superscripts. + + + + + + +subscript.properties + + + +subscript.properties +Properties associated with subscripts + + + + +<xsl:attribute-set name="subscript.properties"> + <xsl:attribute name="font-size">75%</xsl:attribute> +</xsl:attribute-set> + + + +Description + +Specifies styling properties for subscripts. + + + + + + +pgwide.properties +Properties to make a figure or table page wide. + + + + + +<xsl:attribute-set name="pgwide.properties"> + <xsl:attribute name="start-indent">0pt</xsl:attribute> +</xsl:attribute-set> + + + +Description + +This attribute set is used to set the properties +that make a figure or table "page wide" in fo output. +It comes into effect when an attribute pgwide="1" +is used. + + + +By default, it sets start-indent +to 0pt. +In a stylesheet that sets the parameter +body.start.indent +to a non-zero value in order to indent body text, +this attribute set can be used to outdent pgwide +figures to the left margin. + + +If a document uses a multi-column page layout, +then this attribute set could try setting span +to a value of all. However, this may +not work with some processors because a span property must be on an +fo:block that is a direct child of fo:flow. It may work in +some processors anyway. + + + + + + + +Graphics + + +graphic.default.extension +string + + +graphic.default.extension +Default extension for graphic filenames + + + +<xsl:param name="graphic.default.extension"></xsl:param> + + +Description + +If a graphic or mediaobject +includes a reference to a filename that does not include an extension, +and the format attribute is +unspecified, the default extension will be used. + + + + + + + +default.image.width +length + + +default.image.width +The default width of images + + + + +<xsl:param name="default.image.width" select="''"></xsl:param> + + + +Description + +If specified, this value will be used for the +width attribute on +images that do not specify any +viewport +dimensions. + + + + + + +preferred.mediaobject.role + + +preferred.mediaobject.role +Select which mediaobject to use based on +this value of an object's role attribute. + + + + + +<xsl:param name="preferred.mediaobject.role"></xsl:param> + + + +Description + +A mediaobject may contain several objects such as imageobjects. +If the parameter use.role.for.mediaobject +is non-zero, then the role attribute on +imageobjects and other objects within a mediaobject container will be used to select which object will be +used. If one of the objects has a role value that matches the +preferred.mediaobject.role parameter, then it has first +priority for selection. If more than one has such a +role value, the first one is used. + + +See the use.role.for.mediaobject parameter +for the sequence of selection. + + + + + +use.role.for.mediaobject +boolean + + +use.role.for.mediaobject +Use role attribute +value for selecting which of several objects within a mediaobject to use. + + + + + +<xsl:param name="use.role.for.mediaobject" select="1"></xsl:param> + + + +Description + +If non-zero, the role attribute on +imageobjects or other objects within a mediaobject container will be used to select which object will be +used. + + +The order of selection when then parameter is non-zero is: + + + + If the stylesheet parameter preferred.mediaobject.role has a value, then the object whose role equals that value is selected. + + +Else if an object's role attribute has a value of +html for HTML processing or +fo for FO output, then the first +of such objects is selected. + + + +Else the first suitable object is selected. + + + +If the value of +use.role.for.mediaobject +is zero, then role attributes are not considered +and the first suitable object +with or without a role value is used. + + + + + + +ignore.image.scaling +boolean + + +ignore.image.scaling +Tell the stylesheets to ignore the author's image scaling attributes + + + + +<xsl:param name="ignore.image.scaling" select="0"></xsl:param> + + + +Description + +If non-zero, the scaling attributes on graphics and media objects are +ignored. + + + + + + +img.src.path +string + + +img.src.path +Path to HTML image files + + + +<xsl:param name="img.src.path"></xsl:param> + + +Description + +Add a path prefix to each HTML +img or FO +fo:external-graphics element's +src attribute. +This path could relative to the directory where the HTML/FO +files are created, or it could be an absolute URI. +The default value is empty. +Be sure to include a trailing slash if needed. + +This prefix is not applied to any filerefs that start +with "/" or contain "//:". + + + + + + + +keep.relative.image.uris +boolean + + +keep.relative.image.uris +Should image URIs be resolved against xml:base? + + + + + +<xsl:param name="keep.relative.image.uris" select="0"></xsl:param> + + + +Description + +If non-zeor, relative URIs (in, for example fileref attributes) will +be used in the generated output. Otherwise, the URIs will be made absolute +with respect to the base URI. + +Note that the stylesheets calculate (and use) the absolute form +for some purposes, this only applies to the resulting output. + + + + + + +Pagination and General Styles + +
                  Understanding XSL FO Margins + +In order for the parameters in this section to make sense, it is useful to +consider . + +
                  + + + + +Figure showing page margins + +This figure shows the physical page with the various FO page regions +identified. + + +
                  + +First, let's consider the regions on the page. + +The white region is the physical page. Its dimensions are determined by +the page.height and page.width +parameters. + +The yellow region is the region-body. The size and placement of +the region body is constrained by the dimensions labelled in the +figure. + +The pink region at the top of the page is the region-before. The +darker area inside the region-before is the header text. In XSL, the default +display alignment for a region is before, but the +DocBook stylesheets still explicitly make it before. That's +why the darker area is at the top. + +The pink region at the bottom of the page is the region-after. +The darker area is the footer text. In XSL, the default display +alignment for a region is before, +but the DocBook stylesheets explicitly make it +after. That's why the darker area is at the bottom. + +The dimensions in the figure are: + + +The page-master margin-top. + +The region-before extent. + +The region-body margin-top. + +The region-after extent. + +The page-master margin-bottom. + +The region-body margin-bottom. + +The sum of the page-master margin-left and the +region-body margin-left. In DocBook, the region-body margin-left is +zero by default, so this is simply the page-master region-left. + +The sum of the page-master margin-right and the +region-body margin-right. In DocBook, the region-body margin-right is +zero by default, so this is simply the page-master region-left. + + + +
                  +                   + + + +page.height + + + +page.height +The height of the physical page + + + +<xsl:param name="page.height"> + <xsl:choose> + <xsl:when test="$page.orientation = 'portrait'"> + <xsl:value-of select="$page.height.portrait"></xsl:value-of> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$page.width.portrait"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> +</xsl:param> + + +Description + +The page height is generally calculated from the +paper.type and +page.orientation. + + + + + + + +page.height.portrait + + + +page.height.portrait +Specify the physical size of the long edge of the page + + + +<xsl:param name="page.height.portrait"> + <xsl:choose> + <xsl:when test="$paper.type = 'A4landscape'">210mm</xsl:when> + <xsl:when test="$paper.type = 'USletter'">11in</xsl:when> + <xsl:when test="$paper.type = 'USlandscape'">8.5in</xsl:when> + <xsl:when test="$paper.type = '4A0'">2378mm</xsl:when> + <xsl:when test="$paper.type = '2A0'">1682mm</xsl:when> + <xsl:when test="$paper.type = 'A0'">1189mm</xsl:when> + <xsl:when test="$paper.type = 'A1'">841mm</xsl:when> + <xsl:when test="$paper.type = 'A2'">594mm</xsl:when> + <xsl:when test="$paper.type = 'A3'">420mm</xsl:when> + <xsl:when test="$paper.type = 'A4'">297mm</xsl:when> + <xsl:when test="$paper.type = 'A5'">210mm</xsl:when> + <xsl:when test="$paper.type = 'A6'">148mm</xsl:when> + <xsl:when test="$paper.type = 'A7'">105mm</xsl:when> + <xsl:when test="$paper.type = 'A8'">74mm</xsl:when> + <xsl:when test="$paper.type = 'A9'">52mm</xsl:when> + <xsl:when test="$paper.type = 'A10'">37mm</xsl:when> + <xsl:when test="$paper.type = 'B0'">1414mm</xsl:when> + <xsl:when test="$paper.type = 'B1'">1000mm</xsl:when> + <xsl:when test="$paper.type = 'B2'">707mm</xsl:when> + <xsl:when test="$paper.type = 'B3'">500mm</xsl:when> + <xsl:when test="$paper.type = 'B4'">353mm</xsl:when> + <xsl:when test="$paper.type = 'B5'">250mm</xsl:when> + <xsl:when test="$paper.type = 'B6'">176mm</xsl:when> + <xsl:when test="$paper.type = 'B7'">125mm</xsl:when> + <xsl:when test="$paper.type = 'B8'">88mm</xsl:when> + <xsl:when test="$paper.type = 'B9'">62mm</xsl:when> + <xsl:when test="$paper.type = 'B10'">44mm</xsl:when> + <xsl:when test="$paper.type = 'C0'">1297mm</xsl:when> + <xsl:when test="$paper.type = 'C1'">917mm</xsl:when> + <xsl:when test="$paper.type = 'C2'">648mm</xsl:when> + <xsl:when test="$paper.type = 'C3'">458mm</xsl:when> + <xsl:when test="$paper.type = 'C4'">324mm</xsl:when> + <xsl:when test="$paper.type = 'C5'">229mm</xsl:when> + <xsl:when test="$paper.type = 'C6'">162mm</xsl:when> + <xsl:when test="$paper.type = 'C7'">114mm</xsl:when> + <xsl:when test="$paper.type = 'C8'">81mm</xsl:when> + <xsl:when test="$paper.type = 'C9'">57mm</xsl:when> + <xsl:when test="$paper.type = 'C10'">40mm</xsl:when> + <xsl:otherwise>11in</xsl:otherwise> + </xsl:choose> +</xsl:param> + + +Description + +The portrait page height is the length of the long +edge of the physical page. + + + + + + + +page.margin.bottom + + + +page.margin.bottom +The bottom margin of the page + + + + +<xsl:param name="page.margin.bottom" select="'0.5in'"></xsl:param> + + + +Description + +The bottom page margin is the distance from the bottom of the region-after +to the physical bottom of the page. + + + + + + + +page.margin.inner + + + +page.margin.inner +The inner page margin + + + +<xsl:param name="page.margin.inner"> + <xsl:choose> + <xsl:when test="$double.sided != 0">1.25in</xsl:when> + <xsl:otherwise>1in</xsl:otherwise> + </xsl:choose> +</xsl:param> + + +Description + +The inner page margin is the distance from binding edge of the +page to the first column of text. In the left-to-right, top-to-bottom writing +direction, this is the left margin of recto pages. +The inner and outer margins are usually the same unless the output +is double-sided. + + + + + + + +page.margin.outer + + + +page.margin.outer +The outer page margin + + + +<xsl:param name="page.margin.outer"> + <xsl:choose> + <xsl:when test="$double.sided != 0">0.75in</xsl:when> + <xsl:otherwise>1in</xsl:otherwise> + </xsl:choose> +</xsl:param> + + +Description + +The outer page margin is the distance from non-binding edge of the +page to the last column of text. In the left-to-right, top-to-bottom writing +direction, this is the right margin of recto pages. +The inner and outer margins are usually the same unless the output +is double-sided. + + + + + + + +page.margin.top + + + +page.margin.top +The top margin of the page + + + + +<xsl:param name="page.margin.top" select="'0.5in'"></xsl:param> + + + +Description + +The top page margin is the distance from the physical top of the +page to the top of the region-before. + + + + + + +page.orientation + + + +page.orientation +Select the page orientation + + + +<xsl:param name="page.orientation" select="'portrait'"></xsl:param> + + +Description + +In portrait orientation, the short edge is horizontal; in +landscape orientation, it is vertical. + + + + + + + +page.width + + + +page.width +The width of the physical page + + + +<xsl:param name="page.width"> + <xsl:choose> + <xsl:when test="$page.orientation = 'portrait'"> + <xsl:value-of select="$page.width.portrait"></xsl:value-of> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$page.height.portrait"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> +</xsl:param> + + +Description + +The page width is generally calculated from the +paper.type and page.orientation. + + + + + + + +page.width.portrait + + + +page.width.portrait +Specify the physical size of the short edge of the page + + + +<xsl:param name="page.width.portrait"> + <xsl:choose> + <xsl:when test="$paper.type = 'USletter'">8.5in</xsl:when> + <xsl:when test="$paper.type = '4A0'">1682mm</xsl:when> + <xsl:when test="$paper.type = '2A0'">1189mm</xsl:when> + <xsl:when test="$paper.type = 'A0'">841mm</xsl:when> + <xsl:when test="$paper.type = 'A1'">594mm</xsl:when> + <xsl:when test="$paper.type = 'A2'">420mm</xsl:when> + <xsl:when test="$paper.type = 'A3'">297mm</xsl:when> + <xsl:when test="$paper.type = 'A4'">210mm</xsl:when> + <xsl:when test="$paper.type = 'A5'">148mm</xsl:when> + <xsl:when test="$paper.type = 'A6'">105mm</xsl:when> + <xsl:when test="$paper.type = 'A7'">74mm</xsl:when> + <xsl:when test="$paper.type = 'A8'">52mm</xsl:when> + <xsl:when test="$paper.type = 'A9'">37mm</xsl:when> + <xsl:when test="$paper.type = 'A10'">26mm</xsl:when> + <xsl:when test="$paper.type = 'B0'">1000mm</xsl:when> + <xsl:when test="$paper.type = 'B1'">707mm</xsl:when> + <xsl:when test="$paper.type = 'B2'">500mm</xsl:when> + <xsl:when test="$paper.type = 'B3'">353mm</xsl:when> + <xsl:when test="$paper.type = 'B4'">250mm</xsl:when> + <xsl:when test="$paper.type = 'B5'">176mm</xsl:when> + <xsl:when test="$paper.type = 'B6'">125mm</xsl:when> + <xsl:when test="$paper.type = 'B7'">88mm</xsl:when> + <xsl:when test="$paper.type = 'B8'">62mm</xsl:when> + <xsl:when test="$paper.type = 'B9'">44mm</xsl:when> + <xsl:when test="$paper.type = 'B10'">31mm</xsl:when> + <xsl:when test="$paper.type = 'C0'">917mm</xsl:when> + <xsl:when test="$paper.type = 'C1'">648mm</xsl:when> + <xsl:when test="$paper.type = 'C2'">458mm</xsl:when> + <xsl:when test="$paper.type = 'C3'">324mm</xsl:when> + <xsl:when test="$paper.type = 'C4'">229mm</xsl:when> + <xsl:when test="$paper.type = 'C5'">162mm</xsl:when> + <xsl:when test="$paper.type = 'C6'">114mm</xsl:when> + <xsl:when test="$paper.type = 'C7'">81mm</xsl:when> + <xsl:when test="$paper.type = 'C8'">57mm</xsl:when> + <xsl:when test="$paper.type = 'C9'">40mm</xsl:when> + <xsl:when test="$paper.type = 'C10'">28mm</xsl:when> + <xsl:otherwise>8.5in</xsl:otherwise> + </xsl:choose> +</xsl:param> + + +Description + +The portrait page width is the length of the short +edge of the physical page. + + + + + + + +paper.type + + + +paper.type +Select the paper type + + + +<xsl:param name="paper.type" select="'USletter'"></xsl:param> + + +Description + +The paper type is a convenient way to specify the paper size. +The list of known paper sizes includes USletter and most of the A, +B, and C sizes. See page.width.portrait, for example. + + + + + + + +double.sided + + + +double.sided +Is the document to be printed double sided? + + + + +<xsl:param name="double.sided" select="0"></xsl:param> + + + +Description + +Double-sided documents are printed with a slightly wider margin +on the binding edge of the page. + +FIXME: The current set of parameters does not take writing direction +into account. + + + + + + +body.margin.bottom + + + +body.margin.bottom +The bottom margin of the body text + + + + +<xsl:param name="body.margin.bottom" select="'0.5in'"></xsl:param> + + + +Description + +The body bottom margin is the distance from the last line of text +in the page body to the bottom of the region-after. + + + + + + + +body.margin.top + + + +body.margin.top +To specify the size of the top margin of a page + + + + +<xsl:param name="body.margin.top" select="'0.5in'"></xsl:param> + + + +Description + +The body top margin is the distance from the top of the region-before +to the first line of text in the page body. + + + + + + + +body.start.indent + + + +body.start.indent +The start-indent for the body text + + + + +<xsl:param name="body.start.indent"> + <xsl:choose> + <xsl:when test="$fop.extensions != 0">0pt</xsl:when> + <xsl:when test="$passivetex.extensions != 0">0pt</xsl:when> + <xsl:otherwise>4pc</xsl:otherwise> + </xsl:choose> +</xsl:param> + + + +Description + +This parameter provides +one means of indenting the body text relative to +the left page margin. +It is used in place of the +title.margin.left for +all XSL-FO processors except FOP. +It enables support for side floats to appear +in the indented margin area. + +This start-indent property is added to the fo:flow +for certain page sequences. Which page-sequences it is +applied to is determined by the template named +set.flow.properties. +By default, that template adds it to the flow +for page-sequences using the body +master-reference, as well as appendixes and prefaces. + +If this parameter is used, section titles should have +a start-indent value of 0pt if they are to be +outdented relative to the body text. + + +If you are using FOP, then set this parameter to a zero +width value and set the title.margin.left +parameter to the negative value of the desired indent. + + +See also body.end.indent and +title.margin.left. + + + + + + + +body.end.indent + + + +body.end.indent +The end-indent for the body text + + + + +<xsl:param name="body.end.indent" select="'0pt'"></xsl:param> + + + +Description + +This end-indent property is added to the fo:flow +for certain page sequences. Which page-sequences it is +applied to is determined by the template named +set.flow.properties. +By default, that template adds it to the flow +for page-sequences using the body +master-reference, as well as appendixes and prefaces. + + +See also body.start.indent. + + + + + + + +alignment + + + +alignment +Specify the default text alignment + + + +<xsl:param name="alignment">justify</xsl:param> + + +Description + +The default text alignment is used for most body text. + + + + + + + +hyphenate + + + +hyphenate +Specify hyphenation behavior + + + +<xsl:param name="hyphenate">true</xsl:param> + + +Description + +If true, words may be hyphenated. Otherwise, they may not. + + + + + + + +line-height +string + + +line-height +Specify the line-height property + + + + +<xsl:param name="line-height" select="'normal'"></xsl:param> + + + +Description + +Sets the line-height property. + + + + + + +column.count.back +integer + + +column.count.back +Number of columns on back matter pages + + + + +<xsl:param name="column.count.back" select="1"></xsl:param> + + + +Description + +Number of columns on back matter (appendix, glossary, etc.) pages. + + + + + + +column.count.body +integer + + +column.count.body +Number of columns on body pages + + + + +<xsl:param name="column.count.body" select="1"></xsl:param> + + + +Description + +Number of columns on body pages. + + + + + + +column.count.front +integer + + +column.count.front +Number of columns on front matter pages + + + + +<xsl:param name="column.count.front" select="1"></xsl:param> + + + +Description + +Number of columns on front matter (dedication, preface, etc.) pages. + + + + + + +column.count.index +integer + + +column.count.index +Number of columns on index pages + + + + +<xsl:param name="column.count.index" select="2"></xsl:param> + + + +Description + +Number of columns on index pages. + + + + + + +column.count.lot +integer + + +column.count.lot +Number of columns on a 'List-of-Titles' page + + + + +<xsl:param name="column.count.lot" select="1"></xsl:param> + + + +Description + +Number of columns on a page sequence containing the Table of Contents, +List of Figures, etc. + + + + + + +column.count.titlepage +integer + + +column.count.titlepage +Number of columns on a title page + + + + +<xsl:param name="column.count.titlepage" select="1"></xsl:param> + + + +Description + +Number of columns on a title page + + + + + + +column.gap.back +length + + +column.gap.back +Gap between columns in back matter + + + + +<xsl:param name="column.gap.back" select="'12pt'"></xsl:param> + + + +Description + +Specifies the gap between columns in back matter (if +column.count.back is greater than one). + + + + + + +column.gap.body +length + + +column.gap.body +Gap between columns in the body + + + + +<xsl:param name="column.gap.body" select="'12pt'"></xsl:param> + + + +Description + +Specifies the gap between columns in body matter (if +column.count.body is greater than one). + + + + + + +column.gap.front +length + + +column.gap.front +Gap between columns in the front matter + + + + +<xsl:param name="column.gap.front" select="'12pt'"></xsl:param> + + + +Description + +Specifies the gap between columns in front matter (if +column.count.front is greater than one). + + + + + + +column.gap.index +length + + +column.gap.index +Gap between columns in the index + + + + +<xsl:param name="column.gap.index" select="'12pt'"></xsl:param> + + + +Description + +Specifies the gap between columns in indexes (if +column.count.index is greater than one). + + + + + + +column.gap.lot +length + + +column.gap.lot +Gap between columns on a 'List-of-Titles' page + + + + +<xsl:param name="column.gap.lot" select="'12pt'"></xsl:param> + + + +Description + +Specifies the gap between columns on 'List-of-Titles' pages (if +column.count.lot is greater than one). + + + + + + +column.gap.titlepage +length + + +column.gap.titlepage +Gap between columns on title pages + + + + +<xsl:param name="column.gap.titlepage" select="'12pt'"></xsl:param> + + + +Description + +Specifies the gap between columns on title pages (if +column.count.titlepage is greater than one). + + + + + + + +region.after.extent + + + +region.after.extent +Specifies the height of the footer. + + + + +<xsl:param name="region.after.extent" select="'0.4in'"></xsl:param> + + + +Description + +The region after extent is the height of the area where footers +are printed. + + + + + + + +region.before.extent + + + +region.before.extent +Specifies the height of the header + + + + +<xsl:param name="region.before.extent" select="'0.4in'"></xsl:param> + + + +Description + +The region before extent is the height of the area where headers +are printed. + + + + + + + +default.units +list +cm +mm +in +pt +pc +px +em + + +default.units +Default units for an unqualified dimension + + + +<xsl:param name="default.units" select="'pt'"></xsl:param> + + +Description + +If an unqualified dimension is encountered (for example, in a +graphic width), the default-units will be used for the +units. Unqualified dimensions are not allowed in XSL Formatting Objects. + + + + + + + +normal.para.spacing +What space do you want between normal paragraphs + + + +<xsl:attribute-set name="normal.para.spacing"> + <xsl:attribute name="space-before.optimum">1em</xsl:attribute> + <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> +</xsl:attribute-set> + +Description +Specify the spacing required between normal paragraphs + + + + + +body.font.master + + + +body.font.master +Specifies the default point size for body text + + + + +<xsl:param name="body.font.master">10</xsl:param> + + + +Description + +The body font size is specified in two parameters +(body.font.master and body.font.size) +so that math can be performed on the font size by XSLT. + + + + + + + +body.font.size + + + +body.font.size +Specifies the default font size for body text + + + +<xsl:param name="body.font.size"> + <xsl:value-of select="$body.font.master"></xsl:value-of><xsl:text>pt</xsl:text> +</xsl:param> + + +Description + +The body font size is specified in two parameters +(body.font.master and body.font.size) +so that math can be performed on the font size by XSLT. + + + + + + + +footnote.font.size + + + +footnote.font.size +The font size for footnotes + + + +<xsl:param name="footnote.font.size"> + <xsl:value-of select="$body.font.master * 0.8"></xsl:value-of><xsl:text>pt</xsl:text> +</xsl:param> + + +Description + +The footnote font size is used for...footnotes! + + + + + + + +title.margin.left + + + +title.margin.left +Adjust the left margin for titles + + + + +<xsl:param name="title.margin.left"> + <xsl:choose> + <xsl:when test="$fop.extensions != 0">-4pc</xsl:when> + <xsl:when test="$passivetex.extensions != 0">0pt</xsl:when> + <xsl:otherwise>0pt</xsl:otherwise> + </xsl:choose> +</xsl:param> + + + +Description + +This parameter provides +one means of adjusting the left margin for titles. +The left margin of the body region +is calculated to include this space, +and titles are outdented to the left by this amount, +effectively leaving titles at the left margin +and the body text indented. +Currently this method is only used for FOP because +it cannot properly use the body.start.indent +parameter. +the relative + + +The default value for FOP is -4pc, which means the +body text is indented 4 picas relative to +the titles. +The default value for other processors is 0pt, and +the body indent is provided by the body.start.indent +parameter. + + +If you set the value to zero, be sure to still include +a unit indicator such as 0pt, or +the FO processor will report errors. + + +This parameter must be set to 0pt if the +passivetex.extensions +parameter is nonzero because PassiveTeX cannot handle +the math expression with negative values +used to calculate the indents. + + + + + + + +draft.mode +list + + +draft.mode +Select draft mode + + + + +<xsl:param name="draft.mode" select="'maybe'"></xsl:param> + + + +Description + +Selects draft mode. If draft.mode is +yes, the entire document will be treated +as a draft. If it is no, the entire document +will be treated as a final copy. If it is maybe, +individual sections will be treated as draft or final independently, depending +on how their status attribute is set. + + + + + + + +draft.watermark.image +uri + + +draft.watermark.image +The URI of the image to be used for draft watermarks + + + + +<xsl:param name="draft.watermark.image" select="'http://docbook.sourceforge.net/release/images/draft.png'"></xsl:param> + + + +Description + +The image to be used for draft watermarks. + + + + + + +headers.on.blank.pages +boolean + + +headers.on.blank.pages +Put headers on blank pages? + + + + +<xsl:param name="headers.on.blank.pages" select="1"></xsl:param> + + + +Description + +If non-zero, headers will be placed on blank pages. + + + + + + +footers.on.blank.pages +boolean + + +footers.on.blank.pages +Put footers on blank pages? + + + + +<xsl:param name="footers.on.blank.pages" select="1"></xsl:param> + + + +Description + +If non-zero, footers will be placed on blank pages. + + + + + + +header.rule +boolean + + +header.rule +Rule under headers? + + + + +<xsl:param name="header.rule" select="1"></xsl:param> + + + +Description + +If non-zero, a rule will be drawn below the page headers. + + + + + + +footer.rule +boolean + + +footer.rule +Rule over footers? + + + + +<xsl:param name="footer.rule" select="1"></xsl:param> + + + +Description + +If non-zero, a rule will be drawn above the page footers. + + + + + + +header.column.widths +string + + +header.column.widths +Specify relative widths of header areas + + + +<xsl:param name="header.column.widths" select="'1 1 1'"></xsl:param> + + +Description + +Page headers in print output use a three column table +to position text at the left, center, and right side of +the header on the page. +This parameter lets you specify the relative sizes of the +three columns. The default value is +"1 1 1". + +The parameter value must be three numbers, separated +by white space. The first number represents the relative +width of the left header for +single-sided output, or the inside header for +double-sided output. The second number is the relative +width of the center header. The third number is the +relative width of the right header for +single-sided output, or the outside header for +double-sided output. + + +The numbers are used to specify the column widths +for the table that makes up the header area. +In the FO output, this looks like: + + + +<fo:table-column column-number="1" + column-width="proportional-column-width(1)"/> + + + +The proportional-column-width() +function computes a column width by dividing its +argument by the total of the arguments for all the columns, and +then multiplying the result by the width of the whole table +(assuming all the column specs use the function). +Its argument can be any positive integer or floating point number. +Zero is an acceptable value, although some FO processors +may warn about it, in which case using a very small number might +be more satisfactory. + + +For example, the value "1 2 1" means the center +header should have twice the width of the other areas. +A value of "0 0 1" means the entire header area +is reserved for the right (or outside) header text. +Note that to keep the center area centered on +the page, the left and right values must be +the same. A specification like "1 2 3" means the +center area is no longer centered on the page +since the right area is three times the width of the left area. + + + + + + + +footer.column.widths +string + + +footer.column.widths +Specify relative widths of footer areas + + + +<xsl:param name="footer.column.widths" select="'1 1 1'"></xsl:param> + + +Description + +Page footers in print output use a three column table +to position text at the left, center, and right side of +the footer on the page. +This parameter lets you specify the relative sizes of the +three columns. The default value is +"1 1 1". + +The parameter value must be three numbers, separated +by white space. The first number represents the relative +width of the left footer for +single-sided output, or the inside footer for +double-sided output. The second number is the relative +width of the center footer. The third number is the +relative width of the right footer for +single-sided output, or the outside footer for +double-sided output. + + +The numbers are used to specify the column widths +for the table that makes up the footer area. +In the FO output, this looks like: + + + +<fo:table-column column-number="1" + column-width="proportional-column-width(1)"/> + + + +The proportional-column-width() +function computes a column width by dividing its +argument by the total of the arguments for all the columns, and +then multiplying the result by the width of the whole table +(assuming all the column specs use the function). +Its argument can be any positive integer or floating point number. +Zero is an acceptable value, although some FO processors +may warn about it, in which case using a very small number might +be more satisfactory. + + +For example, the value "1 2 1" means the center +footer should have twice the width of the other areas. +A value of "0 0 1" means the entire footer area +is reserved for the right (or outside) footer text. +Note that to keep the center area centered on +the page, the left and right values must be +the same. A specification like "1 2 3" means the +center area is no longer centered on the page +since the right area is three times the width of the left area. + + + + + + + +header.table.height +string + + +header.table.height +Specify the minimum height of the table containing the running page headers + + + +<xsl:param name="header.table.height" select="'14pt'"></xsl:param> + + +Description + +Page headers in print output use a three column table +to position text at the left, center, and right side of +the header on the page. +This parameter lets you specify the minimum height +of the single row in the table. +Since this specifies only the minimum height, +the table should automatically grow to fit taller content. +The default value is "14pt". + + + + + + +footer.table.height +string + + +footer.table.height +Specify the minimum height of the table containing the running page footers + + + +<xsl:param name="footer.table.height" select="'14pt'"></xsl:param> + + +Description + +Page footers in print output use a three column table +to position text at the left, center, and right side of +the footer on the page. +This parameter lets you specify the minimum height +of the single row in the table. +Since this specifies only the minimum height, +the table should automatically grow to fit taller content. +The default value is "14pt". + + + + + + +header.content.properties + + + +header.content.properties + + + + + +<xsl:attribute-set name="header.content.properties"> + <xsl:attribute name="font-family"> + <xsl:value-of select="$body.fontset"></xsl:value-of> + </xsl:attribute> + <xsl:attribute name="margin-left"> + <xsl:value-of select="$title.margin.left"></xsl:value-of> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +Properties of page header content. + + + + + + +footer.content.properties + + + +footer.content.properties + + + + + +<xsl:attribute-set name="footer.content.properties"> + <xsl:attribute name="font-family"> + <xsl:value-of select="$body.fontset"></xsl:value-of> + </xsl:attribute> + <xsl:attribute name="margin-left"> + <xsl:value-of select="$title.margin.left"></xsl:value-of> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +Properties of page footer content. + + + + + + +marker.section.level +integer + + +marker.section.level +Control depth of sections shown in running headers or footers + + + + +<xsl:param name="marker.section.level" select="2"></xsl:param> + + + +Description + +The marker.section.level parameter +controls the depth of section levels that may be displayed +in running headers and footers. For example, if the value +is 2 (the default), then titles from sect1 and +sect2 or equivalent section +elements are candidates for use in running headers and +footers. + +Each candidate title is marked in the FO output with a +<fo:marker marker-class-name="section.head.marker"> +element. + +In order for such titles to appear in headers +or footers, the header.content +or footer.content template +must be customized to retrieve the marker using +an output element such as: + + +<fo:retrieve-marker retrieve-class-name="section.head.marker" + retrieve-position="first-including-carryover" + retrieve-boundary="page-sequence"/> + + + + + + +                   + +Font Families + + +body.font.family + + + +body.font.family +The default font family for body text + + + + +<xsl:param name="body.font.family" select="'serif'"></xsl:param> + + + +Description + +The body font family is the default font used for text in the page body. + + + + + + + +dingbat.font.family + + + +dingbat.font.family +The font family for copyright, quotes, and other symbols + + + + +<xsl:param name="dingbat.font.family" select="'serif'"></xsl:param> + + + +Description + +The dingbat font family is used for dingbats. If it is defined +as the empty string, no font change is effected around dingbats. + + + + + + + +monospace.font.family + + + +monospace.font.family +The default font family for monospace environments + + + + +<xsl:param name="monospace.font.family" select="'monospace'"></xsl:param> + + + +Description + +The monospace font family is used for verbatim environments +(program listings, screens, etc.). + + + + + + + +sans.font.family + + + +sans.font.family +The default sans-serif font family + + + + +<xsl:param name="sans.font.family" select="'sans-serif'"></xsl:param> + + + +Description + +The default sans-serif font family. At the present, this isn't +actually used by the stylesheets. + + + + + + + +title.font.family + + + +title.font.family +The default font family for titles + + + + +<xsl:param name="title.font.family" select="'sans-serif'"></xsl:param> + + + +Description + +The title font family is used for titles (chapter, section, figure, +etc.) + + + + + + + +symbol.font.family + + + +symbol.font.family +The font families to be searched for symbols outside + of the body font + + + + +<xsl:param name="symbol.font.family" select="'Symbol,ZapfDingbats'"></xsl:param> + + + +Description + +A typical body or title font does not contain all +the character glyphs that DocBook supports. This parameter +specifies additional fonts that should be searched for +special characters not in the normal font. +These symbol font names are automatically appended +to the body or title font family name when fonts +are specified in a +font-family +property in the FO output. + +The symbol font names should be entered as a +comma-separated list. The default value is +Symbol,ZapfDingbats. + + + + + + + +Property Sets + + +formal.object.properties +Properties associated with a formal object such as a figure, or other component that has a title + + + + +<xsl:attribute-set name="formal.object.properties"> + <xsl:attribute name="space-before.minimum">0.5em</xsl:attribute> + <xsl:attribute name="space-before.optimum">1em</xsl:attribute> + <xsl:attribute name="space-before.maximum">2em</xsl:attribute> + <xsl:attribute name="space-after.minimum">0.5em</xsl:attribute> + <xsl:attribute name="space-after.optimum">1em</xsl:attribute> + <xsl:attribute name="space-after.maximum">2em</xsl:attribute> + <xsl:attribute name="keep-together.within-column">always</xsl:attribute> +</xsl:attribute-set> + + + +Description + +The styling for formal objects in docbook. Specify the spacing +before and after the object. + + + + + + +formal.title.properties +Style the title element of formal object such as a figure. + + + + +<xsl:attribute-set name="formal.title.properties" use-attribute-sets="normal.para.spacing"> + <xsl:attribute name="font-weight">bold</xsl:attribute> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master * 1.2"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> + <xsl:attribute name="hyphenate">false</xsl:attribute> + <xsl:attribute name="space-after.minimum">0.4em</xsl:attribute> + <xsl:attribute name="space-after.optimum">0.6em</xsl:attribute> + <xsl:attribute name="space-after.maximum">0.8em</xsl:attribute> +</xsl:attribute-set> + + +Description +Specify how the title should be styled. Specify the font size and weight of the title of the formal object. + + + + + +informal.object.properties +Properties associated with a formal object such as a figure, or other component that has a title + + + +<xsl:attribute-set name="informal.object.properties"> + <xsl:attribute name="space-before.minimum">0.5em</xsl:attribute> + <xsl:attribute name="space-before.optimum">1em</xsl:attribute> + <xsl:attribute name="space-before.maximum">2em</xsl:attribute> + <xsl:attribute name="space-after.minimum">0.5em</xsl:attribute> + <xsl:attribute name="space-after.optimum">1em</xsl:attribute> + <xsl:attribute name="space-after.maximum">2em</xsl:attribute> +</xsl:attribute-set> + +Description +The styling for informal objects in docbook. Specify the spacing before and after the object. + + + + + +monospace.properties +attribute set + + +monospace.properties +Properties of monospaced content + + + + +<xsl:attribute-set name="monospace.properties"> + <xsl:attribute name="font-family"> + <xsl:value-of select="$monospace.font.family"></xsl:value-of> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +Specifies the font name for monospaced output. This property set +used to set the font-size as well, but that doesn't work very well +when different fonts are used (as they are in titles and paragraphs, +for example). + +If you want to set the font-size in a customization layer, it's +probably going to be more appropriate to set font-size-adjust, if your +formatter supports it. + + + + + + +verbatim.properties +Properties associated with verbatim text + + + + +<xsl:attribute-set name="verbatim.properties"> + <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-before.optimum">1em</xsl:attribute> + <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> + <xsl:attribute name="space-after.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-after.optimum">1em</xsl:attribute> + <xsl:attribute name="space-after.maximum">1.2em</xsl:attribute> + <xsl:attribute name="hyphenate">false</xsl:attribute> +</xsl:attribute-set> + + +Description +This attribute set is used on all verbatim environments. + + + + + + +monospace.verbatim.properties +What font and size do you want for monospaced content? + + + + +<xsl:attribute-set name="monospace.verbatim.properties" use-attribute-sets="verbatim.properties monospace.properties"> + <xsl:attribute name="text-align">start</xsl:attribute> + <xsl:attribute name="wrap-option">no-wrap</xsl:attribute> +</xsl:attribute-set> + + +Description +Specify the font name and size you want for monospaced output + + + + + +sidebar.properties +attribute set + + +sidebar.properties +Attribute set for sidebar properties + + + + +<xsl:attribute-set name="sidebar.properties" use-attribute-sets="formal.object.properties"> + <xsl:attribute name="border-style">solid</xsl:attribute> + <xsl:attribute name="border-width">1pt</xsl:attribute> + <xsl:attribute name="border-color">black</xsl:attribute> + <xsl:attribute name="background-color">#DDDDDD</xsl:attribute> + <xsl:attribute name="padding-left">12pt</xsl:attribute> + <xsl:attribute name="padding-right">12pt</xsl:attribute> + <xsl:attribute name="padding-top">6pt</xsl:attribute> + <xsl:attribute name="padding-bottom">6pt</xsl:attribute> + <xsl:attribute name="margin-left">0pt</xsl:attribute> + <xsl:attribute name="margin-right">0pt</xsl:attribute> +<!-- + <xsl:attribute name="margin-top">6pt</xsl:attribute> + <xsl:attribute name="margin-bottom">6pt</xsl:attribute> +--> +</xsl:attribute-set> + + + +Description + +The styling for sidebars. + + + + + + +sidebar.title.properties +attribute set + + +sidebar.title.properties +Attribute set for sidebar titles + + + + +<xsl:attribute-set name="sidebar.title.properties"> + <xsl:attribute name="font-weight">bold</xsl:attribute> + <xsl:attribute name="hyphenate">false</xsl:attribute> + <xsl:attribute name="text-align">start</xsl:attribute> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> +</xsl:attribute-set> + + + +Description + +The styling for sidebars titles. + + + + + + +sidebar.float.type +list + + +sidebar.float.type +Select type of float for sidebar elements + + + + +<xsl:param name="sidebar.float.type" select="'none'"></xsl:param> + + + +Description + +Selects the type of float for sidebar elements. + + + +If sidebar.float.type is +none, then +no float is used. + + + +If sidebar.float.type is +before, then +the float appears at the top of the page. On some processors, +that may be the next page rather than the current page. + + + +If sidebar.float.type is +left or +start, then +a left side float is used. + + + +If sidebar.float.type is +right or +end, then +a right side float is used. + + + +If your XSL-FO processor supports floats positioned on the +inside or +outside +of double-sided pages, then you have those two +options for side floats as well. + + + + + + + + + +sidebar.float.width + + +sidebar.float.width +Set the default width for sidebars + + + + +<xsl:param name="sidebar.float.width" select="'1in'"></xsl:param> + + + +Description + +Sets the default width for sidebars when used as a side float. +The width determines the degree to which the sidebar block intrudes into +the text area. + +If sidebar.float.type is +before or +none, then +this parameter is ignored. + + + + + + + +margin.note.properties +attribute set + + +margin.note.properties +Attribute set for margin.note properties + + + + +<xsl:attribute-set name="margin.note.properties"> + <xsl:attribute name="font-size">90%</xsl:attribute> + <xsl:attribute name="text-align">start</xsl:attribute> +</xsl:attribute-set> + + + +Description + +The styling for margin notes. +By default, margin notes are not implemented for any +element. A stylesheet customization is needed to make +use of this attribute-set. + +You can use a template named floater +to create the customization. +That template can create side floats by specifying the +content and characteristics as template parameters. + + +For example: +<xsl:template match="para[@role='marginnote']"> + <xsl:call-template name="floater"> + <xsl:with-param name="position"> + <xsl:value-of select="$margin.note.float.type"/> + </xsl:with-param> + <xsl:with-param name="width"> + <xsl:value-of select="$margin.note.width"/> + </xsl:with-param> + <xsl:with-param name="content"> + <xsl:apply-imports/> + </xsl:with-param> + </xsl:call-template> +</xsl:template> + + + + + + +margin.note.title.properties +attribute set + + +margin.note.title.properties +Attribute set for margin note titles + + + + +<xsl:attribute-set name="margin.note.title.properties"> + <xsl:attribute name="font-weight">bold</xsl:attribute> + <xsl:attribute name="hyphenate">false</xsl:attribute> + <xsl:attribute name="text-align">start</xsl:attribute> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> +</xsl:attribute-set> + + + +Description + +The styling for margin note titles. + + + + + + +margin.note.float.type +list + + +margin.note.float.type +Select type of float for margin note customizations + + + + +<xsl:param name="margin.note.float.type" select="'none'"></xsl:param> + + + +Description + +Selects the type of float for margin notes. +DocBook does not define a margin note element, so this +feature must be implemented as a customization of the stylesheet. +See margin.note.properties for +an example. + + + +If margin.note.float.type is +none, then +no float is used. + + + +If margin.note.float.type is +before, then +the float appears at the top of the page. On some processors, +that may be the next page rather than the current page. + + + +If margin.note.float.type is +left or +start, then +a left side float is used. + + + +If margin.note.float.type is +right or +end, then +a right side float is used. + + + +If your XSL-FO processor supports floats positioned on the +inside or +outside +of double-sided pages, then you have those two +options for side floats as well. + + + + + + + + + +margin.note.width + + +margin.note.width +Set the default width for margin notes + + + + +<xsl:param name="margin.note.width" select="'1in'"></xsl:param> + + + +Description + +Sets the default width for margin notes when used as a side float. +The width determines the degree to which the margin note block intrudes into +the text area. + +If margin.note.float.type is +before or +none, then +this parameter is ignored. + + + + + + + +component.title.properties +attribute set + + +component.title.properties +Properties for component titles + + + + +<xsl:attribute-set name="component.title.properties"> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> + <xsl:attribute name="space-before.optimum"><xsl:value-of select="concat($body.font.master, 'pt')"></xsl:value-of></xsl:attribute> + <xsl:attribute name="space-before.minimum"><xsl:value-of select="concat($body.font.master, 'pt * 0.8')"></xsl:value-of></xsl:attribute> + <xsl:attribute name="space-before.maximum"><xsl:value-of select="concat($body.font.master, 'pt * 1.2')"></xsl:value-of></xsl:attribute> + <xsl:attribute name="hyphenate">false</xsl:attribute> + <xsl:attribute name="text-align"> + <xsl:choose> + <xsl:when test="((parent::article | parent::articleinfo | parent::info/parent::article) and not(ancestor::book) and not(self::bibliography)) or (parent::slides | parent::slidesinfo)">center</xsl:when> + <xsl:otherwise>left</xsl:otherwise> + </xsl:choose> + </xsl:attribute> + <xsl:attribute name="start-indent"><xsl:value-of select="$title.margin.left"></xsl:value-of></xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties common to all component titles. + + + + + + +section.title.properties +attribute set + + +section.title.properties +Properties for section titles + + + + +<xsl:attribute-set name="section.title.properties"> + <xsl:attribute name="font-family"> + <xsl:value-of select="$title.font.family"></xsl:value-of> + </xsl:attribute> + <xsl:attribute name="font-weight">bold</xsl:attribute> + <!-- font size is calculated dynamically by section.heading template --> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> + <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-before.optimum">1.0em</xsl:attribute> + <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> + <xsl:attribute name="text-align">left</xsl:attribute> + <xsl:attribute name="start-indent"><xsl:value-of select="$title.margin.left"></xsl:value-of></xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties common to all section titles. + + + + + + +section.title.level1.properties +attribute set + + +section.title.level1.properties +Properties for level-1 section titles + + + + +<xsl:attribute-set name="section.title.level1.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master * 2.0736"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-1 section titles. + + + + + + +section.title.level2.properties +attribute set + + +section.title.level2.properties +Properties for level-1 section titles + + + + +<xsl:attribute-set name="section.title.level2.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master * 1.728"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-2 section titles. + + + + + + +section.title.level3.properties +attribute set + + +section.title.level3.properties +Properties for level-1 section titles + + + + +<xsl:attribute-set name="section.title.level3.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master * 1.44"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-3 section titles. + + + + + + +section.title.level4.properties +attribute set + + +section.title.level4.properties +Properties for level-1 section titles + + + + +<xsl:attribute-set name="section.title.level4.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master * 1.2"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-4 section titles. + + + + + + +section.title.level5.properties +attribute set + + +section.title.level5.properties +Properties for level-1 section titles + + + + +<xsl:attribute-set name="section.title.level5.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-5 section titles. + + + + + + +section.title.level6.properties +attribute set + + +section.title.level6.properties +Properties for level-1 section titles + + + + +<xsl:attribute-set name="section.title.level6.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-6 section titles. This property set is actually +used for all titles below level 5. + + + + + + +section.properties +attribute set + + +section.properties +Properties for all section levels + + + + +<xsl:attribute-set name="section.properties"> +</xsl:attribute-set> + + + +Description + +The properties that apply to the containing +block of all section levels, and therefore apply to +the whole section. +This attribute set is inherited by the +more specific attribute sets such as +section.level1.properties. +The default is empty. + + + + + + + +section.level1.properties +attribute set + + +section.level1.properties +Properties for level-1 sections + + + + +<xsl:attribute-set name="section.level1.properties" use-attribute-sets="section.properties"> +</xsl:attribute-set> + + + +Description + +The properties that apply to the containing +block of a level-1 section, and therefore apply to +the whole section. This includes sect1 +elements and section elements at level 1. + + +For example, you could start each level-1 section on +a new page by using: +<xsl:attribute-set name="section.level1.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + +section.level2.properties +attribute set + + +section.level2.properties +Properties for level-2 sections + + + + +<xsl:attribute-set name="section.level2.properties" use-attribute-sets="section.properties"> +</xsl:attribute-set> + + + +Description + +The properties that apply to the containing +block of a level-2 section, and therefore apply to +the whole section. This includes sect2 +elements and section elements at level 2. + + +For example, you could start each level-2 section on +a new page by using: +<xsl:attribute-set name="section.level2.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + +section.level3.properties +attribute set + + +section.level3.properties +Properties for level-3 sections + + + + +<xsl:attribute-set name="section.level3.properties" use-attribute-sets="section.properties"> +</xsl:attribute-set> + + + +Description + +The properties that apply to the containing +block of a level-3 section, and therefore apply to +the whole section. This includes sect3 +elements and section elements at level 3. + + +For example, you could start each level-3 section on +a new page by using: +<xsl:attribute-set name="section.level3.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + +section.level4.properties +attribute set + + +section.level4.properties +Properties for level-4 sections + + + + +<xsl:attribute-set name="section.level4.properties" use-attribute-sets="section.properties"> +</xsl:attribute-set> + + + +Description + +The properties that apply to the containing +block of a level-4 section, and therefore apply to +the whole section. This includes sect4 +elements and section elements at level 4. + + +For example, you could start each level-4 section on +a new page by using: +<xsl:attribute-set name="section.level4.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + +section.level5.properties +attribute set + + +section.level5.properties +Properties for level-5 sections + + + + +<xsl:attribute-set name="section.level5.properties" use-attribute-sets="section.properties"> +</xsl:attribute-set> + + + +Description + +The properties that apply to the containing +block of a level-5 section, and therefore apply to +the whole section. This includes sect5 +elements and section elements at level 5. + + +For example, you could start each level-5 section on +a new page by using: +<xsl:attribute-set name="section.level5.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + +section.level6.properties +attribute set + + +section.level6.properties +Properties for level-6 sections + + + + +<xsl:attribute-set name="section.level6.properties" use-attribute-sets="section.properties"> +</xsl:attribute-set> + + + +Description + +The properties that apply to the containing +block of a level 6 or lower section, and therefore apply to +the whole section. This includes +section elements at level 6 and lower. + + +For example, you could start each level-6 section on +a new page by using: +<xsl:attribute-set name="section.level6.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + +figure.properties +Properties associated with a figure + + + + +<xsl:attribute-set name="figure.properties" use-attribute-sets="formal.object.properties"></xsl:attribute-set> + + + +Description + +The styling for figures. + + + + + + +example.properties +Properties associated with a example + + + + +<xsl:attribute-set name="example.properties" use-attribute-sets="formal.object.properties"></xsl:attribute-set> + + + +Description + +The styling for examples. + + + + + + +equation.properties +Properties associated with a equation + + + + +<xsl:attribute-set name="equation.properties" use-attribute-sets="formal.object.properties"></xsl:attribute-set> + + + +Description + +The styling for equations. + + + + + + +table.properties +Properties associated with the block surrounding a table + + + + +<xsl:attribute-set name="table.properties" use-attribute-sets="formal.object.properties"></xsl:attribute-set> + + + +Description + +Block styling properties for tables. This parameter should really +have been called table.block.properties or something +like that, but we’re leaving it to avoid backwards-compatibility +problems. + +See also table.table.properties. + + + + + + +informalfigure.properties +Properties associated with an informalfigure + + + + +<xsl:attribute-set name="informalfigure.properties" use-attribute-sets="informal.object.properties"></xsl:attribute-set> + + + +Description + +The styling for informalfigures. + + + + + + +informalexample.properties +Properties associated with an informalexample + + + + +<xsl:attribute-set name="informalexample.properties" use-attribute-sets="informal.object.properties"></xsl:attribute-set> + + + +Description + +The styling for informalexamples. + + + + + + +informalequation.properties +Properties associated with a informalequation + + + + +<xsl:attribute-set name="informalequation.properties" use-attribute-sets="informal.object.properties"></xsl:attribute-set> + + + +Description + +The styling for informalequations. + + + + + + +informaltable.properties +Properties associated with the block surrounding an informaltable + + + + +<xsl:attribute-set name="informaltable.properties" use-attribute-sets="informal.object.properties"></xsl:attribute-set> + + + +Description + +Block styling properties for informaltables. This parameter should really +have been called informaltable.block.properties or something +like that, but we’re leaving it to avoid backwards-compatibility +problems. + +See also table.table.properties. + + + + + + +procedure.properties +Properties associated with a procedure + + + + +<xsl:attribute-set name="procedure.properties" use-attribute-sets="formal.object.properties"></xsl:attribute-set> + + + +Description + +The styling for procedures. + + + + + + +root.properties +attribute set + + +root.properties +The properties of the fo:root element + + + + +<xsl:attribute-set name="root.properties"> + <xsl:attribute name="font-family"> + <xsl:value-of select="$body.fontset"></xsl:value-of> + </xsl:attribute> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.size"></xsl:value-of> + </xsl:attribute> + <xsl:attribute name="text-align"> + <xsl:value-of select="$alignment"></xsl:value-of> + </xsl:attribute> + <xsl:attribute name="line-height"> + <xsl:value-of select="$line-height"></xsl:value-of> + </xsl:attribute> + <xsl:attribute name="font-selection-strategy">character-by-character</xsl:attribute> + <xsl:attribute name="line-height-shift-adjustment">disregard-shifts</xsl:attribute> +</xsl:attribute-set> + + + +Description + +This property set is used on the fo:root element of +an FO file. It defines a set of default, global parameters. + + + + + + +qanda.title.properties +attribute set + + +qanda.title.properties +Properties for qanda set titles + + + + +<xsl:attribute-set name="qanda.title.properties"> + <xsl:attribute name="font-family"> + <xsl:value-of select="$title.font.family"></xsl:value-of> + </xsl:attribute> + <xsl:attribute name="font-weight">bold</xsl:attribute> + <!-- font size is calculated dynamically by qanda.heading template --> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> + <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> + <xsl:attribute name="space-before.optimum">1.0em</xsl:attribute> + <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties common to all qanda set titles. + + + + + + + +qanda.title.level1.properties +attribute set + + +qanda.title.level1.properties +Properties for level-1 qanda set titles + + + + +<xsl:attribute-set name="qanda.title.level1.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master * 2.0736"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-1 qanda set titles. + + + + + + +qanda.title.level2.properties +attribute set + + +qanda.title.level2.properties +Properties for level-2 qanda set titles + + + + +<xsl:attribute-set name="qanda.title.level2.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master * 1.728"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-2 qanda set titles. + + + + + + +qanda.title.level3.properties +attribute set + + +qanda.title.level3.properties +Properties for level-3 qanda set titles + + + + +<xsl:attribute-set name="qanda.title.level3.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master * 1.44"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-3 qanda set titles. + + + + + + +qanda.title.level4.properties +attribute set + + +qanda.title.level4.properties +Properties for level-4 qanda set titles + + + + +<xsl:attribute-set name="qanda.title.level4.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master * 1.2"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-4 qanda set titles. + + + + + + +qanda.title.level5.properties +attribute set + + +qanda.title.level5.properties +Properties for level-5 qanda set titles + + + + +<xsl:attribute-set name="qanda.title.level5.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-5 qanda set titles. + + + + + + +qanda.title.level6.properties +attribute set + + +qanda.title.level6.properties +Properties for level-6 qanda set titles + + + + +<xsl:attribute-set name="qanda.title.level6.properties"> + <xsl:attribute name="font-size"> + <xsl:value-of select="$body.font.master"></xsl:value-of> + <xsl:text>pt</xsl:text> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties of level-6 qanda set titles. +This property set is actually +used for all titles below level 5. + + + + + + +article.appendix.title.properties +attribute set + + +article.appendix.title.properties +Properties for appendix titles that appear in an article + + + + +<xsl:attribute-set name="article.appendix.title.properties" use-attribute-sets="section.title.properties section.title.level1.properties"> + <xsl:attribute name="margin-left"> + <xsl:value-of select="$title.margin.left"></xsl:value-of> + </xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties for the title of an appendix that +appears inside an article. The default is to use +the properties of sect1 titles. + + + + + + + +abstract.properties +Properties associated with the block surrounding an abstract + + + + +<xsl:attribute-set name="abstract.properties"> + <xsl:attribute name="start-indent">0.0in</xsl:attribute> + <xsl:attribute name="end-indent">0.0in</xsl:attribute> +</xsl:attribute-set> + + + +Description + +Block styling properties for abstract. + +See also abstract.title.properties. + + + + + + +abstract.title.properties +attribute set + + +abstract.title.properties +Properties for abstract titles + + + + +<xsl:attribute-set name="abstract.title.properties"> + <xsl:attribute name="font-family"><xsl:value-of select="$title.fontset"></xsl:value-of></xsl:attribute> + <xsl:attribute name="font-weight">bold</xsl:attribute> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> + <xsl:attribute name="space-before.optimum"><xsl:value-of select="concat($body.font.master, 'pt')"></xsl:value-of></xsl:attribute> + <xsl:attribute name="space-before.minimum"><xsl:value-of select="concat($body.font.master, 'pt * 0.8')"></xsl:value-of></xsl:attribute> + <xsl:attribute name="space-before.maximum"><xsl:value-of select="concat($body.font.master, 'pt * 1.2')"></xsl:value-of></xsl:attribute> + <xsl:attribute name="hyphenate">false</xsl:attribute> + <xsl:attribute name="text-align">center</xsl:attribute> +</xsl:attribute-set> + + + +Description + +The properties for abstract titles. + +See also abstract.properties. + + + + + + +revhistory.table.properties +attribute set + + +revhistory.table.properties +The properties of table used for formatting revhistory + + + + +<xsl:attribute-set name="revhistory.table.properties"> +</xsl:attribute-set> + + + +Description + +This property set defines appearance of revhistory table. + + + + + + +revhistory.table.cell.properties +attribute set + + +revhistory.table.cell.properties +The properties of table cells used for formatting revhistory + + + + +<xsl:attribute-set name="revhistory.table.cell.properties"> +</xsl:attribute-set> + + + +Description + +This property set defines appearance of individual cells in revhistory table. + + + + + + +revhistory.title.properties +attribute set + + +revhistory.title.properties +The properties of revhistory title + + + + +<xsl:attribute-set name="revhistory.title.properties"> +</xsl:attribute-set> + + + +Description + +This property set defines appearance of revhistory title. + + + + + + +Profiling + +Following parameters can be used for attribute value based +profiling of your document. For more info about profiling look at +http://docbook.sourceforge.net/projects/xsl/doc/tools/profiling.html. + + + +profile.arch +string + + +profile.arch +Target profile for arch +attribute + + + + +<xsl:param name="profile.arch" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.condition +string + + +profile.condition +Target profile for condition +attribute + + + + +<xsl:param name="profile.condition" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.conformance +string + + +profile.conformance +Target profile for conformance +attribute + + + + +<xsl:param name="profile.conformance" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.lang +string + + +profile.lang +Target profile for lang +attribute + + + + +<xsl:param name="profile.lang" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.os +string + + +profile.os +Target profile for os +attribute + + + + +<xsl:param name="profile.os" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.revision +string + + +profile.revision +Target profile for revision +attribute + + + + +<xsl:param name="profile.revision" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.revisionflag +string + + +profile.revisionflag +Target profile for revisionflag +attribute + + + + +<xsl:param name="profile.revisionflag" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.role +string + + +profile.role +Target profile for role +attribute + + + + +<xsl:param name="profile.role" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + +Note that role is often +used for other purposes than profiling. For example it is commonly +used to get emphasize in bold font: + +<emphasis role="bold">very important</emphasis> + +If you are using role for +these purposes do not forget to add values like bold to +value of this parameter. If you forgot you will get document with +small pieces missing which are very hard to track. + +For this reason it is not recommended to use role attribute for profiling. You should +rather use profiling specific attributes like userlevel, os, arch, condition, etc. + + + + + + + +profile.security +string + + +profile.security +Target profile for security +attribute + + + + +<xsl:param name="profile.security" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.userlevel +string + + +profile.userlevel +Target profile for userlevel +attribute + + + + +<xsl:param name="profile.userlevel" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.vendor +string + + +profile.vendor +Target profile for vendor +attribute + + + + +<xsl:param name="profile.vendor" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.attribute +string + + +profile.attribute +Name of user-specified profiling attribute + + + + +<xsl:param name="profile.attribute" select="''"></xsl:param> + + + +Description + +This parameter is used in conjuction with profile.value. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.value +string + + +profile.value +Target profile for user-specified attribute + + + + +<xsl:param name="profile.value" select="''"></xsl:param> + + + +Description + +When you are using this parameter you must also specify name of +profiling attribute with parameter profile.attribute. + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.separator +string + + +profile.separator +Separator character for compound profile values + + + + +<xsl:param name="profile.separator" select="';'"></xsl:param> + + + +Description + +Separator character for compound profile values. + + + + + + +Localization + + +l10n.gentext.language +string + + +l10n.gentext.language +Sets the gentext language + + + + +<xsl:param name="l10n.gentext.language" select="''"></xsl:param> + + + +Description + +If this parameter is set to any value other than the empty string, its +value will be used as the value for the language when generating text. Setting +l10n.gentext.language overrides any settings within the +document being formatted. + +It's much more likely that you might want to set the +l10n.gentext.default.language parameter. + + + + + + +l10n.gentext.default.language +string + + +l10n.gentext.default.language +Sets the default language for generated text + + + + +<xsl:param name="l10n.gentext.default.language" select="'en'"></xsl:param> + + + +Description + +The value of the l10n.gentext.default.language +parameter is used as the language for generated text if no setting is provided +in the source document. + + + + + + +l10n.gentext.use.xref.language +boolean + + +l10n.gentext.use.xref.language +Use the language of target when generating cross-reference text? + + + + +<xsl:param name="l10n.gentext.use.xref.language" select="0"></xsl:param> + + + +Description + +If non-zero, the language of the target will be used when +generating cross reference text. Usually, the current +language is used when generating text (that is, the language of the +element that contains the cross-reference element). But setting this parameter +allows the language of the element pointed to to control +the generated text. + +Consider the following example: + + +<para lang="en">See also <xref linkend="chap3"/>.</para> + + + +Suppose that Chapter 3 happens to be written in German. +If l10n.gentext.use.xref.language is non-zero, the +resulting text will be something like this: + +
                  +See also Kapital 3. +
                  + +Where the more traditional rendering would be: + +
                  +See also Chapter 3. +
                  + +                   +                   + + + +l10n.lang.value.rfc.compliant +boolean + + +l10n.lang.value.rfc.compliant +Make value of lang attribute RFC compliant? + + + + +<xsl:param name="l10n.lang.value.rfc.compliant" select="1"></xsl:param> + + + +Description + +If non-zero, ensure that the values for all lang attributes in HTML output are RFC +compliantSection 8.1.1, Language Codes, in the HTML 4.0 Recommendation states that: + +
                  [RFC1766] defines and explains the language codes +that must be used in HTML documents. +Briefly, language codes consist of a primary code and a possibly +empty series of subcodes: + +language-code = primary-code ( "-" subcode )* + +And in RFC 1766, Tags for the Identification +of Languages, the EBNF for "language tag" is given as: + +Language-Tag = Primary-tag *( "-" Subtag ) +Primary-tag = 1*8ALPHA +Subtag = 1*8ALPHA + +
                  +                  . + +by taking any underscore characters in any lang values found in source documents, and +replacing them with hyphen characters in output HTML files. For +example, zh_CN in a source document becomes +zh-CN in the HTML output form that source. + + +This parameter does not cause any case change in lang values, because RFC 1766 +explicitly states that all "language tags" (as it calls them) "are +to be treated as case insensitive". + +                   + +                   +                   + +                   + +EBNF + + +ebnf.assignment +rtf + + +ebnf.assignment +The EBNF production assignment operator + + + + + +<xsl:param name="ebnf.assignment"> + <fo:inline font-family="{$monospace.font.family}"> + <xsl:text>::=</xsl:text> + </fo:inline> +</xsl:param> + + + +Description + +The ebnf.assignment parameter determines what +text is used to show assignment in productions +in productionsets. + +While ::= is common, so are several +other operators. + + + + + + +ebnf.statement.terminator +rtf + + +ebnf.statement.terminator +Punctuation that ends an EBNF statement. + + + + + +<xsl:param name="ebnf.statement.terminator"></xsl:param> + + + +Description + +The ebnf.statement.terminator parameter determines what +text is used to terminate each production +in productionset. + +Some notations end each statement with a period. + + + + + + +Prepress + + +crop.marks +boolean + + +crop.marks +Output crop marks? + + + +<xsl:param name="crop.marks" select="0"></xsl:param> + + +Description + +If non-zero, crop marks will be added to each page. Currently this +works only with XEP if you have xep.extensions set. + + + + + + +crop.mark.width +string + + +crop.mark.width +Width of crop marks. + + + +<xsl:param name="crop.mark.width" select="'0.5pt'"></xsl:param> + + +Description + +Width of crop marks. Crop marks are controlled by +crop.marks parameter. + + + + + + +crop.mark.offset +string + + +crop.mark.offset +Length of crop marks. + + + +<xsl:param name="crop.mark.offset" select="'24pt'"></xsl:param> + + +Description + +Length of crop marks. Crop marks are controlled by +crop.marks parameter. + + + + + + +crop.mark.bleed +string + + +crop.mark.bleed +Length of invisible part of crop marks. + + + +<xsl:param name="crop.mark.bleed" select="'6pt'"></xsl:param> + + +Description + +Length of invisible part of crop marks. Crop marks are controlled by +crop.marks parameter. + + + + + + + + +The Stylesheet + +The param.xsl stylesheet is just a wrapper +around all these parameters. + + +<xsl:stylesheet exclude-result-prefixes="src" version="1.0"> + +<!-- This file is generated from param.xweb; do not edit this file! --> + +<!-- ******************************************************************** + $Id: param.xweb,v 1.114 2006/05/21 13:05:19 kosek Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<src:fragref linkend="abstract.properties.frag"></src:fragref> +<src:fragref linkend="abstract.title.properties.frag"></src:fragref> +<src:fragref linkend="admon.graphics.extension.frag"></src:fragref> +<src:fragref linkend="admon.graphics.frag"></src:fragref> +<src:fragref linkend="admon.graphics.path.frag"></src:fragref> +<src:fragref linkend="admon.textlabel.frag"></src:fragref> +<src:fragref linkend="admonition.properties.frag"></src:fragref> +<src:fragref linkend="admonition.title.properties.frag"></src:fragref> +<src:fragref linkend="graphical.admonition.properties.frag"></src:fragref> +<src:fragref linkend="nongraphical.admonition.properties.frag"></src:fragref> +<src:fragref linkend="alignment.frag"></src:fragref> +<src:fragref linkend="appendix.autolabel.frag"></src:fragref> +<src:fragref linkend="arbortext.extensions.frag"></src:fragref> +<src:fragref linkend="article.appendix.title.properties.frag"></src:fragref> +<src:fragref linkend="author.othername.in.middle.frag"></src:fragref> +<src:fragref linkend="autotoc.label.separator.frag"></src:fragref> +<src:fragref linkend="axf.extensions.frag"></src:fragref> +<src:fragref linkend="biblioentry.item.separator.frag"></src:fragref> +<src:fragref linkend="biblioentry.properties.frag"></src:fragref> +<src:fragref linkend="bibliography.collection.frag"></src:fragref> +<src:fragref linkend="bibliography.numbered.frag"></src:fragref> +<src:fragref linkend="blockquote.properties.frag"></src:fragref> +<src:fragref linkend="body.font.family.frag"></src:fragref> +<src:fragref linkend="body.font.master.frag"></src:fragref> +<src:fragref linkend="body.font.size.frag"></src:fragref> +<src:fragref linkend="body.margin.bottom.frag"></src:fragref> +<src:fragref linkend="body.margin.top.frag"></src:fragref> +<src:fragref linkend="body.start.indent.frag"></src:fragref> +<src:fragref linkend="body.end.indent.frag"></src:fragref> +<src:fragref linkend="bridgehead.in.toc.frag"></src:fragref> +<src:fragref linkend="callout.defaultcolumn.frag"></src:fragref> +<src:fragref linkend="callout.graphics.extension.frag"></src:fragref> +<src:fragref linkend="callout.graphics.frag"></src:fragref> +<src:fragref linkend="callout.graphics.number.limit.frag"></src:fragref> +<src:fragref linkend="callout.graphics.path.frag"></src:fragref> +<src:fragref linkend="callout.unicode.font.frag"></src:fragref> +<src:fragref linkend="callout.unicode.frag"></src:fragref> +<src:fragref linkend="callout.unicode.number.limit.frag"></src:fragref> +<src:fragref linkend="callout.unicode.start.character.frag"></src:fragref> +<src:fragref linkend="callouts.extension.frag"></src:fragref> +<src:fragref linkend="chapter.autolabel.frag"></src:fragref> +<src:fragref linkend="collect.xref.targets.frag"></src:fragref> +<src:fragref linkend="column.count.back.frag"></src:fragref> +<src:fragref linkend="column.count.body.frag"></src:fragref> +<src:fragref linkend="column.count.front.frag"></src:fragref> +<src:fragref linkend="column.count.index.frag"></src:fragref> +<src:fragref linkend="column.count.lot.frag"></src:fragref> +<src:fragref linkend="column.count.titlepage.frag"></src:fragref> +<src:fragref linkend="column.gap.back.frag"></src:fragref> +<src:fragref linkend="column.gap.body.frag"></src:fragref> +<src:fragref linkend="column.gap.front.frag"></src:fragref> +<src:fragref linkend="column.gap.index.frag"></src:fragref> +<src:fragref linkend="column.gap.lot.frag"></src:fragref> +<src:fragref linkend="column.gap.titlepage.frag"></src:fragref> +<src:fragref linkend="compact.list.item.spacing.frag"></src:fragref> +<src:fragref linkend="component.label.includes.part.label.frag"></src:fragref> +<src:fragref linkend="component.title.properties.frag"></src:fragref> +<src:fragref linkend="crop.marks.frag"></src:fragref> +<src:fragref linkend="crop.mark.width.frag"></src:fragref> +<src:fragref linkend="crop.mark.offset.frag"></src:fragref> +<src:fragref linkend="crop.mark.bleed.frag"></src:fragref> +<src:fragref linkend="current.docid.frag"></src:fragref> +<src:fragref linkend="default.float.class.frag"></src:fragref> +<src:fragref linkend="default.image.width.frag"></src:fragref> +<src:fragref linkend="default.table.width.frag"></src:fragref> +<src:fragref linkend="default.units.frag"></src:fragref> +<src:fragref linkend="dingbat.font.family.frag"></src:fragref> +<src:fragref linkend="double.sided.frag"></src:fragref> +<src:fragref linkend="draft.mode.frag"></src:fragref> +<src:fragref linkend="draft.watermark.image.frag"></src:fragref> +<src:fragref linkend="ebnf.assignment.frag"></src:fragref> +<src:fragref linkend="ebnf.statement.terminator.frag"></src:fragref> +<src:fragref linkend="equation.properties.frag"></src:fragref> +<src:fragref linkend="example.properties.frag"></src:fragref> +<src:fragref linkend="figure.properties.frag"></src:fragref> +<src:fragref linkend="firstterm.only.link.frag"></src:fragref> +<src:fragref linkend="footer.content.properties.frag"></src:fragref> +<src:fragref linkend="footer.rule.frag"></src:fragref> +<src:fragref linkend="footer.column.widths.frag"></src:fragref> +<src:fragref linkend="footer.table.height.frag"></src:fragref> +<src:fragref linkend="footers.on.blank.pages.frag"></src:fragref> +<src:fragref linkend="footnote.font.size.frag"></src:fragref> +<src:fragref linkend="footnote.number.format.frag"></src:fragref> +<src:fragref linkend="footnote.number.symbols.frag"></src:fragref> +<src:fragref linkend="footnote.mark.properties.frag"></src:fragref> +<src:fragref linkend="footnote.properties.frag"></src:fragref> +<src:fragref linkend="footnote.sep.leader.properties.frag"></src:fragref> +<src:fragref linkend="fop.extensions.frag"></src:fragref> +<src:fragref linkend="fop1.extensions.frag"></src:fragref> +<src:fragref linkend="formal.object.properties.frag"></src:fragref> +<src:fragref linkend="formal.procedures.frag"></src:fragref> +<src:fragref linkend="formal.title.placement.frag"></src:fragref> +<src:fragref linkend="formal.title.properties.frag"></src:fragref> +<src:fragref linkend="funcsynopsis.decoration.frag"></src:fragref> +<src:fragref linkend="funcsynopsis.style.frag"></src:fragref> +<src:fragref linkend="function.parens.frag"></src:fragref> +<src:fragref linkend="generate.index.frag"></src:fragref> +<src:fragref linkend="generate.section.toc.level.frag"></src:fragref> +<src:fragref linkend="generate.toc.frag"></src:fragref> +<src:fragref linkend="glossary.as.blocks.frag"></src:fragref> +<src:fragref linkend="glossary.collection.frag"></src:fragref> +<src:fragref linkend="glossentry.show.acronym.frag"></src:fragref> +<src:fragref linkend="glosslist.as.blocks.frag"></src:fragref> +<src:fragref linkend="glossterm.auto.link.frag"></src:fragref> +<src:fragref linkend="glossterm.separation.frag"></src:fragref> +<src:fragref linkend="glossterm.width.frag"></src:fragref> +<src:fragref linkend="graphic.default.extension.frag"></src:fragref> +<src:fragref linkend="header.content.properties.frag"></src:fragref> +<src:fragref linkend="header.rule.frag"></src:fragref> +<src:fragref linkend="header.column.widths.frag"></src:fragref> +<src:fragref linkend="header.table.height.frag"></src:fragref> +<src:fragref linkend="headers.on.blank.pages.frag"></src:fragref> +<src:fragref linkend="hyphenate.frag"></src:fragref> +<src:fragref linkend="hyphenate.verbatim.frag"></src:fragref> +<src:fragref linkend="hyphenate.verbatim.characters.frag"></src:fragref> +<src:fragref linkend="ignore.image.scaling.frag"></src:fragref> +<src:fragref linkend="img.src.path.frag"></src:fragref> +<src:fragref linkend="index.method.frag"></src:fragref> +<src:fragref linkend="index.on.role.frag"></src:fragref> +<src:fragref linkend="index.on.type.frag"></src:fragref> +<src:fragref linkend="informalequation.properties.frag"></src:fragref> +<src:fragref linkend="informalexample.properties.frag"></src:fragref> +<src:fragref linkend="informalfigure.properties.frag"></src:fragref> +<src:fragref linkend="informal.object.properties.frag"></src:fragref> +<src:fragref linkend="informaltable.properties.frag"></src:fragref> +<src:fragref linkend="index.preferred.page.properties.frag"></src:fragref> +<src:fragref linkend="index.div.title.properties.frag"></src:fragref> +<src:fragref linkend="index.entry.properties.frag"></src:fragref> +<src:fragref linkend="index.number.separator.frag"></src:fragref> +<src:fragref linkend="index.range.separator.frag"></src:fragref> +<src:fragref linkend="index.term.separator.frag"></src:fragref> +<src:fragref linkend="insert.link.page.number.frag"></src:fragref> +<src:fragref linkend="insert.xref.page.number.frag"></src:fragref> +<src:fragref linkend="itemizedlist.properties.frag"></src:fragref> +<src:fragref linkend="itemizedlist.label.properties.frag"></src:fragref> +<src:fragref linkend="itemizedlist.label.width.frag"></src:fragref> +<src:fragref linkend="keep.relative.image.uris.frag"></src:fragref> +<src:fragref linkend="l10n.gentext.default.language.frag"></src:fragref> +<src:fragref linkend="l10n.gentext.language.frag"></src:fragref> +<src:fragref linkend="l10n.gentext.use.xref.language.frag"></src:fragref> +<src:fragref linkend="l10n.lang.value.rfc.compliant.frag"></src:fragref> +<src:fragref linkend="label.from.part.frag"></src:fragref> +<src:fragref linkend="line-height.frag"></src:fragref> +<src:fragref linkend="linenumbering.everyNth.frag"></src:fragref> +<src:fragref linkend="linenumbering.extension.frag"></src:fragref> +<src:fragref linkend="linenumbering.separator.frag"></src:fragref> +<src:fragref linkend="linenumbering.width.frag"></src:fragref> +<src:fragref linkend="list.block.properties.frag"></src:fragref> +<src:fragref linkend="list.block.spacing.frag"></src:fragref> +<src:fragref linkend="list.item.spacing.frag"></src:fragref> +<src:fragref linkend="make.index.markup.frag"></src:fragref> +<src:fragref linkend="make.single.year.ranges.frag"></src:fragref> +<src:fragref linkend="make.year.ranges.frag"></src:fragref> +<src:fragref linkend="margin.note.properties.frag"></src:fragref> +<src:fragref linkend="margin.note.title.properties.frag"></src:fragref> +<src:fragref linkend="margin.note.float.type.frag"></src:fragref> +<src:fragref linkend="margin.note.width.frag"></src:fragref> +<src:fragref linkend="marker.section.level.frag"></src:fragref> +<src:fragref linkend="menuchoice.menu.separator.frag"></src:fragref> +<src:fragref linkend="menuchoice.separator.frag"></src:fragref> +<src:fragref linkend="monospace.font.family.frag"></src:fragref> +<src:fragref linkend="monospace.properties.frag"></src:fragref> +<src:fragref linkend="monospace.verbatim.properties.frag"></src:fragref> +<src:fragref linkend="nominal.table.width.frag"></src:fragref> +<src:fragref linkend="normal.para.spacing.frag"></src:fragref> +<src:fragref linkend="olink.doctitle.frag"></src:fragref> +<src:fragref linkend="olink.base.uri.frag"></src:fragref> +<src:fragref linkend="olink.debug.frag"></src:fragref> +<src:fragref linkend="olink.properties.frag"></src:fragref> +<src:fragref linkend="olink.lang.fallback.sequence.frag"></src:fragref> +<src:fragref linkend="orderedlist.properties.frag"></src:fragref> +<src:fragref linkend="orderedlist.label.properties.frag"></src:fragref> +<src:fragref linkend="orderedlist.label.width.frag"></src:fragref> +<src:fragref linkend="prefer.internal.olink.frag"></src:fragref> +<src:fragref linkend="insert.olink.page.number.frag"></src:fragref> +<src:fragref linkend="insert.olink.pdf.frag.frag"></src:fragref> +<src:fragref linkend="page.height.frag"></src:fragref> +<src:fragref linkend="page.height.portrait.frag"></src:fragref> +<src:fragref linkend="page.margin.bottom.frag"></src:fragref> +<src:fragref linkend="page.margin.inner.frag"></src:fragref> +<src:fragref linkend="page.margin.outer.frag"></src:fragref> +<src:fragref linkend="page.margin.top.frag"></src:fragref> +<src:fragref linkend="page.orientation.frag"></src:fragref> +<src:fragref linkend="page.width.frag"></src:fragref> +<src:fragref linkend="page.width.portrait.frag"></src:fragref> +<src:fragref linkend="paper.type.frag"></src:fragref> +<src:fragref linkend="part.autolabel.frag"></src:fragref> +<src:fragref linkend="passivetex.extensions.frag"></src:fragref> +<src:fragref linkend="pgwide.properties.frag"></src:fragref> +<src:fragref linkend="preface.autolabel.frag"></src:fragref> +<src:fragref linkend="preferred.mediaobject.role.frag"></src:fragref> +<src:fragref linkend="procedure.properties.frag"></src:fragref> +<src:fragref linkend="process.empty.source.toc.frag"></src:fragref> +<src:fragref linkend="process.source.toc.frag"></src:fragref> +<src:fragref linkend="profile.arch.frag"></src:fragref> +<src:fragref linkend="profile.attribute.frag"></src:fragref> +<src:fragref linkend="profile.condition.frag"></src:fragref> +<src:fragref linkend="profile.conformance.frag"></src:fragref> +<src:fragref linkend="profile.lang.frag"></src:fragref> +<src:fragref linkend="profile.os.frag"></src:fragref> +<src:fragref linkend="profile.revision.frag"></src:fragref> +<src:fragref linkend="profile.revisionflag.frag"></src:fragref> +<src:fragref linkend="profile.role.frag"></src:fragref> +<src:fragref linkend="profile.security.frag"></src:fragref> +<src:fragref linkend="profile.separator.frag"></src:fragref> +<src:fragref linkend="profile.userlevel.frag"></src:fragref> +<src:fragref linkend="profile.value.frag"></src:fragref> +<src:fragref linkend="profile.vendor.frag"></src:fragref> +<src:fragref linkend="punct.honorific.frag"></src:fragref> +<src:fragref linkend="qanda.defaultlabel.frag"></src:fragref> +<src:fragref linkend="qanda.inherit.numeration.frag"></src:fragref> +<src:fragref linkend="qandadiv.autolabel.frag"></src:fragref> +<src:fragref linkend="qanda.title.level1.properties.frag"></src:fragref> +<src:fragref linkend="qanda.title.level2.properties.frag"></src:fragref> +<src:fragref linkend="qanda.title.level3.properties.frag"></src:fragref> +<src:fragref linkend="qanda.title.level4.properties.frag"></src:fragref> +<src:fragref linkend="qanda.title.level5.properties.frag"></src:fragref> +<src:fragref linkend="qanda.title.level6.properties.frag"></src:fragref> +<src:fragref linkend="qanda.title.properties.frag"></src:fragref> +<src:fragref linkend="refentry.generate.name.frag"></src:fragref> +<src:fragref linkend="refentry.generate.title.frag"></src:fragref> +<src:fragref linkend="refentry.pagebreak.frag"></src:fragref> +<src:fragref linkend="refentry.title.properties.frag"></src:fragref> +<src:fragref linkend="refentry.xref.manvolnum.frag"></src:fragref> +<src:fragref linkend="refclass.suppress.frag"></src:fragref> +<src:fragref linkend="region.after.extent.frag"></src:fragref> +<src:fragref linkend="region.before.extent.frag"></src:fragref> +<src:fragref linkend="revhistory.table.properties.frag"></src:fragref> +<src:fragref linkend="revhistory.table.cell.properties.frag"></src:fragref> +<src:fragref linkend="revhistory.title.properties.frag"></src:fragref> +<src:fragref linkend="root.properties.frag"></src:fragref> +<src:fragref linkend="rootid.frag"></src:fragref> +<src:fragref linkend="runinhead.default.title.end.punct.frag"></src:fragref> +<src:fragref linkend="runinhead.title.end.punct.frag"></src:fragref> +<src:fragref linkend="sans.font.family.frag"></src:fragref> +<src:fragref linkend="section.autolabel.frag"></src:fragref> +<src:fragref linkend="section.autolabel.max.depth.frag"></src:fragref> +<src:fragref linkend="section.label.includes.component.label.frag"></src:fragref> +<src:fragref linkend="section.title.level1.properties.frag"></src:fragref> +<src:fragref linkend="section.title.level2.properties.frag"></src:fragref> +<src:fragref linkend="section.title.level3.properties.frag"></src:fragref> +<src:fragref linkend="section.title.level4.properties.frag"></src:fragref> +<src:fragref linkend="section.title.level5.properties.frag"></src:fragref> +<src:fragref linkend="section.title.level6.properties.frag"></src:fragref> +<src:fragref linkend="section.title.properties.frag"></src:fragref> +<src:fragref linkend="section.level1.properties.frag"></src:fragref> +<src:fragref linkend="section.level2.properties.frag"></src:fragref> +<src:fragref linkend="section.level3.properties.frag"></src:fragref> +<src:fragref linkend="section.level4.properties.frag"></src:fragref> +<src:fragref linkend="section.level5.properties.frag"></src:fragref> +<src:fragref linkend="section.level6.properties.frag"></src:fragref> +<src:fragref linkend="section.properties.frag"></src:fragref> +<src:fragref linkend="segmentedlist.as.table.frag"></src:fragref> +<src:fragref linkend="shade.verbatim.frag"></src:fragref> +<src:fragref linkend="shade.verbatim.style.frag"></src:fragref> +<src:fragref linkend="show.comments.frag"></src:fragref> +<src:fragref linkend="sidebar.properties.frag"></src:fragref> +<src:fragref linkend="sidebar.title.properties.frag"></src:fragref> +<src:fragref linkend="sidebar.float.type.frag"></src:fragref> +<src:fragref linkend="sidebar.float.width.frag"></src:fragref> +<src:fragref linkend="simplesect.in.toc.frag"></src:fragref> +<src:fragref linkend="subscript.properties.frag"></src:fragref> +<src:fragref linkend="superscript.properties.frag"></src:fragref> +<src:fragref linkend="symbol.font.family.frag"></src:fragref> +<src:fragref linkend="table.cell.border.color.frag"></src:fragref> +<src:fragref linkend="table.cell.border.style.frag"></src:fragref> +<src:fragref linkend="table.cell.border.thickness.frag"></src:fragref> +<src:fragref linkend="table.cell.padding.frag"></src:fragref> +<src:fragref linkend="table.footnote.number.format.frag"></src:fragref> +<src:fragref linkend="table.footnote.number.symbols.frag"></src:fragref> +<src:fragref linkend="table.footnote.properties.frag"></src:fragref> +<src:fragref linkend="table.frame.border.color.frag"></src:fragref> +<src:fragref linkend="table.frame.border.style.frag"></src:fragref> +<src:fragref linkend="table.frame.border.thickness.frag"></src:fragref> +<src:fragref linkend="table.properties.frag"></src:fragref> +<src:fragref linkend="tablecolumns.extension.frag"></src:fragref> +<src:fragref linkend="table.table.properties.frag"></src:fragref> +<src:fragref linkend="target.database.document.frag"></src:fragref> +<src:fragref linkend="targets.filename.frag"></src:fragref> +<src:fragref linkend="textdata.default.encoding.frag"></src:fragref> +<src:fragref linkend="tex.math.delims.frag"></src:fragref> +<src:fragref linkend="tex.math.in.alt.frag"></src:fragref> +<src:fragref linkend="textinsert.extension.frag"></src:fragref> +<src:fragref linkend="title.font.family.frag"></src:fragref> +<src:fragref linkend="title.margin.left.frag"></src:fragref> +<src:fragref linkend="toc.indent.width.frag"></src:fragref> +<src:fragref linkend="toc.line.properties.frag"></src:fragref> +<src:fragref linkend="toc.margin.properties.frag"></src:fragref> +<src:fragref linkend="toc.max.depth.frag"></src:fragref> +<src:fragref linkend="toc.section.depth.frag"></src:fragref> +<src:fragref linkend="ulink.footnotes.frag"></src:fragref> +<src:fragref linkend="ulink.hyphenate.frag"></src:fragref> +<src:fragref linkend="ulink.hyphenate.chars.frag"></src:fragref> +<src:fragref linkend="ulink.show.frag"></src:fragref> +<src:fragref linkend="use.extensions.frag"></src:fragref> +<src:fragref linkend="use.local.olink.style.frag"></src:fragref> +<src:fragref linkend="use.role.as.xrefstyle.frag"></src:fragref> +<src:fragref linkend="use.role.for.mediaobject.frag"></src:fragref> +<src:fragref linkend="use.svg.frag"></src:fragref> +<src:fragref linkend="variablelist.as.blocks.frag"></src:fragref> +<src:fragref linkend="variablelist.max.termlength.frag"></src:fragref> +<src:fragref linkend="variablelist.term.separator.frag"></src:fragref> +<src:fragref linkend="variablelist.term.break.after.frag"></src:fragref> +<src:fragref linkend="verbatim.properties.frag"></src:fragref> +<src:fragref linkend="xep.extensions.frag"></src:fragref> +<src:fragref linkend="xep.index.item.properties.frag"></src:fragref> +<src:fragref linkend="xref.label-page.separator.frag"></src:fragref> +<src:fragref linkend="xref.label-title.separator.frag"></src:fragref> +<src:fragref linkend="xref.properties.frag"></src:fragref> +<src:fragref linkend="xref.title-page.separator.frag"></src:fragref> +<src:fragref linkend="xref.with.number.and.title.frag"></src:fragref> + +</xsl:stylesheet> + + + + +                   \ No newline at end of file diff --git a/src/documentation/docbook-xsl/fo/param.xsl b/src/documentation/docbook-xsl/fo/param.xsl new file mode 100644 index 0000000000..6166142be0 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/param.xsl @@ -0,0 +1,8141 @@ + + + + + + + +admon.graphics +boolean + +admon.graphics +Use graphics in admonitions? + + +Description + +If true (non-zero), admonitions are presented in an alternate style that uses +a graphic. Default graphics are provided in the distribution. + + + + + + + +admon.graphics.extension +string + +admon.graphics.extension +Extension for admonition graphics + + +Description + +Sets the extension to use on admonition graphics. + + + + + + +admon.graphics.path +string + +admon.graphics.path +Path to admonition graphics + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the admonition graphics. + + + + +images/ + + +admon.textlabel +boolean + +admon.textlabel +Use text label in admonitions? + + +Description + +If true (non-zero), admonitions are presented with a generated +text label such as Note or Warning in the appropriate language. +If zero, such labels are turned off, but any title child +of the admonition element are still output. +The default value is 1. + + + + + + + +admonition.title.properties +To set the style for admonitions titles. + + +Description +How do you want admonitions titles styled? +Set the font-size, weight etc to the style required. + + + + + 14pt + bold + false + always + + + +admonition.properties +To set the style for admonitions. + + +Description +How do you want admonitions styled? +Set the font-size, weight, etc. to the style required + + + + + + +graphical.admonition.properties +To add properties to the outer block of a graphical admonition. + + +Description +These properties are added to the outer block containing the +entire graphical admonition, including its title. +It is used when the parameter +admon.graphics is set to nonzero. +Use this attribute-set to set the space above and below, +and any indent for the whole admonition. + +In addition to these properties, a graphical admonition +also applies the admonition.title.properties +attribute-set to the title, and applies the +admonition.properties attribute-set +to the rest of the content. + + + + + 1em + 0.8em + 1.2em + 1em + 0.8em + 1.2em + + + +nongraphical.admonition.properties +To add properties to the outer block of a nongraphical admonition. + + +Description +These properties are added to the outer block containing the +entire nongraphical admonition, including its title. +It is used when the parameter +admon.graphics is set to zero. +Use this attribute-set to set the space above and below, +and any indent for the whole admonition. + +In addition to these properties, a nongraphical admonition +also applies the admonition.title.properties +attribute-set to the title, and the +admonition.properties attribute-set +to the rest of the content. + + + + + 0.8em + 1em + 1.2em + 0.25in + 0.25in + + + +callout.defaultcolumn +integer + +callout.defaultcolumn +Indicates what column callouts appear in by default + + +Description + +If a callout does not identify a column (for example, if it uses +the linerange unit), +it will appear in the default column. + + + + + + + +callout.graphics +boolean + +callout.graphics +Use graphics for callouts? + + +Description + +If non-zero, callouts are presented with graphics (e.g., reverse-video +circled numbers instead of "(1)", "(2)", etc.). +Default graphics are provided in the distribution. + + + + + + + +callout.graphics.extension +string + +callout.graphics.extension +Extension for callout graphics + + +Description + +Sets the extension to use on callout graphics. + + + + + + +callout.graphics.number.limit +integer + +callout.graphics.number.limit +Number of the largest callout graphic + + +Description + +If callout.graphics +is non-zero, graphics are used to represent +callout numbers. The value of +callout.graphics.number.limit +is +the largest number for which a graphic exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + + + + +callout.graphics.path +string + +callout.graphics.path +Path to callout graphics + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the callout graphics. + + + + + + + +callout.unicode +boolean + +callout.unicode +Use Unicode characters rather than images for callouts. + + +Description + +The stylesheets can use either an image of the numbers one to ten, or the single Unicode character which represents the numeral, in white on a black background. Use this to select the Unicode character option. + + + + + + + +callout.unicode.font + + +callout.unicode.font +Specify a font for Unicode glyphs + + +Description + +The name of the font to specify around Unicode callout glyphs. +If set to the empty string, no font change will occur. + + + + + + + +callout.unicode.number.limit +integer + +callout.unicode.number.limit +Number of the largest callout graphic + + +Description + +If callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.number.limit +is +the largest number for which a unicode character exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + + + + +callout.unicode.start.character +integer + +callout.unicode.start.character +First Unicode character to use, decimal value. + + +Description + +If callout.graphics is zero and callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.start.character +is the decimal unicode value used for callout number one. Currently, +only 10102 is supported in the stylesheets for this parameter. + + + + + + + +callouts.extension +boolean + +callouts.extension +Enable the callout extension + + +Description + +The callouts extension processes areaset +elements in ProgramListingCO and other text-based +callout elements. + + + + + + + +autotoc.label.separator +string + +autotoc.label.separator +Separator between labels and titles in the ToC + + +Description + +String to use to seperate labels and title in a table of contents. + + + + + + +process.empty.source.toc +boolean + +process.empty.source.toc +Generate automated TOC if toc element occurs in a source document? + + +Description + +Specifies that if an empty toc element is +found in a source document, an automated TOC is generated. + + Depending on what the value of the + generate.toc parameter is, setting this + parameter to 1 could result in generation of + duplicate automated TOCs. So the + process.empty.source.toc is primarily useful + as an "override": by placing an empty toc in your + document and setting this parameter to 1, you can + force a TOC to be generated even if generate.toc + says not to. + + + + + + + + +process.source.toc +boolean + +process.source.toc +Process a non-empty toc element if it occurs in a source document? + + +Description + +Specifies that the contents of a non-empty "hard-coded" +toc element in a source document are processed to +generate a TOC in output. + + This parameter has no effect on automated generation of + TOCs. An automated TOC may still be generated along with the + "hard-coded" TOC. To suppress automated TOC generation, adjust the + value of the generate.toc paramameter. + + The process.source.toc parameter also has + no effect if the toc element is empty; handling + for empty toc is controlled by the + process.empty.source.toc parameter. + + + + + + + + +generate.toc +table + +generate.toc +Control generation of ToCs and LoTs + + +Description + +This parameter has a structured value. It is a table of space-delimited +path/value pairs. Each path identifies some element in the source document +using a restricted subset of XPath (only the implicit child axis, no wildcards, +no predicates). Paths can be either relative or absolute. + +When processing a particular element, the stylesheets consult this table to +determine if a ToC (or LoT(s)) should be generated. + +For example, consider the entry: + +book toc,figure + +This indicates that whenever a book is formatted, a +Table Of Contents and a List of Figures should be generated. Similarly, + +/chapter toc + +indicates that whenever a document that has a root +of chapter is formatted, a Table of +Contents should be generated. The entry chapter would match +all chapters, but /chapter matches only chapter +document elements. + +Generally, the longest match wins. So, for example, if you want to distinguish +articles in books from articles in parts, you could use these two entries: + +book/article toc,figure +part/article toc + +Note that an article in a part can never match a book/article, +so if you want nothing to be generated for articles in parts, you can simply leave +that rule out. + +If you want to leave the rule in, to make it explicit that you're turning +something off, use the value nop. For example, the following +entry disables ToCs and LoTs for articles: + +article nop + +Do not simply leave the word article in the file +without a matching value. That'd be just begging the silly little +path/value parser to get confused. + +Section ToCs are further controlled by the +generate.section.toc.level parameter. +For a given section level to have a ToC, it must have both an entry in +generate.toc and be within the range enabled by +generate.section.toc.level. + + + + +/appendix toc,title +article/appendix nop +/article toc,title +book toc,title,figure,table,example,equation +/chapter toc,title +part toc,title +/preface toc,title +reference toc,title +/sect1 toc +/sect2 toc +/sect3 toc +/sect4 toc +/sect5 toc +/section toc +set toc,title + + + +generate.index +boolean + +generate.index +Do you want an index? + + +Description + +Specify if an index should be generated. + + + + + + +make.index.markup +boolean + +make.index.markup +Generate XML index markup in the index? + + +Description + +This parameter enables a very neat trick for getting properly +merged, collated back-of-the-book indexes. G. Ken Holman suggested +this trick at Extreme Markup Languages 2002 and I'm indebted to him +for it. + +Jeni Tennison's excellent code in +autoidx.xsl does a great job of merging and +sorting indexterms in the document and building a +back-of-the-book index. However, there's one thing that it cannot +reasonably be expected to do: merge page numbers into ranges. (I would +not have thought that it could collate and suppress duplicate page +numbers, but in fact it appears to manage that task somehow.) + +Ken's trick is to produce a document in which the index at the +back of the book is displayed in XML. Because the index +is generated by the FO processor, all of the page numbers have been resolved. +It's a bit hard to explain, but what it boils down to is that instead of having +an index at the back of the book that looks like this: + +
                  +A +ap1, 1, 2, 3 + +
                  + +you get one that looks like this: + +
                  +<indexdiv>A</indexdiv> +<indexentry> +<primaryie>ap1</primaryie>, +<phrase role="pageno">1</phrase>, +<phrase role="pageno">2</phrase>, +<phrase role="pageno">3</phrase> +</indexentry> +
                  + +After building a PDF file with this sort of odd-looking index, you can +extract the text from the PDF file and the result is a proper index expressed in +XML. + +Now you have data that's amenable to processing and a simple Perl script +(such as fo/pdf2index) can +merge page ranges and generate a proper index. + +Finally, reformat your original document using this literal index instead of +an automatically generated one and bingo! + +                   +                   + + + +index.method +string + +index.method +Select method used to group index entries in an index + + +Description + +This parameter lets you select which method should be +used to sort and group index entries in an index. +Indexes in languages that have accented characters typically +sort together accented words and unaccented words. +So Á (A acute) would sort together +with A, so both would appear in the A +section of the index. + + +The default indexing method does not sort accented characters this way. +Words that start with an accented character will instead appear in the +Symbols section of the index. +As such, the default method is only suitable for +English and other unaccented languages. +The other indexing methods require extensions of one type or +another, which is why there are not used by default. + +The three choices for indexing method are: + + +english + + +(default) Sort and groups words based only on the Latin alphabet. +Accented words and words in non-Latin alphabets will be +put in the Symbols section of the index. + + + + +kosek + + +Sort and groups words based on letter groups configured in +the DocBook locale file for the given language. +For example, the French locale file is common/fr.xml. +This method requires support for EXSLT extensions in +the XSL processor. It also requires support for using +user-defined functions in xsl:key (xsltproc does not). + +This method is suitable for any language for which you can +list all the individual characters that should appear +in each letter group in an index. +It is probably not practical to use it for ideographic languages +such as Chinese that have hundreds or thousands of characters. + +To use this method, your customization must set this +parameter and import an additional stylesheet module: +<xsl:import href="[path-to-stylesheets]/common/autoidx-ng.xsl"/> +<xsl:param name="index.method">kosek</xsl:param> + + +The stylesheet module defines functions and adds an xsl:key +used by the method. + + + + +kimber + + +This method uses extensions to the Saxon processor to implement +sophisticated indexing processes. It uses its own +configuration file, which can include information for any number of +languages. Each language's configuration can group +words using either an +enumerated method similar to the kosek method, or it can +designate the first character in each group when viewed in sort order. +The latter configuration is useful for ideographic languages +such as Chinese, Japanese, and Korean. +You can also define your own collation algorithms and where you +want Latin-alphabet words sorted. + + +For a whitepaper describing the extensions, see: +. + + + +To download the extension library, see +. + + + + +To use this method, you must: + + + +Use Saxon as your XSLT processor. + + + +Install and configure the Innodata Isogen library, using +the documentation that comes with it. + + + +Set this parameter's value to kimber. + + + +Import the index extensions stylesheet module +common/autoidx-ng.xsl into your +customization. + + + + + + + + + + + + + +index.on.type +boolean + +index.on.type +Select indexterms based on type +attribute value + + +Description + + +If non-zero, +then an index element that has a +type attribute +value will contain only those indexterm +elements with a matching type attribute value. +If an index has no type +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + + +If index.on.type is zero, then the +type attribute has no effect +on selecting indexterms for an index. + + +For those using DocBook version 4.2 or earlier, +the type attribute is not available +for index terms. However, you can achieve the same +effect by using the role attribute +in the same manner on indexterm +and index, and setting the stylesheet parameter +index.on.role to a nonzero value. + + + + + + + +index.on.role +boolean + +index.on.role +Select indexterms based on role value + + +Description + + +If non-zero, +then an index element that has a +role attribute +value will contain only those indexterm +elements with a matching role value. +If an index has no role +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + +If index.on.role is zero, then the +role attribute has no effect +on selecting indexterms for an index. + + +If you are using DocBook version 4.3 or later, you should +use the type attribute instead of role +on indexterm and index, +and set the index.on.type to a nonzero +value. + + + + + + + +index.preferred.page.properties +Properties used to emphasize page number references for +significant index terms + + +Description + +Properties used to emphasize page number references for +significant index terms (significance=preffered). Currently works only with +XEP. + + + + + bold + + + +index.entry.properties +Properties applied to the formatted entries +in an index + + +Description + +This attribute set is applied to the block containing +the entries in a letter division in an index. It can be used to set the +font-size, font-family, and other inheritable properties that will be +applied to all index entries. + + + + + 0pt + + + +index.div.title.properties +Properties associated with the letter headings in an +index + + +Description + +This attribute set is used on the letter headings that separate +the divisions in an index. + + + + + 0pt + 14.4pt + + bold + always + + + + 0pt + + + +index.number.separator +string + +index.number.separator +Override for punctuation separating page numbers in index + + +Description + +This parameter permits you to override the text to insert between +page references in a formatted index entry. Typically +that would be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'number-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. This punctuation appears between +such section titles in an HTML index. + + + + + + + +index.range.separator +string + +index.range.separator +Override for punctuation separating the two numbers +in a page range in index + + +Description + +This parameter permits you +to override the text to insert between +the two numbers of a page range in an index. +This parameter is only used by those XSL-FO processors +that support an extension for generating such page ranges +(such as XEP). + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'range-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. So there are no page ranges +and this parameter has no effect. + + + + + + + +index.term.separator +string + +index.term.separator +Override for punctuation separating an index term +from its list of page references in an index + + +Description + +This parameter permits you to override +the text to insert between +the end of an index term and its list of page references. +Typically that might be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'term-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +fill in the content for this normally empty +override parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. +For fo output, it could be an fo:leader +element to provide space of a specific length, or a dot leader. + + + + + + + +xep.index.item.properties +Properties associated with XEP index-items + + +Description + +Properties associated with XEP index-items. For more info see +the section "Indexes" in +. + + + + + true + true + + + +toc.section.depth +integer + +toc.section.depth +How deep should recursive sections appear +in the TOC? + + +Description + +Specifies the depth to which recursive sections should appear in the +TOC. + + + + +2 + + +toc.max.depth +integer + +toc.max.depth +How maximaly deep should be each TOC? + + +Description + +Specifies the maximal depth of TOC on all levels. + + + +8 + + +toc.indent.width +float + +toc.indent.width +Amount of indentation for TOC entries + + +Description + +Specifies, in points, the distance by which each level of the +TOC is indented from its parent. + +This value is expressed in points, without +a unit (in other words, it is a bare number). Using a bare number allows the stylesheet +to perform calculations that would otherwise have to be performed by the FO processor +because not all processors support expressions. + + + + + + +toc.line.properties +attribute set + +toc.line.properties +Properties for lines in ToC and LoTs + + +Description + +Properties which are applied to every line in ToC (or LoT). You can +modify them in order to change appearance of all, or some lines. For +example in order to make lines for chapters in bold specify the +following in your customization layer. + +<xsl:attribute-set name="toc.line.properties"> + <xsl:attribute name="font-weight"> + <xsl:when test="self::chapter | self::preface | self::appendix">bold</xsl:when> + <xsl:otherwise>normal</xsl:otherwise> + </xsl:attribute> +</xsl:attribute-set> + + + + + justify + start + + + +toc.margin.properties +Margin properties used on Tables of Contents + + +Description +This attribute set is used on Tables of Contents. These attributes are set +on the wrapper that surrounds the ToC block, not on each individual lines. + + + + 0.5em + 1em + 2em + 0.5em + 1em + 2em + + + +bridgehead.in.toc +boolean + +bridgehead.in.toc +Should bridgehead elements appear in the TOC? + + +Description + +If non-zero, bridgeheads appear in the TOC. Note that this option +is not fully supported and may be removed in a future version of the +stylesheets. + + + + + + + +simplesect.in.toc +boolean + +simplesect.in.toc +Should simplesect elements appear in the TOC? + + +Description + +If non-zero, simplesects appear in the TOC. + + + + + + + +generate.section.toc.level +integer + +generate.section.toc.level +Control depth of TOC generation in sections + + +Description + +The generate.section.toc.level parameter +controls the depth of section in which TOCs will be generated. Note +that this is related to, but not the same as +toc.section.depth, which controls the depth to +which TOC entries will be generated in a given TOC. +If, for example, generate.section.toc.level +is 3, TOCs will be generated in first, second, and third +level sections, but not in fourth level sections. + + + + + + + +arbortext.extensions +boolean + +arbortext.extensions +Enable Arbortext extensions? + + +Description + +If non-zero, +Arbortext +extensions will be used. + +This parameter can also affect which graphics file formats +are supported + + + + + + +axf.extensions +boolean + +axf.extensions +Enable XSL Formatter extensions? + + +Description + +If non-zero, +XSL Formatter +extensions will be used. XSL Formatter extensions consists of PDF bookmarks, +document information and better index processing. + +This parameter can also affect which graphics file formats +are supported + + + + + + +fop.extensions +boolean + +fop.extensions +Enable FOP extensions for version 0.20.5 and earlier + + +Description + +If non-zero, extensions intended for +FOP +version 0.20.5 and earlier will be used. +At present, this consists of PDF bookmarks. + + +This parameter can also affect which graphics file formats +are supported + +If you are using a version of FOP beyond +version 0.20.5, then use the fop1.extensions +instead. + + + + + + +fop1.extensions +boolean + +fop1.extensions +Enable extensions for FOP version 1 and later + + +Description + +If non-zero, extensions for +FOP +version 1 and later will be used. + + +This parameter can also affect which graphics file formats +are supported + +The original fop.extensions +should still be used for FOP version 0.20.5 and earlier. + + + + + + +passivetex.extensions +boolean + +passivetex.extensions +Enable PassiveTeX extensions? + + +Description + +If non-zero, +PassiveTeX +extensions will be used. At present, this consists of PDF bookmarks +and sorted index terms. + + +This parameter can also affect which graphics file formats +are supported + + + + + +tex.math.in.alt +string + +tex.math.in.alt +TeX notation used for equations + + +Description + +If you want type math directly in TeX notation in equations, +this parameter specifies notation used. Currently are supported two +values -- plain and latex. Empty +value means that you are not using TeX math at all. + +Preferred way for including TeX alternative of math is inside of +textobject element. Eg.: + +<inlineequation> +<inlinemediaobject> +<imageobject> +<imagedata fileref="eq1.gif"/> +</imageobject> +<textobject><phrase>E=mc squared</phrase></textobject> +<textobject role="tex"><phrase>E=mc^2</phrase></textobject> +</inlinemediaobject> +</inlineequation> + +If you are using graphic element, you can +store TeX inside alt element: + +<inlineequation> +<alt role="tex">a^2+b^2=c^2</alt> +<graphic fileref="a2b2c2.gif"/> +</inlineequation> + +If you want use this feature, you should process your FO with +PassiveTeX, which only supports TeX math notation. When calling +stylsheet, don't forget to specify also +passivetex.extensions=1. + +If you want equations in HTML, just process generated file +tex-math-equations.tex by TeX or LaTeX. Then run +dvi2bitmap program on result DVI file. You will get images for +equations in your document. + + + + + + +tex.math.delims +boolean + +tex.math.delims +Should be equations outputed for processing by TeX +automatically surrounded by math mode delimiters + + +Description + +For compatibility with DSSSL based DBTeXMath from Allin Cottrell +you should set this parameter to 0. + + + + + + +xep.extensions +boolean + +xep.extensions +Enable XEP extensions? + + +Description + +If non-zero, +XEP +extensions will be used. XEP extensions consists of PDF bookmarks, +document information and better index processing. + + +This parameter can also affect which graphics file formats +are supported + + + + + +linenumbering.everyNth +integer + +linenumbering.everyNth +Indicate which lines should be numbered + + +Description + +If line numbering is enabled, everyNth line will be numbered. + + + + + + + +linenumbering.extension +boolean + +linenumbering.extension +Enable the line numbering extension + + +Description + +If true, verbatim environments (elements that have the +format='linespecific' notation attribute: address, literallayout, +programlisting, screen, synopsis) that specify line numbering will +have, surprise, line numbers. + + + + + + + +linenumbering.separator +string + +linenumbering.separator +Specify a separator between line numbers and lines + + +Description + +The separator is inserted between line numbers and lines in +the verbatim environment. + + + + + + + +linenumbering.width +integer + +linenumbering.width +Indicates the width of line numbers + + +Description + +If line numbering is enabled, line numbers will appear right +justified in a field "width" characters wide. + + + + + + + +tablecolumns.extension +boolean + +tablecolumns.extension +Enable the table columns extension function + + +Description + +The table columns extension function adjusts the widths of table +columns in the HTML result to more accurately reflect the specifications +in the CALS table. + + + + + + + +textinsert.extension +boolean + +textinsert.extension +Enable the textinsert extension element + + +Description + +The textinsert extension element inserts the contents of a +a file into the result tree (as text). + + + + + + + +textdata.default.encoding +string + +textdata.default.encoding +Default encoding of external text files which are included +using textdata element + + +Description + +Default encoding of external text files which are included using +textdata element. This value is used only when you do not specify +encoding by appropriate attribute directly on textdata. Default +encoding (empty string) is interpreted as system default +encoding. + + + + + + +use.extensions +boolean + +use.extensions +Enable extensions + + +Description + +If non-zero, extensions may be used. Each extension is +further controlled by its own parameter. But if +use.extensions is zero, no extensions will +be used. + + + + + + + +appendix.autolabel +boolean + +appendix.autolabel +Specifies the labeling format for Appendix titles + + +Description + +If zero, then appendices will not be numbered. +Otherwise appendices will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperalpha). + + + + + + + +chapter.autolabel +boolean + +chapter.autolabel +Specifies the labeling format for Chapter titles + + +Description + +If zero, then chapters will not be numbered. +Otherwise chapters will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + + + + +part.autolabel +boolean + +part.autolabel +Specifies the labeling format for Part titles + + +Description + +If zero, then parts will not be numbered. +Otherwise parts will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperroman). + + + + + + + + +preface.autolabel +boolean + +preface.autolabel +Specifices the labeling format for Preface titles + + +Description + +If zero (default), then prefaces will not be numbered. +Otherwise prefaces will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + + + + + +section.autolabel +boolean + +section.autolabel +Are sections enumerated? + + +Description + +If true (non-zero), unlabeled sections will be enumerated. + + + + + + + +section.autolabel.max.depth +integer + +section.autolabel.max.depth +The deepest level of sections that are numbered. + + +Description + +When section numbering is turned on by the +section.autolabel parameter, +then this parameter controls the depth of section nesting +that is numbered. +Sections nested to a level deeper than this value will +not be numbered. + + + + + + + +section.label.includes.component.label +boolean + +section.label.includes.component.label +Do section labels include the component label? + + +Description + +If true (non-zero), section labels are prefixed with the label of the +component that contains them. + + + + + + + +label.from.part +boolean + +label.from.part +Renumber chapters in each part? + + +Description + +If label.from.part is non-zero, components +(chapters, appendixes, etc.) +will be numbered from 1 in each part. Otherwise, +they will be numbered monotonically throughout each +book. + + + + + + + +component.label.includes.part.label +boolean + +component.label.includes.part.label +Do component labels include the part label? + + +Description + +If true (non-zero), number labels for chapters, appendices, and other component +elements are prefixed with the label of the +part element that contains them. +So you might see Chapter II.3 instead of Chapter 3. +Also, the labels for formal elements such as table and figure will +include the part label. +If there is no part element container, then no prefix is generated. + + +This feature is most useful when the +label.from.part parameter is turned on. +In that case, there would be more than one chapter +1, and the extra part label prefix will identify +each chapter unambiguously. + + + + + + + +rootid +string + +rootid +Specify the root element to format + + +Description + +If rootid is specified, it must be the +value of an ID that occurs in the document being formatted. The entire +document will be loaded and parsed, but formatting will begin at the +element identified, rather than at the root. For example, this allows +you to process only chapter 4 of a book. +Because the entire document is available to the processor, automatic +numbering, cross references, and other dependencies are correctly +resolved. + + + + + + +make.single.year.ranges +boolean + +make.single.year.ranges +Print single-year ranges (e.g., 1998-1999) + + +Description + +If non-zero, year ranges that span a single year will be printed +in range notation (1998-1999) instead of discrete notation +(1998, 1999). + + + + + + +make.year.ranges +boolean + +make.year.ranges +Collate copyright years into ranges? + + +Description + +If non-zero, copyright years will be collated into ranges. + + + + + + +author.othername.in.middle +boolean + +author.othername.in.middle +Is othername in author a +middle name? + + +Description + +If true (non-zero), the othername of an author +appears between the firstname and +surname. Otherwise, othername +is suppressed. + + + + + + + +funcsynopsis.decoration +boolean + +funcsynopsis.decoration +Decorate elements of a FuncSynopsis? + + +Description + +If true (non-zero), elements of the FuncSynopsis will be decorated (e.g. bold or +italic). The decoration is controlled by functions that can be redefined +in a customization layer. + + + + + + + +funcsynopsis.style +list +ansi +kr + +funcsynopsis.style +What style of 'FuncSynopsis' should be generated? + + +Description + +If funcsynopsis.style is ansi, +ANSI-style function synopses are generated for a +funcsynopsis, otherwise K&R-style +function synopses are generated. + + + + +kr + + +function.parens +boolean + +function.parens +Generate parens after a function? + + +Description + +If not 0, the formatting of +a function element will include +generated parenthesis. + + + + +0 + + +refentry.generate.name +boolean + +refentry.generate.name +Output NAME header before 'RefName'(s)? + + +Description + +If true (non-zero), a "NAME" section title is output before the list +of 'RefName's. This parameter and +refentry.generate.title are mutually +exclusive. This means that if you change this parameter to zero, you +should set refentry.generate.title to 1 unless +you want get quite strange output. + + + + + + + +refentry.generate.title +boolean + +refentry.generate.title +Output title before 'RefName'(s)? + + +Description + +If true (non-zero), the reference page title or first name is +output before the list of 'RefName's. This parameter and +refentry.generate.name are mutually exclusive. +This means that if you change this parameter to 1, you +should set refentry.generate.name to 0 unless +you want get quite strange output. + + + + + + + +refentry.pagebreak +boolean + +refentry.pagebreak +Start each refentry on a new page + + +Description + +If non-zero (the default), each refentry +element will start on a new page. If zero, a page +break will not be generated between refentry elements. +The exception is when the refentry elements are children of +a part element, in which case the page breaks are always +retained. That is because a part element does not generate +a page-sequence for its children, so each refentry must +start its own page-sequence. + + + + + + + +refentry.title.properties +attribute set + +refentry.title.properties +Title properties for a refentry title + + +Description + +Formatting properties applied to the title generated for the +refnamediv part of output for +refentry when the value of the +refentry.generate.title parameter is +non-zero. The font size is supplied by the appropriate section.levelX.title.properties +attribute-set, computed from the location of the +refentry in the section hierarchy. + + + This parameter has no effect on the the title generated for + the refnamediv part of output for + refentry when the value of the + refentry.generate.name parameter is + non-zero. By default, that title is formatted with the same + properties as the titles for all other first-level children of + refentry. + + + + + + + + + 18pt + bold + 1em + false + always + 0.8em + 1.0em + 1.2em + 0.5em + 0.4em + 0.6em + + + + +refentry.xref.manvolnum +boolean + +refentry.xref.manvolnum +Output manvolnum as part of +refentry cross-reference? + + +Description + +if true (non-zero), the manvolnum is used when cross-referencing +refentrys, either with xref +or citerefentry. + + + + + + + +refclass.suppress +boolean + +refclass.suppress +Suppress display of refclass contents? + + +Description + +If the value of refclass.suppress is +non-zero, then display of refclass contents is +suppressed in output. + + + + + + +default.table.width +length + +default.table.width +The default width of tables + + +Description + +If specified, this value will be used for the WIDTH attribute on +tables that do not specify an alternate width (with the dbhtml processing +instruction). + + + + + + +nominal.table.width +length + +nominal.table.width +The (absolute) nominal width of tables + + +Description + +In order to convert CALS column widths into HTML column widths, it +is sometimes necessary to have an absolute table width to use for conversion +of mixed absolute and relative widths. This value must be an absolute +length (not a percentag). + + + + + + +table.cell.padding + + +table.cell.padding + + + +Description + +FIXME: + + + + + 2pt + 2pt + 2pt + 2pt + + + +table.frame.border.thickness + + +table.frame.border.thickness +Specifies the thickness of the frame border + + +Description + +Specifies the thickness of the border on the table's frame. + + + + + + +table.frame.border.style + + +table.frame.border.style + + + +Description + +FIXME: + + + + + + +table.frame.border.color + + +table.frame.border.color + + + +Description + +FIXME: + + + + + + + +table.cell.border.thickness + + +table.cell.border.thickness + + + +Description + +FIXME: + + + + + + +table.cell.border.style + + +table.cell.border.style + + + +Description + +FIXME: + + + + + + +table.cell.border.color + + +table.cell.border.color + + + +Description + +FIXME: + + + + + + + +table.table.properties +Properties associated with a table + + +Description + +The styling for tables. This parameter should really +have been called table.properties, but that parameter +name was inadvertantly established for the block-level properties +of the table as a whole. + + +See also table.properties. + + + + + retain + collapse + + + +current.docid +string + +current.docid +targetdoc identifier for the document being +processed + + +Description +When olinks between documents are resolved for HTML output, the stylesheet can compute the relative path between the current document and the target document. The stylesheet needs to know the targetdoc identifiers for both documents, as they appear in the target.database.document database file. This parameter passes to the stylesheet +the targetdoc identifier of the current document, since that +identifier does not appear in the document itself. +This parameter can also be used for print output. If an olink's targetdoc id differs from the current.docid, then the stylesheet can append the target document's title to the generated olink text. That identifies to the reader that the link is to a different document, not the current document. See also olink.doctitle to enable that feature. + + + + + +collect.xref.targets +string + +collect.xref.targets +Controls whether cross reference data is +collected + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter determines whether the collection process is run when the document is processed by the stylesheet. The default value is no, which means the data file is not generated during processing. The other choices are yes, which means the data file is created and the document is processed for output, and only, which means the data file is created but the document is not processed for output. +See also targets.filename. + + + + + + +insert.olink.page.number +string + +insert.olink.page.number +Turns page numbers in olinks on and off + + +Description + +The value of this parameter determines if +cross references made between documents with +olink will +include page number citations. +In most cases this is only applicable to references in printed output. + +The parameter has three possible values. + + + +no +No page number references will be generated for olinks. + + + +yes +Page number references will be generated +for all olink references. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an olink element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + +Olinks that point to targets within the same document +are treated as xrefs, and controlled by +the insert.xref.page.number parameter. + + +Page number references for olinks to +external documents can only be inserted if the +information exists in the olink database. +This means each olink target element +(div or obj) +must have a page attribute +whose value is its page number in the target document. +The XSL stylesheets are not able to extract that information +during processing because pages have not yet been created in +XSLT transformation. Only the XSL-FO processor knows what +page each element is placed on. +Therefore some postprocessing must take place to populate +page numbers in the olink database. + + + + + + +no + + +insert.olink.pdf.frag +boolean + +insert.olink.pdf.frag +Add fragment identifiers for links into PDF files + + +Description + +The value of this parameter determines whether +the cross reference URIs to PDF documents made with +olink will +include fragment identifiers. + + +When forming a URI to link to a PDF document, +a fragment identifier (typically a '#' followed by an +id value) appended to the PDF filename can be used by +the PDF viewer to open +the PDF file to a location within the document instead of +the first page. +However, not all PDF files have id +values embedded in them, and not all PDF viewers can +handle fragment identifiers. + + +If insert.olink.pdf.frag is set +to a non-zero value, then any olink targeting a +PDF file will have the fragment identifier appended to the URI. +The URI is formed by concatenating the value of the +olink.base.uri parameter, the +value of the baseuri +attribute from the document +element in the olink database with the matching +targetdoc value, +and the value of the href +attribute for the targeted element in the olink database. +The href attribute +contains the fragment identifier. + + +If insert.olink.pdf.frag is set +to zero (the default value), then +the href attribute +from the olink database +is not appended to PDF olinks, so the fragment identifier is left off. +A PDF olink is any olink for which the +baseuri attribute +from the matching document +element in the olink database ends with '.pdf'. +Any other olinks will still have the fragment identifier added. + + + + + + +olink.base.uri +uri + +olink.base.uri +Base URI used in olink hrefs + + +Description +When cross reference data is collected for resolving olinks, it may be necessary to prepend a base URI to each target's href. This parameter lets you set that base URI when cross reference data is collected. This feature is needed when you want to link to a document that is processed without chunking. The output filename for such a document is not known to the XSL stylesheet; the only target information consists of fragment identifiers such as #idref. To enable the resolution of olinks between documents, you should pass the name of the HTML output file as the value of this parameter. Then the hrefs recorded in the cross reference data collection look like outfile.html#idref, which can be reached as links from other documents. + + + + + +olink.debug +boolean + +olink.debug +Turn on debugging messages for olinks + + +Description + +If non-zero, then each olink will generate several +messages about how it is being resolved during processing. +This is useful when an olink does not resolve properly +and the standard error messages are not sufficient to +find the problem. + + +You may need to read through the olink XSL templates +to understand the context for some of the debug messages. + + + + + + + +olink.doctitle +string + +olink.doctitle +show the document title for external olinks? + + + +Description +When olinks between documents are resolved, the generated text +may not make it clear that the reference is to another document. +It is possible for the stylesheets to append the other document's +title to external olinks. For this to happen, two parameters must +be set. + + +This olink.doctitle parameter +should be set to either yes or maybe +to enable this feature. + + + +And you should also set the current.docid +parameter to the document id for the document currently +being processed for output. + + + + + +Then if an olink's targetdoc id differs from +the current.docid value, the stylesheet knows +that it is a reference to another document and can +append the target document's +title to the generated olink text. + +The text for the target document's title is copied from the +olink database from the ttl element +of the top-level div for that document. +If that ttl element is missing or empty, +no title is output. + + +The supported values for olink.doctitle are: + + + +yes + + +Always insert the title to the target document if it is not +the current document. + + + + +no + + +Never insert the title to the target document, even if requested +in an xrefstyle attribute. + + + + +maybe + + +Only insert the title to the target document, if requested +in an xrefstyle attribute. + + + + +An xrefstyle attribute +may override the global setting for individual olinks. +The following values are supported in an +xrefstyle +attribute using the select: syntax: + + + + +docname + + +Insert the target document name for this olink using the +docname gentext template, but only +if the value of olink.doctitle +is not no. + + + + +docnamelong + + +Insert the target document name for this olink using the +docnamelong gentext template, but only +if the value of olink.doctitle +is not no. + + + + +nodocname + + +Omit the target document name even if +the value of olink.doctitle +is yes. + + + + +Another way of inserting the target document name +for a single olink is to employ an +xrefstyle +attribute using the template: syntax. +The %o placeholder (the letter o, not zero) +in such a template +will be filled in with the target document's title when it is processed. +This will occur regardless of +the value of olink.doctitle. + +Note that prior to version 1.66 of the XSL stylesheets, +the allowed values for this parameter were 0 and 1. Those +values are still supported and mapped to 'no' and 'yes', respectively. + + + + + + +olink.lang.fallback.sequence +string + +olink.lang.fallback.sequence +look up translated documents if olink not found? + + + +Description + +This parameter defines a list of lang values +to search among to resolve olinks. + + +Normally an olink tries to resolve to a document in the same +language as the olink itself. The language of an olink +is determined by its nearest ancestor element with a +lang attribute, otherwise the +value of the l10n.gentext.default.lang +parameter. + + +An olink database can contain target data for the same +document in multiple languages. Each set of data has the +same value for the targetdoc attribute in +the document element in the database, but with a +different lang attribute value. + + +When an olink is being resolved, the target is first +sought in the document with the same language as the olink. +If no match is found there, then this parameter is consulted +for additional languages to try. + +The olink.lang.fallback.sequence +must be a whitespace separated list of lang values to +try. The first one with a match in the olink database is used. +The default value is empty. + +For example, a document might be written in German +and contain an olink with +targetdoc="adminguide". +When the document is processed, the processor +first looks for a target dataset in the +olink database starting with: + +<document targetdoc="adminguide" lang="de">. + + +If there is no such element, then the +olink.lang.fallback.sequence +parameter is consulted. +If its value is, for example, fr en, then the processor next +looks for targetdoc="adminguide" lang="fr", and +then for targetdoc="adminguide" lang="en". +If there is still no match, it looks for +targetdoc="adminguide" with no +lang attribute. + + +This parameter is useful when a set of documents is only +partially translated, or is in the process of being translated. +If a target of an olink has not yet been translated, then this +parameter permits the processor to look for the document in +other languages. This assumes the reader would rather have +a link to a document in a different language than to have +a broken link. + + + + + + + +olink.properties +Properties associated with the cross-reference +text of an olink. + + +Description + +This attribute set is used on cross reference text +from an olink. It is not applied to the +optional page number or +optional title of the external document. + + + + + + + +prefer.internal.olink +boolean + +prefer.internal.olink +Prefer a local olink reference to an external reference + + +Description + +If you are re-using XML content modules in multiple documents, +you may want to redirect some of your olinks. This parameter +permits you to redirect an olink to the current document. + + +For example: you are writing documentation for a product, +which includes 3 manuals: a little installation +booklet (booklet.xml), a user +guide (user.xml), and a reference manual (reference.xml). +All 3 documents begin with the same introduction section (intro.xml) that +contains a reference to the customization section (custom.xml) which is +included in both user.xml and reference.xml documents. + + +How do you write the link to custom.xml in intro.xml +so that it is interpreted correctly in all 3 documents? + +If you use xref, it will fail in user.xml. + +If you use olink (pointing to reference.xml), +the reference in user.xml +will point to the customization section of the reference manual, while it is +actually available in user.xml. + + + +If you set the prefer.internal.olink +parameter to a non-zero value, then the processor will +first look in the olink database +for the olink's targetptr attribute value +in document matching the current.docid +parameter value. If it isn't found there, then +it tries the document in the database +with the targetdoc +value that matches the olink's targetdoc +attribute. + + +This feature permits an olink reference to resolve to +the current document if there is an element +with an id matching the olink's targetptr +value. The current document's olink data must be +included in the target database for this to work. + + +There is a potential for incorrect links if +the same id attribute value is used for different +content in different documents. +Some of your olinks may be redirected to the current document +when they shouldn't be. It is not possible to control +individual olink instances. + + + + + + + +target.database.document +uri + +target.database.document +Name of master database file for resolving +olinks + + +Description + +To resolve olinks between documents, the stylesheets use +a master database document that identifies the target datafiles for all the documents within the scope +of the olinks. This parameter value is the URI of +the master document to be read during processing to resolve olinks. +The default value is olinkdb.xml. +The data structure of the file is defined in the targetdatabase.dtd DTD. The database file provides the high level elements to record the identifiers, locations, and relationships of documents. The cross reference data for individual documents is generally pulled into the database using system entity references or XIncludes. See also targets.filename. + + + + + + + +targets.filename +string + +targets.filename +Name of cross reference targets data file + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter lets you change the name of the generated +file from the default name target.db. +The name must agree with that used in the target database +used to resolve olinks during processing. +See also target.database.document. + + + + + + +use.local.olink.style +boolean + +use.local.olink.style +Process olinks using xref style of current +document + + +Description +When cross reference data is collected for use by olinks, the data for each potential target includes one field containing a completely assembled cross reference string, as if it were an xref generated in that document. Other fields record the separate title, number, and element name of each target. When an olink is formed to a target from another document, the olink resolves to that preassembled string by default. If the use.local.olink.style parameter is set to non-zero, then instead the cross +reference string is formed again from the target title, number, and +element name, using the stylesheet processing the targeting document. +Then olinks will match the xref style in the targeting document +rather than in the target document. If both documents are processed +with the same stylesheet, then the results will be the same. + + + + + +insert.xref.page.number +string + +insert.xref.page.number +Turns page numbers in xrefs on and off + + +Description + +The value of this parameter determines if +cross references (xrefs) in +printed output will +include page number citations. +It has three possible values. + + + +no +No page number references will be generated. + + + +yes +Page number references will be generated +for all xref elements. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an xref element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + + + + +no + + +xref.properties +Properties associated with cross-reference text + + +Description + +This attribute set is used to set properties +on cross reference text. + + + + + + + +xref.label-title.separator +string + +xref.label-title.separator +Punctuation or space separating label from title in xref + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and title, +then the value of this parameter is inserted between +label and title in the output. + + + + +: + + +xref.label-page.separator +string + +xref.label-page.separator +Punctuation or space separating label from page number in xref + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and page +but no title, +then the value of this parameter is inserted between +label and page number in the output. +If a title is included, then other separators are used. + + + + + + + +xref.title-page.separator +string + +xref.title-page.separator +Punctuation or space separating title from page number in xref + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both title and page number, +then the value of this parameter is inserted between +title and page number in the output. + + + + + + + +insert.link.page.number +string + +insert.link.page.number +Turns page numbers in link elements on and off + + +Description + +The value of this parameter determines if +cross references using the link element in +printed output will +include standard page number citations. +It has three possible values. + + + +no +No page number references will be generated. + + + +yes +Page number references will be generated +for all link elements. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for a link element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + + +Although the xrefstyle attribute +can be used to turn the page reference on or off, it cannot be +used to control the formatting of the page number as it +can in xref. +In link it will always format with +the style established by the +gentext template with name="page.citation" +in the l:context name="xref". + + + +no + + +compact.list.item.spacing +What space do you want between list items (when spacing=compact)? + + +Description +Specify what spacing you want between each list item when +spacing is +compact. + + + + 0em + 0em + 0.2em + + + +itemizedlist.properties +Properties that apply to each list-block generated by itemizedlist. + + +Description +Properties that apply to each fo:list-block generated by itemizedlist. + + + + + + +itemizedlist.label.properties +Properties that apply to each label inside itemized list. + + +Description +Properties that apply to each label inside itemized list. E.g.: +<xsl:attribute-set name="itemizedlist.label.properties"> + <xsl:attribute name="text-align">right</xsl:attribute> +</xsl:attribute-set> + + + + + + +itemizedlist.label.width +The default width of the label (bullet) in an itemized list. + + +Description +Specifies the default width of the label (usually a bullet or other +symbol) in an itemized list. You can override the default value on any +particular list with the “dbfo” processing instruction using the +“label-width” pseudoattribute. + + + + + +list.block.properties +Properties that apply to each list-block generated by list. + + +Description +Properties that apply to each fo:list-block generated by itemizedlist/orderedlist. + + + + 0.2em + 1.5em + + + +list.block.spacing +What spacing do you want before and after lists? + + +Description +Specify the spacing required before and after a list. It is necessary to specify the space after a list block because lists can come inside of paras. + + + + 1em + 0.8em + 1.2em + 1em + 0.8em + 1.2em + + + +list.item.spacing +What space do you want between list items? + + +Description +Specify what spacing you want between each list item. + + + + 1em + 0.8em + 1.2em + + + +orderedlist.properties +Properties that apply to each list-block generated by orderedlist. + + +Description +Properties that apply to each fo:list-block generated by orderedlist. + + + + 2em + + + +orderedlist.label.properties +Properties that apply to each label inside ordered list. + + +Description +Properties that apply to each label inside ordered list. E.g.: +<xsl:attribute-set name="orderedlist.label.properties"> + <xsl:attribute name="text-align">right</xsl:attribute> +</xsl:attribute-set> + + + + + + +orderedlist.label.width +The default width of the label (number) in an ordered list. + + +Description +Specifies the default width of the label (usually a number or +sequence of numbers) in an ordered list. You can override the default +value on any particular list with the “dbfo” processing instruction +using the “label-width” pseudoattribute. + + + + + +variablelist.max.termlength + + +variablelist.max.termlength +Specifies the longest term in variablelists + + +Description + +In variablelists, the listitem +is indented to leave room for the +term elements. That indent may be computed +if it is not specified with a termlength +attribute on the variablelist element. + + +The computation counts characters in the +term elements in the list +to find the longest term. However, some terms are very long +and would produce extreme indents. This parameter lets you +set a maximum character count. Any terms longer than the maximum +would line wrap. The default value is 24. + + +The character counts are converted to physical widths +by multiplying by 0.50em. There will be some variability +in how many actual characters fit in the space +since some characters are wider than others. + + + + +24 + + +variablelist.term.separator +string + +variablelist.term.separator +Text to separate terms within a multi-term +varlistentry + + +Description + +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is placed +after each term except the last. + + + To generate a line break between multiple terms in + a varlistentry, set a non-zero value for the + variablelist.term.break.after parameter. If + you do so, you may also want to set the value of the + variablelist.term.separator parameter to an + empty string (to suppress rendering of the default comma and space + after each term). + + + + +, + + +variablelist.term.break.after +boolean + +variablelist.term.break.after +Generate line break after each term within a +multi-term varlistentry? + + +Description + +Set a non-zero value for the +variablelist.term.break.after parameter to +generate a line break between terms in a +multi-term varlistentry. + + +If you set a non-zero value for +variablelist.term.break.after, you may also +want to set the value of the +variablelist.term.separator parameter to an +empty string (to suppress rendering of the default comma and space +after each term). + + + + +0 + + +qandadiv.autolabel +boolean + +qandadiv.autolabel +Are divisions in QAndASets enumerated? + + +Description + +If true (non-zero), unlabeled qandadivs will be enumerated. + + + + + + + +qanda.inherit.numeration +boolean + +qanda.inherit.numeration +Does enumeration of QandASet components inherit the numeration of parent elements? + + +Description + +If true (non-zero), numbered QandADiv elements and Questions and Answers inherit +the numeration of the ancestors of the QandASet. + + + + + + + +qanda.defaultlabel +boolean + +qanda.defaultlabel +Sets the default for defaultlabel on QandASet. + + +Description + +If no defaultlabel attribute is specified on a QandASet, this +value is used. It must be one of the legal values for the defaultlabel +attribute. + + + + +number + + +biblioentry.item.separator +string + +biblioentry.item.separator +Text to separate bibliography entries + + +Description + +Text to separate bibliography entries + + + + +. + + +bibliography.collection +string + +bibliography.collection +Name of the bibliography collection file + + +Description + +Maintaining bibliography entries across a set of documents is tedious, time +consuming, and error prone. It makes much more sense, usually, to store all of +the bibliography entries in a single place and simply extract +the ones you need in each document. + +That's the purpose of the +bibliography.collection parameter. To setup a global +bibliography database, follow these steps: + +First, create a stand-alone bibliography document that contains all of +the documents that you wish to reference. Make sure that each bibliography +entry (whether you use biblioentry or bibliomixed) +has an ID. + +My global bibliography, ~/bibliography.xml begins +like this: + + +<!DOCTYPE bibliography + PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<bibliography><title>References</title> + +<bibliomixed id="xml-rec"><abbrev>XML 1.0</abbrev>Tim Bray, +Jean Paoli, C. M. Sperberg-McQueen, and Eve Maler, editors. +<citetitle><ulink url="http://www.w3.org/TR/REC-xml">Extensible Markup +Language (XML) 1.0 Second Edition</ulink></citetitle>. +World Wide Web Consortium, 2000. +</bibliomixed> + +<bibliomixed id="xml-names"><abbrev>Namespaces</abbrev>Tim Bray, +Dave Hollander, +and Andrew Layman, editors. +<citetitle><ulink url="http://www.w3.org/TR/REC-xml-names/">Namespaces in +XML</ulink></citetitle>. +World Wide Web Consortium, 1999. +</bibliomixed> + +<!-- ... --> +</bibliography> + + + +When you create a bibliography in your document, simply +provide empty bibliomixed +entries for each document that you wish to cite. Make sure that these +elements have the same ID as the corresponding real +entry in your global bibliography. + +For example: + + +<bibliography><title>Bibliography</title> + +<bibliomixed id="xml-rec"/> +<bibliomixed id="xml-names"/> +<bibliomixed id="DKnuth86">Donald E. Knuth. <citetitle>Computers and +Typesetting: Volume B, TeX: The Program</citetitle>. Addison-Wesley, +1986. ISBN 0-201-13437-3. +</bibliomixed> +<bibliomixed id="relaxng"/> + +</bibliography> + + +Note that it's perfectly acceptable to mix entries from your +global bibliography with normal entries. You can use +xref or other elements to cross-reference your +bibliography entries in exactly the same way you do now. + +Finally, when you are ready to format your document, simply set the +bibliography.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global bibliography. + +The stylesheets will format the bibliography in your document as if +all of the entries referenced appeared there literally. + + + + + + +bibliography.numbered +boolean + +bibliography.numbered +Should bibliography entries be numbered? + + +Description + +If non-zero bibliography entries will be numbered + + + + + + +biblioentry.properties +To set the style for biblioentry. + + +Description +How do you want biblioentry styled? +Set the font-size, weight, space-above and space-below, indents, etc. to the style required + + + + + 0.5in + -0.5in + + + +glossterm.auto.link +boolean + +glossterm.auto.link +Generate links from glossterm to glossentry automaticaly? + + +Description + +If true, a link will be automatically created from glossterm +to glossentry for that glossary term. This is usefull when your +glossterm names are consistent and you don't want to add links +manually. +If there is linkend on +glossterm then is used instead of autogeneration of +link. + + + + + + +firstterm.only.link +boolean + +firstterm.only.link +Does automatic glossterm linking only apply to firstterms? + + +Description + +If true, only firstterms will be automatically linked +to the glossary. If glossary linking is not enabled, this parameter +has no effect. + + + + + + +glossary.collection +string + +glossary.collection +Name of the glossary collection file + + +Description + +Glossaries maintained independently across a set of documents +are likely to become inconsistent unless considerable effort is +expended to keep them in sync. It makes much more sense, usually, to +store all of the glossary entries in a single place and simply +extract the ones you need in each document. + +That's the purpose of the +glossary.collection parameter. To setup a global +glossary database, follow these steps: + +Setting Up the Glossary Database + +First, create a stand-alone glossary document that contains all of +the entries that you wish to reference. Make sure that each glossary +entry has an ID. + +Here's an example glossary: + + + +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE glossary + PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<glossary> +<glossaryinfo> +<editor><firstname>Eric</firstname><surname>Raymond</surname></editor> +<title>Jargon File 4.2.3 (abridged)</title> +<releaseinfo>Just some test data</releaseinfo> +</glossaryinfo> + +<glossdiv><title>0</title> + +<glossentry> +<glossterm>0</glossterm> +<glossdef> +<para>Numeric zero, as opposed to the letter `O' (the 15th letter of +the English alphabet). In their unmodified forms they look a lot +alike, and various kluges invented to make them visually distinct have +compounded the confusion. If your zero is center-dotted and letter-O +is not, or if letter-O looks almost rectangular but zero looks more +like an American football stood on end (or the reverse), you're +probably looking at a modern character display (though the dotted zero +seems to have originated as an option on IBM 3270 controllers). If +your zero is slashed but letter-O is not, you're probably looking at +an old-style ASCII graphic set descended from the default typewheel on +the venerable ASR-33 Teletype (Scandinavians, for whom /O is a letter, +curse this arrangement). (Interestingly, the slashed zero long +predates computers; Florian Cajori's monumental "A History of +Mathematical Notations" notes that it was used in the twelfth and +thirteenth centuries.) If letter-O has a slash across it and the zero +does not, your display is tuned for a very old convention used at IBM +and a few other early mainframe makers (Scandinavians curse <emphasis>this</emphasis> +arrangement even more, because it means two of their letters collide). +Some Burroughs/Unisys equipment displays a zero with a <emphasis>reversed</emphasis> +slash. Old CDC computers rendered letter O as an unbroken oval and 0 +as an oval broken at upper right and lower left. And yet another +convention common on early line printers left zero unornamented but +added a tail or hook to the letter-O so that it resembled an inverted +Q or cursive capital letter-O (this was endorsed by a draft ANSI +standard for how to draw ASCII characters, but the final standard +changed the distinguisher to a tick-mark in the upper-left corner). +Are we sufficiently confused yet?</para> +</glossdef> +</glossentry> + +<glossentry> +<glossterm>1TBS</glossterm> +<glossdef> +<para role="accidence"> +<phrase role="pronounce"></phrase> +<phrase role="partsofspeach">n</phrase> +</para> +<para>The "One True Brace Style"</para> +<glossseealso>indent style</glossseealso> +</glossdef> +</glossentry> + +<!-- ... --> + +</glossdiv> + +<!-- ... --> + +</glossary> + + + + +Marking Up Glossary Terms + +That takes care of the glossary database, now you have to get the entries +into your document. Unlike bibliography entries, which can be empty, creating +placeholder glossary entries would be very tedious. So instead, +support for glossary.collection relies on implicit linking. + +In your source document, simply use firstterm and +glossterm to identify the terms you wish to have included +in the glossary. The stylesheets assume that you will either set the +baseform attribute correctly, or that the +content of the element exactly matches a term in your glossary. + +If you're using a glossary.collection, don't +make explicit links on the terms in your document. + +So, in your document, you might write things like this: + + +<para>This is dummy text, without any real meaning. +The point is simply to reference glossary terms like <glossterm>0</glossterm> +and the <firstterm baseform="1TBS">One True Brace Style (1TBS)</firstterm>. +The <glossterm>1TBS</glossterm>, as you can probably imagine, is a nearly +religious issue.</para> + + +If you set the firstterm.only.link parameter, +only the terms marked with firstterm will be links. +Otherwise, all the terms will be linked. + + + +Marking Up the Glossary + +The glossary itself has to be identified for the stylesheets. For lack +of a better choice, the role is used. +To identify the glossary as the target for automatic processing, set +the role to auto. The title of this +glossary (and any other information from the glossaryinfo +that's rendered by your stylesheet) will be displayed, but the entries will +come from the database. + + +Unfortunately, the glossary can't be empty, so you must put in +at least one glossentry. The content of this entry +is irrelevant, it will not be rendered: + + +<glossary role="auto"> +<glossentry> +<glossterm>Irrelevant</glossterm> +<glossdef> +<para>If you can see this, the document was processed incorrectly. Use +the <parameter>glossary.collection</parameter> parameter.</para> +</glossdef> +</glossentry> +</glossary> + + +What about glossary divisions? If your glossary database has glossary +divisions and your automatic glossary contains at least +one glossdiv, the automic glossary will have divisions. +If the glossdiv is missing from either location, no divisions +will be rendered. + +Glossary entries (and divisions, if appropriate) in the glossary will +occur in precisely the order they occur in your database. + + + +Formatting the Document + +Finally, when you are ready to format your document, simply set the +glossary.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global glossary. + +The stylesheets will format the glossary in your document as if +all of the entries implicilty referenced appeared there literally. + + +Limitations + +Glossary cross-references within the glossary are +not supported. For example, this will not work: + + +<glossentry> +<glossterm>gloss-1</glossterm> +<glossdef><para>A description that references <glossterm>gloss-2</glossterm>.</para> +<glossseealso>gloss-2</glossseealso> +</glossdef> +</glossentry> + + +If you put glossary cross-references in your glossary that way, +you'll get the cryptic error: Warning: +glossary.collection specified, but there are 0 automatic +glossaries. + +Instead, you must do two things: + + + +Markup your glossary using glossseealso: + + +<glossentry> +<glossterm>gloss-1</glossterm> +<glossdef><para>A description that references <glossterm>gloss-2</glossterm>.</para> +<glossseealso>gloss-2</glossseealso> +</glossdef> +</glossentry> + + + + +Make sure there is at least one glossterm reference to +gloss-2 in your document. The +easiest way to do that is probably within a remark in your +automatic glossary: + + +<glossary role="auto"> +<remark>Make sure there's a reference to <glossterm>gloss-2</glossterm>.</remark> +<glossentry> +<glossterm>Irrelevant</glossterm> +<glossdef> +<para>If you can see this, the document was processed incorrectly. Use +the <parameter>glossary.collection</parameter> parameter.</para> +</glossdef> +</glossentry> +</glossary> + + + + + + + + + + +glossterm.separation +length + +glossterm.separation +Separation between glossary terms and descriptions in list mode + + +Description + +Specifies the separation between glossary terms and descriptions when +glossarys are presented using lists. + + + + + + +glossterm.width +length + +glossterm.width +Width of glossterm in list presentation mode + + +Description + +This parameter specifies the width reserved for glossary terms when +a list presentation is used. + + + + + + +glossary.as.blocks +boolean + +glossary.as.blocks +Present glossarys using blocks instead of lists? + + +Description + +If non-zero, glossarys will be formatted as +blocks. + +If you have long glossterms, proper list +markup in the FO case may produce unattractive lists. By setting this +parameter, you can force the stylesheets to produce block markup +instead of proper lists. + +You can override this setting with a processing instruction as the +child of glossary: dbfo +glossary-presentation="blocks" or dbfo +glossary-presentation="list" + + + + + + +glosslist.as.blocks +boolean + +glosslist.as.blocks +Use blocks for glosslists? + + +Description + +See glossary.as.blocks. + + + + + + +glossentry.show.acronym +list + +glossentry.show.acronym +Display glossentry acronyms? + + +Description + +A setting of yes means they should be displayed; +no means they shouldn't. If primary is used, +then they are shown as the primary text for the entry. + + +This setting controls both acronym and +abbrev elements in the glossentry. + + + + + + + +formal.procedures +boolean + +formal.procedures +Selects formal or informal procedures + + +Description + +Formal procedures are numbered and always have a title. + + + + + + + +formal.title.placement + + +formal.title.placement +Specifies where formal object titles should occur + + +Description + +Specifies where formal object titles should occur. For each formal object +type (figure, +example, +equation, +table, and procedure) +you can specify either the keyword +before or +after. + + + + +figure before +example before +equation before +table before +procedure before +task before + + + +runinhead.default.title.end.punct +string + +runinhead.default.title.end.punct +Default punctuation character on a run-in-head + + +Description + +FIXME: + + + + + + + +runinhead.title.end.punct +string + +runinhead.title.end.punct +Characters that count as punctuation on a run-in-head + + +Description + +FIXME: + + + + + + + +show.comments +boolean + +show.comments +Display comment elements? + + +Description + +If true (non-zero), comments will be displayed, otherwise they are suppressed. +Comments here refers to the comment element, +which will be renamed remark in DocBook V4.0, +not XML comments (<-- like this -->) which are unavailable. + + + + +1 + + +punct.honorific +string + +punct.honorific +Punctuation after an honorific in a personal name. + + +Description + +This parameter specifies the punctuation that should be added after an +honorific in a personal name. + + + + + + +segmentedlist.as.table +boolean + +segmentedlist.as.table +Format segmented lists as tables? + + +Description + +If non-zero, segmentedlists will be formatted as +tables. + + + + + + +variablelist.as.blocks +boolean + +variablelist.as.blocks +Format variablelists lists as blocks? + + +Description + +If non-zero, variablelists will be formatted as +blocks. + +If you have long terms, proper list markup in the FO case may produce +unattractive lists. By setting this parameter, you can force the stylesheets +to produce block markup instead of proper lists. + +You can override this setting with a processing instruction as the +child of variablelist: dbfo +list-presentation="blocks" or dbfo +list-presentation="list". + +When using list-presentation="list", +you can also control the amount of space used for the terms with +the dbfo term-width=".25in" processing instruction, +the termlength attribute on variablelist, +or allow the stylesheets to attempt to calculate the amount of space to leave based on the +number of letters in the longest term. + + + <variablelist> + <?dbfo list-presentation="list"?> + <?dbfo term-width="1.5in"?> + <?dbhtml list-presentation="table"?> + <?dbhtml term-width="1.5in"?> + <varlistentry> + <term>list</term> + <listitem> + <para> + Formatted as a list even if variablelist.as.blocks is set to 1. + </para> + </listitem> + </varlistentry> + </variablelist> + + + + + + + +blockquote.properties +To set the style for block quotations. + + +Description + +The blockquote.properties attribute set specifies +the formating properties of block quotations. + + + + +0.5in +0.5in +0.5em +1em +2em + + + +ulink.show +boolean + +ulink.show +Display URLs after ulinks? + + +Description + +If non-zero, the URL of each ULink will +appear after the text of the link. If the text of the link and the URL +are identical, the URL is suppressed. + + + + + + +ulink.footnotes +boolean + +ulink.footnotes +Generate footnotes for ULinks? + + +Description + +If non-zero, the URL of each ULink will +appear as a footnote. + + + + + + + +ulink.hyphenate +string + +ulink.hyphenate +Allow URLs to be automatically hyphenated + + +Description + +If not empty, the specified character (or more generally, content) is +added to URLs after every character included in the string +in the ulink.hyphenate.chars parameter (default +is /). If the character in this parameter is a +Unicode soft hyphen (0x00AD) or Unicode zero-width space (0x200B), some FO +processors will be able to reasonably hyphenate long URLs. + +As of 28 Jan 2002, discretionary hyphens are more widely and correctly +supported than zero-width spaces for this purpose. + + + + + + +ulink.hyphenate.chars +string + +ulink.hyphenate.chars +List of characters to allow ulink URLs to be automatically hyphenated on + + +Description + +If the ulink.hyphenate is not empty, then +hyphenation of ulinks is turned on, and any +character contained in this parameter is treated as an allowable +hyphenation point. + +The default value is /, but the parameter +could be customized +to contain other URL characters, as for example: + +<xsl:param name="ulink.hyphenate.chars">:/@&?.#</xsl:param> + + + + + + + +shade.verbatim +boolean + +shade.verbatim +Should verbatim environments be shaded? + + +Description + +In the FO stylesheet, if this parameter is non-zero then the +shade.verbatim.style properties will be applied +to verbatim environments. + +In the HTML stylesheet, this parameter is now deprecated. Use +CSS instead. + + + + + + +shade.verbatim.style + + +shade.verbatim.style +Properties that specify the style of shaded verbatim listings + + +Description + +FIXME: + + + + + + #E0E0E0 + + + +hyphenate.verbatim +boolean + +hyphenate.verbatim +Should verbatim environments be hyphenated on space characters? + + +Description + +If the lines of program listing are too long to fit into one +line it is quite common to split them at space and indicite by hook +arrow that code continues on the next line. You can turn on this +behaviour for programlisting, +screen and synopsis elements by +using this parameter. + +Note that you must also enable line wrapping for verbatim environments and +select appropriate hyphenation character (e.g. hook arrow). This can +be done using monospace.verbatim.properties +attribute set: + +<xsl:attribute-set name="monospace.verbatim.properties" + use-attribute-sets="verbatim.properties monospace.properties"> + <xsl:attribute name="wrap-option">wrap</xsl:attribute> + <xsl:attribute name="hyphenation-character">&#x25BA;</xsl:attribute> +</xsl:attribute-set> + +For a list of arrows available in Unicode see and and make sure that +selected character is available in the font you are using for verbatim +environments. + + + + + + +hyphenate.verbatim.characters +string + +hyphenate.verbatim.characters +List of characters after which line break can occur in listings + + +Description + +If you enable hyphenate.verbatim line +breaks are allowed only on space characters. If this is not enough for +your document, you can specify list of additional characters after +which line break is allowed in this parameter. + + + + + + +use.svg +boolean + +use.svg +Allow SVG in the result tree? + + +Description + +If non-zero, SVG will be considered an acceptable image format. SVG +is passed through to the result tree, so correct rendering of the resulting +diagram depends on the formatter (FO processor or web browser) that is used +to process the output from the stylesheet. + + + + + + +use.role.as.xrefstyle +boolean + +use.role.as.xrefstyle +Use role attribute for +xrefstyle on xref? + + +Description + +If non-zero, the role attribute on +xref will be used to select the cross reference style. +The DocBook +Technical Committee recently added an +xrefstyle attribute for this purpose. +If the xrefstyle attribute +is present, role will be ignored, regardless +of this setting. + +Until an official DocBook release that includes the new +attribute, this flag allows role +to serve that purpose. + +Example + +The following small stylesheet shows how to configure the stylesheets to make +use of the cross reference style: + +<?xml version="1.0"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<xsl:import href="../xsl/html/docbook.xsl"/> + +<xsl:output method="html"/> + +<xsl:param name="local.l10n.xml" select="document('')"/> +<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"> + <l:l10n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" language="en"> + <l:context name="xref"> + <l:template name="chapter" style="title" text="Chapter %n, %t"/> + <l:template name="chapter" text="Chapter %n"/> + </l:context> + </l:l10n> +</l:i18n> + +</xsl:stylesheet> + +With this stylesheet, the cross references in the following document: + +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> +<book id="book"><title>Book</title> + +<preface> +<title>Preface</title> + +<para>Normal: <xref linkend="ch1"/>.</para> +<para>Title: <xref xrefstyle="title" linkend="ch1"/>.</para> + +</preface> + +<chapter id="ch1"> +<title>First Chapter</title> + +<para>Irrelevant.</para> + +</chapter> +</book> + +will appear as: + + +Normal: Chapter 1. +Title: Chapter 1, First Chapter. + + + + + + +menuchoice.separator + + +menuchoice.separator +Separator between items of a menuchoice +other than guimenuitem and +guisubmenu + + +Description + +Separator used to connect items of a menuchoice other +than guimenuitem and guisubmenu. The latter +elements are linked with menuchoice.menu.separator. + + + + + + + +menuchoice.menu.separator + + +menuchoice.menu.separator +Separator between items of a menuchoice +with guimenuitem or +guisubmenu + + +Description + +Separator used to connect items of a menuchoice with +guimenuitem or guisubmenu. Other elements +are linked with menuchoice.separator. + +The default value is &#x2192;, which is the +&rarr; (right arrow) character entity. +The current FOP (0.20.5) requires setting the font-family +explicitly. + +The default value also includes spaces around the arrow, +which will allow a line to break. Replace the spaces with +&#xA0; (nonbreaking space) if you don't want those +spaces to break. + + + + + → + + +default.float.class +string + +default.float.class +Specifies the default float class + + +Description + +FIXME: + + + + + + left + before + + + + +footnote.number.format +string + +footnote.number.format +Identifies the format used for footnote numbers + + +Description + +The footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A). + + + + + + +table.footnote.number.format +string + +table.footnote.number.format +Identifies the format used for footnote numbers in tables + + +Description + +The table.footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A) in tables. + + + + + + +footnote.number.symbols + + +footnote.number.symbols +Special characters to use as footnote markers + + +Description + +If footnote.number.symbols is not the empty string, +footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + + + + +table.footnote.number.symbols + + +table.footnote.number.symbols +Special characters to use a footnote markers in tables + + +Description + +If table.footnote.number.symbols is not the empty string, +table footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +table.footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + + + + +footnote.properties +Properties applied to each footnote body + + + +Description + +This attribute set is applied to the footnote-block +for each footnote. +It can be used to set the +font-size, font-family, and other inheritable properties that will be +applied to all footnotes. + + + + + + + normal + normal + + 0pt + 0pt + + + +table.footnote.properties +Properties applied to each table footnote body + + + +Description + +This attribute set is applied to the footnote-block +for each table footnote. +It can be used to set the +font-size, font-family, and other inheritable properties that will be +applied to all table footnotes. + + + + + + + normal + normal + 2pt + + + + +footnote.mark.properties +Properties applied to each footnote mark + + + +Description + +This attribute set is applied to the footnote mark used +for each footnote. +It should contain only inline properties. + + +The property to make the mark a superscript is contained in the +footnote template itself, because the current version of FOP reports +an error if baseline-shift is used. + + + + + + 75% + normal + normal + + + +footnote.sep.leader.properties +Properties associated with a procedure + + +Description + +The styling for the rule line that separates the +footnotes from the body text. +These are properties applied to the fo:leader used as +the separator. + +If you want to do more than just set properties on +the leader element, then you can customize the template +named footnote.separator in +fo/pagesetup.xsl. + + + + + black + rule + 1in + + + +xref.with.number.and.title +boolean + +xref.with.number.and.title +Use number and title in cross references + + +Description + +FIXME: + + + + + + +superscript.properties + + +superscript.properties +Properties associated with superscripts + + +Description + +Specifies styling properties for superscripts. + + + + + 75% + + + +subscript.properties + + +subscript.properties +Properties associated with subscripts + + +Description + +Specifies styling properties for subscripts. + + + + + 75% + + + +pgwide.properties +Properties to make a figure or table page wide. + + + +Description + +This attribute set is used to set the properties +that make a figure or table "page wide" in fo output. +It comes into effect when an attribute pgwide="1" +is used. + + + +By default, it sets start-indent +to 0pt. +In a stylesheet that sets the parameter +body.start.indent +to a non-zero value in order to indent body text, +this attribute set can be used to outdent pgwide +figures to the left margin. + + +If a document uses a multi-column page layout, +then this attribute set could try setting span +to a value of all. However, this may +not work with some processors because a span property must be on an +fo:block that is a direct child of fo:flow. It may work in +some processors anyway. + + + + + + 0pt + + + +graphic.default.extension +string + +graphic.default.extension +Default extension for graphic filenames + + +Description + +If a graphic or mediaobject +includes a reference to a filename that does not include an extension, +and the format attribute is +unspecified, the default extension will be used. + + + + + + + +default.image.width +length + +default.image.width +The default width of images + + +Description + +If specified, this value will be used for the +width attribute on +images that do not specify any +viewport +dimensions. + + + + + + +preferred.mediaobject.role + +preferred.mediaobject.role +Select which mediaobject to use based on +this value of an object's role attribute. + + + +Description + +A mediaobject may contain several objects such as imageobjects. +If the parameter use.role.for.mediaobject +is non-zero, then the role attribute on +imageobjects and other objects within a mediaobject container will be used to select which object will be +used. If one of the objects has a role value that matches the +preferred.mediaobject.role parameter, then it has first +priority for selection. If more than one has such a +role value, the first one is used. + + +See the use.role.for.mediaobject parameter +for the sequence of selection. + + + + + +use.role.for.mediaobject +boolean + +use.role.for.mediaobject +Use role attribute +value for selecting which of several objects within a mediaobject to use. + + + +Description + +If non-zero, the role attribute on +imageobjects or other objects within a mediaobject container will be used to select which object will be +used. + + +The order of selection when then parameter is non-zero is: + + + + If the stylesheet parameter preferred.mediaobject.role has a value, then the object whose role equals that value is selected. + + +Else if an object's role attribute has a value of +html for HTML processing or +fo for FO output, then the first +of such objects is selected. + + + +Else the first suitable object is selected. + + + +If the value of +use.role.for.mediaobject +is zero, then role attributes are not considered +and the first suitable object +with or without a role value is used. + + + + + + +ignore.image.scaling +boolean + +ignore.image.scaling +Tell the stylesheets to ignore the author's image scaling attributes + + +Description + +If non-zero, the scaling attributes on graphics and media objects are +ignored. + + + + + + +img.src.path +string + +img.src.path +Path to HTML image files + + +Description + +Add a path prefix to each HTML +img or FO +fo:external-graphics element's +src attribute. +This path could relative to the directory where the HTML/FO +files are created, or it could be an absolute URI. +The default value is empty. +Be sure to include a trailing slash if needed. + +This prefix is not applied to any filerefs that start +with "/" or contain "//:". + + + + + + + +keep.relative.image.uris +boolean + +keep.relative.image.uris +Should image URIs be resolved against xml:base? + + +Description + +If non-zeor, relative URIs (in, for example fileref attributes) will +be used in the generated output. Otherwise, the URIs will be made absolute +with respect to the base URI. + +Note that the stylesheets calculate (and use) the absolute form +for some purposes, this only applies to the resulting output. + + + + + + + +page.height + + +page.height +The height of the physical page + + +Description + +The page height is generally calculated from the +paper.type and +page.orientation. + + + + + + + + + + + + + + + + +page.height.portrait + + +page.height.portrait +Specify the physical size of the long edge of the page + + +Description + +The portrait page height is the length of the long +edge of the physical page. + + + + + + + 210mm + 11in + 8.5in + 2378mm + 1682mm + 1189mm + 841mm + 594mm + 420mm + 297mm + 210mm + 148mm + 105mm + 74mm + 52mm + 37mm + 1414mm + 1000mm + 707mm + 500mm + 353mm + 250mm + 176mm + 125mm + 88mm + 62mm + 44mm + 1297mm + 917mm + 648mm + 458mm + 324mm + 229mm + 162mm + 114mm + 81mm + 57mm + 40mm + 11in + + + + +page.margin.bottom + + +page.margin.bottom +The bottom margin of the page + + +Description + +The bottom page margin is the distance from the bottom of the region-after +to the physical bottom of the page. + + + + + + + +page.margin.inner + + +page.margin.inner +The inner page margin + + +Description + +The inner page margin is the distance from binding edge of the +page to the first column of text. In the left-to-right, top-to-bottom writing +direction, this is the left margin of recto pages. +The inner and outer margins are usually the same unless the output +is double-sided. + + + + + + + 1.25in + 1in + + + + +page.margin.outer + + +page.margin.outer +The outer page margin + + +Description + +The outer page margin is the distance from non-binding edge of the +page to the last column of text. In the left-to-right, top-to-bottom writing +direction, this is the right margin of recto pages. +The inner and outer margins are usually the same unless the output +is double-sided. + + + + + + + 0.75in + 1in + + + + +page.margin.top + + +page.margin.top +The top margin of the page + + +Description + +The top page margin is the distance from the physical top of the +page to the top of the region-before. + + + + + + +page.orientation + + +page.orientation +Select the page orientation + + +Description + +In portrait orientation, the short edge is horizontal; in +landscape orientation, it is vertical. + + + + + + + +page.width + + +page.width +The width of the physical page + + +Description + +The page width is generally calculated from the +paper.type and page.orientation. + + + + + + + + + + + + + + + + +page.width.portrait + + +page.width.portrait +Specify the physical size of the short edge of the page + + +Description + +The portrait page width is the length of the short +edge of the physical page. + + + + + + + 8.5in + 1682mm + 1189mm + 841mm + 594mm + 420mm + 297mm + 210mm + 148mm + 105mm + 74mm + 52mm + 37mm + 26mm + 1000mm + 707mm + 500mm + 353mm + 250mm + 176mm + 125mm + 88mm + 62mm + 44mm + 31mm + 917mm + 648mm + 458mm + 324mm + 229mm + 162mm + 114mm + 81mm + 57mm + 40mm + 28mm + 8.5in + + + + +paper.type + + +paper.type +Select the paper type + + +Description + +The paper type is a convenient way to specify the paper size. +The list of known paper sizes includes USletter and most of the A, +B, and C sizes. See page.width.portrait, for example. + + + + + + + +double.sided + + +double.sided +Is the document to be printed double sided? + + +Description + +Double-sided documents are printed with a slightly wider margin +on the binding edge of the page. + +FIXME: The current set of parameters does not take writing direction +into account. + + + + + + +body.margin.bottom + + +body.margin.bottom +The bottom margin of the body text + + +Description + +The body bottom margin is the distance from the last line of text +in the page body to the bottom of the region-after. + + + + + + + +body.margin.top + + +body.margin.top +To specify the size of the top margin of a page + + +Description + +The body top margin is the distance from the top of the region-before +to the first line of text in the page body. + + + + + + + +body.start.indent + + +body.start.indent +The start-indent for the body text + + +Description + +This parameter provides +one means of indenting the body text relative to +the left page margin. +It is used in place of the +title.margin.left for +all XSL-FO processors except FOP. +It enables support for side floats to appear +in the indented margin area. + +This start-indent property is added to the fo:flow +for certain page sequences. Which page-sequences it is +applied to is determined by the template named +set.flow.properties. +By default, that template adds it to the flow +for page-sequences using the body +master-reference, as well as appendixes and prefaces. + +If this parameter is used, section titles should have +a start-indent value of 0pt if they are to be +outdented relative to the body text. + + +If you are using FOP, then set this parameter to a zero +width value and set the title.margin.left +parameter to the negative value of the desired indent. + + +See also body.end.indent and +title.margin.left. + + + + + + + 0pt + 0pt + 4pc + + + + +body.end.indent + + +body.end.indent +The end-indent for the body text + + +Description + +This end-indent property is added to the fo:flow +for certain page sequences. Which page-sequences it is +applied to is determined by the template named +set.flow.properties. +By default, that template adds it to the flow +for page-sequences using the body +master-reference, as well as appendixes and prefaces. + + +See also body.start.indent. + + + + + + + +alignment + + +alignment +Specify the default text alignment + + +Description + +The default text alignment is used for most body text. + + + + +justify + + +hyphenate + + +hyphenate +Specify hyphenation behavior + + +Description + +If true, words may be hyphenated. Otherwise, they may not. + + + + +true + + +line-height +string + +line-height +Specify the line-height property + + +Description + +Sets the line-height property. + + + + + + +column.count.back +integer + +column.count.back +Number of columns on back matter pages + + +Description + +Number of columns on back matter (appendix, glossary, etc.) pages. + + + + + + +column.count.body +integer + +column.count.body +Number of columns on body pages + + +Description + +Number of columns on body pages. + + + + + + +column.count.front +integer + +column.count.front +Number of columns on front matter pages + + +Description + +Number of columns on front matter (dedication, preface, etc.) pages. + + + + + + +column.count.index +integer + +column.count.index +Number of columns on index pages + + +Description + +Number of columns on index pages. + + + + + + +column.count.lot +integer + +column.count.lot +Number of columns on a 'List-of-Titles' page + + +Description + +Number of columns on a page sequence containing the Table of Contents, +List of Figures, etc. + + + + + + +column.count.titlepage +integer + +column.count.titlepage +Number of columns on a title page + + +Description + +Number of columns on a title page + + + + + + +column.gap.back +length + +column.gap.back +Gap between columns in back matter + + +Description + +Specifies the gap between columns in back matter (if +column.count.back is greater than one). + + + + + + +column.gap.body +length + +column.gap.body +Gap between columns in the body + + +Description + +Specifies the gap between columns in body matter (if +column.count.body is greater than one). + + + + + + +column.gap.front +length + +column.gap.front +Gap between columns in the front matter + + +Description + +Specifies the gap between columns in front matter (if +column.count.front is greater than one). + + + + + + +column.gap.index +length + +column.gap.index +Gap between columns in the index + + +Description + +Specifies the gap between columns in indexes (if +column.count.index is greater than one). + + + + + + +column.gap.lot +length + +column.gap.lot +Gap between columns on a 'List-of-Titles' page + + +Description + +Specifies the gap between columns on 'List-of-Titles' pages (if +column.count.lot is greater than one). + + + + + + +column.gap.titlepage +length + +column.gap.titlepage +Gap between columns on title pages + + +Description + +Specifies the gap between columns on title pages (if +column.count.titlepage is greater than one). + + + + + + + +region.after.extent + + +region.after.extent +Specifies the height of the footer. + + +Description + +The region after extent is the height of the area where footers +are printed. + + + + + + + +region.before.extent + + +region.before.extent +Specifies the height of the header + + +Description + +The region before extent is the height of the area where headers +are printed. + + + + + + + +default.units +list +cm +mm +in +pt +pc +px +em + +default.units +Default units for an unqualified dimension + + +Description + +If an unqualified dimension is encountered (for example, in a +graphic width), the default-units will be used for the +units. Unqualified dimensions are not allowed in XSL Formatting Objects. + + + + + + + +normal.para.spacing +What space do you want between normal paragraphs + + +Description +Specify the spacing required between normal paragraphs + + + + 1em + 0.8em + 1.2em + + + +body.font.master + + +body.font.master +Specifies the default point size for body text + + +Description + +The body font size is specified in two parameters +(body.font.master and body.font.size) +so that math can be performed on the font size by XSLT. + + + + +10 + + +body.font.size + + +body.font.size +Specifies the default font size for body text + + +Description + +The body font size is specified in two parameters +(body.font.master and body.font.size) +so that math can be performed on the font size by XSLT. + + + + + + pt + + + +footnote.font.size + + +footnote.font.size +The font size for footnotes + + +Description + +The footnote font size is used for...footnotes! + + + + + + pt + + + +title.margin.left + + +title.margin.left +Adjust the left margin for titles + + +Description + +This parameter provides +one means of adjusting the left margin for titles. +The left margin of the body region +is calculated to include this space, +and titles are outdented to the left by this amount, +effectively leaving titles at the left margin +and the body text indented. +Currently this method is only used for FOP because +it cannot properly use the body.start.indent +parameter. +the relative + + +The default value for FOP is -4pc, which means the +body text is indented 4 picas relative to +the titles. +The default value for other processors is 0pt, and +the body indent is provided by the body.start.indent +parameter. + + +If you set the value to zero, be sure to still include +a unit indicator such as 0pt, or +the FO processor will report errors. + + +This parameter must be set to 0pt if the +passivetex.extensions +parameter is nonzero because PassiveTeX cannot handle +the math expression with negative values +used to calculate the indents. + + + + + + + -4pc + 0pt + 0pt + + + + +draft.mode +list + +draft.mode +Select draft mode + + +Description + +Selects draft mode. If draft.mode is +yes, the entire document will be treated +as a draft. If it is no, the entire document +will be treated as a final copy. If it is maybe, +individual sections will be treated as draft or final independently, depending +on how their status attribute is set. + + + + + + + +draft.watermark.image +uri + +draft.watermark.image +The URI of the image to be used for draft watermarks + + +Description + +The image to be used for draft watermarks. + + + + + + +headers.on.blank.pages +boolean + +headers.on.blank.pages +Put headers on blank pages? + + +Description + +If non-zero, headers will be placed on blank pages. + + + + + + +footers.on.blank.pages +boolean + +footers.on.blank.pages +Put footers on blank pages? + + +Description + +If non-zero, footers will be placed on blank pages. + + + + + + +header.rule +boolean + +header.rule +Rule under headers? + + +Description + +If non-zero, a rule will be drawn below the page headers. + + + + + + +footer.rule +boolean + +footer.rule +Rule over footers? + + +Description + +If non-zero, a rule will be drawn above the page footers. + + + + + + +header.column.widths +string + +header.column.widths +Specify relative widths of header areas +Description + +Page headers in print output use a three column table +to position text at the left, center, and right side of +the header on the page. +This parameter lets you specify the relative sizes of the +three columns. The default value is +"1 1 1". + +The parameter value must be three numbers, separated +by white space. The first number represents the relative +width of the left header for +single-sided output, or the inside header for +double-sided output. The second number is the relative +width of the center header. The third number is the +relative width of the right header for +single-sided output, or the outside header for +double-sided output. + + +The numbers are used to specify the column widths +for the table that makes up the header area. +In the FO output, this looks like: + + + +<fo:table-column column-number="1" + column-width="proportional-column-width(1)"/> + + + +The proportional-column-width() +function computes a column width by dividing its +argument by the total of the arguments for all the columns, and +then multiplying the result by the width of the whole table +(assuming all the column specs use the function). +Its argument can be any positive integer or floating point number. +Zero is an acceptable value, although some FO processors +may warn about it, in which case using a very small number might +be more satisfactory. + + +For example, the value "1 2 1" means the center +header should have twice the width of the other areas. +A value of "0 0 1" means the entire header area +is reserved for the right (or outside) header text. +Note that to keep the center area centered on +the page, the left and right values must be +the same. A specification like "1 2 3" means the +center area is no longer centered on the page +since the right area is three times the width of the left area. + + + + + + + +footer.column.widths +string + +footer.column.widths +Specify relative widths of footer areas +Description + +Page footers in print output use a three column table +to position text at the left, center, and right side of +the footer on the page. +This parameter lets you specify the relative sizes of the +three columns. The default value is +"1 1 1". + +The parameter value must be three numbers, separated +by white space. The first number represents the relative +width of the left footer for +single-sided output, or the inside footer for +double-sided output. The second number is the relative +width of the center footer. The third number is the +relative width of the right footer for +single-sided output, or the outside footer for +double-sided output. + + +The numbers are used to specify the column widths +for the table that makes up the footer area. +In the FO output, this looks like: + + + +<fo:table-column column-number="1" + column-width="proportional-column-width(1)"/> + + + +The proportional-column-width() +function computes a column width by dividing its +argument by the total of the arguments for all the columns, and +then multiplying the result by the width of the whole table +(assuming all the column specs use the function). +Its argument can be any positive integer or floating point number. +Zero is an acceptable value, although some FO processors +may warn about it, in which case using a very small number might +be more satisfactory. + + +For example, the value "1 2 1" means the center +footer should have twice the width of the other areas. +A value of "0 0 1" means the entire footer area +is reserved for the right (or outside) footer text. +Note that to keep the center area centered on +the page, the left and right values must be +the same. A specification like "1 2 3" means the +center area is no longer centered on the page +since the right area is three times the width of the left area. + + + + + + + +header.table.height +string + +header.table.height +Specify the minimum height of the table containing the running page headers +Description + +Page headers in print output use a three column table +to position text at the left, center, and right side of +the header on the page. +This parameter lets you specify the minimum height +of the single row in the table. +Since this specifies only the minimum height, +the table should automatically grow to fit taller content. +The default value is "14pt". + + + + + + +footer.table.height +string + +footer.table.height +Specify the minimum height of the table containing the running page footers +Description + +Page footers in print output use a three column table +to position text at the left, center, and right side of +the footer on the page. +This parameter lets you specify the minimum height +of the single row in the table. +Since this specifies only the minimum height, +the table should automatically grow to fit taller content. +The default value is "14pt". + + + + + + +header.content.properties + + +header.content.properties + + + +Description + +Properties of page header content. + + + + + + + + + + + + + +footer.content.properties + + +footer.content.properties + + + +Description + +Properties of page footer content. + + + + + + + + + + + + + +marker.section.level +integer + +marker.section.level +Control depth of sections shown in running headers or footers + + +Description + +The marker.section.level parameter +controls the depth of section levels that may be displayed +in running headers and footers. For example, if the value +is 2 (the default), then titles from sect1 and +sect2 or equivalent section +elements are candidates for use in running headers and +footers. + +Each candidate title is marked in the FO output with a +<fo:marker marker-class-name="section.head.marker"> +element. + +In order for such titles to appear in headers +or footers, the header.content +or footer.content template +must be customized to retrieve the marker using +an output element such as: + + +<fo:retrieve-marker retrieve-class-name="section.head.marker" + retrieve-position="first-including-carryover" + retrieve-boundary="page-sequence"/> + + + + + + + + +body.font.family + + +body.font.family +The default font family for body text + + +Description + +The body font family is the default font used for text in the page body. + + + + + + + +dingbat.font.family + + +dingbat.font.family +The font family for copyright, quotes, and other symbols + + +Description + +The dingbat font family is used for dingbats. If it is defined +as the empty string, no font change is effected around dingbats. + + + + + + + +monospace.font.family + + +monospace.font.family +The default font family for monospace environments + + +Description + +The monospace font family is used for verbatim environments +(program listings, screens, etc.). + + + + + + + +sans.font.family + + +sans.font.family +The default sans-serif font family + + +Description + +The default sans-serif font family. At the present, this isn't +actually used by the stylesheets. + + + + + + + +title.font.family + + +title.font.family +The default font family for titles + + +Description + +The title font family is used for titles (chapter, section, figure, +etc.) + + + + + + + +symbol.font.family + + +symbol.font.family +The font families to be searched for symbols outside + of the body font + + +Description + +A typical body or title font does not contain all +the character glyphs that DocBook supports. This parameter +specifies additional fonts that should be searched for +special characters not in the normal font. +These symbol font names are automatically appended +to the body or title font family name when fonts +are specified in a +font-family +property in the FO output. + +The symbol font names should be entered as a +comma-separated list. The default value is +Symbol,ZapfDingbats. + + + + + + + +formal.object.properties +Properties associated with a formal object such as a figure, or other component that has a title + + +Description + +The styling for formal objects in docbook. Specify the spacing +before and after the object. + + + + + 0.5em + 1em + 2em + 0.5em + 1em + 2em + always + + + +formal.title.properties +Style the title element of formal object such as a figure. + + +Description +Specify how the title should be styled. Specify the font size and weight of the title of the formal object. + + + + bold + + + pt + + false + 0.4em + 0.6em + 0.8em + + + +informal.object.properties +Properties associated with a formal object such as a figure, or other component that has a title + + +Description +The styling for informal objects in docbook. Specify the spacing before and after the object. + + + + 0.5em + 1em + 2em + 0.5em + 1em + 2em + + + +monospace.properties +attribute set + +monospace.properties +Properties of monospaced content + + +Description + +Specifies the font name for monospaced output. This property set +used to set the font-size as well, but that doesn't work very well +when different fonts are used (as they are in titles and paragraphs, +for example). + +If you want to set the font-size in a customization layer, it's +probably going to be more appropriate to set font-size-adjust, if your +formatter supports it. + + + + + + + + + + +verbatim.properties +Properties associated with verbatim text + + +Description +This attribute set is used on all verbatim environments. + + + + 0.8em + 1em + 1.2em + 0.8em + 1em + 1.2em + false + + + +monospace.verbatim.properties +What font and size do you want for monospaced content? + + +Description +Specify the font name and size you want for monospaced output + + + + start + no-wrap + + + +sidebar.properties +attribute set + +sidebar.properties +Attribute set for sidebar properties + + +Description + +The styling for sidebars. + + + + + solid + 1pt + black + #DDDDDD + 12pt + 12pt + 6pt + 6pt + 0pt + 0pt + + + + +sidebar.title.properties +attribute set + +sidebar.title.properties +Attribute set for sidebar titles + + +Description + +The styling for sidebars titles. + + + + + bold + false + start + always + + + +sidebar.float.type +list + +sidebar.float.type +Select type of float for sidebar elements + + +Description + +Selects the type of float for sidebar elements. + + + +If sidebar.float.type is +none, then +no float is used. + + + +If sidebar.float.type is +before, then +the float appears at the top of the page. On some processors, +that may be the next page rather than the current page. + + + +If sidebar.float.type is +left or +start, then +a left side float is used. + + + +If sidebar.float.type is +right or +end, then +a right side float is used. + + + +If your XSL-FO processor supports floats positioned on the +inside or +outside +of double-sided pages, then you have those two +options for side floats as well. + + + + + + + + + +sidebar.float.width + +sidebar.float.width +Set the default width for sidebars + + +Description + +Sets the default width for sidebars when used as a side float. +The width determines the degree to which the sidebar block intrudes into +the text area. + +If sidebar.float.type is +before or +none, then +this parameter is ignored. + + + + + + + +margin.note.properties +attribute set + +margin.note.properties +Attribute set for margin.note properties + + +Description + +The styling for margin notes. +By default, margin notes are not implemented for any +element. A stylesheet customization is needed to make +use of this attribute-set. + +You can use a template named floater +to create the customization. +That template can create side floats by specifying the +content and characteristics as template parameters. + + +For example: +<xsl:template match="para[@role='marginnote']"> + <xsl:call-template name="floater"> + <xsl:with-param name="position"> + <xsl:value-of select="$margin.note.float.type"/> + </xsl:with-param> + <xsl:with-param name="width"> + <xsl:value-of select="$margin.note.width"/> + </xsl:with-param> + <xsl:with-param name="content"> + <xsl:apply-imports/> + </xsl:with-param> + </xsl:call-template> +</xsl:template> + + + + + 90% + start + + + +margin.note.title.properties +attribute set + +margin.note.title.properties +Attribute set for margin note titles + + +Description + +The styling for margin note titles. + + + + + bold + false + start + always + + + +margin.note.float.type +list + +margin.note.float.type +Select type of float for margin note customizations + + +Description + +Selects the type of float for margin notes. +DocBook does not define a margin note element, so this +feature must be implemented as a customization of the stylesheet. +See margin.note.properties for +an example. + + + +If margin.note.float.type is +none, then +no float is used. + + + +If margin.note.float.type is +before, then +the float appears at the top of the page. On some processors, +that may be the next page rather than the current page. + + + +If margin.note.float.type is +left or +start, then +a left side float is used. + + + +If margin.note.float.type is +right or +end, then +a right side float is used. + + + +If your XSL-FO processor supports floats positioned on the +inside or +outside +of double-sided pages, then you have those two +options for side floats as well. + + + + + + + + + +margin.note.width + +margin.note.width +Set the default width for margin notes + + +Description + +Sets the default width for margin notes when used as a side float. +The width determines the degree to which the margin note block intrudes into +the text area. + +If margin.note.float.type is +before or +none, then +this parameter is ignored. + + + + + + + +component.title.properties +attribute set + +component.title.properties +Properties for component titles + + +Description + +The properties common to all component titles. + + + + + always + + + + false + + + center + left + + + + + + +section.title.properties +attribute set + +section.title.properties +Properties for section titles + + +Description + +The properties common to all section titles. + + + + + + + + bold + + always + 0.8em + 1.0em + 1.2em + left + + + + +section.title.level1.properties +attribute set + +section.title.level1.properties +Properties for level-1 section titles + + +Description + +The properties of level-1 section titles. + + + + + + + pt + + + + +section.title.level2.properties +attribute set + +section.title.level2.properties +Properties for level-1 section titles + + +Description + +The properties of level-2 section titles. + + + + + + + pt + + + + +section.title.level3.properties +attribute set + +section.title.level3.properties +Properties for level-1 section titles + + +Description + +The properties of level-3 section titles. + + + + + + + pt + + + + +section.title.level4.properties +attribute set + +section.title.level4.properties +Properties for level-1 section titles + + +Description + +The properties of level-4 section titles. + + + + + + + pt + + + + +section.title.level5.properties +attribute set + +section.title.level5.properties +Properties for level-1 section titles + + +Description + +The properties of level-5 section titles. + + + + + + + pt + + + + +section.title.level6.properties +attribute set + +section.title.level6.properties +Properties for level-1 section titles + + +Description + +The properties of level-6 section titles. This property set is actually +used for all titles below level 5. + + + + + + + pt + + + + +section.properties +attribute set + +section.properties +Properties for all section levels + + +Description + +The properties that apply to the containing +block of all section levels, and therefore apply to +the whole section. +This attribute set is inherited by the +more specific attribute sets such as +section.level1.properties. +The default is empty. + + + + + + + + +section.level1.properties +attribute set + +section.level1.properties +Properties for level-1 sections + + +Description + +The properties that apply to the containing +block of a level-1 section, and therefore apply to +the whole section. This includes sect1 +elements and section elements at level 1. + + +For example, you could start each level-1 section on +a new page by using: +<xsl:attribute-set name="section.level1.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + + +section.level2.properties +attribute set + +section.level2.properties +Properties for level-2 sections + + +Description + +The properties that apply to the containing +block of a level-2 section, and therefore apply to +the whole section. This includes sect2 +elements and section elements at level 2. + + +For example, you could start each level-2 section on +a new page by using: +<xsl:attribute-set name="section.level2.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + + +section.level3.properties +attribute set + +section.level3.properties +Properties for level-3 sections + + +Description + +The properties that apply to the containing +block of a level-3 section, and therefore apply to +the whole section. This includes sect3 +elements and section elements at level 3. + + +For example, you could start each level-3 section on +a new page by using: +<xsl:attribute-set name="section.level3.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + + +section.level4.properties +attribute set + +section.level4.properties +Properties for level-4 sections + + +Description + +The properties that apply to the containing +block of a level-4 section, and therefore apply to +the whole section. This includes sect4 +elements and section elements at level 4. + + +For example, you could start each level-4 section on +a new page by using: +<xsl:attribute-set name="section.level4.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + + +section.level5.properties +attribute set + +section.level5.properties +Properties for level-5 sections + + +Description + +The properties that apply to the containing +block of a level-5 section, and therefore apply to +the whole section. This includes sect5 +elements and section elements at level 5. + + +For example, you could start each level-5 section on +a new page by using: +<xsl:attribute-set name="section.level5.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + + +section.level6.properties +attribute set + +section.level6.properties +Properties for level-6 sections + + +Description + +The properties that apply to the containing +block of a level 6 or lower section, and therefore apply to +the whole section. This includes +section elements at level 6 and lower. + + +For example, you could start each level-6 section on +a new page by using: +<xsl:attribute-set name="section.level6.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + + + + + +figure.properties +Properties associated with a figure + + +Description + +The styling for figures. + + + + + + +example.properties +Properties associated with a example + + +Description + +The styling for examples. + + + + + + +equation.properties +Properties associated with a equation + + +Description + +The styling for equations. + + + + + + +table.properties +Properties associated with the block surrounding a table + + +Description + +Block styling properties for tables. This parameter should really +have been called table.block.properties or something +like that, but we’re leaving it to avoid backwards-compatibility +problems. + +See also table.table.properties. + + + + + + +informalfigure.properties +Properties associated with an informalfigure + + +Description + +The styling for informalfigures. + + + + + + +informalexample.properties +Properties associated with an informalexample + + +Description + +The styling for informalexamples. + + + + + + +informalequation.properties +Properties associated with a informalequation + + +Description + +The styling for informalequations. + + + + + + +informaltable.properties +Properties associated with the block surrounding an informaltable + + +Description + +Block styling properties for informaltables. This parameter should really +have been called informaltable.block.properties or something +like that, but we’re leaving it to avoid backwards-compatibility +problems. + +See also table.table.properties. + + + + + + +procedure.properties +Properties associated with a procedure + + +Description + +The styling for procedures. + + + + + + +root.properties +attribute set + +root.properties +The properties of the fo:root element + + +Description + +This property set is used on the fo:root element of +an FO file. It defines a set of default, global parameters. + + + + + + + + + + + + + + + + + character-by-character + disregard-shifts + + + +qanda.title.properties +attribute set + +qanda.title.properties +Properties for qanda set titles + + +Description + +The properties common to all qanda set titles. + + + + + + + + bold + + always + 0.8em + 1.0em + 1.2em + + + +qanda.title.level1.properties +attribute set + +qanda.title.level1.properties +Properties for level-1 qanda set titles + + +Description + +The properties of level-1 qanda set titles. + + + + + + + pt + + + + +qanda.title.level2.properties +attribute set + +qanda.title.level2.properties +Properties for level-2 qanda set titles + + +Description + +The properties of level-2 qanda set titles. + + + + + + + pt + + + + +qanda.title.level3.properties +attribute set + +qanda.title.level3.properties +Properties for level-3 qanda set titles + + +Description + +The properties of level-3 qanda set titles. + + + + + + + pt + + + + +qanda.title.level4.properties +attribute set + +qanda.title.level4.properties +Properties for level-4 qanda set titles + + +Description + +The properties of level-4 qanda set titles. + + + + + + + pt + + + + +qanda.title.level5.properties +attribute set + +qanda.title.level5.properties +Properties for level-5 qanda set titles + + +Description + +The properties of level-5 qanda set titles. + + + + + + + pt + + + + +qanda.title.level6.properties +attribute set + +qanda.title.level6.properties +Properties for level-6 qanda set titles + + +Description + +The properties of level-6 qanda set titles. +This property set is actually +used for all titles below level 5. + + + + + + + pt + + + + +article.appendix.title.properties +attribute set + +article.appendix.title.properties +Properties for appendix titles that appear in an article + + +Description + +The properties for the title of an appendix that +appears inside an article. The default is to use +the properties of sect1 titles. + + + + + + + + + + +abstract.properties +Properties associated with the block surrounding an abstract + + +Description + +Block styling properties for abstract. + +See also abstract.title.properties. + + + + + 0.0in + 0.0in + + + +abstract.title.properties +attribute set + +abstract.title.properties +Properties for abstract titles + + +Description + +The properties for abstract titles. + +See also abstract.properties. + + + + + + bold + always + always + + + + false + center + + + +revhistory.table.properties +attribute set + +revhistory.table.properties +The properties of table used for formatting revhistory + + +Description + +This property set defines appearance of revhistory table. + + + + + + + +revhistory.table.cell.properties +attribute set + +revhistory.table.cell.properties +The properties of table cells used for formatting revhistory + + +Description + +This property set defines appearance of individual cells in revhistory table. + + + + + + + +revhistory.title.properties +attribute set + +revhistory.title.properties +The properties of revhistory title + + +Description + +This property set defines appearance of revhistory title. + + + + + + + +profile.arch +string + +profile.arch +Target profile for arch +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.condition +string + +profile.condition +Target profile for condition +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.conformance +string + +profile.conformance +Target profile for conformance +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.lang +string + +profile.lang +Target profile for lang +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.os +string + +profile.os +Target profile for os +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.revision +string + +profile.revision +Target profile for revision +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.revisionflag +string + +profile.revisionflag +Target profile for revisionflag +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.role +string + +profile.role +Target profile for role +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + +Note that role is often +used for other purposes than profiling. For example it is commonly +used to get emphasize in bold font: + +<emphasis role="bold">very important</emphasis> + +If you are using role for +these purposes do not forget to add values like bold to +value of this parameter. If you forgot you will get document with +small pieces missing which are very hard to track. + +For this reason it is not recommended to use role attribute for profiling. You should +rather use profiling specific attributes like userlevel, os, arch, condition, etc. + + + + + + + +profile.security +string + +profile.security +Target profile for security +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.userlevel +string + +profile.userlevel +Target profile for userlevel +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.vendor +string + +profile.vendor +Target profile for vendor +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.attribute +string + +profile.attribute +Name of user-specified profiling attribute + + +Description + +This parameter is used in conjuction with profile.value. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.value +string + +profile.value +Target profile for user-specified attribute + + +Description + +When you are using this parameter you must also specify name of +profiling attribute with parameter profile.attribute. + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.separator +string + +profile.separator +Separator character for compound profile values + + +Description + +Separator character for compound profile values. + + + + + + +l10n.gentext.language +string + +l10n.gentext.language +Sets the gentext language + + +Description + +If this parameter is set to any value other than the empty string, its +value will be used as the value for the language when generating text. Setting +l10n.gentext.language overrides any settings within the +document being formatted. + +It's much more likely that you might want to set the +l10n.gentext.default.language parameter. + + + + + + +l10n.gentext.default.language +string + +l10n.gentext.default.language +Sets the default language for generated text + + +Description + +The value of the l10n.gentext.default.language +parameter is used as the language for generated text if no setting is provided +in the source document. + + + + + + +l10n.gentext.use.xref.language +boolean + +l10n.gentext.use.xref.language +Use the language of target when generating cross-reference text? + + +Description + +If non-zero, the language of the target will be used when +generating cross reference text. Usually, the current +language is used when generating text (that is, the language of the +element that contains the cross-reference element). But setting this parameter +allows the language of the element pointed to to control +the generated text. + +Consider the following example: + + +<para lang="en">See also <xref linkend="chap3"/>.</para> + + + +Suppose that Chapter 3 happens to be written in German. +If l10n.gentext.use.xref.language is non-zero, the +resulting text will be something like this: + +
                  +See also Kapital 3. +
                  + +Where the more traditional rendering would be: + +
                  +See also Chapter 3. +
                  + +                   +                   + + + +l10n.lang.value.rfc.compliant +boolean + +l10n.lang.value.rfc.compliant +Make value of lang attribute RFC compliant? + + +Description + +If non-zero, ensure that the values for all lang attributes in HTML output are RFC +compliantSection 8.1.1, Language Codes, in the HTML 4.0 Recommendation states that: + +
                  [RFC1766] defines and explains the language codes +that must be used in HTML documents. +Briefly, language codes consist of a primary code and a possibly +empty series of subcodes: + +language-code = primary-code ( "-" subcode )* + +And in RFC 1766, Tags for the Identification +of Languages, the EBNF for "language tag" is given as: + +Language-Tag = Primary-tag *( "-" Subtag ) +Primary-tag = 1*8ALPHA +Subtag = 1*8ALPHA + +
                  +                  . + +by taking any underscore characters in any lang values found in source documents, and +replacing them with hyphen characters in output HTML files. For +example, zh_CN in a source document becomes +zh-CN in the HTML output form that source. + + +This parameter does not cause any case change in lang values, because RFC 1766 +explicitly states that all "language tags" (as it calls them) "are +to be treated as case insensitive". + +                   + +                   +                   + + + +ebnf.assignment +rtf + +ebnf.assignment +The EBNF production assignment operator + + +Description + +The ebnf.assignment parameter determines what +text is used to show assignment in productions +in productionsets. + +While ::= is common, so are several +other operators. + + + + + + + ::= + + + + +ebnf.statement.terminator +rtf + +ebnf.statement.terminator +Punctuation that ends an EBNF statement. + + +Description + +The ebnf.statement.terminator parameter determines what +text is used to terminate each production +in productionset. + +Some notations end each statement with a period. + + + + + + + +crop.marks +boolean + +crop.marks +Output crop marks? + + +Description + +If non-zero, crop marks will be added to each page. Currently this +works only with XEP if you have xep.extensions set. + + + + + + +crop.mark.width +string + +crop.mark.width +Width of crop marks. + + +Description + +Width of crop marks. Crop marks are controlled by +crop.marks parameter. + + + + + + +crop.mark.offset +string + +crop.mark.offset +Length of crop marks. + + +Description + +Length of crop marks. Crop marks are controlled by +crop.marks parameter. + + + + + + +crop.mark.bleed +string + +crop.mark.bleed +Length of invisible part of crop marks. + + +Description + +Length of invisible part of crop marks. Crop marks are controlled by +crop.marks parameter. + + + + +                   \ No newline at end of file diff --git a/src/documentation/docbook-xsl/fo/param.xweb b/src/documentation/docbook-xsl/fo/param.xweb new file mode 100644 index 0000000000..21ab060b42 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/param.xweb @@ -0,0 +1,869 @@ + +%param.ent; +]> + + +FO Parameter Reference + +$Id: param.xweb,v 1.114 2006/05/21 13:05:19 kosek Exp $ + + + Walsh + Norman + + + 1999 + 2000 + 2001 + Norman Walsh + + + +Introduction + +This is reference documentation for all user-configurable +parameters in the DocBook XSL FO stylesheets (for generating +XSL-FO output destined for final print/PDF otutput). + +This reference describes each of the XSL FO Stylesheet parameters. +These are the easily customizable parts of the stylesheet. +If you want to specify an alternate value for one or more of these +parameters, you can do so in a driver stylesheet. + +For example, if you want to change the html.stylesheet +to reference.css, you might create a driver +stylesheet like this: + + + + + + reference.css + +]]> + +Naturally, you have to change the +href attribute on +<xsl:import> to point to +docbook.xsl on your system. (Or +chunk.xsl, if you're using chunking.) + + + +Admonitions +&admon.graphics; +&admon.graphics.extension; +&admon.graphics.path; +&admon.textlabel; +&admonition.title.properties; +&admonition.properties; +&graphical.admonition.properties; +&nongraphical.admonition.properties; + + +Callouts +&callout.defaultcolumn; +&callout.graphics; +&callout.graphics.extension; +&callout.graphics.number.limit; +&callout.graphics.path; +&callout.unicode; +&callout.unicode.font; +&callout.unicode.number.limit; +&callout.unicode.start.character; +&callouts.extension; + + +ToC/LoT/Index Generation +&autotoc.label.separator; +&process.empty.source.toc; +&process.source.toc; +&generate.toc; +&generate.index; +&make.index.markup; +&index.method; +&index.on.type; +&index.on.role; +&index.preferred.page.properties; +&index.entry.properties; +&index.div.title.properties; +&index.number.separator; +&index.range.separator; +&index.term.separator; +&xep.index.item.properties; +&toc.section.depth; +&toc.max.depth; +&toc.indent.width; +&toc.line.properties; +&toc.margin.properties; +&bridgehead.in.toc; +&simplesect.in.toc; +&generate.section.toc.level; + + + + + +Processor Extensions +&arbortext.extensions; +&axf.extensions; +&fop.extensions; +&fop1.extensions; +&passivetex.extensions; +&tex.math.in.alt; +&tex.math.delims; +&xep.extensions; + + +Stylesheet Extensions +&linenumbering.everyNth; +&linenumbering.extension; +&linenumbering.separator; +&linenumbering.width; +&tablecolumns.extension; +&textinsert.extension; +&textdata.default.encoding; +&use.extensions; + + +Automatic labelling +&appendix.autolabel; +&chapter.autolabel; +&part.autolabel; +&preface.autolabel; +§ion.autolabel; +§ion.autolabel.max.depth; +§ion.label.includes.component.label; +&label.from.part; +&component.label.includes.part.label; + + +XSLT Processing +&rootid; + + +Meta/*Info +&make.single.year.ranges; +&make.year.ranges; +&author.othername.in.middle; + + +Reference Pages +&funcsynopsis.decoration; +&funcsynopsis.style; +&function.parens; +&refentry.generate.name; +&refentry.generate.title; +&refentry.pagebreak; +&refentry.title.properties; +&refentry.xref.manvolnum; +&refclass.suppress; + + +Tables +&default.table.width; +&nominal.table.width; +&table.cell.padding; +&table.frame.border.thickness; +&table.frame.border.style; +&table.frame.border.color; +&table.cell.border.thickness; +&table.cell.border.style; +&table.cell.border.color; +&table.table.properties; + + +Linking +¤t.docid; +&collect.xref.targets; +&insert.olink.page.number; +&insert.olink.pdf.frag; +&olink.base.uri; +&olink.debug; +&olink.doctitle; +&olink.lang.fallback.sequence; +&olink.properties; +&prefer.internal.olink; +&target.database.document; +&targets.filename; +&use.local.olink.style; + + +Cross References +&insert.xref.page.number; +&xref.properties; +&xref.label-title.separator; +&xref.label-page.separator; +&xref.title-page.separator; +&insert.link.page.number; + + +Lists +&compact.list.item.spacing; +&itemizedlist.properties; +&itemizedlist.label.properties; +&itemizedlist.label.width; +&list.block.properties; +&list.block.spacing; +&list.item.spacing; +&orderedlist.properties; +&orderedlist.label.properties; +&orderedlist.label.width; +&variablelist.max.termlength; +&variablelist.term.separator; +&variablelist.term.break.after; + + +QAndASet +&qandadiv.autolabel; +&qanda.inherit.numeration; +&qanda.defaultlabel; + + +Bibliography +&biblioentry.item.separator; +&bibliography.collection; +&bibliography.numbered; +&biblioentry.properties; + + +Glossary +&glossterm.auto.link; +&firstterm.only.link; +&glossary.collection; +&glossterm.separation; +&glossterm.width; +&glossary.as.blocks; +&glosslist.as.blocks; +&glossentry.show.acronym; + + +Miscellaneous +&formal.procedures; +&formal.title.placement; +&runinhead.default.title.end.punct; +&runinhead.title.end.punct; +&show.comments; +&punct.honorific; +&segmentedlist.as.table; +&variablelist.as.blocks; +&blockquote.properties; +&ulink.show; +&ulink.footnotes; +&ulink.hyphenate; +&ulink.hyphenate.chars; +&shade.verbatim; +&shade.verbatim.style; +&hyphenate.verbatim; +&hyphenate.verbatim.characters; +&use.svg; +&use.role.as.xrefstyle; +&menuchoice.separator; +&menuchoice.menu.separator; +&default.float.class; +&footnote.number.format; +&table.footnote.number.format; +&footnote.number.symbols; +&table.footnote.number.symbols; +&footnote.properties; +&table.footnote.properties; +&footnote.mark.properties; +&footnote.sep.leader.properties; +&xref.with.number.and.title; +&superscript.properties; +&subscript.properties; +&pgwide.properties; + + +Graphics +&graphic.default.extension; +&default.image.width; +&preferred.mediaobject.role; +&use.role.for.mediaobject; +&ignore.image.scaling; +&img.src.path; +&keep.relative.image.uris; + + +Pagination and General Styles + +
                  Understanding XSL FO Margins + +In order for the parameters in this section to make sense, it is useful to +consider . + +
                  + + + + +Figure showing page margins + +This figure shows the physical page with the various FO page regions +identified. + + +
                  + +First, let's consider the regions on the page. + +The white region is the physical page. Its dimensions are determined by +the page.height and page.width +parameters. + +The yellow region is the region-body. The size and placement of +the region body is constrained by the dimensions labelled in the +figure. + +The pink region at the top of the page is the region-before. The +darker area inside the region-before is the header text. In XSL, the default +display alignment for a region is before, but the +DocBook stylesheets still explicitly make it before. That's +why the darker area is at the top. + +The pink region at the bottom of the page is the region-after. +The darker area is the footer text. In XSL, the default display +alignment for a region is before, +but the DocBook stylesheets explicitly make it +after. That's why the darker area is at the bottom. + +The dimensions in the figure are: + + +The page-master margin-top. + +The region-before extent. + +The region-body margin-top. + +The region-after extent. + +The page-master margin-bottom. + +The region-body margin-bottom. + +The sum of the page-master margin-left and the +region-body margin-left. In DocBook, the region-body margin-left is +zero by default, so this is simply the page-master region-left. + +The sum of the page-master margin-right and the +region-body margin-right. In DocBook, the region-body margin-right is +zero by default, so this is simply the page-master region-left. + + + +
                  +                   + +&page.height; +&page.height.portrait; +&page.margin.bottom; +&page.margin.inner; +&page.margin.outer; +&page.margin.top; +&page.orientation; +&page.width; +&page.width.portrait; +&paper.type; +&double.sided; +&body.margin.bottom; +&body.margin.top; +&body.start.indent; +&body.end.indent; +&alignment; +&hyphenate; +&line-height; +&column.count.back; +&column.count.body; +&column.count.front; +&column.count.index; +&column.count.lot; +&column.count.titlepage; +&column.gap.back; +&column.gap.body; +&column.gap.front; +&column.gap.index; +&column.gap.lot; +&column.gap.titlepage; +®ion.after.extent; +®ion.before.extent; +&default.units; +&normal.para.spacing; +&body.font.master; +&body.font.size; +&footnote.font.size; +&title.margin.left; +&draft.mode; +&draft.watermark.image; +&headers.on.blank.pages; +&footers.on.blank.pages; +&header.rule; +&footer.rule; +&header.column.widths; +&footer.column.widths; +&header.table.height; +&footer.table.height; +&header.content.properties; +&footer.content.properties; +&marker.section.level; +                   + +Font Families +&body.font.family; +&dingbat.font.family; +&monospace.font.family; +&sans.font.family; +&title.font.family; +&symbol.font.family; + + +Property Sets +&formal.object.properties; +&formal.title.properties; +&informal.object.properties; +&monospace.properties; +&verbatim.properties; +&monospace.verbatim.properties; +&sidebar.properties; +&sidebar.title.properties; +&sidebar.float.type; +&sidebar.float.width; +&margin.note.properties; +&margin.note.title.properties; +&margin.note.float.type; +&margin.note.width; +&component.title.properties; +§ion.title.properties; +§ion.title.level1.properties; +§ion.title.level2.properties; +§ion.title.level3.properties; +§ion.title.level4.properties; +§ion.title.level5.properties; +§ion.title.level6.properties; +§ion.properties; +§ion.level1.properties; +§ion.level2.properties; +§ion.level3.properties; +§ion.level4.properties; +§ion.level5.properties; +§ion.level6.properties; +&figure.properties; +&example.properties; +&equation.properties; +&table.properties; +&informalfigure.properties; +&informalexample.properties; +&informalequation.properties; +&informaltable.properties; +&procedure.properties; +&root.properties; +&qanda.title.properties; +&qanda.title.level1.properties; +&qanda.title.level2.properties; +&qanda.title.level3.properties; +&qanda.title.level4.properties; +&qanda.title.level5.properties; +&qanda.title.level6.properties; +&article.appendix.title.properties; +&abstract.properties; +&abstract.title.properties; +&revhistory.table.properties; +&revhistory.table.cell.properties; +&revhistory.title.properties; + + +Profiling + +Following parameters can be used for attribute value based +profiling of your document. For more info about profiling look at +http://docbook.sourceforge.net/projects/xsl/doc/tools/profiling.html. + +&profile.arch; +&profile.condition; +&profile.conformance; +&profile.lang; +&profile.os; +&profile.revision; +&profile.revisionflag; +&profile.role; +&profile.security; +&profile.userlevel; +&profile.vendor; +&profile.attribute; +&profile.value; +&profile.separator; + + +Localization +&l10n.gentext.language; +&l10n.gentext.default.language; +&l10n.gentext.use.xref.language; +&l10n.lang.value.rfc.compliant; + + +EBNF +&ebnf.assignment; +&ebnf.statement.terminator; + + +Prepress +&crop.marks; +&crop.mark.width; +&crop.mark.offset; +&crop.mark.bleed; + + + + +The Stylesheet + +The param.xsl stylesheet is just a wrapper +around all these parameters. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/fo/passivetex.xsl b/src/documentation/docbook-xsl/fo/passivetex.xsl new file mode 100644 index 0000000000..6d5d9bf5c8 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/passivetex.xsl @@ -0,0 +1,36 @@ + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/pdf2index b/src/documentation/docbook-xsl/fo/pdf2index new file mode 100755 index 0000000000..c14d8ecdb3 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/pdf2index @@ -0,0 +1,140 @@ +#!/usr/bin/perl -- # -*- Perl -*- + +# this needs some cleanup... + +my $PSTOTEXT = "pstotext"; + +my $pdf = shift @ARGV; + +my $index = ""; +my $inindex = 0; +open (F, "$PSTOTEXT $pdf |"); +while () { + if (/^<\/index/) { + $index .= $_; + $inindex = 0; + } + $inindex = 1 if /^.*?<\/phrase>\s*)+)/s) { + $cindex .= $1; + $_ = $2; + $index = $'; # ' + + my @pages = m/.*?<\/phrase>\s*/sg; + + # Expand ranges + if ($#pages >= 0) { + my @mpages = (); + foreach my $page (@pages) { + my $pageno = &pageno($page); + if ($pageno =~ /^([0-9]+)[^0-9]([0-9]+)$/) { # funky - + for (my $count = $1; $count <= $2; $count++) { + push (@mpages, "$count"); + } + } else { + push (@mpages, $page); + } + } + @pages = sort rangesort @mpages; + } + + # Remove duplicates... + if ($#pages > 0) { + my @mpages = (); + my $current = ""; + foreach my $page (@pages) { + my $pageno = &pageno($page); + if ($pageno ne $current) { + push (@mpages, $page); + $current = $pageno; + } + } + @pages = @mpages; + } + + # Collapse ranges... + if ($#pages > 1) { + my @cpages = (); + while (@pages) { + my $count = 0; + my $len = &rangelen($count, @pages); + if ($len <= 2) { + my $page = shift @pages; + push (@cpages, $page); + } else { + my $fpage = shift @pages; + my $lpage = ""; + while ($len > 1) { + $lpage = shift @pages; + $len--; + } + my $fpno = &pageno($fpage); + my $lpno = &pageno($lpage); + $fpage =~ s/>$fpno${fpno}-$lpno//; + $page =~ s/^//; + + return $1 if $page =~ /^([^<>]+)/; + return "?"; +} + +sub rangesort { + my $apno = &pageno($a); + my $bpno = &pageno($b); + + # Make sure roman pages come before arabic ones, otherwise sort them in order + return -1 if ($apno !~ /^\d+/ && $bpno =~ /^\d+/); + return 1 if ($apno =~ /^\d+/ && $bpno !~ /^\d+/); + return $apno <=> $bpno; +} + +sub rangelen { + my $count = shift; + my @pages = @_; + my $len = 1; + my $inrange = 1; + + my $current = &pageno($pages[$count]); + while ($count < $#pages && $inrange) { + $count++; + my $next = &pageno($pages[$count]); + if ($current + 1 eq $next) { + $current = $next; + $inrange = 1; + $len++; + } else { + $inrange = 0; + } + } + + return $len; +} diff --git a/src/documentation/docbook-xsl/fo/pi.xsl b/src/documentation/docbook-xsl/fo/pi.xsl new file mode 100644 index 0000000000..b4092f59ec --- /dev/null +++ b/src/documentation/docbook-xsl/fo/pi.xsl @@ -0,0 +1,299 @@ + + + + + + + + + + + + + filename + + + + + + + + + + + + filename + + + + + + + + dir + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + No cmdsynopsis elements matched dbcmdlist PI, perhaps it's nested too deep? + + + +
                  + + + +
                  +                   + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + +
                  + + + + + +                   +                   +                   + + + + + + No funcsynopsis elements matched dbfunclist PI, perhaps it's nested too deep? + + + +
                  + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + 0pt + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/profile-docbook.xsl b/src/documentation/docbook-xsl/fo/profile-docbook.xsl new file mode 100644 index 0000000000..6509acff17 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/profile-docbook.xsl @@ -0,0 +1,271 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + encountered + + in + + + , but no template matches. + + + < + + > + + </ + + > + + + + + + +Stripping NS from DocBook 5/NG document.Processing stripped document. + + + + + + + + + + ID ' + + ' not found in document. + + + + + ERROR: Document root element ($rootid= + + ) for FO output + must be one of the following elements: + + + + + + + + + + + + + + + + + + + + + ERROR: Document root element for FO output + must be one of the following elements: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [could not find document title] + + + + + + false + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Making + + pages on + + paper ( + + x + + ) + + + + + + diff --git a/src/documentation/docbook-xsl/fo/ptc.xsl b/src/documentation/docbook-xsl/fo/ptc.xsl new file mode 100644 index 0000000000..f3e25e3042 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/ptc.xsl @@ -0,0 +1,76 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/qandaset.xsl b/src/documentation/docbook-xsl/fo/qandaset.xsl new file mode 100644 index 0000000000..d4416dd939 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/qandaset.xsl @@ -0,0 +1,399 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + em * 0.50 + + 2.5em + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 2.5em + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + *0.6em + + 2.5em + + + + + + + + + + + + + + + + + 2.5em + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/refentry.xsl b/src/documentation/docbook-xsl/fo/refentry.xsl new file mode 100644 index 0000000000..68e4087900 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/refentry.xsl @@ -0,0 +1,619 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + page + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1em + + + + + + + + + + + , + + + + + + + + em-dash + + + + + + + + + + + + + + + : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + false + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/sections.xsl b/src/documentation/docbook-xsl/fo/sections.xsl new file mode 100644 index 0000000000..a2a6743664 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/sections.xsl @@ -0,0 +1,714 @@ + + + + + + + + + + + + + + + + + + + + 1 + 2 + 3 + 4 + 5 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + 2 + 3 + 4 + 5 + + + + + + + + + + + + + + + + + + + + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + false + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 2 + + + + + + + + + + + + 2 + + + + + + 1 + 2 + 3 + 4 + 5 + + + + + + + + + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/spaces.xsl b/src/documentation/docbook-xsl/fo/spaces.xsl new file mode 100644 index 0000000000..c54773e513 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/spaces.xsl @@ -0,0 +1,273 @@ + + + + + + + + + + + + + + + + + + + + + + + + +0.5em +1em +0.5em +1em +0.33em +0.25em +0.16em + + +0.2em +0.1em + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/synop.xsl b/src/documentation/docbook-xsl/fo/synop.xsl new file mode 100644 index 0000000000..5d5e1dec4a --- /dev/null +++ b/src/documentation/docbook-xsl/fo/synop.xsl @@ -0,0 +1,967 @@ + + + +]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + +   + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + (void); + + + (); + + + + + + (...); + + + + + + + ( + + + + + + + + + + + , + + + ); + + + + + + + + + + + + + + + , + + + + + + + ; + + + + + ( + + ) + + + + +java + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unrecognized language on + + : + + + + + + + + + + + + &RE; + + + + + + + + + + extends + + + &RE;     + + + + implements + + + &RE;     + + + + throws + + +  {&RE; + + } + + + + + + + + + + + , + + + + + + + + + + + +   + + + + + + , + + + + + + + , + + + + + + + , + + + + + + +    + + ; + + + + + + +   + + + + +   + + + + =  + + + + + void  + + + + + + + + 0 + + ,&RE; + + +   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ( + + + + ) + + &RE;    throws  + + + + + + + ; + + + + + + + + + + + : + + + &RE;     + + + + implements + + + &RE;     + + + + throws + + +  {&RE; + + } + + + + + + + + + + , + + + + + + + +   + + + + + + , + + + + + + + , + + + + + + + , + + + + + + +    + + ; + + + + + + +   + + + + +   + + + + =  + + + + + void  + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + &RE;    throws  + + + + + + + ; + + + + + + + + + interface + + + : + + + &RE;     + + + + implements + + + &RE;     + + + + throws + + +  {&RE; + + } + + + + + + + + + + , + + + + + + + +   + + + + + + , + + + + + + + , + + + + + + + , + + + + + + +    + + ; + + + + + + +   + + + + +   + + + + =  + + + + + void  + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + &RE;    raises( + + ) + + + + + + ; + + + + + + + + + package + + ;&RE; + + + @ISA = ( + + );&RE; + + + + + + + + + + + + + , + + + + + + + +   + + + + + + , + + + + + + + , + + + + + + + , + + + + + + +    + + ; + + + + + + +   + + + + +   + + + + =  + + + + + void  + + + + + + + + + , + + + + + + + + + + + + + + + sub + + + { ... }; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/table.xsl b/src/documentation/docbook-xsl/fo/table.xsl new file mode 100644 index 0000000000..80dc1af828 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/table.xsl @@ -0,0 +1,1506 @@ + + + + + + + + + + +$Id: table.xsl,v 1.48 2006/05/04 07:11:00 bobstayton Exp $ + +Walsh +Norman +19992000 +Norman Walsh + + +Formatting Object Table Reference + + +
                  Introduction + +This is technical reference documentation for the DocBook XSL +Stylesheets; it documents (some of) the parameters, templates, and +other elements of the stylesheets. + +This is not intended to be user documentation. +It is provided for developers writing customization layers for the +stylesheets, and for anyone who's interested in how it +works. + +Although I am trying to be thorough, this documentation is known +to be incomplete. Don't forget to read the source, too :-) +
                  +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0pt + none + 0pt + 0pt + 0pt + 0pt + 0pt + 0pt + + + 0pt + none + 0pt + 0pt + 0pt + 0pt + 0pt + 0pt + + + fixed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + always + + + + + + + + + + + + + + + + + + + + + + + + + + all + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + none + none + none + + + + + + + + + + + + + + + + + + none + none + + + + + + + + + + + + + + + none + none + + + + none + + + + + + + + + none + none + + + + + + + + + + + + + + + + + + + + + none + none + none + none + + + + Impossible frame on table: + + + none + none + none + none + + + + + + + + + + + + + + + + + + + + + + + + + + Error: CALS tables must specify the number of columns. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No adjustColumnWidths function available. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + NOWIDTH + NOWIDTH + + + + + + + + + + + + + + + + + NOWIDTH + NOWIDTH + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 100% + + + auto + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + fixed + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + before + center + after + + + Unexpected valign value: + + , center used. + + center + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + bold + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + : + + + + + + + + 0: + + + + + + + + + + + + + + + 0 + + : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + 1* + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1* + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Calculate an XSL FO table column width specification from a +CALS table column width specification. + + +CALS expresses table column widths in the following basic +forms: + + + +99.99units, a fixed length specifier. + + +99.99, a fixed length specifier without any units. + + +99.99*, a relative length specifier. + + +99.99*+99.99units, a combination of both. + + + +The CALS units are points (pt), picas (pi), centimeters (cm), +millimeters (mm), and inches (in). These are the same units as XSL, +except that XSL abbreviates picas "pc" instead of "pi". If a length +specifier has no units, the CALS default unit (pt) is assumed. + +Relative length specifiers are represented in XSL with the +proportional-column-width() function. + +Here are some examples: + + + +"36pt" becomes "36pt" + + +"3pi" becomes "3pc" + + +"36" becomes "36pt" + + +"3*" becomes "proportional-column-width(3)" + + +"3*+2pi" becomes "proportional-column-width(3)+2pc" + + +"1*+2" becomes "proportional-column-width(1)+2pt" + + + + + + +colwidth + +The CALS column width specification. + + + + + + +The XSL column width specification. + + + + + 1* + + + + + + + + + + + + proportional-column-width( + + + + + + 1.00 + + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + pc + pt + + + + + + +                   diff --git a/src/documentation/docbook-xsl/fo/task.xsl b/src/documentation/docbook-xsl/fo/task.xsl new file mode 100644 index 0000000000..5af094faee --- /dev/null +++ b/src/documentation/docbook-xsl/fo/task.xsl @@ -0,0 +1,81 @@ + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/fo/titlepage.templates.xml b/src/documentation/docbook-xsl/fo/titlepage.templates.xml new file mode 100644 index 0000000000..c770f8ba6d --- /dev/null +++ b/src/documentation/docbook-xsl/fo/titlepage.templates.xml @@ -0,0 +1,1311 @@ + + + + + + + + + + + + +]> + + + + + + + + + + + + + <subtitle/> + + <corpauthor space-before="0.5em" + font-size="&hsize2;"/> + <authorgroup space-before="0.5em" + font-size="&hsize2;"/> + <author space-before="0.5em" + font-size="&hsize2;"/> + + <othercredit space-before="0.5em"/> + <releaseinfo space-before="0.5em"/> + <copyright space-before="0.5em"/> + <legalnotice text-align="start" + margin-left="0.5in" + margin-right="0.5in" + font-family="{$body.fontset}"/> + <pubdate space-before="0.5em"/> + <revision space-before="0.5em"/> + <revhistory space-before="0.5em"/> + <abstract space-before="0.5em" + text-align="start" + margin-left="0.5in" + margin-right="0.5in" + font-family="{$body.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="set" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:named-template="division.title" + param:node="ancestor-or-self::set[1]" + text-align="center" + font-size="&hsize5;" + space-before="&hsize5space;" + font-weight="bold" + font-family="{$title.fontset}"/> + <subtitle + font-family="{$title.fontset}" + text-align="center"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="book" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:named-template="division.title" + param:node="ancestor-or-self::book[1]" + text-align="center" + font-size="&hsize5;" + space-before="&hsize5space;" + font-weight="bold" + font-family="{$title.fontset}"/> + <subtitle + text-align="center" + font-size="&hsize4;" + space-before="&hsize4space;" + font-family="{$title.fontset}"/> + <corpauthor font-size="&hsize3;" + keep-with-next.within-column="always" + space-before="2in"/> + <authorgroup space-before="2in"/> + <author font-size="&hsize3;" + space-before="&hsize2space;" + keep-with-next.within-column="always"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + <title + t:named-template="book.verso.title" + font-size="&hsize2;" + font-weight="bold" + font-family="{$title.fontset}"/> + <corpauthor/> + <authorgroup t:named-template="verso.authorgroup"/> + <author/> + <othercredit/> + <releaseinfo space-before="0.5em"/> + <pubdate space-before="1em"/> + <copyright/> + <abstract/> + <legalnotice font-size="8pt"/> + </t:titlepage-content> + + <t:titlepage-separator> + <fo:block break-after="page"/> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + <fo:block break-after="page"/> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="part" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:named-template="division.title" + param:node="ancestor-or-self::part[1]" + text-align="center" + font-size="&hsize5;" + space-before="&hsize5space;" + font-weight="bold" + font-family="{$title.fontset}"/> + <subtitle + text-align="center" + font-size="&hsize4;" + space-before="&hsize4space;" + font-weight='bold' + font-style='italic' + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="partintro" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + text-align="center" + font-size="&hsize5;" + font-weight="bold" + space-before="1em" + font-family="{$title.fontset}"/> + <subtitle + text-align="center" + font-size="&hsize2;" + font-weight="bold" + font-style="italic" + font-family="{$title.fontset}"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="reference" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:named-template="division.title" + param:node="ancestor-or-self::reference[1]" + text-align="center" + font-size="&hsize5;" + space-before="&hsize5space;" + font-weight="bold" + font-family="{$title.fontset}"/> + <subtitle + font-family="{$title.fontset}" + text-align="center"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="refsynopsisdiv" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="refsection" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="refsect1" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="refsect2" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="refsect3" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="dedication" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::dedication[1]" + margin-left="{$title.margin.left}" + font-size="&hsize5;" + font-family="{$title.fontset}" + font-weight="bold"/> + <subtitle + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="preface" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::preface[1]" + margin-left="{$title.margin.left}" + font-size="&hsize5;" + font-family="{$title.fontset}" + font-weight="bold"/> + <subtitle + font-family="{$title.fontset}"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="chapter" t:wrapper="fo:block" + font-family="{$title.fontset}"> + <t:titlepage-content t:side="recto" margin-left="{$title.margin.left}"> + <title t:named-template="component.title" + param:node="ancestor-or-self::chapter[1]" + font-size="&hsize5;" + font-weight="bold"/> + + <subtitle space-before="0.5em" + font-style="italic" + font-size="&hsize2;" + font-weight="bold"/> + + <corpauthor space-before="0.5em" + space-after="0.5em" + font-size="&hsize2;"/> + + <authorgroup space-before="0.5em" + space-after="0.5em" + font-size="&hsize2;"/> + + <author space-before="0.5em" + space-after="0.5em" + font-size="&hsize2;"/> + + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="appendix" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:named-template="component.title" + param:node="ancestor-or-self::appendix[1]" + margin-left="{$title.margin.left}" + font-size="&hsize5;" + font-weight="bold" + font-family="{$title.fontset}"/> + <subtitle + font-family="{$title.fontset}"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="section" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + margin-left="{$title.margin.left}" + font-family="{$title.fontset}"/> + <subtitle + font-family="{$title.fontset}"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="sect1" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + margin-left="{$title.margin.left}" + font-family="{$title.fontset}"/> + <subtitle + font-family="{$title.fontset}"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="sect2" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + margin-left="{$title.margin.left}" + font-family="{$title.fontset}"/> + <subtitle + font-family="{$title.fontset}"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="sect3" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + margin-left="{$title.margin.left}" + font-family="{$title.fontset}"/> + <subtitle + font-family="{$title.fontset}"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="sect4" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + margin-left="{$title.margin.left}" + font-family="{$title.fontset}"/> + <subtitle + font-family="{$title.fontset}"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="sect5" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + margin-left="{$title.margin.left}" + font-family="{$title.fontset}"/> + <subtitle + font-family="{$title.fontset}"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="simplesect" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + margin-left="{$title.margin.left}" + font-family="{$title.fontset}"/> + <subtitle + font-family="{$title.fontset}"/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="bibliography" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::bibliography[1]" + margin-left="{$title.margin.left}" + font-size="&hsize5;" + font-family="{$title.fontset}" + font-weight="bold"/> + <subtitle + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="bibliodiv" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title t:named-template="component.title" + param:node="ancestor-or-self::bibliodiv[1]" + margin-left="{$title.margin.left}" + font-size="&hsize4;" + font-family="{$title.fontset}" + font-weight="bold"/> + <subtitle + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="glossary" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::glossary[1]" + margin-left="{$title.margin.left}" + font-size="&hsize5;" + font-family="{$title.fontset}" + font-weight="bold"/> + <subtitle + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="glossdiv" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title t:named-template="component.title" + param:node="ancestor-or-self::glossdiv[1]" + margin-left="{$title.margin.left}" + font-size="&hsize4;" + font-family="{$title.fontset}" + font-weight="bold"/> + <subtitle + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="index" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::index[1]" + param:pagewide="1" + margin-left="0pt" + font-size="&hsize5;" + font-family="{$title.fontset}" + font-weight="bold"/> + <subtitle + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + +<!-- ==================================================================== --> + + <!-- The indexdiv.title template is used so that manual and --> + <!-- automatically generated indexdiv titles get the same --> + <!-- formatting. --> + + <t:titlepage t:element="indexdiv" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title t:force="1" + t:named-template="indexdiv.title" + param:title="title"/> + <subtitle + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="setindex" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::setindex[1]" + param:pagewide="1" + margin-left="0pt" + font-size="&hsize5;" + font-family="{$title.fontset}" + font-weight="bold"/> + <subtitle + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="colophon" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::colophon[1]" + margin-left="{$title.margin.left}" + font-size="&hsize5;" + font-family="{$title.fontset}" + font-weight="bold"/> + <subtitle + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="sidebar" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + font-family="{$title.fontset}" + font-weight="bold"/> + <subtitle + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + +<!-- ==================================================================== --> +<t:titlepage t:element="qandaset" t:wrapper="fo:block" + font-family="{$title.fontset}"> + + <t:titlepage-content t:side="recto" + start-indent="0pt" + text-align="center"> + + <title t:named-template="component.title" + param:node="ancestor-or-self::qandaset[1]" + keep-with-next.within-column="always" + font-size="&hsize5;" + font-weight="bold"/> + + <subtitle/> + + <corpauthor space-before="0.5em" + font-size="&hsize2;"/> + <authorgroup space-before="0.5em" + font-size="&hsize2;"/> + <author space-before="0.5em" + font-size="&hsize2;"/> + + <othercredit space-before="0.5em"/> + <releaseinfo space-before="0.5em"/> + <copyright space-before="0.5em"/> + <legalnotice text-align="start" + margin-left="0.5in" + margin-right="0.5in" + font-family="{$body.fontset}"/> + <pubdate space-before="0.5em"/> + <revision space-before="0.5em"/> + <revhistory space-before="0.5em"/> + <abstract space-before="0.5em" + text-align="start" + margin-left="0.5in" + margin-right="0.5in" + font-family="{$body.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="table.of.contents" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="gentext" + param:key="'TableofContents'" + space-before.minimum="1em" + space-before.optimum="1.5em" + space-before.maximum="2em" + space-after="0.5em" + margin-left="{$title.margin.left}" + start-indent="0pt" + font-size="&hsize3;" + font-weight="bold" + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + + <t:titlepage t:element="list.of.tables" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="gentext" + param:key="'ListofTables'" + space-before.minimum="1em" + space-before.optimum="1.5em" + space-before.maximum="2em" + space-after="0.5em" + margin-left="{$title.margin.left}" + start-indent="0pt" + font-size="&hsize3;" + font-weight="bold" + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + + <t:titlepage t:element="list.of.figures" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="gentext" + param:key="'ListofFigures'" + space-before.minimum="1em" + space-before.optimum="1.5em" + space-before.maximum="2em" + space-after="0.5em" + margin-left="{$title.margin.left}" + start-indent="0pt" + font-size="&hsize3;" + font-weight="bold" + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + + <t:titlepage t:element="list.of.examples" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="gentext" + param:key="'ListofExamples'" + space-before.minimum="1em" + space-before.optimum="1.5em" + space-before.maximum="2em" + space-after="0.5em" + margin-left="{$title.margin.left}" + start-indent="0pt" + font-size="&hsize3;" + font-weight="bold" + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + + <t:titlepage t:element="list.of.equations" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="gentext" + param:key="'ListofEquations'" + space-before.minimum="1em" + space-before.optimum="1.5em" + space-before.maximum="2em" + space-after="0.5em" + margin-left="{$title.margin.left}" + start-indent="0pt" + font-size="&hsize3;" + font-weight="bold" + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + + <t:titlepage t:element="list.of.procedures" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="gentext" + param:key="'ListofProcedures'" + space-before.minimum="1em" + space-before.optimum="1.5em" + space-before.maximum="2em" + space-after="0.5em" + margin-left="{$title.margin.left}" + start-indent="0pt" + font-size="&hsize3;" + font-weight="bold" + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + + <t:titlepage t:element="list.of.unknowns" t:wrapper="fo:block"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="gentext" + param:key="'ListofUnknown'" + space-before.minimum="1em" + space-before.optimum="1.5em" + space-before.maximum="2em" + space-after="0.5em" + margin-left="{$title.margin.left}" + start-indent="0pt" + font-size="&hsize3;" + font-weight="bold" + font-family="{$title.fontset}"/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> + </t:titlepage> + +<!-- ==================================================================== --> + +</t:templates> diff --git a/src/documentation/docbook-xsl/fo/titlepage.templates.xsl b/src/documentation/docbook-xsl/fo/titlepage.templates.xsl new file mode 100644 index 0000000000..3cff77daf4 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/titlepage.templates.xsl @@ -0,0 +1,5091 @@ +<?xml version="1.0" encoding="utf-8"?><xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:exsl="http://exslt.org/common" version="1.0" exclude-result-prefixes="exsl"> + +<!-- This stylesheet was created by template/titlepage.xsl; do not edit it by hand. --> + +<xsl:template name="article.titlepage.recto"> + <xsl:choose> + <xsl:when test="articleinfo/title"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/title"/> + </xsl:when> + <xsl:when test="artheader/title"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="articleinfo/subtitle"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/subtitle"/> + </xsl:when> + <xsl:when test="artheader/subtitle"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/corpauthor"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/corpauthor"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/authorgroup"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/authorgroup"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/author"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/author"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/othercredit"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/othercredit"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/releaseinfo"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/releaseinfo"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/copyright"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/copyright"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/legalnotice"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/legalnotice"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/pubdate"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/pubdate"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/revision"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/revision"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/revhistory"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/revhistory"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/abstract"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/abstract"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="article.titlepage.verso"> +</xsl:template> + +<xsl:template name="article.titlepage.separator"> +</xsl:template> + +<xsl:template name="article.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="article.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="article.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" font-family="{$title.fontset}"> + <xsl:variable name="recto.content"> + <xsl:call-template name="article.titlepage.before.recto"/> + <xsl:call-template name="article.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block start-indent="0pt" text-align="center"><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="article.titlepage.before.verso"/> + <xsl:call-template name="article.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="article.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="article.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="article.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" keep-with-next.within-column="always" font-size="24.8832pt" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::article[1]"/> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" space-before="0.5em" font-size="14.4pt"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" space-before="0.5em" font-size="14.4pt"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" space-before="0.5em" font-size="14.4pt"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" text-align="start" margin-left="0.5in" margin-right="0.5in" font-family="{$body.fontset}"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="article.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="article.titlepage.recto.style" space-before="0.5em" text-align="start" margin-left="0.5in" margin-right="0.5in" font-family="{$body.fontset}"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="set.titlepage.recto"> + <xsl:choose> + <xsl:when test="setinfo/title"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="setinfo/subtitle"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/corpauthor"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/authorgroup"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/author"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/othercredit"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/releaseinfo"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/copyright"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/legalnotice"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/pubdate"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/revision"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/revhistory"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/abstract"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="set.titlepage.verso"> +</xsl:template> + +<xsl:template name="set.titlepage.separator"> +</xsl:template> + +<xsl:template name="set.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="set.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="set.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="set.titlepage.before.recto"/> + <xsl:call-template name="set.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="set.titlepage.before.verso"/> + <xsl:call-template name="set.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="set.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="set.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="set.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style" text-align="center" font-size="24.8832pt" space-before="18.6624pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="division.title"> +<xsl:with-param name="node" select="ancestor-or-self::set[1]"/> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style" font-family="{$title.fontset}" text-align="center"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="set.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="book.titlepage.recto"> + <xsl:choose> + <xsl:when test="bookinfo/title"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="bookinfo/subtitle"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/corpauthor"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/authorgroup"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/author"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/author"/> +</xsl:template> + +<xsl:template name="book.titlepage.verso"> + <xsl:choose> + <xsl:when test="bookinfo/title"> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/corpauthor"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/authorgroup"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/author"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/author"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/othercredit"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/releaseinfo"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/pubdate"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/copyright"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/abstract"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/abstract"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="bookinfo/legalnotice"/> + <xsl:apply-templates mode="book.titlepage.verso.auto.mode" select="info/legalnotice"/> +</xsl:template> + +<xsl:template name="book.titlepage.separator"><fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" break-after="page"/> +</xsl:template> + +<xsl:template name="book.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="book.titlepage.before.verso"><fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" break-after="page"/> +</xsl:template> + +<xsl:template name="book.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="book.titlepage.before.recto"/> + <xsl:call-template name="book.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="book.titlepage.before.verso"/> + <xsl:call-template name="book.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="book.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="book.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="book.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="book.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.recto.style" text-align="center" font-size="24.8832pt" space-before="18.6624pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="division.title"> +<xsl:with-param name="node" select="ancestor-or-self::book[1]"/> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="book.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.recto.style" text-align="center" font-size="20.736pt" space-before="15.552pt" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="book.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.recto.style" font-size="17.28pt" keep-with-next.within-column="always" space-before="2in"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="book.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.recto.style" space-before="2in"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="book.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.recto.style" font-size="17.28pt" space-before="10.8pt" keep-with-next.within-column="always"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="title" mode="book.titlepage.verso.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.verso.style" font-size="14.4pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="book.verso.title"> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="book.titlepage.verso.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.verso.style"> +<xsl:apply-templates select="." mode="book.titlepage.verso.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="book.titlepage.verso.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.verso.style"> +<xsl:call-template name="verso.authorgroup"> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="book.titlepage.verso.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.verso.style"> +<xsl:apply-templates select="." mode="book.titlepage.verso.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="book.titlepage.verso.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.verso.style"> +<xsl:apply-templates select="." mode="book.titlepage.verso.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="book.titlepage.verso.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.verso.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="book.titlepage.verso.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="book.titlepage.verso.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.verso.style" space-before="1em"> +<xsl:apply-templates select="." mode="book.titlepage.verso.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="book.titlepage.verso.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.verso.style"> +<xsl:apply-templates select="." mode="book.titlepage.verso.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="book.titlepage.verso.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.verso.style"> +<xsl:apply-templates select="." mode="book.titlepage.verso.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="book.titlepage.verso.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="book.titlepage.verso.style" font-size="8pt"> +<xsl:apply-templates select="." mode="book.titlepage.verso.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="part.titlepage.recto"> + <xsl:choose> + <xsl:when test="partinfo/title"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="partinfo/subtitle"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="part.titlepage.verso"> +</xsl:template> + +<xsl:template name="part.titlepage.separator"> +</xsl:template> + +<xsl:template name="part.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="part.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="part.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="part.titlepage.before.recto"/> + <xsl:call-template name="part.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="part.titlepage.before.verso"/> + <xsl:call-template name="part.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="part.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="part.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="part.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="part.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="part.titlepage.recto.style" text-align="center" font-size="24.8832pt" space-before="18.6624pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="division.title"> +<xsl:with-param name="node" select="ancestor-or-self::part[1]"/> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="part.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="part.titlepage.recto.style" text-align="center" font-size="20.736pt" space-before="15.552pt" font-weight="bold" font-style="italic" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="partintro.titlepage.recto"> + <xsl:choose> + <xsl:when test="partintroinfo/title"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="partintroinfo/subtitle"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/corpauthor"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/authorgroup"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/author"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/othercredit"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/releaseinfo"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/copyright"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/legalnotice"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/pubdate"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/revision"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/revhistory"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/abstract"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="partintro.titlepage.verso"> +</xsl:template> + +<xsl:template name="partintro.titlepage.separator"> +</xsl:template> + +<xsl:template name="partintro.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="partintro.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="partintro.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="partintro.titlepage.before.recto"/> + <xsl:call-template name="partintro.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="partintro.titlepage.before.verso"/> + <xsl:call-template name="partintro.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="partintro.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="partintro.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="partintro.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style" text-align="center" font-size="24.8832pt" font-weight="bold" space-before="1em" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style" text-align="center" font-size="14.4pt" font-weight="bold" font-style="italic" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="partintro.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="reference.titlepage.recto"> + <xsl:choose> + <xsl:when test="referenceinfo/title"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="referenceinfo/subtitle"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/corpauthor"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/authorgroup"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/author"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/othercredit"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/releaseinfo"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/copyright"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/legalnotice"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/pubdate"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/revision"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/revhistory"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/abstract"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="reference.titlepage.verso"> +</xsl:template> + +<xsl:template name="reference.titlepage.separator"> +</xsl:template> + +<xsl:template name="reference.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="reference.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="reference.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="reference.titlepage.before.recto"/> + <xsl:call-template name="reference.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="reference.titlepage.before.verso"/> + <xsl:call-template name="reference.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="reference.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="reference.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="reference.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style" text-align="center" font-size="24.8832pt" space-before="18.6624pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="division.title"> +<xsl:with-param name="node" select="ancestor-or-self::reference[1]"/> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style" font-family="{$title.fontset}" text-align="center"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="reference.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="refsynopsisdiv.titlepage.recto"> + <xsl:choose> + <xsl:when test="refsynopsisdivinfo/title"> + <xsl:apply-templates mode="refsynopsisdiv.titlepage.recto.auto.mode" select="refsynopsisdivinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="refsynopsisdiv.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="refsynopsisdiv.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="refsynopsisdiv.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="refsynopsisdiv.titlepage.verso"> +</xsl:template> + +<xsl:template name="refsynopsisdiv.titlepage.separator"> +</xsl:template> + +<xsl:template name="refsynopsisdiv.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="refsynopsisdiv.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="refsynopsisdiv.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="refsynopsisdiv.titlepage.before.recto"/> + <xsl:call-template name="refsynopsisdiv.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="refsynopsisdiv.titlepage.before.verso"/> + <xsl:call-template name="refsynopsisdiv.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="refsynopsisdiv.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="refsynopsisdiv.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="refsynopsisdiv.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="refsynopsisdiv.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="refsynopsisdiv.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="refsynopsisdiv.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="refsection.titlepage.recto"> + <xsl:choose> + <xsl:when test="refsectioninfo/title"> + <xsl:apply-templates mode="refsection.titlepage.recto.auto.mode" select="refsectioninfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="refsection.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="refsection.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="refsection.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="refsection.titlepage.verso"> +</xsl:template> + +<xsl:template name="refsection.titlepage.separator"> +</xsl:template> + +<xsl:template name="refsection.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="refsection.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="refsection.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="refsection.titlepage.before.recto"/> + <xsl:call-template name="refsection.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="refsection.titlepage.before.verso"/> + <xsl:call-template name="refsection.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="refsection.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="refsection.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="refsection.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="refsection.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="refsection.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="refsection.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="refsect1.titlepage.recto"> + <xsl:choose> + <xsl:when test="refsect1info/title"> + <xsl:apply-templates mode="refsect1.titlepage.recto.auto.mode" select="refsect1info/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="refsect1.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="refsect1.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="refsect1.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="refsect1.titlepage.verso"> +</xsl:template> + +<xsl:template name="refsect1.titlepage.separator"> +</xsl:template> + +<xsl:template name="refsect1.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="refsect1.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="refsect1.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="refsect1.titlepage.before.recto"/> + <xsl:call-template name="refsect1.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="refsect1.titlepage.before.verso"/> + <xsl:call-template name="refsect1.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="refsect1.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="refsect1.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="refsect1.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="refsect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="refsect1.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="refsect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="refsect2.titlepage.recto"> + <xsl:choose> + <xsl:when test="refsect2info/title"> + <xsl:apply-templates mode="refsect2.titlepage.recto.auto.mode" select="refsect2info/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="refsect2.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="refsect2.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="refsect2.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="refsect2.titlepage.verso"> +</xsl:template> + +<xsl:template name="refsect2.titlepage.separator"> +</xsl:template> + +<xsl:template name="refsect2.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="refsect2.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="refsect2.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="refsect2.titlepage.before.recto"/> + <xsl:call-template name="refsect2.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="refsect2.titlepage.before.verso"/> + <xsl:call-template name="refsect2.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="refsect2.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="refsect2.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="refsect2.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="refsect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="refsect2.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="refsect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="refsect3.titlepage.recto"> + <xsl:choose> + <xsl:when test="refsect3info/title"> + <xsl:apply-templates mode="refsect3.titlepage.recto.auto.mode" select="refsect3info/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="refsect3.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="refsect3.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="refsect3.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="refsect3.titlepage.verso"> +</xsl:template> + +<xsl:template name="refsect3.titlepage.separator"> +</xsl:template> + +<xsl:template name="refsect3.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="refsect3.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="refsect3.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="refsect3.titlepage.before.recto"/> + <xsl:call-template name="refsect3.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="refsect3.titlepage.before.verso"/> + <xsl:call-template name="refsect3.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="refsect3.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="refsect3.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="refsect3.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="refsect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="refsect3.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="refsect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="dedication.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="dedication.titlepage.recto.style" margin-left="{$title.margin.left}" font-size="24.8832pt" font-family="{$title.fontset}" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::dedication[1]"/> +</xsl:call-template></fo:block> + <xsl:choose> + <xsl:when test="dedicationinfo/subtitle"> + <xsl:apply-templates mode="dedication.titlepage.recto.auto.mode" select="dedicationinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="dedication.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="dedication.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="dedication.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="dedication.titlepage.verso"> +</xsl:template> + +<xsl:template name="dedication.titlepage.separator"> +</xsl:template> + +<xsl:template name="dedication.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="dedication.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="dedication.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="dedication.titlepage.before.recto"/> + <xsl:call-template name="dedication.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="dedication.titlepage.before.verso"/> + <xsl:call-template name="dedication.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="dedication.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="dedication.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="dedication.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="dedication.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="dedication.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="dedication.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="preface.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style" margin-left="{$title.margin.left}" font-size="24.8832pt" font-family="{$title.fontset}" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::preface[1]"/> +</xsl:call-template></fo:block> + <xsl:choose> + <xsl:when test="prefaceinfo/subtitle"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/corpauthor"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/authorgroup"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/author"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/othercredit"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/releaseinfo"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/copyright"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/legalnotice"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/pubdate"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/revision"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/revhistory"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/abstract"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="preface.titlepage.verso"> +</xsl:template> + +<xsl:template name="preface.titlepage.separator"> +</xsl:template> + +<xsl:template name="preface.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="preface.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="preface.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="preface.titlepage.before.recto"/> + <xsl:call-template name="preface.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="preface.titlepage.before.verso"/> + <xsl:call-template name="preface.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="preface.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="preface.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="preface.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="preface.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="chapter.titlepage.recto"> + <xsl:choose> + <xsl:when test="chapterinfo/title"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="chapterinfo/subtitle"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/corpauthor"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/authorgroup"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/author"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/othercredit"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/releaseinfo"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/copyright"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/legalnotice"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/pubdate"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/revision"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/revhistory"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/abstract"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="chapter.titlepage.verso"> +</xsl:template> + +<xsl:template name="chapter.titlepage.separator"> +</xsl:template> + +<xsl:template name="chapter.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="chapter.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="chapter.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" font-family="{$title.fontset}"> + <xsl:variable name="recto.content"> + <xsl:call-template name="chapter.titlepage.before.recto"/> + <xsl:call-template name="chapter.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block margin-left="{$title.margin.left}"><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="chapter.titlepage.before.verso"/> + <xsl:call-template name="chapter.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="chapter.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="chapter.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="chapter.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style" font-size="24.8832pt" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::chapter[1]"/> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style" space-before="0.5em" font-style="italic" font-size="14.4pt" font-weight="bold"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style" space-before="0.5em" space-after="0.5em" font-size="14.4pt"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style" space-before="0.5em" space-after="0.5em" font-size="14.4pt"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style" space-before="0.5em" space-after="0.5em" font-size="14.4pt"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="chapter.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="appendix.titlepage.recto"> + <xsl:choose> + <xsl:when test="appendixinfo/title"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="appendixinfo/subtitle"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/corpauthor"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/authorgroup"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/author"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/othercredit"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/releaseinfo"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/copyright"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/legalnotice"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/pubdate"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/revision"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/revhistory"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/abstract"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="appendix.titlepage.verso"> +</xsl:template> + +<xsl:template name="appendix.titlepage.separator"> +</xsl:template> + +<xsl:template name="appendix.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="appendix.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="appendix.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="appendix.titlepage.before.recto"/> + <xsl:call-template name="appendix.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="appendix.titlepage.before.verso"/> + <xsl:call-template name="appendix.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="appendix.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="appendix.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="appendix.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style" margin-left="{$title.margin.left}" font-size="24.8832pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::appendix[1]"/> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="appendix.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="section.titlepage.recto"> + <xsl:choose> + <xsl:when test="sectioninfo/title"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sectioninfo/subtitle"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/corpauthor"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/authorgroup"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/author"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/othercredit"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/releaseinfo"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/copyright"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/legalnotice"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/pubdate"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/revision"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/revhistory"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/abstract"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="section.titlepage.verso"> +</xsl:template> + +<xsl:template name="section.titlepage.separator"> +</xsl:template> + +<xsl:template name="section.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="section.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="section.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="section.titlepage.before.recto"/> + <xsl:call-template name="section.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="section.titlepage.before.verso"/> + <xsl:call-template name="section.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="section.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="section.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="section.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style" margin-left="{$title.margin.left}" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="section.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="sect1.titlepage.recto"> + <xsl:choose> + <xsl:when test="sect1info/title"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sect1info/subtitle"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/corpauthor"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/authorgroup"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/author"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/othercredit"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/releaseinfo"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/copyright"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/legalnotice"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/pubdate"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/revision"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/revhistory"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/abstract"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="sect1.titlepage.verso"> +</xsl:template> + +<xsl:template name="sect1.titlepage.separator"> +</xsl:template> + +<xsl:template name="sect1.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="sect1.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="sect1.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="sect1.titlepage.before.recto"/> + <xsl:call-template name="sect1.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="sect1.titlepage.before.verso"/> + <xsl:call-template name="sect1.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="sect1.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="sect1.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="sect1.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style" margin-left="{$title.margin.left}" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="sect1.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="sect2.titlepage.recto"> + <xsl:choose> + <xsl:when test="sect2info/title"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sect2info/subtitle"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/corpauthor"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/authorgroup"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/author"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/othercredit"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/releaseinfo"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/copyright"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/legalnotice"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/pubdate"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/revision"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/revhistory"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/abstract"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="sect2.titlepage.verso"> +</xsl:template> + +<xsl:template name="sect2.titlepage.separator"> +</xsl:template> + +<xsl:template name="sect2.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="sect2.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="sect2.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="sect2.titlepage.before.recto"/> + <xsl:call-template name="sect2.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="sect2.titlepage.before.verso"/> + <xsl:call-template name="sect2.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="sect2.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="sect2.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="sect2.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style" margin-left="{$title.margin.left}" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="sect2.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="sect3.titlepage.recto"> + <xsl:choose> + <xsl:when test="sect3info/title"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sect3info/subtitle"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/corpauthor"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/authorgroup"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/author"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/othercredit"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/releaseinfo"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/copyright"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/legalnotice"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/pubdate"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/revision"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/revhistory"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/abstract"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="sect3.titlepage.verso"> +</xsl:template> + +<xsl:template name="sect3.titlepage.separator"> +</xsl:template> + +<xsl:template name="sect3.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="sect3.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="sect3.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="sect3.titlepage.before.recto"/> + <xsl:call-template name="sect3.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="sect3.titlepage.before.verso"/> + <xsl:call-template name="sect3.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="sect3.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="sect3.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="sect3.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style" margin-left="{$title.margin.left}" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="sect3.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="sect4.titlepage.recto"> + <xsl:choose> + <xsl:when test="sect4info/title"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sect4info/subtitle"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/corpauthor"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/authorgroup"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/author"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/othercredit"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/releaseinfo"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/copyright"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/legalnotice"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/pubdate"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/revision"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/revhistory"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/abstract"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="sect4.titlepage.verso"> +</xsl:template> + +<xsl:template name="sect4.titlepage.separator"> +</xsl:template> + +<xsl:template name="sect4.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="sect4.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="sect4.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="sect4.titlepage.before.recto"/> + <xsl:call-template name="sect4.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="sect4.titlepage.before.verso"/> + <xsl:call-template name="sect4.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="sect4.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="sect4.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="sect4.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style" margin-left="{$title.margin.left}" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="sect4.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="sect5.titlepage.recto"> + <xsl:choose> + <xsl:when test="sect5info/title"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sect5info/subtitle"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/corpauthor"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/authorgroup"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/author"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/othercredit"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/releaseinfo"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/copyright"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/legalnotice"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/pubdate"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/revision"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/revhistory"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/abstract"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="sect5.titlepage.verso"> +</xsl:template> + +<xsl:template name="sect5.titlepage.separator"> +</xsl:template> + +<xsl:template name="sect5.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="sect5.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="sect5.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="sect5.titlepage.before.recto"/> + <xsl:call-template name="sect5.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="sect5.titlepage.before.verso"/> + <xsl:call-template name="sect5.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="sect5.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="sect5.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="sect5.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style" margin-left="{$title.margin.left}" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="sect5.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="simplesect.titlepage.recto"> + <xsl:choose> + <xsl:when test="simplesectinfo/title"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="simplesectinfo/subtitle"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/corpauthor"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/authorgroup"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/author"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/othercredit"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/releaseinfo"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/copyright"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/legalnotice"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/pubdate"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/revision"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/revhistory"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/abstract"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="simplesect.titlepage.verso"> +</xsl:template> + +<xsl:template name="simplesect.titlepage.separator"> +</xsl:template> + +<xsl:template name="simplesect.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="simplesect.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="simplesect.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="simplesect.titlepage.before.recto"/> + <xsl:call-template name="simplesect.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="simplesect.titlepage.before.verso"/> + <xsl:call-template name="simplesect.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="simplesect.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="simplesect.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="simplesect.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style" margin-left="{$title.margin.left}" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="simplesect.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="bibliography.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="bibliography.titlepage.recto.style" margin-left="{$title.margin.left}" font-size="24.8832pt" font-family="{$title.fontset}" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::bibliography[1]"/> +</xsl:call-template></fo:block> + <xsl:choose> + <xsl:when test="bibliographyinfo/subtitle"> + <xsl:apply-templates mode="bibliography.titlepage.recto.auto.mode" select="bibliographyinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="bibliography.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="bibliography.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="bibliography.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="bibliography.titlepage.verso"> +</xsl:template> + +<xsl:template name="bibliography.titlepage.separator"> +</xsl:template> + +<xsl:template name="bibliography.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="bibliography.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="bibliography.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="bibliography.titlepage.before.recto"/> + <xsl:call-template name="bibliography.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="bibliography.titlepage.before.verso"/> + <xsl:call-template name="bibliography.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="bibliography.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="bibliography.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="bibliography.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="bibliography.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="bibliography.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="bibliography.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="bibliodiv.titlepage.recto"> + <xsl:choose> + <xsl:when test="bibliodivinfo/title"> + <xsl:apply-templates mode="bibliodiv.titlepage.recto.auto.mode" select="bibliodivinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="bibliodiv.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="bibliodiv.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="bibliodiv.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="bibliodivinfo/subtitle"> + <xsl:apply-templates mode="bibliodiv.titlepage.recto.auto.mode" select="bibliodivinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="bibliodiv.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="bibliodiv.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="bibliodiv.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="bibliodiv.titlepage.verso"> +</xsl:template> + +<xsl:template name="bibliodiv.titlepage.separator"> +</xsl:template> + +<xsl:template name="bibliodiv.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="bibliodiv.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="bibliodiv.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="bibliodiv.titlepage.before.recto"/> + <xsl:call-template name="bibliodiv.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="bibliodiv.titlepage.before.verso"/> + <xsl:call-template name="bibliodiv.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="bibliodiv.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="bibliodiv.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="bibliodiv.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="bibliodiv.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="bibliodiv.titlepage.recto.style" margin-left="{$title.margin.left}" font-size="20.736pt" font-family="{$title.fontset}" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::bibliodiv[1]"/> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="bibliodiv.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="bibliodiv.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="bibliodiv.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="glossary.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="glossary.titlepage.recto.style" margin-left="{$title.margin.left}" font-size="24.8832pt" font-family="{$title.fontset}" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::glossary[1]"/> +</xsl:call-template></fo:block> + <xsl:choose> + <xsl:when test="glossaryinfo/subtitle"> + <xsl:apply-templates mode="glossary.titlepage.recto.auto.mode" select="glossaryinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="glossary.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="glossary.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="glossary.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="glossary.titlepage.verso"> +</xsl:template> + +<xsl:template name="glossary.titlepage.separator"> +</xsl:template> + +<xsl:template name="glossary.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="glossary.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="glossary.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="glossary.titlepage.before.recto"/> + <xsl:call-template name="glossary.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="glossary.titlepage.before.verso"/> + <xsl:call-template name="glossary.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="glossary.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="glossary.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="glossary.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="glossary.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="glossary.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="glossary.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="glossdiv.titlepage.recto"> + <xsl:choose> + <xsl:when test="glossdivinfo/title"> + <xsl:apply-templates mode="glossdiv.titlepage.recto.auto.mode" select="glossdivinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="glossdiv.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="glossdiv.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="glossdiv.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="glossdivinfo/subtitle"> + <xsl:apply-templates mode="glossdiv.titlepage.recto.auto.mode" select="glossdivinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="glossdiv.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="glossdiv.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="glossdiv.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="glossdiv.titlepage.verso"> +</xsl:template> + +<xsl:template name="glossdiv.titlepage.separator"> +</xsl:template> + +<xsl:template name="glossdiv.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="glossdiv.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="glossdiv.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="glossdiv.titlepage.before.recto"/> + <xsl:call-template name="glossdiv.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="glossdiv.titlepage.before.verso"/> + <xsl:call-template name="glossdiv.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="glossdiv.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="glossdiv.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="glossdiv.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="glossdiv.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="glossdiv.titlepage.recto.style" margin-left="{$title.margin.left}" font-size="20.736pt" font-family="{$title.fontset}" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::glossdiv[1]"/> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="glossdiv.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="glossdiv.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="glossdiv.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="index.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="index.titlepage.recto.style" margin-left="0pt" font-size="24.8832pt" font-family="{$title.fontset}" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::index[1]"/> +<xsl:with-param name="pagewide" select="1"/> +</xsl:call-template></fo:block> + <xsl:choose> + <xsl:when test="indexinfo/subtitle"> + <xsl:apply-templates mode="index.titlepage.recto.auto.mode" select="indexinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="index.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="index.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="index.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="index.titlepage.verso"> +</xsl:template> + +<xsl:template name="index.titlepage.separator"> +</xsl:template> + +<xsl:template name="index.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="index.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="index.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="index.titlepage.before.recto"/> + <xsl:call-template name="index.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="index.titlepage.before.verso"/> + <xsl:call-template name="index.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="index.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="index.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="index.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="index.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="index.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="index.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="indexdiv.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="indexdiv.titlepage.recto.style"> +<xsl:call-template name="indexdiv.title"> +<xsl:with-param name="title" select="title"/> +</xsl:call-template></fo:block> + <xsl:choose> + <xsl:when test="indexdivinfo/subtitle"> + <xsl:apply-templates mode="indexdiv.titlepage.recto.auto.mode" select="indexdivinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="indexdiv.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="indexdiv.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="indexdiv.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="indexdiv.titlepage.verso"> +</xsl:template> + +<xsl:template name="indexdiv.titlepage.separator"> +</xsl:template> + +<xsl:template name="indexdiv.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="indexdiv.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="indexdiv.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="indexdiv.titlepage.before.recto"/> + <xsl:call-template name="indexdiv.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="indexdiv.titlepage.before.verso"/> + <xsl:call-template name="indexdiv.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="indexdiv.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="indexdiv.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="indexdiv.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="indexdiv.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="indexdiv.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="indexdiv.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="setindex.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="setindex.titlepage.recto.style" margin-left="0pt" font-size="24.8832pt" font-family="{$title.fontset}" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::setindex[1]"/> +<xsl:with-param name="pagewide" select="1"/> +</xsl:call-template></fo:block> + <xsl:choose> + <xsl:when test="setindexinfo/subtitle"> + <xsl:apply-templates mode="setindex.titlepage.recto.auto.mode" select="setindexinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="setindex.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="setindex.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="setindex.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="setindex.titlepage.verso"> +</xsl:template> + +<xsl:template name="setindex.titlepage.separator"> +</xsl:template> + +<xsl:template name="setindex.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="setindex.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="setindex.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="setindex.titlepage.before.recto"/> + <xsl:call-template name="setindex.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="setindex.titlepage.before.verso"/> + <xsl:call-template name="setindex.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="setindex.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="setindex.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="setindex.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="setindex.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="setindex.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="setindex.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="colophon.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="colophon.titlepage.recto.style" margin-left="{$title.margin.left}" font-size="24.8832pt" font-family="{$title.fontset}" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::colophon[1]"/> +</xsl:call-template></fo:block> + <xsl:choose> + <xsl:when test="colophoninfo/subtitle"> + <xsl:apply-templates mode="colophon.titlepage.recto.auto.mode" select="colophoninfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="colophon.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="colophon.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="colophon.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="colophon.titlepage.verso"> +</xsl:template> + +<xsl:template name="colophon.titlepage.separator"> +</xsl:template> + +<xsl:template name="colophon.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="colophon.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="colophon.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="colophon.titlepage.before.recto"/> + <xsl:call-template name="colophon.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="colophon.titlepage.before.verso"/> + <xsl:call-template name="colophon.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="colophon.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="colophon.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="colophon.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="colophon.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="colophon.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="colophon.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="sidebar.titlepage.recto"> + <xsl:choose> + <xsl:when test="sidebarinfo/title"> + <xsl:apply-templates mode="sidebar.titlepage.recto.auto.mode" select="sidebarinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="sidebar.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="sidebar.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="sidebar.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sidebarinfo/subtitle"> + <xsl:apply-templates mode="sidebar.titlepage.recto.auto.mode" select="sidebarinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="sidebar.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="sidebar.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="sidebar.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="sidebar.titlepage.verso"> +</xsl:template> + +<xsl:template name="sidebar.titlepage.separator"> +</xsl:template> + +<xsl:template name="sidebar.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="sidebar.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="sidebar.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="sidebar.titlepage.before.recto"/> + <xsl:call-template name="sidebar.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="sidebar.titlepage.before.verso"/> + <xsl:call-template name="sidebar.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="sidebar.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="sidebar.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="sidebar.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="sidebar.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sidebar.titlepage.recto.style" font-family="{$title.fontset}" font-weight="bold"> +<xsl:apply-templates select="." mode="sidebar.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="sidebar.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="sidebar.titlepage.recto.style" font-family="{$title.fontset}"> +<xsl:apply-templates select="." mode="sidebar.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="qandaset.titlepage.recto"> + <xsl:choose> + <xsl:when test="qandasetinfo/title"> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/title"/> + </xsl:when> + <xsl:when test="blockinfo/title"> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="qandasetinfo/subtitle"> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/subtitle"/> + </xsl:when> + <xsl:when test="blockinfo/subtitle"> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/corpauthor"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/corpauthor"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/authorgroup"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/authorgroup"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/author"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/author"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/othercredit"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/othercredit"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/releaseinfo"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/releaseinfo"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/copyright"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/copyright"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/legalnotice"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/legalnotice"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/pubdate"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/pubdate"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/revision"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/revision"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/revhistory"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/revhistory"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="qandasetinfo/abstract"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="blockinfo/abstract"/> + <xsl:apply-templates mode="qandaset.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="qandaset.titlepage.verso"> +</xsl:template> + +<xsl:template name="qandaset.titlepage.separator"> +</xsl:template> + +<xsl:template name="qandaset.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="qandaset.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="qandaset.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" font-family="{$title.fontset}"> + <xsl:variable name="recto.content"> + <xsl:call-template name="qandaset.titlepage.before.recto"/> + <xsl:call-template name="qandaset.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block start-indent="0pt" text-align="center"><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="qandaset.titlepage.before.verso"/> + <xsl:call-template name="qandaset.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="qandaset.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="qandaset.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="qandaset.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" keep-with-next.within-column="always" font-size="24.8832pt" font-weight="bold"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::qandaset[1]"/> +</xsl:call-template> +</fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="corpauthor" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" space-before="0.5em" font-size="14.4pt"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="authorgroup" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" space-before="0.5em" font-size="14.4pt"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="author" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" space-before="0.5em" font-size="14.4pt"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="othercredit" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="releaseinfo" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="copyright" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="legalnotice" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" text-align="start" margin-left="0.5in" margin-right="0.5in" font-family="{$body.fontset}"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="pubdate" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revision" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="revhistory" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" space-before="0.5em"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template match="abstract" mode="qandaset.titlepage.recto.auto.mode"> +<fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="qandaset.titlepage.recto.style" space-before="0.5em" text-align="start" margin-left="0.5in" margin-right="0.5in" font-family="{$body.fontset}"> +<xsl:apply-templates select="." mode="qandaset.titlepage.recto.mode"/> +</fo:block> +</xsl:template> + +<xsl:template name="table.of.contents.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="table.of.contents.titlepage.recto.style" space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="{$title.margin.left}" start-indent="0pt" font-size="17.28pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="gentext"> +<xsl:with-param name="key" select="'TableofContents'"/> +</xsl:call-template></fo:block> +</xsl:template> + +<xsl:template name="table.of.contents.titlepage.verso"> +</xsl:template> + +<xsl:template name="table.of.contents.titlepage.separator"> +</xsl:template> + +<xsl:template name="table.of.contents.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="table.of.contents.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="table.of.contents.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="table.of.contents.titlepage.before.recto"/> + <xsl:call-template name="table.of.contents.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="table.of.contents.titlepage.before.verso"/> + <xsl:call-template name="table.of.contents.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="table.of.contents.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="table.of.contents.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="table.of.contents.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template name="list.of.tables.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="list.of.tables.titlepage.recto.style" space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="{$title.margin.left}" start-indent="0pt" font-size="17.28pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="gentext"> +<xsl:with-param name="key" select="'ListofTables'"/> +</xsl:call-template></fo:block> +</xsl:template> + +<xsl:template name="list.of.tables.titlepage.verso"> +</xsl:template> + +<xsl:template name="list.of.tables.titlepage.separator"> +</xsl:template> + +<xsl:template name="list.of.tables.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="list.of.tables.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="list.of.tables.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="list.of.tables.titlepage.before.recto"/> + <xsl:call-template name="list.of.tables.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="list.of.tables.titlepage.before.verso"/> + <xsl:call-template name="list.of.tables.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="list.of.tables.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="list.of.tables.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="list.of.tables.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template name="list.of.figures.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="list.of.figures.titlepage.recto.style" space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="{$title.margin.left}" start-indent="0pt" font-size="17.28pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="gentext"> +<xsl:with-param name="key" select="'ListofFigures'"/> +</xsl:call-template></fo:block> +</xsl:template> + +<xsl:template name="list.of.figures.titlepage.verso"> +</xsl:template> + +<xsl:template name="list.of.figures.titlepage.separator"> +</xsl:template> + +<xsl:template name="list.of.figures.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="list.of.figures.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="list.of.figures.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="list.of.figures.titlepage.before.recto"/> + <xsl:call-template name="list.of.figures.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="list.of.figures.titlepage.before.verso"/> + <xsl:call-template name="list.of.figures.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="list.of.figures.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="list.of.figures.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="list.of.figures.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template name="list.of.examples.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="list.of.examples.titlepage.recto.style" space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="{$title.margin.left}" start-indent="0pt" font-size="17.28pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="gentext"> +<xsl:with-param name="key" select="'ListofExamples'"/> +</xsl:call-template></fo:block> +</xsl:template> + +<xsl:template name="list.of.examples.titlepage.verso"> +</xsl:template> + +<xsl:template name="list.of.examples.titlepage.separator"> +</xsl:template> + +<xsl:template name="list.of.examples.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="list.of.examples.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="list.of.examples.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="list.of.examples.titlepage.before.recto"/> + <xsl:call-template name="list.of.examples.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="list.of.examples.titlepage.before.verso"/> + <xsl:call-template name="list.of.examples.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="list.of.examples.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="list.of.examples.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="list.of.examples.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template name="list.of.equations.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="list.of.equations.titlepage.recto.style" space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="{$title.margin.left}" start-indent="0pt" font-size="17.28pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="gentext"> +<xsl:with-param name="key" select="'ListofEquations'"/> +</xsl:call-template></fo:block> +</xsl:template> + +<xsl:template name="list.of.equations.titlepage.verso"> +</xsl:template> + +<xsl:template name="list.of.equations.titlepage.separator"> +</xsl:template> + +<xsl:template name="list.of.equations.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="list.of.equations.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="list.of.equations.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="list.of.equations.titlepage.before.recto"/> + <xsl:call-template name="list.of.equations.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="list.of.equations.titlepage.before.verso"/> + <xsl:call-template name="list.of.equations.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="list.of.equations.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="list.of.equations.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="list.of.equations.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template name="list.of.procedures.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="list.of.procedures.titlepage.recto.style" space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="{$title.margin.left}" start-indent="0pt" font-size="17.28pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="gentext"> +<xsl:with-param name="key" select="'ListofProcedures'"/> +</xsl:call-template></fo:block> +</xsl:template> + +<xsl:template name="list.of.procedures.titlepage.verso"> +</xsl:template> + +<xsl:template name="list.of.procedures.titlepage.separator"> +</xsl:template> + +<xsl:template name="list.of.procedures.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="list.of.procedures.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="list.of.procedures.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="list.of.procedures.titlepage.before.recto"/> + <xsl:call-template name="list.of.procedures.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="list.of.procedures.titlepage.before.verso"/> + <xsl:call-template name="list.of.procedures.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="list.of.procedures.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="list.of.procedures.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="list.of.procedures.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template name="list.of.unknowns.titlepage.recto"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" xsl:use-attribute-sets="list.of.unknowns.titlepage.recto.style" space-before.minimum="1em" space-before.optimum="1.5em" space-before.maximum="2em" space-after="0.5em" margin-left="{$title.margin.left}" start-indent="0pt" font-size="17.28pt" font-weight="bold" font-family="{$title.fontset}"> +<xsl:call-template name="gentext"> +<xsl:with-param name="key" select="'ListofUnknown'"/> +</xsl:call-template></fo:block> +</xsl:template> + +<xsl:template name="list.of.unknowns.titlepage.verso"> +</xsl:template> + +<xsl:template name="list.of.unknowns.titlepage.separator"> +</xsl:template> + +<xsl:template name="list.of.unknowns.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="list.of.unknowns.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="list.of.unknowns.titlepage"> + <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format"> + <xsl:variable name="recto.content"> + <xsl:call-template name="list.of.unknowns.titlepage.before.recto"/> + <xsl:call-template name="list.of.unknowns.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <fo:block><xsl:copy-of select="$recto.content"/></fo:block> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="list.of.unknowns.titlepage.before.verso"/> + <xsl:call-template name="list.of.unknowns.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <fo:block><xsl:copy-of select="$verso.content"/></fo:block> + </xsl:if> + <xsl:call-template name="list.of.unknowns.titlepage.separator"/> + </fo:block> +</xsl:template> + +<xsl:template match="*" mode="list.of.unknowns.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="list.of.unknowns.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +</xsl:stylesheet> \ No newline at end of file diff --git a/src/documentation/docbook-xsl/fo/titlepage.xsl b/src/documentation/docbook-xsl/fo/titlepage.xsl new file mode 100644 index 0000000000..7579853a19 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/titlepage.xsl @@ -0,0 +1,743 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:fo="http://www.w3.org/1999/XSL/Format" + version='1.0'> + +<!-- ******************************************************************** + $Id: titlepage.xsl,v 1.41 2006/05/21 13:05:19 kosek Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:attribute-set name="book.titlepage.recto.style"> + <xsl:attribute name="font-family"> + <xsl:value-of select="$title.fontset"/> + </xsl:attribute> + <xsl:attribute name="font-weight">bold</xsl:attribute> + <xsl:attribute name="font-size">12pt</xsl:attribute> + <xsl:attribute name="text-align">center</xsl:attribute> +</xsl:attribute-set> + +<xsl:attribute-set name="book.titlepage.verso.style"> + <xsl:attribute name="font-size">10pt</xsl:attribute> +</xsl:attribute-set> + +<xsl:attribute-set name="article.titlepage.recto.style"/> +<xsl:attribute-set name="article.titlepage.verso.style"/> + +<xsl:attribute-set name="set.titlepage.recto.style"/> +<xsl:attribute-set name="set.titlepage.verso.style"/> + +<xsl:attribute-set name="part.titlepage.recto.style"> + <xsl:attribute name="text-align">center</xsl:attribute> +</xsl:attribute-set> + +<xsl:attribute-set name="part.titlepage.verso.style"/> + +<xsl:attribute-set name="partintro.titlepage.recto.style"/> +<xsl:attribute-set name="partintro.titlepage.verso.style"/> + +<xsl:attribute-set name="reference.titlepage.recto.style"/> +<xsl:attribute-set name="reference.titlepage.verso.style"/> + +<xsl:attribute-set name="dedication.titlepage.recto.style"/> +<xsl:attribute-set name="dedication.titlepage.verso.style"/> + +<xsl:attribute-set name="preface.titlepage.recto.style"/> +<xsl:attribute-set name="preface.titlepage.verso.style"/> + +<xsl:attribute-set name="chapter.titlepage.recto.style"/> +<xsl:attribute-set name="chapter.titlepage.verso.style"/> + +<xsl:attribute-set name="appendix.titlepage.recto.style"/> +<xsl:attribute-set name="appendix.titlepage.verso.style"/> + +<xsl:attribute-set name="bibliography.titlepage.recto.style"/> +<xsl:attribute-set name="bibliography.titlepage.verso.style"/> + +<xsl:attribute-set name="bibliodiv.titlepage.recto.style"/> +<xsl:attribute-set name="bibliodiv.titlepage.verso.style"/> + +<xsl:attribute-set name="glossary.titlepage.recto.style"/> +<xsl:attribute-set name="glossary.titlepage.verso.style"/> + +<xsl:attribute-set name="glossdiv.titlepage.recto.style"/> +<xsl:attribute-set name="glossdiv.titlepage.verso.style"/> + +<xsl:attribute-set name="index.titlepage.recto.style"/> +<xsl:attribute-set name="index.titlepage.verso.style"/> + +<xsl:attribute-set name="setindex.titlepage.recto.style"/> +<xsl:attribute-set name="setindex.titlepage.verso.style"/> + +<xsl:attribute-set name="indexdiv.titlepage.recto.style"/> +<xsl:attribute-set name="indexdiv.titlepage.verso.style"/> + +<xsl:attribute-set name="colophon.titlepage.recto.style"/> +<xsl:attribute-set name="colophon.titlepage.verso.style"/> + +<xsl:attribute-set name="sidebar.titlepage.recto.style"/> +<xsl:attribute-set name="sidebar.titlepage.verso.style"/> + +<xsl:attribute-set name="qandaset.titlepage.recto.style"/> +<xsl:attribute-set name="qandaset.titlepage.verso.style"/> + +<xsl:attribute-set name="section.titlepage.recto.style"> + <xsl:attribute name="keep-together.within-column">always</xsl:attribute> +</xsl:attribute-set> + +<xsl:attribute-set name="section.titlepage.verso.style"> + <xsl:attribute name="keep-together.within-column">always</xsl:attribute> + <xsl:attribute name="keep-with-next.within-column">always</xsl:attribute> +</xsl:attribute-set> + +<xsl:attribute-set name="sect1.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="sect1.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="sect2.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="sect2.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="sect3.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="sect3.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="sect4.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="sect4.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="sect5.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="sect5.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="simplesect.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="simplesect.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="refnamediv.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="refnamediv.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="refsynopsisdiv.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="refsynopsisdiv.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="refsection.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="refsection.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="refsect1.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="refsect1.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="refsect2.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="refsect2.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="refsect3.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="refsect3.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="table.of.contents.titlepage.recto.style"/> +<xsl:attribute-set name="table.of.contents.titlepage.verso.style"/> + +<xsl:attribute-set name="list.of.tables.titlepage.recto.style"/> +<xsl:attribute-set name="list.of.tables.contents.titlepage.verso.style"/> + +<xsl:attribute-set name="list.of.figures.titlepage.recto.style"/> +<xsl:attribute-set name="list.of.figures.contents.titlepage.verso.style"/> + +<xsl:attribute-set name="list.of.equations.titlepage.recto.style"/> +<xsl:attribute-set name="list.of.equations.contents.titlepage.verso.style"/> + +<xsl:attribute-set name="list.of.examples.titlepage.recto.style"/> +<xsl:attribute-set name="list.of.examples.contents.titlepage.verso.style"/> + +<xsl:attribute-set name="list.of.procedures.titlepage.recto.style"/> +<xsl:attribute-set name="list.of.procedures.contents.titlepage.verso.style"/> + +<xsl:attribute-set name="list.of.unknowns.titlepage.recto.style"/> +<xsl:attribute-set name="list.of.unknowns.contents.titlepage.verso.style"/> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="titlepage.mode"> + <!-- if an element isn't found in this mode, try the default mode --> + <xsl:apply-templates select="."/> +</xsl:template> + +<xsl:template match="abbrev" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="abstract" mode="titlepage.mode"> + <fo:block> + <xsl:call-template name="formal.object.heading"> + <xsl:with-param name="title"> + <xsl:apply-templates select="." mode="title.markup"/> + </xsl:with-param> + </xsl:call-template> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:block> +</xsl:template> + +<xsl:template match="abstract/title" mode="titlepage.mode"/> + +<xsl:template match="abstract/title" mode="titlepage.abstract.title.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="address" mode="titlepage.mode"> + <!-- use the normal address handling code --> + <xsl:apply-templates select="."/> +</xsl:template> + +<xsl:template match="affiliation" mode="titlepage.mode"> + <fo:block> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:block> +</xsl:template> + +<xsl:template match="artpagenums" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="author" mode="titlepage.mode"> + <fo:block> + <xsl:call-template name="anchor"/> + <xsl:call-template name="person.name"/> + <xsl:if test="affiliation/orgname"> + <xsl:text>, </xsl:text> + <xsl:apply-templates select="affiliation/orgname" mode="titlepage.mode"/> + </xsl:if> + <xsl:if test="email|affiliation/address/email"> + <xsl:text> </xsl:text> + <xsl:apply-templates select="(email|affiliation/address/email)[1]"/> + </xsl:if> + </fo:block> +</xsl:template> + +<xsl:template match="authorblurb" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="authorgroup" mode="titlepage.mode"> + <fo:wrapper> + <xsl:if test="@id"> + <xsl:attribute name="id"><xsl:value-of select="@id"/></xsl:attribute> + </xsl:if> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:wrapper> +</xsl:template> + +<xsl:template match="authorinitials" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="bibliomisc" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="bibliomset" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="collab" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="confgroup" mode="titlepage.mode"> + <fo:block> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:block> +</xsl:template> + +<xsl:template match="confdates" mode="titlepage.mode"> + <fo:block> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:block> +</xsl:template> + +<xsl:template match="conftitle" mode="titlepage.mode"> + <fo:block> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:block> +</xsl:template> + +<xsl:template match="confnum" mode="titlepage.mode"> + <!-- suppress --> +</xsl:template> + +<xsl:template match="contractnum" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="contractsponsor" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="contrib" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="copyright" mode="titlepage.mode"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'Copyright'"/> + </xsl:call-template> + <xsl:call-template name="gentext.space"/> + <xsl:call-template name="dingbat"> + <xsl:with-param name="dingbat">copyright</xsl:with-param> + </xsl:call-template> + <xsl:call-template name="gentext.space"/> + <xsl:call-template name="copyright.years"> + <xsl:with-param name="years" select="year"/> + <xsl:with-param name="print.ranges" select="$make.year.ranges"/> + <xsl:with-param name="single.year.ranges" + select="$make.single.year.ranges"/> + </xsl:call-template> + <xsl:call-template name="gentext.space"/> + <xsl:apply-templates select="holder" mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="year" mode="titlepage.mode"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="holder" mode="titlepage.mode"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="corpauthor" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="corpcredit" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="corpname" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="date" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="edition" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> + <xsl:call-template name="gentext.space"/> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'Edition'"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="editor" mode="titlepage.mode"> + <!-- The first editor is dealt with in the following template, + which in turn displays all editors of the same mode. --> +</xsl:template> + +<xsl:template match="editor[1]" priority="2" mode="titlepage.mode"> + <xsl:call-template name="gentext.edited.by"/> + <xsl:call-template name="gentext.space"/> + <xsl:call-template name="person.name.list"> + <xsl:with-param name="person.list" select="../editor"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="firstname" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="graphic" mode="titlepage.mode"> + <!-- use the normal graphic handling code --> + <xsl:apply-templates select="."/> +</xsl:template> + +<xsl:template match="honorific" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="isbn" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="issn" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="biblioid" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="itermset" mode="titlepage.mode"> + <!-- discard --> +</xsl:template> + +<xsl:template match="invpartnumber" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="issuenum" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="jobtitle" mode="titlepage.mode"> + <fo:block> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:block> +</xsl:template> + +<xsl:template match="keywordset" mode="titlepage.mode"> +</xsl:template> + +<xsl:template match="legalnotice" mode="titlepage.mode"> + + <xsl:variable name="id"> + <xsl:call-template name="object.id"/> + </xsl:variable> + + <fo:block id="{$id}"> + <xsl:if test="title"> <!-- FIXME: add param for using default title? --> + <xsl:call-template name="formal.object.heading"/> + </xsl:if> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:block> +</xsl:template> + +<xsl:template match="legalnotice/title" mode="titlepage.mode"> +</xsl:template> + +<xsl:template match="lineage" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="modespec" mode="titlepage.mode"> + <!-- discard --> +</xsl:template> + +<xsl:template match="orgdiv" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="orgname" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="othercredit" mode="titlepage.mode"> + <xsl:variable name="contrib" select="string(contrib)"/> + <xsl:choose> + <xsl:when test="contrib"> + <xsl:if test="not(preceding-sibling::othercredit[string(contrib)=$contrib])"> + <fo:block> + <xsl:apply-templates mode="titlepage.mode" select="contrib"/> + <xsl:text>: </xsl:text> + <xsl:call-template name="person.name"/> + <xsl:apply-templates mode="titlepage.mode" select="affiliation"/> + <xsl:apply-templates select="following-sibling::othercredit[string(contrib)=$contrib]" mode="titlepage.othercredits"/> + </fo:block> + </xsl:if> + </xsl:when> + <xsl:otherwise> + <fo:block><xsl:call-template name="person.name"/></fo:block> + <xsl:apply-templates mode="titlepage.mode" select="./affiliation"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="othercredit" mode="titlepage.othercredits"> + <xsl:text>, </xsl:text> + <xsl:call-template name="person.name"/> +</xsl:template> + +<xsl:template match="othername" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="pagenums" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="printhistory" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="productname" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="productnumber" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="pubdate" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="publisher" mode="titlepage.mode"> + <fo:block> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:block> +</xsl:template> + +<xsl:template match="publishername" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="pubsnumber" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="releaseinfo" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="revhistory" mode="titlepage.mode"> + + <xsl:variable name="explicit.table.width"> + <xsl:call-template name="dbfo-attribute"> + <xsl:with-param name="pis" + select="processing-instruction('dbfo')"/> + <xsl:with-param name="attribute" select="'table-width'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="table.width"> + <xsl:choose> + <xsl:when test="$explicit.table.width != ''"> + <xsl:value-of select="$explicit.table.width"/> + </xsl:when> + <xsl:when test="$default.table.width = ''"> + <xsl:text>100%</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$default.table.width"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <fo:table table-layout="fixed" width="{$table.width}" xsl:use-attribute-sets="revhistory.table.properties"> + <fo:table-column column-number="1" column-width="proportional-column-width(1)"/> + <fo:table-column column-number="2" column-width="proportional-column-width(1)"/> + <fo:table-column column-number="3" column-width="proportional-column-width(1)"/> + <fo:table-body start-indent="0pt" end-indent="0pt"> + <fo:table-row> + <fo:table-cell number-columns-spanned="3" xsl:use-attribute-sets="revhistory.table.cell.properties"> + <fo:block xsl:use-attribute-sets="revhistory.title.properties"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'RevHistory'"/> + </xsl:call-template> + </fo:block> + </fo:table-cell> + </fo:table-row> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:table-body> + </fo:table> +</xsl:template> + +<xsl:template match="revhistory/revision" mode="titlepage.mode"> + <xsl:variable name="revnumber" select="revnumber"/> + <xsl:variable name="revdate" select="date"/> + <xsl:variable name="revauthor" select="authorinitials|author"/> + <xsl:variable name="revremark" select="revremark|revdescription"/> + <fo:table-row> + <fo:table-cell xsl:use-attribute-sets="revhistory.table.cell.properties"> + <fo:block> + <xsl:if test="$revnumber"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'Revision'"/> + </xsl:call-template> + <xsl:call-template name="gentext.space"/> + <xsl:apply-templates select="$revnumber[1]" mode="titlepage.mode"/> + </xsl:if> + </fo:block> + </fo:table-cell> + <fo:table-cell xsl:use-attribute-sets="revhistory.table.cell.properties"> + <fo:block> + <xsl:apply-templates select="$revdate[1]" mode="titlepage.mode"/> + </fo:block> + </fo:table-cell> + <fo:table-cell xsl:use-attribute-sets="revhistory.table.cell.properties"> + <fo:block> + <xsl:for-each select="$revauthor"> + <xsl:apply-templates select="." mode="titlepage.mode"/> + <xsl:if test="position() != last()"> + <xsl:text>, </xsl:text> + </xsl:if> + </xsl:for-each> + </fo:block> + </fo:table-cell> + </fo:table-row> + <xsl:if test="$revremark"> + <fo:table-row> + <fo:table-cell number-columns-spanned="3" xsl:use-attribute-sets="revhistory.table.cell.properties"> + <fo:block> + <xsl:apply-templates select="$revremark[1]" mode="titlepage.mode"/> + </fo:block> + </fo:table-cell> + </fo:table-row> + </xsl:if> +</xsl:template> + +<xsl:template match="revision/revnumber" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="revision/date" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="revision/authorinitials" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="revision/author" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="revision/revremark" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="revision/revdescription" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="seriesvolnums" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="shortaffil" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subjectset" mode="titlepage.mode"> + <!-- discard --> +</xsl:template> + +<xsl:template match="subtitle" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="surname" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="titleabbrev" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="volumenum" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<!-- ==================================================================== --> +<!-- Book templates --> + +<!-- Note: these templates cannot use *.titlepage.recto.mode or + *.titlepage.verso.mode. If they do then subsequent use of a custom + titlepage.templates.xml file will not work correctly. --> + +<!-- book recto --> + +<xsl:template match="bookinfo/authorgroup|info/authorgroup" + mode="titlepage.mode" priority="2"> + <fo:block> + <xsl:if test="@id"> + <xsl:attribute name="id"><xsl:value-of select="@id"/></xsl:attribute> + </xsl:if> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:block> +</xsl:template> + +<!-- book verso --> + +<xsl:template name="book.verso.title"> + <fo:block> + <xsl:apply-templates mode="titlepage.mode"/> + + <xsl:if test="following-sibling::subtitle + |following-sibling::info/subtitle + |following-sibling::bookinfo/subtitle"> + <xsl:text>: </xsl:text> + + <xsl:apply-templates select="(following-sibling::subtitle + |following-sibling::info/subtitle + |following-sibling::bookinfo/subtitle)[1]" + mode="book.verso.subtitle.mode"/> + </xsl:if> + </fo:block> +</xsl:template> + +<xsl:template match="subtitle" mode="book.verso.subtitle.mode"> + <xsl:apply-templates mode="titlepage.mode"/> + <xsl:if test="following-sibling::subtitle"> + <xsl:text>: </xsl:text> + <xsl:apply-templates select="following-sibling::subtitle[1]" + mode="book.verso.subtitle.mode"/> + </xsl:if> +</xsl:template> + +<xsl:template name="verso.authorgroup"> + <fo:block> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'by'"/> + </xsl:call-template> + <xsl:text> </xsl:text> + <xsl:call-template name="person.name.list"> + <xsl:with-param name="person.list" select="author|corpauthor|editor"/> + </xsl:call-template> + </fo:block> + <xsl:apply-templates select="othercredit" mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="bookinfo/author|info/author" + mode="titlepage.mode" priority="2"> + <fo:block> + <xsl:call-template name="person.name"/> + </fo:block> +</xsl:template> + +<xsl:template match="bookinfo/corpauthor|info/corpauthor" + mode="titlepage.mode" priority="2"> + <fo:block> + <xsl:apply-templates/> + </fo:block> +</xsl:template> + +<xsl:template match="bookinfo/pubdate|info/pubdate" + mode="titlepage.mode" priority="2"> + <fo:block> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'published'"/> + </xsl:call-template> + <xsl:text> </xsl:text> + <xsl:apply-templates mode="titlepage.mode"/> + </fo:block> +</xsl:template> + +<!-- ==================================================================== --> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/fo/toc.xsl b/src/documentation/docbook-xsl/fo/toc.xsl new file mode 100644 index 0000000000..38ca8f721c --- /dev/null +++ b/src/documentation/docbook-xsl/fo/toc.xsl @@ -0,0 +1,280 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:fo="http://www.w3.org/1999/XSL/Format" + version='1.0'> + +<!-- ******************************************************************** + $Id: toc.xsl,v 1.11 2005/01/18 08:20:24 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<!-- FIXME: in the contexts where <toc> can occur, I think it's always + the case that a page-sequence is required. Is that true? --> + +<xsl:template match="toc"> + <xsl:variable name="master-reference"> + <xsl:call-template name="select.pagemaster"/> + </xsl:variable> + + <xsl:choose> + <xsl:when test="*"> + <xsl:if test="$process.source.toc != 0"> + <!-- if the toc isn't empty, process it --> + <fo:page-sequence hyphenate="{$hyphenate}" + master-reference="{$master-reference}"> + <xsl:attribute name="language"> + <xsl:call-template name="l10n.language"/> + </xsl:attribute> + <xsl:attribute name="format"> + <xsl:call-template name="page.number.format"> + <xsl:with-param name="element" select="'toc'"/> + <xsl:with-param name="master-reference" + select="$master-reference"/> + </xsl:call-template> + </xsl:attribute> + + <xsl:attribute name="initial-page-number"> + <xsl:call-template name="initial.page.number"> + <xsl:with-param name="element" select="'toc'"/> + <xsl:with-param name="master-reference" + select="$master-reference"/> + </xsl:call-template> + </xsl:attribute> + + <xsl:attribute name="force-page-count"> + <xsl:call-template name="force.page.count"> + <xsl:with-param name="master-reference" + select="$master-reference"/> + </xsl:call-template> + </xsl:attribute> + + <xsl:attribute name="hyphenation-character"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'hyphenation-character'"/> + </xsl:call-template> + </xsl:attribute> + <xsl:attribute name="hyphenation-push-character-count"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'hyphenation-push-character-count'"/> + </xsl:call-template> + </xsl:attribute> + <xsl:attribute name="hyphenation-remain-character-count"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'hyphenation-remain-character-count'"/> + </xsl:call-template> + </xsl:attribute> + + <xsl:apply-templates select="." mode="running.head.mode"> + <xsl:with-param name="master-reference" select="$master-reference"/> + </xsl:apply-templates> + <xsl:apply-templates select="." mode="running.foot.mode"> + <xsl:with-param name="master-reference" select="$master-reference"/> + </xsl:apply-templates> + + <fo:flow flow-name="xsl-region-body"> + <xsl:call-template name="set.flow.properties"> + <xsl:with-param name="element" select="local-name(.)"/> + <xsl:with-param name="master-reference" + select="$master-reference"/> + </xsl:call-template> + + <fo:block xsl:use-attribute-sets="toc.margin.properties"> + <xsl:call-template name="table.of.contents.titlepage"/> + <xsl:apply-templates/> + </fo:block> + </fo:flow> + </fo:page-sequence> + </xsl:if> + </xsl:when> + <xsl:otherwise> + <xsl:if test="$process.empty.source.toc != 0"> + <fo:page-sequence hyphenate="{$hyphenate}" + master-reference="{$master-reference}"> + <xsl:attribute name="language"> + <xsl:call-template name="l10n.language"/> + </xsl:attribute> + <xsl:attribute name="format"> + <xsl:call-template name="page.number.format"> + <xsl:with-param name="element" select="'toc'"/> + <xsl:with-param name="master-reference" + select="$master-reference"/> + </xsl:call-template> + </xsl:attribute> + + <xsl:attribute name="initial-page-number"> + <xsl:call-template name="initial.page.number"> + <xsl:with-param name="element" select="'toc'"/> + <xsl:with-param name="master-reference" + select="$master-reference"/> + </xsl:call-template> + </xsl:attribute> + + <xsl:attribute name="hyphenation-character"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'hyphenation-character'"/> + </xsl:call-template> + </xsl:attribute> + <xsl:attribute name="hyphenation-push-character-count"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'hyphenation-push-character-count'"/> + </xsl:call-template> + </xsl:attribute> + <xsl:attribute name="hyphenation-remain-character-count"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'hyphenation-remain-character-count'"/> + </xsl:call-template> + </xsl:attribute> + + <xsl:apply-templates select="." mode="running.head.mode"> + <xsl:with-param name="master-reference" select="$master-reference"/> + </xsl:apply-templates> + <xsl:apply-templates select="." mode="running.foot.mode"> + <xsl:with-param name="master-reference" select="$master-reference"/> + </xsl:apply-templates> + + <fo:flow flow-name="xsl-region-body"> + <xsl:choose> + <xsl:when test="parent::section + or parent::sect1 + or parent::sect2 + or parent::sect3 + or parent::sect4 + or parent::sect5"> + <xsl:apply-templates select="parent::*" + mode="toc.for.section"/> + </xsl:when> + <xsl:when test="parent::article"> + <xsl:apply-templates select="parent::*" + mode="toc.for.component"/> + </xsl:when> + <xsl:when test="parent::book + or parent::part"> + <xsl:apply-templates select="parent::*" + mode="toc.for.division"/> + </xsl:when> + <xsl:when test="parent::set"> + <xsl:apply-templates select="parent::*" + mode="toc.for.set"/> + </xsl:when> + <!-- there aren't any other contexts that allow toc --> + <xsl:otherwise> + <xsl:message> + <xsl:text>I don't know how to make a TOC in this context!</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> + </fo:flow> + </fo:page-sequence> + </xsl:if> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="tocpart|tocchap + |toclevel1|toclevel2|toclevel3|toclevel4|toclevel5"> + <xsl:apply-templates select="tocentry"/> + <xsl:if test="tocchap|toclevel1|toclevel2|toclevel3|toclevel4|toclevel5"> + <fo:block start-indent="{count(ancestor::*)*2}pc"> + <xsl:apply-templates select="tocchap|toclevel1|toclevel2|toclevel3|toclevel4|toclevel5"/> + </fo:block> + </xsl:if> +</xsl:template> + +<xsl:template match="tocentry|tocfront|tocback"> + <fo:block text-align-last="justify" + end-indent="2pc" + last-line-end-indent="-2pc"> + <fo:inline keep-with-next.within-line="always"> + <xsl:choose> + <xsl:when test="@linkend"> + <fo:basic-link internal-destination="{@linkend}"> + <xsl:apply-templates/> + </fo:basic-link> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> + </fo:inline> + + <xsl:choose> + <xsl:when test="@linkend"> + <fo:inline keep-together.within-line="always"> + <xsl:text> </xsl:text> + <fo:leader leader-pattern="dots" + keep-with-next.within-line="always"/> + <xsl:text> </xsl:text> + <fo:basic-link internal-destination="{@linkend}"> + <xsl:choose> + <xsl:when test="@pagenum"> + <xsl:value-of select="@pagenum"/> + </xsl:when> + <xsl:otherwise> + <fo:page-number-citation ref-id="{@linkend}"/> + </xsl:otherwise> + </xsl:choose> + </fo:basic-link> + </fo:inline> + </xsl:when> + <xsl:when test="@pagenum"> + <fo:inline keep-together.within-line="always"> + <xsl:text> </xsl:text> + <fo:leader leader-pattern="dots" + keep-with-next.within-line="always"/> + <xsl:text> </xsl:text> + <xsl:value-of select="@pagenum"/> + </fo:inline> + </xsl:when> + <xsl:otherwise> + <!-- just the leaders, what else can I do? --> + <fo:inline keep-together.within-line="always"> + <xsl:text> </xsl:text> + <fo:leader leader-pattern="space" + keep-with-next.within-line="always"/> + </fo:inline> + </xsl:otherwise> + </xsl:choose> + </fo:block> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="toc.for.section"> +<!-- + <xsl:call-template name="section.toc"/> +--> +</xsl:template> + +<xsl:template match="*" mode="toc.for.component"> + <xsl:call-template name="component.toc"/> +</xsl:template> + +<xsl:template match="*" mode="toc.for.section"> +<!-- + <xsl:call-template name="section.toc"/> +--> +</xsl:template> + +<xsl:template match="*" mode="toc.for.division"> + <xsl:call-template name="division.toc"/> +</xsl:template> + +<xsl:template match="*" mode="toc.for.set"> +<!-- + <xsl:call-template name="set.toc"/> +--> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="lot|lotentry"> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/fo/verbatim.xsl b/src/documentation/docbook-xsl/fo/verbatim.xsl new file mode 100644 index 0000000000..6a7887a7c3 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/verbatim.xsl @@ -0,0 +1,419 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:fo="http://www.w3.org/1999/XSL/Format" + xmlns:sverb="http://nwalsh.com/xslt/ext/com.nwalsh.saxon.Verbatim" + xmlns:xverb="com.nwalsh.xalan.Verbatim" + xmlns:lxslt="http://xml.apache.org/xslt" + xmlns:exsl="http://exslt.org/common" + exclude-result-prefixes="sverb xverb lxslt exsl" + version='1.0'> + +<!-- ******************************************************************** + $Id: verbatim.xsl,v 1.19 2005/11/20 01:39:49 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<lxslt:component prefix="xverb" + functions="numberLines"/> + +<xsl:template match="programlisting|screen|synopsis"> + <xsl:param name="suppress-numbers" select="'0'"/> + <xsl:variable name="id"><xsl:call-template name="object.id"/></xsl:variable> + + <xsl:variable name="content"> + <xsl:choose> + <xsl:when test="$suppress-numbers = '0' + and @linenumbering = 'numbered' + and $use.extensions != '0' + and $linenumbering.extension != '0'"> + <xsl:call-template name="number.rtf.lines"> + <xsl:with-param name="rtf"> + <xsl:apply-templates/> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$shade.verbatim != 0"> + <fo:block id="{$id}" + white-space-collapse='false' + white-space-treatment='preserve' + linefeed-treatment='preserve' + xsl:use-attribute-sets="monospace.verbatim.properties shade.verbatim.style"> + <xsl:choose> + <xsl:when test="$hyphenate.verbatim != 0 and function-available('exsl:node-set')"> + <xsl:apply-templates select="exsl:node-set($content)" mode="hyphenate.verbatim"/> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$content"/> + </xsl:otherwise> + </xsl:choose> + </fo:block> + </xsl:when> + <xsl:otherwise> + <fo:block id="{$id}" + white-space-collapse='false' + white-space-treatment='preserve' + linefeed-treatment="preserve" + xsl:use-attribute-sets="monospace.verbatim.properties"> + <xsl:choose> + <xsl:when test="$hyphenate.verbatim != 0 and function-available('exsl:node-set')"> + <xsl:apply-templates select="exsl:node-set($content)" mode="hyphenate.verbatim"/> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$content"/> + </xsl:otherwise> + </xsl:choose> + </fo:block> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="literallayout"> + <xsl:param name="suppress-numbers" select="'0'"/> + + <xsl:variable name="id"><xsl:call-template name="object.id"/></xsl:variable> + + <xsl:variable name="content"> + <xsl:choose> + <xsl:when test="$suppress-numbers = '0' + and @linenumbering = 'numbered' + and $use.extensions != '0' + and $linenumbering.extension != '0'"> + <xsl:call-template name="number.rtf.lines"> + <xsl:with-param name="rtf"> + <xsl:apply-templates/> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="@class='monospaced'"> + <xsl:choose> + <xsl:when test="$shade.verbatim != 0"> + <fo:block id="{$id}" + white-space-collapse='false' + white-space-treatment='preserve' + linefeed-treatment="preserve" + xsl:use-attribute-sets="monospace.verbatim.properties shade.verbatim.style"> + + <xsl:copy-of select="$content"/> + </fo:block> + </xsl:when> + <xsl:otherwise> + <fo:block id="{$id}" + white-space-collapse='false' + white-space-treatment='preserve' + linefeed-treatment="preserve" + xsl:use-attribute-sets="monospace.verbatim.properties"> + <xsl:copy-of select="$content"/> + </fo:block> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="$shade.verbatim != 0"> + <fo:block id="{$id}" + wrap-option='no-wrap' + white-space-collapse='false' + white-space-treatment='preserve' + text-align='start' + linefeed-treatment="preserve" + xsl:use-attribute-sets="verbatim.properties shade.verbatim.style"> + <xsl:copy-of select="$content"/> + </fo:block> + </xsl:when> + <xsl:otherwise> + <fo:block id="{$id}" + wrap-option='no-wrap' + white-space-collapse='false' + white-space-treatment='preserve' + text-align='start' + linefeed-treatment="preserve" + xsl:use-attribute-sets="verbatim.properties"> + <xsl:copy-of select="$content"/> + </fo:block> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="address"> + <xsl:param name="suppress-numbers" select="'0'"/> + + <xsl:variable name="content"> + <xsl:choose> + <xsl:when test="$suppress-numbers = '0' + and @linenumbering = 'numbered' + and $use.extensions != '0' + and $linenumbering.extension != '0'"> + <xsl:call-template name="number.rtf.lines"> + <xsl:with-param name="rtf"> + <xsl:apply-templates/> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <fo:block wrap-option='no-wrap' + white-space-collapse='false' + white-space-treatment='preserve' + linefeed-treatment="preserve" + xsl:use-attribute-sets="verbatim.properties"> + <xsl:copy-of select="$content"/> + </fo:block> +</xsl:template> + +<xsl:template name="number.rtf.lines"> + <xsl:param name="rtf" select="''"/> + <xsl:param name="pi.context" select="."/> + + <!-- Save the global values --> + <xsl:variable name="global.linenumbering.everyNth" + select="$linenumbering.everyNth"/> + + <xsl:variable name="global.linenumbering.separator" + select="$linenumbering.separator"/> + + <xsl:variable name="global.linenumbering.width" + select="$linenumbering.width"/> + + <!-- Extract the <?dbfo linenumbering.*?> PI values --> + <xsl:variable name="pi.linenumbering.everyNth"> + <xsl:call-template name="dbfo-attribute"> + <xsl:with-param name="pis" + select="$pi.context/processing-instruction('dbfo')"/> + <xsl:with-param name="attribute" select="'linenumbering.everyNth'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="pi.linenumbering.separator"> + <xsl:call-template name="dbfo-attribute"> + <xsl:with-param name="pis" + select="$pi.context/processing-instruction('dbfo')"/> + <xsl:with-param name="attribute" select="'linenumbering.separator'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="pi.linenumbering.width"> + <xsl:call-template name="dbfo-attribute"> + <xsl:with-param name="pis" + select="$pi.context/processing-instruction('dbfo')"/> + <xsl:with-param name="attribute" select="'linenumbering.width'"/> + </xsl:call-template> + </xsl:variable> + + <!-- Construct the 'in-context' values --> + <xsl:variable name="linenumbering.everyNth"> + <xsl:choose> + <xsl:when test="$pi.linenumbering.everyNth != ''"> + <xsl:value-of select="$pi.linenumbering.everyNth"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$global.linenumbering.everyNth"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="linenumbering.separator"> + <xsl:choose> + <xsl:when test="$pi.linenumbering.separator != ''"> + <xsl:value-of select="$pi.linenumbering.separator"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$global.linenumbering.separator"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="linenumbering.width"> + <xsl:choose> + <xsl:when test="$pi.linenumbering.width != ''"> + <xsl:value-of select="$pi.linenumbering.width"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$global.linenumbering.width"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="linenumbering.startinglinenumber"> + <xsl:choose> + <xsl:when test="$pi.context/@startinglinenumber"> + <xsl:value-of select="$pi.context/@startinglinenumber"/> + </xsl:when> + <xsl:when test="$pi.context/@continuation='continues'"> + <xsl:variable name="lastLine"> + <xsl:choose> + <xsl:when test="$pi.context/self::programlisting"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" + select="preceding::programlisting[@linenumbering='numbered']"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$pi.context/self::screen"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" + select="preceding::screen[@linenumbering='numbered']"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$pi.context/self::literallayout"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" + select="preceding::literallayout[@linenumbering='numbered']"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$pi.context/self::address"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" + select="preceding::address[@linenumbering='numbered']"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$pi.context/self::synopsis"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" + select="preceding::synopsis[@linenumbering='numbered']"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>Unexpected verbatim environment: </xsl:text> + <xsl:value-of select="local-name(.)"/> + </xsl:message> + <xsl:value-of select="0"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:value-of select="$lastLine + 1"/> + </xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="function-available('sverb:numberLines')"> + <xsl:copy-of select="sverb:numberLines($rtf)"/> + </xsl:when> + <xsl:when test="function-available('xverb:numberLines')"> + <xsl:copy-of select="xverb:numberLines($rtf)"/> + </xsl:when> + <xsl:otherwise> + <xsl:message terminate="yes"> + <xsl:text>No numberLines function available.</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ======================================================================== --> + +<xsl:template name="lastLineNumber"> + <xsl:param name="listings"/> + <xsl:param name="number" select="0"/> + + <xsl:variable name="lines"> + <xsl:call-template name="countLines"> + <xsl:with-param name="listing" select="string($listings[1])"/> + </xsl:call-template> + </xsl:variable> + + <xsl:choose> + <xsl:when test="not($listings)"> + <xsl:value-of select="$number"/> + </xsl:when> + <xsl:when test="$listings[1]/@startinglinenumber"> + <xsl:value-of select="$number + $listings[1]/@startinglinenumber + $lines - 1"/> + </xsl:when> + <xsl:when test="$listings[1]/@continuation='continues'"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" select="listings[position() > 1]"/> + <xsl:with-param name="number" select="$number + $lines"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$lines"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="countLines"> + <xsl:param name="listing"/> + <xsl:param name="count" select="1"/> + + <xsl:choose> + <xsl:when test="contains($listing, ' ')"> + <xsl:call-template name="countLines"> + <xsl:with-param name="listing" select="substring-after($listing, ' ')"/> + <xsl:with-param name="count" select="$count + 1"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$count"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ======================================================================== --> + +<xsl:template match="node()|@*" mode="hyphenate.verbatim"> + <xsl:copy> + <xsl:apply-templates select="node()|@*" mode="hyphenate.verbatim"/> + </xsl:copy> +</xsl:template> + +<xsl:template match="text()" mode="hyphenate.verbatim" priority="2"> + <xsl:call-template name="hyphenate.verbatim"> + <xsl:with-param name="content" select="."/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="hyphenate.verbatim"> + <xsl:param name="content"/> + <xsl:variable name="head" select="substring($content, 1, 1)"/> + <xsl:variable name="tail" select="substring($content, 2)"/> + <xsl:choose> + <!-- Place soft-hyphen after space or non-breakable space. --> + <xsl:when test="$head = ' ' or $head = ' '"> + <xsl:text> </xsl:text> + <xsl:text>­</xsl:text> + </xsl:when> + <xsl:when test="$hyphenate.verbatim.characters != '' and + translate($head, $hyphenate.verbatim.characters, '') = '' and not($tail = '')"> + <xsl:value-of select="$head"/> + <xsl:text>­</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$head"/> + </xsl:otherwise> + </xsl:choose> + <xsl:if test="$tail"> + <xsl:call-template name="hyphenate.verbatim"> + <xsl:with-param name="content" select="$tail"/> + </xsl:call-template> + </xsl:if> +</xsl:template> + + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/fo/xep.xsl b/src/documentation/docbook-xsl/fo/xep.xsl new file mode 100644 index 0000000000..36a6b7d389 --- /dev/null +++ b/src/documentation/docbook-xsl/fo/xep.xsl @@ -0,0 +1,177 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:fo="http://www.w3.org/1999/XSL/Format" + xmlns:rx="http://www.renderx.com/XSL/Extensions" + version='1.0'> + +<!-- ******************************************************************** + $Id: xep.xsl,v 1.24 2005/11/20 19:30:41 bobstayton Exp $ + ******************************************************************** + (c) Stephane Bline Peregrine Systems 2001 + Implementation of xep extensions: + * Pdf bookmarks (based on the XEP 2.5 implementation) + * Document information (XEP 2.5 meta information extensions) + ******************************************************************** --> + +<!-- FIXME: Norm, I changed things so that the top-level element (book or set) + does not appear in the TOC. Is this the right thing? --> + +<xsl:template name="xep-document-information"> + <rx:meta-info> + <xsl:variable name="authors" select="(//author|//editor|//corpauthor|//authorgroup)[1]"/> + <xsl:if test="$authors"> + <xsl:variable name="author"> + <xsl:choose> + <xsl:when test="$authors[self::authorgroup]"> + <xsl:call-template name="person.name.list"> + <xsl:with-param name="person.list" + select="$authors/*[self::author|self::corpauthor| + self::othercredit|self::editor]"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$authors[self::corpauthor]"> + <xsl:value-of select="$authors"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="person.name"> + <xsl:with-param name="node" select="$authors"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:element name="rx:meta-field"> + <xsl:attribute name="name">author</xsl:attribute> + <xsl:attribute name="value"> + <xsl:value-of select="normalize-space($author)"/> + </xsl:attribute> + </xsl:element> + </xsl:if> + + <xsl:variable name="title"> + <xsl:apply-templates select="/*[1]" mode="label.markup"/> + <xsl:apply-templates select="/*[1]" mode="title.markup"/> + </xsl:variable> + + <xsl:element name="rx:meta-field"> + <xsl:attribute name="name">creator</xsl:attribute> + <xsl:attribute name="value"> + <xsl:text>DocBook XSL Stylesheets V</xsl:text> + <xsl:value-of select="$VERSION"/> + </xsl:attribute> + </xsl:element> + + <xsl:element name="rx:meta-field"> + <xsl:attribute name="name">title</xsl:attribute> + <xsl:attribute name="value"> + <xsl:value-of select="normalize-space($title)"/> + </xsl:attribute> + </xsl:element> + + <xsl:if test="//keyword"> + <xsl:element name="rx:meta-field"> + <xsl:attribute name="name">keywords</xsl:attribute> + <xsl:attribute name="value"> + <xsl:for-each select="//keyword"> + <xsl:value-of select="normalize-space(.)"/> + <xsl:if test="position() != last()"> + <xsl:text>, </xsl:text> + </xsl:if> + </xsl:for-each> + </xsl:attribute> + </xsl:element> + </xsl:if> + + <xsl:if test="//subjectterm"> + <xsl:element name="rx:meta-field"> + <xsl:attribute name="name">subject</xsl:attribute> + <xsl:attribute name="value"> + <xsl:for-each select="//subjectterm"> + <xsl:value-of select="normalize-space(.)"/> + <xsl:if test="position() != last()"> + <xsl:text>, </xsl:text> + </xsl:if> + </xsl:for-each> + </xsl:attribute> + </xsl:element> + </xsl:if> + </rx:meta-info> +</xsl:template> + +<!-- ******************************************************************** + Pdf bookmarks + ******************************************************************** --> + +<xsl:template match="*" mode="xep.outline"> + <xsl:apply-templates select="*" mode="xep.outline"/> +</xsl:template> + +<xsl:template match="set|book|part|reference|preface|chapter|appendix|article + |glossary|bibliography|index|setindex + |refentry|refsynopsisdiv + |refsect1|refsect2|refsect3|refsection + |sect1|sect2|sect3|sect4|sect5|section" + mode="xep.outline"> + <xsl:variable name="id"> + <xsl:call-template name="object.id"/> + </xsl:variable> + <xsl:variable name="bookmark-label"> + <xsl:apply-templates select="." mode="object.title.markup"/> + </xsl:variable> + + <!-- Put the root element bookmark at the same level as its children --> + <!-- If the object is a set or book, generate a bookmark for the toc --> + + <xsl:choose> + <xsl:when test="parent::*"> + <rx:bookmark internal-destination="{$id}"> + <rx:bookmark-label> + <xsl:value-of select="normalize-space($bookmark-label)"/> + </rx:bookmark-label> + <xsl:apply-templates select="*" mode="xep.outline"/> + </rx:bookmark> + </xsl:when> + <xsl:otherwise> + <xsl:if test="$bookmark-label != ''"> + <rx:bookmark internal-destination="{$id}"> + <rx:bookmark-label> + <xsl:value-of select="normalize-space($bookmark-label)"/> + </rx:bookmark-label> + </rx:bookmark> + </xsl:if> + + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + <xsl:if test="contains($toc.params, 'toc') + and set|book|part|reference|section|sect1|refentry + |article|bibliography|glossary|chapter + |appendix"> + <rx:bookmark internal-destination="toc...{$id}"> + <rx:bookmark-label> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'TableofContents'"/> + </xsl:call-template> + </rx:bookmark-label> + </rx:bookmark> + </xsl:if> + <xsl:apply-templates select="*" mode="xep.outline"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="xep-pis"> + <xsl:if test="$crop.marks != 0"> + <xsl:processing-instruction name="xep-pdf-crop-mark-width"><xsl:value-of select="$crop.mark.width"/></xsl:processing-instruction> + <xsl:processing-instruction name="xep-pdf-crop-offset"><xsl:value-of select="$crop.mark.offset"/></xsl:processing-instruction> + <xsl:processing-instruction name="xep-pdf-bleed"><xsl:value-of select="$crop.mark.bleed"/></xsl:processing-instruction> + </xsl:if> + + <xsl:call-template name="user-xep-pis"/> +</xsl:template> + +<!-- Placeholder for user defined PIs --> +<xsl:template name="user-xep-pis"/> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/fo/xref.xsl b/src/documentation/docbook-xsl/fo/xref.xsl new file mode 100644 index 0000000000..22b669c9aa --- /dev/null +++ b/src/documentation/docbook-xsl/fo/xref.xsl @@ -0,0 +1,1366 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:fo="http://www.w3.org/1999/XSL/Format" + xmlns:exsl="http://exslt.org/common" + exclude-result-prefixes="exsl" + version='1.0'> + +<!-- ******************************************************************** + $Id: xref.xsl,v 1.67 2006/05/08 05:24:01 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:template match="anchor"> + <fo:inline id="{@id}"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="xref" name="xref"> + <xsl:variable name="targets" select="key('id',@linkend)"/> + <xsl:variable name="target" select="$targets[1]"/> + <xsl:variable name="refelem" select="local-name($target)"/> + + <xsl:call-template name="check.id.unique"> + <xsl:with-param name="linkend" select="@linkend"/> + </xsl:call-template> + + <xsl:variable name="xrefstyle"> + <xsl:choose> + <xsl:when test="@role and not(@xrefstyle) + and $use.role.as.xrefstyle != 0"> + <xsl:value-of select="@role"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@xrefstyle"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$refelem=''"> + <xsl:message> + <xsl:text>XRef to nonexistent id: </xsl:text> + <xsl:value-of select="@linkend"/> + </xsl:message> + <xsl:text>???</xsl:text> + </xsl:when> + + <xsl:when test="@endterm"> + <fo:basic-link internal-destination="{@linkend}" + xsl:use-attribute-sets="xref.properties"> + <xsl:variable name="etargets" select="key('id',@endterm)"/> + <xsl:variable name="etarget" select="$etargets[1]"/> + <xsl:choose> + <xsl:when test="count($etarget) = 0"> + <xsl:message> + <xsl:value-of select="count($etargets)"/> + <xsl:text>Endterm points to nonexistent ID: </xsl:text> + <xsl:value-of select="@endterm"/> + </xsl:message> + <xsl:text>???</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$etarget" mode="endterm"/> + </xsl:otherwise> + </xsl:choose> + </fo:basic-link> + </xsl:when> + + <xsl:when test="$target/@xreflabel"> + <fo:basic-link internal-destination="{@linkend}" + xsl:use-attribute-sets="xref.properties"> + <xsl:call-template name="xref.xreflabel"> + <xsl:with-param name="target" select="$target"/> + </xsl:call-template> + </fo:basic-link> + </xsl:when> + + <xsl:otherwise> + <xsl:if test="not(parent::citation)"> + <xsl:apply-templates select="$target" mode="xref-to-prefix"/> + </xsl:if> + + <fo:basic-link internal-destination="{@linkend}" + xsl:use-attribute-sets="xref.properties"> + <xsl:apply-templates select="$target" mode="xref-to"> + <xsl:with-param name="referrer" select="."/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + </xsl:apply-templates> + </fo:basic-link> + + <xsl:if test="not(parent::citation)"> + <xsl:apply-templates select="$target" mode="xref-to-suffix"/> + </xsl:if> + + </xsl:otherwise> + </xsl:choose> + + <!-- Add standard page reference? --> + <xsl:choose> + <!-- negative xrefstyle in instance turns it off --> + <xsl:when test="starts-with(normalize-space($xrefstyle), 'select:') + and contains($xrefstyle, 'nopage')"> + </xsl:when> + <!-- positive xrefstyle already handles it --> + <xsl:when test="not(starts-with(normalize-space($xrefstyle), 'select:') + and (contains($xrefstyle, 'page') + or contains($xrefstyle, 'Page'))) + and ( $insert.xref.page.number = 'yes' + or $insert.xref.page.number = '1') + or local-name($target) = 'para'"> + <xsl:apply-templates select="$target" mode="page.citation"> + <xsl:with-param name="id" select="@linkend"/> + </xsl:apply-templates> + </xsl:when> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<!-- Handled largely like an xref --> +<!-- To be done: add support for begin, end, and units attributes --> +<xsl:template match="biblioref" name="biblioref"> + <xsl:variable name="targets" select="key('id',@linkend)"/> + <xsl:variable name="target" select="$targets[1]"/> + <xsl:variable name="refelem" select="local-name($target)"/> + + <xsl:call-template name="check.id.unique"> + <xsl:with-param name="linkend" select="@linkend"/> + </xsl:call-template> + + <xsl:choose> + <xsl:when test="$refelem=''"> + <xsl:message> + <xsl:text>XRef to nonexistent id: </xsl:text> + <xsl:value-of select="@linkend"/> + </xsl:message> + <xsl:text>???</xsl:text> + </xsl:when> + + <xsl:when test="@endterm"> + <fo:basic-link internal-destination="{@linkend}" + xsl:use-attribute-sets="xref.properties"> + <xsl:variable name="etargets" select="key('id',@endterm)"/> + <xsl:variable name="etarget" select="$etargets[1]"/> + <xsl:choose> + <xsl:when test="count($etarget) = 0"> + <xsl:message> + <xsl:value-of select="count($etargets)"/> + <xsl:text>Endterm points to nonexistent ID: </xsl:text> + <xsl:value-of select="@endterm"/> + </xsl:message> + <xsl:text>???</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$etarget" mode="endterm"/> + </xsl:otherwise> + </xsl:choose> + </fo:basic-link> + </xsl:when> + + <xsl:when test="$target/@xreflabel"> + <fo:basic-link internal-destination="{@linkend}" + xsl:use-attribute-sets="xref.properties"> + <xsl:call-template name="xref.xreflabel"> + <xsl:with-param name="target" select="$target"/> + </xsl:call-template> + </fo:basic-link> + </xsl:when> + + <xsl:otherwise> + <xsl:if test="not(parent::citation)"> + <xsl:apply-templates select="$target" mode="xref-to-prefix"/> + </xsl:if> + + <fo:basic-link internal-destination="{@linkend}" + xsl:use-attribute-sets="xref.properties"> + <xsl:apply-templates select="$target" mode="xref-to"> + <xsl:with-param name="referrer" select="."/> + <xsl:with-param name="xrefstyle"> + <xsl:choose> + <xsl:when test="@role and not(@xrefstyle) and $use.role.as.xrefstyle != 0"> + <xsl:value-of select="@role"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@xrefstyle"/> + </xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:apply-templates> + </fo:basic-link> + + <xsl:if test="not(parent::citation)"> + <xsl:apply-templates select="$target" mode="xref-to-suffix"/> + </xsl:if> + </xsl:otherwise> + </xsl:choose> + +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="endterm"> + <!-- Process the children of the endterm element --> + <xsl:variable name="endterm"> + <xsl:apply-templates select="child::node()"/> + </xsl:variable> + + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"> + <xsl:apply-templates select="exsl:node-set($endterm)" mode="remove-ids"/> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$endterm"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="*" mode="remove-ids"> + <xsl:copy> + <xsl:for-each select="@*"> + <xsl:choose> + <xsl:when test="name(.) != 'id'"> + <xsl:copy/> + </xsl:when> + <xsl:otherwise> + <xsl:message>removing <xsl:value-of select="name(.)"/></xsl:message> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> + <xsl:apply-templates mode="remove-ids"/> + </xsl:copy> +</xsl:template> + +<!--- ==================================================================== --> + +<xsl:template match="*" mode="xref-to-prefix"/> +<xsl:template match="*" mode="xref-to-suffix"/> + +<xsl:template match="*" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + + <xsl:if test="$verbose != 0"> + <xsl:message> + <xsl:text>Don't know what gentext to create for xref to: "</xsl:text> + <xsl:value-of select="name(.)"/> + <xsl:text>"</xsl:text> + </xsl:message> + <xsl:text>???</xsl:text> + </xsl:if> +</xsl:template> + +<xsl:template match="title" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <!-- if you xref to a title, xref to the parent... --> + <xsl:choose> + <!-- FIXME: how reliable is this? --> + <xsl:when test="contains(local-name(parent::*), 'info')"> + <xsl:apply-templates select="parent::*[2]" mode="xref-to"> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="parent::*" mode="xref-to"> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="abstract|article|authorblurb|bibliodiv|bibliomset + |biblioset|blockquote|calloutlist|caution|colophon + |constraintdef|formalpara|glossdiv|important|indexdiv + |itemizedlist|legalnotice|lot|msg|msgexplan|msgmain + |msgrel|msgset|msgsub|note|orderedlist|partintro + |productionset|qandadiv|refsynopsisdiv|segmentedlist + |set|setindex|sidebar|tip|toc|variablelist|warning" + mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <!-- catch-all for things with (possibly optional) titles --> + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="author|editor|othercredit|personname" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:call-template name="person.name"/> +</xsl:template> + +<xsl:template match="authorgroup" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:call-template name="person.name.list"/> +</xsl:template> + +<xsl:template match="figure|example|table|equation" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="procedure" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="task" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="cmdsynopsis" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="(.//command)[1]" mode="xref"/> +</xsl:template> + +<xsl:template match="funcsynopsis" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="(.//function)[1]" mode="xref"/> +</xsl:template> + +<xsl:template match="dedication|preface|chapter|appendix" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="bibliography" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="biblioentry|bibliomixed" mode="xref-to-prefix"> + <xsl:text>[</xsl:text> +</xsl:template> + +<xsl:template match="biblioentry|bibliomixed" mode="xref-to-suffix"> + <xsl:text>]</xsl:text> +</xsl:template> + +<xsl:template match="biblioentry|bibliomixed" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <!-- handles both biblioentry and bibliomixed --> + <xsl:choose> + <xsl:when test="string(.) = ''"> + <xsl:variable name="bib" select="document($bibliography.collection,.)"/> + <xsl:variable name="id" select="@id"/> + <xsl:variable name="entry" select="$bib/bibliography/*[@id=$id][1]"/> + <xsl:choose> + <xsl:when test="$entry"> + <xsl:choose> + <xsl:when test="$bibliography.numbered != 0"> + <xsl:number from="bibliography" count="biblioentry|bibliomixed" + level="any" format="1"/> + </xsl:when> + <xsl:when test="local-name($entry/*[1]) = 'abbrev'"> + <xsl:apply-templates select="$entry/*[1]"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@id"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>No bibliography entry: </xsl:text> + <xsl:value-of select="$id"/> + <xsl:text> found in </xsl:text> + <xsl:value-of select="$bibliography.collection"/> + </xsl:message> + <xsl:value-of select="@id"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="$bibliography.numbered != 0"> + <xsl:number from="bibliography" count="biblioentry|bibliomixed" + level="any" format="1"/> + </xsl:when> + <xsl:when test="local-name(*[1]) = 'abbrev'"> + <xsl:apply-templates select="*[1]"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@id"/> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="glossary" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="glossentry" mode="xref-to"> + <xsl:choose> + <xsl:when test="$glossentry.show.acronym = 'primary'"> + <xsl:choose> + <xsl:when test="acronym|abbrev"> + <xsl:apply-templates select="(acronym|abbrev)[1]"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="glossterm[1]" mode="xref-to"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="glossterm[1]" mode="xref-to"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="glossterm" mode="xref-to"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="index" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="listitem" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="section|simplesect + |sect1|sect2|sect3|sect4|sect5 + |refsect1|refsect2|refsect3|refsection" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> + <!-- What about "in Chapter X"? --> +</xsl:template> + +<xsl:template match="bridgehead" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> + <!-- What about "in Chapter X"? --> +</xsl:template> + +<xsl:template match="qandaset" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="qandadiv" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="qandaentry" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="question[1]" mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="question|answer" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="part|reference" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="refentry" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:choose> + <xsl:when test="refmeta/refentrytitle"> + <xsl:apply-templates select="refmeta/refentrytitle"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="refnamediv/refname[1]"/> + </xsl:otherwise> + </xsl:choose> + <xsl:apply-templates select="refmeta/manvolnum"/> +</xsl:template> + +<xsl:template match="refnamediv" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="refname[1]" mode="xref-to"> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="refname" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates mode="xref-to"> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="step" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'Step'"/> + </xsl:call-template> + <xsl:text> </xsl:text> + <xsl:apply-templates select="." mode="number"/> +</xsl:template> + +<xsl:template match="varlistentry" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="term[1]" mode="xref-to"> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="varlistentry/term" mode="xref-to"> + <xsl:param name="verbose" select="1"/> + <!-- to avoid the comma that will be generated if there are several terms --> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="co" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="callout-bug"/> +</xsl:template> + +<xsl:template match="book" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="para" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose"/> + + <xsl:variable name="context" select="(ancestor::simplesect + |ancestor::section + |ancestor::sect1 + |ancestor::sect2 + |ancestor::sect3 + |ancestor::sect4 + |ancestor::sect5 + |ancestor::refsection + |ancestor::refsect1 + |ancestor::refsect2 + |ancestor::refsect3 + |ancestor::chapter + |ancestor::appendix + |ancestor::preface + |ancestor::partintro + |ancestor::dedication + |ancestor::colophon + |ancestor::bibliography + |ancestor::index + |ancestor::glossary + |ancestor::glossentry + |ancestor::listitem + |ancestor::varlistentry)[last()]"/> + + <xsl:apply-templates select="$context" mode="xref-to"> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="link" name="link"> + <xsl:variable name="targets" select="key('id',@linkend)"/> + <xsl:variable name="target" select="$targets[1]"/> + + <xsl:call-template name="check.id.unique"> + <xsl:with-param name="linkend" select="@linkend"/> + </xsl:call-template> + + <xsl:variable name="xrefstyle"> + <xsl:choose> + <xsl:when test="@role and not(@xrefstyle) + and $use.role.as.xrefstyle != 0"> + <xsl:value-of select="@role"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@xrefstyle"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <fo:basic-link internal-destination="{@linkend}" + xsl:use-attribute-sets="xref.properties"> + <xsl:choose> + <xsl:when test="count(child::node()) > 0"> + <!-- If it has content, use it --> + <xsl:apply-templates/> + </xsl:when> + <xsl:otherwise> + <!-- else look for an endterm --> + <xsl:choose> + <xsl:when test="@endterm"> + <xsl:variable name="etargets" select="key('id',@endterm)"/> + <xsl:variable name="etarget" select="$etargets[1]"/> + <xsl:choose> + <xsl:when test="count($etarget) = 0"> + <xsl:message> + <xsl:value-of select="count($etargets)"/> + <xsl:text>Endterm points to nonexistent ID: </xsl:text> + <xsl:value-of select="@endterm"/> + </xsl:message> + <xsl:text>???</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$etarget" mode="endterm"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + + <xsl:otherwise> + <xsl:message> + <xsl:text>Link element has no content and no Endterm. </xsl:text> + <xsl:text>Nothing to show in the link to </xsl:text> + <xsl:value-of select="$target"/> + </xsl:message> + <xsl:text>???</xsl:text> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </fo:basic-link> + + <!-- Add standard page reference? --> + <xsl:choose> + <!-- negative xrefstyle in instance turns it off --> + <xsl:when test="starts-with(normalize-space($xrefstyle), 'select:') + and contains($xrefstyle, 'nopage')"> + </xsl:when> + <xsl:when test="(starts-with(normalize-space($xrefstyle), 'select:') + and $insert.link.page.number = 'maybe' + and (contains($xrefstyle, 'page') + or contains($xrefstyle, 'Page'))) + or ( $insert.link.page.number = 'yes' + or $insert.link.page.number = '1') + or local-name($target) = 'para'"> + <xsl:apply-templates select="$target" mode="page.citation"> + <xsl:with-param name="id" select="@linkend"/> + </xsl:apply-templates> + </xsl:when> + </xsl:choose> +</xsl:template> + +<xsl:template match="ulink" name="ulink"> + <xsl:variable name ="ulink.url"> + <xsl:call-template name="fo-external-image"> + <xsl:with-param name="filename" select="@url"/> + </xsl:call-template> + </xsl:variable> + + <fo:basic-link xsl:use-attribute-sets="xref.properties" + external-destination="{$ulink.url}"> + <xsl:choose> + <xsl:when test="count(child::node())=0"> + <xsl:call-template name="hyphenate-url"> + <xsl:with-param name="url" select="@url"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> + </fo:basic-link> + + <xsl:if test="count(child::node()) != 0 + and string(.) != @url + and $ulink.show != 0"> + <!-- yes, show the URI --> + <xsl:choose> + <xsl:when test="$ulink.footnotes != 0 and not(ancestor::footnote)"> + <fo:footnote> + <xsl:call-template name="ulink.footnote.number"/> + <fo:footnote-body xsl:use-attribute-sets="footnote.properties"> + <fo:block> + <xsl:call-template name="ulink.footnote.number"/> + <xsl:text> </xsl:text> + <fo:basic-link external-destination="{$ulink.url}"> + <xsl:value-of select="@url"/> + </fo:basic-link> + </fo:block> + </fo:footnote-body> + </fo:footnote> + </xsl:when> + <xsl:otherwise> + <fo:inline hyphenate="false"> + <xsl:text> [</xsl:text> + <fo:basic-link external-destination="{$ulink.url}"> + <xsl:call-template name="hyphenate-url"> + <xsl:with-param name="url" select="@url"/> + </xsl:call-template> + </fo:basic-link> + <xsl:text>]</xsl:text> + </fo:inline> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + +</xsl:template> + +<xsl:template name="ulink.footnote.number"> + <fo:inline xsl:use-attribute-sets="footnote.mark.properties"> + <xsl:choose> + <xsl:when test="$fop.extensions != 0"> + <xsl:attribute name="vertical-align">super</xsl:attribute> + </xsl:when> + <xsl:otherwise> + <xsl:attribute name="baseline-shift">super</xsl:attribute> + </xsl:otherwise> + </xsl:choose> + <xsl:variable name="fnum"> + <!-- FIXME: list in @from is probably not complete --> + <xsl:number level="any" + from="chapter|appendix|preface|article|refentry|bibliography[not(parent::article)]" + count="footnote[not(@label)][not(ancestor::tgroup)]|ulink[node()][@url != .][not(ancestor::footnote)]" + format="1"/> + </xsl:variable> + <xsl:choose> + <xsl:when test="string-length($footnote.number.symbols) >= $fnum"> + <xsl:value-of select="substring($footnote.number.symbols, $fnum, 1)"/> + </xsl:when> + <xsl:otherwise> + <xsl:number value="$fnum" format="{$footnote.number.format}"/> + </xsl:otherwise> + </xsl:choose> + </fo:inline> +</xsl:template> + +<xsl:template name="hyphenate-url"> + <xsl:param name="url" select="''"/> + <xsl:choose> + <xsl:when test="$ulink.hyphenate = ''"> + <xsl:value-of select="$url"/> + </xsl:when> + <xsl:when test="string-length($url) > 1"> + <xsl:variable name="char" select="substring($url, 1, 1)"/> + <xsl:value-of select="$char"/> + <xsl:if test="contains($ulink.hyphenate.chars, $char)"> + <!-- Do not hyphen in-between // --> + <xsl:if test="not($char = '/' and substring($url,2,1) = '/')"> + <xsl:copy-of select="$ulink.hyphenate"/> + </xsl:if> + </xsl:if> + <!-- recurse to the next character --> + <xsl:call-template name="hyphenate-url"> + <xsl:with-param name="url" select="substring($url, 2)"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$url"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="olink" name="olink"> + <xsl:call-template name="anchor"/> + + <xsl:variable name="localinfo" select="@localinfo"/> + + <xsl:choose> + <!-- olinks resolved by stylesheet and target database --> + <xsl:when test="@targetdoc or @targetptr" > + <xsl:variable name="targetdoc.att" select="@targetdoc"/> + <xsl:variable name="targetptr.att" select="@targetptr"/> + + <xsl:variable name="olink.lang"> + <xsl:call-template name="l10n.language"> + <xsl:with-param name="xref-context" select="true()"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="target.database.filename"> + <xsl:call-template name="select.target.database"> + <xsl:with-param name="targetdoc.att" select="$targetdoc.att"/> + <xsl:with-param name="targetptr.att" select="$targetptr.att"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="target.database" + select="document($target.database.filename, /)"/> + + <xsl:if test="$olink.debug != 0"> + <xsl:message> + <xsl:text>Olink debug: root element of target.database is '</xsl:text> + <xsl:value-of select="local-name($target.database/*[1])"/> + <xsl:text>'.</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:variable name="olink.key"> + <xsl:call-template name="select.olink.key"> + <xsl:with-param name="targetdoc.att" select="$targetdoc.att"/> + <xsl:with-param name="targetptr.att" select="$targetptr.att"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + <xsl:with-param name="target.database" select="$target.database"/> + </xsl:call-template> + </xsl:variable> + + <xsl:if test="string-length($olink.key) = 0"> + <xsl:message> + <xsl:text>Error: unresolved olink: </xsl:text> + <xsl:text>targetdoc/targetptr = '</xsl:text> + <xsl:value-of select="$targetdoc.att"/> + <xsl:text>/</xsl:text> + <xsl:value-of select="$targetptr.att"/> + <xsl:text>'.</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:variable name="href"> + <xsl:call-template name="make.olink.href"> + <xsl:with-param name="olink.key" select="$olink.key"/> + <xsl:with-param name="target.database" select="$target.database"/> + </xsl:call-template> + </xsl:variable> + + <!-- Olink that points to internal id can be a link --> + <xsl:variable name="linkend"> + <xsl:call-template name="olink.as.linkend"> + <xsl:with-param name="olink.key" select="$olink.key"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + <xsl:with-param name="target.database" select="$target.database"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="hottext"> + <xsl:call-template name="olink.hottext"> + <xsl:with-param name="olink.key" select="$olink.key"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + <xsl:with-param name="target.database" select="$target.database"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="olink.docname.citation"> + <xsl:call-template name="olink.document.citation"> + <xsl:with-param name="olink.key" select="$olink.key"/> + <xsl:with-param name="target.database" select="$target.database"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="olink.page.citation"> + <xsl:call-template name="olink.page.citation"> + <xsl:with-param name="olink.key" select="$olink.key"/> + <xsl:with-param name="target.database" select="$target.database"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + <xsl:with-param name="linkend" select="$linkend"/> + </xsl:call-template> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$linkend != ''"> + <fo:basic-link internal-destination="{$linkend}" + xsl:use-attribute-sets="xref.properties"> + <xsl:copy-of select="$hottext"/> + <xsl:copy-of select="$olink.page.citation"/> + </fo:basic-link> + </xsl:when> + <xsl:when test="$href != ''"> + <xsl:choose> + <xsl:when test="$xep.extensions != 0"> + <fo:basic-link external-destination="url({$href})" + xsl:use-attribute-sets="olink.properties"> + <xsl:copy-of select="$hottext"/> + </fo:basic-link> + <xsl:copy-of select="$olink.page.citation"/> + <xsl:copy-of select="$olink.docname.citation"/> + </xsl:when> + <xsl:when test="$axf.extensions != 0"> + <fo:basic-link external-destination="{$href}" + xsl:use-attribute-sets="olink.properties" + show-destination="replace"> + <xsl:copy-of select="$hottext"/> + </fo:basic-link> + <xsl:copy-of select="$olink.page.citation"/> + <xsl:copy-of select="$olink.docname.citation"/> + </xsl:when> + <xsl:otherwise> + <fo:basic-link external-destination="{$href}" + xsl:use-attribute-sets="olink.properties" + show-destination="replace"> + <xsl:copy-of select="$hottext"/> + </fo:basic-link> + <xsl:copy-of select="$olink.page.citation"/> + <xsl:copy-of select="$olink.docname.citation"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$hottext"/> + <xsl:copy-of select="$olink.page.citation"/> + <xsl:copy-of select="$olink.docname.citation"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + + <!-- olink never implemented in FO for old olink entity syntax --> + <xsl:otherwise> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="*" mode="insert.olink.docname.markup"> + <xsl:param name="docname" select="''"/> + + <fo:inline font-style="italic"> + <xsl:value-of select="$docname"/> + </fo:inline> + +</xsl:template> + +<!-- This prevents error message when processing olinks with xrefstyle --> +<xsl:template match="olink" mode="object.xref.template"/> + + +<xsl:template name="olink.as.linkend"> + <xsl:param name="olink.key" select="''"/> + <xsl:param name="olink.lang" select="''"/> + <xsl:param name="target.database" select="NotANode"/> + + <xsl:variable name="targetdoc"> + <xsl:value-of select="substring-before($olink.key, '/')"/> + </xsl:variable> + + <xsl:variable name="targetptr"> + <xsl:value-of + select="substring-before(substring-after($olink.key, '/'), '/')"/> + </xsl:variable> + + <xsl:variable name="target.lang"> + <xsl:variable name="candidate"> + <xsl:for-each select="$target.database" > + <xsl:value-of + select="key('targetptr-key', $olink.key)/@lang" /> + </xsl:for-each> + </xsl:variable> + <xsl:choose> + <xsl:when test="$candidate != ''"> + <xsl:value-of select="$candidate"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$olink.lang"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:if test="$current.docid = $targetdoc and + $olink.lang = $target.lang"> + <xsl:variable name="targets" select="key('id',$targetptr)"/> + <xsl:variable name="target" select="$targets[1]"/> + <xsl:if test="$target"> + <xsl:value-of select="$targetptr"/> + </xsl:if> + </xsl:if> + +</xsl:template> + + +<xsl:template name="olink.outline"> + <xsl:param name="outline.base.uri"/> + <xsl:param name="localinfo"/> + <xsl:param name="return" select="href"/> + + <xsl:message terminate="yes">Fatal error: what is this supposed to do?</xsl:message> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="title.xref"> + <xsl:param name="target" select="."/> + <xsl:choose> + <xsl:when test="local-name($target) = 'figure' + or local-name($target) = 'example' + or local-name($target) = 'equation' + or local-name($target) = 'table' + or local-name($target) = 'dedication' + or local-name($target) = 'preface' + or local-name($target) = 'bibliography' + or local-name($target) = 'glossary' + or local-name($target) = 'index' + or local-name($target) = 'setindex' + or local-name($target) = 'colophon'"> + <xsl:call-template name="gentext.startquote"/> + <xsl:apply-templates select="$target" mode="title.markup"/> + <xsl:call-template name="gentext.endquote"/> + </xsl:when> + <xsl:otherwise> + <fo:inline font-style="italic"> + <xsl:apply-templates select="$target" mode="title.markup"/> + </fo:inline> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="number.xref"> + <xsl:param name="target" select="."/> + <xsl:apply-templates select="$target" mode="label.markup"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="xref.xreflabel"> + <!-- called to process an xreflabel...you might use this to make --> + <!-- xreflabels come out in the right font for different targets, --> + <!-- for example. --> + <xsl:param name="target" select="."/> + <xsl:value-of select="$target/@xreflabel"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="title" mode="xref"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="command" mode="xref"> + <xsl:call-template name="inline.boldseq"/> +</xsl:template> + +<xsl:template match="function" mode="xref"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<xsl:template match="*" mode="page.citation"> + <xsl:param name="id" select="'???'"/> + + <fo:basic-link internal-destination="{$id}" + xsl:use-attribute-sets="xref.properties"> + <fo:inline keep-together.within-line="always"> + <xsl:call-template name="substitute-markup"> + <xsl:with-param name="template"> + <xsl:call-template name="gentext.template"> + <xsl:with-param name="name" select="'page.citation'"/> + <xsl:with-param name="context" select="'xref'"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </fo:inline> + </fo:basic-link> +</xsl:template> + +<xsl:template match="*" mode="pagenumber.markup"> + <fo:page-number-citation ref-id="{@id}"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="insert.title.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="title"/> + + <xsl:choose> + <!-- FIXME: what about the case where titleabbrev is inside the info? --> + <xsl:when test="$purpose = 'xref' and titleabbrev"> + <xsl:apply-templates select="." mode="titleabbrev.markup"/> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$title"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="chapter|appendix" mode="insert.title.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="title"/> + + <xsl:choose> + <xsl:when test="$purpose = 'xref'"> + <fo:inline font-style="italic"> + <xsl:copy-of select="$title"/> + </fo:inline> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$title"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="*" mode="insert.subtitle.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="subtitle"/> + + <xsl:copy-of select="$subtitle"/> +</xsl:template> + +<xsl:template match="*" mode="insert.label.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="label"/> + + <xsl:copy-of select="$label"/> +</xsl:template> + +<xsl:template match="*" mode="insert.pagenumber.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="pagenumber"/> + + <xsl:copy-of select="$pagenumber"/> +</xsl:template> + +<xsl:template match="*" mode="insert.direction.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="direction"/> + + <xsl:copy-of select="$direction"/> +</xsl:template> + +<xsl:template match="olink" mode="pagenumber.markup"> + <!-- Local olinks can use page-citation --> + <xsl:variable name="targetdoc.att" select="@targetdoc"/> + <xsl:variable name="targetptr.att" select="@targetptr"/> + + <xsl:variable name="olink.lang"> + <xsl:call-template name="l10n.language"> + <xsl:with-param name="xref-context" select="true()"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="target.database.filename"> + <xsl:call-template name="select.target.database"> + <xsl:with-param name="targetdoc.att" select="$targetdoc.att"/> + <xsl:with-param name="targetptr.att" select="$targetptr.att"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="target.database" + select="document($target.database.filename, /)"/> + + <xsl:if test="$olink.debug != 0"> + <xsl:message> + <xsl:text>Olink debug: root element of target.database is '</xsl:text> + <xsl:value-of select="local-name($target.database/*[1])"/> + <xsl:text>'.</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:variable name="olink.key"> + <xsl:call-template name="select.olink.key"> + <xsl:with-param name="targetdoc.att" select="$targetdoc.att"/> + <xsl:with-param name="targetptr.att" select="$targetptr.att"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + <xsl:with-param name="target.database" select="$target.database"/> + </xsl:call-template> + </xsl:variable> + + <!-- Olink that points to internal id can be a link --> + <xsl:variable name="linkend"> + <xsl:call-template name="olink.as.linkend"> + <xsl:with-param name="olink.key" select="$olink.key"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + <xsl:with-param name="target.database" select="$target.database"/> + </xsl:call-template> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$linkend != ''"> + <fo:page-number-citation ref-id="{$linkend}"/> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>Olink error: no page number linkend for local olink '</xsl:text> + <xsl:value-of select="$olink.key"/> + <xsl:text>'</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/admon.xsl b/src/documentation/docbook-xsl/html/admon.xsl new file mode 100644 index 0000000000..65f9a2c4e0 --- /dev/null +++ b/src/documentation/docbook-xsl/html/admon.xsl @@ -0,0 +1,130 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + +<!-- ******************************************************************** + $Id: admon.xsl,v 1.11 2004/12/08 20:43:51 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<xsl:template match="*" mode="admon.graphic.width"> + <xsl:param name="node" select="."/> + <xsl:text>25</xsl:text> +</xsl:template> + +<xsl:template match="note|important|warning|caution|tip"> + <xsl:choose> + <xsl:when test="$admon.graphics != 0"> + <xsl:call-template name="graphical.admonition"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="nongraphical.admonition"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="admon.graphic"> + <xsl:param name="node" select="."/> + <xsl:value-of select="$admon.graphics.path"/> + <xsl:choose> + <xsl:when test="local-name($node)='note'">note</xsl:when> + <xsl:when test="local-name($node)='warning'">warning</xsl:when> + <xsl:when test="local-name($node)='caution'">caution</xsl:when> + <xsl:when test="local-name($node)='tip'">tip</xsl:when> + <xsl:when test="local-name($node)='important'">important</xsl:when> + <xsl:otherwise>note</xsl:otherwise> + </xsl:choose> + <xsl:value-of select="$admon.graphics.extension"/> +</xsl:template> + +<xsl:template name="graphical.admonition"> + <xsl:variable name="admon.type"> + <xsl:choose> + <xsl:when test="local-name(.)='note'">Note</xsl:when> + <xsl:when test="local-name(.)='warning'">Warning</xsl:when> + <xsl:when test="local-name(.)='caution'">Caution</xsl:when> + <xsl:when test="local-name(.)='tip'">Tip</xsl:when> + <xsl:when test="local-name(.)='important'">Important</xsl:when> + <xsl:otherwise>Note</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="alt"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="$admon.type"/> + </xsl:call-template> + </xsl:variable> + + <div class="{name(.)}"> + <xsl:if test="$admon.style != ''"> + <xsl:attribute name="style"> + <xsl:value-of select="$admon.style"/> + </xsl:attribute> + </xsl:if> + + <table border="0"> + <xsl:attribute name="summary"> + <xsl:value-of select="$admon.type"/> + <xsl:if test="title"> + <xsl:text>: </xsl:text> + <xsl:value-of select="title"/> + </xsl:if> + </xsl:attribute> + <tr> + <td rowspan="2" align="center" valign="top"> + <xsl:attribute name="width"> + <xsl:apply-templates select="." mode="admon.graphic.width"/> + </xsl:attribute> + <img alt="[{$alt}]"> + <xsl:attribute name="src"> + <xsl:call-template name="admon.graphic"/> + </xsl:attribute> + </img> + </td> + <th align="left"> + <xsl:call-template name="anchor"/> + <xsl:if test="$admon.textlabel != 0 or title"> + <xsl:apply-templates select="." mode="object.title.markup"/> + </xsl:if> + </th> + </tr> + <tr> + <td align="left" valign="top"> + <xsl:apply-templates/> + </td> + </tr> + </table> + </div> +</xsl:template> + +<xsl:template name="nongraphical.admonition"> + <div class="{name(.)}"> + <xsl:if test="$admon.style"> + <xsl:attribute name="style"> + <xsl:value-of select="$admon.style"/> + </xsl:attribute> + </xsl:if> + + <h3 class="title"> + <xsl:call-template name="anchor"/> + <xsl:if test="$admon.textlabel != 0 or title"> + <xsl:apply-templates select="." mode="object.title.markup"/> + </xsl:if> + </h3> + + <xsl:apply-templates/> + </div> +</xsl:template> + +<xsl:template match="note/title"></xsl:template> +<xsl:template match="important/title"></xsl:template> +<xsl:template match="warning/title"></xsl:template> +<xsl:template match="caution/title"></xsl:template> +<xsl:template match="tip/title"></xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/annotations.xsl b/src/documentation/docbook-xsl/html/annotations.xsl new file mode 100644 index 0000000000..69f35e382c --- /dev/null +++ b/src/documentation/docbook-xsl/html/annotations.xsl @@ -0,0 +1,167 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + +<xsl:template name="add.annotation.links"> + <xsl:param name="scripts" select="normalize-space($annotation.js)"/> + <xsl:choose> + <xsl:when test="contains($scripts, ' ')"> + <script type="text/javascript" src="{substring-before($scripts, ' ')}"/> + <xsl:call-template name="add.annotation.links"> + <xsl:with-param name="scripts" select="substring-after($scripts, ' ')"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <script type="text/javascript" src="{$scripts}"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="annotation"/> + +<xsl:template name="apply-annotations"> + <xsl:if test="$annotation.support != 0"> + <!-- do any annotations apply to the context node? --> + <xsl:variable name="id" select="(@id|@xml:id)[1]"/> + + <xsl:variable name="aids"> + <xsl:for-each select="//annotation"> + <xsl:if test="@annotates=$id + or starts-with(@annotates, concat($id, ' ')) + or contains(@annotates, concat(' ', $id, ' ')) + or substring(@annotates, string-length(@annotates)-3) + = concat(' ', $id)"> + <xsl:value-of select="generate-id()"/> + <xsl:text> </xsl:text> + </xsl:if> + </xsl:for-each> + <xsl:if test="normalize-space(@annotations) != ''"> + <xsl:call-template name="annotations-pointed-to"> + <xsl:with-param name="annotations" + select="normalize-space(@annotations)"/> + </xsl:call-template> + </xsl:if> + </xsl:variable> + + <xsl:if test="$aids != ''"> + <xsl:call-template name="apply-annotations-by-gid"> + <xsl:with-param name="gids" select="normalize-space($aids)"/> + </xsl:call-template> + </xsl:if> + </xsl:if> +</xsl:template> + +<xsl:template name="annotations-pointed-to"> + <xsl:param name="annotations"/> + <xsl:choose> + <xsl:when test="contains($annotations, ' ')"> + <xsl:variable name='a' + select="key('id', substring-before($annotations, ' '))"/> + <xsl:if test="$a"> + <xsl:value-of select="generate-id($a)"/> + <xsl:text> </xsl:text> + </xsl:if> + <xsl:call-template name="annotations-pointed-to"> + <xsl:with-param name="annotations" + select="substring-after($annotations, ' ')"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:variable name='a' + select="key('id', $annotations)"/> + <xsl:if test="$a"> + <xsl:value-of select="generate-id($a)"/> + <xsl:text> </xsl:text> + </xsl:if> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="apply-annotations-by-gid"> + <xsl:param name="gids"/> + + <xsl:choose> + <xsl:when test="contains($gids, ' ')"> + <xsl:variable name="gid" select="substring-before($gids, ' ')"/> + <xsl:apply-templates select="key('gid', $gid)" + mode="annotation-inline"/> + <xsl:call-template name="apply-annotations-by-gid"> + <xsl:with-param name="gids" + select="substring-after($gids, ' ')"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="key('gid', $gids)" + mode="annotation-inline"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="annotation" mode="annotation-inline"> + <xsl:variable name="title"> + <xsl:choose> + <xsl:when test="title"> + <xsl:value-of select="title"/> + </xsl:when> + <xsl:otherwise> + <xsl:text>[Annotation #</xsl:text> + <xsl:number count="annotation" level="any" format="1"/> + <xsl:text>]</xsl:text> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <a href="#annot-{generate-id(.)}" title="{$title}" + name="anch-{generate-id(.)}" id="anch-{generate-id(.)}"> + <xsl:attribute name="onClick"> + <xsl:text>popup_</xsl:text> + <xsl:value-of select="generate-id(.)"/> + <xsl:text>.showPopup('anch-</xsl:text> + <xsl:value-of select="generate-id(.)"/> + <xsl:text>'); return false;</xsl:text> + </xsl:attribute> + <img src="{$annotation.graphic.open}" border="0" alt="{$title}"/> + </a> +</xsl:template> + +<xsl:template match="annotation" mode="annotation-popup"> + <div class="annotation-nocss"> + <p> + <a name="annot-{generate-id(.)}"/> + <xsl:text>Annotation #</xsl:text> + <xsl:number count="annotation" level="any" format="1"/> + <xsl:text>:</xsl:text> + </p> + </div> + + <div id="popup-{generate-id(.)}" class="annotation-popup"> + <xsl:if test="string-length(.) > 300"> + <xsl:attribute name="style">width:400px</xsl:attribute> + </xsl:if> + + <xsl:call-template name="annotation-title"/> + <div class="annotation-body"> + <xsl:apply-templates select="*[local-name(.) != 'title']"/> + </div> + <div class="annotation-close"> + <a href="#" onclick="popup_{generate-id(.)}.hidePopup();return false;"> + <img src="{$annotation.graphic.close}" alt="X" border="0"/> + </a> + </div> + </div> +</xsl:template> + +<xsl:template name="annotation-title"> + <div class="annotation-title"> + <xsl:choose> + <xsl:when test="title"> + <xsl:apply-templates select="title/node()"/> + </xsl:when> + <xsl:otherwise> + <xsl:text>Annotation</xsl:text> + </xsl:otherwise> + </xsl:choose> + </div> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/autoidx-ng.xsl b/src/documentation/docbook-xsl/html/autoidx-ng.xsl new file mode 100644 index 0000000000..d44f6348bf --- /dev/null +++ b/src/documentation/docbook-xsl/html/autoidx-ng.xsl @@ -0,0 +1,20 @@ +<?xml version="1.0"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<!-- ******************************************************************** + $Id: autoidx-ng.xsl,v 1.5 2006/05/16 07:24:43 kosek Exp $ + ******************************************************************** + + This file is part of the DocBook XSL Stylesheet distribution. + See ../README or http://docbook.sf.net/ for copyright + and other information. + + ******************************************************************** --> + +<!-- You should have this directly in your customization file. --> +<!-- This file is there only to retain backward compatibility. --> +<xsl:import href="../common/autoidx-ng.xsl"/> +<xsl:param name="index.method">kosek</xsl:param> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/autoidx.xsl b/src/documentation/docbook-xsl/html/autoidx.xsl new file mode 100644 index 0000000000..8383624afd --- /dev/null +++ b/src/documentation/docbook-xsl/html/autoidx.xsl @@ -0,0 +1,853 @@ +<?xml version="1.0"?> +<!DOCTYPE xsl:stylesheet [ + +<!ENTITY lowercase "'abcdefghijklmnopqrstuvwxyz'"> +<!ENTITY uppercase "'ABCDEFGHIJKLMNOPQRSTUVWXYZ'"> + +<!ENTITY primary 'normalize-space(concat(primary/@sortas, primary[not(@sortas) or @sortas = ""]))'> +<!ENTITY secondary 'normalize-space(concat(secondary/@sortas, secondary[not(@sortas) or @sortas = ""]))'> +<!ENTITY tertiary 'normalize-space(concat(tertiary/@sortas, tertiary[not(@sortas) or @sortas = ""]))'> + + +<!ENTITY section '(ancestor-or-self::set + |ancestor-or-self::book + |ancestor-or-self::part + |ancestor-or-self::reference + |ancestor-or-self::partintro + |ancestor-or-self::chapter + |ancestor-or-self::appendix + |ancestor-or-self::preface + |ancestor-or-self::article + |ancestor-or-self::section + |ancestor-or-self::sect1 + |ancestor-or-self::sect2 + |ancestor-or-self::sect3 + |ancestor-or-self::sect4 + |ancestor-or-self::sect5 + |ancestor-or-self::refentry + |ancestor-or-self::refsect1 + |ancestor-or-self::refsect2 + |ancestor-or-self::refsect3 + |ancestor-or-self::simplesect + |ancestor-or-self::bibliography + |ancestor-or-self::glossary + |ancestor-or-self::index + |ancestor-or-self::webpage)[last()]'> + +<!ENTITY section.id 'generate-id(§ion;)'> +<!ENTITY sep '" "'> +<!-- Documents using the kimber index method must have a lang attribute --> +<!-- Only one of these should be present in the entity --> + +<!ENTITY lang 'concat(/*/@lang, /*/@xml:lang, "en")'> +<!ENTITY scope 'count(ancestor::node()|$scope) = count(ancestor::node()) + and ($role = @role or $type = @type or + (string-length($role) = 0 and string-length($type) = 0))'> +]> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:i="urn:cz-kosek:functions:index" + xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" + xmlns:func="http://exslt.org/functions" + xmlns:k="java:com.isogen.saxoni18n.Saxoni18nService" + xmlns:exslt="http://exslt.org/common" + extension-element-prefixes="func exslt" + exclude-result-prefixes="func exslt i l k" + version="1.0"> + +<!-- ******************************************************************** + $Id: autoidx.xsl,v 1.28 2006/05/15 22:42:46 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> +<!-- The "english" method derived from Jeni Tennison's work. --> +<!-- The "kosek" method contributed by Jirka Kosek. --> +<!-- The "kimber" method contributed by Eliot Kimber of Innodata Isogen. --> + +<xsl:key name="letter" + match="indexterm" + use="translate(substring(&primary;, 1, 1),&lowercase;,&uppercase;)"/> + +<xsl:key name="primary" + match="indexterm" + use="&primary;"/> + +<xsl:key name="secondary" + match="indexterm" + use="concat(&primary;, &sep;, &secondary;)"/> + +<xsl:key name="tertiary" + match="indexterm" + use="concat(&primary;, &sep;, &secondary;, &sep;, &tertiary;)"/> + +<xsl:key name="endofrange" + match="indexterm[@class='endofrange']" + use="@startref"/> + +<xsl:key name="primary-section" + match="indexterm[not(secondary) and not(see)]" + use="concat(&primary;, &sep;, §ion.id;)"/> + +<xsl:key name="secondary-section" + match="indexterm[not(tertiary) and not(see)]" + use="concat(&primary;, &sep;, &secondary;, &sep;, §ion.id;)"/> + +<xsl:key name="tertiary-section" + match="indexterm[not(see)]" + use="concat(&primary;, &sep;, &secondary;, &sep;, &tertiary;, &sep;, §ion.id;)"/> + +<xsl:key name="see-also" + match="indexterm[seealso]" + use="concat(&primary;, &sep;, &secondary;, &sep;, &tertiary;, &sep;, seealso)"/> + +<xsl:key name="see" + match="indexterm[see]" + use="concat(&primary;, &sep;, &secondary;, &sep;, &tertiary;, &sep;, see)"/> + +<xsl:key name="sections" match="*[@id]" use="@id"/> + +<!-- The following key is used in the kimber indexing method. + To use this method, either copy this key to a + customization layer, or xsl:import common/autoidx.xsl. --> +<!-- +<xsl:key name="k-group" + match="indexterm" + use="k:getIndexGroupKey(⟨, &primary;)"/> +--> + + +<xsl:template name="generate-index"> + <xsl:param name="scope" select="(ancestor::book|/)[last()]"/> + + <xsl:choose> + <xsl:when test="$index.method = 'kosek'"> + <xsl:call-template name="generate-kosek-index"> + <xsl:with-param name="scope" select="$scope"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$index.method = 'kimber'"> + <xsl:call-template name="generate-kimber-index"> + <xsl:with-param name="scope" select="$scope"/> + </xsl:call-template> + </xsl:when> + + <xsl:otherwise> + <xsl:call-template name="generate-english-index"> + <xsl:with-param name="scope" select="$scope"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="generate-english-index"> + <xsl:param name="scope" select="NOTANODE"/> + + <xsl:variable name="role"> + <xsl:if test="$index.on.role != 0"> + <xsl:value-of select="@role"/> + </xsl:if> + </xsl:variable> + + <xsl:variable name="type"> + <xsl:if test="$index.on.type != 0"> + <xsl:value-of select="@type"/> + </xsl:if> + </xsl:variable> + + <xsl:variable name="terms" + select="//indexterm + [count(.|key('letter', + translate(substring(&primary;, 1, 1), + &lowercase;, + &uppercase;)) + [&scope;][1]) = 1 + and not(@class = 'endofrange')]"/> + + <xsl:variable name="alphabetical" + select="$terms[contains(concat(&lowercase;, &uppercase;), + substring(&primary;, 1, 1))]"/> + + <xsl:variable name="others" select="$terms[not(contains(concat(&lowercase;, + &uppercase;), + substring(&primary;, 1, 1)))]"/> + <div class="index"> + <xsl:if test="$others"> + <div class="indexdiv"> + <h3> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'index symbols'"/> + </xsl:call-template> + </h3> + <dl> + <xsl:apply-templates select="$others[count(.|key('primary', + &primary;)[&scope;][1]) = 1]" + mode="index-symbol-div"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(&primary;, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> + </dl> + </div> + </xsl:if> + + <xsl:apply-templates select="$alphabetical[count(.|key('letter', + translate(substring(&primary;, 1, 1), + &lowercase;,&uppercase;))[&scope;][1]) = 1]" + mode="index-div-english"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(&primary;, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> + </div> +</xsl:template> + +<xsl:template name="generate-kosek-index"> + <xsl:param name="scope" select="(ancestor::book|/)[last()]"/> + + <xsl:variable name="vendor" select="system-property('xsl:vendor')"/> + <xsl:if test="contains($vendor, 'libxslt')"> + <xsl:message terminate="yes"> + <xsl:text>ERROR: the 'kosek' index method does not </xsl:text> + <xsl:text>work with the xsltproc XSLT processor.</xsl:text> + </xsl:message> + </xsl:if> + + + <xsl:if test="not(function-available('exslt:node-set'))"> + <xsl:message terminate="yes"> + <xsl:text>ERROR: the 'kosek' index method requires the </xsl:text> + <xsl:text>exslt:node-set() function. Use a processor that </xsl:text> + <xsl:text>has it, or use a different index method.</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:if test="not(function-available('i:group-index'))"> + <xsl:message terminate="yes"> + <xsl:text>ERROR: the 'kosek' index method requires the </xsl:text> + <xsl:text>index extension functions be imported: </xsl:text> + <xsl:text> xsl:import href="common/autoidx-ng.xsl"</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:variable name="role"> + <xsl:if test="$index.on.role != 0"> + <xsl:value-of select="@role"/> + </xsl:if> + </xsl:variable> + + <xsl:variable name="type"> + <xsl:if test="$index.on.type != 0"> + <xsl:value-of select="@type"/> + </xsl:if> + </xsl:variable> + + <xsl:variable name="terms" + select="//indexterm[count(.|key('group-code', + i:group-index(&primary;)) + [&scope;][1]) = 1 + and not(@class = 'endofrange')]"/> + + <div class="index"> + <xsl:apply-templates select="$terms" mode="index-div-kosek"> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="i:group-index(&primary;)" data-type="number"/> + </xsl:apply-templates> + </div> +</xsl:template> + +<xsl:template name="generate-kimber-index"> + <xsl:param name="scope" select="NOTANODE"/> + + <xsl:variable name="vendor" select="system-property('xsl:vendor')"/> + <xsl:if test="not(contains($vendor, 'SAXON '))"> + <xsl:message terminate="yes"> + <xsl:text>ERROR: the 'kimber' index method requires the </xsl:text> + <xsl:text>Saxon version 6 XSLT processor.</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:if test="not(function-available('k:getIndexGroupKey'))"> + <xsl:message terminate="yes"> + <xsl:text>ERROR: the 'kimber' index method requires the </xsl:text> + <xsl:text>Innodata Isogen Java extensions for </xsl:text> + <xsl:text>internationalized indexes. Install those </xsl:text> + <xsl:text>extensions, or use a different index method. </xsl:text> + <xsl:text>For more information, see: </xsl:text> + <xsl:text>http://www.innodata-isogen.com/knowledge_center/tools_downloads/i18nsupport</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:if test="not(function-available('i:group-index'))"> + <xsl:message terminate="yes"> + <xsl:text>ERROR: the 'kimber' index method requires the </xsl:text> + <xsl:text>index extension functions be imported: </xsl:text> + <xsl:text> xsl:import href="common/autoidx-ng.xsl"</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:variable name="role"> + <xsl:if test="$index.on.role != 0"> + <xsl:value-of select="@role"/> + </xsl:if> + </xsl:variable> + + <xsl:variable name="type"> + <xsl:if test="$index.on.type != 0"> + <xsl:value-of select="@type"/> + </xsl:if> + </xsl:variable> + + <xsl:variable name="terms" + select="//indexterm[count(.|key('k-group', + k:getIndexGroupKey(⟨, &primary;)) + [&scope;][1]) = 1 + and not(@class = 'endofrange')]"/> + + <xsl:variable name="alphabetical" + select="$terms[not(starts-with( + k:getIndexGroupKey(⟨, &primary;), + '#NUMERIC' + ))]"/> + + <xsl:variable name="others" + select="$terms[starts-with( + k:getIndexGroupKey(⟨, &primary;), + '#NUMERIC' + )]"/> + + <div class="index"> + <xsl:if test="$others"> + <div class="indexdev"> + <h3> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'index symbols'"/> + </xsl:call-template> + </h3> + <dl> + <xsl:apply-templates select="$others" + mode="index-symbol-div"> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort lang="⟨" + select="k:getIndexGroupSortKey(⟨, + k:getIndexGroupKey(⟨, &primary;))"/> + </xsl:apply-templates> + </dl> + </div> + </xsl:if> + + <xsl:apply-templates select="$alphabetical" + mode="index-div-kimber"> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort lang="⟨" + select="k:getIndexGroupSortKey(⟨, + k:getIndexGroupKey(⟨, &primary;))"/> + </xsl:apply-templates> + </div> + +</xsl:template> + +<xsl:template match="indexterm" mode="index-div-english"> + <xsl:param name="scope" select="."/> + <xsl:param name="role" select="''"/> + <xsl:param name="type" select="''"/> + + <xsl:variable name="key" + select="translate(substring(&primary;, 1, 1), + &lowercase;,&uppercase;)"/> + + <xsl:if test="key('letter', $key)[&scope;] + [count(.|key('primary', &primary;)[&scope;][1]) = 1]"> + <div class="indexdiv"> + <xsl:if test="contains(concat(&lowercase;, &uppercase;), $key)"> + <h3> + <xsl:value-of select="translate($key, &lowercase;, &uppercase;)"/> + </h3> + </xsl:if> + <dl> + <xsl:apply-templates select="key('letter', $key)[&scope;] + [count(.|key('primary', &primary;) + [&scope;][1])=1]" + mode="index-primary"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(&primary;, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> + </dl> + </div> + </xsl:if> +</xsl:template> + +<xsl:template match="indexterm" mode="index-symbol-div"> + <xsl:param name="scope" select="/"/> + <xsl:param name="role" select="''"/> + <xsl:param name="type" select="''"/> + + <xsl:variable name="key" select="translate(substring(&primary;, 1, 1), + &lowercase;,&uppercase;)"/> + + <xsl:apply-templates select="key('letter', $key) + [&scope;][count(.|key('primary', &primary;)[1]) = 1]" + mode="index-primary"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(&primary;, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="indexterm" mode="index-div-kosek"> + <xsl:param name="scope" select="."/> + <xsl:param name="role" select="''"/> + <xsl:param name="type" select="''"/> + + <xsl:variable name="key" + select="i:group-index(&primary;)"/> + + <xsl:variable name="lang"> + <xsl:call-template name="l10n.language"/> + </xsl:variable> + + <xsl:if test="key('group-code', $key)[&scope;] + [count(.|key('primary', &primary;)[&scope;][1]) = 1]"> + <div class="indexdiv"> + <h3> + <xsl:value-of select="i:group-letter($key)"/> + </h3> + <dl> + <xsl:apply-templates select="key('group-code', $key)[&scope;] + [count(.|key('primary', &primary;)[&scope;][1])=1]" + mode="index-primary"> + <xsl:sort select="&primary;" lang="{$lang}"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + </xsl:apply-templates> + </dl> + </div> + </xsl:if> +</xsl:template> + +<xsl:template match="indexterm" mode="index-div-kimber"> + <xsl:param name="scope" select="."/> + <xsl:param name="role" select="''"/> + <xsl:param name="type" select="''"/> + + <xsl:variable name="key" + select="k:getIndexGroupKey(⟨, &primary;)"/> + + <xsl:variable name="label" + select="k:getIndexGroupLabel(⟨, $key)"/> + + <xsl:if test="key('k-group', $label)[&scope;] + [count(.|key('primary', &primary;)[&scope;][1]) = 1]"> + <div class="indexdiv"> + <h3> + <xsl:value-of select="$label"/> + </h3> + <dl> + <xsl:apply-templates select="key('k-group', $key)[&scope;] + [count(.|key('primary', &primary;)[&scope;] + [1])=1]" + mode="index-primary"> + <xsl:sort select="&primary;" lang="⟨"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + </xsl:apply-templates> + </dl> + </div> + </xsl:if> +</xsl:template> + +<xsl:template match="indexterm" mode="index-primary"> + <xsl:param name="scope" select="."/> + <xsl:param name="role" select="''"/> + <xsl:param name="type" select="''"/> + + <xsl:variable name="key" select="&primary;"/> + <xsl:variable name="refs" select="key('primary', $key)[&scope;]"/> + <dt> + <xsl:value-of select="primary"/> + <xsl:for-each select="$refs[generate-id() = generate-id(key('primary-section', concat($key, &sep;, §ion.id;))[&scope;][1])]"> + <xsl:apply-templates select="." mode="reference"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + </xsl:apply-templates> + </xsl:for-each> + + <xsl:if test="$refs[not(secondary)]/*[self::see]"> + <xsl:apply-templates select="$refs[generate-id() = generate-id(key('see', concat(&primary;, &sep;, &sep;, &sep;, see))[&scope;][1])]" + mode="index-see"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(see, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> + </xsl:if> + </dt> + <xsl:if test="$refs/secondary or $refs[not(secondary)]/*[self::seealso]"> + <dd> + <dl> + <xsl:apply-templates select="$refs[generate-id() = generate-id(key('see-also', concat(&primary;, &sep;, &sep;, &sep;, seealso))[&scope;][1])]" + mode="index-seealso"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(seealso, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> + <xsl:apply-templates select="$refs[secondary and count(.|key('secondary', concat($key, &sep;, &secondary;))[&scope;][1]) = 1]" + mode="index-secondary"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(&secondary;, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> + </dl> + </dd> + </xsl:if> +</xsl:template> + +<xsl:template match="indexterm" mode="index-secondary"> + <xsl:param name="scope" select="."/> + <xsl:param name="role" select="''"/> + <xsl:param name="type" select="''"/> + + <xsl:variable name="key" select="concat(&primary;, &sep;, &secondary;)"/> + <xsl:variable name="refs" select="key('secondary', $key)[&scope;]"/> + <dt> + <xsl:value-of select="secondary"/> + <xsl:for-each select="$refs[generate-id() = generate-id(key('secondary-section', concat($key, &sep;, §ion.id;))[&scope;][1])]"> + <xsl:apply-templates select="." mode="reference"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + </xsl:apply-templates> + </xsl:for-each> + + <xsl:if test="$refs[not(tertiary)]/*[self::see]"> + <xsl:apply-templates select="$refs[generate-id() = generate-id(key('see', concat(&primary;, &sep;, &secondary;, &sep;, &sep;, see))[&scope;][1])]" + mode="index-see"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(see, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> + </xsl:if> + </dt> + <xsl:if test="$refs/tertiary or $refs[not(tertiary)]/*[self::seealso]"> + <dd> + <dl> + <xsl:apply-templates select="$refs[generate-id() = generate-id(key('see-also', concat(&primary;, &sep;, &secondary;, &sep;, &sep;, seealso))[&scope;][1])]" + mode="index-seealso"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(seealso, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> + <xsl:apply-templates select="$refs[tertiary and count(.|key('tertiary', concat($key, &sep;, &tertiary;))[&scope;][1]) = 1]" + mode="index-tertiary"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(&tertiary;, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> + </dl> + </dd> + </xsl:if> +</xsl:template> + +<xsl:template match="indexterm" mode="index-tertiary"> + <xsl:param name="scope" select="."/> + <xsl:param name="role" select="''"/> + <xsl:param name="type" select="''"/> + + <xsl:variable name="key" select="concat(&primary;, &sep;, &secondary;, &sep;, &tertiary;)"/> + <xsl:variable name="refs" select="key('tertiary', $key)[&scope;]"/> + <dt> + <xsl:value-of select="tertiary"/> + <xsl:for-each select="$refs[generate-id() = generate-id(key('tertiary-section', concat($key, &sep;, §ion.id;))[&scope;][1])]"> + <xsl:apply-templates select="." mode="reference"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + </xsl:apply-templates> + </xsl:for-each> + + <xsl:if test="$refs/see"> + <xsl:apply-templates select="$refs[generate-id() = generate-id(key('see', concat(&primary;, &sep;, &secondary;, &sep;, &tertiary;, &sep;, see))[&scope;][1])]" + mode="index-see"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(see, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> + </xsl:if> + </dt> + <xsl:if test="$refs/seealso"> + <dd> + <dl> + <xsl:apply-templates select="$refs[generate-id() = generate-id(key('see-also', concat(&primary;, &sep;, &secondary;, &sep;, &tertiary;, &sep;, seealso))[&scope;][1])]" + mode="index-seealso"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:sort select="translate(seealso, &lowercase;, &uppercase;)"/> + </xsl:apply-templates> + </dl> + </dd> + </xsl:if> +</xsl:template> + +<xsl:template match="indexterm" mode="reference"> + <xsl:param name="scope" select="."/> + <xsl:param name="role" select="''"/> + <xsl:param name="type" select="''"/> + <xsl:param name="position"/> + + <xsl:variable name="term.separator"> + <xsl:call-template name="index.separator"> + <xsl:with-param name="key" select="'index.term.separator'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="number.separator"> + <xsl:call-template name="index.separator"> + <xsl:with-param name="key" select="'index.number.separator'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="range.separator"> + <xsl:call-template name="index.separator"> + <xsl:with-param name="key" select="'index.range.separator'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$position = 1"> + <xsl:value-of select="$term.separator"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$number.separator"/> + </xsl:otherwise> + </xsl:choose> + + <xsl:choose> + <xsl:when test="@zone and string(@zone)"> + <xsl:call-template name="reference"> + <xsl:with-param name="zones" select="normalize-space(@zone)"/> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <a> + <xsl:variable name="title"> + <xsl:choose> + <xsl:when test="§ion;/titleabbrev and $index.prefer.titleabbrev != 0"> + <xsl:apply-templates select="§ion;" mode="titleabbrev.markup"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="§ion;" mode="title.markup"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="§ion;"/> + <xsl:with-param name="context" select="//index[&scope;][1]"/> + </xsl:call-template> + </xsl:attribute> + + <xsl:value-of select="$title"/> <!-- text only --> + </a> + + <xsl:if test="key('endofrange', @id)[&scope;]"> + <xsl:apply-templates select="key('endofrange', @id)[&scope;][last()]" + mode="reference"> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + <xsl:with-param name="separator" select="$range.separator"/> + </xsl:apply-templates> + </xsl:if> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="reference"> + <xsl:param name="scope" select="."/> + <xsl:param name="role" select="''"/> + <xsl:param name="type" select="''"/> + <xsl:param name="zones"/> + + <xsl:choose> + <xsl:when test="contains($zones, ' ')"> + <xsl:variable name="zone" select="substring-before($zones, ' ')"/> + <xsl:variable name="target" select="key('sections', $zone)[&scope;]"/> + + <a> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$target[1]"/> + <xsl:with-param name="context" select="//index[&scope;][1]"/> + </xsl:call-template> + </xsl:attribute> + <xsl:apply-templates select="$target[1]" mode="index-title-content"/> + </a> + <xsl:text>, </xsl:text> + <xsl:call-template name="reference"> + <xsl:with-param name="zones" select="substring-after($zones, ' ')"/> + <xsl:with-param name="position" select="position()"/> + <xsl:with-param name="scope" select="$scope"/> + <xsl:with-param name="role" select="$role"/> + <xsl:with-param name="type" select="$type"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="zone" select="$zones"/> + <xsl:variable name="target" select="key('sections', $zone)[&scope;]"/> + + <a> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$target[1]"/> + <xsl:with-param name="context" select="//index[&scope;][1]"/> + </xsl:call-template> + </xsl:attribute> + <xsl:apply-templates select="$target[1]" mode="index-title-content"/> + </a> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="indexterm" mode="index-see"> + <xsl:param name="scope" select="."/> + <xsl:param name="role" select="''"/> + <xsl:param name="type" select="''"/> + + <xsl:text> (</xsl:text> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'see'"/> + </xsl:call-template> + <xsl:text> </xsl:text> + <xsl:value-of select="see"/> + <xsl:text>)</xsl:text> +</xsl:template> + +<xsl:template match="indexterm" mode="index-seealso"> + <xsl:param name="scope" select="."/> + <xsl:param name="role" select="''"/> + <xsl:param name="type" select="''"/> + + <xsl:for-each select="seealso"> + <xsl:sort select="translate(., &lowercase;, &uppercase;)"/> + <dt> + <xsl:text>(</xsl:text> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'seealso'"/> + </xsl:call-template> + <xsl:text> </xsl:text> + <xsl:value-of select="."/> + <xsl:text>)</xsl:text> + </dt> + </xsl:for-each> +</xsl:template> + +<xsl:template match="*" mode="index-title-content"> + <xsl:variable name="title"> + <xsl:apply-templates select="§ion;" mode="title.markup"/> + </xsl:variable> + + <xsl:value-of select="$title"/> +</xsl:template> + +<xsl:template name="index.separator"> + <xsl:param name="key" select="''"/> + <xsl:param name="lang"> + <xsl:call-template name="l10n.language"/> + </xsl:param> + + <xsl:choose> + <xsl:when test="$key = 'index.term.separator'"> + <xsl:choose> + <!-- Use the override if not blank --> + <xsl:when test="$index.term.separator != ''"> + <xsl:copy-of select="$index.term.separator"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="gentext.template"> + <xsl:with-param name="lang" select="$lang"/> + <xsl:with-param name="context">index</xsl:with-param> + <xsl:with-param name="name">term-separator</xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="$key = 'index.number.separator'"> + <xsl:choose> + <!-- Use the override if not blank --> + <xsl:when test="$index.number.separator != ''"> + <xsl:copy-of select="$index.number.separator"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="gentext.template"> + <xsl:with-param name="lang" select="$lang"/> + <xsl:with-param name="context">index</xsl:with-param> + <xsl:with-param name="name">number-separator</xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="$key = 'index.range.separator'"> + <xsl:choose> + <!-- Use the override if not blank --> + <xsl:when test="$index.range.separator != ''"> + <xsl:copy-of select="$index.range.separator"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="gentext.template"> + <xsl:with-param name="lang" select="$lang"/> + <xsl:with-param name="context">index</xsl:with-param> + <xsl:with-param name="name">range-separator</xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + </xsl:choose> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/autotoc.xsl b/src/documentation/docbook-xsl/html/autotoc.xsl new file mode 100644 index 0000000000..c174def1c9 --- /dev/null +++ b/src/documentation/docbook-xsl/html/autotoc.xsl @@ -0,0 +1,621 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + +<!-- ******************************************************************** + $Id: autotoc.xsl,v 1.37 2006/05/04 12:21:28 kosek Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<xsl:variable name="toc.listitem.type"> + <xsl:choose> + <xsl:when test="$toc.list.type = 'dl'">dt</xsl:when> + <xsl:otherwise>li</xsl:otherwise> + </xsl:choose> +</xsl:variable> + +<!-- this is just hack because dl and ul aren't completely isomorphic --> +<xsl:variable name="toc.dd.type"> + <xsl:choose> + <xsl:when test="$toc.list.type = 'dl'">dd</xsl:when> + <xsl:otherwise></xsl:otherwise> + </xsl:choose> +</xsl:variable> + +<xsl:template name="make.toc"> + <xsl:param name="toc-context" select="."/> + <xsl:param name="toc.title.p" select="true()"/> + <xsl:param name="nodes" select="/NOT-AN-ELEMENT"/> + + <xsl:variable name="toc.title"> + <xsl:if test="$toc.title.p"> + <p> + <b> + <xsl:call-template name="gentext"> + <xsl:with-param name="key">TableofContents</xsl:with-param> + </xsl:call-template> + </b> + </p> + </xsl:if> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$manual.toc != ''"> + <xsl:variable name="id"> + <xsl:call-template name="object.id"/> + </xsl:variable> + <xsl:variable name="toc" select="document($manual.toc, .)"/> + <xsl:variable name="tocentry" select="$toc//tocentry[@linkend=$id]"/> + <xsl:if test="$tocentry and $tocentry/*"> + <div class="toc"> + <xsl:copy-of select="$toc.title"/> + <xsl:element name="{$toc.list.type}"> + <xsl:call-template name="manual-toc"> + <xsl:with-param name="tocentry" select="$tocentry/*[1]"/> + </xsl:call-template> + </xsl:element> + </div> + </xsl:if> + </xsl:when> + <xsl:otherwise> + <xsl:if test="$nodes"> + <div class="toc"> + <xsl:copy-of select="$toc.title"/> + <xsl:element name="{$toc.list.type}"> + <xsl:apply-templates select="$nodes" mode="toc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + </xsl:apply-templates> + </xsl:element> + </div> + </xsl:if> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="make.lots"> + <xsl:param name="toc.params" select="''"/> + <xsl:param name="toc"/> + + <xsl:if test="contains($toc.params, 'toc')"> + <xsl:copy-of select="$toc"/> + </xsl:if> + + <xsl:if test="contains($toc.params, 'figure')"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'figure'"/> + <xsl:with-param name="nodes" select=".//figure"/> + </xsl:call-template> + </xsl:if> + + <xsl:if test="contains($toc.params, 'table')"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'table'"/> + <xsl:with-param name="nodes" select=".//table"/> + </xsl:call-template> + </xsl:if> + + <xsl:if test="contains($toc.params, 'example')"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'example'"/> + <xsl:with-param name="nodes" select=".//example"/> + </xsl:call-template> + </xsl:if> + + <xsl:if test="contains($toc.params, 'equation')"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'equation'"/> + <xsl:with-param name="nodes" select=".//equation[title]"/> + </xsl:call-template> + </xsl:if> + + <xsl:if test="contains($toc.params, 'procedure')"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'procedure'"/> + <xsl:with-param name="nodes" select=".//procedure[title]"/> + </xsl:call-template> + </xsl:if> +</xsl:template> + +<!-- ====================================================================== --> + +<xsl:template name="set.toc"> + <xsl:param name="toc-context" select="."/> + <xsl:param name="toc.title.p" select="true()"/> + + <xsl:call-template name="make.toc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="toc.title.p" select="$toc.title.p"/> + <xsl:with-param name="nodes" select="book|setindex"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="division.toc"> + <xsl:param name="toc-context" select="."/> + <xsl:param name="toc.title.p" select="true()"/> + + <xsl:call-template name="make.toc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="toc.title.p" select="$toc.title.p"/> + <xsl:with-param name="nodes" select="part|reference + |preface|chapter|appendix + |article + |bibliography|glossary|index + |refentry + |bridgehead[$bridgehead.in.toc != 0]"/> + + </xsl:call-template> +</xsl:template> + +<xsl:template name="component.toc"> + <xsl:param name="toc-context" select="."/> + <xsl:param name="toc.title.p" select="true()"/> + + <xsl:call-template name="make.toc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="toc.title.p" select="$toc.title.p"/> + <xsl:with-param name="nodes" select="section|sect1 + |simplesect[$simplesect.in.toc != 0] + |refentry + |article|bibliography|glossary + |appendix|index + |bridgehead[not(@renderas) + and $bridgehead.in.toc != 0] + |.//bridgehead[@renderas='sect1' + and $bridgehead.in.toc != 0]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="component.toc.separator"> + <!-- Customize to output something between + component.toc and first output --> +</xsl:template> + +<xsl:template name="section.toc"> + <xsl:param name="toc-context" select="."/> + <xsl:param name="toc.title.p" select="true()"/> + + <xsl:call-template name="make.toc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="toc.title.p" select="$toc.title.p"/> + <xsl:with-param name="nodes" + select="section|sect1|sect2|sect3|sect4|sect5|refentry + |bridgehead[$bridgehead.in.toc != 0]"/> + + </xsl:call-template> +</xsl:template> + +<xsl:template name="section.toc.separator"> + <!-- Customize to output something between + section.toc and first output --> +</xsl:template> +<!-- ==================================================================== --> + +<xsl:template name="subtoc"> + <xsl:param name="toc-context" select="."/> + <xsl:param name="nodes" select="NOT-AN-ELEMENT"/> + + <xsl:variable name="subtoc"> + <xsl:element name="{$toc.list.type}"> + <xsl:apply-templates mode="toc" select="$nodes"> + <xsl:with-param name="toc-context" select="$toc-context"/> + </xsl:apply-templates> + </xsl:element> + </xsl:variable> + + <xsl:variable name="depth"> + <xsl:choose> + <xsl:when test="local-name(.) = 'section'"> + <xsl:value-of select="count(ancestor::section) + 1"/> + </xsl:when> + <xsl:when test="local-name(.) = 'sect1'">1</xsl:when> + <xsl:when test="local-name(.) = 'sect2'">2</xsl:when> + <xsl:when test="local-name(.) = 'sect3'">3</xsl:when> + <xsl:when test="local-name(.) = 'sect4'">4</xsl:when> + <xsl:when test="local-name(.) = 'sect5'">5</xsl:when> + <xsl:when test="local-name(.) = 'refsect1'">1</xsl:when> + <xsl:when test="local-name(.) = 'refsect2'">2</xsl:when> + <xsl:when test="local-name(.) = 'refsect3'">3</xsl:when> + <xsl:when test="local-name(.) = 'simplesect'"> + <!-- sigh... --> + <xsl:choose> + <xsl:when test="local-name(..) = 'section'"> + <xsl:value-of select="count(ancestor::section)"/> + </xsl:when> + <xsl:when test="local-name(..) = 'sect1'">2</xsl:when> + <xsl:when test="local-name(..) = 'sect2'">3</xsl:when> + <xsl:when test="local-name(..) = 'sect3'">4</xsl:when> + <xsl:when test="local-name(..) = 'sect4'">5</xsl:when> + <xsl:when test="local-name(..) = 'sect5'">6</xsl:when> + <xsl:when test="local-name(..) = 'refsect1'">2</xsl:when> + <xsl:when test="local-name(..) = 'refsect2'">3</xsl:when> + <xsl:when test="local-name(..) = 'refsect3'">4</xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise>0</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="depth.from.context" select="count(ancestor::*)-count($toc-context/ancestor::*)"/> + + <xsl:variable name="subtoc.list"> + <xsl:choose> + <xsl:when test="$toc.dd.type = ''"> + <xsl:copy-of select="$subtoc"/> + </xsl:when> + <xsl:otherwise> + <xsl:element name="{$toc.dd.type}"> + <xsl:copy-of select="$subtoc"/> + </xsl:element> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:element name="{$toc.listitem.type}"> + <xsl:call-template name="toc.line"> + <xsl:with-param name="toc-context" select="$toc-context"/> + </xsl:call-template> + <xsl:if test="$toc.listitem.type = 'li' + and $toc.section.depth > $depth and count($nodes)>0 + and $toc.max.depth > $depth.from.context"> + <xsl:copy-of select="$subtoc.list"/> + </xsl:if> + </xsl:element> + <xsl:if test="$toc.listitem.type != 'li' + and $toc.section.depth > $depth and count($nodes)>0 + and $toc.max.depth > $depth.from.context"> + <xsl:copy-of select="$subtoc.list"/> + </xsl:if> +</xsl:template> + +<xsl:template name="toc.line"> + <xsl:param name="toc-context" select="."/> + <xsl:param name="depth" select="1"/> + <xsl:param name="depth.from.context" select="8"/> + + <span> + <xsl:attribute name="class"><xsl:value-of select="local-name(.)"/></xsl:attribute> + + <!-- * if $autotoc.label.in.hyperlink is zero, then output the label --> + <!-- * before the hyperlinked title (as the DSSSL stylesheet does) --> + <xsl:if test="$autotoc.label.in.hyperlink = 0"> + <xsl:variable name="label"> + <xsl:apply-templates select="." mode="label.markup"/> + </xsl:variable> + <xsl:copy-of select="$label"/> + <xsl:if test="$label != ''"> + <xsl:value-of select="$autotoc.label.separator"/> + </xsl:if> + </xsl:if> + + <a> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="context" select="$toc-context"/> + </xsl:call-template> + </xsl:attribute> + + <!-- * if $autotoc.label.in.hyperlink is non-zero, then output the label --> + <!-- * as part of the hyperlinked title --> + <xsl:if test="not($autotoc.label.in.hyperlink = 0)"> + <xsl:variable name="label"> + <xsl:apply-templates select="." mode="label.markup"/> + </xsl:variable> + <xsl:copy-of select="$label"/> + <xsl:if test="$label != ''"> + <xsl:value-of select="$autotoc.label.separator"/> + </xsl:if> + </xsl:if> + + <xsl:apply-templates select="." mode="titleabbrev.markup"/> + </a> + </span> +</xsl:template> + +<xsl:template match="book" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="nodes" select="part|reference + |preface|chapter|appendix + |article + |bibliography|glossary|index + |refentry + |bridgehead[$bridgehead.in.toc != 0]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="setindex" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <!-- If the setindex tag is not empty, it should be it in the TOC --> + <xsl:if test="* or $generate.index != 0"> + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + </xsl:call-template> + </xsl:if> +</xsl:template> + +<xsl:template match="part|reference" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="nodes" select="appendix|chapter|article + |index|glossary|bibliography + |preface|reference|refentry + |bridgehead[$bridgehead.in.toc != 0]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="preface|chapter|appendix|article" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="nodes" select="section|sect1 + |simplesect[$simplesect.in.toc != 0] + |refentry + |glossary|bibliography|index + |bridgehead[$bridgehead.in.toc != 0]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="sect1" mode="toc"> + <xsl:param name="toc-context" select="."/> + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="nodes" select="sect2 + |bridgehead[$bridgehead.in.toc != 0]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="sect2" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="nodes" select="sect3 + |bridgehead[$bridgehead.in.toc != 0]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="sect3" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="nodes" select="sect4 + |bridgehead[$bridgehead.in.toc != 0]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="sect4" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="nodes" select="sect5 + |bridgehead[$bridgehead.in.toc != 0]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="sect5" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="simplesect" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="section" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + <xsl:with-param name="nodes" select="section + |bridgehead[$bridgehead.in.toc != 0]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="bridgehead" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:if test="$bridgehead.in.toc != 0"> + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + </xsl:call-template> + </xsl:if> +</xsl:template> + +<xsl:template match="bibliography|glossary" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="index" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <!-- If the index tag is not empty, it should be it in the TOC --> + <xsl:if test="* or $generate.index != 0"> + <xsl:call-template name="subtoc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + </xsl:call-template> + </xsl:if> +</xsl:template> + +<xsl:template match="refentry" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:variable name="refmeta" select=".//refmeta"/> + <xsl:variable name="refentrytitle" select="$refmeta//refentrytitle"/> + <xsl:variable name="refnamediv" select=".//refnamediv"/> + <xsl:variable name="refname" select="$refnamediv//refname"/> + <xsl:variable name="refdesc" select="$refnamediv//refdescriptor"/> + <xsl:variable name="title"> + <xsl:choose> + <xsl:when test="$refentrytitle"> + <xsl:apply-templates select="$refentrytitle[1]" + mode="titleabbrev.markup"/> + </xsl:when> + <xsl:when test="$refdesc"> + <xsl:apply-templates select="$refdesc" + mode="titleabbrev.markup"/> + </xsl:when> + <xsl:when test="$refname"> + <xsl:apply-templates select="$refname[1]" + mode="titleabbrev.markup"/> + </xsl:when> + </xsl:choose> + </xsl:variable> + + <xsl:element name="{$toc.listitem.type}"> + <span class='refentrytitle'> + <a> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"/> + </xsl:attribute> + <xsl:copy-of select="$title"/> + </a> + </span> + <span class='refpurpose'> + <xsl:if test="$annotate.toc != 0"> + <!-- * DocBook 5 says inlinemediaobject (among other things) --> + <!-- * is allowed in refpurpose; so we need to run --> + <!-- * apply-templates on refpurpose here, instead of value-of --> + <xsl:apply-templates select="refnamediv/refpurpose"/> + </xsl:if> + </span> + </xsl:element> +</xsl:template> + +<xsl:template match="title" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <a> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select=".."/> + </xsl:call-template> + </xsl:attribute> + <xsl:apply-templates/> + </a> +</xsl:template> + +<xsl:template name="manual-toc"> + <xsl:param name="toc-context" select="."/> + <xsl:param name="tocentry"/> + + <!-- be careful, we don't want to change the current document to the other tree! --> + + <xsl:if test="$tocentry"> + <xsl:variable name="node" select="key('id', $tocentry/@linkend)"/> + + <xsl:element name="{$toc.listitem.type}"> + <xsl:variable name="label"> + <xsl:apply-templates select="$node" mode="label.markup"/> + </xsl:variable> + <xsl:copy-of select="$label"/> + <xsl:if test="$label != ''"> + <xsl:value-of select="$autotoc.label.separator"/> + </xsl:if> + <a> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$node"/> + </xsl:call-template> + </xsl:attribute> + <xsl:apply-templates select="$node" mode="titleabbrev.markup"/> + </a> + </xsl:element> + + <xsl:if test="$tocentry/*"> + <xsl:element name="{$toc.list.type}"> + <xsl:call-template name="manual-toc"> + <xsl:with-param name="tocentry" select="$tocentry/*[1]"/> + </xsl:call-template> + </xsl:element> + </xsl:if> + + <xsl:if test="$tocentry/following-sibling::*"> + <xsl:call-template name="manual-toc"> + <xsl:with-param name="tocentry" select="$tocentry/following-sibling::*[1]"/> + </xsl:call-template> + </xsl:if> + </xsl:if> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="list.of.titles"> + <xsl:param name="toc-context" select="."/> + <xsl:param name="titles" select="'table'"/> + <xsl:param name="nodes" select=".//table"/> + + <xsl:if test="$nodes"> + <div class="list-of-{$titles}s"> + <p> + <b> + <xsl:call-template name="gentext"> + <xsl:with-param name="key"> + <xsl:choose> + <xsl:when test="$titles='table'">ListofTables</xsl:when> + <xsl:when test="$titles='figure'">ListofFigures</xsl:when> + <xsl:when test="$titles='equation'">ListofEquations</xsl:when> + <xsl:when test="$titles='example'">ListofExamples</xsl:when> + <xsl:when test="$titles='procedure'">ListofProcedures</xsl:when> + <xsl:otherwise>ListofUnknown</xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:call-template> + </b> + </p> + + <xsl:element name="{$toc.list.type}"> + <xsl:apply-templates select="$nodes" mode="toc"> + <xsl:with-param name="toc-context" select="$toc-context"/> + </xsl:apply-templates> + </xsl:element> + </div> + </xsl:if> +</xsl:template> + +<xsl:template match="figure|table|example|equation|procedure" mode="toc"> + <xsl:param name="toc-context" select="."/> + + <xsl:element name="{$toc.listitem.type}"> + <xsl:variable name="label"> + <xsl:apply-templates select="." mode="label.markup"/> + </xsl:variable> + <xsl:copy-of select="$label"/> + <xsl:if test="$label != ''"> + <xsl:value-of select="$autotoc.label.separator"/> + </xsl:if> + <a> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"/> + </xsl:attribute> + <xsl:apply-templates select="." mode="titleabbrev.markup"/> + </a> + </xsl:element> +</xsl:template> + +</xsl:stylesheet> + diff --git a/src/documentation/docbook-xsl/html/biblio.xsl b/src/documentation/docbook-xsl/html/biblio.xsl new file mode 100644 index 0000000000..938cb8e67e --- /dev/null +++ b/src/documentation/docbook-xsl/html/biblio.xsl @@ -0,0 +1,1093 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + +<!-- ******************************************************************** + $Id: biblio.xsl,v 1.26 2006/02/28 14:27:23 kosek Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:template match="bibliography"> + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:if test="$generate.id.attributes != 0"> + <xsl:attribute name="id"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </xsl:if> + + <xsl:call-template name="bibliography.titlepage"/> + + <xsl:apply-templates/> + + <xsl:if test="not(parent::article)"> + <xsl:call-template name="process.footnotes"/> + </xsl:if> + </div> +</xsl:template> + +<xsl:template match="bibliography/bibliographyinfo"></xsl:template> +<xsl:template match="bibliography/title"></xsl:template> +<xsl:template match="bibliography/subtitle"></xsl:template> +<xsl:template match="bibliography/titleabbrev"></xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="bibliodiv"> + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:apply-templates/> + </div> +</xsl:template> + +<xsl:template match="bibliodiv/title"> + <h3 class="{name(.)}"> + <xsl:call-template name="anchor"> + <xsl:with-param name="node" select=".."/> + </xsl:call-template> + <xsl:apply-templates/> + </h3> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="bibliolist"> + <div class="{name(.)}"> + <xsl:call-template name="anchor"/> + <xsl:if test="blockinfo/title|title"> + <xsl:call-template name="formal.object.heading"/> + </xsl:if> + <xsl:apply-templates select="*[not(self::blockinfo) + and not(self::title) + and not(self::titleabbrev) + and not(self::biblioentry) + and not(self::bibliomixed)]"/> + <dl> + <xsl:apply-templates select="biblioentry|bibliomixed"/> + </dl> + </div> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="biblioentry"> + <xsl:param name="label"> + <xsl:call-template name="biblioentry.label"/> + </xsl:param> + + <xsl:variable name="id"> + <xsl:call-template name="object.id"/> + </xsl:variable> + + <xsl:choose> + <xsl:when test="string(.) = ''"> + <xsl:variable name="bib" select="document($bibliography.collection,.)"/> + <xsl:variable name="entry" select="$bib/bibliography/*[@id=$id][1]"/> + <xsl:choose> + <xsl:when test="$entry"> + <xsl:choose> + <xsl:when test="$bibliography.numbered != 0"> + <xsl:apply-templates select="$entry"> + <xsl:with-param name="label" select="$label"/> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$entry"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>No bibliography entry: </xsl:text> + <xsl:value-of select="$id"/> + <xsl:text> found in </xsl:text> + <xsl:value-of select="$bibliography.collection"/> + </xsl:message> + <div class="{name(.)}"> + <xsl:call-template name="anchor"/> + <p> + <xsl:copy-of select="$label"/> + <xsl:text>Error: no bibliography entry: </xsl:text> + <xsl:value-of select="$id"/> + <xsl:text> found in </xsl:text> + <xsl:value-of select="$bibliography.collection"/> + </p> + </div> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <div class="{name(.)}"> + <xsl:call-template name="anchor"> + <xsl:with-param name="conditional" select="0"/> + </xsl:call-template> + <p> + <xsl:copy-of select="$label"/> + <xsl:apply-templates mode="bibliography.mode"/> + </p> + </div> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="bibliomixed"> + <xsl:param name="label"> + <xsl:call-template name="biblioentry.label"/> + </xsl:param> + + <xsl:variable name="id"> + <xsl:call-template name="object.id"/> + </xsl:variable> + + <xsl:choose> + <xsl:when test="string(.) = ''"> + <xsl:variable name="bib" select="document($bibliography.collection,.)"/> + <xsl:variable name="entry" select="$bib/bibliography/*[@id=$id][1]"/> + <xsl:choose> + <xsl:when test="$entry"> + <xsl:choose> + <xsl:when test="$bibliography.numbered != 0"> + <xsl:apply-templates select="$entry"> + <xsl:with-param name="label" select="$label"/> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$entry"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>No bibliography entry: </xsl:text> + <xsl:value-of select="$id"/> + <xsl:text> found in </xsl:text> + <xsl:value-of select="$bibliography.collection"/> + </xsl:message> + <div class="{name(.)}"> + <xsl:call-template name="anchor"/> + <p> + <xsl:copy-of select="$label"/> + <xsl:text>Error: no bibliography entry: </xsl:text> + <xsl:value-of select="$id"/> + <xsl:text> found in </xsl:text> + <xsl:value-of select="$bibliography.collection"/> + </p> + </div> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <div class="{name(.)}"> + <xsl:call-template name="anchor"> + <xsl:with-param name="conditional" select="0"/> + </xsl:call-template> + <p class="{name(.)}"> + <xsl:copy-of select="$label"/> + <xsl:apply-templates mode="bibliomixed.mode"/> + </p> + </div> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="biblioentry.label"> + <xsl:param name="node" select="."/> + + <xsl:choose> + <xsl:when test="$bibliography.numbered != 0"> + <xsl:text>[</xsl:text> + <xsl:number from="bibliography" count="biblioentry|bibliomixed" + level="any" format="1"/> + <xsl:text>] </xsl:text> + </xsl:when> + <xsl:when test="local-name($node/child::*[1]) = 'abbrev'"> + <xsl:text>[</xsl:text> + <xsl:apply-templates select="$node/abbrev[1]"/> + <xsl:text>] </xsl:text> + </xsl:when> + <xsl:when test="$node/@xreflabel"> + <xsl:text>[</xsl:text> + <xsl:value-of select="$node/@xreflabel"/> + <xsl:text>] </xsl:text> + </xsl:when> + <xsl:when test="$node/@id"> + <xsl:text>[</xsl:text> + <xsl:value-of select="$node/@id"/> + <xsl:text>] </xsl:text> + </xsl:when> + <xsl:otherwise><!-- nop --></xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="bibliography.mode"> + <xsl:apply-templates select="."/><!-- try the default mode --> +</xsl:template> + +<xsl:template match="abbrev" mode="bibliography.mode"> + <xsl:if test="preceding-sibling::*"> + <xsl:apply-templates mode="bibliography.mode"/> + </xsl:if> +</xsl:template> + +<xsl:template match="abstract" mode="bibliography.mode"> + <!-- suppressed --> +</xsl:template> + +<xsl:template match="address" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="affiliation" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="shortaffil" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="jobtitle" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="artheader|articleinfo|info" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="artpagenums" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="author" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:call-template name="person.name"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="authorblurb|personblurb" mode="bibliography.mode"> + <!-- suppressed --> +</xsl:template> + +<xsl:template match="authorgroup" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:call-template name="person.name.list"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="authorinitials" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="bibliomisc" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="bibliomset" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<!-- ================================================== --> + +<xsl:template match="biblioset" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + </span> +</xsl:template> + +<xsl:template match="biblioset/title|biblioset/citetitle" + mode="bibliography.mode"> + <xsl:variable name="relation" select="../@relation"/> + <xsl:choose> + <xsl:when test="$relation='article' or @pubwork='article'"> + <xsl:call-template name="gentext.startquote"/> + <xsl:apply-templates/> + <xsl:call-template name="gentext.endquote"/> + </xsl:when> + <xsl:otherwise> + <i><xsl:apply-templates/></i> + </xsl:otherwise> + </xsl:choose> + <xsl:value-of select="$biblioentry.item.separator"/> +</xsl:template> + +<!-- ================================================== --> + +<xsl:template match="bookbiblio" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="citetitle" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:choose> + <xsl:when test="@pubwork = 'article'"> + <xsl:call-template name="gentext.startquote"/> + <xsl:call-template name="inline.charseq"/> + <xsl:call-template name="gentext.endquote"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="inline.italicseq"/> + </xsl:otherwise> + </xsl:choose> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="collab" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="collabname" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="confgroup" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="confdates" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="conftitle" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="confnum" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="confsponsor" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="contractnum" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="contractsponsor" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="contrib" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<!-- ================================================== --> + +<xsl:template match="copyright" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'Copyright'"/> + </xsl:call-template> + <xsl:call-template name="gentext.space"/> + <xsl:call-template name="dingbat"> + <xsl:with-param name="dingbat">copyright</xsl:with-param> + </xsl:call-template> + <xsl:call-template name="gentext.space"/> + <xsl:apply-templates select="year" mode="bibliography.mode"/> + <xsl:if test="holder"> + <xsl:call-template name="gentext.space"/> + <xsl:apply-templates select="holder" mode="bibliography.mode"/> + </xsl:if> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="year" mode="bibliography.mode"> + <xsl:apply-templates/><xsl:text>, </xsl:text> +</xsl:template> + +<xsl:template match="year[position()=last()]" mode="bibliography.mode"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="holder" mode="bibliography.mode"> + <xsl:apply-templates/> +</xsl:template> + +<!-- ================================================== --> + +<xsl:template match="corpauthor" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="corpcredit" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="corpname" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="date" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="edition" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="editor" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:call-template name="person.name"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="firstname" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="honorific" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="indexterm" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="invpartnumber" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="isbn" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="issn" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="issuenum" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="lineage" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="orgname" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="orgdiv" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="othercredit" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="othername" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="pagenums" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="printhistory" mode="bibliography.mode"> + <!-- suppressed --> +</xsl:template> + +<xsl:template match="productname" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="productnumber" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="pubdate" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="publisher" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + </span> +</xsl:template> + +<xsl:template match="publishername" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="pubsnumber" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="releaseinfo" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="revhistory" mode="bibliography.mode"> + <!-- suppressed; how could this be represented? --> +</xsl:template> + +<xsl:template match="seriesinfo" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + </span> +</xsl:template> + +<xsl:template match="seriesvolnums" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="subtitle" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="surname" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="title" mode="bibliography.mode"> + <span class="{name(.)}"> + <i><xsl:apply-templates mode="bibliography.mode"/></i> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="titleabbrev" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="volumenum" mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<xsl:template match="bibliocoverage|biblioid|bibliorelation|bibliosource" + mode="bibliography.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliography.mode"/> + <xsl:value-of select="$biblioentry.item.separator"/> + </span> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="bibliomixed.mode"> + <xsl:apply-templates select="."/><!-- try the default mode --> +</xsl:template> + +<xsl:template match="abbrev" mode="bibliomixed.mode"> + <xsl:if test="preceding-sibling::*"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </xsl:if> +</xsl:template> + +<xsl:template match="abstract" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="address" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="affiliation" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="shortaffil" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="jobtitle" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="artpagenums" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="author" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="authorblurb|personblurb" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="authorgroup" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="authorinitials" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="bibliomisc" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<!-- ================================================== --> + +<xsl:template match="bibliomset" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="bibliomset/title|bibliomset/citetitle" + mode="bibliomixed.mode"> + <xsl:variable name="relation" select="../@relation"/> + <xsl:choose> + <xsl:when test="$relation='article' or @pubwork='article'"> + <xsl:call-template name="gentext.startquote"/> + <xsl:apply-templates/> + <xsl:call-template name="gentext.endquote"/> + </xsl:when> + <xsl:otherwise> + <i><xsl:apply-templates/></i> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ================================================== --> + +<xsl:template match="biblioset" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="citetitle" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:choose> + <xsl:when test="@pubwork = 'article'"> + <xsl:call-template name="gentext.startquote"/> + <xsl:call-template name="inline.charseq"/> + <xsl:call-template name="gentext.endquote"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="inline.italicseq"/> + </xsl:otherwise> + </xsl:choose> + </span> +</xsl:template> + + +<xsl:template match="collab" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="confgroup" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="contractnum" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="contractsponsor" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="contrib" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="copyright" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="corpauthor" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="corpcredit" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="corpname" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="date" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="edition" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="editor" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="firstname" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="honorific" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="indexterm" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="invpartnumber" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="isbn" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="issn" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="issuenum" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="lineage" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="orgname" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="othercredit" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="othername" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="pagenums" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="printhistory" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="productname" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="productnumber" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="pubdate" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="publisher" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="publishername" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="pubsnumber" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="releaseinfo" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="revhistory" mode="bibliomixed.mode"> + <!-- suppressed; how could this be represented? --> +</xsl:template> + +<xsl:template match="seriesvolnums" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="subtitle" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="surname" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="title" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="titleabbrev" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="volumenum" mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<xsl:template match="bibliocoverage|biblioid|bibliorelation|bibliosource" + mode="bibliomixed.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="bibliomixed.mode"/> + </span> +</xsl:template> + +<!-- ==================================================================== --> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/block.xsl b/src/documentation/docbook-xsl/html/block.xsl new file mode 100644 index 0000000000..3f6adf1fbe --- /dev/null +++ b/src/documentation/docbook-xsl/html/block.xsl @@ -0,0 +1,432 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + +<!-- ******************************************************************** + $Id: block.xsl,v 1.23 2006/05/21 12:25:21 kosek Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> +<!-- What should we do about styling blockinfo? --> + +<xsl:template match="blockinfo"> + <!-- suppress --> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="block.object"> + <div class="{name(.)}"> + <xsl:call-template name="anchor"/> + <xsl:apply-templates/> + </div> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="para"> + <xsl:call-template name="paragraph"> + <xsl:with-param name="class"> + <xsl:if test="@role and $para.propagates.style != 0"> + <xsl:value-of select="@role"/> + </xsl:if> + </xsl:with-param> + <xsl:with-param name="content"> + <xsl:if test="position() = 1 and parent::listitem"> + <xsl:call-template name="anchor"> + <xsl:with-param name="node" select="parent::listitem"/> + </xsl:call-template> + </xsl:if> + + <xsl:call-template name="anchor"/> + <xsl:apply-templates/> + </xsl:with-param> + </xsl:call-template> +</xsl:template> + +<xsl:template name="paragraph"> + <xsl:param name="class" select="''"/> + <xsl:param name="content"/> + + <xsl:variable name="p"> + <p> + <xsl:call-template name="dir"/> + <xsl:if test="$class != ''"> + <xsl:attribute name="class"> + <xsl:value-of select="$class"/> + </xsl:attribute> + </xsl:if> + <xsl:copy-of select="$content"/> + </p> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$html.cleanup != 0"> + <xsl:call-template name="unwrap.p"> + <xsl:with-param name="p" select="$p"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$p"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="simpara"> + <!-- see also listitem/simpara in lists.xsl --> + <p> + <xsl:if test="@role and $para.propagates.style != 0"> + <xsl:attribute name="class"> + <xsl:value-of select="@role"/> + </xsl:attribute> + </xsl:if> + + <xsl:call-template name="anchor"/> + <xsl:apply-templates/> + </p> +</xsl:template> + +<xsl:template match="formalpara"> + <xsl:call-template name="paragraph"> + <xsl:with-param name="class"> + <xsl:if test="@role and $para.propagates.style != 0"> + <xsl:value-of select="@role"/> + </xsl:if> + </xsl:with-param> + <xsl:with-param name="content"> + <xsl:call-template name="anchor"/> + <xsl:apply-templates/> + </xsl:with-param> + </xsl:call-template> +</xsl:template> + +<xsl:template match="formalpara/title"> + <xsl:variable name="titleStr"> + <xsl:apply-templates/> + </xsl:variable> + <xsl:variable name="lastChar"> + <xsl:if test="$titleStr != ''"> + <xsl:value-of select="substring($titleStr,string-length($titleStr),1)"/> + </xsl:if> + </xsl:variable> + + <b> + <xsl:copy-of select="$titleStr"/> + <xsl:if test="$lastChar != '' + and not(contains($runinhead.title.end.punct, $lastChar))"> + <xsl:value-of select="$runinhead.default.title.end.punct"/> + </xsl:if> + <xsl:text> </xsl:text> + </b> +</xsl:template> + +<xsl:template match="formalpara/para"> + <xsl:apply-templates/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="blockquote"> + <div class="{local-name(.)}"> + <xsl:if test="@lang or @xml:lang"> + <xsl:call-template name="language.attribute"/> + </xsl:if> + <xsl:call-template name="anchor"/> + + <xsl:choose> + <xsl:when test="attribution"> + <table border="0" width="100%" + cellspacing="0" cellpadding="0" class="blockquote" + summary="Block quote"> + <tr> + <td width="10%" valign="top"> </td> + <td width="80%" valign="top"> + <xsl:apply-templates select="child::*[local-name(.)!='attribution']"/> + </td> + <td width="10%" valign="top"> </td> + </tr> + <tr> + <td width="10%" valign="top"> </td> + <td colspan="2" align="right" valign="top"> + <xsl:text>--</xsl:text> + <xsl:apply-templates select="attribution"/> + </td> + </tr> + </table> + </xsl:when> + <xsl:otherwise> + <blockquote class="{local-name(.)}"> + <xsl:apply-templates/> + </blockquote> + </xsl:otherwise> + </xsl:choose> + </div> +</xsl:template> + +<xsl:template match="blockquote/title"> + <div class="blockquote-title"> + <p> + <b> + <xsl:apply-templates/> + </b> + </p> + </div> +</xsl:template> + +<xsl:template match="epigraph"> + <div class="{name(.)}"> + <xsl:apply-templates select="para|simpara|formalpara|literallayout"/> + <xsl:if test="attribution"> + <div class="attribution"> + <span>--<xsl:apply-templates select="attribution"/></span> + </div> + </xsl:if> + </div> +</xsl:template> + +<xsl:template match="attribution"> + <span class="{name(.)}"><xsl:apply-templates/></span> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="sidebar"> + <div class="{name(.)}"> + <xsl:call-template name="anchor"/> + <xsl:apply-templates/> + </div> +</xsl:template> + +<xsl:template match="sidebar/title"> + <p class="title"> + <b><xsl:apply-templates/></b> + </p> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="abstract"> + <div class="{name(.)}"> + <xsl:call-template name="anchor"/> + <xsl:call-template name="formal.object.heading"> + <xsl:with-param name="title"> + <xsl:apply-templates select="." mode="title.markup"> + <xsl:with-param name="allow-anchors" select="'1'"/> + </xsl:apply-templates> + </xsl:with-param> + </xsl:call-template> + <xsl:apply-templates/> + </div> +</xsl:template> + +<xsl:template match="abstract/title"> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="msgset"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="msgentry"> + <xsl:call-template name="block.object"/> +</xsl:template> + +<xsl:template match="simplemsgentry"> + <xsl:call-template name="block.object"/> +</xsl:template> + +<xsl:template match="msg"> + <xsl:call-template name="block.object"/> +</xsl:template> + +<xsl:template match="msgmain"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="msgmain/title"> + <b><xsl:apply-templates/></b> +</xsl:template> + +<xsl:template match="msgsub"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="msgsub/title"> + <b><xsl:apply-templates/></b> +</xsl:template> + +<xsl:template match="msgrel"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="msgrel/title"> + <b><xsl:apply-templates/></b> +</xsl:template> + +<xsl:template match="msgtext"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="msginfo"> + <xsl:call-template name="block.object"/> +</xsl:template> + +<xsl:template match="msglevel"> + <p> + <b> + <xsl:call-template name="gentext.template"> + <xsl:with-param name="context" select="'msgset'"/> + <xsl:with-param name="name" select="'MsgLevel'"/> + </xsl:call-template> + </b> + <xsl:apply-templates/> + </p> +</xsl:template> + +<xsl:template match="msgorig"> + <p> + <b> + <xsl:call-template name="gentext.template"> + <xsl:with-param name="context" select="'msgset'"/> + <xsl:with-param name="name" select="'MsgOrig'"/> + </xsl:call-template> + </b> + <xsl:apply-templates/> + </p> +</xsl:template> + +<xsl:template match="msgaud"> + <p> + <b> + <xsl:call-template name="gentext.template"> + <xsl:with-param name="context" select="'msgset'"/> + <xsl:with-param name="name" select="'MsgAud'"/> + </xsl:call-template> + </b> + <xsl:apply-templates/> + </p> +</xsl:template> + +<xsl:template match="msgexplan"> + <xsl:call-template name="block.object"/> +</xsl:template> + +<xsl:template match="msgexplan/title"> + <p><b><xsl:apply-templates/></b></p> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="revhistory"> + <div class="{name(.)}"> + <table border="0" width="100%" summary="Revision history"> + <tr> + <th align="left" valign="top" colspan="3"> + <b> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'RevHistory'"/> + </xsl:call-template> + </b> + </th> + </tr> + <xsl:apply-templates/> + </table> + </div> +</xsl:template> + +<xsl:template match="revhistory/revision"> + <xsl:variable name="revnumber" select="revnumber"/> + <xsl:variable name="revdate" select="date"/> + <xsl:variable name="revauthor" select="authorinitials|author"/> + <xsl:variable name="revremark" select="revremark|revdescription"/> + <tr> + <td align="left"> + <xsl:if test="$revnumber"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'Revision'"/> + </xsl:call-template> + <xsl:call-template name="gentext.space"/> + <xsl:apply-templates select="$revnumber"/> + </xsl:if> + </td> + <td align="left"> + <xsl:apply-templates select="$revdate"/> + </td> + <xsl:choose> + <xsl:when test="count($revauthor)=0"> + <td align="left"> + <xsl:call-template name="dingbat"> + <xsl:with-param name="dingbat">nbsp</xsl:with-param> + </xsl:call-template> + </td> + </xsl:when> + <xsl:otherwise> + <td align="left"> + <xsl:for-each select="$revauthor"> + <xsl:apply-templates select="."/> + <xsl:if test="position() != last()"> + <xsl:text>, </xsl:text> + </xsl:if> + </xsl:for-each> + </td> + </xsl:otherwise> + </xsl:choose> + </tr> + <xsl:if test="$revremark"> + <tr> + <td align="left" colspan="3"> + <xsl:apply-templates select="$revremark"/> + </td> + </tr> + </xsl:if> +</xsl:template> + +<xsl:template match="revision/revnumber"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="revision/date"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="revision/authorinitials"> + <xsl:text>, </xsl:text> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="revision/authorinitials[1]" priority="2"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="revision/revremark"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="revision/revdescription"> + <xsl:apply-templates/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="ackno"> + <p class="{name(.)}"> + <xsl:apply-templates/> + </p> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="highlights"> + <xsl:call-template name="block.object"/> +</xsl:template> + +<!-- ==================================================================== --> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/callout.xsl b/src/documentation/docbook-xsl/html/callout.xsl new file mode 100644 index 0000000000..b613d84c61 --- /dev/null +++ b/src/documentation/docbook-xsl/html/callout.xsl @@ -0,0 +1,197 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:sverb="http://nwalsh.com/xslt/ext/com.nwalsh.saxon.Verbatim" + xmlns:xverb="com.nwalsh.xalan.Verbatim" + xmlns:lxslt="http://xml.apache.org/xslt" + exclude-result-prefixes="sverb xverb lxslt" + version='1.0'> + +<!-- ******************************************************************** + $Id: callout.xsl,v 1.11 2003/08/07 17:04:43 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<lxslt:component prefix="xverb" + functions="insertCallouts"/> + +<xsl:template match="programlistingco|screenco"> + <xsl:variable name="verbatim" select="programlisting|screen"/> + + <xsl:choose> + <xsl:when test="$use.extensions != '0' + and $callouts.extension != '0'"> + <xsl:variable name="rtf"> + <xsl:apply-templates select="$verbatim"> + <xsl:with-param name="suppress-numbers" select="'1'"/> + </xsl:apply-templates> + </xsl:variable> + + <xsl:variable name="rtf-with-callouts"> + <xsl:choose> + <xsl:when test="function-available('sverb:insertCallouts')"> + <xsl:copy-of select="sverb:insertCallouts(areaspec,$rtf)"/> + </xsl:when> + <xsl:when test="function-available('xverb:insertCallouts')"> + <xsl:copy-of select="xverb:insertCallouts(areaspec,$rtf)"/> + </xsl:when> + <xsl:otherwise> + <xsl:message terminate="yes"> + <xsl:text>No insertCallouts function is available.</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$verbatim/@linenumbering = 'numbered' + and $linenumbering.extension != '0'"> + <div class="{name(.)}"> + <xsl:call-template name="number.rtf.lines"> + <xsl:with-param name="rtf" select="$rtf-with-callouts"/> + <xsl:with-param name="pi.context" + select="programlisting|screen"/> + </xsl:call-template> + <xsl:apply-templates select="calloutlist"/> + </div> + </xsl:when> + <xsl:otherwise> + <div class="{name(.)}"> + <xsl:copy-of select="$rtf-with-callouts"/> + <xsl:apply-templates select="calloutlist"/> + </div> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <div class="{name(.)}"> + <xsl:apply-templates/> + </div> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="areaspec|areaset|area"> +</xsl:template> + +<xsl:template match="areaset" mode="conumber"> + <xsl:number count="area|areaset" format="1"/> +</xsl:template> + +<xsl:template match="area" mode="conumber"> + <xsl:number count="area|areaset" format="1"/> +</xsl:template> + +<xsl:template match="co" name="co"> + <!-- Support a single linkend in HTML --> + <xsl:variable name="targets" select="key('id', @linkends)"/> + <xsl:variable name="target" select="$targets[1]"/> + <xsl:choose> + <xsl:when test="$target"> + <a> + <xsl:if test="@id"> + <xsl:attribute name="name"> + <xsl:value-of select="@id"/> + </xsl:attribute> + </xsl:if> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$target"/> + </xsl:call-template> + </xsl:attribute> + <xsl:apply-templates select="." mode="callout-bug"/> + </a> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="anchor"/> + <xsl:apply-templates select="." mode="callout-bug"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="coref"> + <!-- tricky; this relies on the fact that we can process the "co" that's --> + <!-- "over there" as if it were "right here" --> + + <xsl:variable name="co" select="key('id', @linkend)"/> + <xsl:choose> + <xsl:when test="not($co)"> + <xsl:message> + <xsl:text>Error: coref link is broken: </xsl:text> + <xsl:value-of select="@linkend"/> + </xsl:message> + </xsl:when> + <xsl:when test="local-name($co) != 'co'"> + <xsl:message> + <xsl:text>Error: coref doesn't point to a co: </xsl:text> + <xsl:value-of select="@linkend"/> + </xsl:message> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$co"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="co" mode="callout-bug"> + <xsl:call-template name="callout-bug"> + <xsl:with-param name="conum"> + <xsl:number count="co" + level="any" + from="programlisting|screen|literallayout|synopsis" + format="1"/> + </xsl:with-param> + </xsl:call-template> +</xsl:template> + +<xsl:template name="callout-bug"> + <xsl:param name="conum" select='1'/> + + <xsl:choose> + <xsl:when test="$callout.graphics != 0 + and $conum <= $callout.graphics.number.limit"> + <img src="{$callout.graphics.path}{$conum}{$callout.graphics.extension}" + alt="{$conum}" border="0"/> + </xsl:when> + <xsl:when test="$callout.unicode != 0 + and $conum <= $callout.unicode.number.limit"> + <xsl:choose> + <xsl:when test="$callout.unicode.start.character = 10102"> + <xsl:choose> + <xsl:when test="$conum = 1">❶</xsl:when> + <xsl:when test="$conum = 2">❷</xsl:when> + <xsl:when test="$conum = 3">❸</xsl:when> + <xsl:when test="$conum = 4">❹</xsl:when> + <xsl:when test="$conum = 5">❺</xsl:when> + <xsl:when test="$conum = 6">❻</xsl:when> + <xsl:when test="$conum = 7">❼</xsl:when> + <xsl:when test="$conum = 8">❽</xsl:when> + <xsl:when test="$conum = 9">❾</xsl:when> + <xsl:when test="$conum = 10">❿</xsl:when> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>Don't know how to generate Unicode callouts </xsl:text> + <xsl:text>when $callout.unicode.start.character is </xsl:text> + <xsl:value-of select="$callout.unicode.start.character"/> + </xsl:message> + <xsl:text>(</xsl:text> + <xsl:value-of select="$conum"/> + <xsl:text>)</xsl:text> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:text>(</xsl:text> + <xsl:value-of select="$conum"/> + <xsl:text>)</xsl:text> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/changebars.xsl b/src/documentation/docbook-xsl/html/changebars.xsl new file mode 100644 index 0000000000..8df00d75e9 --- /dev/null +++ b/src/documentation/docbook-xsl/html/changebars.xsl @@ -0,0 +1,98 @@ +<?xml version="1.0"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<!-- ******************************************************************** + $Id: changebars.xsl,v 1.12 2005/02/01 07:33:38 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> +<xsl:import href="docbook.xsl"/> + +<xsl:param name="show.revisionflag" select="'1'"/> + +<xsl:template name="system.head.content"> +<xsl:param name="node" select="."/> + +<style type="text/css"> +<xsl:text> +div.added { background-color: #ffff99; } +div.deleted { text-decoration: line-through; + background-color: #FF7F7F; } +div.changed { background-color: #99ff99; } +div.off { } + +span.added { background-color: #ffff99; } +span.deleted { text-decoration: line-through; + background-color: #FF7F7F; } +span.changed { background-color: #99ff99; } +span.off { } +</xsl:text> +</style> +</xsl:template> + +<xsl:template match="*[@revisionflag]"> + <xsl:choose> + <xsl:when test="local-name(.) = 'para' + or local-name(.) = 'simpara' + or local-name(.) = 'formalpara' + or local-name(.) = 'section' + or local-name(.) = 'sect1' + or local-name(.) = 'sect2' + or local-name(.) = 'sect3' + or local-name(.) = 'sect4' + or local-name(.) = 'sect5' + or local-name(.) = 'chapter' + or local-name(.) = 'preface' + or local-name(.) = 'itemizedlist' + or local-name(.) = 'varlistentry' + or local-name(.) = 'glossary' + or local-name(.) = 'bibliography' + or local-name(.) = 'index' + or local-name(.) = 'appendix'"> + <div class='{@revisionflag}'> + <xsl:apply-imports/> + </div> + </xsl:when> + <xsl:when test="local-name(.) = 'phrase' + or local-name(.) = 'ulink' + or local-name(.) = 'link' + or local-name(.) = 'filename' + or local-name(.) = 'literal' + or local-name(.) = 'member' + or local-name(.) = 'glossterm' + or local-name(.) = 'sgmltag' + or local-name(.) = 'quote' + or local-name(.) = 'emphasis' + or local-name(.) = 'command' + or local-name(.) = 'xref'"> + <span class='{@revisionflag}'> + <xsl:apply-imports/> + </span> + </xsl:when> + <xsl:when test="local-name(.) = 'listitem' + or local-name(.) = 'entry' + or local-name(.) = 'title'"> + <!-- nop; these are handled directly in the stylesheet --> + <xsl:apply-imports/> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>Revisionflag on unexpected element: </xsl:text> + <xsl:value-of select="local-name(.)"/> + <xsl:text> (Assuming block)</xsl:text> + </xsl:message> + <div class='{@revisionflag}'> + <xsl:apply-imports/> + </div> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/chunk-code.xsl b/src/documentation/docbook-xsl/html/chunk-code.xsl new file mode 100644 index 0000000000..be7988e13f --- /dev/null +++ b/src/documentation/docbook-xsl/html/chunk-code.xsl @@ -0,0 +1,1042 @@ +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:exsl="http://exslt.org/common" + xmlns:cf="http://docbook.sourceforge.net/xmlns/chunkfast/1.0" + xmlns:ng="http://docbook.org/docbook-ng" + xmlns:db="http://docbook.org/ns/docbook" + version="1.0" + exclude-result-prefixes="exsl cf ng db"> + +<!-- ******************************************************************** + $Id: chunk-code.xsl,v 1.15 2006/05/04 12:46:45 kosek Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:param name="onechunk" select="0"/> +<xsl:param name="refentry.separator" select="0"/> +<xsl:param name="chunk.fast" select="0"/> + +<xsl:key name="genid" match="*" use="generate-id()"/> + +<!-- ==================================================================== --> + +<xsl:variable name="chunk.hierarchy"> + <xsl:if test="$chunk.fast != 0"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"> + <xsl:message>Computing chunks...</xsl:message> + <xsl:apply-templates select="/*" mode="find.chunks"/> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>Fast chunking requires exsl:node-set(). </xsl:text> + <xsl:text>Using "slow" chunking.</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> + </xsl:if> +</xsl:variable> + +<xsl:template match="*" mode="find.chunks"> + <xsl:variable name="chunk"> + <xsl:call-template name="chunk"/> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$chunk != 0"> + <cf:div class="{local-name(.)}" id="{generate-id()}"> + <xsl:apply-templates select="*" mode="find.chunks"/> + </cf:div> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="*" mode="find.chunks"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="process-chunk-element"> + <xsl:param name="content"> + <xsl:apply-imports/> + </xsl:param> + + <xsl:choose> + <xsl:when test="$chunk.fast != 0 and function-available('exsl:node-set')"> + <xsl:variable name="chunks" select="exsl:node-set($chunk.hierarchy)//cf:div"/> + <xsl:variable name="genid" select="generate-id()"/> + + <xsl:variable name="div" select="$chunks[@id=$genid]"/> + + <xsl:variable name="prevdiv" + select="($div/preceding-sibling::cf:div|$div/preceding::cf:div|$div/parent::cf:div)[last()]"/> + <xsl:variable name="prev" select="key('genid', $prevdiv/@id)"/> + + <xsl:variable name="nextdiv" + select="($div/following-sibling::cf:div|$div/following::cf:div|$div/cf:div)[1]"/> + <xsl:variable name="next" select="key('genid', $nextdiv/@id)"/> + + <xsl:choose> + <xsl:when test="$onechunk != 0 and parent::*"> + <xsl:copy-of select="$content"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="process-chunk"> + <xsl:with-param name="prev" select="$prev"/> + <xsl:with-param name="next" select="$next"/> + <xsl:with-param name="content" select="$content"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="$onechunk != 0 and not(parent::*)"> + <xsl:call-template name="chunk-all-sections"> + <xsl:with-param name="content" select="$content"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$onechunk != 0"> + <xsl:copy-of select="$content"/> + </xsl:when> + <xsl:when test="$chunk.first.sections = 0"> + <xsl:call-template name="chunk-first-section-with-parent"> + <xsl:with-param name="content" select="$content"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="chunk-all-sections"> + <xsl:with-param name="content" select="$content"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="process-chunk"> + <xsl:param name="prev" select="."/> + <xsl:param name="next" select="."/> + <xsl:param name="content"> + <xsl:apply-imports/> + </xsl:param> + + <xsl:variable name="ischunk"> + <xsl:call-template name="chunk"/> + </xsl:variable> + + <xsl:variable name="chunkfn"> + <xsl:if test="$ischunk='1'"> + <xsl:apply-templates mode="chunk-filename" select="."/> + </xsl:if> + </xsl:variable> + + <xsl:if test="$ischunk='0'"> + <xsl:message> + <xsl:text>Error </xsl:text> + <xsl:value-of select="name(.)"/> + <xsl:text> is not a chunk!</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:variable name="filename"> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.dir" select="$base.dir"/> + <xsl:with-param name="base.name" select="$chunkfn"/> + </xsl:call-template> + </xsl:variable> + + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename" select="$filename"/> + <xsl:with-param name="content"> + <xsl:call-template name="chunk-element-content"> + <xsl:with-param name="prev" select="$prev"/> + <xsl:with-param name="next" select="$next"/> + <xsl:with-param name="content" select="$content"/> + </xsl:call-template> + </xsl:with-param> + <xsl:with-param name="quiet" select="$chunk.quietly"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="chunk-first-section-with-parent"> + <xsl:param name="content"> + <xsl:apply-imports/> + </xsl:param> + + <!-- These xpath expressions are really hairy. The trick is to pick sections --> + <!-- that are not first children and are not the children of first children --> + + <!-- Break these variables into pieces to work around + http://nagoya.apache.org/bugzilla/show_bug.cgi?id=6063 --> + + <xsl:variable name="prev-v1" + select="(ancestor::sect1[$chunk.section.depth > 0 + and preceding-sibling::sect1][1] + + |ancestor::sect2[$chunk.section.depth > 1 + and preceding-sibling::sect2 + and parent::sect1[preceding-sibling::sect1]][1] + + |ancestor::sect3[$chunk.section.depth > 2 + and preceding-sibling::sect3 + and parent::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |ancestor::sect4[$chunk.section.depth > 3 + and preceding-sibling::sect4 + and parent::sect3[preceding-sibling::sect2] + and ancestor::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |ancestor::sect5[$chunk.section.depth > 4 + and preceding-sibling::sect5 + and parent::sect4[preceding-sibling::sect4] + and ancestor::sect3[preceding-sibling::sect3] + and ancestor::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |ancestor::section[$chunk.section.depth > count(ancestor::section) + and not(ancestor::section[not(preceding-sibling::section)])][1])[last()]"/> + + <xsl:variable name="prev-v2" + select="(preceding::sect1[$chunk.section.depth > 0 + and preceding-sibling::sect1][1] + + |preceding::sect2[$chunk.section.depth > 1 + and preceding-sibling::sect2 + and parent::sect1[preceding-sibling::sect1]][1] + + |preceding::sect3[$chunk.section.depth > 2 + and preceding-sibling::sect3 + and parent::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |preceding::sect4[$chunk.section.depth > 3 + and preceding-sibling::sect4 + and parent::sect3[preceding-sibling::sect2] + and ancestor::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |preceding::sect5[$chunk.section.depth > 4 + and preceding-sibling::sect5 + and parent::sect4[preceding-sibling::sect4] + and ancestor::sect3[preceding-sibling::sect3] + and ancestor::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |preceding::section[$chunk.section.depth > count(ancestor::section) + and preceding-sibling::section + and not(ancestor::section[not(preceding-sibling::section)])][1])[last()]"/> + + <xsl:variable name="prev" + select="(preceding::book[1] + |preceding::preface[1] + |preceding::chapter[1] + |preceding::appendix[1] + |preceding::part[1] + |preceding::reference[1] + |preceding::refentry[1] + |preceding::colophon[1] + |preceding::article[1] + |preceding::bibliography[parent::article or parent::book or parent::part][1] + |preceding::glossary[parent::article or parent::book or parent::part][1] + |preceding::index[$generate.index != 0] + [parent::article or parent::book or parent::part][1] + |preceding::setindex[$generate.index != 0][1] + |ancestor::set + |ancestor::book[1] + |ancestor::preface[1] + |ancestor::chapter[1] + |ancestor::appendix[1] + |ancestor::part[1] + |ancestor::reference[1] + |ancestor::article[1] + |$prev-v1 + |$prev-v2)[last()]"/> + + <xsl:variable name="next-v1" + select="(following::sect1[$chunk.section.depth > 0 + and preceding-sibling::sect1][1] + + |following::sect2[$chunk.section.depth > 1 + and preceding-sibling::sect2 + and parent::sect1[preceding-sibling::sect1]][1] + + |following::sect3[$chunk.section.depth > 2 + and preceding-sibling::sect3 + and parent::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |following::sect4[$chunk.section.depth > 3 + and preceding-sibling::sect4 + and parent::sect3[preceding-sibling::sect2] + and ancestor::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |following::sect5[$chunk.section.depth > 4 + and preceding-sibling::sect5 + and parent::sect4[preceding-sibling::sect4] + and ancestor::sect3[preceding-sibling::sect3] + and ancestor::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |following::section[$chunk.section.depth > count(ancestor::section) + and preceding-sibling::section + and not(ancestor::section[not(preceding-sibling::section)])][1])[1]"/> + + <xsl:variable name="next-v2" + select="(descendant::sect1[$chunk.section.depth > 0 + and preceding-sibling::sect1][1] + + |descendant::sect2[$chunk.section.depth > 1 + and preceding-sibling::sect2 + and parent::sect1[preceding-sibling::sect1]][1] + + |descendant::sect3[$chunk.section.depth > 2 + and preceding-sibling::sect3 + and parent::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |descendant::sect4[$chunk.section.depth > 3 + and preceding-sibling::sect4 + and parent::sect3[preceding-sibling::sect2] + and ancestor::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |descendant::sect5[$chunk.section.depth > 4 + and preceding-sibling::sect5 + and parent::sect4[preceding-sibling::sect4] + and ancestor::sect3[preceding-sibling::sect3] + and ancestor::sect2[preceding-sibling::sect2] + and ancestor::sect1[preceding-sibling::sect1]][1] + + |descendant::section[$chunk.section.depth > count(ancestor::section) + and preceding-sibling::section + and not(ancestor::section[not(preceding-sibling::section)])])[1]"/> + + <xsl:variable name="next" + select="(following::book[1] + |following::preface[1] + |following::chapter[1] + |following::appendix[1] + |following::part[1] + |following::reference[1] + |following::refentry[1] + |following::colophon[1] + |following::bibliography[parent::article or parent::book or parent::part][1] + |following::glossary[parent::article or parent::book or parent::part][1] + |following::index[$generate.index != 0] + [parent::article or parent::book or parent::part][1] + |following::article[1] + |following::setindex[$generate.index != 0][1] + |descendant::book[1] + |descendant::preface[1] + |descendant::chapter[1] + |descendant::appendix[1] + |descendant::article[1] + |descendant::bibliography[parent::article or parent::book or parent::part][1] + |descendant::glossary[parent::article or parent::book or parent::part][1] + |descendant::index[$generate.index != 0] + [parent::article or parent::book or parent::part][1] + |descendant::colophon[1] + |descendant::setindex[$generate.index != 0][1] + |descendant::part[1] + |descendant::reference[1] + |descendant::refentry[1] + |$next-v1 + |$next-v2)[1]"/> + + <xsl:call-template name="process-chunk"> + <xsl:with-param name="prev" select="$prev"/> + <xsl:with-param name="next" select="$next"/> + <xsl:with-param name="content" select="$content"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="chunk-all-sections"> + <xsl:param name="content"> + <xsl:apply-imports/> + </xsl:param> + + <xsl:variable name="prev-v1" + select="(preceding::sect1[$chunk.section.depth > 0][1] + |preceding::sect2[$chunk.section.depth > 1][1] + |preceding::sect3[$chunk.section.depth > 2][1] + |preceding::sect4[$chunk.section.depth > 3][1] + |preceding::sect5[$chunk.section.depth > 4][1] + |preceding::section[$chunk.section.depth > count(ancestor::section)][1])[last()]"/> + + <xsl:variable name="prev-v2" + select="(ancestor::sect1[$chunk.section.depth > 0][1] + |ancestor::sect2[$chunk.section.depth > 1][1] + |ancestor::sect3[$chunk.section.depth > 2][1] + |ancestor::sect4[$chunk.section.depth > 3][1] + |ancestor::sect5[$chunk.section.depth > 4][1] + |ancestor::section[$chunk.section.depth > count(ancestor::section)][1])[last()]"/> + + <xsl:variable name="prev" + select="(preceding::book[1] + |preceding::preface[1] + |preceding::chapter[1] + |preceding::appendix[1] + |preceding::part[1] + |preceding::reference[1] + |preceding::refentry[1] + |preceding::colophon[1] + |preceding::article[1] + |preceding::bibliography[parent::article or parent::book or parent::part][1] + |preceding::glossary[parent::article or parent::book or parent::part][1] + |preceding::index[$generate.index != 0] + [parent::article or parent::book or parent::part][1] + |preceding::setindex[$generate.index != 0][1] + |ancestor::set + |ancestor::book[1] + |ancestor::preface[1] + |ancestor::chapter[1] + |ancestor::appendix[1] + |ancestor::part[1] + |ancestor::reference[1] + |ancestor::article[1] + |$prev-v1 + |$prev-v2)[last()]"/> + + <xsl:variable name="next-v1" + select="(following::sect1[$chunk.section.depth > 0][1] + |following::sect2[$chunk.section.depth > 1][1] + |following::sect3[$chunk.section.depth > 2][1] + |following::sect4[$chunk.section.depth > 3][1] + |following::sect5[$chunk.section.depth > 4][1] + |following::section[$chunk.section.depth > count(ancestor::section)][1])[1]"/> + + <xsl:variable name="next-v2" + select="(descendant::sect1[$chunk.section.depth > 0][1] + |descendant::sect2[$chunk.section.depth > 1][1] + |descendant::sect3[$chunk.section.depth > 2][1] + |descendant::sect4[$chunk.section.depth > 3][1] + |descendant::sect5[$chunk.section.depth > 4][1] + |descendant::section[$chunk.section.depth + > count(ancestor::section)][1])[1]"/> + + <xsl:variable name="next" + select="(following::book[1] + |following::preface[1] + |following::chapter[1] + |following::appendix[1] + |following::part[1] + |following::reference[1] + |following::refentry[1] + |following::colophon[1] + |following::bibliography[parent::article or parent::book or parent::part][1] + |following::glossary[parent::article or parent::book or parent::part][1] + |following::index[$generate.index != 0] + [parent::article or parent::book][1] + |following::article[1] + |following::setindex[$generate.index != 0][1] + |descendant::book[1] + |descendant::preface[1] + |descendant::chapter[1] + |descendant::appendix[1] + |descendant::article[1] + |descendant::bibliography[parent::article or parent::book][1] + |descendant::glossary[parent::article or parent::book or parent::part][1] + |descendant::index[$generate.index != 0] + [parent::article or parent::book][1] + |descendant::colophon[1] + |descendant::setindex[$generate.index != 0][1] + |descendant::part[1] + |descendant::reference[1] + |descendant::refentry[1] + |$next-v1 + |$next-v2)[1]"/> + + <xsl:call-template name="process-chunk"> + <xsl:with-param name="prev" select="$prev"/> + <xsl:with-param name="next" select="$next"/> + <xsl:with-param name="content" select="$content"/> + </xsl:call-template> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="/"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set') + and (*/self::ng:* or */self::db:*)"> + <!-- Hack! If someone hands us a DocBook V5.x or DocBook NG document, + toss the namespace and continue. Someday we'll reverse this logic + and add the namespace to documents that don't have one. + But not before the whole stylesheet has been converted to use + namespaces. i.e., don't hold your breath --> + <xsl:message>Stripping NS from DocBook 5/NG document.</xsl:message> + <xsl:variable name="nons"> + <xsl:apply-templates mode="stripNS"/> + </xsl:variable> + <xsl:message>Processing stripped document.</xsl:message> + <xsl:apply-templates select="exsl:node-set($nons)"/> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:choose> + <xsl:when test="count(key('id',$rootid)) = 0"> + <xsl:message terminate="yes"> + <xsl:text>ID '</xsl:text> + <xsl:value-of select="$rootid"/> + <xsl:text>' not found in document.</xsl:text> + </xsl:message> + </xsl:when> + <xsl:otherwise> + <xsl:if test="$collect.xref.targets = 'yes' or + $collect.xref.targets = 'only'"> + <xsl:apply-templates select="key('id', $rootid)" + mode="collect.targets"/> + </xsl:if> + <xsl:if test="$collect.xref.targets != 'only'"> + <xsl:apply-templates select="key('id',$rootid)" + mode="process.root"/> + <xsl:if test="$tex.math.in.alt != ''"> + <xsl:apply-templates select="key('id',$rootid)" + mode="collect.tex.math"/> + </xsl:if> + <xsl:if test="$generate.manifest != 0"> + <xsl:call-template name="generate.manifest"> + <xsl:with-param name="node" select="key('id',$rootid)"/> + </xsl:call-template> + </xsl:if> + </xsl:if> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:if test="$collect.xref.targets = 'yes' or + $collect.xref.targets = 'only'"> + <xsl:apply-templates select="/" mode="collect.targets"/> + </xsl:if> + <xsl:if test="$collect.xref.targets != 'only'"> + <xsl:apply-templates select="/" mode="process.root"/> + <xsl:if test="$tex.math.in.alt != ''"> + <xsl:apply-templates select="/" mode="collect.tex.math"/> + </xsl:if> + <xsl:if test="$generate.manifest != 0"> + <xsl:call-template name="generate.manifest"> + <xsl:with-param name="node" select="/"/> + </xsl:call-template> + </xsl:if> + </xsl:if> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="*" mode="process.root"> + <xsl:apply-templates select="."/> +</xsl:template> + +<!-- ====================================================================== --> + +<xsl:template match="set|book|part|preface|chapter|appendix + |article + |reference|refentry + |book/glossary|article/glossary|part/glossary + |book/bibliography|article/bibliography|part/bibliography + |colophon"> + <xsl:choose> + <xsl:when test="$onechunk != 0 and parent::*"> + <xsl:apply-imports/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="process-chunk-element"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="sect1|sect2|sect3|sect4|sect5|section"> + <xsl:variable name="ischunk"> + <xsl:call-template name="chunk"/> + </xsl:variable> + + <xsl:choose> + <xsl:when test="not(parent::*)"> + <xsl:call-template name="process-chunk-element"/> + </xsl:when> + <xsl:when test="$ischunk = 0"> + <xsl:apply-imports/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="process-chunk-element"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="setindex + |book/index + |article/index + |part/index"> + <!-- some implementations use completely empty index tags to indicate --> + <!-- where an automatically generated index should be inserted. so --> + <!-- if the index is completely empty, skip it. --> + <xsl:if test="count(*)>0 or $generate.index != '0'"> + <xsl:call-template name="process-chunk-element"/> + </xsl:if> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="make.lots"> + <xsl:param name="toc.params" select="''"/> + <xsl:param name="toc"/> + + <xsl:variable name="lots"> + <xsl:if test="contains($toc.params, 'toc')"> + <xsl:copy-of select="$toc"/> + </xsl:if> + + <xsl:if test="contains($toc.params, 'figure')"> + <xsl:choose> + <xsl:when test="$chunk.separate.lots != '0'"> + <xsl:call-template name="make.lot.chunk"> + <xsl:with-param name="type" select="'figure'"/> + <xsl:with-param name="lot"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'figure'"/> + <xsl:with-param name="nodes" select=".//figure"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'figure'"/> + <xsl:with-param name="nodes" select=".//figure"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:if test="contains($toc.params, 'table')"> + <xsl:choose> + <xsl:when test="$chunk.separate.lots != '0'"> + <xsl:call-template name="make.lot.chunk"> + <xsl:with-param name="type" select="'table'"/> + <xsl:with-param name="lot"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'table'"/> + <xsl:with-param name="nodes" select=".//table"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'table'"/> + <xsl:with-param name="nodes" select=".//table"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:if test="contains($toc.params, 'example')"> + <xsl:choose> + <xsl:when test="$chunk.separate.lots != '0'"> + <xsl:call-template name="make.lot.chunk"> + <xsl:with-param name="type" select="'example'"/> + <xsl:with-param name="lot"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'example'"/> + <xsl:with-param name="nodes" select=".//example"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'example'"/> + <xsl:with-param name="nodes" select=".//example"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:if test="contains($toc.params, 'equation')"> + <xsl:choose> + <xsl:when test="$chunk.separate.lots != '0'"> + <xsl:call-template name="make.lot.chunk"> + <xsl:with-param name="type" select="'equation'"/> + <xsl:with-param name="lot"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'equation'"/> + <xsl:with-param name="nodes" select=".//equation"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'equation'"/> + <xsl:with-param name="nodes" select=".//equation"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:if test="contains($toc.params, 'procedure')"> + <xsl:choose> + <xsl:when test="$chunk.separate.lots != '0'"> + <xsl:call-template name="make.lot.chunk"> + <xsl:with-param name="type" select="'procedure'"/> + <xsl:with-param name="lot"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'procedure'"/> + <xsl:with-param name="nodes" select=".//procedure[title]"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'procedure'"/> + <xsl:with-param name="nodes" select=".//procedure[title]"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + </xsl:variable> + + <xsl:if test="string($lots) != ''"> + <xsl:choose> + <xsl:when test="$chunk.tocs.and.lots != 0 and not(parent::*)"> + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename"> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.dir" select="$base.dir"/> + <xsl:with-param name="base.name"> + <xsl:call-template name="dbhtml-dir"/> + <xsl:apply-templates select="." mode="recursive-chunk-filename"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + <xsl:text>-toc</xsl:text> + <xsl:value-of select="$html.ext"/> + </xsl:with-param> + </xsl:call-template> + </xsl:with-param> + <xsl:with-param name="content"> + <xsl:call-template name="chunk-element-content"> + <xsl:with-param name="prev" select="/foo"/> + <xsl:with-param name="next" select="/foo"/> + <xsl:with-param name="nav.context" select="'toc'"/> + <xsl:with-param name="content"> + <xsl:if test="$chunk.tocs.and.lots.has.title != 0"> + <h1> + <xsl:apply-templates select="." mode="object.title.markup"/> + </h1> + </xsl:if> + <xsl:copy-of select="$lots"/> + </xsl:with-param> + </xsl:call-template> + </xsl:with-param> + <xsl:with-param name="quiet" select="$chunk.quietly"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$lots"/> + </xsl:otherwise> + </xsl:choose> + </xsl:if> +</xsl:template> + +<xsl:template name="make.lot.chunk"> + <xsl:param name="type" select="''"/> + <xsl:param name="lot"/> + + <xsl:if test="string($lot) != ''"> + <xsl:variable name="filename"> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.dir" select="$base.dir"/> + <xsl:with-param name="base.name"> + <xsl:call-template name="dbhtml-dir"/> + <xsl:value-of select="$type"/> + <xsl:text>-toc</xsl:text> + <xsl:value-of select="$html.ext"/> + </xsl:with-param> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="href"> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.name"> + <xsl:call-template name="dbhtml-dir"/> + <xsl:value-of select="$type"/> + <xsl:text>-toc</xsl:text> + <xsl:value-of select="$html.ext"/> + </xsl:with-param> + </xsl:call-template> + </xsl:variable> + + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename" select="$filename"/> + <xsl:with-param name="content"> + <xsl:call-template name="chunk-element-content"> + <xsl:with-param name="prev" select="/foo"/> + <xsl:with-param name="next" select="/foo"/> + <xsl:with-param name="nav.context" select="'toc'"/> + <xsl:with-param name="content"> + <xsl:copy-of select="$lot"/> + </xsl:with-param> + </xsl:call-template> + </xsl:with-param> + <xsl:with-param name="quiet" select="$chunk.quietly"/> + </xsl:call-template> + <!-- And output a link to this file --> + <div> + <xsl:attribute name="class"> + <xsl:text>ListofTitles</xsl:text> + </xsl:attribute> + <a href="{$href}"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key"> + <xsl:choose> + <xsl:when test="$type='table'">ListofTables</xsl:when> + <xsl:when test="$type='figure'">ListofFigures</xsl:when> + <xsl:when test="$type='equation'">ListofEquations</xsl:when> + <xsl:when test="$type='example'">ListofExamples</xsl:when> + <xsl:when test="$type='procedure'">ListofProcedures</xsl:when> + <xsl:otherwise>ListofUnknown</xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:call-template> + </a> + </div> + </xsl:if> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="in.other.chunk"> + <xsl:param name="chunk" select="."/> + <xsl:param name="node" select="."/> + + <xsl:variable name="is.chunk"> + <xsl:call-template name="chunk"> + <xsl:with-param name="node" select="$node"/> + </xsl:call-template> + </xsl:variable> + +<!-- + <xsl:message> + <xsl:text>in.other.chunk: </xsl:text> + <xsl:value-of select="name($chunk)"/> + <xsl:text> </xsl:text> + <xsl:value-of select="name($node)"/> + <xsl:text> </xsl:text> + <xsl:value-of select="$chunk = $node"/> + <xsl:text> </xsl:text> + <xsl:value-of select="$is.chunk"/> + </xsl:message> +--> + + <xsl:choose> + <xsl:when test="$chunk = $node">0</xsl:when> + <xsl:when test="$is.chunk = 1">1</xsl:when> + <xsl:when test="count($node) = 0">0</xsl:when> + <xsl:otherwise> + <xsl:call-template name="in.other.chunk"> + <xsl:with-param name="chunk" select="$chunk"/> + <xsl:with-param name="node" select="$node/parent::*"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="count.footnotes.in.this.chunk"> + <xsl:param name="node" select="."/> + <xsl:param name="footnotes" select="$node//footnote"/> + <xsl:param name="count" select="0"/> + +<!-- + <xsl:message> + <xsl:text>count.footnotes.in.this.chunk: </xsl:text> + <xsl:value-of select="name($node)"/> + </xsl:message> +--> + + <xsl:variable name="in.other.chunk"> + <xsl:call-template name="in.other.chunk"> + <xsl:with-param name="chunk" select="$node"/> + <xsl:with-param name="node" select="$footnotes[1]"/> + </xsl:call-template> + </xsl:variable> + + <xsl:choose> + <xsl:when test="count($footnotes) = 0"> + <xsl:value-of select="$count"/> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="$in.other.chunk != 0"> + <xsl:call-template name="count.footnotes.in.this.chunk"> + <xsl:with-param name="node" select="$node"/> + <xsl:with-param name="footnotes" + select="$footnotes[position() > 1]"/> + <xsl:with-param name="count" select="$count"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$footnotes[1]/ancestor::table + |$footnotes[1]/ancestor::informaltable"> + <xsl:call-template name="count.footnotes.in.this.chunk"> + <xsl:with-param name="node" select="$node"/> + <xsl:with-param name="footnotes" + select="$footnotes[position() > 1]"/> + <xsl:with-param name="count" select="$count"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="count.footnotes.in.this.chunk"> + <xsl:with-param name="node" select="$node"/> + <xsl:with-param name="footnotes" + select="$footnotes[position() > 1]"/> + <xsl:with-param name="count" select="$count + 1"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="process.footnotes.in.this.chunk"> + <xsl:param name="node" select="."/> + <xsl:param name="footnotes" select="$node//footnote"/> + +<!-- + <xsl:message>process.footnotes.in.this.chunk</xsl:message> +--> + + <xsl:variable name="in.other.chunk"> + <xsl:call-template name="in.other.chunk"> + <xsl:with-param name="chunk" select="$node"/> + <xsl:with-param name="node" select="$footnotes[1]"/> + </xsl:call-template> + </xsl:variable> + + <xsl:choose> + <xsl:when test="count($footnotes) = 0"> + <!-- nop --> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="$in.other.chunk != 0"> + <xsl:call-template name="process.footnotes.in.this.chunk"> + <xsl:with-param name="node" select="$node"/> + <xsl:with-param name="footnotes" + select="$footnotes[position() > 1]"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$footnotes[1]/ancestor::table + |$footnotes[1]/ancestor::informaltable"> + <xsl:call-template name="process.footnotes.in.this.chunk"> + <xsl:with-param name="node" select="$node"/> + <xsl:with-param name="footnotes" + select="$footnotes[position() > 1]"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$footnotes[1]" + mode="process.footnote.mode"/> + <xsl:call-template name="process.footnotes.in.this.chunk"> + <xsl:with-param name="node" select="$node"/> + <xsl:with-param name="footnotes" + select="$footnotes[position() > 1]"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="process.footnotes"> + <xsl:variable name="footnotes" select=".//footnote"/> + <xsl:variable name="fcount"> + <xsl:call-template name="count.footnotes.in.this.chunk"> + <xsl:with-param name="node" select="."/> + <xsl:with-param name="footnotes" select="$footnotes"/> + </xsl:call-template> + </xsl:variable> + +<!-- + <xsl:message> + <xsl:value-of select="name(.)"/> + <xsl:text> fcount: </xsl:text> + <xsl:value-of select="$fcount"/> + </xsl:message> +--> + + <!-- Only bother to do this if there's at least one non-table footnote --> + <xsl:if test="$fcount > 0"> + <div class="footnotes"> + <br/> + <hr width="100" align="left"/> + <xsl:call-template name="process.footnotes.in.this.chunk"> + <xsl:with-param name="node" select="."/> + <xsl:with-param name="footnotes" select="$footnotes"/> + </xsl:call-template> + </div> + </xsl:if> + + <!-- FIXME: When chunking, only the annotations actually used + in this chunk should be referenced. I don't think it + does any harm to reference them all, but it adds + unnecessary bloat to each chunk. --> + <xsl:if test="$annotation.support != 0 and //annotation"> + <div class="annotation-list"> + <div class="annotation-nocss"> + <p>The following annotations are from this essay. You are seeing + them here because your browser doesn’t support the user-interface + techniques used to make them appear as ‘popups’ on modern browsers.</p> + </div> + + <xsl:apply-templates select="//annotation" + mode="annotation-popup"/> + </div> + </xsl:if> +</xsl:template> + +<xsl:template name="process.chunk.footnotes"> + <xsl:variable name="is.chunk"> + <xsl:call-template name="chunk"/> + </xsl:variable> + <xsl:if test="$is.chunk = 1"> + <xsl:call-template name="process.footnotes"/> + </xsl:if> +</xsl:template> + +<!-- ====================================================================== --> + +<!-- Resolve xml:base attributes --> +<xsl:template match="@fileref"> + <!-- need a check for absolute urls --> + <xsl:choose> + <xsl:when test="contains(., ':')"> + <!-- it has a uri scheme so it is an absolute uri --> + <xsl:value-of select="."/> + </xsl:when> + <xsl:otherwise> + <!-- its a relative uri --> + <xsl:call-template name="relative-uri"> + <xsl:with-param name="destdir"> + <xsl:call-template name="dbhtml-dir"> + <xsl:with-param name="context" select=".."/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/chunk-common.xsl b/src/documentation/docbook-xsl/html/chunk-common.xsl new file mode 100644 index 0000000000..75f002b128 --- /dev/null +++ b/src/documentation/docbook-xsl/html/chunk-common.xsl @@ -0,0 +1,1088 @@ +<?xml version="1.0"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<!-- ******************************************************************** + $Id: chunk-common.xsl,v 1.45 2006/04/27 08:59:37 xmldoc Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:template name="chunk"> + <xsl:param name="node" select="."/> + <!-- returns 1 if $node is a chunk --> + + <!-- ==================================================================== --> + <!-- What's a chunk? + + The root element + appendix + article + bibliography in article or part or book + book + chapter + colophon + glossary in article or part or book + index in article or part or book + part + preface + refentry + reference + sect{1,2,3,4,5} if position()>1 && depth < chunk.section.depth + section if position()>1 && depth < chunk.section.depth + set + setindex + --> + <!-- ==================================================================== --> + +<!-- + <xsl:message> + <xsl:text>chunk: </xsl:text> + <xsl:value-of select="name($node)"/> + <xsl:text>(</xsl:text> + <xsl:value-of select="$node/@id"/> + <xsl:text>)</xsl:text> + <xsl:text> csd: </xsl:text> + <xsl:value-of select="$chunk.section.depth"/> + <xsl:text> cfs: </xsl:text> + <xsl:value-of select="$chunk.first.sections"/> + <xsl:text> ps: </xsl:text> + <xsl:value-of select="count($node/parent::section)"/> + <xsl:text> prs: </xsl:text> + <xsl:value-of select="count($node/preceding-sibling::section)"/> + </xsl:message> +--> + + <xsl:choose> + <xsl:when test="not($node/parent::*)">1</xsl:when> + + <xsl:when test="local-name($node) = 'sect1' + and $chunk.section.depth >= 1 + and ($chunk.first.sections != 0 + or count($node/preceding-sibling::sect1) > 0)"> + <xsl:text>1</xsl:text> + </xsl:when> + <xsl:when test="local-name($node) = 'sect2' + and $chunk.section.depth >= 2 + and ($chunk.first.sections != 0 + or count($node/preceding-sibling::sect2) > 0)"> + <xsl:call-template name="chunk"> + <xsl:with-param name="node" select="$node/parent::*"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="local-name($node) = 'sect3' + and $chunk.section.depth >= 3 + and ($chunk.first.sections != 0 + or count($node/preceding-sibling::sect3) > 0)"> + <xsl:call-template name="chunk"> + <xsl:with-param name="node" select="$node/parent::*"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="local-name($node) = 'sect4' + and $chunk.section.depth >= 4 + and ($chunk.first.sections != 0 + or count($node/preceding-sibling::sect4) > 0)"> + <xsl:call-template name="chunk"> + <xsl:with-param name="node" select="$node/parent::*"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="local-name($node) = 'sect5' + and $chunk.section.depth >= 5 + and ($chunk.first.sections != 0 + or count($node/preceding-sibling::sect5) > 0)"> + <xsl:call-template name="chunk"> + <xsl:with-param name="node" select="$node/parent::*"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="local-name($node) = 'section' + and $chunk.section.depth >= count($node/ancestor::section)+1 + and ($chunk.first.sections != 0 + or count($node/preceding-sibling::section) > 0)"> + <xsl:call-template name="chunk"> + <xsl:with-param name="node" select="$node/parent::*"/> + </xsl:call-template> + </xsl:when> + + <xsl:when test="local-name($node)='preface'">1</xsl:when> + <xsl:when test="local-name($node)='chapter'">1</xsl:when> + <xsl:when test="local-name($node)='appendix'">1</xsl:when> + <xsl:when test="local-name($node)='article'">1</xsl:when> + <xsl:when test="local-name($node)='part'">1</xsl:when> + <xsl:when test="local-name($node)='reference'">1</xsl:when> + <xsl:when test="local-name($node)='refentry'">1</xsl:when> + <xsl:when test="local-name($node)='index' and ($generate.index != 0 or count($node/*) > 0) + and (local-name($node/parent::*) = 'article' + or local-name($node/parent::*) = 'book' + or local-name($node/parent::*) = 'part' + )">1</xsl:when> + <xsl:when test="local-name($node)='bibliography' + and (local-name($node/parent::*) = 'article' + or local-name($node/parent::*) = 'book' + or local-name($node/parent::*) = 'part' + )">1</xsl:when> + <xsl:when test="local-name($node)='glossary' + and (local-name($node/parent::*) = 'article' + or local-name($node/parent::*) = 'book' + or local-name($node/parent::*) = 'part' + )">1</xsl:when> + <xsl:when test="local-name($node)='colophon'">1</xsl:when> + <xsl:when test="local-name($node)='book'">1</xsl:when> + <xsl:when test="local-name($node)='set'">1</xsl:when> + <xsl:when test="local-name($node)='setindex'">1</xsl:when> + <xsl:when test="local-name($node)='legalnotice' + and $generate.legalnotice.link != 0">1</xsl:when> + <xsl:otherwise>0</xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="chunk-filename"> + <!-- returns the filename of a chunk --> + <xsl:variable name="ischunk"> + <xsl:call-template name="chunk"/> + </xsl:variable> + + <xsl:variable name="fn"> + <xsl:apply-templates select="." mode="recursive-chunk-filename"/> + </xsl:variable> + + <!-- + <xsl:message> + <xsl:value-of select="$ischunk"/> + <xsl:text> (</xsl:text> + <xsl:value-of select="local-name(.)"/> + <xsl:text>) </xsl:text> + <xsl:value-of select="$fn"/> + <xsl:text>, </xsl:text> + <xsl:call-template name="dbhtml-dir"/> + </xsl:message> + --> + + <!-- 2003-11-25 by ndw: + The following test used to read test="$ischunk != 0 and $fn != ''" + I've removed the ischunk part of the test so that href.to.uri and + href.from.uri will be fully qualified even if the source or target + isn't a chunk. I *think* that if $fn != '' then it's appropriate + to put the directory on the front, even if the element isn't a + chunk. I could be wrong. --> + + <xsl:if test="$fn != ''"> + <xsl:call-template name="dbhtml-dir"/> + </xsl:if> + + <xsl:value-of select="$fn"/> + <!-- You can't add the html.ext here because dbhtml filename= may already --> + <!-- have added it. It really does have to be handled in the recursive template --> +</xsl:template> + +<xsl:template match="*" mode="recursive-chunk-filename"> + <xsl:param name="recursive" select="false()"/> + + <!-- returns the filename of a chunk --> + <xsl:variable name="ischunk"> + <xsl:call-template name="chunk"/> + </xsl:variable> + + <xsl:variable name="dbhtml-filename"> + <xsl:call-template name="dbhtml-filename"/> + </xsl:variable> + + <xsl:variable name="filename"> + <xsl:choose> + <xsl:when test="$dbhtml-filename != ''"> + <xsl:value-of select="$dbhtml-filename"/> + </xsl:when> + <!-- if this is the root element, use the root.filename --> + <xsl:when test="not(parent::*) and $root.filename != ''"> + <xsl:value-of select="$root.filename"/> + <xsl:value-of select="$html.ext"/> + </xsl:when> + <!-- Special case --> + <xsl:when test="self::legalnotice and $generate.legalnotice.link != 0"> + <xsl:variable name="id"> + <xsl:call-template name="object.id"/> + </xsl:variable> + <xsl:value-of select="concat('ln-',$id,$html.ext)"/> + </xsl:when> + <!-- if there's no dbhtml filename, and if we're to use IDs as --> + <!-- filenames, then use the ID to generate the filename. --> + <xsl:when test="@id and $use.id.as.filename != 0"> + <xsl:value-of select="@id"/> + <xsl:value-of select="$html.ext"/> + </xsl:when> + <xsl:otherwise></xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$ischunk='0'"> + <!-- if called on something that isn't a chunk, walk up... --> + <xsl:choose> + <xsl:when test="count(parent::*)>0"> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="$recursive"/> + </xsl:apply-templates> + </xsl:when> + <!-- unless there is no up, in which case return "" --> + <xsl:otherwise></xsl:otherwise> + </xsl:choose> + </xsl:when> + + <xsl:when test="not($recursive) and $filename != ''"> + <!-- if this chunk has an explicit name, use it --> + <xsl:value-of select="$filename"/> + </xsl:when> + + <xsl:when test="self::set"> + <xsl:value-of select="$root.filename"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::book"> + <xsl:text>bk</xsl:text> + <xsl:number level="any" format="01"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::article"> + <xsl:if test="/set"> + <!-- in a set, make sure we inherit the right book info... --> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + </xsl:if> + + <xsl:text>ar</xsl:text> + <xsl:number level="any" format="01" from="book"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::preface"> + <xsl:if test="/set"> + <!-- in a set, make sure we inherit the right book info... --> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + </xsl:if> + + <xsl:text>pr</xsl:text> + <xsl:number level="any" format="01" from="book"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::chapter"> + <xsl:if test="/set"> + <!-- in a set, make sure we inherit the right book info... --> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + </xsl:if> + + <xsl:text>ch</xsl:text> + <xsl:number level="any" format="01" from="book"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::appendix"> + <xsl:if test="/set"> + <!-- in a set, make sure we inherit the right book info... --> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + </xsl:if> + + <xsl:text>ap</xsl:text> + <xsl:number level="any" format="a" from="book"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::part"> + <xsl:choose> + <xsl:when test="/set"> + <!-- in a set, make sure we inherit the right book info... --> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + </xsl:otherwise> + </xsl:choose> + + <xsl:text>pt</xsl:text> + <xsl:number level="any" format="01" from="book"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::reference"> + <xsl:choose> + <xsl:when test="/set"> + <!-- in a set, make sure we inherit the right book info... --> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + </xsl:otherwise> + </xsl:choose> + + <xsl:text>rn</xsl:text> + <xsl:number level="any" format="01" from="book"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::refentry"> + <xsl:choose> + <xsl:when test="parent::reference"> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + </xsl:otherwise> + </xsl:choose> + + <xsl:text>re</xsl:text> + <xsl:number level="any" format="01" from="book"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::colophon"> + <xsl:choose> + <xsl:when test="/set"> + <!-- in a set, make sure we inherit the right book info... --> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + </xsl:otherwise> + </xsl:choose> + + <xsl:text>co</xsl:text> + <xsl:number level="any" format="01" from="book"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::sect1 + or self::sect2 + or self::sect3 + or self::sect4 + or self::sect5 + or self::section"> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + <xsl:text>s</xsl:text> + <xsl:number format="01"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::bibliography"> + <xsl:choose> + <xsl:when test="/set"> + <!-- in a set, make sure we inherit the right book info... --> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + </xsl:otherwise> + </xsl:choose> + + <xsl:text>bi</xsl:text> + <xsl:number level="any" format="01" from="book"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::glossary"> + <xsl:choose> + <xsl:when test="/set"> + <!-- in a set, make sure we inherit the right book info... --> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + </xsl:otherwise> + </xsl:choose> + + <xsl:text>go</xsl:text> + <xsl:number level="any" format="01" from="book"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::index"> + <xsl:choose> + <xsl:when test="/set"> + <!-- in a set, make sure we inherit the right book info... --> + <xsl:apply-templates mode="recursive-chunk-filename" select="parent::*"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + </xsl:otherwise> + </xsl:choose> + + <xsl:text>ix</xsl:text> + <xsl:number level="any" format="01" from="book"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:when test="self::setindex"> + <xsl:text>si</xsl:text> + <xsl:number level="any" format="01" from="set"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:when> + + <xsl:otherwise> + <xsl:text>chunk-filename-error-</xsl:text> + <xsl:value-of select="name(.)"/> + <xsl:number level="any" format="01" from="set"/> + <xsl:if test="not($recursive)"> + <xsl:value-of select="$html.ext"/> + </xsl:if> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="href.target.uri"> + <xsl:param name="object" select="."/> + <xsl:variable name="ischunk"> + <xsl:call-template name="chunk"> + <xsl:with-param name="node" select="$object"/> + </xsl:call-template> + </xsl:variable> + + <xsl:apply-templates mode="chunk-filename" select="$object"/> + + <xsl:if test="$ischunk='0'"> + <xsl:text>#</xsl:text> + <xsl:call-template name="object.id"> + <xsl:with-param name="object" select="$object"/> + </xsl:call-template> + </xsl:if> +</xsl:template> + +<xsl:template name="href.target"> + <xsl:param name="context" select="."/> + <xsl:param name="object" select="."/> + + <xsl:variable name="href.to.uri"> + <xsl:call-template name="href.target.uri"> + <xsl:with-param name="object" select="$object"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="href.from.uri"> + <xsl:call-template name="href.target.uri"> + <xsl:with-param name="object" select="$context"/> + </xsl:call-template> + </xsl:variable> + + <!-- + <xsl:message>href.to.uri: <xsl:value-of select="$href.to.uri"/></xsl:message> + <xsl:message>href.from.uri: <xsl:value-of select="$href.from.uri"/></xsl:message> + --> + + <xsl:variable name="href.to"> + <xsl:call-template name="trim.common.uri.paths"> + <xsl:with-param name="uriA" select="$href.to.uri"/> + <xsl:with-param name="uriB" select="$href.from.uri"/> + <xsl:with-param name="return" select="'A'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="href.from"> + <xsl:call-template name="trim.common.uri.paths"> + <xsl:with-param name="uriA" select="$href.to.uri"/> + <xsl:with-param name="uriB" select="$href.from.uri"/> + <xsl:with-param name="return" select="'B'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="depth"> + <xsl:call-template name="count.uri.path.depth"> + <xsl:with-param name="filename" select="$href.from"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="href"> + <xsl:call-template name="copy-string"> + <xsl:with-param name="string" select="'../'"/> + <xsl:with-param name="count" select="$depth"/> + </xsl:call-template> + <xsl:value-of select="$href.to"/> + </xsl:variable> + + <!-- + <xsl:message> + <xsl:text>In </xsl:text> + <xsl:value-of select="name(.)"/> + <xsl:text> (</xsl:text> + <xsl:value-of select="$href.from"/> + <xsl:text>,</xsl:text> + <xsl:value-of select="$depth"/> + <xsl:text>) </xsl:text> + <xsl:value-of select="name($object)"/> + <xsl:text> href=</xsl:text> + <xsl:value-of select="$href"/> + </xsl:message> + --> + + <xsl:value-of select="$href"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="html.head"> + <xsl:param name="prev" select="/foo"/> + <xsl:param name="next" select="/foo"/> + <xsl:variable name="this" select="."/> + <xsl:variable name="home" select="/*[1]"/> + <xsl:variable name="up" select="parent::*"/> + + <head> + <xsl:call-template name="system.head.content"/> + <xsl:call-template name="head.content"/> + + <xsl:if test="$home"> + <link rel="start"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$home"/> + </xsl:call-template> + </xsl:attribute> + <xsl:attribute name="title"> + <xsl:apply-templates select="$home" + mode="object.title.markup.textonly"/> + </xsl:attribute> + </link> + </xsl:if> + + <xsl:if test="$up"> + <link rel="up"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$up"/> + </xsl:call-template> + </xsl:attribute> + <xsl:attribute name="title"> + <xsl:apply-templates select="$up" mode="object.title.markup.textonly"/> + </xsl:attribute> + </link> + </xsl:if> + + <xsl:if test="$prev"> + <link rel="prev"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$prev"/> + </xsl:call-template> + </xsl:attribute> + <xsl:attribute name="title"> + <xsl:apply-templates select="$prev" mode="object.title.markup.textonly"/> + </xsl:attribute> + </link> + </xsl:if> + + <xsl:if test="$next"> + <link rel="next"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$next"/> + </xsl:call-template> + </xsl:attribute> + <xsl:attribute name="title"> + <xsl:apply-templates select="$next" mode="object.title.markup.textonly"/> + </xsl:attribute> + </link> + </xsl:if> + + <xsl:if test="$html.extra.head.links != 0"> + <xsl:for-each select="//part + |//reference + |//preface + |//chapter + |//article + |//refentry + |//appendix[not(parent::article)]|appendix + |//glossary[not(parent::article)]|glossary + |//index[not(parent::article)]|index"> + <link rel="{local-name(.)}"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="context" select="$this"/> + <xsl:with-param name="object" select="."/> + </xsl:call-template> + </xsl:attribute> + <xsl:attribute name="title"> + <xsl:apply-templates select="." mode="object.title.markup.textonly"/> + </xsl:attribute> + </link> + </xsl:for-each> + + <xsl:for-each select="section|sect1|refsection|refsect1"> + <link> + <xsl:attribute name="rel"> + <xsl:choose> + <xsl:when test="local-name($this) = 'section' + or local-name($this) = 'refsection'"> + <xsl:value-of select="'subsection'"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="'section'"/> + </xsl:otherwise> + </xsl:choose> + </xsl:attribute> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="context" select="$this"/> + <xsl:with-param name="object" select="."/> + </xsl:call-template> + </xsl:attribute> + <xsl:attribute name="title"> + <xsl:apply-templates select="." mode="object.title.markup.textonly"/> + </xsl:attribute> + </link> + </xsl:for-each> + + <xsl:for-each select="sect2|sect3|sect4|sect5|refsect2|refsect3"> + <link rel="subsection"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="context" select="$this"/> + <xsl:with-param name="object" select="."/> + </xsl:call-template> + </xsl:attribute> + <xsl:attribute name="title"> + <xsl:apply-templates select="." mode="object.title.markup.textonly"/> + </xsl:attribute> + </link> + </xsl:for-each> + </xsl:if> + + <!-- * if we have a legalnotice and user wants it output as a --> + <!-- * separate page and $html.head.legalnotice.link.types is --> + <!-- * non-empty, we generate a link or links for each value in --> + <!-- * $html.head.legalnotice.link.types --> + <xsl:if test="//legalnotice + and not($generate.legalnotice.link = 0) + and not($html.head.legalnotice.link.types = '')"> + <xsl:call-template name="make.legalnotice.head.links"/> + </xsl:if> + + <xsl:call-template name="user.head.content"/> + </head> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="header.navigation"> + <xsl:param name="prev" select="/foo"/> + <xsl:param name="next" select="/foo"/> + <xsl:param name="nav.context"/> + + <xsl:variable name="home" select="/*[1]"/> + <xsl:variable name="up" select="parent::*"/> + + <xsl:variable name="row1" select="$navig.showtitles != 0"/> + <xsl:variable name="row2" select="count($prev) > 0 + or (count($up) > 0 + and generate-id($up) != generate-id($home) + and $navig.showtitles != 0) + or count($next) > 0"/> + + <xsl:if test="$suppress.navigation = '0' and $suppress.header.navigation = '0'"> + <div class="navheader"> + <xsl:if test="$row1 or $row2"> + <table width="100%" summary="Navigation header"> + <xsl:if test="$row1"> + <tr> + <th colspan="3" align="center"> + <xsl:apply-templates select="." mode="object.title.markup"/> + </th> + </tr> + </xsl:if> + + <xsl:if test="$row2"> + <tr> + <td width="20%" align="left"> + <xsl:if test="count($prev)>0"> + <a accesskey="p"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$prev"/> + </xsl:call-template> + </xsl:attribute> + <xsl:call-template name="navig.content"> + <xsl:with-param name="direction" select="'prev'"/> + </xsl:call-template> + </a> + </xsl:if> + <xsl:text> </xsl:text> + </td> + <th width="60%" align="center"> + <xsl:choose> + <xsl:when test="count($up) > 0 + and generate-id($up) != generate-id($home) + and $navig.showtitles != 0"> + <xsl:apply-templates select="$up" mode="object.title.markup"/> + </xsl:when> + <xsl:otherwise> </xsl:otherwise> + </xsl:choose> + </th> + <td width="20%" align="right"> + <xsl:text> </xsl:text> + <xsl:if test="count($next)>0"> + <a accesskey="n"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$next"/> + </xsl:call-template> + </xsl:attribute> + <xsl:call-template name="navig.content"> + <xsl:with-param name="direction" select="'next'"/> + </xsl:call-template> + </a> + </xsl:if> + </td> + </tr> + </xsl:if> + </table> + </xsl:if> + <xsl:if test="$header.rule != 0"> + <hr/> + </xsl:if> + </div> + </xsl:if> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="footer.navigation"> + <xsl:param name="prev" select="/foo"/> + <xsl:param name="next" select="/foo"/> + <xsl:param name="nav.context"/> + + <xsl:variable name="home" select="/*[1]"/> + <xsl:variable name="up" select="parent::*"/> + + <xsl:variable name="row1" select="count($prev) > 0 + or count($up) > 0 + or count($next) > 0"/> + + <xsl:variable name="row2" select="($prev and $navig.showtitles != 0) + or (generate-id($home) != generate-id(.) + or $nav.context = 'toc') + or ($chunk.tocs.and.lots != 0 + and $nav.context != 'toc') + or ($next and $navig.showtitles != 0)"/> + + <xsl:if test="$suppress.navigation = '0' and $suppress.footer.navigation = '0'"> + <div class="navfooter"> + <xsl:if test="$footer.rule != 0"> + <hr/> + </xsl:if> + + <xsl:if test="$row1 or $row2"> + <table width="100%" summary="Navigation footer"> + <xsl:if test="$row1"> + <tr> + <td width="40%" align="left"> + <xsl:if test="count($prev)>0"> + <a accesskey="p"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$prev"/> + </xsl:call-template> + </xsl:attribute> + <xsl:call-template name="navig.content"> + <xsl:with-param name="direction" select="'prev'"/> + </xsl:call-template> + </a> + </xsl:if> + <xsl:text> </xsl:text> + </td> + <td width="20%" align="center"> + <xsl:choose> + <xsl:when test="count($up)>0 + and generate-id($up) != generate-id($home)"> + <a accesskey="u"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$up"/> + </xsl:call-template> + </xsl:attribute> + <xsl:call-template name="navig.content"> + <xsl:with-param name="direction" select="'up'"/> + </xsl:call-template> + </a> + </xsl:when> + <xsl:otherwise> </xsl:otherwise> + </xsl:choose> + </td> + <td width="40%" align="right"> + <xsl:text> </xsl:text> + <xsl:if test="count($next)>0"> + <a accesskey="n"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$next"/> + </xsl:call-template> + </xsl:attribute> + <xsl:call-template name="navig.content"> + <xsl:with-param name="direction" select="'next'"/> + </xsl:call-template> + </a> + </xsl:if> + </td> + </tr> + </xsl:if> + + <xsl:if test="$row2"> + <tr> + <td width="40%" align="left" valign="top"> + <xsl:if test="$navig.showtitles != 0"> + <xsl:apply-templates select="$prev" mode="object.title.markup"/> + </xsl:if> + <xsl:text> </xsl:text> + </td> + <td width="20%" align="center"> + <xsl:choose> + <xsl:when test="$home != . or $nav.context = 'toc'"> + <a accesskey="h"> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$home"/> + </xsl:call-template> + </xsl:attribute> + <xsl:call-template name="navig.content"> + <xsl:with-param name="direction" select="'home'"/> + </xsl:call-template> + </a> + <xsl:if test="$chunk.tocs.and.lots != 0 and $nav.context != 'toc'"> + <xsl:text> | </xsl:text> + </xsl:if> + </xsl:when> + <xsl:otherwise> </xsl:otherwise> + </xsl:choose> + + <xsl:if test="$chunk.tocs.and.lots != 0 and $nav.context != 'toc'"> + <a accesskey="t"> + <xsl:attribute name="href"> + <xsl:apply-templates select="/*[1]" + mode="recursive-chunk-filename"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + <xsl:text>-toc</xsl:text> + <xsl:value-of select="$html.ext"/> + </xsl:attribute> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'nav-toc'"/> + </xsl:call-template> + </a> + </xsl:if> + </td> + <td width="40%" align="right" valign="top"> + <xsl:text> </xsl:text> + <xsl:if test="$navig.showtitles != 0"> + <xsl:apply-templates select="$next" mode="object.title.markup"/> + </xsl:if> + </td> + </tr> + </xsl:if> + </table> + </xsl:if> + </div> + </xsl:if> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="navig.content"> + <xsl:param name="direction" select="next"/> + <xsl:variable name="navtext"> + <xsl:choose> + <xsl:when test="$direction = 'prev'"> + <xsl:call-template name="gentext.nav.prev"/> + </xsl:when> + <xsl:when test="$direction = 'next'"> + <xsl:call-template name="gentext.nav.next"/> + </xsl:when> + <xsl:when test="$direction = 'up'"> + <xsl:call-template name="gentext.nav.up"/> + </xsl:when> + <xsl:when test="$direction = 'home'"> + <xsl:call-template name="gentext.nav.home"/> + </xsl:when> + <xsl:otherwise> + <xsl:text>xxx</xsl:text> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$navig.graphics != 0"> + <img> + <xsl:attribute name="src"> + <xsl:value-of select="$navig.graphics.path"/> + <xsl:value-of select="$direction"/> + <xsl:value-of select="$navig.graphics.extension"/> + </xsl:attribute> + <xsl:attribute name="alt"> + <xsl:value-of select="$navtext"/> + </xsl:attribute> + </img> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$navtext"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> +<!-- * The following does tail-recursion through a space-separated --> +<!-- * list of link types specified in $html.head.legalnotice.link.types, --> +<!-- * popping off link types and generating links for them until it --> +<!-- * depletes the list. --> + +<xsl:template name="make.legalnotice.head.links"> + <!-- * the following ID is used as part of the legalnotice filename; --> + <!-- * we need it in order to construct the filename for use in the --> + <!-- * value of the href attribute on the link --> + <xsl:param name="id"> + <xsl:call-template name="object.id"> + <xsl:with-param name="object" select="//legalnotice[1]"/> + </xsl:call-template> + </xsl:param> + <xsl:param name="linktype"> + <xsl:choose> + <xsl:when test="contains($html.head.legalnotice.link.types, ' ')"> + <xsl:value-of + select="normalize-space( + substring-before($html.head.legalnotice.link.types, ' '))"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$html.head.legalnotice.link.types"/> + </xsl:otherwise> + </xsl:choose> + </xsl:param> + <xsl:param + name="remaining.linktypes" + select="concat( + normalize-space( + substring-after($html.head.legalnotice.link.types, ' ')),' ')"/> + <xsl:if test="not($linktype = '')"> + <link rel="{$linktype}"> + <xsl:attribute name="href"> + <xsl:value-of select="concat('ln-',$id,$html.ext)"/> + </xsl:attribute> + <xsl:attribute name="title"> + <xsl:apply-templates select="//legalnotice[1]" + mode="object.title.markup.textonly"/> + </xsl:attribute> + </link> + <xsl:call-template name="make.legalnotice.head.links"> + <!-- * pop the next value off the list of link types --> + <xsl:with-param + name="linktype" + select="substring-before($remaining.linktypes, ' ')"/> + <!-- * remove the link type from the list of remaining link types --> + <xsl:with-param + name="remaining.linktypes" + select="substring-after($remaining.linktypes, ' ')"/> + </xsl:call-template> + </xsl:if> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="processing-instruction('dbhtml')"> + <!-- nop --> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="chunk-element-content"> + <xsl:param name="prev"/> + <xsl:param name="next"/> + <xsl:param name="nav.context"/> + <xsl:param name="content"> + <xsl:apply-imports/> + </xsl:param> + + <xsl:call-template name="user.preroot"/> + + <html> + <xsl:call-template name="html.head"> + <xsl:with-param name="prev" select="$prev"/> + <xsl:with-param name="next" select="$next"/> + </xsl:call-template> + + <body> + <xsl:call-template name="body.attributes"/> + <xsl:call-template name="user.header.navigation"/> + + <xsl:call-template name="header.navigation"> + <xsl:with-param name="prev" select="$prev"/> + <xsl:with-param name="next" select="$next"/> + <xsl:with-param name="nav.context" select="$nav.context"/> + </xsl:call-template> + + <xsl:call-template name="user.header.content"/> + + <xsl:copy-of select="$content"/> + + <xsl:call-template name="user.footer.content"/> + + <xsl:call-template name="footer.navigation"> + <xsl:with-param name="prev" select="$prev"/> + <xsl:with-param name="next" select="$next"/> + <xsl:with-param name="nav.context" select="$nav.context"/> + </xsl:call-template> + + <xsl:call-template name="user.footer.navigation"/> + </body> + </html> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/chunk.xsl b/src/documentation/docbook-xsl/html/chunk.xsl new file mode 100644 index 0000000000..6b763be779 --- /dev/null +++ b/src/documentation/docbook-xsl/html/chunk.xsl @@ -0,0 +1,40 @@ +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:exsl="http://exslt.org/common" + version="1.0" + exclude-result-prefixes="exsl"> + +<!-- ******************************************************************** + $Id: chunk.xsl,v 1.30 2003/11/30 19:42:23 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:import href="docbook.xsl"/> +<xsl:import href="chunk-common.xsl"/> +<xsl:include href="manifest.xsl"/> + +<!-- Why is chunk-code now xsl:included? + +Suppose you want to customize *both* the chunking algorithm used *and* the +presentation of some elements that may be chunks. In order to do that, you +must get the order of imports "just right". The answer is to make your own +copy of this file, where you replace the initial import of "docbook.xsl" +with an import of your own base.xsl (that does its own import of docbook.xsl). + +Put the templates for changing the presentation of elements in your base.xsl. + +Put the templates that control chunking after the include of chunk-code.xsl. + +Voila! (Man I hope we can do this better in XSLT 2.0) + +--> + +<xsl:include href="chunk-code.xsl"/> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/chunker.xsl b/src/documentation/docbook-xsl/html/chunker.xsl new file mode 100644 index 0000000000..48a86a5a13 --- /dev/null +++ b/src/documentation/docbook-xsl/html/chunker.xsl @@ -0,0 +1,439 @@ +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:saxon="http://icl.com/saxon" + xmlns:lxslt="http://xml.apache.org/xslt" + xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect" + xmlns:exsl="http://exslt.org/common" + xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" + version="1.0" + exclude-result-prefixes="doc" + extension-element-prefixes="saxon xalanredirect lxslt exsl"> + +<!-- ******************************************************************** + $Id: chunker.xsl,v 1.27 2006/04/10 14:15:28 xmldoc Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<!-- This stylesheet works with XSLT implementations that support --> +<!-- exsl:document, saxon:output, or xalanredirect:write --> +<!-- Note: Only Saxon 6.4.2 or later is supported. --> + +<xsl:param name="chunker.output.method" select="'html'"/> +<xsl:param name="chunker.output.encoding" select="'ISO-8859-1'"/> +<xsl:param name="chunker.output.indent" select="'no'"/> +<xsl:param name="chunker.output.omit-xml-declaration" select="'no'"/> +<xsl:param name="chunker.output.standalone" select="'no'"/> +<xsl:param name="chunker.output.doctype-public" select="''"/> +<xsl:param name="chunker.output.doctype-system" select="''"/> +<xsl:param name="chunker.output.media-type" select="''"/> +<xsl:param name="chunker.output.cdata-section-elements" select="''"/> +<xsl:param name="chunker.output.quiet" select="0"/> + +<xsl:param name="saxon.character.representation" select="'entity;decimal'"/> + +<!-- ==================================================================== --> + +<xsl:template name="make-relative-filename"> + <xsl:param name="base.dir" select="'./'"/> + <xsl:param name="base.name" select="''"/> + + <xsl:choose> + <!-- put Saxon first to work around a bug in libxslt --> + <xsl:when test="element-available('saxon:output')"> + <!-- Saxon doesn't make the chunks relative --> + <xsl:value-of select="concat($base.dir,$base.name)"/> + </xsl:when> + <xsl:when test="element-available('exsl:document')"> + <!-- EXSL document does make the chunks relative, I think --> + <xsl:choose> + <xsl:when test="count(parent::*) = 0"> + <xsl:value-of select="concat($base.dir,$base.name)"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$base.name"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:when test="element-available('xalanredirect:write')"> + <!-- Xalan doesn't make the chunks relative --> + <xsl:value-of select="concat($base.dir,$base.name)"/> + </xsl:when> + <xsl:otherwise> + <xsl:message terminate="yes"> + <xsl:text>Don't know how to chunk with </xsl:text> + <xsl:value-of select="system-property('xsl:vendor')"/> + </xsl:message> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="write.chunk"> + <xsl:param name="filename" select="''"/> + <xsl:param name="quiet" select="$chunker.output.quiet"/> + <xsl:param name="suppress-context-node-name" select="0"/> + <xsl:param name="message-prolog"/> + <xsl:param name="message-epilog"/> + + <xsl:param name="method" select="$chunker.output.method"/> + <xsl:param name="encoding" select="$chunker.output.encoding"/> + <xsl:param name="indent" select="$chunker.output.indent"/> + <xsl:param name="omit-xml-declaration" + select="$chunker.output.omit-xml-declaration"/> + <xsl:param name="standalone" select="$chunker.output.standalone"/> + <xsl:param name="doctype-public" select="$chunker.output.doctype-public"/> + <xsl:param name="doctype-system" select="$chunker.output.doctype-system"/> + <xsl:param name="media-type" select="$chunker.output.media-type"/> + <xsl:param name="cdata-section-elements" + select="$chunker.output.cdata-section-elements"/> + + <xsl:param name="content"/> + + <xsl:if test="$quiet = 0"> + <xsl:message> + <xsl:if test="not($message-prolog = '')"> + <xsl:value-of select="$message-prolog"/> + </xsl:if> + <xsl:text>Writing </xsl:text> + <xsl:value-of select="$filename"/> + <xsl:if test="name(.) != '' and $suppress-context-node-name = 0"> + <xsl:text> for </xsl:text> + <xsl:value-of select="name(.)"/> + <xsl:if test="@id"> + <xsl:text>(</xsl:text> + <xsl:value-of select="@id"/> + <xsl:text>)</xsl:text> + </xsl:if> + </xsl:if> + <xsl:if test="not($message-epilog = '')"> + <xsl:value-of select="$message-epilog"/> + </xsl:if> + </xsl:message> + </xsl:if> + + <xsl:choose> + <xsl:when test="element-available('exsl:document')"> + <xsl:choose> + <!-- Handle the permutations ... --> + <xsl:when test="$media-type != ''"> + <xsl:choose> + <xsl:when test="$doctype-public != '' and $doctype-system != ''"> + <exsl:document href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + media-type="{$media-type}" + doctype-public="{$doctype-public}" + doctype-system="{$doctype-system}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </exsl:document> + </xsl:when> + <xsl:when test="$doctype-public != '' and $doctype-system = ''"> + <exsl:document href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + media-type="{$media-type}" + doctype-public="{$doctype-public}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </exsl:document> + </xsl:when> + <xsl:when test="$doctype-public = '' and $doctype-system != ''"> + <exsl:document href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + media-type="{$media-type}" + doctype-system="{$doctype-system}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </exsl:document> + </xsl:when> + <xsl:otherwise><!-- $doctype-public = '' and $doctype-system = ''"> --> + <exsl:document href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + media-type="{$media-type}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </exsl:document> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="$doctype-public != '' and $doctype-system != ''"> + <exsl:document href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + doctype-public="{$doctype-public}" + doctype-system="{$doctype-system}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </exsl:document> + </xsl:when> + <xsl:when test="$doctype-public != '' and $doctype-system = ''"> + <exsl:document href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + doctype-public="{$doctype-public}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </exsl:document> + </xsl:when> + <xsl:when test="$doctype-public = '' and $doctype-system != ''"> + <exsl:document href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + doctype-system="{$doctype-system}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </exsl:document> + </xsl:when> + <xsl:otherwise><!-- $doctype-public = '' and $doctype-system = ''"> --> + <exsl:document href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </exsl:document> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + + <xsl:when test="element-available('saxon:output')"> + <xsl:choose> + <!-- Handle the permutations ... --> + <xsl:when test="$media-type != ''"> + <xsl:choose> + <xsl:when test="$doctype-public != '' and $doctype-system != ''"> + <saxon:output saxon:character-representation="{$saxon.character.representation}" + href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + media-type="{$media-type}" + doctype-public="{$doctype-public}" + doctype-system="{$doctype-system}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </saxon:output> + </xsl:when> + <xsl:when test="$doctype-public != '' and $doctype-system = ''"> + <saxon:output saxon:character-representation="{$saxon.character.representation}" + href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + media-type="{$media-type}" + doctype-public="{$doctype-public}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </saxon:output> + </xsl:when> + <xsl:when test="$doctype-public = '' and $doctype-system != ''"> + <saxon:output saxon:character-representation="{$saxon.character.representation}" + href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + media-type="{$media-type}" + doctype-system="{$doctype-system}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </saxon:output> + </xsl:when> + <xsl:otherwise><!-- $doctype-public = '' and $doctype-system = ''"> --> + <saxon:output saxon:character-representation="{$saxon.character.representation}" + href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + media-type="{$media-type}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </saxon:output> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="$doctype-public != '' and $doctype-system != ''"> + <saxon:output saxon:character-representation="{$saxon.character.representation}" + href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + doctype-public="{$doctype-public}" + doctype-system="{$doctype-system}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </saxon:output> + </xsl:when> + <xsl:when test="$doctype-public != '' and $doctype-system = ''"> + <saxon:output saxon:character-representation="{$saxon.character.representation}" + href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + doctype-public="{$doctype-public}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </saxon:output> + </xsl:when> + <xsl:when test="$doctype-public = '' and $doctype-system != ''"> + <saxon:output saxon:character-representation="{$saxon.character.representation}" + href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + doctype-system="{$doctype-system}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </saxon:output> + </xsl:when> + <xsl:otherwise><!-- $doctype-public = '' and $doctype-system = ''"> --> + <saxon:output saxon:character-representation="{$saxon.character.representation}" + href="{$filename}" + method="{$method}" + encoding="{$encoding}" + indent="{$indent}" + omit-xml-declaration="{$omit-xml-declaration}" + cdata-section-elements="{$cdata-section-elements}" + standalone="{$standalone}"> + <xsl:copy-of select="$content"/> + </saxon:output> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + + <xsl:when test="element-available('xalanredirect:write')"> + <!-- Xalan uses xalanredirect --> + <xalanredirect:write file="{$filename}"> + <xsl:copy-of select="$content"/> + </xalanredirect:write> + </xsl:when> + + <xsl:otherwise> + <!-- it doesn't matter since we won't be making chunks... --> + <xsl:message terminate="yes"> + <xsl:text>Can't make chunks with </xsl:text> + <xsl:value-of select="system-property('xsl:vendor')"/> + <xsl:text>'s processor.</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="write.chunk.with.doctype"> + <xsl:param name="filename" select="''"/> + <xsl:param name="quiet" select="$chunker.output.quiet"/> + + <xsl:param name="method" select="$chunker.output.method"/> + <xsl:param name="encoding" select="$chunker.output.encoding"/> + <xsl:param name="indent" select="$chunker.output.indent"/> + <xsl:param name="omit-xml-declaration" + select="$chunker.output.omit-xml-declaration"/> + <xsl:param name="standalone" select="$chunker.output.standalone"/> + <xsl:param name="doctype-public" select="$chunker.output.doctype-public"/> + <xsl:param name="doctype-system" select="$chunker.output.doctype-system"/> + <xsl:param name="media-type" select="$chunker.output.media-type"/> + <xsl:param name="cdata-section-elements" + select="$chunker.output.cdata-section-elements"/> + + <xsl:param name="content"/> + + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename" select="$filename"/> + <xsl:with-param name="quiet" select="$quiet"/> + <xsl:with-param name="method" select="$method"/> + <xsl:with-param name="encoding" select="$encoding"/> + <xsl:with-param name="indent" select="$indent"/> + <xsl:with-param name="omit-xml-declaration" select="$omit-xml-declaration"/> + <xsl:with-param name="standalone" select="$standalone"/> + <xsl:with-param name="doctype-public" select="$doctype-public"/> + <xsl:with-param name="doctype-system" select="$doctype-system"/> + <xsl:with-param name="media-type" select="$media-type"/> + <xsl:with-param name="cdata-section-elements" select="$cdata-section-elements"/> + <xsl:with-param name="content" select="$content"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="write.text.chunk"> + <xsl:param name="filename" select="''"/> + <xsl:param name="quiet" select="$chunker.output.quiet"/> + <xsl:param name="suppress-context-node-name" select="0"/> + <xsl:param name="message-prolog"/> + <xsl:param name="message-epilog"/> + <xsl:param name="method" select="'text'"/> + <xsl:param name="encoding" select="$chunker.output.encoding"/> + <xsl:param name="media-type" select="$chunker.output.media-type"/> + <xsl:param name="content"/> + + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename" select="$filename"/> + <xsl:with-param name="quiet" select="$quiet"/> + <xsl:with-param name="suppress-context-node-name" select="$suppress-context-node-name"/> + <xsl:with-param name="message-prolog" select="$message-prolog"/> + <xsl:with-param name="message-epilog" select="$message-epilog"/> + <xsl:with-param name="method" select="$method"/> + <xsl:with-param name="encoding" select="$encoding"/> + <xsl:with-param name="indent" select="'no'"/> + <xsl:with-param name="omit-xml-declaration" select="'no'"/> + <xsl:with-param name="standalone" select="'no'"/> + <xsl:with-param name="doctype-public"/> + <xsl:with-param name="doctype-system"/> + <xsl:with-param name="media-type" select="$media-type"/> + <xsl:with-param name="cdata-section-elements"/> + <xsl:with-param name="content" select="$content"/> + </xsl:call-template> +</xsl:template> + + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/chunkfast.xsl b/src/documentation/docbook-xsl/html/chunkfast.xsl new file mode 100644 index 0000000000..e345dc9c50 --- /dev/null +++ b/src/documentation/docbook-xsl/html/chunkfast.xsl @@ -0,0 +1,72 @@ +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:exsl="http://exslt.org/common" + xmlns:cf="http://docbook.sourceforge.net/xmlns/chunkfast/1.0" + version="1.0" + exclude-result-prefixes="cf exsl"> + +<!-- ******************************************************************** + $Id: chunkfast.xsl,v 1.4 2005/08/04 07:03:47 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:import href="chunk.xsl"/> +<xsl:param name="chunk.fast" select="1"/> + +<xsl:variable name="chunks" select="exsl:node-set($chunk.hierarchy)//cf:div"/> + +<!-- ==================================================================== --> + +<xsl:template name="process-chunk-element"> + <xsl:choose> + <xsl:when test="$chunk.fast != 0 and function-available('exsl:node-set')"> + <xsl:variable name="genid" select="generate-id()"/> + + <xsl:variable name="div" select="$chunks[@id=$genid]"/> + + <xsl:variable name="prevdiv" + select="($div/preceding-sibling::cf:div|$div/preceding::cf:div|$div/parent::cf:div)[last()]"/> + <xsl:variable name="prev" select="key('genid', $prevdiv/@id)"/> + + <xsl:variable name="nextdiv" + select="($div/following-sibling::cf:div|$div/following::cf:div|$div/cf:div)[1]"/> + <xsl:variable name="next" select="key('genid', $nextdiv/@id)"/> + + <xsl:choose> + <xsl:when test="$onechunk != 0 and parent::*"> + <xsl:apply-imports/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="process-chunk"> + <xsl:with-param name="prev" select="$prev"/> + <xsl:with-param name="next" select="$next"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="$onechunk != 0 and not(parent::*)"> + <xsl:call-template name="chunk-all-sections"/> + </xsl:when> + <xsl:when test="$onechunk != 0"> + <xsl:apply-imports/> + </xsl:when> + <xsl:when test="$chunk.first.sections = 0"> + <xsl:call-template name="chunk-first-section-with-parent"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="chunk-all-sections"/> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/chunktoc.xsl b/src/documentation/docbook-xsl/html/chunktoc.xsl new file mode 100644 index 0000000000..ca9060d5e9 --- /dev/null +++ b/src/documentation/docbook-xsl/html/chunktoc.xsl @@ -0,0 +1,468 @@ +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" + version="1.0" + exclude-result-prefixes="doc"> + +<!-- ******************************************************************** + $Id: chunktoc.xsl,v 1.6 2005/05/31 07:46:52 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:import href="docbook.xsl"/> +<xsl:import href="chunk-common.xsl"/> + +<xsl:template name="chunk"> + <xsl:param name="node" select="."/> + <!-- returns 1 if $node is a chunk --> + + <xsl:variable name="id"> + <xsl:call-template name="object.id"> + <xsl:with-param name="object" select="$node"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="chunks" select="document($chunk.toc,/)"/> + + <xsl:choose> + <xsl:when test="$chunks//tocentry[@linkend=$id]">1</xsl:when> + <xsl:otherwise>0</xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="chunk-filename"> + <!-- returns the filename of a chunk --> + + <xsl:variable name="id"> + <xsl:call-template name="object.id"/> + </xsl:variable> + + <xsl:variable name="chunks" select="document($chunk.toc,/)"/> + + <xsl:variable name="chunk" select="$chunks//tocentry[@linkend=$id]"/> + <xsl:variable name="filename"> + <xsl:call-template name="dbhtml-filename"> + <xsl:with-param name="pis" select="$chunk/processing-instruction('dbhtml')"/> + </xsl:call-template> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$chunk"> + <xsl:value-of select="$filename"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="parent::*" mode="chunk-filename"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="process-chunk"> + <xsl:variable name="id"> + <xsl:call-template name="object.id"/> + </xsl:variable> + + <xsl:variable name="chunks" select="document($chunk.toc,/)"/> + + <xsl:variable name="chunk" select="$chunks//tocentry[@linkend=$id]"/> + <xsl:variable name="prev-id" + select="($chunk/preceding::tocentry + |$chunk/ancestor::tocentry)[last()]/@linkend"/> + <xsl:variable name="next-id" + select="($chunk/following::tocentry + |$chunk/child::tocentry)[1]/@linkend"/> + + <xsl:variable name="prev" select="key('id',$prev-id)"/> + <xsl:variable name="next" select="key('id',$next-id)"/> + + <xsl:variable name="ischunk"> + <xsl:call-template name="chunk"/> + </xsl:variable> + + <xsl:variable name="chunkfn"> + <xsl:if test="$ischunk='1'"> + <xsl:apply-templates mode="chunk-filename" select="."/> + </xsl:if> + </xsl:variable> + + <xsl:variable name="filename"> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.dir" select="$base.dir"/> + <xsl:with-param name="base.name" select="$chunkfn"/> + </xsl:call-template> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$ischunk = 0"> + <xsl:apply-imports/> + </xsl:when> + + <xsl:otherwise> + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename" select="$filename"/> + <xsl:with-param name="content"> + <xsl:call-template name="chunk-element-content"> + <xsl:with-param name="prev" select="$prev"/> + <xsl:with-param name="next" select="$next"/> + </xsl:call-template> + </xsl:with-param> + <xsl:with-param name="quiet" select="$chunk.quietly"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="set"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="book"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="book/appendix"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="book/glossary"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="book/bibliography"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="dedication" mode="dedication"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="preface|chapter"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="part|reference"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="refentry"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="colophon"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="article"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="article/appendix"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="article/glossary"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="article/bibliography"> + <xsl:call-template name="process-chunk"/> +</xsl:template> + +<xsl:template match="sect1|sect2|sect3|sect4|sect5|section"> + <xsl:variable name="ischunk"> + <xsl:call-template name="chunk"/> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$ischunk != 0"> + <xsl:call-template name="process-chunk"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-imports/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="setindex + |book/index + |article/index"> + <!-- some implementations use completely empty index tags to indicate --> + <!-- where an automatically generated index should be inserted. so --> + <!-- if the index is completely empty, skip it. --> + <xsl:if test="count(*)>0 or $generate.index != '0'"> + <xsl:call-template name="process-chunk"/> + </xsl:if> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="/"> + <xsl:choose> + <xsl:when test="$chunk.toc = ''"> + <xsl:message terminate="yes"> + <xsl:text>The chunk.toc file is not set.</xsl:text> + </xsl:message> + </xsl:when> + + <xsl:when test="$rootid != ''"> + <xsl:choose> + <xsl:when test="count(key('id',$rootid)) = 0"> + <xsl:message terminate="yes"> + <xsl:text>ID '</xsl:text> + <xsl:value-of select="$rootid"/> + <xsl:text>' not found in document.</xsl:text> + </xsl:message> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="key('id',$rootid)"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + + <xsl:otherwise> + <xsl:apply-templates select="/" mode="process.root"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="*" mode="process.root"> + <xsl:apply-templates select="."/> +</xsl:template> + +<xsl:template name="make.lots"> + <xsl:param name="toc.params" select="''"/> + <xsl:param name="toc"/> + + <xsl:variable name="lots"> + <xsl:if test="contains($toc.params, 'toc')"> + <xsl:copy-of select="$toc"/> + </xsl:if> + + <xsl:if test="contains($toc.params, 'figure')"> + <xsl:choose> + <xsl:when test="$chunk.separate.lots != '0'"> + <xsl:call-template name="make.lot.chunk"> + <xsl:with-param name="type" select="'figure'"/> + <xsl:with-param name="lot"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'figure'"/> + <xsl:with-param name="nodes" select=".//figure"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'figure'"/> + <xsl:with-param name="nodes" select=".//figure"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:if test="contains($toc.params, 'table')"> + <xsl:choose> + <xsl:when test="$chunk.separate.lots != '0'"> + <xsl:call-template name="make.lot.chunk"> + <xsl:with-param name="type" select="'table'"/> + <xsl:with-param name="lot"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'table'"/> + <xsl:with-param name="nodes" select=".//table"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'table'"/> + <xsl:with-param name="nodes" select=".//table"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:if test="contains($toc.params, 'example')"> + <xsl:choose> + <xsl:when test="$chunk.separate.lots != '0'"> + <xsl:call-template name="make.lot.chunk"> + <xsl:with-param name="type" select="'example'"/> + <xsl:with-param name="lot"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'example'"/> + <xsl:with-param name="nodes" select=".//example"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'example'"/> + <xsl:with-param name="nodes" select=".//example"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:if test="contains($toc.params, 'equation')"> + <xsl:choose> + <xsl:when test="$chunk.separate.lots != '0'"> + <xsl:call-template name="make.lot.chunk"> + <xsl:with-param name="type" select="'equation'"/> + <xsl:with-param name="lot"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'equation'"/> + <xsl:with-param name="nodes" select=".//equation"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'equation'"/> + <xsl:with-param name="nodes" select=".//equation"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:if test="contains($toc.params, 'procedure')"> + <xsl:choose> + <xsl:when test="$chunk.separate.lots != '0'"> + <xsl:call-template name="make.lot.chunk"> + <xsl:with-param name="type" select="'procedure'"/> + <xsl:with-param name="lot"> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'procedure'"/> + <xsl:with-param name="nodes" select=".//procedure[title]"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="list.of.titles"> + <xsl:with-param name="titles" select="'procedure'"/> + <xsl:with-param name="nodes" select=".//procedure[title]"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + </xsl:variable> + + <xsl:if test="string($lots) != ''"> + <xsl:choose> + <xsl:when test="$chunk.tocs.and.lots != 0 and not(parent::*)"> + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename"> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.dir" select="$base.dir"/> + <xsl:with-param name="base.name"> + <xsl:call-template name="dbhtml-dir"/> + <xsl:apply-templates select="." mode="recursive-chunk-filename"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + <xsl:text>-toc</xsl:text> + <xsl:value-of select="$html.ext"/> + </xsl:with-param> + </xsl:call-template> + </xsl:with-param> + <xsl:with-param name="content"> + <xsl:call-template name="chunk-element-content"> + <xsl:with-param name="prev" select="/foo"/> + <xsl:with-param name="next" select="/foo"/> + <xsl:with-param name="nav.context" select="'toc'"/> + <xsl:with-param name="content"> + <h1> + <xsl:apply-templates select="." mode="object.title.markup"/> + </h1> + <xsl:copy-of select="$lots"/> + </xsl:with-param> + </xsl:call-template> + </xsl:with-param> + <xsl:with-param name="quiet" select="$chunk.quietly"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$lots"/> + </xsl:otherwise> + </xsl:choose> + </xsl:if> +</xsl:template> + +<xsl:template name="make.lot.chunk"> + <xsl:param name="type" select="''"/> + <xsl:param name="lot"/> + + <xsl:if test="string($lot) != ''"> + <xsl:variable name="filename"> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.dir" select="$base.dir"/> + <xsl:with-param name="base.name"> + <xsl:call-template name="dbhtml-dir"/> + <xsl:value-of select="$type"/> + <xsl:text>-toc</xsl:text> + <xsl:value-of select="$html.ext"/> + </xsl:with-param> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="href"> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.name"> + <xsl:call-template name="dbhtml-dir"/> + <xsl:value-of select="$type"/> + <xsl:text>-toc</xsl:text> + <xsl:value-of select="$html.ext"/> + </xsl:with-param> + </xsl:call-template> + </xsl:variable> + + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename" select="$filename"/> + <xsl:with-param name="content"> + <xsl:call-template name="chunk-element-content"> + <xsl:with-param name="prev" select="/foo"/> + <xsl:with-param name="next" select="/foo"/> + <xsl:with-param name="nav.context" select="'toc'"/> + <xsl:with-param name="content"> + <xsl:copy-of select="$lot"/> + </xsl:with-param> + </xsl:call-template> + </xsl:with-param> + <xsl:with-param name="quiet" select="$chunk.quietly"/> + </xsl:call-template> + <!-- And output a link to this file --> + <div> + <xsl:attribute name="class"> + <xsl:text>ListofTitles</xsl:text> + </xsl:attribute> + <a href="{$href}"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key"> + <xsl:choose> + <xsl:when test="$type='table'">ListofTables</xsl:when> + <xsl:when test="$type='figure'">ListofFigures</xsl:when> + <xsl:when test="$type='equation'">ListofEquations</xsl:when> + <xsl:when test="$type='example'">ListofExamples</xsl:when> + <xsl:when test="$type='procedure'">ListofProcedures</xsl:when> + <xsl:otherwise>ListofUnknown</xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:call-template> + </a> + </div> + </xsl:if> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/component.xsl b/src/documentation/docbook-xsl/html/component.xsl new file mode 100644 index 0000000000..fbe433a57f --- /dev/null +++ b/src/documentation/docbook-xsl/html/component.xsl @@ -0,0 +1,387 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + +<!-- ******************************************************************** + $Id: component.xsl,v 1.27 2005/10/28 12:35:15 nwalsh Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:template name="component.title"> + <xsl:param name="node" select="."/> + + <xsl:variable name="level"> + <xsl:choose> + <xsl:when test="ancestor::section"> + <xsl:value-of select="count(ancestor::section)+1"/> + </xsl:when> + <xsl:when test="ancestor::sect5">6</xsl:when> + <xsl:when test="ancestor::sect4">5</xsl:when> + <xsl:when test="ancestor::sect3">4</xsl:when> + <xsl:when test="ancestor::sect2">3</xsl:when> + <xsl:when test="ancestor::sect1">2</xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <!-- Let's handle the case where a component (bibliography, for example) + occurs inside a section; will we need parameters for this? --> + + <xsl:element name="h{$level+1}"> + <xsl:attribute name="class">title</xsl:attribute> + <xsl:call-template name="anchor"> + <xsl:with-param name="node" select="$node"/> + <xsl:with-param name="conditional" select="0"/> + </xsl:call-template> + <xsl:apply-templates select="$node" mode="object.title.markup"> + <xsl:with-param name="allow-anchors" select="1"/> + </xsl:apply-templates> + </xsl:element> +</xsl:template> + +<xsl:template name="component.subtitle"> + <xsl:param name="node" select="."/> + <xsl:variable name="subtitle" + select="($node/docinfo/subtitle + |$node/info/subtitle + |$node/prefaceinfo/subtitle + |$node/chapterinfo/subtitle + |$node/appendixinfo/subtitle + |$node/articleinfo/subtitle + |$node/artheader/subtitle + |$node/subtitle)[1]"/> + + <xsl:if test="$subtitle"> + <h3 class="subtitle"> + <i> + <xsl:apply-templates select="$node" mode="object.subtitle.markup"/> + </i> + </h3> + </xsl:if> +</xsl:template> + +<xsl:template name="component.separator"> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="dedication" mode="dedication"> + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:call-template name="dir"> + <xsl:with-param name="inherit" select="1"/> + </xsl:call-template> + <xsl:call-template name="language.attribute"/> + <xsl:call-template name="dedication.titlepage"/> + <xsl:apply-templates/> + <xsl:call-template name="process.footnotes"/> + </div> +</xsl:template> + +<xsl:template match="dedication/title" mode="titlepage.mode" priority="2"> + <xsl:call-template name="component.title"> + <xsl:with-param name="node" select="ancestor::dedication[1]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="dedication/subtitle" mode="titlepage.mode" priority="2"> + <xsl:call-template name="component.subtitle"> + <xsl:with-param name="node" select="ancestor::dedication[1]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="dedication"></xsl:template> <!-- see mode="dedication" --> +<xsl:template match="dedication/title"></xsl:template> +<xsl:template match="dedication/subtitle"></xsl:template> +<xsl:template match="dedication/titleabbrev"></xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="colophon"> + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:call-template name="dir"> + <xsl:with-param name="inherit" select="1"/> + </xsl:call-template> + <xsl:call-template name="language.attribute"/> + <xsl:if test="$generate.id.attributes != 0"> + <xsl:attribute name="id"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </xsl:if> + + <xsl:call-template name="component.separator"/> + <xsl:call-template name="component.title"/> + <xsl:call-template name="component.subtitle"/> + + <xsl:apply-templates/> + <xsl:call-template name="process.footnotes"/> + </div> +</xsl:template> + +<xsl:template match="colophon/title"></xsl:template> +<xsl:template match="colophon/subtitle"></xsl:template> +<xsl:template match="colophon/titleabbrev"></xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="preface"> + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:call-template name="dir"> + <xsl:with-param name="inherit" select="1"/> + </xsl:call-template> + <xsl:call-template name="language.attribute"/> + <xsl:if test="$generate.id.attributes != 0"> + <xsl:attribute name="id"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </xsl:if> + + <xsl:call-template name="component.separator"/> + <xsl:call-template name="preface.titlepage"/> + + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + + <xsl:if test="contains($toc.params, 'toc')"> + <xsl:call-template name="component.toc"> + <xsl:with-param name="toc.title.p" select="contains($toc.params, 'title')"/> + </xsl:call-template> + <xsl:call-template name="component.toc.separator"/> + </xsl:if> + <xsl:apply-templates/> + <xsl:call-template name="process.footnotes"/> + </div> +</xsl:template> + +<xsl:template match="preface/title" mode="titlepage.mode" priority="2"> + <xsl:call-template name="component.title"> + <xsl:with-param name="node" select="ancestor::preface[1]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="preface/subtitle + |preface/prefaceinfo/subtitle + |preface/info/subtitle + |preface/docinfo/subtitle" + mode="titlepage.mode" priority="2"> + <xsl:call-template name="component.subtitle"> + <xsl:with-param name="node" select="ancestor::preface[1]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="preface/docinfo|prefaceinfo"></xsl:template> +<xsl:template match="preface/title"></xsl:template> +<xsl:template match="preface/titleabbrev"></xsl:template> +<xsl:template match="preface/subtitle"></xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="chapter"> + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:call-template name="dir"> + <xsl:with-param name="inherit" select="1"/> + </xsl:call-template> + <xsl:call-template name="language.attribute"/> + <xsl:if test="$generate.id.attributes != 0"> + <xsl:attribute name="id"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </xsl:if> + + <xsl:call-template name="component.separator"/> + <xsl:call-template name="chapter.titlepage"/> + + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + <xsl:if test="contains($toc.params, 'toc')"> + <xsl:call-template name="component.toc"> + <xsl:with-param name="toc.title.p" select="contains($toc.params, 'title')"/> + </xsl:call-template> + <xsl:call-template name="component.toc.separator"/> + </xsl:if> + <xsl:apply-templates/> + <xsl:call-template name="process.footnotes"/> + </div> +</xsl:template> + +<xsl:template match="chapter/title" mode="titlepage.mode" priority="2"> + <xsl:call-template name="component.title"> + <xsl:with-param name="node" select="ancestor::chapter[1]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="chapter/subtitle + |chapter/chapterinfo/subtitle + |chapter/info/subtitle + |chapter/docinfo/subtitle" + mode="titlepage.mode" priority="2"> + <xsl:call-template name="component.subtitle"> + <xsl:with-param name="node" select="ancestor::chapter[1]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="chapter/docinfo|chapterinfo"></xsl:template> +<xsl:template match="chapter/title"></xsl:template> +<xsl:template match="chapter/titleabbrev"></xsl:template> +<xsl:template match="chapter/subtitle"></xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="appendix"> + <xsl:variable name="ischunk"> + <xsl:call-template name="chunk"/> + </xsl:variable> + + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:call-template name="dir"> + <xsl:with-param name="inherit" select="1"/> + </xsl:call-template> + <xsl:call-template name="language.attribute"/> + <xsl:if test="$generate.id.attributes != 0"> + <xsl:attribute name="id"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </xsl:if> + + <xsl:choose> + <xsl:when test="parent::article and $ischunk = 0"> + <xsl:call-template name="section.heading"> + <xsl:with-param name="level" select="1"/> + <xsl:with-param name="title"> + <xsl:apply-templates select="." mode="object.title.markup"/> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="component.separator"/> + <xsl:call-template name="appendix.titlepage"/> + </xsl:otherwise> + </xsl:choose> + + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + + <xsl:if test="contains($toc.params, 'toc')"> + <xsl:call-template name="component.toc"> + <xsl:with-param name="toc.title.p" select="contains($toc.params, 'title')"/> + </xsl:call-template> + <xsl:call-template name="component.toc.separator"/> + </xsl:if> + + <xsl:apply-templates/> + + <xsl:if test="not(parent::article) or $ischunk != 0"> + <xsl:call-template name="process.footnotes"/> + </xsl:if> + </div> +</xsl:template> + +<xsl:template match="appendix/title" mode="titlepage.mode" priority="2"> + <xsl:call-template name="component.title"> + <xsl:with-param name="node" select="ancestor::appendix[1]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="appendix/subtitle + |appendix/appendixinfo/subtitle + |appendix/info/subtitle + |appendix/docinfo/subtitle" + mode="titlepage.mode" priority="2"> + <xsl:call-template name="component.subtitle"> + <xsl:with-param name="node" select="ancestor::appendix[1]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="appendix/docinfo|appendixinfo"></xsl:template> +<xsl:template match="appendix/title"></xsl:template> +<xsl:template match="appendix/titleabbrev"></xsl:template> +<xsl:template match="appendix/subtitle"></xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="article"> + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:call-template name="dir"> + <xsl:with-param name="inherit" select="1"/> + </xsl:call-template> + <xsl:call-template name="language.attribute"/> + <xsl:if test="$generate.id.attributes != 0"> + <xsl:attribute name="id"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </xsl:if> + + <xsl:call-template name="article.titlepage"/> + + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + + <xsl:call-template name="make.lots"> + <xsl:with-param name="toc.params" select="$toc.params"/> + <xsl:with-param name="toc"> + <xsl:call-template name="component.toc"> + <xsl:with-param name="toc.title.p" select="contains($toc.params, 'title')"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + + <xsl:apply-templates/> + <xsl:call-template name="process.footnotes"/> + </div> +</xsl:template> + +<xsl:template match="article/title" mode="titlepage.mode" priority="2"> + <xsl:call-template name="component.title"> + <xsl:with-param name="node" select="ancestor::article[1]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="article/subtitle + |article/articleinfo/subtitle + |article/info/subtitle + |article/artheader/subtitle" + mode="titlepage.mode" priority="2"> + <xsl:call-template name="component.subtitle"> + <xsl:with-param name="node" select="ancestor::article[1]"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="article/artheader|article/articleinfo"></xsl:template> +<xsl:template match="article/title"></xsl:template> +<xsl:template match="article/titleabbrev"></xsl:template> +<xsl:template match="article/subtitle"></xsl:template> + +<!-- ==================================================================== --> + +</xsl:stylesheet> + diff --git a/src/documentation/docbook-xsl/html/db5strip.xsl b/src/documentation/docbook-xsl/html/db5strip.xsl new file mode 100644 index 0000000000..a17710e1fd --- /dev/null +++ b/src/documentation/docbook-xsl/html/db5strip.xsl @@ -0,0 +1,33 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:ng="http://docbook.org/docbook-ng" + xmlns:db="http://docbook.org/ns/docbook" + xmlns:exsl="http://exslt.org/common" + exclude-result-prefixes="db ng exsl" + version='1.0'> + +<xsl:import href="docbook.xsl"/> + +<xsl:output method="xml" encoding="utf-8" indent="no"/> + +<xsl:template match="/"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set') + and (*/self::ng:* or */self::db:*)"> + <!-- Hack! If someone hands us a DocBook V5.x or DocBook NG document, + toss the namespace and continue. Someday we'll reverse this logic + and add the namespace to documents that don't have one. + But not before the whole stylesheet has been converted to use + namespaces. i.e., don't hold your breath --> + <xsl:message>Stripping NS from DocBook 5/NG document.</xsl:message> + <xsl:apply-templates mode="stripNS"/> + </xsl:when> + <xsl:otherwise> + <xsl:message terminate="yes"> + <xsl:text>Cannot strip without exsl:node-set.</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/division.xsl b/src/documentation/docbook-xsl/html/division.xsl new file mode 100644 index 0000000000..eb2046ab67 --- /dev/null +++ b/src/documentation/docbook-xsl/html/division.xsl @@ -0,0 +1,220 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + +<!-- ******************************************************************** + $Id: division.xsl,v 1.12 2006/05/04 12:21:28 kosek Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:template match="set"> + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:call-template name="dir"> + <xsl:with-param name="inherit" select="1"/> + </xsl:call-template> + <xsl:call-template name="language.attribute"/> + <xsl:if test="$generate.id.attributes != 0"> + <xsl:attribute name="id"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </xsl:if> + + <xsl:call-template name="set.titlepage"/> + + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + + <xsl:call-template name="make.lots"> + <xsl:with-param name="toc.params" select="$toc.params"/> + <xsl:with-param name="toc"> + <xsl:call-template name="set.toc"> + <xsl:with-param name="toc.title.p" select="contains($toc.params, 'title')"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + + <xsl:apply-templates/> + </div> +</xsl:template> + +<xsl:template match="set/setinfo"></xsl:template> +<xsl:template match="set/title"></xsl:template> +<xsl:template match="set/titleabbrev"></xsl:template> +<xsl:template match="set/subtitle"></xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="book"> + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:call-template name="dir"> + <xsl:with-param name="inherit" select="1"/> + </xsl:call-template> + <xsl:call-template name="language.attribute"/> + <xsl:if test="$generate.id.attributes != 0"> + <xsl:attribute name="id"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </xsl:if> + + <xsl:call-template name="book.titlepage"/> + + <xsl:apply-templates select="dedication" mode="dedication"/> + + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + + <xsl:call-template name="make.lots"> + <xsl:with-param name="toc.params" select="$toc.params"/> + <xsl:with-param name="toc"> + <xsl:call-template name="division.toc"> + <xsl:with-param name="toc.title.p" select="contains($toc.params, 'title')"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + + <xsl:apply-templates/> + </div> +</xsl:template> + +<xsl:template match="book/bookinfo"></xsl:template> +<xsl:template match="book/title"></xsl:template> +<xsl:template match="book/titleabbrev"></xsl:template> +<xsl:template match="book/subtitle"></xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="part"> + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:call-template name="dir"> + <xsl:with-param name="inherit" select="1"/> + </xsl:call-template> + <xsl:call-template name="language.attribute"/> + <xsl:if test="$generate.id.attributes != 0"> + <xsl:attribute name="id"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </xsl:if> + + <xsl:call-template name="part.titlepage"/> + + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + <xsl:if test="not(partintro) and contains($toc.params, 'toc')"> + <xsl:call-template name="division.toc"/> + </xsl:if> + <xsl:apply-templates/> + </div> +</xsl:template> + +<xsl:template match="part" mode="make.part.toc"> + <xsl:call-template name="division.toc"/> +</xsl:template> + +<xsl:template match="reference" mode="make.part.toc"> + <xsl:call-template name="division.toc"/> +</xsl:template> + +<xsl:template match="part/docinfo"></xsl:template> +<xsl:template match="part/partinfo"></xsl:template> +<xsl:template match="part/title"></xsl:template> +<xsl:template match="part/titleabbrev"></xsl:template> +<xsl:template match="part/subtitle"></xsl:template> + +<xsl:template match="partintro"> + <xsl:call-template name="id.warning"/> + + <div class="{name(.)}"> + <xsl:call-template name="dir"> + <xsl:with-param name="inherit" select="1"/> + </xsl:call-template> + <xsl:call-template name="language.attribute"/> + <xsl:if test="$generate.id.attributes != 0"> + <xsl:attribute name="id"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </xsl:if> + + <xsl:call-template name="partintro.titlepage"/> + <xsl:apply-templates/> + + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="node" select="parent::*"/> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + <xsl:if test="contains($toc.params, 'toc')"> + <!-- not ancestor::part because partintro appears in reference --> + <xsl:apply-templates select="parent::*" mode="make.part.toc"/> + </xsl:if> + <xsl:call-template name="process.footnotes"/> + </div> +</xsl:template> + +<xsl:template match="partintro/title"></xsl:template> +<xsl:template match="partintro/titleabbrev"></xsl:template> +<xsl:template match="partintro/subtitle"></xsl:template> + +<xsl:template match="partintro/title" mode="partintro.title.mode"> + <h2> + <xsl:apply-templates/> + </h2> +</xsl:template> + +<xsl:template match="partintro/subtitle" mode="partintro.title.mode"> + <h3> + <i><xsl:apply-templates/></i> + </h3> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="book" mode="division.number"> + <xsl:number from="set" count="book" format="1."/> +</xsl:template> + +<xsl:template match="part" mode="division.number"> + <xsl:number from="book" count="part" format="I."/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="division.title"> + <xsl:param name="node" select="."/> + + <h1> + <xsl:attribute name="class">title</xsl:attribute> + <xsl:call-template name="anchor"> + <xsl:with-param name="node" select="$node"/> + <xsl:with-param name="conditional" select="0"/> + </xsl:call-template> + <xsl:apply-templates select="$node" mode="object.title.markup"> + <xsl:with-param name="allow-anchors" select="1"/> + </xsl:apply-templates> + </h1> +</xsl:template> + +</xsl:stylesheet> + diff --git a/src/documentation/docbook-xsl/html/docbook.xsl b/src/documentation/docbook-xsl/html/docbook.xsl new file mode 100644 index 0000000000..198c8cc6b3 --- /dev/null +++ b/src/documentation/docbook-xsl/html/docbook.xsl @@ -0,0 +1,442 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:ng="http://docbook.org/docbook-ng" + xmlns:db="http://docbook.org/ns/docbook" + xmlns:exsl="http://exslt.org/common" + exclude-result-prefixes="db ng exsl" + version='1.0'> + +<xsl:output method="html" + encoding="ISO-8859-1" + indent="no"/> + +<!-- ******************************************************************** + $Id: docbook.xsl,v 1.41 2006/04/21 14:37:19 nwalsh Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:include href="../VERSION"/> +<xsl:include href="param.xsl"/> +<xsl:include href="../lib/lib.xsl"/> +<xsl:include href="../common/l10n.xsl"/> +<xsl:include href="../common/common.xsl"/> +<xsl:include href="../common/labels.xsl"/> +<xsl:include href="../common/titles.xsl"/> +<xsl:include href="../common/subtitles.xsl"/> +<xsl:include href="../common/gentext.xsl"/> +<xsl:include href="../common/targets.xsl"/> +<xsl:include href="../common/olink.xsl"/> +<xsl:include href="../common/pi.xsl"/> +<xsl:include href="autotoc.xsl"/> +<xsl:include href="autoidx.xsl"/> +<xsl:include href="lists.xsl"/> +<xsl:include href="callout.xsl"/> +<xsl:include href="verbatim.xsl"/> +<xsl:include href="graphics.xsl"/> +<xsl:include href="xref.xsl"/> +<xsl:include href="formal.xsl"/> +<xsl:include href="table.xsl"/> +<xsl:include href="htmltbl.xsl"/> +<xsl:include href="sections.xsl"/> +<xsl:include href="inline.xsl"/> +<xsl:include href="footnote.xsl"/> +<xsl:include href="html.xsl"/> +<xsl:include href="info.xsl"/> +<xsl:include href="keywords.xsl"/> +<xsl:include href="division.xsl"/> +<xsl:include href="toc.xsl"/> +<xsl:include href="index.xsl"/> +<xsl:include href="refentry.xsl"/> +<xsl:include href="math.xsl"/> +<xsl:include href="admon.xsl"/> +<xsl:include href="component.xsl"/> +<xsl:include href="biblio.xsl"/> +<xsl:include href="glossary.xsl"/> +<xsl:include href="block.xsl"/> +<xsl:include href="task.xsl"/> +<xsl:include href="qandaset.xsl"/> +<xsl:include href="synop.xsl"/> +<xsl:include href="titlepage.xsl"/> +<xsl:include href="titlepage.templates.xsl"/> +<xsl:include href="pi.xsl"/> +<xsl:include href="ebnf.xsl"/> +<xsl:include href="chunker.xsl"/> +<xsl:include href="html-rtf.xsl"/> +<xsl:include href="docbookng.xsl"/> +<xsl:include href="annotations.xsl"/> +<xsl:include href="../common/stripns.xsl"/> + +<xsl:param name="stylesheet.result.type" select="'html'"/> +<xsl:param name="htmlhelp.output" select="0"/> + +<!-- ==================================================================== --> + +<xsl:key name="id" match="*" use="@id|@xml:id"/> +<xsl:key name="gid" match="*" use="generate-id()"/> + +<!-- ==================================================================== --> + +<xsl:template match="*"> + <xsl:message> + <xsl:text>No template matches </xsl:text> + <xsl:value-of select="name(.)"/> + <xsl:if test="parent::*"> + <xsl:text> in </xsl:text> + <xsl:value-of select="name(parent::*)"/> + </xsl:if> + <xsl:text>.</xsl:text> + </xsl:message> + + <font color="red"> + <xsl:text><</xsl:text> + <xsl:value-of select="name(.)"/> + <xsl:text>></xsl:text> + <xsl:apply-templates/> + <xsl:text></</xsl:text> + <xsl:value-of select="name(.)"/> + <xsl:text>></xsl:text> + </font> +</xsl:template> + +<xsl:template match="text()"> + <xsl:value-of select="."/> +</xsl:template> + +<xsl:template name="body.attributes"> + <xsl:attribute name="bgcolor">white</xsl:attribute> + <xsl:attribute name="text">black</xsl:attribute> + <xsl:attribute name="link">#0000FF</xsl:attribute> + <xsl:attribute name="vlink">#840084</xsl:attribute> + <xsl:attribute name="alink">#0000FF</xsl:attribute> +</xsl:template> + +<xsl:template name="head.content"> + <xsl:param name="node" select="."/> + <xsl:param name="title"> + <xsl:apply-templates select="$node" mode="object.title.markup.textonly"/> + </xsl:param> + + <title> + <xsl:copy-of select="$title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Stripping NS from DocBook 5/NG document. + + + + + Processing stripped document. + + + + + + + + + ID ' + + ' not found in document. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + diff --git a/src/documentation/docbook-xsl/html/docbookng.xsl b/src/documentation/docbook-xsl/html/docbookng.xsl new file mode 100644 index 0000000000..4f8e7a6f58 --- /dev/null +++ b/src/documentation/docbook-xsl/html/docbookng.xsl @@ -0,0 +1,7 @@ + + + + + + diff --git a/src/documentation/docbook-xsl/html/ebnf.xsl b/src/documentation/docbook-xsl/html/ebnf.xsl new file mode 100644 index 0000000000..c82a639ec5 --- /dev/null +++ b/src/documentation/docbook-xsl/html/ebnf.xsl @@ -0,0 +1,327 @@ + + + + + + + + +$Id: ebnf.xsl,v 1.9 2003/04/12 21:08:45 nwalsh Exp $ + +Walsh +Norman +19992000 +Norman Walsh + + +HTML EBNF Reference + + +
                  Introduction + +This is technical reference documentation for the DocBook XSL +Stylesheets; it documents (some of) the parameters, templates, and +other elements of the stylesheets. + +This reference describes the templates and parameters relevant +to formatting EBNF markup. + +This is not intended to be user documentation. +It is provided for developers writing customization layers for the +stylesheets, and for anyone who's interested in how it +works. + +Although I am trying to be thorough, this documentation is known +to be incomplete. Don't forget to read the source, too :-) +
                  +                   +                   + + + + + + + + + + + + 1 + + + + + + EBNF + + for + + + + + + + + + + + + +
                  + +
                  + + + + + + + + + + EBNF productions + +
                  +
                  +                   + + + + + + + + + + [ + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + Error: no ID for productionrecap linkend: + + . + + + + + + Warning: multiple "IDs" for productionrecap linkend: + + . + + + + + + + + + + + + + + + + | +
                  +                   +                   + + + + + + + + + + + + + + + production + + + + + + + + + Non-terminals with no content must point to + production elements in the current document. + + + Invalid xpointer for empty nt: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ??? + + + + + + + + + + + + + /*  + +  */ +
                  +                   + + + + + + + + + constraintdef + + + + + + + + + + + [  + + + + + : + + + + + + + : + + + + + + + + + +  ] + +
                  +                   +                   + + +
                  + + +
                  +                   + + +

                  +                   + + + +                   diff --git a/src/documentation/docbook-xsl/html/footnote.xsl b/src/documentation/docbook-xsl/html/footnote.xsl new file mode 100644 index 0000000000..6967d169e0 --- /dev/null +++ b/src/documentation/docbook-xsl/html/footnote.xsl @@ -0,0 +1,284 @@ + + + + + + + + + + + #ftn. + + + + + + + [ + + + + ] + + + + + [ + + + + ] + + + + + + + + + + #ftn. + + + + + + [ + + + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ftn. + + + + + + # + + + + +

                  + + + + + + + [ + + + + ] + + +

                  +                   + + + + + + ftn. + + + + + + # + + + + + + + [ + + + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +
                  +
                  + +
                  +                   + + +
                  +
                  +

                  The following annotations are from this essay. You are seeing + them here because your browser doesn’t support the user-interface + techniques used to make them appear as ‘popups’ on modern browsers.

                  +
                  + + +
                  +                   +                   + + + + + + + + +
                  + +
                  +                   + + +
                  + + +
                  +                   + + + + Warning: footnote number may not be generated + correctly; + + unexpected as first child of footnote. + +
                  + +
                  +                   +                   +                   + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/html/formal.xsl b/src/documentation/docbook-xsl/html/formal.xsl new file mode 100644 index 0000000000..5b0334eb05 --- /dev/null +++ b/src/documentation/docbook-xsl/html/formal.xsl @@ -0,0 +1,400 @@ + + + + + +1 + + + + + + + + +
                  + + + + + + + +
                  + +
                  + + + + + +

                  + + +

                  +

                  + + + + + + + +                   +
                  + +
                  +                   +                   + + + + + + + + + -float + + + + + + + + + +                   + + + + + + + + + +

                  + + + +

                  +                   + + + + + +
                  +

                  + + + + + + + + +

                  +

                  +                   + + + + + + + + + -float + + + + + + + + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Broken table: tr descendent of CALS Table. + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + Broken table: row descendent of HTML table. + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + float: + + ; + + + +
                  +                   + +                   diff --git a/src/documentation/docbook-xsl/html/glossary.xsl b/src/documentation/docbook-xsl/html/glossary.xsl new file mode 100644 index 0000000000..3e84662d01 --- /dev/null +++ b/src/documentation/docbook-xsl/html/glossary.xsl @@ -0,0 +1,393 @@ + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  +                   +                   + + + + +
                  +                   + + + + + + + + + +
                  + + + + +
                  + +
                  +
                  +                   + + + + + + +
                  + + +
                  + +
                  +
                  +                   + + +

                  + +

                  +                   + + + + + + + + +
                  + + + + 0 + 1 + + + + + + + + ( + + ) + + + + + +
                  +                   + +
                  + + + + 0 + 1 + + + + + + + + ( + + ) + +
                  +                   + +
                  + + + + 0 + 1 + + + + + +
                  +                   +                   + + +                   + + + + , + + + + + , + + + + + , + + + + + + + + + + +
                  +

                  + + + + + + + + + + + + + + + + + + + + + + Warning: glosssee @otherterm reference not found: + + + + + + + + + + + + + + + . +

                  +
                  +                   + + +
                  + + +

                  + + + + + + + + + + + + + +

                  +                   +
                  +                   + + + + + + + + + + + + + + + + + + + + Warning: glossseealso @otherterm reference not found: + + + + + + + + + + + + . + + + , + + + + + + + + + + + + + + + + + Warning: processing automatic glossary + without a glossary.collection file. + + + + + + Warning: processing automatic glossary but unable to + open glossary.collection file ' + + ' + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + +
                  +                   +                   + + + + +
                  +                   + + + + + + + + + +
                  + + +
                  + + + + + + +
                  +
                  +                   + + + +                   diff --git a/src/documentation/docbook-xsl/html/graphics.xsl b/src/documentation/docbook-xsl/html/graphics.xsl new file mode 100644 index 0000000000..0087fe3e06 --- /dev/null +++ b/src/documentation/docbook-xsl/html/graphics.xsl @@ -0,0 +1,1439 @@ + + + + + + + + + + + + + + 1 + + + + + + 1 + + + + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 0 + 0 + + 1 + 0 + + + + + + 1.0 + 1.0 + + + + 1.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + px + + + + + + + + + + + px + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + px + + + + + + + + + + + px + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + middle + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: imagemaps not supported + on scaled images + + + + 0 + + + + + + + + + + + + + + + + + + + + middle + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + height: + + px + + + + + + + + + + + +
                  + + + + + background-color: + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + +                   + + + + + + + + + + + + + calspair + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + , + + , + + , + + + + + + + Warning: only calspair supported + in imageobjectco + + + + + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + middle + + + + + + + + + + + + + + + + + +
                  + + + + + + + +
                  +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No insertfile extension available. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No insertfile extension available. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +
                  + + [ +                   D + ] + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No insertfile extension available. + + + + + + + + + + + + + +
                  + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/html/html-rtf.xsl b/src/documentation/docbook-xsl/html/html-rtf.xsl new file mode 100644 index 0000000000..c9062c348c --- /dev/null +++ b/src/documentation/docbook-xsl/html/html-rtf.xsl @@ -0,0 +1,335 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + + + +                   +                   +                   +                   + + + + + + + + + + + + + + +
                  +                   + + + + + + + + + + +                   +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/html/html.xsl b/src/documentation/docbook-xsl/html/html.xsl new file mode 100644 index 0000000000..a0c61d8ebb --- /dev/null +++ b/src/documentation/docbook-xsl/html/html.xsl @@ -0,0 +1,166 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   + + + + + + + # + + + + + + + + + # + + + + + + + + + + + + + + + + + bullet + + + + + + + + + bullet + + • + © + ™ + ™ + ® + (SM) +   + “ + ” + ‘ + ’ + — + — + – + – + + • + + + + + + + + + + + + + + + + + + + + + + + + + ID recommended on + + + : + + + + ... + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/html/htmltbl.xsl b/src/documentation/docbook-xsl/html/htmltbl.xsl new file mode 100644 index 0000000000..e07421667d --- /dev/null +++ b/src/documentation/docbook-xsl/html/htmltbl.xsl @@ -0,0 +1,55 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/html/index.xsl b/src/documentation/docbook-xsl/html/index.xsl new file mode 100644 index 0000000000..6fbe011b07 --- /dev/null +++ b/src/documentation/docbook-xsl/html/index.xsl @@ -0,0 +1,223 @@ + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  +                   +                   +                   + + + + + + + + + + +
                  +                   +                   + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + +
                  +                   +                   + + + + + + + + + + +
                  + + + + + + + + +
                  + +
                  +
                  +                   + + +

                  + +

                  +                   + + + + + + + + + +                   + + + + + + + + + + + + +
                  + +
                  + + +
                  +
                  + +
                  +
                  +                   + +
                  +
                  + +
                  +
                  +                   +                   +                   + + +
                  + +
                  + + +
                  +
                  + +
                  +
                  +                   + +
                  +
                  + +
                  +
                  +                   +                   +                   + + +
                  + +
                  + +
                  +
                  + +
                  +
                  +                   +                   + + +
                  + +
                  +                   + + diff --git a/src/documentation/docbook-xsl/html/info.xsl b/src/documentation/docbook-xsl/html/info.xsl new file mode 100644 index 0000000000..5bcee98f32 --- /dev/null +++ b/src/documentation/docbook-xsl/html/info.xsl @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/html/inline.xsl b/src/documentation/docbook-xsl/html/inline.xsl new file mode 100644 index 0000000000..56a22df06d --- /dev/null +++ b/src/documentation/docbook-xsl/html/inline.xsl @@ -0,0 +1,1197 @@ + + +]> + + + + + + + + + + + + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + XLink to nonexistent id: + + + ??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + span + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + , + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + abbr + + + + + + acronym + + + + + + + + + + + + + + + + + + + + + + + + + http://example.com/cgi-bin/man.cgi? + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + emphasis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + SM + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: glossary.collection specified, but there are + + automatic glossaries + + + + + + + + + + + + + + + + + + + + + + + + There's no entry for + + in + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Error: no glossentry for glossterm: + + . + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + element + + + + + + + + + + + + + + + + + </ + + > + + + & + + ; + + + &# + + ; + + + % + + ; + + + <? + + > + + + <? + + ?> + + + < + + > + + + < + + /> + + + <!-- + + --> + + + + + + + + + + + + < + + mailto: + + + > + + + + + + + + + + + + - + - + - + + - + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Citation to nonexistent publication abbrev: + + + [ + + ] + + + + + + + + +

                  +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/html/keywords.xsl b/src/documentation/docbook-xsl/html/keywords.xsl new file mode 100644 index 0000000000..228709aa4a --- /dev/null +++ b/src/documentation/docbook-xsl/html/keywords.xsl @@ -0,0 +1,35 @@ + + + + + + + + + + + + + + + + + + + + + , + + + + + diff --git a/src/documentation/docbook-xsl/html/lists.xsl b/src/documentation/docbook-xsl/html/lists.xsl new file mode 100644 index 0000000000..921e9c97dd --- /dev/null +++ b/src/documentation/docbook-xsl/html/lists.xsl @@ -0,0 +1,1092 @@ + + + + + + + + +
                  + + + + + + + + +
                    + + + + + + + + + + + + +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + circle + disc + square + + + + + + +
                • + + + list-style-type: + + + + + + + + + + + +
                  + +
                  +                   + + + +                   +
                  • +                   + + + + + + + + + + + + + 1 + a + i + A + I + + + + Unexpected numeration: + + + + + + + +
                  + + + + + + + + + +
                    + + + + + + + + + + + + + + + + +
                  +
                  +                   + + + + + + +
                • + + + + + + + + + + + + + +
                  + +
                  +                   + + + +                   +
                  • +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + +
                  + +
                  +                   +                   +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + +

                  + + + + + + + + +

                  +                   +                   +                   + + +
                  + + +
                  +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   +                   +                   +                   + + + + +
                  + +
                  +                   + + + +                   +                   + + + + + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + + 1 + + + +
                  +                   + + + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + 1 + 1 + + 1 + + + + + + + + +   + + + + + + + + + + + + + + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + 1 + 1 + + 1 + + + + + + + + +   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + +
                  + + + + 0 + 1 + + + + + + + + + + + + +
                    + +
                  +                   + +
                    + + + + +
                  +                   +                   + + + + +
                  +                   + + + + + + + + + + + + +
                    + +
                  +                   + + +
                • + + +
                  • +                   + + + +
                    + +
                  +                   + + +

                  + + + +

                  +                   + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + +
                  + + +
                  +                   + + + + + + + + +
                  + + + + : + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + +
                  +                   + +
                  + +
                  +                   +                   +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + +
                  +
                  +                   +                   +                   + + + + + + + + + +

                  + + + + + + + + +

                  +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ??? + + + + + # + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ??? + + + + + + +                   + diff --git a/src/documentation/docbook-xsl/html/maketoc.xsl b/src/documentation/docbook-xsl/html/maketoc.xsl new file mode 100644 index 0000000000..fecea38708 --- /dev/null +++ b/src/documentation/docbook-xsl/html/maketoc.xsl @@ -0,0 +1,83 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + filename=" + + " + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/html/manifest.xsl b/src/documentation/docbook-xsl/html/manifest.xsl new file mode 100644 index 0000000000..2b94cc7a39 --- /dev/null +++ b/src/documentation/docbook-xsl/html/manifest.xsl @@ -0,0 +1,122 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/html/math.xsl b/src/documentation/docbook-xsl/html/math.xsl new file mode 100644 index 0000000000..d41a53538b --- /dev/null +++ b/src/documentation/docbook-xsl/html/math.xsl @@ -0,0 +1,268 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unsupported TeX math notation: + + + + + + + + + + + + + \nopagenumbers + + + + \bye + + + + + + + + + + + + + + + + + + + + + + + \special{dvi2bitmap outputfile + + } + + $ + + + + $ + + \vfill\eject + + + + + + + + + + + + + + + + + + + + + + + + \special{dvi2bitmap outputfile + + } + + $$ + + + + $$ + + \vfill\eject + + + + + + + + + \documentclass{article} + \pagestyle{empty} + \begin{document} + + + + \end{document} + + + + + + + + + + + + + + + + + + + + + + + \special{dvi2bitmap outputfile + + } + + $ + + + + $ + + \newpage + + + + + + + + + + + + + + + + + + + + + + + + \special{dvi2bitmap outputfile + + } + + $$ + + + + $$ + + \newpage + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 0 + 1 + + + + + + diff --git a/src/documentation/docbook-xsl/html/oldchunker.xsl b/src/documentation/docbook-xsl/html/oldchunker.xsl new file mode 100644 index 0000000000..f6e8f2fbcd --- /dev/null +++ b/src/documentation/docbook-xsl/html/oldchunker.xsl @@ -0,0 +1,202 @@ + + + + + + + + + + + + + +Encoding used in generated HTML pages + +This encoding is used in files generated by chunking stylesheet. Currently +only Saxon is able to change output encoding. + + + + + + + + + +Saxon character representation used in generated HTML pages + +This character representation is used in files generated by chunking stylesheet. If +you want to suppress entity references for characters with direct representation +in default.encoding, set this parameter to value native. + + + + + + + + + + + + + + + + + + + + + + + + Chunking isn't supported with + + + + + + + + + + + + + + + Writing + + + for + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Can't make chunks with + + 's processor. + + + + + + + + + + + + + + + + Writing + + + for + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Can't make chunks with + + 's processor. + + + + + + diff --git a/src/documentation/docbook-xsl/html/onechunk.xsl b/src/documentation/docbook-xsl/html/onechunk.xsl new file mode 100644 index 0000000000..6e7d9391ad --- /dev/null +++ b/src/documentation/docbook-xsl/html/onechunk.xsl @@ -0,0 +1,37 @@ + + + + + + + + + + + + + + + +1 + + + + # + + + + + + diff --git a/src/documentation/docbook-xsl/html/param.ent b/src/documentation/docbook-xsl/html/param.ent new file mode 100644 index 0000000000..60efcb2209 --- /dev/null +++ b/src/documentation/docbook-xsl/html/param.ent @@ -0,0 +1,291 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/html/param.xml b/src/documentation/docbook-xsl/html/param.xml new file mode 100644 index 0000000000..8decd69bd5 --- /dev/null +++ b/src/documentation/docbook-xsl/html/param.xml @@ -0,0 +1,9402 @@ + + + + +HTML Parameter Reference + +$Id: param.xweb,v 1.103 2006/05/14 06:22:26 bobstayton Exp $ + + + Walsh + Norman + + + 1999 + 2000 + 2001 + Norman Walsh + + + +Introduction + +This is reference documentation for all user-configurable +parameters in the DocBook XSL HTML stylesheets (for generating +HTML output). + +This reference describes each of the HTML Stylesheet parameters. +These are the easily customizable parts of the stylesheet. +If you want to specify an alternate value for one or more of these +parameters, you can do so in a driver stylesheet. + +For example, if you want to change the html.stylesheet +to reference.css, you might create a driver +stylesheet like this: + +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + + <xsl:import href="http://docbook.sourceforge.net/release/xsl/snapshot/html/docbook.xsl"/> + + <xsl:param name="html.stylesheet">reference.css</xsl:param> + +</xsl:stylesheet> + +Naturally, you have to change the +href attribute on +<xsl:import> to point to +docbook.xsl on your system. (Or +chunk.xsl, if you're using chunking.) + + +Admonitions + + +admon.graphics.extension +string + + +admon.graphics.extension +Extension for admonition graphics + + + +<xsl:param name="admon.graphics.extension" select="'.png'"></xsl:param> + + +Description + +Sets the extension to use on admonition graphics. + + + + + + +admon.graphics.path +string + + +admon.graphics.path +Path to admonition graphics + + + +<xsl:param name="admon.graphics.path">images/</xsl:param> + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the admonition graphics. + + + + + + + +admon.graphics +boolean + + +admon.graphics +Use graphics in admonitions? + + + + +<xsl:param name="admon.graphics" select="0"></xsl:param> + + + +Description + +If true (non-zero), admonitions are presented in an alternate style that uses +a graphic. Default graphics are provided in the distribution. + + + + + + + +admon.textlabel +boolean + + +admon.textlabel +Use text label in admonitions? + + + + +<xsl:param name="admon.textlabel" select="1"></xsl:param> + + + +Description + +If true (non-zero), admonitions are presented with a generated +text label such as Note or Warning in the appropriate language. +If zero, such labels are turned off, but any title child +of the admonition element are still output. +The default value is 1. + + + + + + + + +admon.style +string + + +admon.style +CSS style attributes for admonitions + + + +<xsl:param name="admon.style"> + <xsl:text>margin-left: 0.5in; margin-right: 0.5in;</xsl:text> +</xsl:param> + + +Description + +Specifies the value of the STYLE +attribute that should be added to admonitions. + + + + + + + +Callouts + + +callout.defaultcolumn +integer + + +callout.defaultcolumn +Indicates what column callouts appear in by default + + + +<xsl:param name="callout.defaultcolumn" select="'60'"></xsl:param> + + +Description + +If a callout does not identify a column (for example, if it uses +the linerange unit), +it will appear in the default column. + + + + + + + +callout.graphics.extension +string + + +callout.graphics.extension +Extension for callout graphics + + + +<xsl:param name="callout.graphics.extension" select="'.png'"></xsl:param> + + +Description + +Sets the extension to use on callout graphics. + + + + + + +callout.graphics.number.limit +integer + + +callout.graphics.number.limit +Number of the largest callout graphic + + + +<xsl:param name="callout.graphics.number.limit" select="'15'"></xsl:param> + + +Description + +If callout.graphics +is non-zero, graphics are used to represent +callout numbers. The value of +callout.graphics.number.limit +is +the largest number for which a graphic exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + + + + +callout.graphics.path +string + + +callout.graphics.path +Path to callout graphics + + + + +<xsl:param name="callout.graphics.path" select="'images/callouts/'"></xsl:param> + + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the callout graphics. + + + + + + + +callout.graphics +boolean + + +callout.graphics +Use graphics for callouts? + + + + +<xsl:param name="callout.graphics" select="'1'"></xsl:param> + + + +Description + +If non-zero, callouts are presented with graphics (e.g., reverse-video +circled numbers instead of "(1)", "(2)", etc.). +Default graphics are provided in the distribution. + + + + + + + +callout.list.table +boolean + + +callout.list.table +Present callout lists using a table? + + + +<xsl:param name="callout.list.table" select="'1'"></xsl:param> + + +Description + +The default presentation of CalloutLists uses +an HTML DL. Some browsers don't align DLs very well +if callout.graphics are used. With this option +turned on, CalloutLists are presented in an HTML +TABLE, which usually results in better alignment +of the callout number with the callout description. + + + + + + +callout.unicode.number.limit +integer + + +callout.unicode.number.limit +Number of the largest callout graphic + + + +<xsl:param name="callout.unicode.number.limit" select="'10'"></xsl:param> + + +Description + +If callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.number.limit +is +the largest number for which a unicode character exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + + + + +callout.unicode.start.character +integer + + +callout.unicode.start.character +First Unicode character to use, decimal value. + + + +<xsl:param name="callout.unicode.start.character" select="10102"></xsl:param> + + +Description + +If callout.graphics is zero and callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.start.character +is the decimal unicode value used for callout number one. Currently, +only 10102 is supported in the stylesheets for this parameter. + + + + + + + +callout.unicode +boolean + + +callout.unicode +Use Unicode characters rather than images for callouts. + + + +<xsl:param name="callout.unicode" select="0"></xsl:param> + + +Description + +The stylesheets can use either an image of the numbers one to ten, or the single Unicode character which represents the numeral, in white on a black background. Use this to select the Unicode character option. + + + + + + + +callouts.extension +boolean + + +callouts.extension +Enable the callout extension + + + +<xsl:param name="callouts.extension" select="'1'"></xsl:param> + + +Description + +The callouts extension processes areaset +elements in ProgramListingCO and other text-based +callout elements. + + + + + + + +EBNF + + +ebnf.table.bgcolor +string + + +ebnf.table.bgcolor +Background color for EBNF tables + + + +<xsl:param name="ebnf.table.bgcolor" select="'#F5DCB3'"></xsl:param> + + +Description + +Sets the background color for EBNF tables. No bgcolor +attribute is output if ebnf.table.bgcolor is set to +the null string. The default value matches the value used in recent +online versions of the W3C's XML Spec productions. + + + + + + +ebnf.table.border + + + +ebnf.table.border +Selects border on EBNF tables + + + +<xsl:param name="ebnf.table.border" select="1"></xsl:param> + + +Description + +Selects the border on EBNF tables. If non-zero, the tables have +borders, otherwise they don't. + + + + + + +ebnf.assignment +rtf + + +ebnf.assignment +The EBNF production assignment operator + + + + +<xsl:param name="ebnf.assignment"> +<code>::=</code> +</xsl:param> + + + + +Description + +The ebnf.assignment parameter determines what +text is used to show assignment in productions +in productionsets. + +While ::= is common, so are several +other operators. + + + + + + +ebnf.statement.terminator +rtf + + +ebnf.statement.terminator +Punctuation that ends an EBNF statement. + + + + +<xsl:param name="ebnf.statement.terminator"></xsl:param> + + + + +Description + +The ebnf.statement.terminator parameter determines what +text is used to terminate each production +in productionset. + +Some notations end each statement with a period. + + + + + + +ToC/LoT/Index Generation + + +annotate.toc +boolean + + +annotate.toc +Annotate the Table of Contents? + + + +<xsl:param name="annotate.toc" select="1"></xsl:param> + + +Description + +If true, TOCs will be annotated. At present, this just means +that the RefPurpose of RefEntry +TOC entries will be displayed. + + + + + + + +autotoc.label.separator +string + + +autotoc.label.separator +Separator between labels and titles in the ToC + + + +<xsl:param name="autotoc.label.separator" select="'. '"></xsl:param> + + +Description + +String to use to seperate labels and title in a table of contents. + + + + + + +autotoc.label.in.hyperlink +boolean + + +autotoc.label.in.hyperlink +Include lable in hyperlinked titles in TOC? + + + +<xsl:param name="autotoc.label.in.hyperlink" select="1"></xsl:param> + + +Description + +If the value of +autotoc.label.in.hyperlink is non-zero, labels +are included in hyperlinked titles in the TOC. If it is instead zero, +labels are still displayed prior to the hyperlinked titles, but +are not hyperlinked along with the titles. + + + + + + +process.source.toc +boolean + + +process.source.toc +Process a non-empty toc element if it occurs in a source document? + + + +<xsl:param name="process.source.toc" select="0"></xsl:param> + + +Description + +Specifies that the contents of a non-empty "hard-coded" +toc element in a source document are processed to +generate a TOC in output. + + This parameter has no effect on automated generation of + TOCs. An automated TOC may still be generated along with the + "hard-coded" TOC. To suppress automated TOC generation, adjust the + value of the generate.toc paramameter. + + The process.source.toc parameter also has + no effect if the toc element is empty; handling + for empty toc is controlled by the + process.empty.source.toc parameter. + + + + + + + + +process.empty.source.toc +boolean + + +process.empty.source.toc +Generate automated TOC if toc element occurs in a source document? + + + +<xsl:param name="process.empty.source.toc" select="0"></xsl:param> + + +Description + +Specifies that if an empty toc element is +found in a source document, an automated TOC is generated. + + Depending on what the value of the + generate.toc parameter is, setting this + parameter to 1 could result in generation of + duplicate automated TOCs. So the + process.empty.source.toc is primarily useful + as an "override": by placing an empty toc in your + document and setting this parameter to 1, you can + force a TOC to be generated even if generate.toc + says not to. + + + + + + + + +bridgehead.in.toc +boolean + + +bridgehead.in.toc +Should bridgehead elements appear in the TOC? + + + +<xsl:param name="bridgehead.in.toc" select="0"></xsl:param> + + +Description + +If non-zero, bridgeheads appear in the TOC. Note that this option +is not fully supported and may be removed in a future version of the +stylesheets. + + + + + + + +simplesect.in.toc +boolean + + +simplesect.in.toc +Should simplesect elements appear in the TOC? + + + +<xsl:param name="simplesect.in.toc" select="0"></xsl:param> + + +Description + +If non-zero, simplesects appear in the TOC. + + + + + + + +manual.toc +string + + +manual.toc +An explicit TOC to be used for the TOC + + + + +<xsl:param name="manual.toc" select="''"></xsl:param> + + + +Description + +The manual.toc identifies an explicit TOC that +will be used for building the printed TOC. + + + + + + + +toc.list.type +list +dl +ul +ol + + +toc.list.type +Type of HTML list element to use for Tables of Contents + + + +<xsl:param name="toc.list.type">dl</xsl:param> + + +Description + +When an automatically generated Table of Contents (or List of Titles) +is produced, this HTML element will be used to make the list. + + + + + + + +toc.section.depth +integer + + +toc.section.depth +How deep should recursive sections appear +in the TOC? + + + +<xsl:param name="toc.section.depth">2</xsl:param> + + +Description + +Specifies the depth to which recursive sections should appear in the +TOC. + + + + + + + +toc.max.depth +integer + + +toc.max.depth +How maximaly deep should be each TOC? + + + +<xsl:param name="toc.max.depth">8</xsl:param> + + +Description + +Specifies the maximal depth of TOC on all levels. + + + + + + +generate.toc +table + + +generate.toc +Control generation of ToCs and LoTs + + + + +<xsl:param name="generate.toc"> +appendix toc,title +article/appendix nop +article toc,title +book toc,title,figure,table,example,equation +chapter toc,title +part toc,title +preface toc,title +qandadiv toc +qandaset toc +reference toc,title +sect1 toc +sect2 toc +sect3 toc +sect4 toc +sect5 toc +section toc +set toc,title +</xsl:param> + + + + +Description + +This parameter has a structured value. It is a table of space-delimited +path/value pairs. Each path identifies some element in the source document +using a restricted subset of XPath (only the implicit child axis, no wildcards, +no predicates). Paths can be either relative or absolute. + +When processing a particular element, the stylesheets consult this table to +determine if a ToC (or LoT(s)) should be generated. + +For example, consider the entry: + +book toc,figure + +This indicates that whenever a book is formatted, a +Table Of Contents and a List of Figures should be generated. Similarly, + +/chapter toc + +indicates that whenever a document that has a root +of chapter is formatted, a Table of +Contents should be generated. The entry chapter would match +all chapters, but /chapter matches only chapter +document elements. + +Generally, the longest match wins. So, for example, if you want to distinguish +articles in books from articles in parts, you could use these two entries: + +book/article toc,figure +part/article toc + +Note that an article in a part can never match a book/article, +so if you want nothing to be generated for articles in parts, you can simply leave +that rule out. + +If you want to leave the rule in, to make it explicit that you're turning +something off, use the value nop. For example, the following +entry disables ToCs and LoTs for articles: + +article nop + +Do not simply leave the word article in the file +without a matching value. That'd be just begging the silly little +path/value parser to get confused. + +Section ToCs are further controlled by the +generate.section.toc.level parameter. +For a given section level to have a ToC, it must have both an entry in +generate.toc and be within the range enabled by +generate.section.toc.level. + + + + + +generate.section.toc.level +integer + + +generate.section.toc.level +Control depth of TOC generation in sections + + + + +<xsl:param name="generate.section.toc.level" select="0"></xsl:param> + + + +Description + +The generate.section.toc.level parameter +controls the depth of section in which TOCs will be generated. Note +that this is related to, but not the same as +toc.section.depth, which controls the depth to +which TOC entries will be generated in a given TOC. +If, for example, generate.section.toc.level +is 3, TOCs will be generated in first, second, and third +level sections, but not in fourth level sections. + + + + + + + +generate.index +boolean + + +generate.index +Do you want an index? + + + +<xsl:param name="generate.index" select="1"></xsl:param> + + +Description + +Specify if an index should be generated. + + + + + + +index.method +string + + +index.method +Select method used to group index entries in an index + + + + +<xsl:param name="index.method" select="'english'"></xsl:param> + + + +Description + +This parameter lets you select which method should be +used to sort and group index entries in an index. +Indexes in languages that have accented characters typically +sort together accented words and unaccented words. +So Á (A acute) would sort together +with A, so both would appear in the A +section of the index. + + +The default indexing method does not sort accented characters this way. +Words that start with an accented character will instead appear in the +Symbols section of the index. +As such, the default method is only suitable for +English and other unaccented languages. +The other indexing methods require extensions of one type or +another, which is why there are not used by default. + +The three choices for indexing method are: + + +english + + +(default) Sort and groups words based only on the Latin alphabet. +Accented words and words in non-Latin alphabets will be +put in the Symbols section of the index. + + + + +kosek + + +Sort and groups words based on letter groups configured in +the DocBook locale file for the given language. +For example, the French locale file is common/fr.xml. +This method requires support for EXSLT extensions in +the XSL processor. It also requires support for using +user-defined functions in xsl:key (xsltproc does not). + +This method is suitable for any language for which you can +list all the individual characters that should appear +in each letter group in an index. +It is probably not practical to use it for ideographic languages +such as Chinese that have hundreds or thousands of characters. + +To use this method, your customization must set this +parameter and import an additional stylesheet module: +<xsl:import href="[path-to-stylesheets]/common/autoidx-ng.xsl"/> +<xsl:param name="index.method">kosek</xsl:param> + + +The stylesheet module defines functions and adds an xsl:key +used by the method. + + + + +kimber + + +This method uses extensions to the Saxon processor to implement +sophisticated indexing processes. It uses its own +configuration file, which can include information for any number of +languages. Each language's configuration can group +words using either an +enumerated method similar to the kosek method, or it can +designate the first character in each group when viewed in sort order. +The latter configuration is useful for ideographic languages +such as Chinese, Japanese, and Korean. +You can also define your own collation algorithms and where you +want Latin-alphabet words sorted. + + +For a whitepaper describing the extensions, see: +. + + + +To download the extension library, see +. + + + + +To use this method, you must: + + + +Use Saxon as your XSLT processor. + + + +Install and configure the Innodata Isogen library, using +the documentation that comes with it. + + + +Set this parameter's value to kimber. + + + +Import the index extensions stylesheet module +common/autoidx-ng.xsl into your +customization. + + + + + + + + + + + + + +index.on.type +boolean + + +index.on.type +Select indexterms based on type +attribute value + + + + +<xsl:param name="index.on.type" select="0"></xsl:param> + + + +Description + + +If non-zero, +then an index element that has a +type attribute +value will contain only those indexterm +elements with a matching type attribute value. +If an index has no type +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + + +If index.on.type is zero, then the +type attribute has no effect +on selecting indexterms for an index. + + +For those using DocBook version 4.2 or earlier, +the type attribute is not available +for index terms. However, you can achieve the same +effect by using the role attribute +in the same manner on indexterm +and index, and setting the stylesheet parameter +index.on.role to a nonzero value. + + + + + + + +index.on.role +boolean + + +index.on.role +Select indexterms based on role value + + + + +<xsl:param name="index.on.role" select="0"></xsl:param> + + + +Description + + +If non-zero, +then an index element that has a +role attribute +value will contain only those indexterm +elements with a matching role value. +If an index has no role +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + +If index.on.role is zero, then the +role attribute has no effect +on selecting indexterms for an index. + + +If you are using DocBook version 4.3 or later, you should +use the type attribute instead of role +on indexterm and index, +and set the index.on.type to a nonzero +value. + + + + + + + +index.prefer.titleabbrev +boolean + + +index.prefer.titleabbrev +Should be abbreviated titles used as back references + + + + +<xsl:param name="index.prefer.titleabbrev" select="0"></xsl:param> + + + +Description + +FIXME: + + + + + + + +index.term.separator +string + + +index.term.separator +Override for punctuation separating an index term +from its list of page references in an index + + + + +<xsl:param name="index.term.separator" select="''"></xsl:param> + + + +Description + +This parameter permits you to override +the text to insert between +the end of an index term and its list of page references. +Typically that might be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'term-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +fill in the content for this normally empty +override parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. +For fo output, it could be an fo:leader +element to provide space of a specific length, or a dot leader. + + + + + + + +index.number.separator +string + + +index.number.separator +Override for punctuation separating page numbers in index + + + + +<xsl:param name="index.number.separator" select="''"></xsl:param> + + + +Description + +This parameter permits you to override the text to insert between +page references in a formatted index entry. Typically +that would be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'number-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. This punctuation appears between +such section titles in an HTML index. + + + + + + + +index.range.separator +string + + +index.range.separator +Override for punctuation separating the two numbers +in a page range in index + + + + +<xsl:param name="index.range.separator" select="''"></xsl:param> + + + +Description + +This parameter permits you +to override the text to insert between +the two numbers of a page range in an index. +This parameter is only used by those XSL-FO processors +that support an extension for generating such page ranges +(such as XEP). + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'range-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. So there are no page ranges +and this parameter has no effect. + + + + + + + +Stylesheet Extensions + + +linenumbering.everyNth +integer + + +linenumbering.everyNth +Indicate which lines should be numbered + + + +<xsl:param name="linenumbering.everyNth" select="'5'"></xsl:param> + + +Description + +If line numbering is enabled, everyNth line will be numbered. + + + + + + + +linenumbering.extension +boolean + + +linenumbering.extension +Enable the line numbering extension + + + +<xsl:param name="linenumbering.extension" select="'1'"></xsl:param> + + +Description + +If true, verbatim environments (elements that have the +format='linespecific' notation attribute: address, literallayout, +programlisting, screen, synopsis) that specify line numbering will +have, surprise, line numbers. + + + + + + + +linenumbering.separator +string + + +linenumbering.separator +Specify a separator between line numbers and lines + + + +<xsl:param name="linenumbering.separator" select="' '"></xsl:param> + + +Description + +The separator is inserted between line numbers and lines in +the verbatim environment. + + + + + + + +linenumbering.width +integer + + +linenumbering.width +Indicates the width of line numbers + + + +<xsl:param name="linenumbering.width" select="'3'"></xsl:param> + + +Description + +If line numbering is enabled, line numbers will appear right +justified in a field "width" characters wide. + + + + + + + +tablecolumns.extension +boolean + + +tablecolumns.extension +Enable the table columns extension function + + + +<xsl:param name="tablecolumns.extension" select="'1'"></xsl:param> + + +Description + +The table columns extension function adjusts the widths of table +columns in the HTML result to more accurately reflect the specifications +in the CALS table. + + + + + + + +textinsert.extension +boolean + + +textinsert.extension +Enable the textinsert extension element + + + +<xsl:param name="textinsert.extension" select="'1'"></xsl:param> + + +Description + +The textinsert extension element inserts the contents of a +a file into the result tree (as text). + + + + + + + +textdata.default.encoding +string + + +textdata.default.encoding +Default encoding of external text files which are included +using textdata element + + + + +<xsl:param name="textdata.default.encoding" select="''"></xsl:param> + + + +Description + +Default encoding of external text files which are included using +textdata element. This value is used only when you do not specify +encoding by appropriate attribute directly on textdata. Default +encoding (empty string) is interpreted as system default +encoding. + + + + + + + +graphicsize.extension +boolean + + +graphicsize.extension +Enable the getWidth()/getDepth() extension functions + + + + +<xsl:param name="graphicsize.extension" select="1"></xsl:param> + + + +Description + +If non-zero (and if use.extensions is non-zero +and if you're using a processor that supports extension functions), the +getWidth and getDepth functions +will be used to extract image sizes from graphics. + + + + + + +graphicsize.use.img.src.path +boolean + + +graphicsize.use.img.src.path +Prepend img.src.path before +filenames passed to extension functions + + + + +<xsl:param name="graphicsize.use.img.src.path" select="0"></xsl:param> + + + +Description + +If non-zero img.src.path parameter will +be appended before filenames passed to extension functions for +measuring image dimensions. + + + + + + +use.extensions +boolean + + +use.extensions +Enable extensions + + + +<xsl:param name="use.extensions" select="'0'"></xsl:param> + + +Description + +If non-zero, extensions may be used. Each extension is +further controlled by its own parameter. But if +use.extensions is zero, no extensions will +be used. + + + + + + + +Automatic labelling + + +chapter.autolabel +boolean + + +chapter.autolabel +Specifies the labeling format for Chapter titles + + + +<xsl:param name="chapter.autolabel" select="1"></xsl:param> + + +Description + +If zero, then chapters will not be numbered. +Otherwise chapters will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + + + + +appendix.autolabel +boolean + + +appendix.autolabel +Specifies the labeling format for Appendix titles + + + + +<xsl:param name="appendix.autolabel" select="'A'"></xsl:param> + + + +Description + +If zero, then appendices will not be numbered. +Otherwise appendices will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperalpha). + + + + + + + +part.autolabel +boolean + + +part.autolabel +Specifies the labeling format for Part titles + + + +<xsl:param name="part.autolabel" select="'I'"></xsl:param> + + +Description + +If zero, then parts will not be numbered. +Otherwise parts will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperroman). + + + + + + + + +preface.autolabel +boolean + + +preface.autolabel +Specifices the labeling format for Preface titles + + + +<xsl:param name="preface.autolabel" select="0"></xsl:param> + + +Description + +If zero (default), then prefaces will not be numbered. +Otherwise prefaces will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + + + + + +qandadiv.autolabel +boolean + + +qandadiv.autolabel +Are divisions in QAndASets enumerated? + + + +<xsl:param name="qandadiv.autolabel" select="1"></xsl:param> + + +Description + +If true (non-zero), unlabeled qandadivs will be enumerated. + + + + + + + +section.autolabel +boolean + + +section.autolabel +Are sections enumerated? + + + +<xsl:param name="section.autolabel" select="0"></xsl:param> + + +Description + +If true (non-zero), unlabeled sections will be enumerated. + + + + + + + +section.autolabel.max.depth +integer + + +section.autolabel.max.depth +The deepest level of sections that are numbered. + + + +<xsl:param name="section.autolabel.max.depth" select="8"></xsl:param> + + +Description + +When section numbering is turned on by the +section.autolabel parameter, +then this parameter controls the depth of section nesting +that is numbered. +Sections nested to a level deeper than this value will +not be numbered. + + + + + + + +section.label.includes.component.label +boolean + + +section.label.includes.component.label +Do section labels include the component label? + + + +<xsl:param name="section.label.includes.component.label" select="0"></xsl:param> + + +Description + +If true (non-zero), section labels are prefixed with the label of the +component that contains them. + + + + + + + +label.from.part +boolean + + +label.from.part +Renumber chapters in each part? + + + +<xsl:param name="label.from.part" select="'0'"></xsl:param> + + +Description + +If label.from.part is non-zero, components +(chapters, appendixes, etc.) +will be numbered from 1 in each part. Otherwise, +they will be numbered monotonically throughout each +book. + + + + + + + +component.label.includes.part.label +boolean + + +component.label.includes.part.label +Do component labels include the part label? + + + +<xsl:param name="component.label.includes.part.label" select="0"></xsl:param> + + +Description + +If true (non-zero), number labels for chapters, appendices, and other component +elements are prefixed with the label of the +part element that contains them. +So you might see Chapter II.3 instead of Chapter 3. +Also, the labels for formal elements such as table and figure will +include the part label. +If there is no part element container, then no prefix is generated. + + +This feature is most useful when the +label.from.part parameter is turned on. +In that case, there would be more than one chapter +1, and the extra part label prefix will identify +each chapter unambiguously. + + + + + + + + + +HTML + + +html.base +uri + + +html.base +An HTML base URI + + + +<xsl:param name="html.base"></xsl:param> + + +Description + +If html.base is set, it is used for the BASE +element in the HEAD of the HTML documents. +This is useful for dynamically served HTML where the base URI needs +to be shifted. + + + + + + +html.stylesheet.type +string + + +html.stylesheet.type +The type of the stylesheet used in the generated HTML + + + +<xsl:param name="html.stylesheet.type">text/css</xsl:param> + + +Description + +The type of the stylesheet to place in the HTML link tag. + + + + + + + +html.stylesheet +string + + +html.stylesheet +Name of the stylesheet(s) to use in the generated HTML + + + + +<xsl:param name="html.stylesheet" select="''"></xsl:param> + + + +Description + +The html.stylesheet parameter is either empty, +indicating that no stylesheet LINK tag should be generated +in the HTML output, or it is a list of one or more stylesheets. + +Multiple stylesheets are space-delimited. If you need to +reference a stylesheet URI that includes a space, encode it with +%20. A seprate HTML LINK element will +be generated for each stylesheet in the order they are listed in the +parameter. + + + + + + +css.decoration +boolean + + +css.decoration +Enable CSS decoration of elements + + + + +<xsl:param name="css.decoration" select="1"></xsl:param> + + + +Description + + +If css.decoration is turned on, then HTML elements +produced by the +stylesheet may be decorated with STYLE attributes. For example, the +LI tags produced for list items may include a fragment of CSS in the +STYLE attribute which sets the CSS property "list-style-type". + + + + + + + +spacing.paras +boolean + + +spacing.paras +Insert additional <p> elements for spacing? + + + +<xsl:param name="spacing.paras" select="'0'"></xsl:param> + + +Description + +When non-zero, additional, empty paragraphs are inserted in +several contexts (for example, around informal figures), to create a +more pleasing visual appearance in many browsers. + + + + + + + +emphasis.propagates.style +boolean + + +emphasis.propagates.style +Pass emphasis role attribute through to HTML? + + + + +<xsl:param name="emphasis.propagates.style" select="1"></xsl:param> + + + +Description + +If true, the role attribute of emphasis elements +will be passed through to the HTML as a class attribute on a +span that surrounds the emphasis. + + + + + + +para.propagates.style +boolean + + +para.propagates.style +Pass para role attribute through to HTML? + + + + +<xsl:param name="para.propagates.style" select="1"></xsl:param> + + + +Description + +If true, the role attribute of para elements +will be passed through to the HTML as a class attribute on the +p generated for the paragraph. + + + + + + +phrase.propagates.style +boolean + + +phrase.propagates.style +Pass phrase role attribute through to HTML? + + + +<xsl:param name="phrase.propagates.style" select="1"></xsl:param> + + +Description + +If true, the role attribute of phrase elements +will be passed through to the HTML as a class attribute on a +span that surrounds the phrase. + + + + + + +entry.propagates.style +boolean + + +entry.propagates.style +Pass entry role attribute through to HTML? + + + + +<xsl:param name="entry.propagates.style" select="1"></xsl:param> + + + +Description + +If true, the role attribute of entry elements +will be passed through to the HTML as a class attribute on the +td or th generated for the table +cell. + + + + + + +html.longdesc +boolean + + +html.longdesc +Should longdesc URIs be created? + + + + +<xsl:param name="html.longdesc" select="1"></xsl:param> + + + +Description + +If non-zero, HTML files will be created for the +longdesc attribute. These files +are created from the textobjects in +mediaobjects and +inlinemediaobject. + + + + + + + +html.longdesc.link +boolean + + +html.longdesc.link +Should a link to the longdesc be included in the HTML? + + + + +<xsl:param name="html.longdesc.link" select="$html.longdesc"></xsl:param> + + + +Description + +If non-zero, links will be created to the +HTML files created for the +longdesc attribute. It makes no +sense to turn enable this option without also enabling the +$html.longdesc parameter. + +The longdesc.link named template is called +to construct the link. + + + + + + +make.valid.html +boolean + + +make.valid.html +Attempt to make sure the HTML output is valid HTML + + + + +<xsl:param name="make.valid.html" select="0"></xsl:param> + + + +Description + +If make.valid.html is true, the stylesheets take +extra effort to ensure that the resulting HTML is valid. This may mean that some +para tags are translated into HTML divs or +that other substitutions occur. + +This parameter is different from html.cleanup +because it changes the resulting markup; it does not use extension functions +to manipulate result-tree-fragments and is therefore applicable to any +XSLT processor. + + + + + + +html.cleanup +boolean + + +html.cleanup +Attempt to clean up the resulting HTML? + + + + +<xsl:param name="html.cleanup" select="1"></xsl:param> + + + +Description + +If non-zero, and if the EXSLT +extensions are supported by your processor, the resulting HTML will be +cleaned up. This improves the chances that the +resulting HTML will be valid. It may also improve the formatting of +some elements. + +This parameter is different from make.valid.html +because it uses extension functions to manipulate result-tree-fragments. + + + + + + +draft.mode +list + + +draft.mode +Select draft mode + + + + +<xsl:param name="draft.mode" select="'maybe'"></xsl:param> + + + +Description + +Selects draft mode. If draft.mode is +yes, the entire document will be treated +as a draft. If it is no, the entire document +will be treated as a final copy. If it is maybe, +individual sections will be treated as draft or final independently, depending +on how their status attribute is set. + + + + + + + +draft.watermark.image +uri + + +draft.watermark.image +The URI of the image to be used for draft watermarks + + + + +<xsl:param name="draft.watermark.image" select="'http://docbook.sourceforge.net/release/images/draft.png'"></xsl:param> + + + +Description + +The image to be used for draft watermarks. + + + + + + +generate.id.attributes + + + +generate.id.attributes + + + + + +<xsl:param name="generate.id.attributes" select="0"></xsl:param> + + + +Description + +If non-zero, the HTML stylesheet will generate ID attributes on +containers. For example, the markup: + +<section id="foo"><title>Some Title</title> +<para>Some para.</para> +</section> + +might produce: + +<div class="section" id="foo"> +<h2>Some Title</h2> +<p>Some para.</p> +</div> + +The alternative is to generate anchors: + +<div class="section"> +<h2><a name="foo"></a>Some Title</h2> +<p>Some para.</p> +</div> + +Because the name attribute of +the a element and the id +attribute of other tags are both of type ID, producing both +generates invalid documents. + +As of version 1.50, you can use this switch to control which type of +identifier is generated. For backwards-compatibility, generating +a anchors is preferred. + +Note: at present, this switch is incompletely implemented. +Disabling ID attributes will suppress them, but enabling ID attributes +will not suppress the anchors. + + + + + + +generate.meta.abstract +boolean + + +generate.meta.abstract +Generate HTML META element from abstract? + + + + +<xsl:param name="generate.meta.abstract" select="1"></xsl:param> + + + +Description + +If non-zero, document abstracts will be reproduced in the HTML +HEAD with meta name="description" content="...". + + + + + + +XSLT Processing + + +rootid +string + + +rootid +Specify the root element to format + + + +<xsl:param name="rootid" select="''"></xsl:param> + + +Description + +If rootid is specified, it must be the +value of an ID that occurs in the document being formatted. The entire +document will be loaded and parsed, but formatting will begin at the +element identified, rather than at the root. For example, this allows +you to process only chapter 4 of a book. +Because the entire document is available to the processor, automatic +numbering, cross references, and other dependencies are correctly +resolved. + + + + + + +suppress.navigation +boolean + + +suppress.navigation +Disable header and footer navigation + + + +<xsl:param name="suppress.navigation">0</xsl:param> + + +Description + + +If suppress.navigation is turned on, header and +footer navigation will be suppressed. + + + + + + +suppress.header.navigation +boolean + + +suppress.header.navigation +Disable header navigation + + + +<xsl:param name="suppress.header.navigation">0</xsl:param> + + +Description + + +If suppress.header.navigation is turned on, header +navigation will be suppressed. + + + + + + +suppress.footer.navigation +boolean + + +suppress.footer.navigation +Disable footer navigation + + + +<xsl:param name="suppress.footer.navigation">0</xsl:param> + + +Description + + +If suppress.footer.navigation is turned on, footer +navigation will be suppressed. + + + + + + +header.rule +boolean + + +header.rule +Rule under headers? + + + + +<xsl:param name="header.rule" select="1"></xsl:param> + + + +Description + +If non-zero, a rule will be drawn below the page headers. + + + + + + +footer.rule +boolean + + +footer.rule +Rule over footers? + + + + +<xsl:param name="footer.rule" select="1"></xsl:param> + + + +Description + +If non-zero, a rule will be drawn above the page footers. + + + + + + +id.warnings +boolean + + +id.warnings +Should warnings be generated for titled elements without IDs? + + + + +<xsl:param name="id.warnings" select="1"></xsl:param> + + + +Description + +If non-zero, the stylesheet will issue a warning for +any element (other than the root element) which +has a title but does not have an ID. + + + + + + +Meta/*Info + + +inherit.keywords +boolean + + +inherit.keywords +Inherit keywords from ancestor elements? + + + +<xsl:param name="inherit.keywords" select="'1'"></xsl:param> + + +Description + +If inherit.keywords +is non-zero, the keyword META for each HTML +HEAD element will include all of the keywords from +ancestral elements. Otherwise, only the keywords from the current section +will be used. + + + + + + + +make.single.year.ranges +boolean + + +make.single.year.ranges +Print single-year ranges (e.g., 1998-1999) + + + +<xsl:param name="make.single.year.ranges" select="0"></xsl:param> + + +Description + +If non-zero, year ranges that span a single year will be printed +in range notation (1998-1999) instead of discrete notation +(1998, 1999). + + + + + + +make.year.ranges +boolean + + +make.year.ranges +Collate copyright years into ranges? + + + +<xsl:param name="make.year.ranges" select="0"></xsl:param> + + +Description + +If non-zero, copyright years will be collated into ranges. + + + + + + +author.othername.in.middle +boolean + + +author.othername.in.middle +Is othername in author a +middle name? + + + +<xsl:param name="author.othername.in.middle" select="1"></xsl:param> + + +Description + +If true (non-zero), the othername of an author +appears between the firstname and +surname. Otherwise, othername +is suppressed. + + + + + + + +generate.legalnotice.link +boolean + + +generate.legalnotice.link +Write legalnotice to separate chunk and generate link? + + + +<xsl:param name="generate.legalnotice.link" select="0"></xsl:param> + + +Description + +If the value of generate.legalnotice.link +is non-zero, the stylesheet: + + + + writes the contents of legalnotice to a separate + HTML file + + + inserts a hyperlink to the legalnotice file + + + adds (in the HTML head) either a single + link or element or multiple + link elements (depending on the value of the + html.head.legalnotice.link.multiple + parameter), with the value or values derived from the + html.head.legalnotice.link.types + parameter + + + + Otherwise, if generate.legalnotice.link is + zero, legalnotice contents are rendered on the title + page. + + + + + + +generate.revhistory.link +boolean + + +generate.revhistory.link +Write revhistory to separate chunk and generate link? + + + +<xsl:param name="generate.revhistory.link" select="0"></xsl:param> + + +Description + +If non-zero, the contents of revhistory are written +to a separate HTML file and a link to the file is +generated. Otherwise, revhistory contents are rendered on +the title page. + + + + + + +html.head.legalnotice.link.types +string + + +html.head.legalnotice.link.types +Specifies link types for legalnotice link in html head + + + + +<xsl:param name="html.head.legalnotice.link.types">copyright</xsl:param> + + + +Description + +The value of +html.head.legalnotice.link.types is a +space-separated list of link types, as described in Section 6.12 +of the HTML 4.01 specification. If the value of the +generate.legalnotice.link parameter is +non-zero, then the stylesheet generates (in the +head section of the HTML source) either a single +HTML link element or, if the value of the +html.head.legalnotice.link.multiple is +non-zero, one link element for each link type +specified. Each link has the following attributes: + + + + a rel attribute whose + value is derived from the value of + html.head.legalnotice.link.types + + + an href attribute whose + value is set to the URL of the file containing the + legalnotice + + + a title attribute whose + value is set to the title of the corresponding + legalnotice (or a title programatically + determined by the stylesheet) + + + +For example: + + <link rel="license" href="ln-id2524073.html" title="Legal Notice"> + + + + About the default value + In an ideal world, the default value of + html.head.legalnotice.link.types would + probably be “license”, since the content of the + DocBook legalnotice is typically license + information, not copyright information. However, the default value + is “copyright” for pragmatic reasons: because + that’s among the set of “recognized link types” listed in Section + 6.12 of the HTML 4.01 specification, and because certain + browsers and browser extensions are preconfigured to recognize that + value. + + + + + + + +html.head.legalnotice.link.multiple +boolean + + +html.head.legalnotice.link.multiple +Generate multiple link instances in html head for legalnotice? + + + +<xsl:param name="html.head.legalnotice.link.multiple" select="1"></xsl:param> + + +Description + +If html.head.legalnotice.link.multiple is +non-zero and the value of +html.head.legalnotice.link.types contains +multiple link types, then the stylesheet generates (in the +head section of the HTML source) one +link element for each link type specified. For +example, if the value of +html.head.legalnotice.link.types is +“copyright license”: + + <link rel="copyright" href="ln-id2524073.html" title="Legal Notice"> + <link rel="license" href="ln-id2524073.html" title="Legal Notice"> + + Otherwise, the stylesheet generates generates a single + link instance; for example: + + <link rel="copyright license" href="ln-id2524073.html" title="Legal Notice"> + + + + + + + +Reference Pages + + +funcsynopsis.decoration +boolean + + +funcsynopsis.decoration +Decorate elements of a FuncSynopsis? + + + +<xsl:param name="funcsynopsis.decoration" select="1"></xsl:param> + + +Description + +If true (non-zero), elements of the FuncSynopsis will be decorated (e.g. bold or +italic). The decoration is controlled by functions that can be redefined +in a customization layer. + + + + + + + +funcsynopsis.style +list +ansi +kr + + +funcsynopsis.style +What style of 'FuncSynopsis' should be generated? + + + +<xsl:param name="funcsynopsis.style">kr</xsl:param> + + +Description + +If funcsynopsis.style is ansi, +ANSI-style function synopses are generated for a +funcsynopsis, otherwise K&R-style +function synopses are generated. + + + + + + + +funcsynopsis.tabular.threshold +integer + + +funcsynopsis.tabular.threshold +Width beyond which a tabular presentation will be used + + + + +<xsl:param name="funcsynopsis.tabular.threshold" select="40"></xsl:param> + + + +Description + +If funcsynopsis.tabular.threshold is greater than +zero then if a funcprototype is wider than the threshold +value, it will be presented in a table. + + + + + + +function.parens +boolean + + +function.parens +Generate parens after a function? + + + +<xsl:param name="function.parens">0</xsl:param> + + +Description + +If not 0, the formatting of +a function element will include +generated parenthesis. + + + + + + + +refentry.generate.name +boolean + + +refentry.generate.name +Output NAME header before 'RefName'(s)? + + + +<xsl:param name="refentry.generate.name" select="1"></xsl:param> + + +Description + +If true (non-zero), a "NAME" section title is output before the list +of 'RefName's. This parameter and +refentry.generate.title are mutually +exclusive. This means that if you change this parameter to zero, you +should set refentry.generate.title to 1 unless +you want get quite strange output. + + + + + + + +refentry.generate.title +boolean + + +refentry.generate.title +Output title before 'RefName'(s)? + + + + +<xsl:param name="refentry.generate.title" select="0"></xsl:param> + + + +Description + +If true (non-zero), the reference page title or first name is +output before the list of 'RefName's. This parameter and +refentry.generate.name are mutually exclusive. +This means that if you change this parameter to 1, you +should set refentry.generate.name to 0 unless +you want get quite strange output. + + + + + + + +refentry.xref.manvolnum +boolean + + +refentry.xref.manvolnum +Output manvolnum as part of +refentry cross-reference? + + + +<xsl:param name="refentry.xref.manvolnum" select="1"></xsl:param> + + +Description + +if true (non-zero), the manvolnum is used when cross-referencing +refentrys, either with xref +or citerefentry. + + + + + + + +citerefentry.link +boolean + + +citerefentry.link +Generate URL links when cross-referencing RefEntrys? + + + +<xsl:param name="citerefentry.link" select="'0'"></xsl:param> + + +Description + +If true, a web link will be generated, presumably +to an online man->HTML gateway. The text of the link is +generated by the generate.citerefentry.link template. + + + + + + + +refentry.separator +boolean + + +refentry.separator +Generate a separator between consecutive RefEntry elements? + + + +<xsl:param name="refentry.separator" select="'1'"></xsl:param> + + +Description + +If true, a separator will be generated between consecutive +reference pages. + + + + + + + +refclass.suppress +boolean + + +refclass.suppress +Suppress display of refclass contents? + + + + +<xsl:param name="refclass.suppress" select="0"></xsl:param> + + +Description + +If the value of refclass.suppress is +non-zero, then display of refclass contents is +suppressed in output. + + + + + + +Tables + + +default.table.width +length + + +default.table.width +The default width of tables + + + +<xsl:param name="default.table.width" select="''"></xsl:param> + + +Description + +If specified, this value will be used for the WIDTH attribute on +tables that do not specify an alternate width (with the dbhtml processing +instruction). + + + + + + +nominal.table.width +length + + +nominal.table.width +The (absolute) nominal width of tables + + + +<xsl:param name="nominal.table.width" select="'6in'"></xsl:param> + + +Description + +In order to convert CALS column widths into HTML column widths, it +is sometimes necessary to have an absolute table width to use for conversion +of mixed absolute and relative widths. This value must be an absolute +length (not a percentag). + + + + + + +table.borders.with.css +boolean + + +table.borders.with.css +Use CSS to specify table, row, and cell borders? + + + + +<xsl:param name="table.borders.with.css" select="0"></xsl:param> + + + +Description + +If true (non-zero), CSS will be used to draw table borders. + + + + + + + +table.cell.border.style + + + +table.cell.border.style + + + + + +<xsl:param name="table.cell.border.style" select="'solid'"></xsl:param> + + + +Description + +FIXME: + + + + + + +table.cell.border.thickness + + + +table.cell.border.thickness + + + + + +<xsl:param name="table.cell.border.thickness" select="'0.5pt'"></xsl:param> + + + +Description + +FIXME: + + + + + + +table.cell.border.color + + + +table.cell.border.color + + + + + +<xsl:param name="table.cell.border.color" select="''"></xsl:param> + + + + +Description + +FIXME: + + + + + + +table.frame.border.style + + + +table.frame.border.style + + + + + +<xsl:param name="table.frame.border.style" select="'solid'"></xsl:param> + + + +Description + +FIXME: + + + + + + +table.frame.border.thickness + + + +table.frame.border.thickness +Specifies the thickness of the frame border + + + + +<xsl:param name="table.frame.border.thickness" select="'0.5pt'"></xsl:param> + + + +Description + +Specifies the thickness of the border on the table's frame. + + + + + + +table.frame.border.color + + + +table.frame.border.color + + + + + +<xsl:param name="table.frame.border.color" select="''"></xsl:param> + + + + +Description + +FIXME: + + + + + + +default.table.frame +string + + +default.table.frame +The default framing of tables + + + +<xsl:param name="default.table.frame" select="'all'"></xsl:param> + + +Description + +This value will be used when there is no frame attribute on the table. + + + + + + +html.cellspacing +integer + + +html.cellspacing +Default value for cellspacing in HTML tables + + + + +<xsl:param name="html.cellspacing" select="''"></xsl:param> + + + +Description + +If specified, this value will be used as the default cellspacing value +in HTML tables. + + + + + + +html.cellpadding +integer + + +html.cellpadding +Default value for cellpadding in HTML tables + + + + +<xsl:param name="html.cellpadding" select="''"></xsl:param> + + + +Description + +If specified, this value will be used as the default cellpadding value +in HTML tables. + + + + + + +QAndASet + + +qanda.defaultlabel +boolean + + +qanda.defaultlabel +Sets the default for defaultlabel on QandASet. + + + +<xsl:param name="qanda.defaultlabel">number</xsl:param> + + +Description + +If no defaultlabel attribute is specified on a QandASet, this +value is used. It must be one of the legal values for the defaultlabel +attribute. + + + + + + + +qanda.inherit.numeration +boolean + + +qanda.inherit.numeration +Does enumeration of QandASet components inherit the numeration of parent elements? + + + +<xsl:param name="qanda.inherit.numeration" select="1"></xsl:param> + + +Description + +If true (non-zero), numbered QandADiv elements and Questions and Answers inherit +the numeration of the ancestors of the QandASet. + + + + + + + +Linking + + +target.database.document +uri + + +target.database.document +Name of master database file for resolving +olinks + + +<xsl:param name="target.database.document" select="''"></xsl:param> + + + +Description + +To resolve olinks between documents, the stylesheets use +a master database document that identifies the target datafiles for all the documents within the scope +of the olinks. This parameter value is the URI of +the master document to be read during processing to resolve olinks. +The default value is olinkdb.xml. +The data structure of the file is defined in the targetdatabase.dtd DTD. The database file provides the high level elements to record the identifiers, locations, and relationships of documents. The cross reference data for individual documents is generally pulled into the database using system entity references or XIncludes. See also targets.filename. + + + + + + + +targets.filename +string + + +targets.filename +Name of cross reference targets data file + + +<xsl:param name="targets.filename" select="'target.db'"></xsl:param> + + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter lets you change the name of the generated +file from the default name target.db. +The name must agree with that used in the target database +used to resolve olinks during processing. +See also target.database.document. + + + + + + +olink.base.uri +uri + + +olink.base.uri +Base URI used in olink hrefs + + +<xsl:param name="olink.base.uri" select="''"></xsl:param> + + +Description +When cross reference data is collected for resolving olinks, it may be necessary to prepend a base URI to each target's href. This parameter lets you set that base URI when cross reference data is collected. This feature is needed when you want to link to a document that is processed without chunking. The output filename for such a document is not known to the XSL stylesheet; the only target information consists of fragment identifiers such as #idref. To enable the resolution of olinks between documents, you should pass the name of the HTML output file as the value of this parameter. Then the hrefs recorded in the cross reference data collection look like outfile.html#idref, which can be reached as links from other documents. + + + + + +use.local.olink.style +boolean + + +use.local.olink.style +Process olinks using xref style of current +document + + +<xsl:param name="use.local.olink.style" select="0"></xsl:param> + + +Description +When cross reference data is collected for use by olinks, the data for each potential target includes one field containing a completely assembled cross reference string, as if it were an xref generated in that document. Other fields record the separate title, number, and element name of each target. When an olink is formed to a target from another document, the olink resolves to that preassembled string by default. If the use.local.olink.style parameter is set to non-zero, then instead the cross +reference string is formed again from the target title, number, and +element name, using the stylesheet processing the targeting document. +Then olinks will match the xref style in the targeting document +rather than in the target document. If both documents are processed +with the same stylesheet, then the results will be the same. + + + + + +current.docid +string + + +current.docid +targetdoc identifier for the document being +processed + + +<xsl:param name="current.docid" select="''"></xsl:param> + + +Description +When olinks between documents are resolved for HTML output, the stylesheet can compute the relative path between the current document and the target document. The stylesheet needs to know the targetdoc identifiers for both documents, as they appear in the target.database.document database file. This parameter passes to the stylesheet +the targetdoc identifier of the current document, since that +identifier does not appear in the document itself. +This parameter can also be used for print output. If an olink's targetdoc id differs from the current.docid, then the stylesheet can append the target document's title to the generated olink text. That identifies to the reader that the link is to a different document, not the current document. See also olink.doctitle to enable that feature. + + + + + +olink.doctitle +string + + +olink.doctitle +show the document title for external olinks? + + + +<xsl:param name="olink.doctitle" select="'no'"></xsl:param> + + +Description +When olinks between documents are resolved, the generated text +may not make it clear that the reference is to another document. +It is possible for the stylesheets to append the other document's +title to external olinks. For this to happen, two parameters must +be set. + + +This olink.doctitle parameter +should be set to either yes or maybe +to enable this feature. + + + +And you should also set the current.docid +parameter to the document id for the document currently +being processed for output. + + + + + +Then if an olink's targetdoc id differs from +the current.docid value, the stylesheet knows +that it is a reference to another document and can +append the target document's +title to the generated olink text. + +The text for the target document's title is copied from the +olink database from the ttl element +of the top-level div for that document. +If that ttl element is missing or empty, +no title is output. + + +The supported values for olink.doctitle are: + + + +yes + + +Always insert the title to the target document if it is not +the current document. + + + + +no + + +Never insert the title to the target document, even if requested +in an xrefstyle attribute. + + + + +maybe + + +Only insert the title to the target document, if requested +in an xrefstyle attribute. + + + + +An xrefstyle attribute +may override the global setting for individual olinks. +The following values are supported in an +xrefstyle +attribute using the select: syntax: + + + + +docname + + +Insert the target document name for this olink using the +docname gentext template, but only +if the value of olink.doctitle +is not no. + + + + +docnamelong + + +Insert the target document name for this olink using the +docnamelong gentext template, but only +if the value of olink.doctitle +is not no. + + + + +nodocname + + +Omit the target document name even if +the value of olink.doctitle +is yes. + + + + +Another way of inserting the target document name +for a single olink is to employ an +xrefstyle +attribute using the template: syntax. +The %o placeholder (the letter o, not zero) +in such a template +will be filled in with the target document's title when it is processed. +This will occur regardless of +the value of olink.doctitle. + +Note that prior to version 1.66 of the XSL stylesheets, +the allowed values for this parameter were 0 and 1. Those +values are still supported and mapped to 'no' and 'yes', respectively. + + + + + + +olink.debug +boolean + + +olink.debug +Turn on debugging messages for olinks + + + + +<xsl:param name="olink.debug" select="0"></xsl:param> + + + +Description + +If non-zero, then each olink will generate several +messages about how it is being resolved during processing. +This is useful when an olink does not resolve properly +and the standard error messages are not sufficient to +find the problem. + + +You may need to read through the olink XSL templates +to understand the context for some of the debug messages. + + + + + + + +olink.properties +Properties associated with the cross-reference +text of an olink. + + + + +<xsl:attribute-set name="olink.properties"> +</xsl:attribute-set> + + + +Description + +This attribute set is used on cross reference text +from an olink. It is not applied to the +optional page number or +optional title of the external document. + + + + + + +olink.lang.fallback.sequence +string + + +olink.lang.fallback.sequence +look up translated documents if olink not found? + + + +<xsl:param name="olink.lang.fallback.sequence" select="''"></xsl:param> + + +Description + +This parameter defines a list of lang values +to search among to resolve olinks. + + +Normally an olink tries to resolve to a document in the same +language as the olink itself. The language of an olink +is determined by its nearest ancestor element with a +lang attribute, otherwise the +value of the l10n.gentext.default.lang +parameter. + + +An olink database can contain target data for the same +document in multiple languages. Each set of data has the +same value for the targetdoc attribute in +the document element in the database, but with a +different lang attribute value. + + +When an olink is being resolved, the target is first +sought in the document with the same language as the olink. +If no match is found there, then this parameter is consulted +for additional languages to try. + +The olink.lang.fallback.sequence +must be a whitespace separated list of lang values to +try. The first one with a match in the olink database is used. +The default value is empty. + +For example, a document might be written in German +and contain an olink with +targetdoc="adminguide". +When the document is processed, the processor +first looks for a target dataset in the +olink database starting with: + +<document targetdoc="adminguide" lang="de">. + + +If there is no such element, then the +olink.lang.fallback.sequence +parameter is consulted. +If its value is, for example, fr en, then the processor next +looks for targetdoc="adminguide" lang="fr", and +then for targetdoc="adminguide" lang="en". +If there is still no match, it looks for +targetdoc="adminguide" with no +lang attribute. + + +This parameter is useful when a set of documents is only +partially translated, or is in the process of being translated. +If a target of an olink has not yet been translated, then this +parameter permits the processor to look for the document in +other languages. This assumes the reader would rather have +a link to a document in a different language than to have +a broken link. + + + + + + + +insert.olink.page.number +string + + +insert.olink.page.number +Turns page numbers in olinks on and off + + + + +<xsl:param name="insert.olink.page.number">no</xsl:param> + + + +Description + +The value of this parameter determines if +cross references made between documents with +olink will +include page number citations. +In most cases this is only applicable to references in printed output. + +The parameter has three possible values. + + + +no +No page number references will be generated for olinks. + + + +yes +Page number references will be generated +for all olink references. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an olink element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + +Olinks that point to targets within the same document +are treated as xrefs, and controlled by +the insert.xref.page.number parameter. + + +Page number references for olinks to +external documents can only be inserted if the +information exists in the olink database. +This means each olink target element +(div or obj) +must have a page attribute +whose value is its page number in the target document. +The XSL stylesheets are not able to extract that information +during processing because pages have not yet been created in +XSLT transformation. Only the XSL-FO processor knows what +page each element is placed on. +Therefore some postprocessing must take place to populate +page numbers in the olink database. + + + + + + + + + +insert.olink.pdf.frag +boolean + + +insert.olink.pdf.frag +Add fragment identifiers for links into PDF files + + + + +<xsl:param name="insert.olink.pdf.frag" select="0"></xsl:param> + + + +Description + +The value of this parameter determines whether +the cross reference URIs to PDF documents made with +olink will +include fragment identifiers. + + +When forming a URI to link to a PDF document, +a fragment identifier (typically a '#' followed by an +id value) appended to the PDF filename can be used by +the PDF viewer to open +the PDF file to a location within the document instead of +the first page. +However, not all PDF files have id +values embedded in them, and not all PDF viewers can +handle fragment identifiers. + + +If insert.olink.pdf.frag is set +to a non-zero value, then any olink targeting a +PDF file will have the fragment identifier appended to the URI. +The URI is formed by concatenating the value of the +olink.base.uri parameter, the +value of the baseuri +attribute from the document +element in the olink database with the matching +targetdoc value, +and the value of the href +attribute for the targeted element in the olink database. +The href attribute +contains the fragment identifier. + + +If insert.olink.pdf.frag is set +to zero (the default value), then +the href attribute +from the olink database +is not appended to PDF olinks, so the fragment identifier is left off. +A PDF olink is any olink for which the +baseuri attribute +from the matching document +element in the olink database ends with '.pdf'. +Any other olinks will still have the fragment identifier added. + + + + + + +prefer.internal.olink +boolean + + +prefer.internal.olink +Prefer a local olink reference to an external reference + + + + +<xsl:param name="prefer.internal.olink" select="0"></xsl:param> + + + +Description + +If you are re-using XML content modules in multiple documents, +you may want to redirect some of your olinks. This parameter +permits you to redirect an olink to the current document. + + +For example: you are writing documentation for a product, +which includes 3 manuals: a little installation +booklet (booklet.xml), a user +guide (user.xml), and a reference manual (reference.xml). +All 3 documents begin with the same introduction section (intro.xml) that +contains a reference to the customization section (custom.xml) which is +included in both user.xml and reference.xml documents. + + +How do you write the link to custom.xml in intro.xml +so that it is interpreted correctly in all 3 documents? + +If you use xref, it will fail in user.xml. + +If you use olink (pointing to reference.xml), +the reference in user.xml +will point to the customization section of the reference manual, while it is +actually available in user.xml. + + + +If you set the prefer.internal.olink +parameter to a non-zero value, then the processor will +first look in the olink database +for the olink's targetptr attribute value +in document matching the current.docid +parameter value. If it isn't found there, then +it tries the document in the database +with the targetdoc +value that matches the olink's targetdoc +attribute. + + +This feature permits an olink reference to resolve to +the current document if there is an element +with an id matching the olink's targetptr +value. The current document's olink data must be +included in the target database for this to work. + + +There is a potential for incorrect links if +the same id attribute value is used for different +content in different documents. +Some of your olinks may be redirected to the current document +when they shouldn't be. It is not possible to control +individual olink instances. + + + + + + + +link.mailto.url +string + + +link.mailto.url +Mailto URL for the LINK REL=made HTML HEAD element + + + +<xsl:param name="link.mailto.url"></xsl:param> + + +Description + +If not the empty string, this address will be used for the +REL=made LINK element in the HTML HEAD. + + + + + + + +ulink.target +string + + +ulink.target +The HTML anchor target for ULinks + + + +<xsl:param name="ulink.target" select="'_top'"></xsl:param> + + +Description + +If ulink.target is set, its value will +be used for the target attribute +on anchors generated for ulinks. + + + + + + +olink.fragid +string + + +olink.fragid +Names the fragment identifier portion of an OLink resolver query + + + +<xsl:param name="olink.fragid" select="'fragid='"></xsl:param> + + +Description + +FIXME: + + + + + + +olink.outline.ext +string + + +olink.outline.ext +The extension of OLink outline files + + + +<xsl:param name="olink.outline.ext" select="'.olink'"></xsl:param> + + +Description + +FIXME: + + + + + + +olink.pubid +string + + +olink.pubid +Names the public identifier portion of an OLink resolver query + + + +<xsl:param name="olink.pubid" select="'pubid='"></xsl:param> + + +Description + +FIXME: + + + + + + +olink.sysid +string + + +olink.sysid +Names the system identifier portion of an OLink resolver query + + + +<xsl:param name="olink.sysid" select="'sysid='"></xsl:param> + + +Description + +FIXME: + + + + + + +olink.resolver + + + +olink.resolver +The root name of the OLink resolver (usually a script) + + + +<xsl:param name="olink.resolver" select="'/cgi-bin/olink'"></xsl:param> + + +Description + +FIXME: + + + + + + +Cross References + + +collect.xref.targets +string + + +collect.xref.targets +Controls whether cross reference data is +collected + + +<xsl:param name="collect.xref.targets" select="'no'"></xsl:param> + + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter determines whether the collection process is run when the document is processed by the stylesheet. The default value is no, which means the data file is not generated during processing. The other choices are yes, which means the data file is created and the document is processed for output, and only, which means the data file is created but the document is not processed for output. +See also targets.filename. + + + + + + +insert.xref.page.number +string + + +insert.xref.page.number +Turns page numbers in xrefs on and off + + + + +<xsl:param name="insert.xref.page.number">no</xsl:param> + + + +Description + +The value of this parameter determines if +cross references (xrefs) in +printed output will +include page number citations. +It has three possible values. + + + +no +No page number references will be generated. + + + +yes +Page number references will be generated +for all xref elements. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an xref element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + + + + + + + +use.role.as.xrefstyle +boolean + + +use.role.as.xrefstyle +Use role attribute for +xrefstyle on xref? + + + + +<xsl:param name="use.role.as.xrefstyle" select="1"></xsl:param> + + + +Description + +If non-zero, the role attribute on +xref will be used to select the cross reference style. +The DocBook +Technical Committee recently added an +xrefstyle attribute for this purpose. +If the xrefstyle attribute +is present, role will be ignored, regardless +of this setting. + +Until an official DocBook release that includes the new +attribute, this flag allows role +to serve that purpose. + + + +Example + +The following small stylesheet shows how to configure the stylesheets to make +use of the cross reference style: + +<?xml version="1.0"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<xsl:import href="../xsl/html/docbook.xsl"/> + +<xsl:output method="html"/> + +<xsl:param name="local.l10n.xml" select="document('')"/> +<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"> + <l:l10n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" language="en"> + <l:context name="xref"> + <l:template name="chapter" style="title" text="Chapter %n, %t"/> + <l:template name="chapter" text="Chapter %n"/> + </l:context> + </l:l10n> +</l:i18n> + +</xsl:stylesheet> + +With this stylesheet, the cross references in the following document: + +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> +<book id="book"><title>Book</title> + +<preface> +<title>Preface</title> + +<para>Normal: <xref linkend="ch1"/>.</para> +<para>Title: <xref xrefstyle="title" linkend="ch1"/>.</para> + +</preface> + +<chapter id="ch1"> +<title>First Chapter</title> + +<para>Irrelevant.</para> + +</chapter> +</book> + +will appear as: + + +Normal: Chapter 1. +Title: Chapter 1, First Chapter. + + + + + + + +xref.with.number.and.title +boolean + + +xref.with.number.and.title +Use number and title in cross references + + + + +<xsl:param name="xref.with.number.and.title" select="1"></xsl:param> + + + +Description + +FIXME: + + + + + + +xref.label-page.separator +string + + +xref.label-page.separator +Punctuation or space separating label from page number in xref + + + +<xsl:param name="xref.label-page.separator"><xsl:text> </xsl:text></xsl:param> + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and page +but no title, +then the value of this parameter is inserted between +label and page number in the output. +If a title is included, then other separators are used. + + + + + + + +xref.label-title.separator +string + + +xref.label-title.separator +Punctuation or space separating label from title in xref + + + +<xsl:param name="xref.label-title.separator">: </xsl:param> + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and title, +then the value of this parameter is inserted between +label and title in the output. + + + + + + + +xref.title-page.separator +string + + +xref.title-page.separator +Punctuation or space separating title from page number in xref + + + +<xsl:param name="xref.title-page.separator"><xsl:text> </xsl:text></xsl:param> + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both title and page number, +then the value of this parameter is inserted between +title and page number in the output. + + + + + + + +Lists + + +segmentedlist.as.table +boolean + + +segmentedlist.as.table +Format segmented lists as tables? + + + + +<xsl:param name="segmentedlist.as.table" select="0"></xsl:param> + + + +Description + +If non-zero, segmentedlists will be formatted as +tables. + + + + + + +variablelist.as.table +boolean + + +variablelist.as.table +Format variablelists as tables? + + + + +<xsl:param name="variablelist.as.table" select="0"></xsl:param> + + + +Description + +If non-zero, variablelists will be formatted as +tables. A processing instruction exists to specify a particualar width for the +column containing the terms: +dbhtml term-width=".25in" + +You can override this setting with a processing instruction as the +child of variablelist: dbhtml +list-presentation="table" or dbhtml +list-presentation="list". + +This parameter only applys to the HTML transformations. In the +FO case, proper list markup is robust enough to handle the formatting. +But see also variablelist.as.blocks. + + <variablelist> + <?dbhtml list-presentation="table"?> + <?dbhtml term-width="1.5in"?> + <?dbfo list-presentation="list"?> + <?dbfo term-width="1in"?> + <varlistentry> + <term>list</term> + <listitem> + <para> + Formatted as a table even if variablelist.as.table is set to 0. + </para> + </listitem> + </varlistentry> + </variablelist> + + + + + + +variablelist.term.separator +string + + +variablelist.term.separator +Text to separate terms within a multi-term +varlistentry + + + + +<xsl:param name="variablelist.term.separator">, </xsl:param> + + +Description + +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is placed +after each term except the last. + + + To generate a line break between multiple terms in + a varlistentry, set a non-zero value for the + variablelist.term.break.after parameter. If + you do so, you may also want to set the value of the + variablelist.term.separator parameter to an + empty string (to suppress rendering of the default comma and space + after each term). + + + + + + + +variablelist.term.break.after +boolean + + +variablelist.term.break.after +Generate line break after each term within a +multi-term varlistentry? + + + + +<xsl:param name="variablelist.term.break.after">0</xsl:param> + + +Description + +Set a non-zero value for the +variablelist.term.break.after parameter to +generate a line break between terms in a +multi-term varlistentry. + + +If you set a non-zero value for +variablelist.term.break.after, you may also +want to set the value of the +variablelist.term.separator parameter to an +empty string (to suppress rendering of the default comma and space +after each term). + + + + + + + +Bibliography + + +biblioentry.item.separator +string + + +biblioentry.item.separator +Text to separate bibliography entries + + + +<xsl:param name="biblioentry.item.separator">. </xsl:param> + + +Description + +Text to separate bibliography entries + + + + + + + +bibliography.collection +string + + +bibliography.collection +Name of the bibliography collection file + + + +<xsl:param name="bibliography.collection" select="'http://docbook.sourceforge.net/release/bibliography/bibliography.xml'"></xsl:param> + + +Description + +Maintaining bibliography entries across a set of documents is tedious, time +consuming, and error prone. It makes much more sense, usually, to store all of +the bibliography entries in a single place and simply extract +the ones you need in each document. + +That's the purpose of the +bibliography.collection parameter. To setup a global +bibliography database, follow these steps: + +First, create a stand-alone bibliography document that contains all of +the documents that you wish to reference. Make sure that each bibliography +entry (whether you use biblioentry or bibliomixed) +has an ID. + +My global bibliography, ~/bibliography.xml begins +like this: + + +<!DOCTYPE bibliography + PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<bibliography><title>References</title> + +<bibliomixed id="xml-rec"><abbrev>XML 1.0</abbrev>Tim Bray, +Jean Paoli, C. M. Sperberg-McQueen, and Eve Maler, editors. +<citetitle><ulink url="http://www.w3.org/TR/REC-xml">Extensible Markup +Language (XML) 1.0 Second Edition</ulink></citetitle>. +World Wide Web Consortium, 2000. +</bibliomixed> + +<bibliomixed id="xml-names"><abbrev>Namespaces</abbrev>Tim Bray, +Dave Hollander, +and Andrew Layman, editors. +<citetitle><ulink url="http://www.w3.org/TR/REC-xml-names/">Namespaces in +XML</ulink></citetitle>. +World Wide Web Consortium, 1999. +</bibliomixed> + +<!-- ... --> +</bibliography> + + + +When you create a bibliography in your document, simply +provide empty bibliomixed +entries for each document that you wish to cite. Make sure that these +elements have the same ID as the corresponding real +entry in your global bibliography. + +For example: + + +<bibliography><title>Bibliography</title> + +<bibliomixed id="xml-rec"/> +<bibliomixed id="xml-names"/> +<bibliomixed id="DKnuth86">Donald E. Knuth. <citetitle>Computers and +Typesetting: Volume B, TeX: The Program</citetitle>. Addison-Wesley, +1986. ISBN 0-201-13437-3. +</bibliomixed> +<bibliomixed id="relaxng"/> + +</bibliography> + + +Note that it's perfectly acceptable to mix entries from your +global bibliography with normal entries. You can use +xref or other elements to cross-reference your +bibliography entries in exactly the same way you do now. + +Finally, when you are ready to format your document, simply set the +bibliography.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global bibliography. + +The stylesheets will format the bibliography in your document as if +all of the entries referenced appeared there literally. + + + + + + +bibliography.numbered +boolean + + +bibliography.numbered +Should bibliography entries be numbered? + + + + +<xsl:param name="bibliography.numbered" select="0"></xsl:param> + + + +Description + +If non-zero bibliography entries will be numbered + + + + + + +Glossary + + +glossterm.auto.link +boolean + + +glossterm.auto.link +Generate links from glossterm to glossentry automaticaly? + + + + +<xsl:param name="glossterm.auto.link" select="0"></xsl:param> + + + +Description + +If true, a link will be automatically created from glossterm +to glossentry for that glossary term. This is usefull when your +glossterm names are consistent and you don't want to add links +manually. +If there is linkend on +glossterm then is used instead of autogeneration of +link. + + + + + + +firstterm.only.link +boolean + + +firstterm.only.link +Does automatic glossterm linking only apply to firstterms? + + + + +<xsl:param name="firstterm.only.link" select="0"></xsl:param> + + + +Description + +If true, only firstterms will be automatically linked +to the glossary. If glossary linking is not enabled, this parameter +has no effect. + + + + + + +glossary.collection +string + + +glossary.collection +Name of the glossary collection file + + + + +<xsl:param name="glossary.collection" select="''"></xsl:param> + + + +Description + +Glossaries maintained independently across a set of documents +are likely to become inconsistent unless considerable effort is +expended to keep them in sync. It makes much more sense, usually, to +store all of the glossary entries in a single place and simply +extract the ones you need in each document. + +That's the purpose of the +glossary.collection parameter. To setup a global +glossary database, follow these steps: + +Setting Up the Glossary Database + +First, create a stand-alone glossary document that contains all of +the entries that you wish to reference. Make sure that each glossary +entry has an ID. + +Here's an example glossary: + + + +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE glossary + PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<glossary> +<glossaryinfo> +<editor><firstname>Eric</firstname><surname>Raymond</surname></editor> +<title>Jargon File 4.2.3 (abridged)</title> +<releaseinfo>Just some test data</releaseinfo> +</glossaryinfo> + +<glossdiv><title>0</title> + +<glossentry> +<glossterm>0</glossterm> +<glossdef> +<para>Numeric zero, as opposed to the letter `O' (the 15th letter of +the English alphabet). In their unmodified forms they look a lot +alike, and various kluges invented to make them visually distinct have +compounded the confusion. If your zero is center-dotted and letter-O +is not, or if letter-O looks almost rectangular but zero looks more +like an American football stood on end (or the reverse), you're +probably looking at a modern character display (though the dotted zero +seems to have originated as an option on IBM 3270 controllers). If +your zero is slashed but letter-O is not, you're probably looking at +an old-style ASCII graphic set descended from the default typewheel on +the venerable ASR-33 Teletype (Scandinavians, for whom /O is a letter, +curse this arrangement). (Interestingly, the slashed zero long +predates computers; Florian Cajori's monumental "A History of +Mathematical Notations" notes that it was used in the twelfth and +thirteenth centuries.) If letter-O has a slash across it and the zero +does not, your display is tuned for a very old convention used at IBM +and a few other early mainframe makers (Scandinavians curse <emphasis>this</emphasis> +arrangement even more, because it means two of their letters collide). +Some Burroughs/Unisys equipment displays a zero with a <emphasis>reversed</emphasis> +slash. Old CDC computers rendered letter O as an unbroken oval and 0 +as an oval broken at upper right and lower left. And yet another +convention common on early line printers left zero unornamented but +added a tail or hook to the letter-O so that it resembled an inverted +Q or cursive capital letter-O (this was endorsed by a draft ANSI +standard for how to draw ASCII characters, but the final standard +changed the distinguisher to a tick-mark in the upper-left corner). +Are we sufficiently confused yet?</para> +</glossdef> +</glossentry> + +<glossentry> +<glossterm>1TBS</glossterm> +<glossdef> +<para role="accidence"> +<phrase role="pronounce"></phrase> +<phrase role="partsofspeach">n</phrase> +</para> +<para>The "One True Brace Style"</para> +<glossseealso>indent style</glossseealso> +</glossdef> +</glossentry> + +<!-- ... --> + +</glossdiv> + +<!-- ... --> + +</glossary> + + + + +Marking Up Glossary Terms + +That takes care of the glossary database, now you have to get the entries +into your document. Unlike bibliography entries, which can be empty, creating +placeholder glossary entries would be very tedious. So instead, +support for glossary.collection relies on implicit linking. + +In your source document, simply use firstterm and +glossterm to identify the terms you wish to have included +in the glossary. The stylesheets assume that you will either set the +baseform attribute correctly, or that the +content of the element exactly matches a term in your glossary. + +If you're using a glossary.collection, don't +make explicit links on the terms in your document. + +So, in your document, you might write things like this: + + +<para>This is dummy text, without any real meaning. +The point is simply to reference glossary terms like <glossterm>0</glossterm> +and the <firstterm baseform="1TBS">One True Brace Style (1TBS)</firstterm>. +The <glossterm>1TBS</glossterm>, as you can probably imagine, is a nearly +religious issue.</para> + + +If you set the firstterm.only.link parameter, +only the terms marked with firstterm will be links. +Otherwise, all the terms will be linked. + + + +Marking Up the Glossary + +The glossary itself has to be identified for the stylesheets. For lack +of a better choice, the role is used. +To identify the glossary as the target for automatic processing, set +the role to auto. The title of this +glossary (and any other information from the glossaryinfo +that's rendered by your stylesheet) will be displayed, but the entries will +come from the database. + + +Unfortunately, the glossary can't be empty, so you must put in +at least one glossentry. The content of this entry +is irrelevant, it will not be rendered: + + +<glossary role="auto"> +<glossentry> +<glossterm>Irrelevant</glossterm> +<glossdef> +<para>If you can see this, the document was processed incorrectly. Use +the <parameter>glossary.collection</parameter> parameter.</para> +</glossdef> +</glossentry> +</glossary> + + +What about glossary divisions? If your glossary database has glossary +divisions and your automatic glossary contains at least +one glossdiv, the automic glossary will have divisions. +If the glossdiv is missing from either location, no divisions +will be rendered. + +Glossary entries (and divisions, if appropriate) in the glossary will +occur in precisely the order they occur in your database. + + + +Formatting the Document + +Finally, when you are ready to format your document, simply set the +glossary.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global glossary. + +The stylesheets will format the glossary in your document as if +all of the entries implicilty referenced appeared there literally. + + +Limitations + +Glossary cross-references within the glossary are +not supported. For example, this will not work: + + +<glossentry> +<glossterm>gloss-1</glossterm> +<glossdef><para>A description that references <glossterm>gloss-2</glossterm>.</para> +<glossseealso>gloss-2</glossseealso> +</glossdef> +</glossentry> + + +If you put glossary cross-references in your glossary that way, +you'll get the cryptic error: Warning: +glossary.collection specified, but there are 0 automatic +glossaries. + +Instead, you must do two things: + + + +Markup your glossary using glossseealso: + + +<glossentry> +<glossterm>gloss-1</glossterm> +<glossdef><para>A description that references <glossterm>gloss-2</glossterm>.</para> +<glossseealso>gloss-2</glossseealso> +</glossdef> +</glossentry> + + + + +Make sure there is at least one glossterm reference to +gloss-2 in your document. The +easiest way to do that is probably within a remark in your +automatic glossary: + + +<glossary role="auto"> +<remark>Make sure there's a reference to <glossterm>gloss-2</glossterm>.</remark> +<glossentry> +<glossterm>Irrelevant</glossterm> +<glossdef> +<para>If you can see this, the document was processed incorrectly. Use +the <parameter>glossary.collection</parameter> parameter.</para> +</glossdef> +</glossentry> +</glossary> + + + + + + + + + + +glossentry.show.acronym +list + + +glossentry.show.acronym +Display glossentry acronyms? + + + + +<xsl:param name="glossentry.show.acronym" select="'no'"></xsl:param> + + + +Description + +A setting of yes means they should be displayed; +no means they shouldn't. If primary is used, +then they are shown as the primary text for the entry. + + +This setting controls both acronym and +abbrev elements in the glossentry. + + + + + + + +Miscellaneous + + +formal.procedures +boolean + + +formal.procedures +Selects formal or informal procedures + + + + +<xsl:param name="formal.procedures" select="1"></xsl:param> + + + +Description + +Formal procedures are numbered and always have a title. + + + + + + + +formal.title.placement + + + +formal.title.placement +Specifies where formal object titles should occur + + + + +<xsl:param name="formal.title.placement"> +figure before +example before +equation before +table before +procedure before +task before +</xsl:param> + + + +Description + +Specifies where formal object titles should occur. For each formal object +type (figure, +example, +equation, +table, and procedure) +you can specify either the keyword +before or +after. + + + + + + +runinhead.default.title.end.punct +string + + +runinhead.default.title.end.punct +Default punctuation character on a run-in-head + + + +<xsl:param name="runinhead.default.title.end.punct" select="'.'"></xsl:param> + + +Description + +FIXME: + + + + + + + +runinhead.title.end.punct +string + + +runinhead.title.end.punct +Characters that count as punctuation on a run-in-head + + + +<xsl:param name="runinhead.title.end.punct" select="'.!?:'"></xsl:param> + + +Description + +FIXME: + + + + + + + +show.comments +boolean + + +show.comments +Display comment elements? + + + +<xsl:param name="show.comments">1</xsl:param> + + +Description + +If true (non-zero), comments will be displayed, otherwise they are suppressed. +Comments here refers to the comment element, +which will be renamed remark in DocBook V4.0, +not XML comments (<-- like this -->) which are unavailable. + + + + + + + +show.revisionflag +boolean + + +show.revisionflag +Enable decoration of elements that have a revisionflag + + + +<xsl:param name="show.revisionflag">0</xsl:param> + + +Description + + +If show.revisionflag is turned on, then the stylesheets +may produce additional markup designed to allow a CSS stylesheet to +highlight elements that have specific revisionflag settings. + +The markup inserted will be usually be either a <span> or <div> +with an appropriate class attribute. (The value of +the class attribute will be the same as the value of the revisionflag +attribute). In some contexts, for example tables, where extra markup +would be structurally illegal, the class attribute will be added to the +appropriate container element. + +In general, the stylesheets only test for revisionflag in contexts +where an importing stylesheet would have to redefine whole templates. +Most of the revisionflag processing is expected to be done by another +stylesheet, for example changebars.xsl. + + + + + + +shade.verbatim +boolean + + +shade.verbatim +Should verbatim environments be shaded? + + + +<xsl:param name="shade.verbatim" select="0"></xsl:param> + + +Description + +In the FO stylesheet, if this parameter is non-zero then the +shade.verbatim.style properties will be applied +to verbatim environments. + +In the HTML stylesheet, this parameter is now deprecated. Use +CSS instead. + + + + + + +shade.verbatim.style + + + +shade.verbatim.style +Properties that specify the style of shaded verbatim listings + + + + +<xsl:attribute-set name="shade.verbatim.style"> + <xsl:attribute name="border">0</xsl:attribute> + <xsl:attribute name="bgcolor">#E0E0E0</xsl:attribute> +</xsl:attribute-set> + + + + +Description + +FIXME: + + + + + + +punct.honorific +string + + +punct.honorific +Punctuation after an honorific in a personal name. + + + + +<xsl:param name="punct.honorific" select="'.'"></xsl:param> + + + +Description + +This parameter specifies the punctuation that should be added after an +honorific in a personal name. + + + + + + +tex.math.in.alt +string + + +tex.math.in.alt +TeX notation used for equations + + + + +<xsl:param name="tex.math.in.alt" select="''"></xsl:param> + + + +Description + +If you want type math directly in TeX notation in equations, +this parameter specifies notation used. Currently are supported two +values -- plain and latex. Empty +value means that you are not using TeX math at all. + +Preferred way for including TeX alternative of math is inside of +textobject element. Eg.: + +<inlineequation> +<inlinemediaobject> +<imageobject> +<imagedata fileref="eq1.gif"/> +</imageobject> +<textobject><phrase>E=mc squared</phrase></textobject> +<textobject role="tex"><phrase>E=mc^2</phrase></textobject> +</inlinemediaobject> +</inlineequation> + +If you are using graphic element, you can +store TeX inside alt element: + +<inlineequation> +<alt role="tex">a^2+b^2=c^2</alt> +<graphic fileref="a2b2c2.gif"/> +</inlineequation> + +If you want use this feature, you should process your FO with +PassiveTeX, which only supports TeX math notation. When calling +stylsheet, don't forget to specify also +passivetex.extensions=1. + +If you want equations in HTML, just process generated file +tex-math-equations.tex by TeX or LaTeX. Then run +dvi2bitmap program on result DVI file. You will get images for +equations in your document. + + + + + + +tex.math.file +string + + +tex.math.file +Name of temporary file for generating images from equations + + + + +<xsl:param name="tex.math.file" select="'tex-math-equations.tex'"></xsl:param> + + + +Description + +Name of auxiliary file for TeX equations. This file can be +processed by dvi2bitmap to get bitmap versions of equations for HTML +output. + + + + + + +tex.math.delims +boolean + + +tex.math.delims +Should be equations outputed for processing by TeX +automatically surrounded by math mode delimiters + + + + +<xsl:param name="tex.math.delims" select="'1'"></xsl:param> + + + +Description + +For compatibility with DSSSL based DBTeXMath from Allin Cottrell +you should set this parameter to 0. + + + + + + +pixels.per.inch +integer + + +pixels.per.inch +How many pixels are there per inch? + + + + +<xsl:param name="pixels.per.inch" select="90"></xsl:param> + + + +Description + +When lengths are converted to pixels, this value is used to +determine the size of a pixel. The default value is taken from the +XSL +Recommendation. + + + + + + + +points.per.em +number + + +points.per.em +Specify the nominal size of an em-space in points + + + + +<xsl:param name="points.per.em" select="10"></xsl:param> + + + +Description + +FIXME: + + + + + + +use.svg +boolean + + +use.svg +Allow SVG in the result tree? + + + + +<xsl:param name="use.svg" select="1"></xsl:param> + + + +Description + +If non-zero, SVG will be considered an acceptable image format. SVG +is passed through to the result tree, so correct rendering of the resulting +diagram depends on the formatter (FO processor or web browser) that is used +to process the output from the stylesheet. + + + + + + +menuchoice.separator + + + +menuchoice.separator +Separator between items of a menuchoice +other than guimenuitem and +guisubmenu + + + + +<xsl:param name="menuchoice.separator" select="'+'"></xsl:param> + + + +Description + +Separator used to connect items of a menuchoice other +than guimenuitem and guisubmenu. The latter +elements are linked with menuchoice.menu.separator. + + + + + + + +menuchoice.menu.separator + + + +menuchoice.menu.separator +Separator between items of a menuchoice +with guimenuitem or +guisubmenu + + + + +<xsl:param name="menuchoice.menu.separator"> → </xsl:param> + + + +Description + +Separator used to connect items of a menuchoice with +guimenuitem or guisubmenu. Other elements +are linked with menuchoice.separator. + +The default value is &#x2192;, which is the +&rarr; (right arrow) character entity. +The current FOP (0.20.5) requires setting the font-family +explicitly. + +The default value also includes spaces around the arrow, +which will allow a line to break. Replace the spaces with +&#xA0; (nonbreaking space) if you don't want those +spaces to break. + + + + + + + +default.float.class +string + + +default.float.class +Specifies the default float class + + + + +<xsl:param name="default.float.class"> + <xsl:choose> + <xsl:when test="contains($stylesheet.result.type,'html')">left</xsl:when> + <xsl:otherwise>before</xsl:otherwise> + </xsl:choose> +</xsl:param> + + + +Description + +FIXME: + + + + + + +footnote.number.format +string + + +footnote.number.format +Identifies the format used for footnote numbers + + + + +<xsl:param name="footnote.number.format" select="'1'"></xsl:param> + + + +Description + +The footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A). + + + + + + +table.footnote.number.format +string + + +table.footnote.number.format +Identifies the format used for footnote numbers in tables + + + + +<xsl:param name="table.footnote.number.format" select="'a'"></xsl:param> + + + +Description + +The table.footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A) in tables. + + + + + + +footnote.number.symbols + + + +footnote.number.symbols +Special characters to use as footnote markers + + + + +<xsl:param name="footnote.number.symbols" select="''"></xsl:param> + + + +Description + +If footnote.number.symbols is not the empty string, +footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + + + + +table.footnote.number.symbols + + + +table.footnote.number.symbols +Special characters to use a footnote markers in tables + + + + +<xsl:param name="table.footnote.number.symbols" select="''"></xsl:param> + + + +Description + +If table.footnote.number.symbols is not the empty string, +table footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +table.footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + + + + +Annotations + + +annotation.support +boolean + + +annotation.support +Enable annotations? + + + + +<xsl:param name="annotation.support" select="0"></xsl:param> + + + +Description + +If non-zero, the stylesheets will attempt to support annotation +elements in HTML by including some JavaScript (see +annotation.js). + + + + + + +annotation.js +boolean + + +annotation.js +Enable annotations? + + + + +<xsl:param name="annotation.js" select="'http://docbook.sourceforge.net/release/script/AnchorPosition.js http://docbook.sourceforge.net/release/script/PopupWindow.js'"></xsl:param> + + + +Description + +If annotation.support is enabled and the +document contains annotations, then the URIs listed +in this parameter will be included. These JavaScript files are required +for popup annotation support. + + + + + + +annotation.css +boolean + + +annotation.css +Enable annotations? + + + + +<xsl:param name="annotation.css"> +/* ====================================================================== + Annotations +*/ + +div.annotation-list { visibility: hidden; + } + +div.annotation-nocss { position: absolute; + visibility: hidden; + } + +div.annotation-popup { position: absolute; + z-index: 4; + visibility: hidden; + padding: 0px; + margin: 2px; + border-style: solid; + border-width: 1px; + width: 200px; + background-color: white; + } + +div.annotation-title { padding: 1px; + font-weight: bold; + border-bottom-style: solid; + border-bottom-width: 1px; + color: white; + background-color: black; + } + +div.annotation-body { padding: 2px; + } + +div.annotation-body p { margin-top: 0px; + padding-top: 0px; + } + +div.annotation-close { position: absolute; + top: 2px; + right: 2px; + } +</xsl:param> + + + +Description + +If annotation.support is enabled and the +document contains annotations, then the CSS in this +parameter will be included in the document. + + + + + + +annotation.graphic.open +boolean + + +annotation.graphic.open +Enable annotations? + + + + +<xsl:param name="annotation.graphic.open" select="'http://docbook.sourceforge.net/release/images/annot-open.png'"></xsl:param> + + + +Description + +This image is used inline to identify the location of +annotations. + + + + + + +annotation.graphic.close +boolean + + +annotation.graphic.close +Enable annotations? + + + + +<xsl:param name="annotation.graphic.close" select="'http://docbook.sourceforge.net/release/images/annot-close.png'"></xsl:param> + + + +Description + +This image is used on popup annotations as the “x” that the +user can click to dismiss the popup. + + + + + + +Graphics + + +img.src.path +string + + +img.src.path +Path to HTML image files + + + +<xsl:param name="img.src.path"></xsl:param> + + +Description + +Add a path prefix to each HTML +img or FO +fo:external-graphics element's +src attribute. +This path could relative to the directory where the HTML/FO +files are created, or it could be an absolute URI. +The default value is empty. +Be sure to include a trailing slash if needed. + +This prefix is not applied to any filerefs that start +with "/" or contain "//:". + + + + + + + +keep.relative.image.uris +boolean + + +keep.relative.image.uris +Should image URIs be resolved against xml:base? + + + + +<xsl:param name="keep.relative.image.uris" select="1"></xsl:param> + + + + +Description + +If non-zeor, relative URIs (in, for example fileref attributes) will +be used in the generated output. Otherwise, the URIs will be made absolute +with respect to the base URI. + +Note that the stylesheets calculate (and use) the absolute form +for some purposes, this only applies to the resulting output. + + + + + + +graphic.default.extension +string + + +graphic.default.extension +Default extension for graphic filenames + + + +<xsl:param name="graphic.default.extension"></xsl:param> + + +Description + +If a graphic or mediaobject +includes a reference to a filename that does not include an extension, +and the format attribute is +unspecified, the default extension will be used. + + + + + + + +default.image.width +length + + +default.image.width +The default width of images + + + + +<xsl:param name="default.image.width" select="''"></xsl:param> + + + +Description + +If specified, this value will be used for the +width attribute on +images that do not specify any +viewport +dimensions. + + + + + + +nominal.image.width +length + + +nominal.image.width +The nominal image width + + + + +<xsl:param name="nominal.image.width" select="6 * $pixels.per.inch"></xsl:param> + + + +Description + +Graphic widths expressed as a percentage are problematic. In the +following discussion, we speak of width and contentwidth, but +the same issues apply to depth and contentdepth. + +A width of 50% means "half of the available space for the image." +That's fine. But note that in HTML, this is a dynamic property and +the image size will vary if the browser window is resized. + +A contentwidth of 50% means "half of the actual image width". +But what does that mean if the stylesheets cannot assess the image's +actual size? Treating this as a width of 50% is one possibility, but +it produces behavior (dynamic scaling) that seems entirely out of +character with the meaning. + +Instead, the stylesheets define a +nominal.image.width and convert percentages to +actual values based on that nominal size. + + + + + + +nominal.image.depth +length + + +nominal.image.depth +Nominal image depth + + + + +<xsl:param name="nominal.image.depth" select="4 * $pixels.per.inch"></xsl:param> + + + +Description + +See nominal.image.width. + + + + + + +use.embed.for.svg +boolean + + +use.embed.for.svg +Use HTML embed for SVG? + + + + +<xsl:param name="use.embed.for.svg" select="0"></xsl:param> + + + +Description + +If non-zero, an embed element will be created for +SVG figures. An object is always created, +this parameter merely controls whether or not an additional embed +is generated inside the object. + +On the plus side, this may be more portable among browsers and plug-ins. +On the minus side, it isn't valid HTML. + + + + + + +make.graphic.viewport +boolean + + +make.graphic.viewport +Use tables in HTML to make viewports for graphics + + + + +<xsl:param name="make.graphic.viewport" select="1"></xsl:param> + + + +Description + +The HTML img element only supports the notion +of content-area scaling; it doesn't support the distinction between a +content-area and a viewport-area, so we have to make some compromises. + +If make.graphic.viewport is non-zero, a table +will be used to frame the image. This creates an effective viewport-area. + + +Tables and alignment don't work together, so this parameter is ignored +if alignment is specified on an image. + + + + + +preferred.mediaobject.role + + +preferred.mediaobject.role +Select which mediaobject to use based on +this value of an object's role attribute. + + + + + +<xsl:param name="preferred.mediaobject.role"></xsl:param> + + + +Description + +A mediaobject may contain several objects such as imageobjects. +If the parameter use.role.for.mediaobject +is non-zero, then the role attribute on +imageobjects and other objects within a mediaobject container will be used to select which object will be +used. If one of the objects has a role value that matches the +preferred.mediaobject.role parameter, then it has first +priority for selection. If more than one has such a +role value, the first one is used. + + +See the use.role.for.mediaobject parameter +for the sequence of selection. + + + + + +use.role.for.mediaobject +boolean + + +use.role.for.mediaobject +Use role attribute +value for selecting which of several objects within a mediaobject to use. + + + + + +<xsl:param name="use.role.for.mediaobject" select="1"></xsl:param> + + + +Description + +If non-zero, the role attribute on +imageobjects or other objects within a mediaobject container will be used to select which object will be +used. + + +The order of selection when then parameter is non-zero is: + + + + If the stylesheet parameter preferred.mediaobject.role has a value, then the object whose role equals that value is selected. + + +Else if an object's role attribute has a value of +html for HTML processing or +fo for FO output, then the first +of such objects is selected. + + + +Else the first suitable object is selected. + + + +If the value of +use.role.for.mediaobject +is zero, then role attributes are not considered +and the first suitable object +with or without a role value is used. + + + + + + +ignore.image.scaling +boolean + + +ignore.image.scaling +Tell the stylesheets to ignore the author's image scaling attributes + + + + +<xsl:param name="ignore.image.scaling" select="0"></xsl:param> + + + +Description + +If non-zero, the scaling attributes on graphics and media objects are +ignored. + + + + + + +Chunking + + +chunker.output.cdata-section-elements +string + + +chunker.output.cdata-section-elements +List of elements to escape with CDATA sections + + +<xsl:param name="chunker.output.cdata-section-elements" select="''"/> + + +Description + +This parameter specifies the list of elements that should be escaped +as CDATA sections by the chunking stylesheet. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.doctype-public +string + + +chunker.output.doctype-public +Public identifer to use in the document type of generated pages + + +<xsl:param name="chunker.output.doctype-public" select="''"/> + + +Description + +This parameter specifies the public identifier that should be used by +the chunking stylesheet in the document type declaration of chunked pages. +Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.doctype-system +uri + + +chunker.output.doctype-system +System identifier to use for the document type in generated pages + + +<xsl:param name="chunker.output.doctype-system" select="''"/> + + +Description + +This parameter specifies the system identifier that should be used by +the chunking stylesheet in the document type declaration of chunked pages. +Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.encoding +string + + +chunker.output.encoding +Encoding used in generated pages + + +<xsl:param name="chunker.output.encoding" select="'ISO-8859-1'"/> + + +Description + +This parameter specifies the encoding to be used in files +generated by the chunking stylesheet. Not all processors support +specification of this parameter. + + +This parameter used to be named default.encoding. + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.indent +string + + +chunker.output.indent +Specification of indentation on generated pages + + +<xsl:param name="chunker.output.indent" select="'no'"/> + + +Description + +This parameter specifies the value of the indent +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.media-type +string + + +chunker.output.media-type +Media type to use in generated pages + + +<xsl:param name="chunker.output.media-type" select="''"/> + + +Description + +This parameter specifies the media type that should be used by +the chunking stylesheet. Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.method +list +html +xml + + +chunker.output.method +Method used in generated pages + + +<xsl:param name="chunker.output.method" select="'html'"/> + + +Description + +This parameter specifies the output method to be used in files +generated by the chunking stylesheet. + + +This parameter used to be named output.method. + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.omit-xml-declaration + + + +chunker.output.omit-xml-declaration +Omit-xml-declaration for generated pages + + +<xsl:param name="chunker.output.omit-xml-declaration" select="'no'"/> + + +Description + +This parameter specifies the value of the omit-xml-declaration +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.standalone +string + + +chunker.output.standalone +Standalone declaration for generated pages + + +<xsl:param name="chunker.output.standalone" select="'no'"/> + + +Description + +This parameter specifies the value of the standalone +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +saxon.character.representation +string + + +saxon.character.representation +Saxon character representation used in generated HTML pages + + +<xsl:param name="saxon.character.representation" select="'entity;decimal'"/> + + +Description + +This character representation is used in files generated by chunking stylesheet. If +you want to suppress entity references for characters with direct representation +in default.encoding, set this parameter to value native. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +html.ext + + + +html.ext +Identifies the extension of generated HTML files + + + + +<xsl:param name="html.ext" select="'.html'"></xsl:param> + + + +Description + +The extension identified by html.ext will +be used as the filename extension for chunks created by this stylesheet. + + + + + + + +use.id.as.filename +boolean + + +use.id.as.filename +Use ID value of chunk elements as the filename? + + + +<xsl:param name="use.id.as.filename" select="'0'"></xsl:param> + + +Description + +If use.id.as.filename +is non-zero, the filename of chunk elements that have IDs will be +derived from the ID value. + + + + + + + +html.extra.head.links +boolean + + +html.extra.head.links +Toggle extra HTML head link information + + + + +<xsl:param name="html.extra.head.links" select="0"></xsl:param> + + + +Description + +If non-zero, extra link elements will be +generated in the head of chunked HTML files. These +extra links point to chapters, appendixes, sections, etc. as supported +by the Site Navigation Bar in Mozilla 1.0 (as of CR1, at least). + + + + + + + +root.filename + + + +root.filename +Identifies the name of the root HTML file when chunking + + + +<xsl:param name="root.filename" select="'index'"></xsl:param> + + +Description + +The root.filename is the base filename for +the chunk created for the root of each document processed. + + + + + + + +base.dir + + + +base.dir +The base directory of chunks + + + +<xsl:param name="base.dir" select="''"></xsl:param> + + +Description + +If specified, the base.dir identifies +the output directory for chunks. (If not specified, the output directory +is system dependent.) + + + + + + + generate.manifest + boolean + + + generate.manifest + Generate a manifest file? + + + + <xsl:param name="generate.manifest" select="0"></xsl:param> + + + Description + + If non-zero, a list of HTML files generated by the + stylesheet transformation is written to the file named by + the manifest parameter. + + + + + + + manifest + string + + + manifest + Name of manifest file + + + + <xsl:param name="manifest" select="'HTML.manifest'"></xsl:param> + + + Description + + The name of the file to which a manifest is written (if the + value of the generate.manifest parameter + is non-zero). + + + + + + +manifest.in.base.dir +boolean + + +manifest.in.base.dir +Should be manifest file written in $base.dir? + + + + +<xsl:param name="manifest.in.base.dir" select="0"></xsl:param> + + + +Description + +If non-zero manifest file and project files for HTML Help and +Eclipse Help are written into base.dir instead +of current directory. + + + + + + + +chunk.toc +string + + +chunk.toc +An explicit TOC to be used for chunking + + + + +<xsl:param name="chunk.toc" select="''"></xsl:param> + + + +Description + +The chunk.toc identifies an explicit TOC that +will be used for chunking. This parameter is only used by the +chunktoc.xsl stylesheet (and customization layers built +from it). + + + + + + +chunk.tocs.and.lots +boolean + + +chunk.tocs.and.lots +Should ToC and LoTs be in separate chunks? + + + + +<xsl:param name="chunk.tocs.and.lots" select="0"></xsl:param> + + + +Description + +If non-zero, ToC and LoT (List of Examples, List of Figures, etc.) +will be put in a separate chunk. At the moment, this chunk is not in the +normal forward/backward navigation list. Instead, a new link is added to the +navigation footer. + +This feature is still somewhat experimental. Feedback welcome. + + + + + + +chunk.separate.lots +boolean + + +chunk.separate.lots +Should each LoT be in its own separate chunk? + + + + +<xsl:param name="chunk.separate.lots" select="0"></xsl:param> + + + +Description + +If non-zero, each of the ToC and LoTs +(List of Examples, List of Figures, etc.) +will be put in its own separate chunk. +The title page includes generated links to each of the separate files. + + +This feature depends on the +chunk.tocs.and.lots +parameter also being non-zero. + + + + + + + +chunk.tocs.and.lots.has.title +boolean + + +chunk.tocs.and.lots.has.title +Should ToC and LoTs in a separate chunks have title? + + + + +<xsl:param name="chunk.tocs.and.lots.has.title" select="1"></xsl:param> + + + +Description + +If non-zero title of document is shown before ToC/LoT in +separate chunk. + + + + + + +chunk.section.depth +integer + + +chunk.section.depth +Depth to which sections should be chunked + + + + +<xsl:param name="chunk.section.depth" select="1"></xsl:param> + + + +Description + +This parameter sets the depth of section chunking. + + + + + + +chunk.first.sections + + + +chunk.first.sections +Chunk the first top-level section? + + + + +<xsl:param name="chunk.first.sections" select="0"></xsl:param> + + + +Description + +If non-zero, a chunk will be created for the first top-level +sect1 or section elements in +each component. Otherwise, that section will be part of the chunk for +its parent. + + + + + + + +chunk.quietly + + + +chunk.quietly +Omit the chunked filename messages. + + + + +<xsl:param name="chunk.quietly" select="0"></xsl:param> + + + +Description + +If zero (the default), the XSL processor emits a message naming +each separate chunk filename as it is being output. +If nonzero, then the messages are suppressed. + + + + + + + +navig.graphics +boolean + + +navig.graphics +Use graphics in navigational headers and footers? + + + +<xsl:param name="navig.graphics" select="0"></xsl:param> + + +Description + +If true (non-zero), the navigational headers and footers in chunked +HTML are presented in an alternate style that uses +graphical icons for Next, Previous, Up, and Home. +Default graphics are provided in the distribution. + + + + + + + +navig.graphics.extension +string + + +navig.graphics.extension +Extension for navigational graphics + + + +<xsl:param name="navig.graphics.extension" select="'.gif'"></xsl:param> + + +Description + +Sets the filename extension to use on navigational graphics used +in the headers and footers of chunked HTML. + + + + + + +navig.graphics.path +string + + +navig.graphics.path +Path to navigational graphics + + + +<xsl:param name="navig.graphics.path">images/</xsl:param> + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the navigational graphics used in the +headers and footers of chunked HTML. + + + + + + + +navig.showtitles +boolean + + +navig.showtitles +Display titles in HTML headers and footers? + + + +<xsl:param name="navig.showtitles">1</xsl:param> + + +Description + +If true (non-zero), +the headers and footers of chunked HTML +display the titles of the next and previous chunks, +along with the words 'Next' and 'Previous' (or the +equivalent graphical icons if navig.graphics is true). +If false (zero), then only the words 'Next' and 'Previous' +(or the icons) are displayed. + + + + + + + +Profiling + +Following parameters can be used for attribute value based +profiling of your document. For more info about profiling look at +http://docbook.sourceforge.net/projects/xsl/doc/tools/profiling.html. + + + +profile.arch +string + + +profile.arch +Target profile for arch +attribute + + + + +<xsl:param name="profile.arch" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.condition +string + + +profile.condition +Target profile for condition +attribute + + + + +<xsl:param name="profile.condition" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.conformance +string + + +profile.conformance +Target profile for conformance +attribute + + + + +<xsl:param name="profile.conformance" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.lang +string + + +profile.lang +Target profile for lang +attribute + + + + +<xsl:param name="profile.lang" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.os +string + + +profile.os +Target profile for os +attribute + + + + +<xsl:param name="profile.os" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.revision +string + + +profile.revision +Target profile for revision +attribute + + + + +<xsl:param name="profile.revision" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.revisionflag +string + + +profile.revisionflag +Target profile for revisionflag +attribute + + + + +<xsl:param name="profile.revisionflag" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.role +string + + +profile.role +Target profile for role +attribute + + + + +<xsl:param name="profile.role" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + +Note that role is often +used for other purposes than profiling. For example it is commonly +used to get emphasize in bold font: + +<emphasis role="bold">very important</emphasis> + +If you are using role for +these purposes do not forget to add values like bold to +value of this parameter. If you forgot you will get document with +small pieces missing which are very hard to track. + +For this reason it is not recommended to use role attribute for profiling. You should +rather use profiling specific attributes like userlevel, os, arch, condition, etc. + + + + + + + +profile.security +string + + +profile.security +Target profile for security +attribute + + + + +<xsl:param name="profile.security" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.userlevel +string + + +profile.userlevel +Target profile for userlevel +attribute + + + + +<xsl:param name="profile.userlevel" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.vendor +string + + +profile.vendor +Target profile for vendor +attribute + + + + +<xsl:param name="profile.vendor" select="''"></xsl:param> + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.attribute +string + + +profile.attribute +Name of user-specified profiling attribute + + + + +<xsl:param name="profile.attribute" select="''"></xsl:param> + + + +Description + +This parameter is used in conjuction with profile.value. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.value +string + + +profile.value +Target profile for user-specified attribute + + + + +<xsl:param name="profile.value" select="''"></xsl:param> + + + +Description + +When you are using this parameter you must also specify name of +profiling attribute with parameter profile.attribute. + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.separator +string + + +profile.separator +Separator character for compound profile values + + + + +<xsl:param name="profile.separator" select="';'"></xsl:param> + + + +Description + +Separator character for compound profile values. + + + + + + +HTML Help + + +htmlhelp.encoding +string + + +htmlhelp.encoding +Character encoding to use in files for HTML Help compiler. + + + + +<xsl:param name="htmlhelp.encoding" select="'iso-8859-1'"></xsl:param> + + + +Description + +HTML Help Compiler is not UTF-8 aware, so you should always use +apropriate single-byte encoding here. + + + + + + +htmlhelp.autolabel +boolean + + +htmlhelp.autolabel +Should tree-like ToC use autonumbering feature? + + + + +<xsl:param name="htmlhelp.autolabel" select="0"></xsl:param> + + + +Description + +If you want to include chapter and section numbers into ToC in +the left panel, set this parameter to 1. + + + + + + +htmlhelp.chm +string + + +htmlhelp.chm +Filename of output HTML Help file. + + + + +<xsl:param name="htmlhelp.chm" select="'htmlhelp.chm'"></xsl:param> + + + +Description + +Change this parameter if you want different name of result +CHM file than htmlhelp.chm. + + + + + + +htmlhelp.default.topic +string + + +htmlhelp.default.topic +Name of file with default topic + + + + +<xsl:param name="htmlhelp.default.topic" select="''"></xsl:param> + + + +Description + +Normally first chunk of document is displayed when you open HTML +Help file. If you want to display another topic, simply set its +filename by this parameter. + +This is useful especially if you don't generate ToC in front of +your document and you also hide root element in ToC. E.g.: + +<xsl:param name="generate.book.toc" select="0"/> +<xsl:param name="htmlhelp.hhc.show.root" select="0"/> +<xsl:param name="htmlhelp.default.topic" select="'pr01.html'"/> + + + + + + +htmlhelp.display.progress +boolean + + +htmlhelp.display.progress +Display compile progress? + + + + +<xsl:param name="htmlhelp.display.progress" select="1"></xsl:param> + + + +Description + +You can swith off display of compile progress by setting this +parameter to 0. + + + + + + + +htmlhelp.hhp +string + + +htmlhelp.hhp +Filename of project file. + + + + +<xsl:param name="htmlhelp.hhp" select="'htmlhelp.hhp'"></xsl:param> + + + +Description + +Change this parameter if you want different name of project +file than htmlhelp.hhp. + + + + + + +htmlhelp.hhc +string + + +htmlhelp.hhc +Filename of TOC file. + + + + +<xsl:param name="htmlhelp.hhc" select="'toc.hhc'"></xsl:param> + + + +Description + +Change this parameter if you want different name of TOC file +than toc.hhc. + + + + + + +htmlhelp.hhk +string + + +htmlhelp.hhk +Filename of index file. + + + + +<xsl:param name="htmlhelp.hhk" select="'index.hhk'"></xsl:param> + + + +Description + +Change this parameter if you want different name of index file +than index.hhk. + + + + + + +htmlhelp.hhp.tail +string + + +htmlhelp.hhp.tail +Additional content for project file. + + + + +<xsl:param name="htmlhelp.hhp.tail"></xsl:param> + + + +Description + +If you want to include some additional parameters into project file, +store appropriate part of project file into this parameter. + + + + + + +htmlhelp.hhp.window +string + + +htmlhelp.hhp.window +Name of default window. + + + + +<xsl:param name="htmlhelp.hhp.window" select="'Main'"></xsl:param> + + + +Description + +Name of default window. If empty no [WINDOWS] section will be +added to project file. + + + + + + +htmlhelp.hhp.windows +string + + +htmlhelp.hhp.windows +Definition of additional windows + + + + +<xsl:param name="htmlhelp.hhp.windows"></xsl:param> + + + +Description + +Content of this parameter is placed at the end of [WINDOWS] +section of project file. You can use it for defining your own +addtional windows. + + + + + + + +htmlhelp.enhanced.decompilation +boolean + + +htmlhelp.enhanced.decompilation +Allow enhanced decompilation of CHM? + + + + +<xsl:param name="htmlhelp.enhanced.decompilation" select="0"></xsl:param> + + + +Description + +When set to 1 this parameter enables enhanced decompilation of CHM. + + + + + + + +htmlhelp.enumerate.images +boolean + + +htmlhelp.enumerate.images +Should be paths to all used images added to project file? + + + + +<xsl:param name="htmlhelp.enumerate.images" select="0"></xsl:param> + + + +Description + +You should turn on this flag, if you insert images into your documents +as external binary entities or if you are using absolute path in image names. + + + + + + +htmlhelp.force.map.and.alias +boolean + + +htmlhelp.force.map.and.alias +Should be [MAP] and [ALIAS] section added to project file unconditionaly? + + + + +<xsl:param name="htmlhelp.force.map.and.alias" select="0"></xsl:param> + + + +Description + +You should turn on this flag, if you have your own +alias.h and contex.h files +and you want include reference to them in project file. + + + + + + +htmlhelp.map.file +string + + +htmlhelp.map.file +Filename of map file. + + + + +<xsl:param name="htmlhelp.map.file" select="'context.h'"></xsl:param> + + + +Description + +Change this parameter if you want different name of map file +than context.h. + + + + + + +htmlhelp.alias.file +string + + +htmlhelp.alias.file +Filename of map file. + + + + +<xsl:param name="htmlhelp.alias.file" select="'alias.h'"></xsl:param> + + + +Description + +Change this parameter if you want different name of map file +than alias.h. + + + + + + +htmlhelp.hhc.section.depth +integer + + +htmlhelp.hhc.section.depth +Depth of TOC for sections in a left pane. + + + + +<xsl:param name="htmlhelp.hhc.section.depth" select="5"></xsl:param> + + + +Description + +Change this parameter if you want shallower ToC in a left pane +of HTML Help viewer. + + + + + + +htmlhelp.hhc.show.root +boolean + + +htmlhelp.hhc.show.root +Should be entry for root element shown in ToC? + + + + +<xsl:param name="htmlhelp.hhc.show.root" select="1"></xsl:param> + + + +Description + +If set to 0, there will be no entry for root element in +ToC. This is useful when you want provide user with expanded ToC as +a default. + + + + + + +htmlhelp.hhc.folders.instead.books + + + +htmlhelp.hhc.folders.instead.books +Use folder icons in ToC (instead of book icons)? + + + + +<xsl:param name="htmlhelp.hhc.folders.instead.books" select="1"></xsl:param> + + + +Description + +This parameter controls whether there should be folder-like +icons (1) or book-like icons (0) in ToC. If you want to use +folder-like icons you must swith off binary ToC using +htmlhelp.hhc.binary. + + + + + + +htmlhelp.hhc.binary + + + +htmlhelp.hhc.binary +Generate binary ToC? + + + + +<xsl:param name="htmlhelp.hhc.binary" select="1"></xsl:param> + + + +Description + +This parametr controls whether binary TOC will be generated. You +must create binary TOC if you want to add Prev/Next buttons to toolbar +(which is default behaviour). Files with binary TOC can't be merged. + + + + + + +htmlhelp.hhc.width +integer + + +htmlhelp.hhc.width +Width of navigation (ToC) pane + + + + +<xsl:param name="htmlhelp.hhc.width"></xsl:param> + + + +Description + +This parameter specifies width of ToC pane in pixels. + + + + + + + +htmlhelp.title +string + + +htmlhelp.title +Title of HTML Help + + + + +<xsl:param name="htmlhelp.title" select="''"></xsl:param> + + + +Description + +Content of this parameter will be used as a title for generated +HTML Help. If empty, title will be automatically taken from document. + + + + + + +htmlhelp.show.menu +boolean + + +htmlhelp.show.menu +Should be menu shown? + + + + +<xsl:param name="htmlhelp.show.menu" select="0"></xsl:param> + + + +Description + +If you want application menu in your HTML Help file, turn this +parameter to 1. + + + + + + +htmlhelp.show.toolbar.text +boolean + + +htmlhelp.show.toolbar.text +Show text under toolbar buttons? + + + + +<xsl:param name="htmlhelp.show.toolbar.text" select="1"></xsl:param> + + + +Description + +You can switch off display of texts under toolbar buttons by +setting this parameter to 0. + + + + + + + +htmlhelp.show.advanced.search +boolean + + +htmlhelp.show.advanced.search +Should be advanced search available? + + + + +<xsl:param name="htmlhelp.show.advanced.search" select="0"></xsl:param> + + + +Description + +If you want advanced search features in your help, turn this +parameter to 1. + + + + + + +htmlhelp.show.favorities +boolean + + +htmlhelp.show.favorities +Should be favorities tab shown? + + + + +<xsl:param name="htmlhelp.show.favorities" select="0"></xsl:param> + + + +Description + +If you want favorities tab shown in your help, turn this +parameter to 1. + + + + + + +htmlhelp.button.hideshow +boolean + + +htmlhelp.button.hideshow +Should be Hide/Show button shown? + + + + +<xsl:param name="htmlhelp.button.hideshow" select="1"></xsl:param> + + + +Description + +If you want Hide/Show button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.back +boolean + + +htmlhelp.button.back +Should be Back button shown? + + + + +<xsl:param name="htmlhelp.button.back" select="1"></xsl:param> + + + +Description + +If you want Back button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.forward +boolean + + +htmlhelp.button.forward +Should be Forward button shown? + + + + +<xsl:param name="htmlhelp.button.forward" select="0"></xsl:param> + + + +Description + +If you want Forward button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.stop +boolean + + +htmlhelp.button.stop +Should be Stop button shown? + + + + +<xsl:param name="htmlhelp.button.stop" select="0"></xsl:param> + + + +Description + +If you want Stop button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.refresh +boolean + + +htmlhelp.button.refresh +Should be Refresh button shown? + + + + +<xsl:param name="htmlhelp.button.refresh" select="0"></xsl:param> + + + +Description + +If you want Refresh button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.home +boolean + + +htmlhelp.button.home +Should be Home button shown? + + + + +<xsl:param name="htmlhelp.button.home" select="0"></xsl:param> + + + +Description + +If you want Home button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.home.url +string + + +htmlhelp.button.home.url +URL address of page accessible by Home button + + + + +<xsl:param name="htmlhelp.button.home.url"></xsl:param> + + + +Description + +URL address of page accessible by Home button. + + + + + + +htmlhelp.button.options +boolean + + +htmlhelp.button.options +Should be Options button shown? + + + + +<xsl:param name="htmlhelp.button.options" select="1"></xsl:param> + + + +Description + +If you want Options button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.print +boolean + + +htmlhelp.button.print +Should be Print button shown? + + + + +<xsl:param name="htmlhelp.button.print" select="1"></xsl:param> + + + +Description + +If you want Print button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.locate +boolean + + +htmlhelp.button.locate +Should be Locate button shown? + + + + +<xsl:param name="htmlhelp.button.locate" select="0"></xsl:param> + + + +Description + +If you want Locate button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.jump1 +boolean + + +htmlhelp.button.jump1 +Should be Jump1 button shown? + + + + +<xsl:param name="htmlhelp.button.jump1" select="0"></xsl:param> + + + +Description + +If you want Jump1 button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.jump1.url +string + + +htmlhelp.button.jump1.url +URL address of page accessible by Jump1 button + + + + +<xsl:param name="htmlhelp.button.jump1.url"></xsl:param> + + + +Description + +URL address of page accessible by Jump1 button. + + + + + + +htmlhelp.button.jump1.title +string + + +htmlhelp.button.jump1.title +Title of Jump1 button + + + + +<xsl:param name="htmlhelp.button.jump1.title" select="'User1'"></xsl:param> + + + +Description + +Title of Jump1 button. + + + + + + +htmlhelp.button.jump2 +boolean + + +htmlhelp.button.jump2 +Should be Jump2 button shown? + + + + +<xsl:param name="htmlhelp.button.jump2" select="0"></xsl:param> + + + +Description + +If you want Jump2 button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.jump2.url +string + + +htmlhelp.button.jump2.url +URL address of page accessible by Jump2 button + + + + +<xsl:param name="htmlhelp.button.jump2.url"></xsl:param> + + + +Description + +URL address of page accessible by Jump2 button. + + + + + + +htmlhelp.button.jump2.title +string + + +htmlhelp.button.jump2.title +Title of Jump2 button + + + + +<xsl:param name="htmlhelp.button.jump2.title" select="'User2'"></xsl:param> + + + +Description + +Title of Jump2 button. + + + + + + +htmlhelp.button.next +boolean + + +htmlhelp.button.next +Should be Next button shown? + + + + +<xsl:param name="htmlhelp.button.next" select="1"></xsl:param> + + + +Description + +If you want Next button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.prev +boolean + + +htmlhelp.button.prev +Should be Prev button shown? + + + + +<xsl:param name="htmlhelp.button.prev" select="1"></xsl:param> + + + +Description + +If you want Prev button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.zoom +boolean + + +htmlhelp.button.zoom +Should be Zoom button shown? + + + + +<xsl:param name="htmlhelp.button.zoom" select="0"></xsl:param> + + + +Description + +If you want Zoom button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.remember.window.position +boolean + + +htmlhelp.remember.window.position +Remember help window position? + + + + +<xsl:param name="htmlhelp.remember.window.position" select="0"></xsl:param> + + + +Description + +To remember help window position between starts set this +parameter to 1. + + + + + + + +htmlhelp.window.geometry +string + + +htmlhelp.window.geometry +Set initial geometry of help window + + + + +<xsl:param name="htmlhelp.window.geometry"></xsl:param> + + + +Description + +This parameter specifies initial position of help +window. E.g. + +<xsl:param name="htmlhelp.window.geometry">[160,64,992,704]</xsl:param> + + + + + + + +htmlhelp.use.hhk +boolean + + +htmlhelp.use.hhk +Should be index built using HHK file? + + + + +<xsl:param name="htmlhelp.use.hhk" select="0"></xsl:param> + + + +Description + +If non-zero, index is created using HHK file. This provides some +new features. + + + + + + +htmlhelp.only +boolean + + +htmlhelp.only +Should be only project files generated? + + + + +<xsl:param name="htmlhelp.only" select="0"></xsl:param> + + + +Description + +If you want to play with various HTML Help parameters and you +don't need to regenerate all HTML files, you can set this parameter to +1. This setting will not process whole document, only project files +(hhp, hhc, hhk,...) will be generated. + + + + + + +Eclipse Help Platform + + +eclipse.autolabel +boolean + + +eclipse.autolabel +Should tree-like ToC use autonumbering feature? + + + + +<xsl:param name="eclipse.autolabel" select="0"></xsl:param> + + + +Description + +If you want to include chapter and section numbers into ToC in +the left panel, set this parameter to 1. + + + + + + +eclipse.plugin.name +string + + +eclipse.plugin.name +Eclipse Help plugin name + + + + +<xsl:param name="eclipse.plugin.name">DocBook Online Help Sample</xsl:param> + + + +Description + +Eclipse Help plugin name. + + + + + + +eclipse.plugin.id +string + + +eclipse.plugin.id +Eclipse Help plugin id + + + + +<xsl:param name="eclipse.plugin.id">com.example.help</xsl:param> + + + +Description + +Eclipse Help plugin id. You should change this id to something +unique for each help. + + + + + + +eclipse.plugin.provider +string + + +eclipse.plugin.provider +Eclipse Help plugin provider name + + + + +<xsl:param name="eclipse.plugin.provider">Example provider</xsl:param> + + + +Description + +Eclipse Help plugin provider name. + + + + + + +Localization + + +l10n.gentext.language +string + + +l10n.gentext.language +Sets the gentext language + + + + +<xsl:param name="l10n.gentext.language" select="''"></xsl:param> + + + +Description + +If this parameter is set to any value other than the empty string, its +value will be used as the value for the language when generating text. Setting +l10n.gentext.language overrides any settings within the +document being formatted. + +It's much more likely that you might want to set the +l10n.gentext.default.language parameter. + + + + + + +l10n.gentext.default.language +string + + +l10n.gentext.default.language +Sets the default language for generated text + + + + +<xsl:param name="l10n.gentext.default.language" select="'en'"></xsl:param> + + + +Description + +The value of the l10n.gentext.default.language +parameter is used as the language for generated text if no setting is provided +in the source document. + + + + + + +l10n.gentext.use.xref.language +boolean + + +l10n.gentext.use.xref.language +Use the language of target when generating cross-reference text? + + + + +<xsl:param name="l10n.gentext.use.xref.language" select="0"></xsl:param> + + + +Description + +If non-zero, the language of the target will be used when +generating cross reference text. Usually, the current +language is used when generating text (that is, the language of the +element that contains the cross-reference element). But setting this parameter +allows the language of the element pointed to to control +the generated text. + +Consider the following example: + + +<para lang="en">See also <xref linkend="chap3"/>.</para> + + + +Suppose that Chapter 3 happens to be written in German. +If l10n.gentext.use.xref.language is non-zero, the +resulting text will be something like this: + +
                  +See also Kapital 3. +
                  + +Where the more traditional rendering would be: + +
                  +See also Chapter 3. +
                  + +                   +                   + + + +l10n.lang.value.rfc.compliant +boolean + + +l10n.lang.value.rfc.compliant +Make value of lang attribute RFC compliant? + + + + +<xsl:param name="l10n.lang.value.rfc.compliant" select="1"></xsl:param> + + + +Description + +If non-zero, ensure that the values for all lang attributes in HTML output are RFC +compliantSection 8.1.1, Language Codes, in the HTML 4.0 Recommendation states that: + +
                  [RFC1766] defines and explains the language codes +that must be used in HTML documents. +Briefly, language codes consist of a primary code and a possibly +empty series of subcodes: + +language-code = primary-code ( "-" subcode )* + +And in RFC 1766, Tags for the Identification +of Languages, the EBNF for "language tag" is given as: + +Language-Tag = Primary-tag *( "-" Subtag ) +Primary-tag = 1*8ALPHA +Subtag = 1*8ALPHA + +
                  +                  . + +by taking any underscore characters in any lang values found in source documents, and +replacing them with hyphen characters in output HTML files. For +example, zh_CN in a source document becomes +zh-CN in the HTML output form that source. + + +This parameter does not cause any case change in lang values, because RFC 1766 +explicitly states that all "language tags" (as it calls them) "are +to be treated as case insensitive". + +                   + +                   +                   + +                   + +The Stylesheet + +The param.xsl stylesheet is just a wrapper +around all these parameters. + + + +<!-- This file is generated from param.xweb; do not edit this file! --> + +<xsl:stylesheet exclude-result-prefixes="src" version="1.0"> + +<!-- ******************************************************************** + $Id: param.xweb,v 1.103 2006/05/14 06:22:26 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<src:fragref linkend="admon.graphics.extension.frag"></src:fragref> +<src:fragref linkend="admon.graphics.frag"></src:fragref> +<src:fragref linkend="admon.graphics.path.frag"></src:fragref> +<src:fragref linkend="admon.style.frag"></src:fragref> +<src:fragref linkend="admon.textlabel.frag"></src:fragref> +<src:fragref linkend="annotate.toc.frag"></src:fragref> +<src:fragref linkend="annotation.css.frag"></src:fragref> +<src:fragref linkend="annotation.js.frag"></src:fragref> +<src:fragref linkend="annotation.graphic.open.frag"></src:fragref> +<src:fragref linkend="annotation.graphic.close.frag"></src:fragref> +<src:fragref linkend="annotation.support.frag"></src:fragref> +<src:fragref linkend="appendix.autolabel.frag"></src:fragref> +<src:fragref linkend="author.othername.in.middle.frag"></src:fragref> +<src:fragref linkend="autotoc.label.separator.frag"></src:fragref> +<src:fragref linkend="autotoc.label.in.hyperlink.frag"></src:fragref> +<src:fragref linkend="base.dir.frag"></src:fragref> +<src:fragref linkend="biblioentry.item.separator.frag"></src:fragref> +<src:fragref linkend="bibliography.collection.frag"></src:fragref> +<src:fragref linkend="bibliography.numbered.frag"></src:fragref> +<src:fragref linkend="bridgehead.in.toc.frag"></src:fragref> +<src:fragref linkend="callout.defaultcolumn.frag"></src:fragref> +<src:fragref linkend="callout.graphics.extension.frag"></src:fragref> +<src:fragref linkend="callout.graphics.frag"></src:fragref> +<src:fragref linkend="callout.graphics.number.limit.frag"></src:fragref> +<src:fragref linkend="callout.graphics.path.frag"></src:fragref> +<src:fragref linkend="callout.list.table.frag"></src:fragref> +<src:fragref linkend="callout.unicode.frag"></src:fragref> +<src:fragref linkend="callout.unicode.number.limit.frag"></src:fragref> +<src:fragref linkend="callout.unicode.start.character.frag"></src:fragref> +<src:fragref linkend="callouts.extension.frag"></src:fragref> +<src:fragref linkend="chapter.autolabel.frag"></src:fragref> +<src:fragref linkend="chunk.first.sections.frag"></src:fragref> +<src:fragref linkend="chunk.quietly.frag"></src:fragref> +<src:fragref linkend="chunk.section.depth.frag"></src:fragref> +<src:fragref linkend="chunk.toc.frag"></src:fragref> +<src:fragref linkend="chunk.tocs.and.lots.frag"></src:fragref> +<src:fragref linkend="chunk.tocs.and.lots.has.title.frag"></src:fragref> +<src:fragref linkend="chunk.separate.lots.frag"></src:fragref> +<src:fragref linkend="citerefentry.link.frag"></src:fragref> +<src:fragref linkend="collect.xref.targets.frag"></src:fragref> +<src:fragref linkend="component.label.includes.part.label.frag"></src:fragref> +<src:fragref linkend="css.decoration.frag"></src:fragref> +<src:fragref linkend="current.docid.frag"></src:fragref> +<src:fragref linkend="default.float.class.frag"></src:fragref> +<src:fragref linkend="default.image.width.frag"></src:fragref> +<src:fragref linkend="default.table.width.frag"></src:fragref> +<src:fragref linkend="default.table.frame.frag"></src:fragref> +<src:fragref linkend="draft.mode.frag"></src:fragref> +<src:fragref linkend="draft.watermark.image.frag"></src:fragref> +<src:fragref linkend="ebnf.table.bgcolor.frag"></src:fragref> +<src:fragref linkend="ebnf.table.border.frag"></src:fragref> +<src:fragref linkend="ebnf.assignment.frag"></src:fragref> +<src:fragref linkend="ebnf.statement.terminator.frag"></src:fragref> +<src:fragref linkend="eclipse.autolabel.frag"></src:fragref> +<src:fragref linkend="eclipse.plugin.name.frag"></src:fragref> +<src:fragref linkend="eclipse.plugin.id.frag"></src:fragref> +<src:fragref linkend="eclipse.plugin.provider.frag"></src:fragref> +<src:fragref linkend="emphasis.propagates.style.frag"></src:fragref> +<src:fragref linkend="entry.propagates.style.frag"></src:fragref> +<src:fragref linkend="firstterm.only.link.frag"></src:fragref> +<src:fragref linkend="footer.rule.frag"></src:fragref> +<src:fragref linkend="footnote.number.format.frag"></src:fragref> +<src:fragref linkend="footnote.number.symbols.frag"></src:fragref> +<src:fragref linkend="formal.procedures.frag"></src:fragref> +<src:fragref linkend="formal.title.placement.frag"></src:fragref> +<src:fragref linkend="funcsynopsis.decoration.frag"></src:fragref> +<src:fragref linkend="funcsynopsis.style.frag"></src:fragref> +<src:fragref linkend="funcsynopsis.tabular.threshold.frag"></src:fragref> +<src:fragref linkend="function.parens.frag"></src:fragref> +<src:fragref linkend="generate.id.attributes.frag"></src:fragref> +<src:fragref linkend="generate.index.frag"></src:fragref> +<src:fragref linkend="generate.legalnotice.link.frag"></src:fragref> +<src:fragref linkend="generate.revhistory.link.frag"></src:fragref> +<src:fragref linkend="generate.manifest.frag"></src:fragref> +<src:fragref linkend="generate.meta.abstract.frag"></src:fragref> +<src:fragref linkend="generate.section.toc.level.frag"></src:fragref> +<src:fragref linkend="generate.toc.frag"></src:fragref> +<src:fragref linkend="glossary.collection.frag"></src:fragref> +<src:fragref linkend="glossentry.show.acronym.frag"></src:fragref> +<src:fragref linkend="glossterm.auto.link.frag"></src:fragref> +<src:fragref linkend="graphic.default.extension.frag"></src:fragref> +<src:fragref linkend="graphicsize.extension.frag"></src:fragref> +<src:fragref linkend="graphicsize.use.img.src.path.frag"></src:fragref> +<src:fragref linkend="header.rule.frag"></src:fragref> +<src:fragref linkend="html.base.frag"></src:fragref> +<src:fragref linkend="html.cellpadding.frag"></src:fragref> +<src:fragref linkend="html.cellspacing.frag"></src:fragref> +<src:fragref linkend="html.cleanup.frag"></src:fragref> +<src:fragref linkend="html.ext.frag"></src:fragref> +<src:fragref linkend="html.extra.head.links.frag"></src:fragref> +<src:fragref linkend="html.head.legalnotice.link.types.frag"></src:fragref> +<src:fragref linkend="html.head.legalnotice.link.multiple.frag"></src:fragref> +<src:fragref linkend="html.longdesc.frag"></src:fragref> +<src:fragref linkend="html.longdesc.link.frag"></src:fragref> +<src:fragref linkend="html.stylesheet.frag"></src:fragref> +<src:fragref linkend="html.stylesheet.type.frag"></src:fragref> +<src:fragref linkend="htmlhelp.alias.file.frag"></src:fragref> +<src:fragref linkend="htmlhelp.autolabel.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.back.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.forward.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.hideshow.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.home.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.home.url.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.jump1.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.jump1.title.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.jump1.url.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.jump2.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.jump2.title.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.jump2.url.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.locate.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.next.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.options.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.prev.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.print.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.refresh.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.stop.frag"></src:fragref> +<src:fragref linkend="htmlhelp.button.zoom.frag"></src:fragref> +<src:fragref linkend="htmlhelp.chm.frag"></src:fragref> +<src:fragref linkend="htmlhelp.default.topic.frag"></src:fragref> +<src:fragref linkend="htmlhelp.display.progress.frag"></src:fragref> +<src:fragref linkend="htmlhelp.encoding.frag"></src:fragref> +<src:fragref linkend="htmlhelp.enhanced.decompilation.frag"></src:fragref> +<src:fragref linkend="htmlhelp.enumerate.images.frag"></src:fragref> +<src:fragref linkend="htmlhelp.force.map.and.alias.frag"></src:fragref> +<src:fragref linkend="htmlhelp.hhc.binary.frag"></src:fragref> +<src:fragref linkend="htmlhelp.hhc.folders.instead.books.frag"></src:fragref> +<src:fragref linkend="htmlhelp.hhc.frag"></src:fragref> +<src:fragref linkend="htmlhelp.hhc.section.depth.frag"></src:fragref> +<src:fragref linkend="htmlhelp.hhc.show.root.frag"></src:fragref> +<src:fragref linkend="htmlhelp.hhc.width.frag"></src:fragref> +<src:fragref linkend="htmlhelp.hhk.frag"></src:fragref> +<src:fragref linkend="htmlhelp.hhp.frag"></src:fragref> +<src:fragref linkend="htmlhelp.hhp.tail.frag"></src:fragref> +<src:fragref linkend="htmlhelp.hhp.window.frag"></src:fragref> +<src:fragref linkend="htmlhelp.hhp.windows.frag"></src:fragref> +<src:fragref linkend="htmlhelp.map.file.frag"></src:fragref> +<src:fragref linkend="htmlhelp.only.frag"></src:fragref> +<src:fragref linkend="htmlhelp.remember.window.position.frag"></src:fragref> +<src:fragref linkend="htmlhelp.show.advanced.search.frag"></src:fragref> +<src:fragref linkend="htmlhelp.show.favorities.frag"></src:fragref> +<src:fragref linkend="htmlhelp.show.menu.frag"></src:fragref> +<src:fragref linkend="htmlhelp.show.toolbar.text.frag"></src:fragref> +<src:fragref linkend="htmlhelp.title.frag"></src:fragref> +<src:fragref linkend="htmlhelp.use.hhk.frag"></src:fragref> +<src:fragref linkend="htmlhelp.window.geometry.frag"></src:fragref> +<src:fragref linkend="img.src.path.frag"></src:fragref> +<src:fragref linkend="id.warnings.frag"></src:fragref> +<src:fragref linkend="index.method.frag"></src:fragref> +<src:fragref linkend="index.on.role.frag"></src:fragref> +<src:fragref linkend="index.on.type.frag"></src:fragref> +<src:fragref linkend="index.number.separator.frag"></src:fragref> +<src:fragref linkend="index.term.separator.frag"></src:fragref> +<src:fragref linkend="index.range.separator.frag"></src:fragref> +<src:fragref linkend="index.prefer.titleabbrev.frag"></src:fragref> +<src:fragref linkend="ignore.image.scaling.frag"></src:fragref> +<src:fragref linkend="inherit.keywords.frag"></src:fragref> +<src:fragref linkend="keep.relative.image.uris.frag"></src:fragref> +<src:fragref linkend="l10n.gentext.default.language.frag"></src:fragref> +<src:fragref linkend="l10n.gentext.language.frag"></src:fragref> +<src:fragref linkend="l10n.gentext.use.xref.language.frag"></src:fragref> +<src:fragref linkend="l10n.lang.value.rfc.compliant.frag"></src:fragref> +<src:fragref linkend="label.from.part.frag"></src:fragref> +<src:fragref linkend="linenumbering.everyNth.frag"></src:fragref> +<src:fragref linkend="linenumbering.extension.frag"></src:fragref> +<src:fragref linkend="linenumbering.separator.frag"></src:fragref> +<src:fragref linkend="linenumbering.width.frag"></src:fragref> +<src:fragref linkend="link.mailto.url.frag"></src:fragref> +<src:fragref linkend="make.graphic.viewport.frag"></src:fragref> +<src:fragref linkend="make.single.year.ranges.frag"></src:fragref> +<src:fragref linkend="make.valid.html.frag"></src:fragref> +<src:fragref linkend="make.year.ranges.frag"></src:fragref> +<src:fragref linkend="manifest.frag"></src:fragref> +<src:fragref linkend="manifest.in.base.dir.frag"></src:fragref> +<src:fragref linkend="manual.toc.frag"></src:fragref> +<src:fragref linkend="menuchoice.menu.separator.frag"></src:fragref> +<src:fragref linkend="menuchoice.separator.frag"></src:fragref> +<src:fragref linkend="navig.graphics.extension.frag"></src:fragref> +<src:fragref linkend="navig.graphics.frag"></src:fragref> +<src:fragref linkend="navig.graphics.path.frag"></src:fragref> +<src:fragref linkend="navig.showtitles.frag"></src:fragref> +<src:fragref linkend="nominal.image.depth.frag"></src:fragref> +<src:fragref linkend="nominal.image.width.frag"></src:fragref> +<src:fragref linkend="nominal.table.width.frag"></src:fragref> +<src:fragref linkend="olink.base.uri.frag"></src:fragref> +<src:fragref linkend="olink.debug.frag"></src:fragref> +<src:fragref linkend="olink.properties.frag"></src:fragref> +<src:fragref linkend="insert.olink.page.number.frag"></src:fragref> +<src:fragref linkend="insert.olink.pdf.frag.frag"></src:fragref> +<src:fragref linkend="prefer.internal.olink.frag"></src:fragref> +<src:fragref linkend="olink.lang.fallback.sequence.frag"></src:fragref> +<src:fragref linkend="olink.doctitle.frag"></src:fragref> +<src:fragref linkend="olink.fragid.frag"></src:fragref> +<src:fragref linkend="olink.outline.ext.frag"></src:fragref> +<src:fragref linkend="olink.pubid.frag"></src:fragref> +<src:fragref linkend="olink.resolver.frag"></src:fragref> +<src:fragref linkend="olink.sysid.frag"></src:fragref> +<src:fragref linkend="para.propagates.style.frag"></src:fragref> +<src:fragref linkend="part.autolabel.frag"></src:fragref> +<src:fragref linkend="phrase.propagates.style.frag"></src:fragref> +<src:fragref linkend="pixels.per.inch.frag"></src:fragref> +<src:fragref linkend="points.per.em.frag"></src:fragref> +<src:fragref linkend="preface.autolabel.frag"></src:fragref> +<src:fragref linkend="preferred.mediaobject.role.frag"></src:fragref> +<src:fragref linkend="process.empty.source.toc.frag"></src:fragref> +<src:fragref linkend="process.source.toc.frag"></src:fragref> +<src:fragref linkend="profile.arch.frag"></src:fragref> +<src:fragref linkend="profile.attribute.frag"></src:fragref> +<src:fragref linkend="profile.condition.frag"></src:fragref> +<src:fragref linkend="profile.conformance.frag"></src:fragref> +<src:fragref linkend="profile.lang.frag"></src:fragref> +<src:fragref linkend="profile.os.frag"></src:fragref> +<src:fragref linkend="profile.revision.frag"></src:fragref> +<src:fragref linkend="profile.revisionflag.frag"></src:fragref> +<src:fragref linkend="profile.role.frag"></src:fragref> +<src:fragref linkend="profile.security.frag"></src:fragref> +<src:fragref linkend="profile.separator.frag"></src:fragref> +<src:fragref linkend="profile.userlevel.frag"></src:fragref> +<src:fragref linkend="profile.value.frag"></src:fragref> +<src:fragref linkend="profile.vendor.frag"></src:fragref> +<src:fragref linkend="punct.honorific.frag"></src:fragref> +<src:fragref linkend="qanda.defaultlabel.frag"></src:fragref> +<src:fragref linkend="qanda.inherit.numeration.frag"></src:fragref> +<src:fragref linkend="qandadiv.autolabel.frag"></src:fragref> +<src:fragref linkend="refentry.generate.name.frag"></src:fragref> +<src:fragref linkend="refentry.generate.title.frag"></src:fragref> +<src:fragref linkend="refentry.separator.frag"></src:fragref> +<src:fragref linkend="refentry.xref.manvolnum.frag"></src:fragref> +<src:fragref linkend="refclass.suppress.frag"></src:fragref> +<src:fragref linkend="root.filename.frag"></src:fragref> +<src:fragref linkend="rootid.frag"></src:fragref> +<src:fragref linkend="runinhead.default.title.end.punct.frag"></src:fragref> +<src:fragref linkend="runinhead.title.end.punct.frag"></src:fragref> +<src:fragref linkend="section.autolabel.frag"></src:fragref> +<src:fragref linkend="section.autolabel.max.depth.frag"></src:fragref> +<src:fragref linkend="section.label.includes.component.label.frag"></src:fragref> +<src:fragref linkend="segmentedlist.as.table.frag"></src:fragref> +<src:fragref linkend="shade.verbatim.frag"></src:fragref> +<src:fragref linkend="shade.verbatim.style.frag"></src:fragref> +<src:fragref linkend="show.comments.frag"></src:fragref> +<src:fragref linkend="show.revisionflag.frag"></src:fragref> +<src:fragref linkend="simplesect.in.toc.frag"></src:fragref> +<src:fragref linkend="spacing.paras.frag"></src:fragref> +<src:fragref linkend="suppress.footer.navigation.frag"></src:fragref> +<src:fragref linkend="suppress.header.navigation.frag"></src:fragref> +<src:fragref linkend="suppress.navigation.frag"></src:fragref> +<src:fragref linkend="table.borders.with.css.frag"></src:fragref> +<src:fragref linkend="table.cell.border.color.frag"></src:fragref> +<src:fragref linkend="table.cell.border.style.frag"></src:fragref> +<src:fragref linkend="table.cell.border.thickness.frag"></src:fragref> +<src:fragref linkend="table.footnote.number.format.frag"></src:fragref> +<src:fragref linkend="table.footnote.number.symbols.frag"></src:fragref> +<src:fragref linkend="table.frame.border.color.frag"></src:fragref> +<src:fragref linkend="table.frame.border.style.frag"></src:fragref> +<src:fragref linkend="table.frame.border.thickness.frag"></src:fragref> +<src:fragref linkend="tablecolumns.extension.frag"></src:fragref> +<src:fragref linkend="target.database.document.frag"></src:fragref> +<src:fragref linkend="targets.filename.frag"></src:fragref> +<src:fragref linkend="textdata.default.encoding.frag"></src:fragref> +<src:fragref linkend="tex.math.delims.frag"></src:fragref> +<src:fragref linkend="tex.math.file.frag"></src:fragref> +<src:fragref linkend="tex.math.in.alt.frag"></src:fragref> +<src:fragref linkend="textinsert.extension.frag"></src:fragref> +<src:fragref linkend="toc.list.type.frag"></src:fragref> +<src:fragref linkend="toc.section.depth.frag"></src:fragref> +<src:fragref linkend="toc.max.depth.frag"></src:fragref> +<src:fragref linkend="ulink.target.frag"></src:fragref> +<src:fragref linkend="use.embed.for.svg.frag"></src:fragref> +<src:fragref linkend="use.extensions.frag"></src:fragref> +<src:fragref linkend="use.id.as.filename.frag"></src:fragref> +<src:fragref linkend="use.local.olink.style.frag"></src:fragref> +<src:fragref linkend="use.role.as.xrefstyle.frag"></src:fragref> +<src:fragref linkend="use.role.for.mediaobject.frag"></src:fragref> +<src:fragref linkend="use.svg.frag"></src:fragref> +<src:fragref linkend="variablelist.as.table.frag"></src:fragref> +<src:fragref linkend="variablelist.term.separator.frag"></src:fragref> +<src:fragref linkend="variablelist.term.break.after.frag"></src:fragref> +<src:fragref linkend="xref.with.number.and.title.frag"></src:fragref> +<src:fragref linkend="xref.label-title.separator.frag"></src:fragref> +<src:fragref linkend="xref.label-page.separator.frag"></src:fragref> +<src:fragref linkend="xref.title-page.separator.frag"></src:fragref> +<src:fragref linkend="insert.xref.page.number.frag"></src:fragref> + +</xsl:stylesheet> + + + + +                   \ No newline at end of file diff --git a/src/documentation/docbook-xsl/html/param.xsl b/src/documentation/docbook-xsl/html/param.xsl new file mode 100644 index 0000000000..0441e69229 --- /dev/null +++ b/src/documentation/docbook-xsl/html/param.xsl @@ -0,0 +1,7157 @@ + + + + + + +admon.graphics.extension +string + +admon.graphics.extension +Extension for admonition graphics + + +Description + +Sets the extension to use on admonition graphics. + + + + + + +admon.graphics.path +string + +admon.graphics.path +Path to admonition graphics + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the admonition graphics. + + + + +images/ + + +admon.graphics +boolean + +admon.graphics +Use graphics in admonitions? + + +Description + +If true (non-zero), admonitions are presented in an alternate style that uses +a graphic. Default graphics are provided in the distribution. + + + + + + + +admon.textlabel +boolean + +admon.textlabel +Use text label in admonitions? + + +Description + +If true (non-zero), admonitions are presented with a generated +text label such as Note or Warning in the appropriate language. +If zero, such labels are turned off, but any title child +of the admonition element are still output. +The default value is 1. + + + + + + + +admon.style +string + +admon.style +CSS style attributes for admonitions + + +Description + +Specifies the value of the STYLE +attribute that should be added to admonitions. + + + + + + margin-left: 0.5in; margin-right: 0.5in; + + + +callout.defaultcolumn +integer + +callout.defaultcolumn +Indicates what column callouts appear in by default + + +Description + +If a callout does not identify a column (for example, if it uses +the linerange unit), +it will appear in the default column. + + + + + + + +callout.graphics.extension +string + +callout.graphics.extension +Extension for callout graphics + + +Description + +Sets the extension to use on callout graphics. + + + + + + +callout.graphics.number.limit +integer + +callout.graphics.number.limit +Number of the largest callout graphic + + +Description + +If callout.graphics +is non-zero, graphics are used to represent +callout numbers. The value of +callout.graphics.number.limit +is +the largest number for which a graphic exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + + + + +callout.graphics.path +string + +callout.graphics.path +Path to callout graphics + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the callout graphics. + + + + + + + +callout.graphics +boolean + +callout.graphics +Use graphics for callouts? + + +Description + +If non-zero, callouts are presented with graphics (e.g., reverse-video +circled numbers instead of "(1)", "(2)", etc.). +Default graphics are provided in the distribution. + + + + + + + +callout.list.table +boolean + +callout.list.table +Present callout lists using a table? + + +Description + +The default presentation of CalloutLists uses +an HTML DL. Some browsers don't align DLs very well +if callout.graphics are used. With this option +turned on, CalloutLists are presented in an HTML +TABLE, which usually results in better alignment +of the callout number with the callout description. + + + + + + +callout.unicode.number.limit +integer + +callout.unicode.number.limit +Number of the largest callout graphic + + +Description + +If callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.number.limit +is +the largest number for which a unicode character exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + + + + +callout.unicode.start.character +integer + +callout.unicode.start.character +First Unicode character to use, decimal value. + + +Description + +If callout.graphics is zero and callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.start.character +is the decimal unicode value used for callout number one. Currently, +only 10102 is supported in the stylesheets for this parameter. + + + + + + + +callout.unicode +boolean + +callout.unicode +Use Unicode characters rather than images for callouts. + + +Description + +The stylesheets can use either an image of the numbers one to ten, or the single Unicode character which represents the numeral, in white on a black background. Use this to select the Unicode character option. + + + + + + + +callouts.extension +boolean + +callouts.extension +Enable the callout extension + + +Description + +The callouts extension processes areaset +elements in ProgramListingCO and other text-based +callout elements. + + + + + + + +ebnf.table.bgcolor +string + +ebnf.table.bgcolor +Background color for EBNF tables + + +Description + +Sets the background color for EBNF tables. No bgcolor +attribute is output if ebnf.table.bgcolor is set to +the null string. The default value matches the value used in recent +online versions of the W3C's XML Spec productions. + + + + + + +ebnf.table.border + + +ebnf.table.border +Selects border on EBNF tables + + +Description + +Selects the border on EBNF tables. If non-zero, the tables have +borders, otherwise they don't. + + + + + + +ebnf.assignment +rtf + +ebnf.assignment +The EBNF production assignment operator + + +Description + +The ebnf.assignment parameter determines what +text is used to show assignment in productions +in productionsets. + +While ::= is common, so are several +other operators. + + + + +::= + + + + +ebnf.statement.terminator +rtf + +ebnf.statement.terminator +Punctuation that ends an EBNF statement. + + +Description + +The ebnf.statement.terminator parameter determines what +text is used to terminate each production +in productionset. + +Some notations end each statement with a period. + + + + + + + +annotate.toc +boolean + +annotate.toc +Annotate the Table of Contents? + + +Description + +If true, TOCs will be annotated. At present, this just means +that the RefPurpose of RefEntry +TOC entries will be displayed. + + + + + + + +autotoc.label.separator +string + +autotoc.label.separator +Separator between labels and titles in the ToC + + +Description + +String to use to seperate labels and title in a table of contents. + + + + + + +autotoc.label.in.hyperlink +boolean + +autotoc.label.in.hyperlink +Include lable in hyperlinked titles in TOC? + + +Description + +If the value of +autotoc.label.in.hyperlink is non-zero, labels +are included in hyperlinked titles in the TOC. If it is instead zero, +labels are still displayed prior to the hyperlinked titles, but +are not hyperlinked along with the titles. + + + + + + +process.source.toc +boolean + +process.source.toc +Process a non-empty toc element if it occurs in a source document? + + +Description + +Specifies that the contents of a non-empty "hard-coded" +toc element in a source document are processed to +generate a TOC in output. + + This parameter has no effect on automated generation of + TOCs. An automated TOC may still be generated along with the + "hard-coded" TOC. To suppress automated TOC generation, adjust the + value of the generate.toc paramameter. + + The process.source.toc parameter also has + no effect if the toc element is empty; handling + for empty toc is controlled by the + process.empty.source.toc parameter. + + + + + + + + +process.empty.source.toc +boolean + +process.empty.source.toc +Generate automated TOC if toc element occurs in a source document? + + +Description + +Specifies that if an empty toc element is +found in a source document, an automated TOC is generated. + + Depending on what the value of the + generate.toc parameter is, setting this + parameter to 1 could result in generation of + duplicate automated TOCs. So the + process.empty.source.toc is primarily useful + as an "override": by placing an empty toc in your + document and setting this parameter to 1, you can + force a TOC to be generated even if generate.toc + says not to. + + + + + + + + +bridgehead.in.toc +boolean + +bridgehead.in.toc +Should bridgehead elements appear in the TOC? + + +Description + +If non-zero, bridgeheads appear in the TOC. Note that this option +is not fully supported and may be removed in a future version of the +stylesheets. + + + + + + + +simplesect.in.toc +boolean + +simplesect.in.toc +Should simplesect elements appear in the TOC? + + +Description + +If non-zero, simplesects appear in the TOC. + + + + + + + +manual.toc +string + +manual.toc +An explicit TOC to be used for the TOC + + +Description + +The manual.toc identifies an explicit TOC that +will be used for building the printed TOC. + + + + + + + +toc.list.type +list +dl +ul +ol + +toc.list.type +Type of HTML list element to use for Tables of Contents + + +Description + +When an automatically generated Table of Contents (or List of Titles) +is produced, this HTML element will be used to make the list. + + + + +dl + + +toc.section.depth +integer + +toc.section.depth +How deep should recursive sections appear +in the TOC? + + +Description + +Specifies the depth to which recursive sections should appear in the +TOC. + + + + +2 + + +toc.max.depth +integer + +toc.max.depth +How maximaly deep should be each TOC? + + +Description + +Specifies the maximal depth of TOC on all levels. + + + +8 + + +generate.toc +table + +generate.toc +Control generation of ToCs and LoTs + + +Description + +This parameter has a structured value. It is a table of space-delimited +path/value pairs. Each path identifies some element in the source document +using a restricted subset of XPath (only the implicit child axis, no wildcards, +no predicates). Paths can be either relative or absolute. + +When processing a particular element, the stylesheets consult this table to +determine if a ToC (or LoT(s)) should be generated. + +For example, consider the entry: + +book toc,figure + +This indicates that whenever a book is formatted, a +Table Of Contents and a List of Figures should be generated. Similarly, + +/chapter toc + +indicates that whenever a document that has a root +of chapter is formatted, a Table of +Contents should be generated. The entry chapter would match +all chapters, but /chapter matches only chapter +document elements. + +Generally, the longest match wins. So, for example, if you want to distinguish +articles in books from articles in parts, you could use these two entries: + +book/article toc,figure +part/article toc + +Note that an article in a part can never match a book/article, +so if you want nothing to be generated for articles in parts, you can simply leave +that rule out. + +If you want to leave the rule in, to make it explicit that you're turning +something off, use the value nop. For example, the following +entry disables ToCs and LoTs for articles: + +article nop + +Do not simply leave the word article in the file +without a matching value. That'd be just begging the silly little +path/value parser to get confused. + +Section ToCs are further controlled by the +generate.section.toc.level parameter. +For a given section level to have a ToC, it must have both an entry in +generate.toc and be within the range enabled by +generate.section.toc.level. + + + +appendix toc,title +article/appendix nop +article toc,title +book toc,title,figure,table,example,equation +chapter toc,title +part toc,title +preface toc,title +qandadiv toc +qandaset toc +reference toc,title +sect1 toc +sect2 toc +sect3 toc +sect4 toc +sect5 toc +section toc +set toc,title + + + + +generate.section.toc.level +integer + +generate.section.toc.level +Control depth of TOC generation in sections + + +Description + +The generate.section.toc.level parameter +controls the depth of section in which TOCs will be generated. Note +that this is related to, but not the same as +toc.section.depth, which controls the depth to +which TOC entries will be generated in a given TOC. +If, for example, generate.section.toc.level +is 3, TOCs will be generated in first, second, and third +level sections, but not in fourth level sections. + + + + + + + +generate.index +boolean + +generate.index +Do you want an index? + + +Description + +Specify if an index should be generated. + + + + + + +index.method +string + +index.method +Select method used to group index entries in an index + + +Description + +This parameter lets you select which method should be +used to sort and group index entries in an index. +Indexes in languages that have accented characters typically +sort together accented words and unaccented words. +So Á (A acute) would sort together +with A, so both would appear in the A +section of the index. + + +The default indexing method does not sort accented characters this way. +Words that start with an accented character will instead appear in the +Symbols section of the index. +As such, the default method is only suitable for +English and other unaccented languages. +The other indexing methods require extensions of one type or +another, which is why there are not used by default. + +The three choices for indexing method are: + + +english + + +(default) Sort and groups words based only on the Latin alphabet. +Accented words and words in non-Latin alphabets will be +put in the Symbols section of the index. + + + + +kosek + + +Sort and groups words based on letter groups configured in +the DocBook locale file for the given language. +For example, the French locale file is common/fr.xml. +This method requires support for EXSLT extensions in +the XSL processor. It also requires support for using +user-defined functions in xsl:key (xsltproc does not). + +This method is suitable for any language for which you can +list all the individual characters that should appear +in each letter group in an index. +It is probably not practical to use it for ideographic languages +such as Chinese that have hundreds or thousands of characters. + +To use this method, your customization must set this +parameter and import an additional stylesheet module: +<xsl:import href="[path-to-stylesheets]/common/autoidx-ng.xsl"/> +<xsl:param name="index.method">kosek</xsl:param> + + +The stylesheet module defines functions and adds an xsl:key +used by the method. + + + + +kimber + + +This method uses extensions to the Saxon processor to implement +sophisticated indexing processes. It uses its own +configuration file, which can include information for any number of +languages. Each language's configuration can group +words using either an +enumerated method similar to the kosek method, or it can +designate the first character in each group when viewed in sort order. +The latter configuration is useful for ideographic languages +such as Chinese, Japanese, and Korean. +You can also define your own collation algorithms and where you +want Latin-alphabet words sorted. + + +For a whitepaper describing the extensions, see: +. + + + +To download the extension library, see +. + + + + +To use this method, you must: + + + +Use Saxon as your XSLT processor. + + + +Install and configure the Innodata Isogen library, using +the documentation that comes with it. + + + +Set this parameter's value to kimber. + + + +Import the index extensions stylesheet module +common/autoidx-ng.xsl into your +customization. + + + + + + + + + + + + + +index.on.type +boolean + +index.on.type +Select indexterms based on type +attribute value + + +Description + + +If non-zero, +then an index element that has a +type attribute +value will contain only those indexterm +elements with a matching type attribute value. +If an index has no type +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + + +If index.on.type is zero, then the +type attribute has no effect +on selecting indexterms for an index. + + +For those using DocBook version 4.2 or earlier, +the type attribute is not available +for index terms. However, you can achieve the same +effect by using the role attribute +in the same manner on indexterm +and index, and setting the stylesheet parameter +index.on.role to a nonzero value. + + + + + + + +index.on.role +boolean + +index.on.role +Select indexterms based on role value + + +Description + + +If non-zero, +then an index element that has a +role attribute +value will contain only those indexterm +elements with a matching role value. +If an index has no role +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + +If index.on.role is zero, then the +role attribute has no effect +on selecting indexterms for an index. + + +If you are using DocBook version 4.3 or later, you should +use the type attribute instead of role +on indexterm and index, +and set the index.on.type to a nonzero +value. + + + + + + + +index.prefer.titleabbrev +boolean + +index.prefer.titleabbrev +Should be abbreviated titles used as back references + + +Description + +FIXME: + + + + + + + +index.term.separator +string + +index.term.separator +Override for punctuation separating an index term +from its list of page references in an index + + +Description + +This parameter permits you to override +the text to insert between +the end of an index term and its list of page references. +Typically that might be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'term-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +fill in the content for this normally empty +override parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. +For fo output, it could be an fo:leader +element to provide space of a specific length, or a dot leader. + + + + + + + +index.number.separator +string + +index.number.separator +Override for punctuation separating page numbers in index + + +Description + +This parameter permits you to override the text to insert between +page references in a formatted index entry. Typically +that would be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'number-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. This punctuation appears between +such section titles in an HTML index. + + + + + + + +index.range.separator +string + +index.range.separator +Override for punctuation separating the two numbers +in a page range in index + + +Description + +This parameter permits you +to override the text to insert between +the two numbers of a page range in an index. +This parameter is only used by those XSL-FO processors +that support an extension for generating such page ranges +(such as XEP). + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'range-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. So there are no page ranges +and this parameter has no effect. + + + + + + + +linenumbering.everyNth +integer + +linenumbering.everyNth +Indicate which lines should be numbered + + +Description + +If line numbering is enabled, everyNth line will be numbered. + + + + + + + +linenumbering.extension +boolean + +linenumbering.extension +Enable the line numbering extension + + +Description + +If true, verbatim environments (elements that have the +format='linespecific' notation attribute: address, literallayout, +programlisting, screen, synopsis) that specify line numbering will +have, surprise, line numbers. + + + + + + + +linenumbering.separator +string + +linenumbering.separator +Specify a separator between line numbers and lines + + +Description + +The separator is inserted between line numbers and lines in +the verbatim environment. + + + + + + + +linenumbering.width +integer + +linenumbering.width +Indicates the width of line numbers + + +Description + +If line numbering is enabled, line numbers will appear right +justified in a field "width" characters wide. + + + + + + + +tablecolumns.extension +boolean + +tablecolumns.extension +Enable the table columns extension function + + +Description + +The table columns extension function adjusts the widths of table +columns in the HTML result to more accurately reflect the specifications +in the CALS table. + + + + + + + +textinsert.extension +boolean + +textinsert.extension +Enable the textinsert extension element + + +Description + +The textinsert extension element inserts the contents of a +a file into the result tree (as text). + + + + + + + +textdata.default.encoding +string + +textdata.default.encoding +Default encoding of external text files which are included +using textdata element + + +Description + +Default encoding of external text files which are included using +textdata element. This value is used only when you do not specify +encoding by appropriate attribute directly on textdata. Default +encoding (empty string) is interpreted as system default +encoding. + + + + + + +graphicsize.extension +boolean + +graphicsize.extension +Enable the getWidth()/getDepth() extension functions + + +Description + +If non-zero (and if use.extensions is non-zero +and if you're using a processor that supports extension functions), the +getWidth and getDepth functions +will be used to extract image sizes from graphics. + + + + + + +graphicsize.use.img.src.path +boolean + +graphicsize.use.img.src.path +Prepend img.src.path before +filenames passed to extension functions + + +Description + +If non-zero img.src.path parameter will +be appended before filenames passed to extension functions for +measuring image dimensions. + + + + + + +use.extensions +boolean + +use.extensions +Enable extensions + + +Description + +If non-zero, extensions may be used. Each extension is +further controlled by its own parameter. But if +use.extensions is zero, no extensions will +be used. + + + + + + + +chapter.autolabel +boolean + +chapter.autolabel +Specifies the labeling format for Chapter titles + + +Description + +If zero, then chapters will not be numbered. +Otherwise chapters will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + + + + +appendix.autolabel +boolean + +appendix.autolabel +Specifies the labeling format for Appendix titles + + +Description + +If zero, then appendices will not be numbered. +Otherwise appendices will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperalpha). + + + + + + + +part.autolabel +boolean + +part.autolabel +Specifies the labeling format for Part titles + + +Description + +If zero, then parts will not be numbered. +Otherwise parts will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperroman). + + + + + + + + +preface.autolabel +boolean + +preface.autolabel +Specifices the labeling format for Preface titles + + +Description + +If zero (default), then prefaces will not be numbered. +Otherwise prefaces will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + + + + + +qandadiv.autolabel +boolean + +qandadiv.autolabel +Are divisions in QAndASets enumerated? + + +Description + +If true (non-zero), unlabeled qandadivs will be enumerated. + + + + + + + +section.autolabel +boolean + +section.autolabel +Are sections enumerated? + + +Description + +If true (non-zero), unlabeled sections will be enumerated. + + + + + + + +section.autolabel.max.depth +integer + +section.autolabel.max.depth +The deepest level of sections that are numbered. + + +Description + +When section numbering is turned on by the +section.autolabel parameter, +then this parameter controls the depth of section nesting +that is numbered. +Sections nested to a level deeper than this value will +not be numbered. + + + + + + + +section.label.includes.component.label +boolean + +section.label.includes.component.label +Do section labels include the component label? + + +Description + +If true (non-zero), section labels are prefixed with the label of the +component that contains them. + + + + + + + +label.from.part +boolean + +label.from.part +Renumber chapters in each part? + + +Description + +If label.from.part is non-zero, components +(chapters, appendixes, etc.) +will be numbered from 1 in each part. Otherwise, +they will be numbered monotonically throughout each +book. + + + + + + + +component.label.includes.part.label +boolean + +component.label.includes.part.label +Do component labels include the part label? + + +Description + +If true (non-zero), number labels for chapters, appendices, and other component +elements are prefixed with the label of the +part element that contains them. +So you might see Chapter II.3 instead of Chapter 3. +Also, the labels for formal elements such as table and figure will +include the part label. +If there is no part element container, then no prefix is generated. + + +This feature is most useful when the +label.from.part parameter is turned on. +In that case, there would be more than one chapter +1, and the extra part label prefix will identify +each chapter unambiguously. + + + + + + + +html.base +uri + +html.base +An HTML base URI + + +Description + +If html.base is set, it is used for the BASE +element in the HEAD of the HTML documents. +This is useful for dynamically served HTML where the base URI needs +to be shifted. + + + + + + +html.stylesheet.type +string + +html.stylesheet.type +The type of the stylesheet used in the generated HTML + + +Description + +The type of the stylesheet to place in the HTML link tag. + + + + +text/css + + +html.stylesheet +string + +html.stylesheet +Name of the stylesheet(s) to use in the generated HTML + + +Description + +The html.stylesheet parameter is either empty, +indicating that no stylesheet LINK tag should be generated +in the HTML output, or it is a list of one or more stylesheets. + +Multiple stylesheets are space-delimited. If you need to +reference a stylesheet URI that includes a space, encode it with +%20. A seprate HTML LINK element will +be generated for each stylesheet in the order they are listed in the +parameter. + + + + + + +css.decoration +boolean + +css.decoration +Enable CSS decoration of elements + + +Description + + +If css.decoration is turned on, then HTML elements +produced by the +stylesheet may be decorated with STYLE attributes. For example, the +LI tags produced for list items may include a fragment of CSS in the +STYLE attribute which sets the CSS property "list-style-type". + + + + + + + +spacing.paras +boolean + +spacing.paras +Insert additional <p> elements for spacing? + + +Description + +When non-zero, additional, empty paragraphs are inserted in +several contexts (for example, around informal figures), to create a +more pleasing visual appearance in many browsers. + + + + + + + +emphasis.propagates.style +boolean + +emphasis.propagates.style +Pass emphasis role attribute through to HTML? + + +Description + +If true, the role attribute of emphasis elements +will be passed through to the HTML as a class attribute on a +span that surrounds the emphasis. + + + + + + +para.propagates.style +boolean + +para.propagates.style +Pass para role attribute through to HTML? + + +Description + +If true, the role attribute of para elements +will be passed through to the HTML as a class attribute on the +p generated for the paragraph. + + + + + + +phrase.propagates.style +boolean + +phrase.propagates.style +Pass phrase role attribute through to HTML? + + +Description + +If true, the role attribute of phrase elements +will be passed through to the HTML as a class attribute on a +span that surrounds the phrase. + + + + + + +entry.propagates.style +boolean + +entry.propagates.style +Pass entry role attribute through to HTML? + + +Description + +If true, the role attribute of entry elements +will be passed through to the HTML as a class attribute on the +td or th generated for the table +cell. + + + + + + +html.longdesc +boolean + +html.longdesc +Should longdesc URIs be created? + + +Description + +If non-zero, HTML files will be created for the +longdesc attribute. These files +are created from the textobjects in +mediaobjects and +inlinemediaobject. + + + + + + + +html.longdesc.link +boolean + +html.longdesc.link +Should a link to the longdesc be included in the HTML? + + +Description + +If non-zero, links will be created to the +HTML files created for the +longdesc attribute. It makes no +sense to turn enable this option without also enabling the +$html.longdesc parameter. + +The longdesc.link named template is called +to construct the link. + + + + + + +make.valid.html +boolean + +make.valid.html +Attempt to make sure the HTML output is valid HTML + + +Description + +If make.valid.html is true, the stylesheets take +extra effort to ensure that the resulting HTML is valid. This may mean that some +para tags are translated into HTML divs or +that other substitutions occur. + +This parameter is different from html.cleanup +because it changes the resulting markup; it does not use extension functions +to manipulate result-tree-fragments and is therefore applicable to any +XSLT processor. + + + + + + +html.cleanup +boolean + +html.cleanup +Attempt to clean up the resulting HTML? + + +Description + +If non-zero, and if the EXSLT +extensions are supported by your processor, the resulting HTML will be +cleaned up. This improves the chances that the +resulting HTML will be valid. It may also improve the formatting of +some elements. + +This parameter is different from make.valid.html +because it uses extension functions to manipulate result-tree-fragments. + + + + + + +draft.mode +list + +draft.mode +Select draft mode + + +Description + +Selects draft mode. If draft.mode is +yes, the entire document will be treated +as a draft. If it is no, the entire document +will be treated as a final copy. If it is maybe, +individual sections will be treated as draft or final independently, depending +on how their status attribute is set. + + + + + + + +draft.watermark.image +uri + +draft.watermark.image +The URI of the image to be used for draft watermarks + + +Description + +The image to be used for draft watermarks. + + + + + + +generate.id.attributes + + +generate.id.attributes + + + +Description + +If non-zero, the HTML stylesheet will generate ID attributes on +containers. For example, the markup: + +<section id="foo"><title>Some Title</title> +<para>Some para.</para> +</section> + +might produce: + +<div class="section" id="foo"> +<h2>Some Title</h2> +<p>Some para.</p> +</div> + +The alternative is to generate anchors: + +<div class="section"> +<h2><a name="foo"></a>Some Title</h2> +<p>Some para.</p> +</div> + +Because the name attribute of +the a element and the id +attribute of other tags are both of type ID, producing both +generates invalid documents. + +As of version 1.50, you can use this switch to control which type of +identifier is generated. For backwards-compatibility, generating +a anchors is preferred. + +Note: at present, this switch is incompletely implemented. +Disabling ID attributes will suppress them, but enabling ID attributes +will not suppress the anchors. + + + + + + +generate.meta.abstract +boolean + +generate.meta.abstract +Generate HTML META element from abstract? + + +Description + +If non-zero, document abstracts will be reproduced in the HTML +HEAD with meta name="description" content="...". + + + + + + +rootid +string + +rootid +Specify the root element to format + + +Description + +If rootid is specified, it must be the +value of an ID that occurs in the document being formatted. The entire +document will be loaded and parsed, but formatting will begin at the +element identified, rather than at the root. For example, this allows +you to process only chapter 4 of a book. +Because the entire document is available to the processor, automatic +numbering, cross references, and other dependencies are correctly +resolved. + + + + + + +suppress.navigation +boolean + +suppress.navigation +Disable header and footer navigation + + +Description + + +If suppress.navigation is turned on, header and +footer navigation will be suppressed. + + + +0 + + +suppress.header.navigation +boolean + +suppress.header.navigation +Disable header navigation + + +Description + + +If suppress.header.navigation is turned on, header +navigation will be suppressed. + + + +0 + + +suppress.footer.navigation +boolean + +suppress.footer.navigation +Disable footer navigation + + +Description + + +If suppress.footer.navigation is turned on, footer +navigation will be suppressed. + + + +0 + + +header.rule +boolean + +header.rule +Rule under headers? + + +Description + +If non-zero, a rule will be drawn below the page headers. + + + + + + +footer.rule +boolean + +footer.rule +Rule over footers? + + +Description + +If non-zero, a rule will be drawn above the page footers. + + + + + + +id.warnings +boolean + +id.warnings +Should warnings be generated for titled elements without IDs? + + +Description + +If non-zero, the stylesheet will issue a warning for +any element (other than the root element) which +has a title but does not have an ID. + + + + + + +inherit.keywords +boolean + +inherit.keywords +Inherit keywords from ancestor elements? + + +Description + +If inherit.keywords +is non-zero, the keyword META for each HTML +HEAD element will include all of the keywords from +ancestral elements. Otherwise, only the keywords from the current section +will be used. + + + + + + + +make.single.year.ranges +boolean + +make.single.year.ranges +Print single-year ranges (e.g., 1998-1999) + + +Description + +If non-zero, year ranges that span a single year will be printed +in range notation (1998-1999) instead of discrete notation +(1998, 1999). + + + + + + +make.year.ranges +boolean + +make.year.ranges +Collate copyright years into ranges? + + +Description + +If non-zero, copyright years will be collated into ranges. + + + + + + +author.othername.in.middle +boolean + +author.othername.in.middle +Is othername in author a +middle name? + + +Description + +If true (non-zero), the othername of an author +appears between the firstname and +surname. Otherwise, othername +is suppressed. + + + + + + + +generate.legalnotice.link +boolean + +generate.legalnotice.link +Write legalnotice to separate chunk and generate link? + + +Description + +If the value of generate.legalnotice.link +is non-zero, the stylesheet: + + + + writes the contents of legalnotice to a separate + HTML file + + + inserts a hyperlink to the legalnotice file + + + adds (in the HTML head) either a single + link or element or multiple + link elements (depending on the value of the + html.head.legalnotice.link.multiple + parameter), with the value or values derived from the + html.head.legalnotice.link.types + parameter + + + + Otherwise, if generate.legalnotice.link is + zero, legalnotice contents are rendered on the title + page. + + + + + + +generate.revhistory.link +boolean + +generate.revhistory.link +Write revhistory to separate chunk and generate link? + + +Description + +If non-zero, the contents of revhistory are written +to a separate HTML file and a link to the file is +generated. Otherwise, revhistory contents are rendered on +the title page. + + + + + + +html.head.legalnotice.link.types +string + +html.head.legalnotice.link.types +Specifies link types for legalnotice link in html head + + +Description + +The value of +html.head.legalnotice.link.types is a +space-separated list of link types, as described in Section 6.12 +of the HTML 4.01 specification. If the value of the +generate.legalnotice.link parameter is +non-zero, then the stylesheet generates (in the +head section of the HTML source) either a single +HTML link element or, if the value of the +html.head.legalnotice.link.multiple is +non-zero, one link element for each link type +specified. Each link has the following attributes: + + + + a rel attribute whose + value is derived from the value of + html.head.legalnotice.link.types + + + an href attribute whose + value is set to the URL of the file containing the + legalnotice + + + a title attribute whose + value is set to the title of the corresponding + legalnotice (or a title programatically + determined by the stylesheet) + + + +For example: + + <link rel="license" href="ln-id2524073.html" title="Legal Notice"> + + + + About the default value + In an ideal world, the default value of + html.head.legalnotice.link.types would + probably be “license”, since the content of the + DocBook legalnotice is typically license + information, not copyright information. However, the default value + is “copyright” for pragmatic reasons: because + that’s among the set of “recognized link types” listed in Section + 6.12 of the HTML 4.01 specification, and because certain + browsers and browser extensions are preconfigured to recognize that + value. + + + + +copyright + + +html.head.legalnotice.link.multiple +boolean + +html.head.legalnotice.link.multiple +Generate multiple link instances in html head for legalnotice? + + +Description + +If html.head.legalnotice.link.multiple is +non-zero and the value of +html.head.legalnotice.link.types contains +multiple link types, then the stylesheet generates (in the +head section of the HTML source) one +link element for each link type specified. For +example, if the value of +html.head.legalnotice.link.types is +“copyright license”: + + <link rel="copyright" href="ln-id2524073.html" title="Legal Notice"> + <link rel="license" href="ln-id2524073.html" title="Legal Notice"> + + Otherwise, the stylesheet generates generates a single + link instance; for example: + + <link rel="copyright license" href="ln-id2524073.html" title="Legal Notice"> + + + + + + + +funcsynopsis.decoration +boolean + +funcsynopsis.decoration +Decorate elements of a FuncSynopsis? + + +Description + +If true (non-zero), elements of the FuncSynopsis will be decorated (e.g. bold or +italic). The decoration is controlled by functions that can be redefined +in a customization layer. + + + + + + + +funcsynopsis.style +list +ansi +kr + +funcsynopsis.style +What style of 'FuncSynopsis' should be generated? + + +Description + +If funcsynopsis.style is ansi, +ANSI-style function synopses are generated for a +funcsynopsis, otherwise K&R-style +function synopses are generated. + + + + +kr + + +funcsynopsis.tabular.threshold +integer + +funcsynopsis.tabular.threshold +Width beyond which a tabular presentation will be used + + +Description + +If funcsynopsis.tabular.threshold is greater than +zero then if a funcprototype is wider than the threshold +value, it will be presented in a table. + + + + + + +function.parens +boolean + +function.parens +Generate parens after a function? + + +Description + +If not 0, the formatting of +a function element will include +generated parenthesis. + + + + +0 + + +refentry.generate.name +boolean + +refentry.generate.name +Output NAME header before 'RefName'(s)? + + +Description + +If true (non-zero), a "NAME" section title is output before the list +of 'RefName's. This parameter and +refentry.generate.title are mutually +exclusive. This means that if you change this parameter to zero, you +should set refentry.generate.title to 1 unless +you want get quite strange output. + + + + + + + +refentry.generate.title +boolean + +refentry.generate.title +Output title before 'RefName'(s)? + + +Description + +If true (non-zero), the reference page title or first name is +output before the list of 'RefName's. This parameter and +refentry.generate.name are mutually exclusive. +This means that if you change this parameter to 1, you +should set refentry.generate.name to 0 unless +you want get quite strange output. + + + + + + + +refentry.xref.manvolnum +boolean + +refentry.xref.manvolnum +Output manvolnum as part of +refentry cross-reference? + + +Description + +if true (non-zero), the manvolnum is used when cross-referencing +refentrys, either with xref +or citerefentry. + + + + + + + +citerefentry.link +boolean + +citerefentry.link +Generate URL links when cross-referencing RefEntrys? + + +Description + +If true, a web link will be generated, presumably +to an online man->HTML gateway. The text of the link is +generated by the generate.citerefentry.link template. + + + + + + + +refentry.separator +boolean + +refentry.separator +Generate a separator between consecutive RefEntry elements? + + +Description + +If true, a separator will be generated between consecutive +reference pages. + + + + + + + +refclass.suppress +boolean + +refclass.suppress +Suppress display of refclass contents? + + +Description + +If the value of refclass.suppress is +non-zero, then display of refclass contents is +suppressed in output. + + + + + + +default.table.width +length + +default.table.width +The default width of tables + + +Description + +If specified, this value will be used for the WIDTH attribute on +tables that do not specify an alternate width (with the dbhtml processing +instruction). + + + + + + +nominal.table.width +length + +nominal.table.width +The (absolute) nominal width of tables + + +Description + +In order to convert CALS column widths into HTML column widths, it +is sometimes necessary to have an absolute table width to use for conversion +of mixed absolute and relative widths. This value must be an absolute +length (not a percentag). + + + + + + +table.borders.with.css +boolean + +table.borders.with.css +Use CSS to specify table, row, and cell borders? + + +Description + +If true (non-zero), CSS will be used to draw table borders. + + + + + + + +table.cell.border.style + + +table.cell.border.style + + + +Description + +FIXME: + + + + + + +table.cell.border.thickness + + +table.cell.border.thickness + + + +Description + +FIXME: + + + + + + +table.cell.border.color + + +table.cell.border.color + + + +Description + +FIXME: + + + + + + + +table.frame.border.style + + +table.frame.border.style + + + +Description + +FIXME: + + + + + + +table.frame.border.thickness + + +table.frame.border.thickness +Specifies the thickness of the frame border + + +Description + +Specifies the thickness of the border on the table's frame. + + + + + + +table.frame.border.color + + +table.frame.border.color + + + +Description + +FIXME: + + + + + + + +default.table.frame +string + +default.table.frame +The default framing of tables + + +Description + +This value will be used when there is no frame attribute on the table. + + + + + + +html.cellspacing +integer + +html.cellspacing +Default value for cellspacing in HTML tables + + +Description + +If specified, this value will be used as the default cellspacing value +in HTML tables. + + + + + + +html.cellpadding +integer + +html.cellpadding +Default value for cellpadding in HTML tables + + +Description + +If specified, this value will be used as the default cellpadding value +in HTML tables. + + + + + + +qanda.defaultlabel +boolean + +qanda.defaultlabel +Sets the default for defaultlabel on QandASet. + + +Description + +If no defaultlabel attribute is specified on a QandASet, this +value is used. It must be one of the legal values for the defaultlabel +attribute. + + + + +number + + +qanda.inherit.numeration +boolean + +qanda.inherit.numeration +Does enumeration of QandASet components inherit the numeration of parent elements? + + +Description + +If true (non-zero), numbered QandADiv elements and Questions and Answers inherit +the numeration of the ancestors of the QandASet. + + + + + + + +target.database.document +uri + +target.database.document +Name of master database file for resolving +olinks + + +Description + +To resolve olinks between documents, the stylesheets use +a master database document that identifies the target datafiles for all the documents within the scope +of the olinks. This parameter value is the URI of +the master document to be read during processing to resolve olinks. +The default value is olinkdb.xml. +The data structure of the file is defined in the targetdatabase.dtd DTD. The database file provides the high level elements to record the identifiers, locations, and relationships of documents. The cross reference data for individual documents is generally pulled into the database using system entity references or XIncludes. See also targets.filename. + + + + + + + +targets.filename +string + +targets.filename +Name of cross reference targets data file + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter lets you change the name of the generated +file from the default name target.db. +The name must agree with that used in the target database +used to resolve olinks during processing. +See also target.database.document. + + + + + + +olink.base.uri +uri + +olink.base.uri +Base URI used in olink hrefs + + +Description +When cross reference data is collected for resolving olinks, it may be necessary to prepend a base URI to each target's href. This parameter lets you set that base URI when cross reference data is collected. This feature is needed when you want to link to a document that is processed without chunking. The output filename for such a document is not known to the XSL stylesheet; the only target information consists of fragment identifiers such as #idref. To enable the resolution of olinks between documents, you should pass the name of the HTML output file as the value of this parameter. Then the hrefs recorded in the cross reference data collection look like outfile.html#idref, which can be reached as links from other documents. + + + + + +use.local.olink.style +boolean + +use.local.olink.style +Process olinks using xref style of current +document + + +Description +When cross reference data is collected for use by olinks, the data for each potential target includes one field containing a completely assembled cross reference string, as if it were an xref generated in that document. Other fields record the separate title, number, and element name of each target. When an olink is formed to a target from another document, the olink resolves to that preassembled string by default. If the use.local.olink.style parameter is set to non-zero, then instead the cross +reference string is formed again from the target title, number, and +element name, using the stylesheet processing the targeting document. +Then olinks will match the xref style in the targeting document +rather than in the target document. If both documents are processed +with the same stylesheet, then the results will be the same. + + + + + +current.docid +string + +current.docid +targetdoc identifier for the document being +processed + + +Description +When olinks between documents are resolved for HTML output, the stylesheet can compute the relative path between the current document and the target document. The stylesheet needs to know the targetdoc identifiers for both documents, as they appear in the target.database.document database file. This parameter passes to the stylesheet +the targetdoc identifier of the current document, since that +identifier does not appear in the document itself. +This parameter can also be used for print output. If an olink's targetdoc id differs from the current.docid, then the stylesheet can append the target document's title to the generated olink text. That identifies to the reader that the link is to a different document, not the current document. See also olink.doctitle to enable that feature. + + + + + +olink.doctitle +string + +olink.doctitle +show the document title for external olinks? + + + +Description +When olinks between documents are resolved, the generated text +may not make it clear that the reference is to another document. +It is possible for the stylesheets to append the other document's +title to external olinks. For this to happen, two parameters must +be set. + + +This olink.doctitle parameter +should be set to either yes or maybe +to enable this feature. + + + +And you should also set the current.docid +parameter to the document id for the document currently +being processed for output. + + + + + +Then if an olink's targetdoc id differs from +the current.docid value, the stylesheet knows +that it is a reference to another document and can +append the target document's +title to the generated olink text. + +The text for the target document's title is copied from the +olink database from the ttl element +of the top-level div for that document. +If that ttl element is missing or empty, +no title is output. + + +The supported values for olink.doctitle are: + + + +yes + + +Always insert the title to the target document if it is not +the current document. + + + + +no + + +Never insert the title to the target document, even if requested +in an xrefstyle attribute. + + + + +maybe + + +Only insert the title to the target document, if requested +in an xrefstyle attribute. + + + + +An xrefstyle attribute +may override the global setting for individual olinks. +The following values are supported in an +xrefstyle +attribute using the select: syntax: + + + + +docname + + +Insert the target document name for this olink using the +docname gentext template, but only +if the value of olink.doctitle +is not no. + + + + +docnamelong + + +Insert the target document name for this olink using the +docnamelong gentext template, but only +if the value of olink.doctitle +is not no. + + + + +nodocname + + +Omit the target document name even if +the value of olink.doctitle +is yes. + + + + +Another way of inserting the target document name +for a single olink is to employ an +xrefstyle +attribute using the template: syntax. +The %o placeholder (the letter o, not zero) +in such a template +will be filled in with the target document's title when it is processed. +This will occur regardless of +the value of olink.doctitle. + +Note that prior to version 1.66 of the XSL stylesheets, +the allowed values for this parameter were 0 and 1. Those +values are still supported and mapped to 'no' and 'yes', respectively. + + + + + + +olink.debug +boolean + +olink.debug +Turn on debugging messages for olinks + + +Description + +If non-zero, then each olink will generate several +messages about how it is being resolved during processing. +This is useful when an olink does not resolve properly +and the standard error messages are not sufficient to +find the problem. + + +You may need to read through the olink XSL templates +to understand the context for some of the debug messages. + + + + + + + +olink.properties +Properties associated with the cross-reference +text of an olink. + + +Description + +This attribute set is used on cross reference text +from an olink. It is not applied to the +optional page number or +optional title of the external document. + + + + + + + +olink.lang.fallback.sequence +string + +olink.lang.fallback.sequence +look up translated documents if olink not found? + + + +Description + +This parameter defines a list of lang values +to search among to resolve olinks. + + +Normally an olink tries to resolve to a document in the same +language as the olink itself. The language of an olink +is determined by its nearest ancestor element with a +lang attribute, otherwise the +value of the l10n.gentext.default.lang +parameter. + + +An olink database can contain target data for the same +document in multiple languages. Each set of data has the +same value for the targetdoc attribute in +the document element in the database, but with a +different lang attribute value. + + +When an olink is being resolved, the target is first +sought in the document with the same language as the olink. +If no match is found there, then this parameter is consulted +for additional languages to try. + +The olink.lang.fallback.sequence +must be a whitespace separated list of lang values to +try. The first one with a match in the olink database is used. +The default value is empty. + +For example, a document might be written in German +and contain an olink with +targetdoc="adminguide". +When the document is processed, the processor +first looks for a target dataset in the +olink database starting with: + +<document targetdoc="adminguide" lang="de">. + + +If there is no such element, then the +olink.lang.fallback.sequence +parameter is consulted. +If its value is, for example, fr en, then the processor next +looks for targetdoc="adminguide" lang="fr", and +then for targetdoc="adminguide" lang="en". +If there is still no match, it looks for +targetdoc="adminguide" with no +lang attribute. + + +This parameter is useful when a set of documents is only +partially translated, or is in the process of being translated. +If a target of an olink has not yet been translated, then this +parameter permits the processor to look for the document in +other languages. This assumes the reader would rather have +a link to a document in a different language than to have +a broken link. + + + + + + + +insert.olink.page.number +string + +insert.olink.page.number +Turns page numbers in olinks on and off + + +Description + +The value of this parameter determines if +cross references made between documents with +olink will +include page number citations. +In most cases this is only applicable to references in printed output. + +The parameter has three possible values. + + + +no +No page number references will be generated for olinks. + + + +yes +Page number references will be generated +for all olink references. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an olink element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + +Olinks that point to targets within the same document +are treated as xrefs, and controlled by +the insert.xref.page.number parameter. + + +Page number references for olinks to +external documents can only be inserted if the +information exists in the olink database. +This means each olink target element +(div or obj) +must have a page attribute +whose value is its page number in the target document. +The XSL stylesheets are not able to extract that information +during processing because pages have not yet been created in +XSLT transformation. Only the XSL-FO processor knows what +page each element is placed on. +Therefore some postprocessing must take place to populate +page numbers in the olink database. + + + + + + +no + + +insert.olink.pdf.frag +boolean + +insert.olink.pdf.frag +Add fragment identifiers for links into PDF files + + +Description + +The value of this parameter determines whether +the cross reference URIs to PDF documents made with +olink will +include fragment identifiers. + + +When forming a URI to link to a PDF document, +a fragment identifier (typically a '#' followed by an +id value) appended to the PDF filename can be used by +the PDF viewer to open +the PDF file to a location within the document instead of +the first page. +However, not all PDF files have id +values embedded in them, and not all PDF viewers can +handle fragment identifiers. + + +If insert.olink.pdf.frag is set +to a non-zero value, then any olink targeting a +PDF file will have the fragment identifier appended to the URI. +The URI is formed by concatenating the value of the +olink.base.uri parameter, the +value of the baseuri +attribute from the document +element in the olink database with the matching +targetdoc value, +and the value of the href +attribute for the targeted element in the olink database. +The href attribute +contains the fragment identifier. + + +If insert.olink.pdf.frag is set +to zero (the default value), then +the href attribute +from the olink database +is not appended to PDF olinks, so the fragment identifier is left off. +A PDF olink is any olink for which the +baseuri attribute +from the matching document +element in the olink database ends with '.pdf'. +Any other olinks will still have the fragment identifier added. + + + + + + +prefer.internal.olink +boolean + +prefer.internal.olink +Prefer a local olink reference to an external reference + + +Description + +If you are re-using XML content modules in multiple documents, +you may want to redirect some of your olinks. This parameter +permits you to redirect an olink to the current document. + + +For example: you are writing documentation for a product, +which includes 3 manuals: a little installation +booklet (booklet.xml), a user +guide (user.xml), and a reference manual (reference.xml). +All 3 documents begin with the same introduction section (intro.xml) that +contains a reference to the customization section (custom.xml) which is +included in both user.xml and reference.xml documents. + + +How do you write the link to custom.xml in intro.xml +so that it is interpreted correctly in all 3 documents? + +If you use xref, it will fail in user.xml. + +If you use olink (pointing to reference.xml), +the reference in user.xml +will point to the customization section of the reference manual, while it is +actually available in user.xml. + + + +If you set the prefer.internal.olink +parameter to a non-zero value, then the processor will +first look in the olink database +for the olink's targetptr attribute value +in document matching the current.docid +parameter value. If it isn't found there, then +it tries the document in the database +with the targetdoc +value that matches the olink's targetdoc +attribute. + + +This feature permits an olink reference to resolve to +the current document if there is an element +with an id matching the olink's targetptr +value. The current document's olink data must be +included in the target database for this to work. + + +There is a potential for incorrect links if +the same id attribute value is used for different +content in different documents. +Some of your olinks may be redirected to the current document +when they shouldn't be. It is not possible to control +individual olink instances. + + + + + + + +link.mailto.url +string + +link.mailto.url +Mailto URL for the LINK REL=made HTML HEAD element + + +Description + +If not the empty string, this address will be used for the +REL=made LINK element in the HTML HEAD. + + + + + + + +ulink.target +string + +ulink.target +The HTML anchor target for ULinks + + +Description + +If ulink.target is set, its value will +be used for the target attribute +on anchors generated for ulinks. + + + + + + +olink.fragid +string + +olink.fragid +Names the fragment identifier portion of an OLink resolver query + + +Description + +FIXME: + + + + + + +olink.outline.ext +string + +olink.outline.ext +The extension of OLink outline files + + +Description + +FIXME: + + + + + + +olink.pubid +string + +olink.pubid +Names the public identifier portion of an OLink resolver query + + +Description + +FIXME: + + + + + + +olink.sysid +string + +olink.sysid +Names the system identifier portion of an OLink resolver query + + +Description + +FIXME: + + + + + + +olink.resolver + + +olink.resolver +The root name of the OLink resolver (usually a script) + + +Description + +FIXME: + + + + + + +collect.xref.targets +string + +collect.xref.targets +Controls whether cross reference data is +collected + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter determines whether the collection process is run when the document is processed by the stylesheet. The default value is no, which means the data file is not generated during processing. The other choices are yes, which means the data file is created and the document is processed for output, and only, which means the data file is created but the document is not processed for output. +See also targets.filename. + + + + + + +insert.xref.page.number +string + +insert.xref.page.number +Turns page numbers in xrefs on and off + + +Description + +The value of this parameter determines if +cross references (xrefs) in +printed output will +include page number citations. +It has three possible values. + + + +no +No page number references will be generated. + + + +yes +Page number references will be generated +for all xref elements. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an xref element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + + + + +no + + +use.role.as.xrefstyle +boolean + +use.role.as.xrefstyle +Use role attribute for +xrefstyle on xref? + + +Description + +If non-zero, the role attribute on +xref will be used to select the cross reference style. +The DocBook +Technical Committee recently added an +xrefstyle attribute for this purpose. +If the xrefstyle attribute +is present, role will be ignored, regardless +of this setting. + +Until an official DocBook release that includes the new +attribute, this flag allows role +to serve that purpose. + +Example + +The following small stylesheet shows how to configure the stylesheets to make +use of the cross reference style: + +<?xml version="1.0"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<xsl:import href="../xsl/html/docbook.xsl"/> + +<xsl:output method="html"/> + +<xsl:param name="local.l10n.xml" select="document('')"/> +<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"> + <l:l10n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" language="en"> + <l:context name="xref"> + <l:template name="chapter" style="title" text="Chapter %n, %t"/> + <l:template name="chapter" text="Chapter %n"/> + </l:context> + </l:l10n> +</l:i18n> + +</xsl:stylesheet> + +With this stylesheet, the cross references in the following document: + +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> +<book id="book"><title>Book</title> + +<preface> +<title>Preface</title> + +<para>Normal: <xref linkend="ch1"/>.</para> +<para>Title: <xref xrefstyle="title" linkend="ch1"/>.</para> + +</preface> + +<chapter id="ch1"> +<title>First Chapter</title> + +<para>Irrelevant.</para> + +</chapter> +</book> + +will appear as: + + +Normal: Chapter 1. +Title: Chapter 1, First Chapter. + + + + + + +xref.with.number.and.title +boolean + +xref.with.number.and.title +Use number and title in cross references + + +Description + +FIXME: + + + + + + +xref.label-page.separator +string + +xref.label-page.separator +Punctuation or space separating label from page number in xref + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and page +but no title, +then the value of this parameter is inserted between +label and page number in the output. +If a title is included, then other separators are used. + + + + + + + +xref.label-title.separator +string + +xref.label-title.separator +Punctuation or space separating label from title in xref + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and title, +then the value of this parameter is inserted between +label and title in the output. + + + + +: + + +xref.title-page.separator +string + +xref.title-page.separator +Punctuation or space separating title from page number in xref + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both title and page number, +then the value of this parameter is inserted between +title and page number in the output. + + + + + + + +segmentedlist.as.table +boolean + +segmentedlist.as.table +Format segmented lists as tables? + + +Description + +If non-zero, segmentedlists will be formatted as +tables. + + + + + + +variablelist.as.table +boolean + +variablelist.as.table +Format variablelists as tables? + + +Description + +If non-zero, variablelists will be formatted as +tables. A processing instruction exists to specify a particualar width for the +column containing the terms: +dbhtml term-width=".25in" + +You can override this setting with a processing instruction as the +child of variablelist: dbhtml +list-presentation="table" or dbhtml +list-presentation="list". + +This parameter only applys to the HTML transformations. In the +FO case, proper list markup is robust enough to handle the formatting. +But see also variablelist.as.blocks. + + <variablelist> + <?dbhtml list-presentation="table"?> + <?dbhtml term-width="1.5in"?> + <?dbfo list-presentation="list"?> + <?dbfo term-width="1in"?> + <varlistentry> + <term>list</term> + <listitem> + <para> + Formatted as a table even if variablelist.as.table is set to 0. + </para> + </listitem> + </varlistentry> + </variablelist> + + + + + + +variablelist.term.separator +string + +variablelist.term.separator +Text to separate terms within a multi-term +varlistentry + + +Description + +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is placed +after each term except the last. + + + To generate a line break between multiple terms in + a varlistentry, set a non-zero value for the + variablelist.term.break.after parameter. If + you do so, you may also want to set the value of the + variablelist.term.separator parameter to an + empty string (to suppress rendering of the default comma and space + after each term). + + + + +, + + +variablelist.term.break.after +boolean + +variablelist.term.break.after +Generate line break after each term within a +multi-term varlistentry? + + +Description + +Set a non-zero value for the +variablelist.term.break.after parameter to +generate a line break between terms in a +multi-term varlistentry. + + +If you set a non-zero value for +variablelist.term.break.after, you may also +want to set the value of the +variablelist.term.separator parameter to an +empty string (to suppress rendering of the default comma and space +after each term). + + + + +0 + + +biblioentry.item.separator +string + +biblioentry.item.separator +Text to separate bibliography entries + + +Description + +Text to separate bibliography entries + + + + +. + + +bibliography.collection +string + +bibliography.collection +Name of the bibliography collection file + + +Description + +Maintaining bibliography entries across a set of documents is tedious, time +consuming, and error prone. It makes much more sense, usually, to store all of +the bibliography entries in a single place and simply extract +the ones you need in each document. + +That's the purpose of the +bibliography.collection parameter. To setup a global +bibliography database, follow these steps: + +First, create a stand-alone bibliography document that contains all of +the documents that you wish to reference. Make sure that each bibliography +entry (whether you use biblioentry or bibliomixed) +has an ID. + +My global bibliography, ~/bibliography.xml begins +like this: + + +<!DOCTYPE bibliography + PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<bibliography><title>References</title> + +<bibliomixed id="xml-rec"><abbrev>XML 1.0</abbrev>Tim Bray, +Jean Paoli, C. M. Sperberg-McQueen, and Eve Maler, editors. +<citetitle><ulink url="http://www.w3.org/TR/REC-xml">Extensible Markup +Language (XML) 1.0 Second Edition</ulink></citetitle>. +World Wide Web Consortium, 2000. +</bibliomixed> + +<bibliomixed id="xml-names"><abbrev>Namespaces</abbrev>Tim Bray, +Dave Hollander, +and Andrew Layman, editors. +<citetitle><ulink url="http://www.w3.org/TR/REC-xml-names/">Namespaces in +XML</ulink></citetitle>. +World Wide Web Consortium, 1999. +</bibliomixed> + +<!-- ... --> +</bibliography> + + + +When you create a bibliography in your document, simply +provide empty bibliomixed +entries for each document that you wish to cite. Make sure that these +elements have the same ID as the corresponding real +entry in your global bibliography. + +For example: + + +<bibliography><title>Bibliography</title> + +<bibliomixed id="xml-rec"/> +<bibliomixed id="xml-names"/> +<bibliomixed id="DKnuth86">Donald E. Knuth. <citetitle>Computers and +Typesetting: Volume B, TeX: The Program</citetitle>. Addison-Wesley, +1986. ISBN 0-201-13437-3. +</bibliomixed> +<bibliomixed id="relaxng"/> + +</bibliography> + + +Note that it's perfectly acceptable to mix entries from your +global bibliography with normal entries. You can use +xref or other elements to cross-reference your +bibliography entries in exactly the same way you do now. + +Finally, when you are ready to format your document, simply set the +bibliography.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global bibliography. + +The stylesheets will format the bibliography in your document as if +all of the entries referenced appeared there literally. + + + + + + +bibliography.numbered +boolean + +bibliography.numbered +Should bibliography entries be numbered? + + +Description + +If non-zero bibliography entries will be numbered + + + + + + +glossterm.auto.link +boolean + +glossterm.auto.link +Generate links from glossterm to glossentry automaticaly? + + +Description + +If true, a link will be automatically created from glossterm +to glossentry for that glossary term. This is usefull when your +glossterm names are consistent and you don't want to add links +manually. +If there is linkend on +glossterm then is used instead of autogeneration of +link. + + + + + + +firstterm.only.link +boolean + +firstterm.only.link +Does automatic glossterm linking only apply to firstterms? + + +Description + +If true, only firstterms will be automatically linked +to the glossary. If glossary linking is not enabled, this parameter +has no effect. + + + + + + +glossary.collection +string + +glossary.collection +Name of the glossary collection file + + +Description + +Glossaries maintained independently across a set of documents +are likely to become inconsistent unless considerable effort is +expended to keep them in sync. It makes much more sense, usually, to +store all of the glossary entries in a single place and simply +extract the ones you need in each document. + +That's the purpose of the +glossary.collection parameter. To setup a global +glossary database, follow these steps: + +Setting Up the Glossary Database + +First, create a stand-alone glossary document that contains all of +the entries that you wish to reference. Make sure that each glossary +entry has an ID. + +Here's an example glossary: + + + +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE glossary + PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<glossary> +<glossaryinfo> +<editor><firstname>Eric</firstname><surname>Raymond</surname></editor> +<title>Jargon File 4.2.3 (abridged)</title> +<releaseinfo>Just some test data</releaseinfo> +</glossaryinfo> + +<glossdiv><title>0</title> + +<glossentry> +<glossterm>0</glossterm> +<glossdef> +<para>Numeric zero, as opposed to the letter `O' (the 15th letter of +the English alphabet). In their unmodified forms they look a lot +alike, and various kluges invented to make them visually distinct have +compounded the confusion. If your zero is center-dotted and letter-O +is not, or if letter-O looks almost rectangular but zero looks more +like an American football stood on end (or the reverse), you're +probably looking at a modern character display (though the dotted zero +seems to have originated as an option on IBM 3270 controllers). If +your zero is slashed but letter-O is not, you're probably looking at +an old-style ASCII graphic set descended from the default typewheel on +the venerable ASR-33 Teletype (Scandinavians, for whom /O is a letter, +curse this arrangement). (Interestingly, the slashed zero long +predates computers; Florian Cajori's monumental "A History of +Mathematical Notations" notes that it was used in the twelfth and +thirteenth centuries.) If letter-O has a slash across it and the zero +does not, your display is tuned for a very old convention used at IBM +and a few other early mainframe makers (Scandinavians curse <emphasis>this</emphasis> +arrangement even more, because it means two of their letters collide). +Some Burroughs/Unisys equipment displays a zero with a <emphasis>reversed</emphasis> +slash. Old CDC computers rendered letter O as an unbroken oval and 0 +as an oval broken at upper right and lower left. And yet another +convention common on early line printers left zero unornamented but +added a tail or hook to the letter-O so that it resembled an inverted +Q or cursive capital letter-O (this was endorsed by a draft ANSI +standard for how to draw ASCII characters, but the final standard +changed the distinguisher to a tick-mark in the upper-left corner). +Are we sufficiently confused yet?</para> +</glossdef> +</glossentry> + +<glossentry> +<glossterm>1TBS</glossterm> +<glossdef> +<para role="accidence"> +<phrase role="pronounce"></phrase> +<phrase role="partsofspeach">n</phrase> +</para> +<para>The "One True Brace Style"</para> +<glossseealso>indent style</glossseealso> +</glossdef> +</glossentry> + +<!-- ... --> + +</glossdiv> + +<!-- ... --> + +</glossary> + + + + +Marking Up Glossary Terms + +That takes care of the glossary database, now you have to get the entries +into your document. Unlike bibliography entries, which can be empty, creating +placeholder glossary entries would be very tedious. So instead, +support for glossary.collection relies on implicit linking. + +In your source document, simply use firstterm and +glossterm to identify the terms you wish to have included +in the glossary. The stylesheets assume that you will either set the +baseform attribute correctly, or that the +content of the element exactly matches a term in your glossary. + +If you're using a glossary.collection, don't +make explicit links on the terms in your document. + +So, in your document, you might write things like this: + + +<para>This is dummy text, without any real meaning. +The point is simply to reference glossary terms like <glossterm>0</glossterm> +and the <firstterm baseform="1TBS">One True Brace Style (1TBS)</firstterm>. +The <glossterm>1TBS</glossterm>, as you can probably imagine, is a nearly +religious issue.</para> + + +If you set the firstterm.only.link parameter, +only the terms marked with firstterm will be links. +Otherwise, all the terms will be linked. + + + +Marking Up the Glossary + +The glossary itself has to be identified for the stylesheets. For lack +of a better choice, the role is used. +To identify the glossary as the target for automatic processing, set +the role to auto. The title of this +glossary (and any other information from the glossaryinfo +that's rendered by your stylesheet) will be displayed, but the entries will +come from the database. + + +Unfortunately, the glossary can't be empty, so you must put in +at least one glossentry. The content of this entry +is irrelevant, it will not be rendered: + + +<glossary role="auto"> +<glossentry> +<glossterm>Irrelevant</glossterm> +<glossdef> +<para>If you can see this, the document was processed incorrectly. Use +the <parameter>glossary.collection</parameter> parameter.</para> +</glossdef> +</glossentry> +</glossary> + + +What about glossary divisions? If your glossary database has glossary +divisions and your automatic glossary contains at least +one glossdiv, the automic glossary will have divisions. +If the glossdiv is missing from either location, no divisions +will be rendered. + +Glossary entries (and divisions, if appropriate) in the glossary will +occur in precisely the order they occur in your database. + + + +Formatting the Document + +Finally, when you are ready to format your document, simply set the +glossary.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global glossary. + +The stylesheets will format the glossary in your document as if +all of the entries implicilty referenced appeared there literally. + + +Limitations + +Glossary cross-references within the glossary are +not supported. For example, this will not work: + + +<glossentry> +<glossterm>gloss-1</glossterm> +<glossdef><para>A description that references <glossterm>gloss-2</glossterm>.</para> +<glossseealso>gloss-2</glossseealso> +</glossdef> +</glossentry> + + +If you put glossary cross-references in your glossary that way, +you'll get the cryptic error: Warning: +glossary.collection specified, but there are 0 automatic +glossaries. + +Instead, you must do two things: + + + +Markup your glossary using glossseealso: + + +<glossentry> +<glossterm>gloss-1</glossterm> +<glossdef><para>A description that references <glossterm>gloss-2</glossterm>.</para> +<glossseealso>gloss-2</glossseealso> +</glossdef> +</glossentry> + + + + +Make sure there is at least one glossterm reference to +gloss-2 in your document. The +easiest way to do that is probably within a remark in your +automatic glossary: + + +<glossary role="auto"> +<remark>Make sure there's a reference to <glossterm>gloss-2</glossterm>.</remark> +<glossentry> +<glossterm>Irrelevant</glossterm> +<glossdef> +<para>If you can see this, the document was processed incorrectly. Use +the <parameter>glossary.collection</parameter> parameter.</para> +</glossdef> +</glossentry> +</glossary> + + + + + + + + + + +glossentry.show.acronym +list + +glossentry.show.acronym +Display glossentry acronyms? + + +Description + +A setting of yes means they should be displayed; +no means they shouldn't. If primary is used, +then they are shown as the primary text for the entry. + + +This setting controls both acronym and +abbrev elements in the glossentry. + + + + + + + +formal.procedures +boolean + +formal.procedures +Selects formal or informal procedures + + +Description + +Formal procedures are numbered and always have a title. + + + + + + + +formal.title.placement + + +formal.title.placement +Specifies where formal object titles should occur + + +Description + +Specifies where formal object titles should occur. For each formal object +type (figure, +example, +equation, +table, and procedure) +you can specify either the keyword +before or +after. + + + + +figure before +example before +equation before +table before +procedure before +task before + + + +runinhead.default.title.end.punct +string + +runinhead.default.title.end.punct +Default punctuation character on a run-in-head + + +Description + +FIXME: + + + + + + + +runinhead.title.end.punct +string + +runinhead.title.end.punct +Characters that count as punctuation on a run-in-head + + +Description + +FIXME: + + + + + + + +show.comments +boolean + +show.comments +Display comment elements? + + +Description + +If true (non-zero), comments will be displayed, otherwise they are suppressed. +Comments here refers to the comment element, +which will be renamed remark in DocBook V4.0, +not XML comments (<-- like this -->) which are unavailable. + + + + +1 + + +show.revisionflag +boolean + +show.revisionflag +Enable decoration of elements that have a revisionflag + + +Description + + +If show.revisionflag is turned on, then the stylesheets +may produce additional markup designed to allow a CSS stylesheet to +highlight elements that have specific revisionflag settings. + +The markup inserted will be usually be either a <span> or <div> +with an appropriate class attribute. (The value of +the class attribute will be the same as the value of the revisionflag +attribute). In some contexts, for example tables, where extra markup +would be structurally illegal, the class attribute will be added to the +appropriate container element. + +In general, the stylesheets only test for revisionflag in contexts +where an importing stylesheet would have to redefine whole templates. +Most of the revisionflag processing is expected to be done by another +stylesheet, for example changebars.xsl. + + + +0 + + +shade.verbatim +boolean + +shade.verbatim +Should verbatim environments be shaded? + + +Description + +In the FO stylesheet, if this parameter is non-zero then the +shade.verbatim.style properties will be applied +to verbatim environments. + +In the HTML stylesheet, this parameter is now deprecated. Use +CSS instead. + + + + + + +shade.verbatim.style + + +shade.verbatim.style +Properties that specify the style of shaded verbatim listings + + +Description + +FIXME: + + + + + 0 + #E0E0E0 + + + + +punct.honorific +string + +punct.honorific +Punctuation after an honorific in a personal name. + + +Description + +This parameter specifies the punctuation that should be added after an +honorific in a personal name. + + + + + + +tex.math.in.alt +string + +tex.math.in.alt +TeX notation used for equations + + +Description + +If you want type math directly in TeX notation in equations, +this parameter specifies notation used. Currently are supported two +values -- plain and latex. Empty +value means that you are not using TeX math at all. + +Preferred way for including TeX alternative of math is inside of +textobject element. Eg.: + +<inlineequation> +<inlinemediaobject> +<imageobject> +<imagedata fileref="eq1.gif"/> +</imageobject> +<textobject><phrase>E=mc squared</phrase></textobject> +<textobject role="tex"><phrase>E=mc^2</phrase></textobject> +</inlinemediaobject> +</inlineequation> + +If you are using graphic element, you can +store TeX inside alt element: + +<inlineequation> +<alt role="tex">a^2+b^2=c^2</alt> +<graphic fileref="a2b2c2.gif"/> +</inlineequation> + +If you want use this feature, you should process your FO with +PassiveTeX, which only supports TeX math notation. When calling +stylsheet, don't forget to specify also +passivetex.extensions=1. + +If you want equations in HTML, just process generated file +tex-math-equations.tex by TeX or LaTeX. Then run +dvi2bitmap program on result DVI file. You will get images for +equations in your document. + + + + + + +tex.math.file +string + +tex.math.file +Name of temporary file for generating images from equations + + +Description + +Name of auxiliary file for TeX equations. This file can be +processed by dvi2bitmap to get bitmap versions of equations for HTML +output. + + + + + + +tex.math.delims +boolean + +tex.math.delims +Should be equations outputed for processing by TeX +automatically surrounded by math mode delimiters + + +Description + +For compatibility with DSSSL based DBTeXMath from Allin Cottrell +you should set this parameter to 0. + + + + + + +pixels.per.inch +integer + +pixels.per.inch +How many pixels are there per inch? + + +Description + +When lengths are converted to pixels, this value is used to +determine the size of a pixel. The default value is taken from the +XSL +Recommendation. + + + + + + + +points.per.em +number + +points.per.em +Specify the nominal size of an em-space in points + + +Description + +FIXME: + + + + + + +use.svg +boolean + +use.svg +Allow SVG in the result tree? + + +Description + +If non-zero, SVG will be considered an acceptable image format. SVG +is passed through to the result tree, so correct rendering of the resulting +diagram depends on the formatter (FO processor or web browser) that is used +to process the output from the stylesheet. + + + + + + +menuchoice.separator + + +menuchoice.separator +Separator between items of a menuchoice +other than guimenuitem and +guisubmenu + + +Description + +Separator used to connect items of a menuchoice other +than guimenuitem and guisubmenu. The latter +elements are linked with menuchoice.menu.separator. + + + + + + + +menuchoice.menu.separator + + +menuchoice.menu.separator +Separator between items of a menuchoice +with guimenuitem or +guisubmenu + + +Description + +Separator used to connect items of a menuchoice with +guimenuitem or guisubmenu. Other elements +are linked with menuchoice.separator. + +The default value is &#x2192;, which is the +&rarr; (right arrow) character entity. +The current FOP (0.20.5) requires setting the font-family +explicitly. + +The default value also includes spaces around the arrow, +which will allow a line to break. Replace the spaces with +&#xA0; (nonbreaking space) if you don't want those +spaces to break. + + + + + → + + +default.float.class +string + +default.float.class +Specifies the default float class + + +Description + +FIXME: + + + + + + left + before + + + + +footnote.number.format +string + +footnote.number.format +Identifies the format used for footnote numbers + + +Description + +The footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A). + + + + + + +table.footnote.number.format +string + +table.footnote.number.format +Identifies the format used for footnote numbers in tables + + +Description + +The table.footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A) in tables. + + + + + + +footnote.number.symbols + + +footnote.number.symbols +Special characters to use as footnote markers + + +Description + +If footnote.number.symbols is not the empty string, +footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + + + + +table.footnote.number.symbols + + +table.footnote.number.symbols +Special characters to use a footnote markers in tables + + +Description + +If table.footnote.number.symbols is not the empty string, +table footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +table.footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + + + + +annotation.support +boolean + +annotation.support +Enable annotations? + + +Description + +If non-zero, the stylesheets will attempt to support annotation +elements in HTML by including some JavaScript (see +annotation.js). + + + + + + +annotation.js +boolean + +annotation.js +Enable annotations? + + +Description + +If annotation.support is enabled and the +document contains annotations, then the URIs listed +in this parameter will be included. These JavaScript files are required +for popup annotation support. + + + + + + +annotation.css +boolean + +annotation.css +Enable annotations? + + +Description + +If annotation.support is enabled and the +document contains annotations, then the CSS in this +parameter will be included in the document. + + + + +/* ====================================================================== + Annotations +*/ + +div.annotation-list { visibility: hidden; + } + +div.annotation-nocss { position: absolute; + visibility: hidden; + } + +div.annotation-popup { position: absolute; + z-index: 4; + visibility: hidden; + padding: 0px; + margin: 2px; + border-style: solid; + border-width: 1px; + width: 200px; + background-color: white; + } + +div.annotation-title { padding: 1px; + font-weight: bold; + border-bottom-style: solid; + border-bottom-width: 1px; + color: white; + background-color: black; + } + +div.annotation-body { padding: 2px; + } + +div.annotation-body p { margin-top: 0px; + padding-top: 0px; + } + +div.annotation-close { position: absolute; + top: 2px; + right: 2px; + } + + + +annotation.graphic.open +boolean + +annotation.graphic.open +Enable annotations? + + +Description + +This image is used inline to identify the location of +annotations. + + + + + + +annotation.graphic.close +boolean + +annotation.graphic.close +Enable annotations? + + +Description + +This image is used on popup annotations as the “x” that the +user can click to dismiss the popup. + + + + + + +img.src.path +string + +img.src.path +Path to HTML image files + + +Description + +Add a path prefix to each HTML +img or FO +fo:external-graphics element's +src attribute. +This path could relative to the directory where the HTML/FO +files are created, or it could be an absolute URI. +The default value is empty. +Be sure to include a trailing slash if needed. + +This prefix is not applied to any filerefs that start +with "/" or contain "//:". + + + + + + + +keep.relative.image.uris +boolean + +keep.relative.image.uris +Should image URIs be resolved against xml:base? + + +Description + +If non-zeor, relative URIs (in, for example fileref attributes) will +be used in the generated output. Otherwise, the URIs will be made absolute +with respect to the base URI. + +Note that the stylesheets calculate (and use) the absolute form +for some purposes, this only applies to the resulting output. + + + + + + + +graphic.default.extension +string + +graphic.default.extension +Default extension for graphic filenames + + +Description + +If a graphic or mediaobject +includes a reference to a filename that does not include an extension, +and the format attribute is +unspecified, the default extension will be used. + + + + + + + +default.image.width +length + +default.image.width +The default width of images + + +Description + +If specified, this value will be used for the +width attribute on +images that do not specify any +viewport +dimensions. + + + + + + +nominal.image.width +length + +nominal.image.width +The nominal image width + + +Description + +Graphic widths expressed as a percentage are problematic. In the +following discussion, we speak of width and contentwidth, but +the same issues apply to depth and contentdepth. + +A width of 50% means "half of the available space for the image." +That's fine. But note that in HTML, this is a dynamic property and +the image size will vary if the browser window is resized. + +A contentwidth of 50% means "half of the actual image width". +But what does that mean if the stylesheets cannot assess the image's +actual size? Treating this as a width of 50% is one possibility, but +it produces behavior (dynamic scaling) that seems entirely out of +character with the meaning. + +Instead, the stylesheets define a +nominal.image.width and convert percentages to +actual values based on that nominal size. + + + + + + +nominal.image.depth +length + +nominal.image.depth +Nominal image depth + + +Description + +See nominal.image.width. + + + + + + +use.embed.for.svg +boolean + +use.embed.for.svg +Use HTML embed for SVG? + + +Description + +If non-zero, an embed element will be created for +SVG figures. An object is always created, +this parameter merely controls whether or not an additional embed +is generated inside the object. + +On the plus side, this may be more portable among browsers and plug-ins. +On the minus side, it isn't valid HTML. + + + + + + +make.graphic.viewport +boolean + +make.graphic.viewport +Use tables in HTML to make viewports for graphics + + +Description + +The HTML img element only supports the notion +of content-area scaling; it doesn't support the distinction between a +content-area and a viewport-area, so we have to make some compromises. + +If make.graphic.viewport is non-zero, a table +will be used to frame the image. This creates an effective viewport-area. + + +Tables and alignment don't work together, so this parameter is ignored +if alignment is specified on an image. + + + + + +preferred.mediaobject.role + +preferred.mediaobject.role +Select which mediaobject to use based on +this value of an object's role attribute. + + + +Description + +A mediaobject may contain several objects such as imageobjects. +If the parameter use.role.for.mediaobject +is non-zero, then the role attribute on +imageobjects and other objects within a mediaobject container will be used to select which object will be +used. If one of the objects has a role value that matches the +preferred.mediaobject.role parameter, then it has first +priority for selection. If more than one has such a +role value, the first one is used. + + +See the use.role.for.mediaobject parameter +for the sequence of selection. + + + + + +use.role.for.mediaobject +boolean + +use.role.for.mediaobject +Use role attribute +value for selecting which of several objects within a mediaobject to use. + + + +Description + +If non-zero, the role attribute on +imageobjects or other objects within a mediaobject container will be used to select which object will be +used. + + +The order of selection when then parameter is non-zero is: + + + + If the stylesheet parameter preferred.mediaobject.role has a value, then the object whose role equals that value is selected. + + +Else if an object's role attribute has a value of +html for HTML processing or +fo for FO output, then the first +of such objects is selected. + + + +Else the first suitable object is selected. + + + +If the value of +use.role.for.mediaobject +is zero, then role attributes are not considered +and the first suitable object +with or without a role value is used. + + + + + + +ignore.image.scaling +boolean + +ignore.image.scaling +Tell the stylesheets to ignore the author's image scaling attributes + + +Description + +If non-zero, the scaling attributes on graphics and media objects are +ignored. + + + + + + +chunker.output.cdata-section-elements +string + +chunker.output.cdata-section-elements +List of elements to escape with CDATA sections +<xsl:param name="chunker.output.cdata-section-elements" select="''"/> +Description + +This parameter specifies the list of elements that should be escaped +as CDATA sections by the chunking stylesheet. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.doctype-public +string + +chunker.output.doctype-public +Public identifer to use in the document type of generated pages +<xsl:param name="chunker.output.doctype-public" select="''"/> +Description + +This parameter specifies the public identifier that should be used by +the chunking stylesheet in the document type declaration of chunked pages. +Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.doctype-system +uri + +chunker.output.doctype-system +System identifier to use for the document type in generated pages +<xsl:param name="chunker.output.doctype-system" select="''"/> +Description + +This parameter specifies the system identifier that should be used by +the chunking stylesheet in the document type declaration of chunked pages. +Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.encoding +string + +chunker.output.encoding +Encoding used in generated pages +<xsl:param name="chunker.output.encoding" select="'ISO-8859-1'"/> +Description + +This parameter specifies the encoding to be used in files +generated by the chunking stylesheet. Not all processors support +specification of this parameter. + + +This parameter used to be named default.encoding. + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.indent +string + +chunker.output.indent +Specification of indentation on generated pages +<xsl:param name="chunker.output.indent" select="'no'"/> +Description + +This parameter specifies the value of the indent +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.media-type +string + +chunker.output.media-type +Media type to use in generated pages +<xsl:param name="chunker.output.media-type" select="''"/> +Description + +This parameter specifies the media type that should be used by +the chunking stylesheet. Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.method +list +html +xml + +chunker.output.method +Method used in generated pages +<xsl:param name="chunker.output.method" select="'html'"/> +Description + +This parameter specifies the output method to be used in files +generated by the chunking stylesheet. + + +This parameter used to be named output.method. + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.omit-xml-declaration + + +chunker.output.omit-xml-declaration +Omit-xml-declaration for generated pages +<xsl:param name="chunker.output.omit-xml-declaration" select="'no'"/> +Description + +This parameter specifies the value of the omit-xml-declaration +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.standalone +string + +chunker.output.standalone +Standalone declaration for generated pages +<xsl:param name="chunker.output.standalone" select="'no'"/> +Description + +This parameter specifies the value of the standalone +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +saxon.character.representation +string + +saxon.character.representation +Saxon character representation used in generated HTML pages +<xsl:param name="saxon.character.representation" select="'entity;decimal'"/> +Description + +This character representation is used in files generated by chunking stylesheet. If +you want to suppress entity references for characters with direct representation +in default.encoding, set this parameter to value native. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +html.ext + + +html.ext +Identifies the extension of generated HTML files + + +Description + +The extension identified by html.ext will +be used as the filename extension for chunks created by this stylesheet. + + + + + + + +use.id.as.filename +boolean + +use.id.as.filename +Use ID value of chunk elements as the filename? + + +Description + +If use.id.as.filename +is non-zero, the filename of chunk elements that have IDs will be +derived from the ID value. + + + + + + + +html.extra.head.links +boolean + +html.extra.head.links +Toggle extra HTML head link information + + +Description + +If non-zero, extra link elements will be +generated in the head of chunked HTML files. These +extra links point to chapters, appendixes, sections, etc. as supported +by the Site Navigation Bar in Mozilla 1.0 (as of CR1, at least). + + + + + + + +root.filename + + +root.filename +Identifies the name of the root HTML file when chunking + + +Description + +The root.filename is the base filename for +the chunk created for the root of each document processed. + + + + + + + +base.dir + + +base.dir +The base directory of chunks + + +Description + +If specified, the base.dir identifies +the output directory for chunks. (If not specified, the output directory +is system dependent.) + + + + + + + generate.manifest + boolean + + generate.manifest + Generate a manifest file? + + + Description + + If non-zero, a list of HTML files generated by the + stylesheet transformation is written to the file named by + the manifest parameter. + + + + + + + manifest + string + + manifest + Name of manifest file + + + Description + + The name of the file to which a manifest is written (if the + value of the generate.manifest parameter + is non-zero). + + + + + + +manifest.in.base.dir +boolean + +manifest.in.base.dir +Should be manifest file written in $base.dir? + + +Description + +If non-zero manifest file and project files for HTML Help and +Eclipse Help are written into base.dir instead +of current directory. + + + + + + +chunk.toc +string + +chunk.toc +An explicit TOC to be used for chunking + + +Description + +The chunk.toc identifies an explicit TOC that +will be used for chunking. This parameter is only used by the +chunktoc.xsl stylesheet (and customization layers built +from it). + + + + + + +chunk.tocs.and.lots +boolean + +chunk.tocs.and.lots +Should ToC and LoTs be in separate chunks? + + +Description + +If non-zero, ToC and LoT (List of Examples, List of Figures, etc.) +will be put in a separate chunk. At the moment, this chunk is not in the +normal forward/backward navigation list. Instead, a new link is added to the +navigation footer. + +This feature is still somewhat experimental. Feedback welcome. + + + + + + +chunk.separate.lots +boolean + +chunk.separate.lots +Should each LoT be in its own separate chunk? + + +Description + +If non-zero, each of the ToC and LoTs +(List of Examples, List of Figures, etc.) +will be put in its own separate chunk. +The title page includes generated links to each of the separate files. + + +This feature depends on the +chunk.tocs.and.lots +parameter also being non-zero. + + + + + + + +chunk.tocs.and.lots.has.title +boolean + +chunk.tocs.and.lots.has.title +Should ToC and LoTs in a separate chunks have title? + + +Description + +If non-zero title of document is shown before ToC/LoT in +separate chunk. + + + + + + +chunk.section.depth +integer + +chunk.section.depth +Depth to which sections should be chunked + + +Description + +This parameter sets the depth of section chunking. + + + + + + +chunk.first.sections + + +chunk.first.sections +Chunk the first top-level section? + + +Description + +If non-zero, a chunk will be created for the first top-level +sect1 or section elements in +each component. Otherwise, that section will be part of the chunk for +its parent. + + + + + + + +chunk.quietly + + +chunk.quietly +Omit the chunked filename messages. + + +Description + +If zero (the default), the XSL processor emits a message naming +each separate chunk filename as it is being output. +If nonzero, then the messages are suppressed. + + + + + + + +navig.graphics +boolean + +navig.graphics +Use graphics in navigational headers and footers? + + +Description + +If true (non-zero), the navigational headers and footers in chunked +HTML are presented in an alternate style that uses +graphical icons for Next, Previous, Up, and Home. +Default graphics are provided in the distribution. + + + + + + + +navig.graphics.extension +string + +navig.graphics.extension +Extension for navigational graphics + + +Description + +Sets the filename extension to use on navigational graphics used +in the headers and footers of chunked HTML. + + + + + + +navig.graphics.path +string + +navig.graphics.path +Path to navigational graphics + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the navigational graphics used in the +headers and footers of chunked HTML. + + + + +images/ + + +navig.showtitles +boolean + +navig.showtitles +Display titles in HTML headers and footers? + + +Description + +If true (non-zero), +the headers and footers of chunked HTML +display the titles of the next and previous chunks, +along with the words 'Next' and 'Previous' (or the +equivalent graphical icons if navig.graphics is true). +If false (zero), then only the words 'Next' and 'Previous' +(or the icons) are displayed. + + + + +1 + + +profile.arch +string + +profile.arch +Target profile for arch +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.condition +string + +profile.condition +Target profile for condition +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.conformance +string + +profile.conformance +Target profile for conformance +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.lang +string + +profile.lang +Target profile for lang +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.os +string + +profile.os +Target profile for os +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.revision +string + +profile.revision +Target profile for revision +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.revisionflag +string + +profile.revisionflag +Target profile for revisionflag +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.role +string + +profile.role +Target profile for role +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + +Note that role is often +used for other purposes than profiling. For example it is commonly +used to get emphasize in bold font: + +<emphasis role="bold">very important</emphasis> + +If you are using role for +these purposes do not forget to add values like bold to +value of this parameter. If you forgot you will get document with +small pieces missing which are very hard to track. + +For this reason it is not recommended to use role attribute for profiling. You should +rather use profiling specific attributes like userlevel, os, arch, condition, etc. + + + + + + + +profile.security +string + +profile.security +Target profile for security +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.userlevel +string + +profile.userlevel +Target profile for userlevel +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.vendor +string + +profile.vendor +Target profile for vendor +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.attribute +string + +profile.attribute +Name of user-specified profiling attribute + + +Description + +This parameter is used in conjuction with profile.value. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.value +string + +profile.value +Target profile for user-specified attribute + + +Description + +When you are using this parameter you must also specify name of +profiling attribute with parameter profile.attribute. + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.separator +string + +profile.separator +Separator character for compound profile values + + +Description + +Separator character for compound profile values. + + + + + + +htmlhelp.encoding +string + +htmlhelp.encoding +Character encoding to use in files for HTML Help compiler. + + +Description + +HTML Help Compiler is not UTF-8 aware, so you should always use +apropriate single-byte encoding here. + + + + + + +htmlhelp.autolabel +boolean + +htmlhelp.autolabel +Should tree-like ToC use autonumbering feature? + + +Description + +If you want to include chapter and section numbers into ToC in +the left panel, set this parameter to 1. + + + + + + +htmlhelp.chm +string + +htmlhelp.chm +Filename of output HTML Help file. + + +Description + +Change this parameter if you want different name of result +CHM file than htmlhelp.chm. + + + + + + +htmlhelp.default.topic +string + +htmlhelp.default.topic +Name of file with default topic + + +Description + +Normally first chunk of document is displayed when you open HTML +Help file. If you want to display another topic, simply set its +filename by this parameter. + +This is useful especially if you don't generate ToC in front of +your document and you also hide root element in ToC. E.g.: + +<xsl:param name="generate.book.toc" select="0"/> +<xsl:param name="htmlhelp.hhc.show.root" select="0"/> +<xsl:param name="htmlhelp.default.topic" select="'pr01.html'"/> + + + + + + +htmlhelp.display.progress +boolean + +htmlhelp.display.progress +Display compile progress? + + +Description + +You can swith off display of compile progress by setting this +parameter to 0. + + + + + + +htmlhelp.hhp +string + +htmlhelp.hhp +Filename of project file. + + +Description + +Change this parameter if you want different name of project +file than htmlhelp.hhp. + + + + + + +htmlhelp.hhc +string + +htmlhelp.hhc +Filename of TOC file. + + +Description + +Change this parameter if you want different name of TOC file +than toc.hhc. + + + + + + +htmlhelp.hhk +string + +htmlhelp.hhk +Filename of index file. + + +Description + +Change this parameter if you want different name of index file +than index.hhk. + + + + + + +htmlhelp.hhp.tail +string + +htmlhelp.hhp.tail +Additional content for project file. + + +Description + +If you want to include some additional parameters into project file, +store appropriate part of project file into this parameter. + + + + + + +htmlhelp.hhp.window +string + +htmlhelp.hhp.window +Name of default window. + + +Description + +Name of default window. If empty no [WINDOWS] section will be +added to project file. + + + + + + +htmlhelp.hhp.windows +string + +htmlhelp.hhp.windows +Definition of additional windows + + +Description + +Content of this parameter is placed at the end of [WINDOWS] +section of project file. You can use it for defining your own +addtional windows. + + + + + + +htmlhelp.enhanced.decompilation +boolean + +htmlhelp.enhanced.decompilation +Allow enhanced decompilation of CHM? + + +Description + +When set to 1 this parameter enables enhanced decompilation of CHM. + + + + + + +htmlhelp.enumerate.images +boolean + +htmlhelp.enumerate.images +Should be paths to all used images added to project file? + + +Description + +You should turn on this flag, if you insert images into your documents +as external binary entities or if you are using absolute path in image names. + + + + + + +htmlhelp.force.map.and.alias +boolean + +htmlhelp.force.map.and.alias +Should be [MAP] and [ALIAS] section added to project file unconditionaly? + + +Description + +You should turn on this flag, if you have your own +alias.h and contex.h files +and you want include reference to them in project file. + + + + + + +htmlhelp.map.file +string + +htmlhelp.map.file +Filename of map file. + + +Description + +Change this parameter if you want different name of map file +than context.h. + + + + + + +htmlhelp.alias.file +string + +htmlhelp.alias.file +Filename of map file. + + +Description + +Change this parameter if you want different name of map file +than alias.h. + + + + + + +htmlhelp.hhc.section.depth +integer + +htmlhelp.hhc.section.depth +Depth of TOC for sections in a left pane. + + +Description + +Change this parameter if you want shallower ToC in a left pane +of HTML Help viewer. + + + + + + +htmlhelp.hhc.show.root +boolean + +htmlhelp.hhc.show.root +Should be entry for root element shown in ToC? + + +Description + +If set to 0, there will be no entry for root element in +ToC. This is useful when you want provide user with expanded ToC as +a default. + + + + + + +htmlhelp.hhc.folders.instead.books + + +htmlhelp.hhc.folders.instead.books +Use folder icons in ToC (instead of book icons)? + + +Description + +This parameter controls whether there should be folder-like +icons (1) or book-like icons (0) in ToC. If you want to use +folder-like icons you must swith off binary ToC using +htmlhelp.hhc.binary. + + + + + + +htmlhelp.hhc.binary + + +htmlhelp.hhc.binary +Generate binary ToC? + + +Description + +This parametr controls whether binary TOC will be generated. You +must create binary TOC if you want to add Prev/Next buttons to toolbar +(which is default behaviour). Files with binary TOC can't be merged. + + + + + + +htmlhelp.hhc.width +integer + +htmlhelp.hhc.width +Width of navigation (ToC) pane + + +Description + +This parameter specifies width of ToC pane in pixels. + + + + + + +htmlhelp.title +string + +htmlhelp.title +Title of HTML Help + + +Description + +Content of this parameter will be used as a title for generated +HTML Help. If empty, title will be automatically taken from document. + + + + + + +htmlhelp.show.menu +boolean + +htmlhelp.show.menu +Should be menu shown? + + +Description + +If you want application menu in your HTML Help file, turn this +parameter to 1. + + + + + + +htmlhelp.show.toolbar.text +boolean + +htmlhelp.show.toolbar.text +Show text under toolbar buttons? + + +Description + +You can switch off display of texts under toolbar buttons by +setting this parameter to 0. + + + + + + +htmlhelp.show.advanced.search +boolean + +htmlhelp.show.advanced.search +Should be advanced search available? + + +Description + +If you want advanced search features in your help, turn this +parameter to 1. + + + + + + +htmlhelp.show.favorities +boolean + +htmlhelp.show.favorities +Should be favorities tab shown? + + +Description + +If you want favorities tab shown in your help, turn this +parameter to 1. + + + + + + +htmlhelp.button.hideshow +boolean + +htmlhelp.button.hideshow +Should be Hide/Show button shown? + + +Description + +If you want Hide/Show button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.back +boolean + +htmlhelp.button.back +Should be Back button shown? + + +Description + +If you want Back button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.forward +boolean + +htmlhelp.button.forward +Should be Forward button shown? + + +Description + +If you want Forward button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.stop +boolean + +htmlhelp.button.stop +Should be Stop button shown? + + +Description + +If you want Stop button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.refresh +boolean + +htmlhelp.button.refresh +Should be Refresh button shown? + + +Description + +If you want Refresh button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.home +boolean + +htmlhelp.button.home +Should be Home button shown? + + +Description + +If you want Home button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.home.url +string + +htmlhelp.button.home.url +URL address of page accessible by Home button + + +Description + +URL address of page accessible by Home button. + + + + + + +htmlhelp.button.options +boolean + +htmlhelp.button.options +Should be Options button shown? + + +Description + +If you want Options button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.print +boolean + +htmlhelp.button.print +Should be Print button shown? + + +Description + +If you want Print button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.locate +boolean + +htmlhelp.button.locate +Should be Locate button shown? + + +Description + +If you want Locate button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.jump1 +boolean + +htmlhelp.button.jump1 +Should be Jump1 button shown? + + +Description + +If you want Jump1 button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.jump1.url +string + +htmlhelp.button.jump1.url +URL address of page accessible by Jump1 button + + +Description + +URL address of page accessible by Jump1 button. + + + + + + +htmlhelp.button.jump1.title +string + +htmlhelp.button.jump1.title +Title of Jump1 button + + +Description + +Title of Jump1 button. + + + + + + +htmlhelp.button.jump2 +boolean + +htmlhelp.button.jump2 +Should be Jump2 button shown? + + +Description + +If you want Jump2 button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.jump2.url +string + +htmlhelp.button.jump2.url +URL address of page accessible by Jump2 button + + +Description + +URL address of page accessible by Jump2 button. + + + + + + +htmlhelp.button.jump2.title +string + +htmlhelp.button.jump2.title +Title of Jump2 button + + +Description + +Title of Jump2 button. + + + + + + +htmlhelp.button.next +boolean + +htmlhelp.button.next +Should be Next button shown? + + +Description + +If you want Next button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.prev +boolean + +htmlhelp.button.prev +Should be Prev button shown? + + +Description + +If you want Prev button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.zoom +boolean + +htmlhelp.button.zoom +Should be Zoom button shown? + + +Description + +If you want Zoom button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.remember.window.position +boolean + +htmlhelp.remember.window.position +Remember help window position? + + +Description + +To remember help window position between starts set this +parameter to 1. + + + + + + +htmlhelp.window.geometry +string + +htmlhelp.window.geometry +Set initial geometry of help window + + +Description + +This parameter specifies initial position of help +window. E.g. + +<xsl:param name="htmlhelp.window.geometry">[160,64,992,704]</xsl:param> + + + + + + +htmlhelp.use.hhk +boolean + +htmlhelp.use.hhk +Should be index built using HHK file? + + +Description + +If non-zero, index is created using HHK file. This provides some +new features. + + + + + + +htmlhelp.only +boolean + +htmlhelp.only +Should be only project files generated? + + +Description + +If you want to play with various HTML Help parameters and you +don't need to regenerate all HTML files, you can set this parameter to +1. This setting will not process whole document, only project files +(hhp, hhc, hhk,...) will be generated. + + + + + + +eclipse.autolabel +boolean + +eclipse.autolabel +Should tree-like ToC use autonumbering feature? + + +Description + +If you want to include chapter and section numbers into ToC in +the left panel, set this parameter to 1. + + + + + + +eclipse.plugin.name +string + +eclipse.plugin.name +Eclipse Help plugin name + + +Description + +Eclipse Help plugin name. + + + +DocBook Online Help Sample + + +eclipse.plugin.id +string + +eclipse.plugin.id +Eclipse Help plugin id + + +Description + +Eclipse Help plugin id. You should change this id to something +unique for each help. + + + +com.example.help + + +eclipse.plugin.provider +string + +eclipse.plugin.provider +Eclipse Help plugin provider name + + +Description + +Eclipse Help plugin provider name. + + + +Example provider + + +l10n.gentext.language +string + +l10n.gentext.language +Sets the gentext language + + +Description + +If this parameter is set to any value other than the empty string, its +value will be used as the value for the language when generating text. Setting +l10n.gentext.language overrides any settings within the +document being formatted. + +It's much more likely that you might want to set the +l10n.gentext.default.language parameter. + + + + + + +l10n.gentext.default.language +string + +l10n.gentext.default.language +Sets the default language for generated text + + +Description + +The value of the l10n.gentext.default.language +parameter is used as the language for generated text if no setting is provided +in the source document. + + + + + + +l10n.gentext.use.xref.language +boolean + +l10n.gentext.use.xref.language +Use the language of target when generating cross-reference text? + + +Description + +If non-zero, the language of the target will be used when +generating cross reference text. Usually, the current +language is used when generating text (that is, the language of the +element that contains the cross-reference element). But setting this parameter +allows the language of the element pointed to to control +the generated text. + +Consider the following example: + + +<para lang="en">See also <xref linkend="chap3"/>.</para> + + + +Suppose that Chapter 3 happens to be written in German. +If l10n.gentext.use.xref.language is non-zero, the +resulting text will be something like this: + +
                  +See also Kapital 3. +
                  + +Where the more traditional rendering would be: + +
                  +See also Chapter 3. +
                  + +                   +                   + + + +l10n.lang.value.rfc.compliant +boolean + +l10n.lang.value.rfc.compliant +Make value of lang attribute RFC compliant? + + +Description + +If non-zero, ensure that the values for all lang attributes in HTML output are RFC +compliantSection 8.1.1, Language Codes, in the HTML 4.0 Recommendation states that: + +
                  [RFC1766] defines and explains the language codes +that must be used in HTML documents. +Briefly, language codes consist of a primary code and a possibly +empty series of subcodes: + +language-code = primary-code ( "-" subcode )* + +And in RFC 1766, Tags for the Identification +of Languages, the EBNF for "language tag" is given as: + +Language-Tag = Primary-tag *( "-" Subtag ) +Primary-tag = 1*8ALPHA +Subtag = 1*8ALPHA + +
                  +                  . + +by taking any underscore characters in any lang values found in source documents, and +replacing them with hyphen characters in output HTML files. For +example, zh_CN in a source document becomes +zh-CN in the HTML output form that source. + + +This parameter does not cause any case change in lang values, because RFC 1766 +explicitly states that all "language tags" (as it calls them) "are +to be treated as case insensitive". + +                   + +                   +                   + +                   \ No newline at end of file diff --git a/src/documentation/docbook-xsl/html/param.xweb b/src/documentation/docbook-xsl/html/param.xweb new file mode 100644 index 0000000000..b37768f63f --- /dev/null +++ b/src/documentation/docbook-xsl/html/param.xweb @@ -0,0 +1,742 @@ + +%param.ent; +]> + + +HTML Parameter Reference + +$Id: param.xweb,v 1.103 2006/05/14 06:22:26 bobstayton Exp $ + + + Walsh + Norman + + + 1999 + 2000 + 2001 + Norman Walsh + + + +Introduction + +This is reference documentation for all user-configurable +parameters in the DocBook XSL HTML stylesheets (for generating +HTML output). + +This reference describes each of the HTML Stylesheet parameters. +These are the easily customizable parts of the stylesheet. +If you want to specify an alternate value for one or more of these +parameters, you can do so in a driver stylesheet. + +For example, if you want to change the html.stylesheet +to reference.css, you might create a driver +stylesheet like this: + + + + + + reference.css + +]]> + +Naturally, you have to change the +href attribute on +<xsl:import> to point to +docbook.xsl on your system. (Or +chunk.xsl, if you're using chunking.) + + +Admonitions +&admon.graphics.extension; +&admon.graphics.path; +&admon.graphics; +&admon.textlabel; +&admon.style; + + +Callouts +&callout.defaultcolumn; +&callout.graphics.extension; +&callout.graphics.number.limit; +&callout.graphics.path; +&callout.graphics; +&callout.list.table; +&callout.unicode.number.limit; +&callout.unicode.start.character; +&callout.unicode; +&callouts.extension; + + +EBNF +&ebnf.table.bgcolor; +&ebnf.table.border; +&ebnf.assignment; +&ebnf.statement.terminator; + + +ToC/LoT/Index Generation +&annotate.toc; +&autotoc.label.separator; +&autotoc.label.in.hyperlink; +&process.source.toc; +&process.empty.source.toc; +&bridgehead.in.toc; +&simplesect.in.toc; +&manual.toc; +&toc.list.type; +&toc.section.depth; +&toc.max.depth; +&generate.toc; +&generate.section.toc.level; +&generate.index; +&index.method; +&index.on.type; +&index.on.role; +&index.prefer.titleabbrev; +&index.term.separator; +&index.number.separator; +&index.range.separator; + + +Stylesheet Extensions +&linenumbering.everyNth; +&linenumbering.extension; +&linenumbering.separator; +&linenumbering.width; +&tablecolumns.extension; +&textinsert.extension; +&textdata.default.encoding; +&graphicsize.extension; +&graphicsize.use.img.src.path; +&use.extensions; + + +Automatic labelling +&chapter.autolabel; +&appendix.autolabel; +&part.autolabel; +&preface.autolabel; +&qandadiv.autolabel; +§ion.autolabel; +§ion.autolabel.max.depth; +§ion.label.includes.component.label; +&label.from.part; +&component.label.includes.part.label; + + + + +HTML +&html.base; +&html.stylesheet.type; +&html.stylesheet; +&css.decoration; +&spacing.paras; +&emphasis.propagates.style; +¶.propagates.style; +&phrase.propagates.style; +&entry.propagates.style; +&html.longdesc; +&html.longdesc.link; +&make.valid.html; +&html.cleanup; +&draft.mode; +&draft.watermark.image; +&generate.id.attributes; +&generate.meta.abstract; + + +XSLT Processing +&rootid; +&suppress.navigation; +&suppress.header.navigation; +&suppress.footer.navigation; +&header.rule; +&footer.rule; +&id.warnings; + + +Meta/*Info +&inherit.keywords; +&make.single.year.ranges; +&make.year.ranges; +&author.othername.in.middle; +&generate.legalnotice.link; +&generate.revhistory.link; +&html.head.legalnotice.link.types; +&html.head.legalnotice.link.multiple; + + +Reference Pages +&funcsynopsis.decoration; +&funcsynopsis.style; +&funcsynopsis.tabular.threshold; +&function.parens; +&refentry.generate.name; +&refentry.generate.title; +&refentry.xref.manvolnum; +&citerefentry.link; +&refentry.separator; +&refclass.suppress; + + +Tables +&default.table.width; +&nominal.table.width; +&table.borders.with.css; +&table.cell.border.style; +&table.cell.border.thickness; +&table.cell.border.color; +&table.frame.border.style; +&table.frame.border.thickness; +&table.frame.border.color; +&default.table.frame; +&html.cellspacing; +&html.cellpadding; + + +QAndASet +&qanda.defaultlabel; +&qanda.inherit.numeration; + + +Linking +&target.database.document; +&targets.filename; +&olink.base.uri; +&use.local.olink.style; +¤t.docid; +&olink.doctitle; +&olink.debug; +&olink.properties; +&olink.lang.fallback.sequence; +&insert.olink.page.number; +&insert.olink.pdf.frag; +&prefer.internal.olink; +&link.mailto.url; +&ulink.target; +&olink.fragid; +&olink.outline.ext; +&olink.pubid; +&olink.sysid; +&olink.resolver; + + +Cross References +&collect.xref.targets; +&insert.xref.page.number; +&use.role.as.xrefstyle; +&xref.with.number.and.title; +&xref.label-page.separator; +&xref.label-title.separator; +&xref.title-page.separator; + + +Lists +&segmentedlist.as.table; +&variablelist.as.table; +&variablelist.term.separator; +&variablelist.term.break.after; + + +Bibliography +&biblioentry.item.separator; +&bibliography.collection; +&bibliography.numbered; + + +Glossary +&glossterm.auto.link; +&firstterm.only.link; +&glossary.collection; +&glossentry.show.acronym; + + +Miscellaneous +&formal.procedures; +&formal.title.placement; +&runinhead.default.title.end.punct; +&runinhead.title.end.punct; +&show.comments; +&show.revisionflag; +&shade.verbatim; +&shade.verbatim.style; +&punct.honorific; +&tex.math.in.alt; +&tex.math.file; +&tex.math.delims; +&pixels.per.inch; +&points.per.em; +&use.svg; +&menuchoice.separator; +&menuchoice.menu.separator; +&default.float.class; +&footnote.number.format; +&table.footnote.number.format; +&footnote.number.symbols; +&table.footnote.number.symbols; + + +Annotations +&annotation.support; +&annotation.js; +&annotation.css; +&annotation.graphic.open; +&annotation.graphic.close; + + +Graphics +&img.src.path; +&keep.relative.image.uris; +&graphic.default.extension; +&default.image.width; +&nominal.image.width; +&nominal.image.depth; +&use.embed.for.svg; +&make.graphic.viewport; +&preferred.mediaobject.role; +&use.role.for.mediaobject; +&ignore.image.scaling; + + +Chunking +&chunker.output.cdata-section-elements; +&chunker.output.doctype-public; +&chunker.output.doctype-system; +&chunker.output.encoding; +&chunker.output.indent; +&chunker.output.media-type; +&chunker.output.method; +&chunker.output.omit-xml-declaration; +&chunker.output.standalone; +&saxon.character.representation; +&html.ext; +&use.id.as.filename; +&html.extra.head.links; +&root.filename; +&base.dir; +&generate.manifest; +&manifest; +&manifest.in.base.dir; +&chunk.toc; +&chunk.tocs.and.lots; +&chunk.separate.lots; +&chunk.tocs.and.lots.has.title; +&chunk.section.depth; +&chunk.first.sections; +&chunk.quietly; +&navig.graphics; +&navig.graphics.extension; +&navig.graphics.path; +&navig.showtitles; + + +Profiling + +Following parameters can be used for attribute value based +profiling of your document. For more info about profiling look at +http://docbook.sourceforge.net/projects/xsl/doc/tools/profiling.html. + +&profile.arch; +&profile.condition; +&profile.conformance; +&profile.lang; +&profile.os; +&profile.revision; +&profile.revisionflag; +&profile.role; +&profile.security; +&profile.userlevel; +&profile.vendor; +&profile.attribute; +&profile.value; +&profile.separator; + + +HTML Help +&htmlhelp.encoding; +&htmlhelp.autolabel; +&htmlhelp.chm; +&htmlhelp.default.topic; +&htmlhelp.display.progress; +&htmlhelp.hhp; +&htmlhelp.hhc; +&htmlhelp.hhk; +&htmlhelp.hhp.tail; +&htmlhelp.hhp.window; +&htmlhelp.hhp.windows; +&htmlhelp.enhanced.decompilation; +&htmlhelp.enumerate.images; +&htmlhelp.force.map.and.alias; +&htmlhelp.map.file; +&htmlhelp.alias.file; +&htmlhelp.hhc.section.depth; +&htmlhelp.hhc.show.root; +&htmlhelp.hhc.folders.instead.books; +&htmlhelp.hhc.binary; +&htmlhelp.hhc.width; +&htmlhelp.title; +&htmlhelp.show.menu; +&htmlhelp.show.toolbar.text; +&htmlhelp.show.advanced.search; +&htmlhelp.show.favorities; +&htmlhelp.button.hideshow; +&htmlhelp.button.back; +&htmlhelp.button.forward; +&htmlhelp.button.stop; +&htmlhelp.button.refresh; +&htmlhelp.button.home; +&htmlhelp.button.home.url; +&htmlhelp.button.options; +&htmlhelp.button.print; +&htmlhelp.button.locate; +&htmlhelp.button.jump1; +&htmlhelp.button.jump1.url; +&htmlhelp.button.jump1.title; +&htmlhelp.button.jump2; +&htmlhelp.button.jump2.url; +&htmlhelp.button.jump2.title; +&htmlhelp.button.next; +&htmlhelp.button.prev; +&htmlhelp.button.zoom; +&htmlhelp.remember.window.position; +&htmlhelp.window.geometry; +&htmlhelp.use.hhk; +&htmlhelp.only; + + +Eclipse Help Platform +&eclipse.autolabel; +&eclipse.plugin.name; +&eclipse.plugin.id; +&eclipse.plugin.provider; + + +Localization +&l10n.gentext.language; +&l10n.gentext.default.language; +&l10n.gentext.use.xref.language; +&l10n.lang.value.rfc.compliant; + + +The Stylesheet + +The param.xsl stylesheet is just a wrapper +around all these parameters. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/html/pi.xsl b/src/documentation/docbook-xsl/html/pi.xsl new file mode 100644 index 0000000000..0772dac3c1 --- /dev/null +++ b/src/documentation/docbook-xsl/html/pi.xsl @@ -0,0 +1,251 @@ + + + + + + + + + + + + + + + + + filename + + + + + + + + + + + + filename + + + + + + + + + + + + + + + + + + + + + + dir + + + + + + + + + + + + + + / + + + + / + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + +
                  + + + + + +                   +                   +                   + + + + + + No cmdsynopsis elements matched dbcmdlist PI, perhaps it's nested too deep? + + + +
                  + + + +
                  +                   + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + +
                  + + + + + +                   +                   +                   + + + + + + No funcsynopsis elements matched dbfunclist PI, perhaps it's nested too deep? + + + +
                  + + + +
                  +                   + + + + + + + + + + href + + + + + + + + + + + + + + + + + + + + + ERROR: dbhtml-include processing instruction + href has no content. + + + + + + + ERROR: dbhtml-include processing instruction has + missing or empty href value. + + + + + +                   diff --git a/src/documentation/docbook-xsl/html/profile-chunk-code.xsl b/src/documentation/docbook-xsl/html/profile-chunk-code.xsl new file mode 100644 index 0000000000..77c63e4d7b --- /dev/null +++ b/src/documentation/docbook-xsl/html/profile-chunk-code.xsl @@ -0,0 +1,757 @@ + + + + + + + + + + + + + + + + + + + + + + Computing chunks... + + + + + Fast chunking requires exsl:node-set(). + Using "slow" chunking. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Error + + is not a chunk! + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Stripping NS from DocBook 5/NG document.Processing stripped document. + + + + + + + + + ID ' + + ' not found in document. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -toc + + + + + + + + + + + +

                  + +

                  +                   + +                   +                   +                   + +                   +                   + + + +                   +                   +                   + + + + + + + + + + + + + -toc + + + + + + + + + + + -toc + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +
                  +
                  + + + + +
                  +                   + + + +
                  +
                  +

                  The following annotations are from this essay. You are seeing + them here because your browser doesn’t support the user-interface + techniques used to make them appear as ‘popups’ on modern browsers.

                  +
                  + + +
                  +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/html/profile-chunk.xsl b/src/documentation/docbook-xsl/html/profile-chunk.xsl new file mode 100644 index 0000000000..44796647eb --- /dev/null +++ b/src/documentation/docbook-xsl/html/profile-chunk.xsl @@ -0,0 +1,40 @@ + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/html/profile-docbook.xsl b/src/documentation/docbook-xsl/html/profile-docbook.xsl new file mode 100644 index 0000000000..769b17f70f --- /dev/null +++ b/src/documentation/docbook-xsl/html/profile-docbook.xsl @@ -0,0 +1,394 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No template matches + + + in + + + . + + + + < + + > + + </ + + > + + + + + + + + + white + black + #0000FF + #840084 + #0000FF + + + + + + + + + + <xsl:copy-of select="$title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Stripping NS from DocBook 5/NG document.Processing stripped document. + + + + + + + + + ID ' + + ' not found in document. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + diff --git a/src/documentation/docbook-xsl/html/profile-onechunk.xsl b/src/documentation/docbook-xsl/html/profile-onechunk.xsl new file mode 100644 index 0000000000..53cbfd0c90 --- /dev/null +++ b/src/documentation/docbook-xsl/html/profile-onechunk.xsl @@ -0,0 +1,37 @@ + + + + + + + + + + + + + + + +1 + + + + # + + + + + + diff --git a/src/documentation/docbook-xsl/html/qandaset.xsl b/src/documentation/docbook-xsl/html/qandaset.xsl new file mode 100644 index 0000000000..615fd77b47 --- /dev/null +++ b/src/documentation/docbook-xsl/html/qandaset.xsl @@ -0,0 +1,367 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1% + + + + + + +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + +
                  +                   + + +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + +
                  +                   + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/html/refentry.xsl b/src/documentation/docbook-xsl/html/refentry.xsl new file mode 100644 index 0000000000..d55c8770ee --- /dev/null +++ b/src/documentation/docbook-xsl/html/refentry.xsl @@ -0,0 +1,297 @@ + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

                  + +

                  +                   + + + + +
                  + + + + + +
                  +
                  +
                  +                   + + + + + + +
                  +                   + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + +
                  + + + + + + + + + + +

                  + + + +

                  +                   + +

                  + + + + + + + + +

                  +                   +                   + +

                  + +

                  +
                  +                   + + + + + + , + + + + + + + + em-dash + + + + + + + + + + + +

                  + + + + : + + + +

                  +                   +                   + + +
                  + + + + +

                  + + + + + + + + + + +

                  + +
                  +                   + + + + + + + + + + + +
                  + + + + + + + + +
                  +                   + + + + + + 0 + 1 + + + + 6 + + + + + + + + + + + + +

                  + +

                  +                   + + + +

                  + +

                  +                   + + + +

                  + +

                  +                   + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/html/sections.xsl b/src/documentation/docbook-xsl/html/sections.xsl new file mode 100644 index 0000000000..392285b250 --- /dev/null +++ b/src/documentation/docbook-xsl/html/sections.xsl @@ -0,0 +1,586 @@ + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + 1 + 2 + 3 + 4 + 5 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 6 + + + + + + + + + + clear: both + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + 1 + + + + + + + 2 + 3 + 4 + 5 + 6 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   + diff --git a/src/documentation/docbook-xsl/html/synop.xsl b/src/documentation/docbook-xsl/html/synop.xsl new file mode 100644 index 0000000000..f2e313e883 --- /dev/null +++ b/src/documentation/docbook-xsl/html/synop.xsl @@ -0,0 +1,1463 @@ + + +]> + + + + + + + + + + + +
                  +

                  + + +

                  +
                  +                   + + +
                  + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + + + + ( + + ) + +   + + + + + + + + + + + + +

                  + + ( + + ) + + + +

                  +                   + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

                  + + +
                  + +                   +

                  +                   + + + + + ( + + + + + + + + + + + + + + + + ) + ; + + + + ... + ) + ; + + + + + + + , + + + ) + ; + + + + + + + + + + + + + + + + + + + + +
                  + + + + ; +                   + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + +
                  + +
                   
                  + + + + padding-bottom: 1em + + +
                  +                   +                   + + + + + ( + + + + + + + + + + + + + + + + + ) + ; + +   + + + + + ... + ) + ; + +   + + + + + + + + , + + + ) + ; + + + +   + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + + + + + + + + + +   + + + + + + ; + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + ; + + + + + + +

                  + +

                  +                   + + + + + ( + + + + + + + + + + + + + + + + void) + ; + + + + ... + ) + ; + + + + + + + , + + + ) + ; + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + padding-bottom: 1em + + + + + + + + + + + +
                  + +
                   
                  +                   + + + + + ( + + + + + + + + + + + + + + + + + void) + ; + +   + + + + + ... + ) + ; + +   + + + + + + + +   + + + + + + , + + + ) + ; + + + + + + + +   + + + + + + + , + + + ) + ; + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + +java + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unrecognized language on + + : + + + + + + + + + + + +
                  +                   +                   + + + + + + 
                  +    
+    
+       extends
+      
+      
+        
                  
+	    
+                        
+                      
+    
+      implements
+      
+      
+        
                  
+	    
+                        
+                      
+    
+      throws
+      
+    
+     {
+    
                  
+    
+    }
+
                  +                   + + + + + + + + + , + + + + + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + 0 + + , +
                  + + +   + + + +                   + + + +                   + + + + + + + + + + + + + +    + + + + + + + + + + + + + + ( + + + + ) + +
                  +     throws  + +                   + + + + + ; +                   + +                   + + + + + 
                  +    
+    
+      : 
+      
+      
+        
                  
+	    
+                        
+                      
+    
+       implements
+      
+      
+        
                  
+	    
+                        
+                      
+    
+       throws
+      
+    
+     {
+    
                  
+    
+    }
+
                  +                   + + + + + + + + , + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + +    + + + + + + + + + + ( + + ) + +
                  +     throws  + +                   + + + + + ; +                   + +                   + + + + + 
                  +    interface 
+    
+    
+      : 
+      
+      
+        
                  
+	    
+                        
+                      
+    
+       implements
+      
+      
+        
                  
+	    
+                        
+                      
+    
+       throws
+      
+    
+     {
+    
                  
+    
+    }
+
                  +                   + + + + + + + + , + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + +    + + + + + + + + + + ( + + ) + +
                  +     raises( + + ) +                   + + + + + ; +                   + +                   + + + + + 
                  +    package 
+    
+    ;
+    
                  
+
+    
+      @ISA = (
+      
+      );
+      
                  
+                      
+
+    
+
                  +                   + + + + + + + + , + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + sub + + + { ... }; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/html/table.xsl b/src/documentation/docbook-xsl/html/table.xsl new file mode 100644 index 0000000000..01a2afd703 --- /dev/null +++ b/src/documentation/docbook-xsl/html/table.xsl @@ -0,0 +1,1105 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + + + + + + + border- + + : + + + + + + ; + + + + + border- + + -width: + + ; + + + + border- + + -style: + + ; + + + + border- + + -color: + + ; + + + + + + + + + + + Error: CALS tables must specify the number of columns. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 100% + + + + + 0 + + + + border-collapse: collapse; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + border-collapse: collapse; + + + + + + + + + + + + + + + + + border-collapse: collapse; + + + + + + + + + + + border-collapse: collapse; + + + + + + + + + + + border-collapse: collapse; + + + + + + + + + + + + + + + + + border-collapse: collapse; + + + + + + 0 + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + 100% + + + + + + + + + + + + + + + + + + + + + + + + No convertLength function available. + + + + + + + + + + + + + + + + + + + + + + + + + + No adjustColumnWidths function available. + + + + + + + + + + + + + + + + + + + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + th + th + td + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + : + + + + + + + + 0: + + + + + + + + + + + + + + + 0 + + : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   + diff --git a/src/documentation/docbook-xsl/html/task.xsl b/src/documentation/docbook-xsl/html/task.xsl new file mode 100644 index 0000000000..bc9b15f36a --- /dev/null +++ b/src/documentation/docbook-xsl/html/task.xsl @@ -0,0 +1,75 @@ + + + + + + + + + + + + + + + + before + + + + + + + + +
                  + + + + + + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/html/titlepage.templates.xml b/src/documentation/docbook-xsl/html/titlepage.templates.xml new file mode 100644 index 0000000000..664dc14e2e --- /dev/null +++ b/src/documentation/docbook-xsl/html/titlepage.templates.xml @@ -0,0 +1,662 @@ + + + + + + + + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <hr/> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="set" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <hr/> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="book" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <hr/> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="part" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="division.title" + param:node="ancestor-or-self::part[1]"/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="partintro" t:wrapper="div"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="reference" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <hr/> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="refentry" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> +<!-- uncomment this if you want refentry titlepages + <title t:force="1" + t:named-template="refentry.title" + param:node="ancestor-or-self::refentry[1]"/> +--> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator/> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + + <t:titlepage t:element="dedication" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::dedication[1]"/> + <subtitle/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="preface" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="chapter" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="appendix" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="section" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <xsl:if test="count(parent::*)='0'"><hr/></xsl:if> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="sect1" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <xsl:if test="count(parent::*)='0'"><hr/></xsl:if> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="sect2" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <xsl:if test="count(parent::*)='0'"><hr/></xsl:if> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="sect3" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <xsl:if test="count(parent::*)='0'"><hr/></xsl:if> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="sect4" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <xsl:if test="count(parent::*)='0'"><hr/></xsl:if> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="sect5" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <xsl:if test="count(parent::*)='0'"><hr/></xsl:if> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<t:titlepage t:element="simplesect" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title/> + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <xsl:if test="count(parent::*)='0'"><hr/></xsl:if> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="bibliography" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::bibliography[1]"/> + <subtitle/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="glossary" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::glossary[1]"/> + <subtitle/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="index" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::index[1]"/> + <subtitle/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +<t:titlepage t:element="setindex" t:wrapper="div" class="titlepage"> + <t:titlepage-content t:side="recto"> + <title + t:force="1" + t:named-template="component.title" + param:node="ancestor-or-self::setindex[1]"/> + <subtitle/> + </t:titlepage-content> + + <t:titlepage-content t:side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + </t:titlepage-separator> + + <t:titlepage-before t:side="recto"> + </t:titlepage-before> + + <t:titlepage-before t:side="verso"> + </t:titlepage-before> +</t:titlepage> + +<!-- ==================================================================== --> + +</t:templates> diff --git a/src/documentation/docbook-xsl/html/titlepage.templates.xsl b/src/documentation/docbook-xsl/html/titlepage.templates.xsl new file mode 100644 index 0000000000..8f585f9d38 --- /dev/null +++ b/src/documentation/docbook-xsl/html/titlepage.templates.xsl @@ -0,0 +1,3619 @@ +<?xml version="1.0" encoding="utf-8"?><xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:exsl="http://exslt.org/common" version="1.0" exclude-result-prefixes="exsl"> + +<!-- This stylesheet was created by template/titlepage.xsl; do not edit it by hand. --> + +<xsl:template name="article.titlepage.recto"> + <xsl:choose> + <xsl:when test="articleinfo/title"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/title"/> + </xsl:when> + <xsl:when test="artheader/title"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="articleinfo/subtitle"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/subtitle"/> + </xsl:when> + <xsl:when test="artheader/subtitle"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/corpauthor"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/corpauthor"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/authorgroup"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/authorgroup"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/author"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/author"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/othercredit"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/othercredit"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/releaseinfo"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/releaseinfo"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/copyright"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/copyright"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/legalnotice"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/legalnotice"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/pubdate"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/pubdate"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/revision"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/revision"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/revhistory"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/revhistory"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="articleinfo/abstract"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="artheader/abstract"/> + <xsl:apply-templates mode="article.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="article.titlepage.verso"> +</xsl:template> + +<xsl:template name="article.titlepage.separator"><hr/> +</xsl:template> + +<xsl:template name="article.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="article.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="article.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="article.titlepage.before.recto"/> + <xsl:call-template name="article.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="article.titlepage.before.verso"/> + <xsl:call-template name="article.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="article.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="article.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="article.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="article.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="article.titlepage.recto.style"> +<xsl:apply-templates select="." mode="article.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="set.titlepage.recto"> + <xsl:choose> + <xsl:when test="setinfo/title"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="setinfo/subtitle"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/corpauthor"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/authorgroup"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/author"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/othercredit"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/releaseinfo"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/copyright"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/legalnotice"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/pubdate"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/revision"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/revhistory"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="setinfo/abstract"/> + <xsl:apply-templates mode="set.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="set.titlepage.verso"> +</xsl:template> + +<xsl:template name="set.titlepage.separator"><hr/> +</xsl:template> + +<xsl:template name="set.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="set.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="set.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="set.titlepage.before.recto"/> + <xsl:call-template name="set.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="set.titlepage.before.verso"/> + <xsl:call-template name="set.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="set.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="set.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="set.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="set.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="set.titlepage.recto.style"> +<xsl:apply-templates select="." mode="set.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="book.titlepage.recto"> + <xsl:choose> + <xsl:when test="bookinfo/title"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="bookinfo/subtitle"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/corpauthor"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/authorgroup"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/author"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/othercredit"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/releaseinfo"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/copyright"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/legalnotice"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/pubdate"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/revision"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/revhistory"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="bookinfo/abstract"/> + <xsl:apply-templates mode="book.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="book.titlepage.verso"> +</xsl:template> + +<xsl:template name="book.titlepage.separator"><hr/> +</xsl:template> + +<xsl:template name="book.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="book.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="book.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="book.titlepage.before.recto"/> + <xsl:call-template name="book.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="book.titlepage.before.verso"/> + <xsl:call-template name="book.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="book.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="book.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="book.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="book.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="book.titlepage.recto.style"> +<xsl:apply-templates select="." mode="book.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="part.titlepage.recto"> + <div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:call-template name="division.title"> +<xsl:with-param name="node" select="ancestor-or-self::part[1]"/> +</xsl:call-template></div> + <xsl:choose> + <xsl:when test="partinfo/subtitle"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/corpauthor"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/authorgroup"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/author"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/othercredit"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/releaseinfo"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/copyright"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/legalnotice"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/pubdate"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/revision"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/revhistory"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="partinfo/abstract"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="part.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="part.titlepage.verso"> +</xsl:template> + +<xsl:template name="part.titlepage.separator"> +</xsl:template> + +<xsl:template name="part.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="part.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="part.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="part.titlepage.before.recto"/> + <xsl:call-template name="part.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="part.titlepage.before.verso"/> + <xsl:call-template name="part.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="part.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="part.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="part.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="part.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="part.titlepage.recto.style"> +<xsl:apply-templates select="." mode="part.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="partintro.titlepage.recto"> + <xsl:choose> + <xsl:when test="partintroinfo/title"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="partintroinfo/subtitle"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/corpauthor"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/authorgroup"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/author"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/othercredit"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/releaseinfo"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/copyright"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/legalnotice"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/pubdate"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/revision"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/revhistory"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="partintroinfo/abstract"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="partintro.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="partintro.titlepage.verso"> +</xsl:template> + +<xsl:template name="partintro.titlepage.separator"> +</xsl:template> + +<xsl:template name="partintro.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="partintro.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="partintro.titlepage"> + <div> + <xsl:variable name="recto.content"> + <xsl:call-template name="partintro.titlepage.before.recto"/> + <xsl:call-template name="partintro.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="partintro.titlepage.before.verso"/> + <xsl:call-template name="partintro.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="partintro.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="partintro.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="partintro.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="partintro.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="partintro.titlepage.recto.style"> +<xsl:apply-templates select="." mode="partintro.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="reference.titlepage.recto"> + <xsl:choose> + <xsl:when test="referenceinfo/title"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="referenceinfo/subtitle"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/corpauthor"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/authorgroup"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/author"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/othercredit"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/releaseinfo"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/copyright"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/legalnotice"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/pubdate"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/revision"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/revhistory"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="referenceinfo/abstract"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="reference.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="reference.titlepage.verso"> +</xsl:template> + +<xsl:template name="reference.titlepage.separator"><hr/> +</xsl:template> + +<xsl:template name="reference.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="reference.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="reference.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="reference.titlepage.before.recto"/> + <xsl:call-template name="reference.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="reference.titlepage.before.verso"/> + <xsl:call-template name="reference.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="reference.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="reference.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="reference.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="reference.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="reference.titlepage.recto.style"> +<xsl:apply-templates select="." mode="reference.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="refentry.titlepage.recto"> +</xsl:template> + +<xsl:template name="refentry.titlepage.verso"> +</xsl:template> + +<xsl:template name="refentry.titlepage.separator"> +</xsl:template> + +<xsl:template name="refentry.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="refentry.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="refentry.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="refentry.titlepage.before.recto"/> + <xsl:call-template name="refentry.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="refentry.titlepage.before.verso"/> + <xsl:call-template name="refentry.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="refentry.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="refentry.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="refentry.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template name="dedication.titlepage.recto"> + <div xsl:use-attribute-sets="dedication.titlepage.recto.style"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::dedication[1]"/> +</xsl:call-template></div> + <xsl:choose> + <xsl:when test="dedicationinfo/subtitle"> + <xsl:apply-templates mode="dedication.titlepage.recto.auto.mode" select="dedicationinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="dedication.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="dedication.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="dedication.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="dedication.titlepage.verso"> +</xsl:template> + +<xsl:template name="dedication.titlepage.separator"> +</xsl:template> + +<xsl:template name="dedication.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="dedication.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="dedication.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="dedication.titlepage.before.recto"/> + <xsl:call-template name="dedication.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="dedication.titlepage.before.verso"/> + <xsl:call-template name="dedication.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="dedication.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="dedication.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="dedication.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="dedication.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="dedication.titlepage.recto.style"> +<xsl:apply-templates select="." mode="dedication.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="preface.titlepage.recto"> + <xsl:choose> + <xsl:when test="prefaceinfo/title"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="prefaceinfo/subtitle"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/corpauthor"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/authorgroup"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/author"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/othercredit"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/releaseinfo"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/copyright"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/legalnotice"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/pubdate"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/revision"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/revhistory"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="prefaceinfo/abstract"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="preface.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="preface.titlepage.verso"> +</xsl:template> + +<xsl:template name="preface.titlepage.separator"> +</xsl:template> + +<xsl:template name="preface.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="preface.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="preface.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="preface.titlepage.before.recto"/> + <xsl:call-template name="preface.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="preface.titlepage.before.verso"/> + <xsl:call-template name="preface.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="preface.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="preface.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="preface.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="preface.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="preface.titlepage.recto.style"> +<xsl:apply-templates select="." mode="preface.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="chapter.titlepage.recto"> + <xsl:choose> + <xsl:when test="chapterinfo/title"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="chapterinfo/subtitle"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/corpauthor"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/authorgroup"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/author"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/othercredit"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/releaseinfo"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/copyright"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/legalnotice"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/pubdate"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/revision"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/revhistory"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="chapterinfo/abstract"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="chapter.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="chapter.titlepage.verso"> +</xsl:template> + +<xsl:template name="chapter.titlepage.separator"> +</xsl:template> + +<xsl:template name="chapter.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="chapter.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="chapter.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="chapter.titlepage.before.recto"/> + <xsl:call-template name="chapter.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="chapter.titlepage.before.verso"/> + <xsl:call-template name="chapter.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="chapter.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="chapter.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="chapter.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="chapter.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="chapter.titlepage.recto.style"> +<xsl:apply-templates select="." mode="chapter.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="appendix.titlepage.recto"> + <xsl:choose> + <xsl:when test="appendixinfo/title"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="appendixinfo/subtitle"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/corpauthor"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/authorgroup"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/author"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/othercredit"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/releaseinfo"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/copyright"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/legalnotice"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/pubdate"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/revision"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/revhistory"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="appendixinfo/abstract"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="appendix.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="appendix.titlepage.verso"> +</xsl:template> + +<xsl:template name="appendix.titlepage.separator"> +</xsl:template> + +<xsl:template name="appendix.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="appendix.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="appendix.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="appendix.titlepage.before.recto"/> + <xsl:call-template name="appendix.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="appendix.titlepage.before.verso"/> + <xsl:call-template name="appendix.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="appendix.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="appendix.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="appendix.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="appendix.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="appendix.titlepage.recto.style"> +<xsl:apply-templates select="." mode="appendix.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="section.titlepage.recto"> + <xsl:choose> + <xsl:when test="sectioninfo/title"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sectioninfo/subtitle"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/corpauthor"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/authorgroup"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/author"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/othercredit"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/releaseinfo"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/copyright"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/legalnotice"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/pubdate"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/revision"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/revhistory"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="sectioninfo/abstract"/> + <xsl:apply-templates mode="section.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="section.titlepage.verso"> +</xsl:template> + +<xsl:template name="section.titlepage.separator"><xsl:if test="count(parent::*)='0'"><hr/></xsl:if> +</xsl:template> + +<xsl:template name="section.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="section.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="section.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="section.titlepage.before.recto"/> + <xsl:call-template name="section.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="section.titlepage.before.verso"/> + <xsl:call-template name="section.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="section.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="section.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="section.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="section.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="section.titlepage.recto.style"> +<xsl:apply-templates select="." mode="section.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="sect1.titlepage.recto"> + <xsl:choose> + <xsl:when test="sect1info/title"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sect1info/subtitle"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/corpauthor"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/authorgroup"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/author"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/othercredit"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/releaseinfo"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/copyright"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/legalnotice"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/pubdate"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/revision"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/revhistory"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="sect1info/abstract"/> + <xsl:apply-templates mode="sect1.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="sect1.titlepage.verso"> +</xsl:template> + +<xsl:template name="sect1.titlepage.separator"><xsl:if test="count(parent::*)='0'"><hr/></xsl:if> +</xsl:template> + +<xsl:template name="sect1.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="sect1.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="sect1.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="sect1.titlepage.before.recto"/> + <xsl:call-template name="sect1.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="sect1.titlepage.before.verso"/> + <xsl:call-template name="sect1.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="sect1.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="sect1.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="sect1.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="sect1.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect1.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect1.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="sect2.titlepage.recto"> + <xsl:choose> + <xsl:when test="sect2info/title"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sect2info/subtitle"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/corpauthor"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/authorgroup"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/author"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/othercredit"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/releaseinfo"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/copyright"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/legalnotice"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/pubdate"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/revision"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/revhistory"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="sect2info/abstract"/> + <xsl:apply-templates mode="sect2.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="sect2.titlepage.verso"> +</xsl:template> + +<xsl:template name="sect2.titlepage.separator"><xsl:if test="count(parent::*)='0'"><hr/></xsl:if> +</xsl:template> + +<xsl:template name="sect2.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="sect2.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="sect2.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="sect2.titlepage.before.recto"/> + <xsl:call-template name="sect2.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="sect2.titlepage.before.verso"/> + <xsl:call-template name="sect2.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="sect2.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="sect2.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="sect2.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="sect2.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect2.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect2.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="sect3.titlepage.recto"> + <xsl:choose> + <xsl:when test="sect3info/title"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sect3info/subtitle"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/corpauthor"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/authorgroup"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/author"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/othercredit"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/releaseinfo"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/copyright"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/legalnotice"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/pubdate"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/revision"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/revhistory"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="sect3info/abstract"/> + <xsl:apply-templates mode="sect3.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="sect3.titlepage.verso"> +</xsl:template> + +<xsl:template name="sect3.titlepage.separator"><xsl:if test="count(parent::*)='0'"><hr/></xsl:if> +</xsl:template> + +<xsl:template name="sect3.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="sect3.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="sect3.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="sect3.titlepage.before.recto"/> + <xsl:call-template name="sect3.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="sect3.titlepage.before.verso"/> + <xsl:call-template name="sect3.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="sect3.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="sect3.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="sect3.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="sect3.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect3.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect3.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="sect4.titlepage.recto"> + <xsl:choose> + <xsl:when test="sect4info/title"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sect4info/subtitle"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/corpauthor"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/authorgroup"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/author"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/othercredit"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/releaseinfo"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/copyright"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/legalnotice"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/pubdate"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/revision"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/revhistory"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="sect4info/abstract"/> + <xsl:apply-templates mode="sect4.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="sect4.titlepage.verso"> +</xsl:template> + +<xsl:template name="sect4.titlepage.separator"><xsl:if test="count(parent::*)='0'"><hr/></xsl:if> +</xsl:template> + +<xsl:template name="sect4.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="sect4.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="sect4.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="sect4.titlepage.before.recto"/> + <xsl:call-template name="sect4.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="sect4.titlepage.before.verso"/> + <xsl:call-template name="sect4.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="sect4.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="sect4.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="sect4.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="sect4.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect4.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect4.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="sect5.titlepage.recto"> + <xsl:choose> + <xsl:when test="sect5info/title"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="sect5info/subtitle"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/corpauthor"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/authorgroup"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/author"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/othercredit"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/releaseinfo"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/copyright"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/legalnotice"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/pubdate"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/revision"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/revhistory"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="sect5info/abstract"/> + <xsl:apply-templates mode="sect5.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="sect5.titlepage.verso"> +</xsl:template> + +<xsl:template name="sect5.titlepage.separator"><xsl:if test="count(parent::*)='0'"><hr/></xsl:if> +</xsl:template> + +<xsl:template name="sect5.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="sect5.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="sect5.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="sect5.titlepage.before.recto"/> + <xsl:call-template name="sect5.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="sect5.titlepage.before.verso"/> + <xsl:call-template name="sect5.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="sect5.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="sect5.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="sect5.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="sect5.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="sect5.titlepage.recto.style"> +<xsl:apply-templates select="." mode="sect5.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="simplesect.titlepage.recto"> + <xsl:choose> + <xsl:when test="simplesectinfo/title"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/title"/> + </xsl:when> + <xsl:when test="docinfo/title"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/title"/> + </xsl:when> + <xsl:when test="info/title"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/title"/> + </xsl:when> + <xsl:when test="title"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="title"/> + </xsl:when> + </xsl:choose> + + <xsl:choose> + <xsl:when test="simplesectinfo/subtitle"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/corpauthor"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/corpauthor"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/corpauthor"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/authorgroup"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/authorgroup"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/authorgroup"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/author"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/author"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/author"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/othercredit"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/othercredit"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/othercredit"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/releaseinfo"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/releaseinfo"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/releaseinfo"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/copyright"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/copyright"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/copyright"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/legalnotice"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/legalnotice"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/legalnotice"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/pubdate"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/pubdate"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/pubdate"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/revision"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/revision"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/revision"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/revhistory"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/revhistory"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/revhistory"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="simplesectinfo/abstract"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="docinfo/abstract"/> + <xsl:apply-templates mode="simplesect.titlepage.recto.auto.mode" select="info/abstract"/> +</xsl:template> + +<xsl:template name="simplesect.titlepage.verso"> +</xsl:template> + +<xsl:template name="simplesect.titlepage.separator"><xsl:if test="count(parent::*)='0'"><hr/></xsl:if> +</xsl:template> + +<xsl:template name="simplesect.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="simplesect.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="simplesect.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="simplesect.titlepage.before.recto"/> + <xsl:call-template name="simplesect.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="simplesect.titlepage.before.verso"/> + <xsl:call-template name="simplesect.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="simplesect.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="simplesect.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="simplesect.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="title" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="subtitle" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="corpauthor" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="authorgroup" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="author" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="othercredit" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="releaseinfo" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="copyright" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="legalnotice" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="pubdate" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revision" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="revhistory" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template match="abstract" mode="simplesect.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="simplesect.titlepage.recto.style"> +<xsl:apply-templates select="." mode="simplesect.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="bibliography.titlepage.recto"> + <div xsl:use-attribute-sets="bibliography.titlepage.recto.style"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::bibliography[1]"/> +</xsl:call-template></div> + <xsl:choose> + <xsl:when test="bibliographyinfo/subtitle"> + <xsl:apply-templates mode="bibliography.titlepage.recto.auto.mode" select="bibliographyinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="bibliography.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="bibliography.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="bibliography.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="bibliography.titlepage.verso"> +</xsl:template> + +<xsl:template name="bibliography.titlepage.separator"> +</xsl:template> + +<xsl:template name="bibliography.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="bibliography.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="bibliography.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="bibliography.titlepage.before.recto"/> + <xsl:call-template name="bibliography.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="bibliography.titlepage.before.verso"/> + <xsl:call-template name="bibliography.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="bibliography.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="bibliography.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="bibliography.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="bibliography.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="bibliography.titlepage.recto.style"> +<xsl:apply-templates select="." mode="bibliography.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="glossary.titlepage.recto"> + <div xsl:use-attribute-sets="glossary.titlepage.recto.style"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::glossary[1]"/> +</xsl:call-template></div> + <xsl:choose> + <xsl:when test="glossaryinfo/subtitle"> + <xsl:apply-templates mode="glossary.titlepage.recto.auto.mode" select="glossaryinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="glossary.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="glossary.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="glossary.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="glossary.titlepage.verso"> +</xsl:template> + +<xsl:template name="glossary.titlepage.separator"> +</xsl:template> + +<xsl:template name="glossary.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="glossary.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="glossary.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="glossary.titlepage.before.recto"/> + <xsl:call-template name="glossary.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="glossary.titlepage.before.verso"/> + <xsl:call-template name="glossary.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="glossary.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="glossary.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="glossary.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="glossary.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="glossary.titlepage.recto.style"> +<xsl:apply-templates select="." mode="glossary.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="index.titlepage.recto"> + <div xsl:use-attribute-sets="index.titlepage.recto.style"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::index[1]"/> +</xsl:call-template></div> + <xsl:choose> + <xsl:when test="indexinfo/subtitle"> + <xsl:apply-templates mode="index.titlepage.recto.auto.mode" select="indexinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="index.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="index.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="index.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="index.titlepage.verso"> +</xsl:template> + +<xsl:template name="index.titlepage.separator"> +</xsl:template> + +<xsl:template name="index.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="index.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="index.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="index.titlepage.before.recto"/> + <xsl:call-template name="index.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="index.titlepage.before.verso"/> + <xsl:call-template name="index.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="index.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="index.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="index.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="index.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="index.titlepage.recto.style"> +<xsl:apply-templates select="." mode="index.titlepage.recto.mode"/> +</div> +</xsl:template> + +<xsl:template name="setindex.titlepage.recto"> + <div xsl:use-attribute-sets="setindex.titlepage.recto.style"> +<xsl:call-template name="component.title"> +<xsl:with-param name="node" select="ancestor-or-self::setindex[1]"/> +</xsl:call-template></div> + <xsl:choose> + <xsl:when test="setindexinfo/subtitle"> + <xsl:apply-templates mode="setindex.titlepage.recto.auto.mode" select="setindexinfo/subtitle"/> + </xsl:when> + <xsl:when test="docinfo/subtitle"> + <xsl:apply-templates mode="setindex.titlepage.recto.auto.mode" select="docinfo/subtitle"/> + </xsl:when> + <xsl:when test="info/subtitle"> + <xsl:apply-templates mode="setindex.titlepage.recto.auto.mode" select="info/subtitle"/> + </xsl:when> + <xsl:when test="subtitle"> + <xsl:apply-templates mode="setindex.titlepage.recto.auto.mode" select="subtitle"/> + </xsl:when> + </xsl:choose> + +</xsl:template> + +<xsl:template name="setindex.titlepage.verso"> +</xsl:template> + +<xsl:template name="setindex.titlepage.separator"> +</xsl:template> + +<xsl:template name="setindex.titlepage.before.recto"> +</xsl:template> + +<xsl:template name="setindex.titlepage.before.verso"> +</xsl:template> + +<xsl:template name="setindex.titlepage"> + <div class="titlepage"> + <xsl:variable name="recto.content"> + <xsl:call-template name="setindex.titlepage.before.recto"/> + <xsl:call-template name="setindex.titlepage.recto"/> + </xsl:variable> + <xsl:variable name="recto.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($recto.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($recto.content) != '') or ($recto.elements.count > 0)"> + <div><xsl:copy-of select="$recto.content"/></div> + </xsl:if> + <xsl:variable name="verso.content"> + <xsl:call-template name="setindex.titlepage.before.verso"/> + <xsl:call-template name="setindex.titlepage.verso"/> + </xsl:variable> + <xsl:variable name="verso.elements.count"> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:when test="contains(system-property('xsl:vendor'), 'Apache Software Foundation')"> + <!--Xalan quirk--><xsl:value-of select="count(exsl:node-set($verso.content)/*)"/></xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:if test="(normalize-space($verso.content) != '') or ($verso.elements.count > 0)"> + <div><xsl:copy-of select="$verso.content"/></div> + </xsl:if> + <xsl:call-template name="setindex.titlepage.separator"/> + </div> +</xsl:template> + +<xsl:template match="*" mode="setindex.titlepage.recto.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="*" mode="setindex.titlepage.verso.mode"> + <!-- if an element isn't found in this mode, --> + <!-- try the generic titlepage.mode --> + <xsl:apply-templates select="." mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="subtitle" mode="setindex.titlepage.recto.auto.mode"> +<div xsl:use-attribute-sets="setindex.titlepage.recto.style"> +<xsl:apply-templates select="." mode="setindex.titlepage.recto.mode"/> +</div> +</xsl:template> + +</xsl:stylesheet> \ No newline at end of file diff --git a/src/documentation/docbook-xsl/html/titlepage.xsl b/src/documentation/docbook-xsl/html/titlepage.xsl new file mode 100644 index 0000000000..c65ed13ea1 --- /dev/null +++ b/src/documentation/docbook-xsl/html/titlepage.xsl @@ -0,0 +1,876 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + +<!-- ******************************************************************** + $Id: titlepage.xsl,v 1.34 2006/05/21 12:25:21 kosek Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:attribute-set name="book.titlepage.recto.style"/> +<xsl:attribute-set name="book.titlepage.verso.style"/> + +<xsl:attribute-set name="article.titlepage.recto.style"/> +<xsl:attribute-set name="article.titlepage.verso.style"/> + +<xsl:attribute-set name="set.titlepage.recto.style"/> +<xsl:attribute-set name="set.titlepage.verso.style"/> + +<xsl:attribute-set name="part.titlepage.recto.style"/> +<xsl:attribute-set name="part.titlepage.verso.style"/> + +<xsl:attribute-set name="partintro.titlepage.recto.style"/> +<xsl:attribute-set name="partintro.titlepage.verso.style"/> + +<xsl:attribute-set name="reference.titlepage.recto.style"/> +<xsl:attribute-set name="reference.titlepage.verso.style"/> + +<xsl:attribute-set name="refentry.titlepage.recto.style"/> +<xsl:attribute-set name="refentry.titlepage.verso.style"/> + +<xsl:attribute-set name="dedication.titlepage.recto.style"/> +<xsl:attribute-set name="dedication.titlepage.verso.style"/> + +<xsl:attribute-set name="preface.titlepage.recto.style"/> +<xsl:attribute-set name="preface.titlepage.verso.style"/> + +<xsl:attribute-set name="chapter.titlepage.recto.style"/> +<xsl:attribute-set name="chapter.titlepage.verso.style"/> + +<xsl:attribute-set name="appendix.titlepage.recto.style"/> +<xsl:attribute-set name="appendix.titlepage.verso.style"/> + +<xsl:attribute-set name="bibliography.titlepage.recto.style"/> +<xsl:attribute-set name="bibliography.titlepage.verso.style"/> + +<xsl:attribute-set name="glossary.titlepage.recto.style"/> +<xsl:attribute-set name="glossary.titlepage.verso.style"/> + +<xsl:attribute-set name="index.titlepage.recto.style"/> +<xsl:attribute-set name="index.titlepage.verso.style"/> + +<xsl:attribute-set name="setindex.titlepage.recto.style"/> +<xsl:attribute-set name="setindex.titlepage.verso.style"/> + +<xsl:attribute-set name="section.titlepage.recto.style"/> +<xsl:attribute-set name="section.titlepage.verso.style"/> + +<xsl:attribute-set name="sect1.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="sect1.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="sect2.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="sect2.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="sect3.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="sect3.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="sect4.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="sect4.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="sect5.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="sect5.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="simplesect.titlepage.recto.style" + use-attribute-sets="section.titlepage.recto.style"/> +<xsl:attribute-set name="simplesect.titlepage.verso.style" + use-attribute-sets="section.titlepage.verso.style"/> + +<xsl:attribute-set name="table.of.contents.titlepage.recto.style"/> +<xsl:attribute-set name="table.of.contents.titlepage.verso.style"/> + +<xsl:attribute-set name="list.of.tables.titlepage.recto.style"/> +<xsl:attribute-set name="list.of.tables.contents.titlepage.verso.style"/> + +<xsl:attribute-set name="list.of.figures.titlepage.recto.style"/> +<xsl:attribute-set name="list.of.figures.contents.titlepage.verso.style"/> + +<xsl:attribute-set name="list.of.equations.titlepage.recto.style"/> +<xsl:attribute-set name="list.of.equations.contents.titlepage.verso.style"/> + +<xsl:attribute-set name="list.of.examples.titlepage.recto.style"/> +<xsl:attribute-set name="list.of.examples.contents.titlepage.verso.style"/> + +<xsl:attribute-set name="list.of.unknowns.titlepage.recto.style"/> +<xsl:attribute-set name="list.of.unknowns.contents.titlepage.verso.style"/> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="titlepage.mode"> + <!-- if an element isn't found in this mode, try the default mode --> + <xsl:apply-templates select="."/> +</xsl:template> + +<xsl:template match="abbrev" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="abstract" mode="titlepage.mode"> + <div class="{name(.)}"> + <xsl:call-template name="anchor"/> + <xsl:call-template name="formal.object.heading"> + <xsl:with-param name="title"> + <xsl:apply-templates select="." mode="title.markup"/> + </xsl:with-param> + </xsl:call-template> + <xsl:apply-templates mode="titlepage.mode"/> + </div> +</xsl:template> + +<xsl:template match="abstract/title" mode="titlepage.mode"> +</xsl:template> + +<xsl:template match="address" mode="titlepage.mode"> + <xsl:param name="suppress-numbers" select="'0'"/> + + <xsl:variable name="rtf"> + <xsl:apply-templates mode="titlepage.mode"/> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$suppress-numbers = '0' + and @linenumbering = 'numbered' + and $use.extensions != '0' + and $linenumbering.extension != '0'"> + <div class="{name(.)}"> + <xsl:call-template name="paragraph"> + <xsl:with-param name="content"> + <xsl:call-template name="number.rtf.lines"> + <xsl:with-param name="rtf" select="$rtf"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </div> + </xsl:when> + + <xsl:otherwise> + <div class="{name(.)}"> + <xsl:call-template name="paragraph"> + <xsl:with-param name="content"> + <xsl:call-template name="make-verbatim"> + <xsl:with-param name="rtf" select="$rtf"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </div> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="affiliation" mode="titlepage.mode"> + <div class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + </div> +</xsl:template> + +<xsl:template match="artpagenums" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="author" mode="titlepage.mode"> + <div class="{name(.)}"> + <h3 class="{name(.)}"><xsl:call-template name="person.name"/></h3> + <xsl:apply-templates mode="titlepage.mode" select="./contrib"/> + <xsl:apply-templates mode="titlepage.mode" select="./affiliation"/> + <xsl:apply-templates mode="titlepage.mode" select="./email"/> + </div> +</xsl:template> + +<xsl:template match="authorblurb|personblurb" mode="titlepage.mode"> + <div class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + </div> +</xsl:template> + +<xsl:template match="authorgroup" mode="titlepage.mode"> + <div class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + </div> +</xsl:template> + +<xsl:template match="authorinitials" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="bibliomisc" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="bibliomset" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="collab" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="collabname" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + </span> +</xsl:template> + +<xsl:template match="confgroup" mode="titlepage.mode"> + <div class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + </div> +</xsl:template> + +<xsl:template match="confdates" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="confsponsor" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="conftitle" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="confnum" mode="titlepage.mode"> + <!-- suppress --> +</xsl:template> + +<xsl:template match="contractnum" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="contractsponsor" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="contrib" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + </span> +</xsl:template> + +<xsl:template match="copyright" mode="titlepage.mode"> + <p class="{name(.)}"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'Copyright'"/> + </xsl:call-template> + <xsl:call-template name="gentext.space"/> + <xsl:call-template name="dingbat"> + <xsl:with-param name="dingbat">copyright</xsl:with-param> + </xsl:call-template> + <xsl:call-template name="gentext.space"/> + <xsl:call-template name="copyright.years"> + <xsl:with-param name="years" select="year"/> + <xsl:with-param name="print.ranges" select="$make.year.ranges"/> + <xsl:with-param name="single.year.ranges" + select="$make.single.year.ranges"/> + </xsl:call-template> + <xsl:call-template name="gentext.space"/> + <xsl:apply-templates select="holder" mode="titlepage.mode"/> + </p> +</xsl:template> + +<xsl:template match="year" mode="titlepage.mode"> + <xsl:choose> + <xsl:when test="$show.revisionflag != 0 and @revisionflag"> + <span class="{@revisionflag}"> + <xsl:apply-templates mode="titlepage.mode"/> + </span> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates mode="titlepage.mode"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="holder" mode="titlepage.mode"> + <xsl:choose> + <xsl:when test="$show.revisionflag != 0 and @revisionflag"> + <span class="{@revisionflag}"> + <xsl:apply-templates mode="titlepage.mode"/> + </span> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates mode="titlepage.mode"/> + </xsl:otherwise> + </xsl:choose> + <xsl:if test="position() < last()"> + <xsl:text>, </xsl:text> + </xsl:if> +</xsl:template> + +<xsl:template match="corpauthor" mode="titlepage.mode"> + <h3 class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + </h3> +</xsl:template> + +<xsl:template match="corpcredit" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="corpname" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="date" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="edition" mode="titlepage.mode"> + <p class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <xsl:call-template name="gentext.space"/> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'Edition'"/> + </xsl:call-template> + </p> +</xsl:template> + +<xsl:template match="editor" mode="titlepage.mode"> + <h3 class="{name(.)}"><xsl:call-template name="person.name"/></h3> +</xsl:template> + +<xsl:template match="editor[position()=1]" mode="titlepage.mode"> + <h4 class="editedby"><xsl:call-template name="gentext.edited.by"/></h4> + <h3 class="{name(.)}"><xsl:call-template name="person.name"/></h3> +</xsl:template> + +<xsl:template match="email" mode="titlepage.mode"> + <!-- use the normal e-mail handling code --> + <xsl:apply-templates select="."/> +</xsl:template> + +<xsl:template match="firstname" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="graphic" mode="titlepage.mode"> + <!-- use the normal graphic handling code --> + <xsl:apply-templates select="."/> +</xsl:template> + +<xsl:template match="honorific" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="isbn" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="issn" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="biblioid" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="itermset" mode="titlepage.mode"> +</xsl:template> + +<xsl:template match="invpartnumber" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="issuenum" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="jobtitle" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="keywordset" mode="titlepage.mode"> +</xsl:template> + +<xsl:template match="legalnotice" mode="titlepage.mode"> + <xsl:variable name="id"><xsl:call-template name="object.id"/></xsl:variable> + <xsl:choose> + <xsl:when test="$generate.legalnotice.link != 0"> + <xsl:variable name="filename"> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.dir" select="$base.dir"/> + <xsl:with-param name="base.name"> + <xsl:apply-templates mode="chunk-filename" select="."/> + </xsl:with-param> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="title"> + <xsl:apply-templates select="." mode="title.markup"/> + </xsl:variable> + + <xsl:variable name="href"> + <xsl:apply-templates mode="chunk-filename" select="."/> + </xsl:variable> + + <a href="{$href}"> + <xsl:copy-of select="$title"/> + </a> + + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename" select="$filename"/> + <xsl:with-param name="quiet" select="$chunk.quietly"/> + <xsl:with-param name="content"> + <xsl:call-template name="user.preroot"/> + <html> + <head> + <xsl:call-template name="system.head.content"/> + <xsl:call-template name="head.content"/> + <xsl:call-template name="user.head.content"/> + </head> + <body> + <xsl:call-template name="body.attributes"/> + <div class="{local-name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + </div> + </body> + </html> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <div class="{local-name(.)}"> + <a name="{$id}"/> + <xsl:apply-templates mode="titlepage.mode"/> + </div> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="legalnotice/title" mode="titlepage.mode"> + <p class="legalnotice-title"><b><xsl:apply-templates/></b></p> +</xsl:template> + +<xsl:template match="lineage" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="modespec" mode="titlepage.mode"> +</xsl:template> + +<xsl:template match="orgdiv" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="orgname" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="othercredit" mode="titlepage.mode"> + <xsl:variable name="contrib" select="string(contrib)"/> + <xsl:choose> + <xsl:when test="contrib"> + <xsl:if test="not(preceding-sibling::othercredit[string(contrib)=$contrib])"> + <xsl:call-template name="paragraph"> + <xsl:with-param name="class" select="name(.)"/> + <xsl:with-param name="content"> + <xsl:apply-templates mode="titlepage.mode" select="contrib"/> + <xsl:text>: </xsl:text> + <xsl:call-template name="person.name"/> + <xsl:apply-templates mode="titlepage.mode" select="./affiliation"/> + <xsl:apply-templates select="following-sibling::othercredit[string(contrib)=$contrib]" mode="titlepage.othercredits"/> + </xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="paragraph"> + <xsl:with-param name="class" select="name(.)"/> + <xsl:with-param name="content"> + <xsl:call-template name="person.name"/> + </xsl:with-param> + </xsl:call-template> + <xsl:apply-templates mode="titlepage.mode" select="./affiliation"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="othercredit" mode="titlepage.othercredits"> + <xsl:text>, </xsl:text> + <xsl:call-template name="person.name"/> +</xsl:template> + +<xsl:template match="othername" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="pagenums" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="printhistory" mode="titlepage.mode"> + <div class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + </div> +</xsl:template> + +<xsl:template match="productname" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="productnumber" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="pubdate" mode="titlepage.mode"> + <xsl:call-template name="paragraph"> + <xsl:with-param name="class" select="name(.)"/> + <xsl:with-param name="content"> + <xsl:apply-templates mode="titlepage.mode"/> + </xsl:with-param> + </xsl:call-template> +</xsl:template> + +<xsl:template match="publisher" mode="titlepage.mode"> + <xsl:call-template name="paragraph"> + <xsl:with-param name="class" select="name(.)"/> + <xsl:with-param name="content"> + <xsl:apply-templates mode="titlepage.mode"/> + </xsl:with-param> + </xsl:call-template> +</xsl:template> + +<xsl:template match="publishername" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="pubsnumber" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="releaseinfo" mode="titlepage.mode"> + <xsl:call-template name="paragraph"> + <xsl:with-param name="class" select="name(.)"/> + <xsl:with-param name="content"> + <xsl:apply-templates mode="titlepage.mode"/> + </xsl:with-param> + </xsl:call-template> +</xsl:template> + +<xsl:template match="revhistory" mode="titlepage.mode"> + <xsl:variable name="numcols"> + <xsl:choose> + <xsl:when test=".//authorinitials|.//author">3</xsl:when> + <xsl:otherwise>2</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="id"><xsl:call-template name="object.id"/></xsl:variable> + + <xsl:variable name="title"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key">RevHistory</xsl:with-param> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="contents"> + <div class="{name(.)}"> + <table border="1" width="100%" summary="Revision history"> + <tr> + <th align="left" valign="top" colspan="{$numcols}"> + <b> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'RevHistory'"/> + </xsl:call-template> + </b> + </th> + </tr> + <xsl:apply-templates mode="titlepage.mode"> + <xsl:with-param name="numcols" select="$numcols"/> + </xsl:apply-templates> + </table> + </div> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$generate.revhistory.link != 0"> + <xsl:variable name="filename"> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.dir" select="$base.dir"/> + <xsl:with-param name="base.name" select="concat($id,$html.ext)"/> + </xsl:call-template> + </xsl:variable> + + <a href="{concat($id,$html.ext)}"> + <xsl:copy-of select="$title"/> + </a> + + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename" select="$filename"/> + <xsl:with-param name="quiet" select="$chunk.quietly"/> + <xsl:with-param name="content"> + <xsl:call-template name="user.preroot"/> + <html> + <head> + <xsl:call-template name="system.head.content"/> + <xsl:call-template name="head.content"> + <xsl:with-param name="title"> + <xsl:value-of select="$title"/> + <xsl:if test="../../title"> + <xsl:value-of select="concat(' (', ../../title, ')')"/> + </xsl:if> + </xsl:with-param> + </xsl:call-template> + <xsl:call-template name="user.head.content"/> + </head> + <body> + <xsl:call-template name="body.attributes"/> + <xsl:copy-of select="$contents"/> + </body> + </html> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$contents"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="revhistory/revision" mode="titlepage.mode"> + <xsl:param name="numcols" select="'3'"/> + <xsl:variable name="revnumber" select="revnumber"/> + <xsl:variable name="revdate" select="date"/> + <xsl:variable name="revauthor" select="authorinitials|author"/> + <xsl:variable name="revremark" select="revremark|revdescription"/> + <tr> + <td align="left"> + <xsl:if test="$revnumber"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'Revision'"/> + </xsl:call-template> + <xsl:call-template name="gentext.space"/> + <xsl:apply-templates select="$revnumber[1]" mode="titlepage.mode"/> + </xsl:if> + </td> + <td align="left"> + <xsl:apply-templates select="$revdate[1]" mode="titlepage.mode"/> + </td> + <xsl:choose> + <xsl:when test="$revauthor"> + <td align="left"> + <xsl:for-each select="$revauthor"> + <xsl:apply-templates select="." mode="titlepage.mode"/> + <xsl:if test="position() != last()"> + <xsl:text>, </xsl:text> + </xsl:if> + </xsl:for-each> + </td> + </xsl:when> + <xsl:when test="$numcols > 2"> + <td> </td> + </xsl:when> + <xsl:otherwise></xsl:otherwise> + </xsl:choose> + </tr> + <xsl:if test="$revremark"> + <tr> + <td align="left" colspan="{$numcols}"> + <xsl:apply-templates select="$revremark[1]" mode="titlepage.mode"/> + </td> + </tr> + </xsl:if> +</xsl:template> + +<xsl:template match="revision/revnumber" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="revision/date" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="revision/authorinitials" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="revision/author" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="revision/revremark" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="revision/revdescription" mode="titlepage.mode"> + <xsl:apply-templates mode="titlepage.mode"/> +</xsl:template> + +<xsl:template match="seriesvolnums" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="shortaffil" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="subjectset" mode="titlepage.mode"> +</xsl:template> + +<xsl:template match="subtitle" mode="titlepage.mode"> + <h2 class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + </h2> +</xsl:template> + +<xsl:template match="surname" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<xsl:template match="title" mode="titlepage.mode"> + <xsl:variable name="id"> + <xsl:choose> + <!-- if title is in an *info wrapper, get the grandparent --> + <xsl:when test="contains(local-name(..), 'info')"> + <xsl:call-template name="object.id"> + <xsl:with-param name="object" select="../.."/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="object.id"> + <xsl:with-param name="object" select=".."/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <h1 class="{name(.)}"> + <a name="{$id}"/> + <xsl:choose> + <xsl:when test="$show.revisionflag != 0 and @revisionflag"> + <span class="{@revisionflag}"> + <xsl:apply-templates mode="titlepage.mode"/> + </span> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates mode="titlepage.mode"/> + </xsl:otherwise> + </xsl:choose> + </h1> +</xsl:template> + +<xsl:template match="titleabbrev" mode="titlepage.mode"> + <!-- nop; title abbreviations don't belong on the title page! --> +</xsl:template> + +<xsl:template match="volumenum" mode="titlepage.mode"> + <span class="{name(.)}"> + <xsl:apply-templates mode="titlepage.mode"/> + <br/> + </span> +</xsl:template> + +<!-- ==================================================================== --> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/toc.xsl b/src/documentation/docbook-xsl/html/toc.xsl new file mode 100644 index 0000000000..89c74ead2c --- /dev/null +++ b/src/documentation/docbook-xsl/html/toc.xsl @@ -0,0 +1,173 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + +<!-- ******************************************************************** + $Id: toc.xsl,v 1.5 2002/03/14 18:43:42 nwalsh Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:template match="toc"> + <xsl:choose> + <xsl:when test="*"> + <xsl:if test="$process.source.toc != 0"> + <!-- if the toc isn't empty, process it --> + <xsl:element name="{$toc.list.type}"> + <xsl:apply-templates/> + </xsl:element> + </xsl:if> + </xsl:when> + <xsl:otherwise> + <xsl:if test="$process.empty.source.toc != 0"> + <xsl:choose> + <xsl:when test="parent::section + or parent::sect1 + or parent::sect2 + or parent::sect3 + or parent::sect4 + or parent::sect5"> + <xsl:apply-templates select="parent::*" + mode="toc.for.section"/> + </xsl:when> + <xsl:when test="parent::article"> + <xsl:apply-templates select="parent::*" + mode="toc.for.component"/> + </xsl:when> + <xsl:when test="parent::book + or parent::part"> + <xsl:apply-templates select="parent::*" + mode="toc.for.division"/> + </xsl:when> + <xsl:when test="parent::set"> + <xsl:apply-templates select="parent::*" + mode="toc.for.set"/> + </xsl:when> + <!-- there aren't any other contexts that allow toc --> + <xsl:otherwise> + <xsl:message> + <xsl:text>I don't know how to make a TOC in this context!</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="tocpart|tocchap + |toclevel1|toclevel2|toclevel3|toclevel4|toclevel5"> + <xsl:variable name="sub-toc"> + <xsl:if test="tocchap|toclevel1|toclevel2|toclevel3|toclevel4|toclevel5"> + <xsl:choose> + <xsl:when test="$toc.list.type = 'dl'"> + <dd> + <xsl:element name="{$toc.list.type}"> + <xsl:apply-templates select="tocchap|toclevel1|toclevel2|toclevel3|toclevel4|toclevel5"/> + </xsl:element> + </dd> + </xsl:when> + <xsl:otherwise> + <xsl:element name="{$toc.list.type}"> + <xsl:apply-templates select="tocchap|toclevel1|toclevel2|toclevel3|toclevel4|toclevel5"/> + </xsl:element> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + </xsl:variable> + + <xsl:apply-templates select="tocentry[position() != last()]"/> + + <xsl:choose> + <xsl:when test="$toc.list.type = 'dl'"> + <dt> + <xsl:apply-templates select="tocentry[position() = last()]"/> + </dt> + <xsl:copy-of select="$sub-toc"/> + </xsl:when> + <xsl:otherwise> + <li> + <xsl:apply-templates select="tocentry[position() = last()]"/> + <xsl:copy-of select="$sub-toc"/> + </li> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="tocentry|tocfront|tocback"> + <xsl:choose> + <xsl:when test="$toc.list.type = 'dl'"> + <dt> + <xsl:call-template name="tocentry-content"/> + </dt> + </xsl:when> + <xsl:otherwise> + <li> + <xsl:call-template name="tocentry-content"/> + </li> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="tocentry[position() = last()]" priority="2"> + <xsl:call-template name="tocentry-content"/> +</xsl:template> + +<xsl:template name="tocentry-content"> + <xsl:variable name="targets" select="key('id',@linkend)"/> + <xsl:variable name="target" select="$targets[1]"/> + + <xsl:choose> + <xsl:when test="@linkend"> + <xsl:call-template name="check.id.unique"> + <xsl:with-param name="linkend" select="@linkend"/> + </xsl:call-template> + <a> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$target"/> + </xsl:call-template> + </xsl:attribute> + <xsl:apply-templates/> + </a> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="toc.for.section"> + <xsl:call-template name="section.toc"/> +</xsl:template> + +<xsl:template match="*" mode="toc.for.component"> + <xsl:call-template name="component.toc"/> +</xsl:template> + +<xsl:template match="*" mode="toc.for.section"> + <xsl:call-template name="section.toc"/> +</xsl:template> + +<xsl:template match="*" mode="toc.for.division"> + <xsl:call-template name="division.toc"/> +</xsl:template> + +<xsl:template match="*" mode="toc.for.set"> + <xsl:call-template name="set.toc"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="lot|lotentry"> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/verbatim.xsl b/src/documentation/docbook-xsl/html/verbatim.xsl new file mode 100644 index 0000000000..8473e6ed33 --- /dev/null +++ b/src/documentation/docbook-xsl/html/verbatim.xsl @@ -0,0 +1,371 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:sverb="http://nwalsh.com/xslt/ext/com.nwalsh.saxon.Verbatim" + xmlns:xverb="com.nwalsh.xalan.Verbatim" + xmlns:lxslt="http://xml.apache.org/xslt" + xmlns:exsl="http://exslt.org/common" + exclude-result-prefixes="sverb xverb lxslt exsl" + version='1.0'> + +<!-- ******************************************************************** + $Id: verbatim.xsl,v 1.14 2005/11/20 02:44:34 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<lxslt:component prefix="xverb" + functions="numberLines"/> + +<xsl:template match="programlisting|screen|synopsis"> + <xsl:param name="suppress-numbers" select="'0'"/> + <xsl:variable name="id"> + <xsl:call-template name="object.id"/> + </xsl:variable> + + <xsl:call-template name="anchor"/> + + <xsl:if test="$shade.verbatim != 0"> + <xsl:message> + <xsl:text>The shade.verbatim parameter is deprecated. </xsl:text> + <xsl:text>Use CSS instead,</xsl:text> + </xsl:message> + <xsl:message> + <xsl:text>for example: pre.</xsl:text> + <xsl:value-of select="local-name(.)"/> + <xsl:text> { background-color: #E0E0E0; }</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:choose> + <xsl:when test="$suppress-numbers = '0' + and @linenumbering = 'numbered' + and $use.extensions != '0' + and $linenumbering.extension != '0'"> + <xsl:variable name="rtf"> + <xsl:apply-templates/> + </xsl:variable> + <pre class="{name(.)}"> + <xsl:call-template name="number.rtf.lines"> + <xsl:with-param name="rtf" select="$rtf"/> + </xsl:call-template> + </pre> + </xsl:when> + <xsl:otherwise> + <pre class="{name(.)}"> + <xsl:apply-templates/> + </pre> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="literallayout"> + <xsl:param name="suppress-numbers" select="'0'"/> + + <xsl:variable name="rtf"> + <xsl:apply-templates/> + </xsl:variable> + + <xsl:if test="$shade.verbatim != 0 and @class='monospaced'"> + <xsl:message> + <xsl:text>The shade.verbatim parameter is deprecated. </xsl:text> + <xsl:text>Use CSS instead,</xsl:text> + </xsl:message> + <xsl:message> + <xsl:text>for example: pre.</xsl:text> + <xsl:value-of select="local-name(.)"/> + <xsl:text> { background-color: #E0E0E0; }</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:choose> + <xsl:when test="$suppress-numbers = '0' + and @linenumbering = 'numbered' + and $use.extensions != '0' + and $linenumbering.extension != '0'"> + <xsl:choose> + <xsl:when test="@class='monospaced'"> + <pre class="{name(.)}"> + <xsl:call-template name="number.rtf.lines"> + <xsl:with-param name="rtf" select="$rtf"/> + </xsl:call-template> + </pre> + </xsl:when> + <xsl:otherwise> + <div class="{name(.)}"> + <p> + <xsl:call-template name="number.rtf.lines"> + <xsl:with-param name="rtf" select="$rtf"/> + </xsl:call-template> + </p> + </div> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="@class='monospaced'"> + <pre class="{name(.)}"> + <xsl:copy-of select="$rtf"/> + </pre> + </xsl:when> + <xsl:otherwise> + <div class="{name(.)}"> + <p> + <xsl:call-template name="make-verbatim"> + <xsl:with-param name="rtf" select="$rtf"/> + </xsl:call-template> + </p> + </div> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="address"> + <xsl:param name="suppress-numbers" select="'0'"/> + + <xsl:variable name="rtf"> + <xsl:apply-templates/> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$suppress-numbers = '0' + and @linenumbering = 'numbered' + and $use.extensions != '0' + and $linenumbering.extension != '0'"> + <div class="{name(.)}"> + <p> + <xsl:call-template name="number.rtf.lines"> + <xsl:with-param name="rtf" select="$rtf"/> + </xsl:call-template> + </p> + </div> + </xsl:when> + + <xsl:otherwise> + <div class="{name(.)}"> + <p> + <xsl:call-template name="make-verbatim"> + <xsl:with-param name="rtf" select="$rtf"/> + </xsl:call-template> + </p> + </div> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="number.rtf.lines"> + <xsl:param name="rtf" select="''"/> + <xsl:param name="pi.context" select="."/> + + <!-- Save the global values --> + <xsl:variable name="global.linenumbering.everyNth" + select="$linenumbering.everyNth"/> + + <xsl:variable name="global.linenumbering.separator" + select="$linenumbering.separator"/> + + <xsl:variable name="global.linenumbering.width" + select="$linenumbering.width"/> + + <!-- Extract the <?dbhtml linenumbering.*?> PI values --> + <xsl:variable name="pi.linenumbering.everyNth"> + <xsl:call-template name="dbhtml-attribute"> + <xsl:with-param name="pis" + select="$pi.context/processing-instruction('dbhtml')"/> + <xsl:with-param name="attribute" select="'linenumbering.everyNth'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="pi.linenumbering.separator"> + <xsl:call-template name="dbhtml-attribute"> + <xsl:with-param name="pis" + select="$pi.context/processing-instruction('dbhtml')"/> + <xsl:with-param name="attribute" select="'linenumbering.separator'"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="pi.linenumbering.width"> + <xsl:call-template name="dbhtml-attribute"> + <xsl:with-param name="pis" + select="$pi.context/processing-instruction('dbhtml')"/> + <xsl:with-param name="attribute" select="'linenumbering.width'"/> + </xsl:call-template> + </xsl:variable> + + <!-- Construct the 'in-context' values --> + <xsl:variable name="linenumbering.everyNth"> + <xsl:choose> + <xsl:when test="$pi.linenumbering.everyNth != ''"> + <xsl:value-of select="$pi.linenumbering.everyNth"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$global.linenumbering.everyNth"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="linenumbering.separator"> + <xsl:choose> + <xsl:when test="$pi.linenumbering.separator != ''"> + <xsl:value-of select="$pi.linenumbering.separator"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$global.linenumbering.separator"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="linenumbering.width"> + <xsl:choose> + <xsl:when test="$pi.linenumbering.width != ''"> + <xsl:value-of select="$pi.linenumbering.width"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$global.linenumbering.width"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="linenumbering.startinglinenumber"> + <xsl:choose> + <xsl:when test="$pi.context/@startinglinenumber"> + <xsl:value-of select="$pi.context/@startinglinenumber"/> + </xsl:when> + <xsl:when test="$pi.context/@continuation='continues'"> + <xsl:variable name="lastLine"> + <xsl:choose> + <xsl:when test="$pi.context/self::programlisting"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" + select="preceding::programlisting[@linenumbering='numbered']"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$pi.context/self::screen"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" + select="preceding::screen[@linenumbering='numbered']"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$pi.context/self::literallayout"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" + select="preceding::literallayout[@linenumbering='numbered']"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$pi.context/self::address"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" + select="preceding::address[@linenumbering='numbered']"/> + </xsl:call-template> + </xsl:when> + <xsl:when test="$pi.context/self::synopsis"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" + select="preceding::synopsis[@linenumbering='numbered']"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>Unexpected verbatim environment: </xsl:text> + <xsl:value-of select="local-name($pi.context)"/> + </xsl:message> + <xsl:value-of select="0"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:value-of select="$lastLine + 1"/> + </xsl:when> + <xsl:otherwise>1</xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="function-available('sverb:numberLines')"> + <xsl:copy-of select="sverb:numberLines($rtf)"/> + </xsl:when> + <xsl:when test="function-available('xverb:numberLines')"> + <xsl:copy-of select="xverb:numberLines($rtf)"/> + </xsl:when> + <xsl:otherwise> + <xsl:message terminate="yes"> + <xsl:text>No numberLines function available.</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="make-verbatim"> + <xsl:param name="rtf"/> + + <!-- I want to make this RTF verbatim. There are two possibilities: either + I have access to the exsl:node-set extension function and I can "do it right" + or I have to rely on CSS. --> + + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"> + <xsl:apply-templates select="exsl:node-set($rtf)" mode="make.verbatim.mode"/> + </xsl:when> + <xsl:otherwise> + <span style="white-space: pre;"> + <xsl:copy-of select="$rtf"/> + </span> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ======================================================================== --> + +<xsl:template name="lastLineNumber"> + <xsl:param name="listings"/> + <xsl:param name="number" select="0"/> + + <xsl:variable name="lines"> + <xsl:call-template name="countLines"> + <xsl:with-param name="listing" select="string($listings[1])"/> + </xsl:call-template> + </xsl:variable> + + <xsl:choose> + <xsl:when test="not($listings)"> + <xsl:value-of select="$number"/> + </xsl:when> + <xsl:when test="$listings[1]/@startinglinenumber"> + <xsl:value-of select="$number + $listings[1]/@startinglinenumber + $lines - 1"/> + </xsl:when> + <xsl:when test="$listings[1]/@continuation='continues'"> + <xsl:call-template name="lastLineNumber"> + <xsl:with-param name="listings" select="listings[position() > 1]"/> + <xsl:with-param name="number" select="$number + $lines"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$lines"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template name="countLines"> + <xsl:param name="listing"/> + <xsl:param name="count" select="1"/> + + <xsl:choose> + <xsl:when test="contains($listing, ' ')"> + <xsl:call-template name="countLines"> + <xsl:with-param name="listing" select="substring-after($listing, ' ')"/> + <xsl:with-param name="count" select="$count + 1"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$count"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/html/xref.xsl b/src/documentation/docbook-xsl/html/xref.xsl new file mode 100644 index 0000000000..e48603021c --- /dev/null +++ b/src/documentation/docbook-xsl/html/xref.xsl @@ -0,0 +1,1335 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:suwl="http://nwalsh.com/xslt/ext/com.nwalsh.saxon.UnwrapLinks" + xmlns:exsl="http://exslt.org/common" + exclude-result-prefixes="suwl exsl" + version='1.0'> + +<!-- ******************************************************************** + $Id: xref.xsl,v 1.58 2006/02/28 14:27:23 kosek Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<xsl:template match="anchor"> + <xsl:call-template name="anchor"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="xref" name="xref"> + <xsl:param name="targets" select="key('id',@linkend)"/> + <xsl:variable name="target" select="$targets[1]"/> + <xsl:variable name="refelem" select="local-name($target)"/> + + <xsl:call-template name="check.id.unique"> + <xsl:with-param name="linkend" select="@linkend"/> + </xsl:call-template> + + <xsl:call-template name="anchor"/> + + <xsl:choose> + <xsl:when test="count($target) = 0"> + <xsl:message> + <xsl:text>XRef to nonexistent id: </xsl:text> + <xsl:value-of select="@linkend"/> + </xsl:message> + <xsl:text>???</xsl:text> + </xsl:when> + + <xsl:when test="@endterm"> + <xsl:variable name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$target"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="etargets" select="key('id',@endterm)"/> + <xsl:variable name="etarget" select="$etargets[1]"/> + <xsl:choose> + <xsl:when test="count($etarget) = 0"> + <xsl:message> + <xsl:value-of select="count($etargets)"/> + <xsl:text>Endterm points to nonexistent ID: </xsl:text> + <xsl:value-of select="@endterm"/> + </xsl:message> + <a href="{$href}"> + <xsl:text>???</xsl:text> + </a> + </xsl:when> + <xsl:otherwise> + <a href="{$href}"> + <xsl:apply-templates select="$etarget" mode="endterm"/> + </a> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + + <xsl:when test="$target/@xreflabel"> + <a> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$target"/> + </xsl:call-template> + </xsl:attribute> + <xsl:call-template name="xref.xreflabel"> + <xsl:with-param name="target" select="$target"/> + </xsl:call-template> + </a> + </xsl:when> + + <xsl:otherwise> + <xsl:variable name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$target"/> + </xsl:call-template> + </xsl:variable> + + <xsl:if test="not(parent::citation)"> + <xsl:apply-templates select="$target" mode="xref-to-prefix"/> + </xsl:if> + + <a href="{$href}"> + <xsl:if test="$target/title or $target/*/title"> + <xsl:attribute name="title"> + <xsl:apply-templates select="$target" mode="xref-title"/> + </xsl:attribute> + </xsl:if> + <xsl:apply-templates select="$target" mode="xref-to"> + <xsl:with-param name="referrer" select="."/> + <xsl:with-param name="xrefstyle"> + <xsl:choose> + <xsl:when test="@role and not(@xrefstyle) and $use.role.as.xrefstyle != 0"> + <xsl:value-of select="@role"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@xrefstyle"/> + </xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:apply-templates> + </a> + + <xsl:if test="not(parent::citation)"> + <xsl:apply-templates select="$target" mode="xref-to-suffix"/> + </xsl:if> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<!-- biblioref handled largely like an xref --> +<!-- To be done: add support for begin, end, and units attributes --> +<xsl:template match="biblioref"> + <xsl:variable name="targets" select="key('id',@linkend)"/> + <xsl:variable name="target" select="$targets[1]"/> + <xsl:variable name="refelem" select="local-name($target)"/> + + <xsl:call-template name="check.id.unique"> + <xsl:with-param name="linkend" select="@linkend"/> + </xsl:call-template> + + <xsl:call-template name="anchor"/> + + <xsl:choose> + <xsl:when test="count($target) = 0"> + <xsl:message> + <xsl:text>XRef to nonexistent id: </xsl:text> + <xsl:value-of select="@linkend"/> + </xsl:message> + <xsl:text>???</xsl:text> + </xsl:when> + + <xsl:when test="@endterm"> + <xsl:variable name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$target"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="etargets" select="key('id',@endterm)"/> + <xsl:variable name="etarget" select="$etargets[1]"/> + <xsl:choose> + <xsl:when test="count($etarget) = 0"> + <xsl:message> + <xsl:value-of select="count($etargets)"/> + <xsl:text>Endterm points to nonexistent ID: </xsl:text> + <xsl:value-of select="@endterm"/> + </xsl:message> + <a href="{$href}"> + <xsl:text>???</xsl:text> + </a> + </xsl:when> + <xsl:otherwise> + <a href="{$href}"> + <xsl:apply-templates select="$etarget" mode="endterm"/> + </a> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + + <xsl:when test="$target/@xreflabel"> + <a> + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$target"/> + </xsl:call-template> + </xsl:attribute> + <xsl:call-template name="xref.xreflabel"> + <xsl:with-param name="target" select="$target"/> + </xsl:call-template> + </a> + </xsl:when> + + <xsl:otherwise> + <xsl:variable name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$target"/> + </xsl:call-template> + </xsl:variable> + + <xsl:if test="not(parent::citation)"> + <xsl:apply-templates select="$target" mode="xref-to-prefix"/> + </xsl:if> + + <a href="{$href}"> + <xsl:if test="$target/title or $target/*/title"> + <xsl:attribute name="title"> + <xsl:apply-templates select="$target" mode="xref-title"/> + </xsl:attribute> + </xsl:if> + <xsl:apply-templates select="$target" mode="xref-to"> + <xsl:with-param name="referrer" select="."/> + <xsl:with-param name="xrefstyle"> + <xsl:choose> + <xsl:when test="@role and not(@xrefstyle) and $use.role.as.xrefstyle != 0"> + <xsl:value-of select="@role"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@xrefstyle"/> + </xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:apply-templates> + </a> + + <xsl:if test="not(parent::citation)"> + <xsl:apply-templates select="$target" mode="xref-to-suffix"/> + </xsl:if> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="endterm"> + <!-- Process the children of the endterm element --> + <xsl:variable name="endterm"> + <xsl:apply-templates select="child::node()"/> + </xsl:variable> + + <xsl:choose> + <xsl:when test="function-available('exsl:node-set')"> + <xsl:apply-templates select="exsl:node-set($endterm)" mode="remove-ids"/> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$endterm"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="*" mode="remove-ids"> + <xsl:choose> + <!-- handle html or xhtml --> + <xsl:when test="local-name(.) = 'a' + and (namespace-uri(.) = '' + or namespace-uri(.) = 'http://www.w3.org/1999/xhtml')"> + <xsl:choose> + <xsl:when test="(@name and count(@*) = 1) + or (@id and count(@*) = 1) + or (@id and @name and count(@*) = 2)"> + <xsl:message>suppress anchor</xsl:message> + <!-- suppress the whole thing --> + </xsl:when> + <xsl:otherwise> + <xsl:copy> + <xsl:for-each select="@*"> + <xsl:choose> + <xsl:when test="name(.) != 'name' and name(.) != 'id'"> + <xsl:copy/> + </xsl:when> + <xsl:otherwise> + <xsl:message>removing <xsl:value-of select="name(.)"/></xsl:message> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> + </xsl:copy> + <xsl:apply-templates mode="remove-ids"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:copy> + <xsl:for-each select="@*"> + <xsl:choose> + <xsl:when test="name(.) != 'id'"> + <xsl:copy/> + </xsl:when> + <xsl:otherwise> + <xsl:message>removing <xsl:value-of select="name(.)"/></xsl:message> + </xsl:otherwise> + </xsl:choose> + </xsl:for-each> + <xsl:apply-templates mode="remove-ids"/> + </xsl:copy> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="xref-to-prefix"/> +<xsl:template match="*" mode="xref-to-suffix"/> + +<xsl:template match="*" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:if test="$verbose"> + <xsl:message> + <xsl:text>Don't know what gentext to create for xref to: "</xsl:text> + <xsl:value-of select="name(.)"/> + <xsl:text>", ("</xsl:text> + <xsl:value-of select="@id"/> + <xsl:text>")</xsl:text> + </xsl:message> + </xsl:if> + <xsl:text>???</xsl:text> +</xsl:template> + +<xsl:template match="title" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <!-- if you xref to a title, xref to the parent... --> + <xsl:choose> + <!-- FIXME: how reliable is this? --> + <xsl:when test="contains(local-name(parent::*), 'info')"> + <xsl:apply-templates select="parent::*[2]" mode="xref-to"> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="parent::*" mode="xref-to"> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="abstract|authorblurb|personblurb|bibliodiv|bibliomset + |biblioset|blockquote|calloutlist|caution|colophon + |constraintdef|formalpara|glossdiv|important|indexdiv + |itemizedlist|legalnotice|lot|msg|msgexplan|msgmain + |msgrel|msgset|msgsub|note|orderedlist|partintro + |productionset|qandadiv|refsynopsisdiv|segmentedlist + |set|setindex|sidebar|tip|toc|variablelist|warning" + mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <!-- catch-all for things with (possibly optional) titles --> + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="author|editor|othercredit|personname" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + + <xsl:call-template name="person.name"/> +</xsl:template> + +<xsl:template match="authorgroup" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + + <xsl:call-template name="person.name.list"/> +</xsl:template> + +<xsl:template match="figure|example|table|equation" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="procedure" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="task" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="cmdsynopsis" mode="xref-to"> + <xsl:apply-templates select="(.//command)[1]" mode="xref"/> +</xsl:template> + +<xsl:template match="funcsynopsis" mode="xref-to"> + <xsl:apply-templates select="(.//function)[1]" mode="xref"/> +</xsl:template> + +<xsl:template match="dedication|preface|chapter|appendix|article" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="bibliography" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="biblioentry|bibliomixed" mode="xref-to-prefix"> + <xsl:text>[</xsl:text> +</xsl:template> + +<xsl:template match="biblioentry|bibliomixed" mode="xref-to-suffix"> + <xsl:text>]</xsl:text> +</xsl:template> + +<xsl:template match="biblioentry|bibliomixed" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <!-- handles both biblioentry and bibliomixed --> + <xsl:choose> + <xsl:when test="string(.) = ''"> + <xsl:variable name="bib" select="document($bibliography.collection,.)"/> + <xsl:variable name="id" select="@id"/> + <xsl:variable name="entry" select="$bib/bibliography/*[@id=$id][1]"/> + <xsl:choose> + <xsl:when test="$entry"> + <xsl:choose> + <xsl:when test="$bibliography.numbered != 0"> + <xsl:number from="bibliography" count="biblioentry|bibliomixed" + level="any" format="1"/> + </xsl:when> + <xsl:when test="local-name($entry/*[1]) = 'abbrev'"> + <xsl:apply-templates select="$entry/*[1]"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@id"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>No bibliography entry: </xsl:text> + <xsl:value-of select="$id"/> + <xsl:text> found in </xsl:text> + <xsl:value-of select="$bibliography.collection"/> + </xsl:message> + <xsl:value-of select="@id"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="$bibliography.numbered != 0"> + <xsl:number from="bibliography" count="biblioentry|bibliomixed" + level="any" format="1"/> + </xsl:when> + <xsl:when test="local-name(*[1]) = 'abbrev'"> + <xsl:apply-templates select="*[1]"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@id"/> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="glossary" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="glossentry" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + <xsl:choose> + <xsl:when test="$glossentry.show.acronym = 'primary'"> + <xsl:choose> + <xsl:when test="acronym|abbrev"> + <xsl:apply-templates select="(acronym|abbrev)[1]"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="glossterm[1]" mode="xref-to"> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="glossterm[1]" mode="xref-to"> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="glossterm" mode="xref-to"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="index" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="listitem" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="section|simplesect + |sect1|sect2|sect3|sect4|sect5 + |refsect1|refsect2|refsect3|refsection" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> + <!-- FIXME: What about "in Chapter X"? --> +</xsl:template> + +<xsl:template match="bridgehead" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> + <!-- FIXME: What about "in Chapter X"? --> +</xsl:template> + +<xsl:template match="qandaset" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="qandadiv" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="qandaentry" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="question[1]" mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="question|answer" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="part|reference" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="refentry" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + + <xsl:choose> + <xsl:when test="refmeta/refentrytitle"> + <xsl:apply-templates select="refmeta/refentrytitle"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="refnamediv/refname[1]"/> + </xsl:otherwise> + </xsl:choose> + <xsl:apply-templates select="refmeta/manvolnum"/> +</xsl:template> + +<xsl:template match="refnamediv" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="refname[1]" mode="xref-to"> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="refname" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates mode="xref-to"/> +</xsl:template> + +<xsl:template match="step" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'Step'"/> + </xsl:call-template> + <xsl:text> </xsl:text> + <xsl:apply-templates select="." mode="number"/> +</xsl:template> + +<xsl:template match="varlistentry" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="term[1]" mode="xref-to"> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="varlistentry/term" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + + <!-- to avoid the comma that will be generated if there are several terms --> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="co" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + + <xsl:apply-templates select="." mode="callout-bug"/> +</xsl:template> + +<!-- This is currently not working, because there is no corresponding ID generated by Java extensions for processing callouts +<xsl:template match="area|areaset" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + + <xsl:call-template name="callout-bug"> + <xsl:with-param name="conum"> + <xsl:apply-templates select="." mode="conumber"/> + </xsl:with-param> + </xsl:call-template> +</xsl:template> +--> + +<xsl:template match="book" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:apply-templates select="." mode="object.xref.markup"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<xsl:template match="para" mode="xref-to"> + <xsl:param name="referrer"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="verbose" select="1"/> + + <xsl:variable name="context" select="(ancestor::simplesect + |ancestor::section + |ancestor::sect1 + |ancestor::sect2 + |ancestor::sect3 + |ancestor::sect4 + |ancestor::sect5 + |ancestor::refsection + |ancestor::refsect1 + |ancestor::refsect2 + |ancestor::refsect3 + |ancestor::chapter + |ancestor::appendix + |ancestor::preface + |ancestor::partintro + |ancestor::dedication + |ancestor::colophon + |ancestor::bibliography + |ancestor::index + |ancestor::glossary + |ancestor::glossentry + |ancestor::listitem + |ancestor::varlistentry)[last()]"/> + + <xsl:apply-templates select="$context" mode="xref-to"> + <xsl:with-param name="purpose" select="'xref'"/> + <xsl:with-param name="xrefstyle" select="$xrefstyle"/> + <xsl:with-param name="referrer" select="$referrer"/> + <xsl:with-param name="verbose" select="$verbose"/> + </xsl:apply-templates> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="xref-title"> + <xsl:variable name="title"> + <xsl:apply-templates select="." mode="object.title.markup"/> + </xsl:variable> + + <xsl:value-of select="$title"/> +</xsl:template> + +<xsl:template match="author" mode="xref-title"> + <xsl:variable name="title"> + <xsl:call-template name="person.name"/> + </xsl:variable> + + <xsl:value-of select="$title"/> +</xsl:template> + +<xsl:template match="authorgroup" mode="xref-title"> + <xsl:variable name="title"> + <xsl:call-template name="person.name.list"/> + </xsl:variable> + + <xsl:value-of select="$title"/> +</xsl:template> + +<xsl:template match="cmdsynopsis" mode="xref-title"> + <xsl:variable name="title"> + <xsl:apply-templates select="(.//command)[1]" mode="xref"/> + </xsl:variable> + + <xsl:value-of select="$title"/> +</xsl:template> + +<xsl:template match="funcsynopsis" mode="xref-title"> + <xsl:variable name="title"> + <xsl:apply-templates select="(.//function)[1]" mode="xref"/> + </xsl:variable> + + <xsl:value-of select="$title"/> +</xsl:template> + +<xsl:template match="biblioentry|bibliomixed" mode="xref-title"> + <!-- handles both biblioentry and bibliomixed --> + <xsl:variable name="title"> + <xsl:text>[</xsl:text> + <xsl:choose> + <xsl:when test="local-name(*[1]) = 'abbrev'"> + <xsl:apply-templates select="*[1]"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="@id"/> + </xsl:otherwise> + </xsl:choose> + <xsl:text>]</xsl:text> + </xsl:variable> + + <xsl:value-of select="$title"/> +</xsl:template> + +<xsl:template match="step" mode="xref-title"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'Step'"/> + </xsl:call-template> + <xsl:text> </xsl:text> + <xsl:apply-templates select="." mode="number"/> +</xsl:template> + +<xsl:template match="co" mode="xref-title"> + <xsl:variable name="title"> + <xsl:apply-templates select="." mode="callout-bug"/> + </xsl:variable> + + <xsl:value-of select="$title"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="link" name="link"> + <xsl:param name="a.target"/> + + <xsl:variable name="targets" select="key('id',@linkend)"/> + <xsl:variable name="target" select="$targets[1]"/> + + <xsl:call-template name="check.id.unique"> + <xsl:with-param name="linkend" select="@linkend"/> + </xsl:call-template> + + <a> + <xsl:if test="@id"> + <xsl:attribute name="name"><xsl:value-of select="@id"/></xsl:attribute> + </xsl:if> + + <xsl:if test="$a.target"> + <xsl:attribute name="target"><xsl:value-of select="$a.target"/></xsl:attribute> + </xsl:if> + + <xsl:attribute name="href"> + <xsl:call-template name="href.target"> + <xsl:with-param name="object" select="$target"/> + </xsl:call-template> + </xsl:attribute> + + <!-- FIXME: is there a better way to tell what elements have a title? --> + <xsl:if test="local-name($target) = 'book' + or local-name($target) = 'set' + or local-name($target) = 'chapter' + or local-name($target) = 'preface' + or local-name($target) = 'appendix' + or local-name($target) = 'bibliography' + or local-name($target) = 'glossary' + or local-name($target) = 'index' + or local-name($target) = 'part' + or local-name($target) = 'refentry' + or local-name($target) = 'reference' + or local-name($target) = 'example' + or local-name($target) = 'equation' + or local-name($target) = 'table' + or local-name($target) = 'figure' + or local-name($target) = 'simplesect' + or starts-with(local-name($target),'sect') + or starts-with(local-name($target),'refsect')"> + <xsl:attribute name="title"> + <xsl:apply-templates select="$target" + mode="object.title.markup.textonly"/> + </xsl:attribute> + </xsl:if> + + <xsl:choose> + <xsl:when test="count(child::node()) > 0"> + <!-- If it has content, use it --> + <xsl:apply-templates/> + </xsl:when> + <xsl:otherwise> + <!-- else look for an endterm --> + <xsl:choose> + <xsl:when test="@endterm"> + <xsl:variable name="etargets" select="key('id',@endterm)"/> + <xsl:variable name="etarget" select="$etargets[1]"/> + <xsl:choose> + <xsl:when test="count($etarget) = 0"> + <xsl:message> + <xsl:value-of select="count($etargets)"/> + <xsl:text>Endterm points to nonexistent ID: </xsl:text> + <xsl:value-of select="@endterm"/> + </xsl:message> + <xsl:text>???</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$etarget" mode="endterm"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + + <xsl:otherwise> + <xsl:message> + <xsl:text>Link element has no content and no Endterm. </xsl:text> + <xsl:text>Nothing to show in the link to </xsl:text> + <xsl:value-of select="$target"/> + </xsl:message> + <xsl:text>???</xsl:text> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </a> +</xsl:template> + +<xsl:template match="ulink" name="ulink"> + <xsl:variable name="link"> + <a> + <xsl:if test="@id"> + <xsl:attribute name="name"> + <xsl:value-of select="@id"/> + </xsl:attribute> + </xsl:if> + <xsl:attribute name="href"><xsl:value-of select="@url"/></xsl:attribute> + <xsl:if test="$ulink.target != ''"> + <xsl:attribute name="target"> + <xsl:value-of select="$ulink.target"/> + </xsl:attribute> + </xsl:if> + <xsl:choose> + <xsl:when test="count(child::node())=0"> + <xsl:value-of select="@url"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates/> + </xsl:otherwise> + </xsl:choose> + </a> + </xsl:variable> + + <xsl:choose> + <xsl:when test="function-available('suwl:unwrapLinks')"> + <xsl:copy-of select="suwl:unwrapLinks($link)"/> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$link"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="olink" name="olink"> + + <xsl:call-template name="anchor"/> + + <xsl:variable name="localinfo" select="@localinfo"/> + + <xsl:choose> + <!-- olinks resolved by stylesheet and target database --> + <xsl:when test="@targetdoc or @targetptr" > + <xsl:variable name="targetdoc.att" select="@targetdoc"/> + <xsl:variable name="targetptr.att" select="@targetptr"/> + + <xsl:variable name="olink.lang"> + <xsl:call-template name="l10n.language"> + <xsl:with-param name="xref-context" select="true()"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="target.database.filename"> + <xsl:call-template name="select.target.database"> + <xsl:with-param name="targetdoc.att" select="$targetdoc.att"/> + <xsl:with-param name="targetptr.att" select="$targetptr.att"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="target.database" + select="document($target.database.filename,/)"/> + + <xsl:if test="$olink.debug != 0"> + <xsl:message> + <xsl:text>Olink debug: root element of target.database '</xsl:text> + <xsl:value-of select="$target.database.filename"/> + <xsl:text>' is '</xsl:text> + <xsl:value-of select="local-name($target.database/*[1])"/> + <xsl:text>'.</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:variable name="olink.key"> + <xsl:call-template name="select.olink.key"> + <xsl:with-param name="targetdoc.att" select="$targetdoc.att"/> + <xsl:with-param name="targetptr.att" select="$targetptr.att"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + <xsl:with-param name="target.database" select="$target.database"/> + </xsl:call-template> + </xsl:variable> + + <xsl:if test="string-length($olink.key) = 0"> + <xsl:message> + <xsl:text>Error: unresolved olink: </xsl:text> + <xsl:text>targetdoc/targetptr = '</xsl:text> + <xsl:value-of select="$targetdoc.att"/> + <xsl:text>/</xsl:text> + <xsl:value-of select="$targetptr.att"/> + <xsl:text>'.</xsl:text> + </xsl:message> + </xsl:if> + + <xsl:variable name="href"> + <xsl:call-template name="make.olink.href"> + <xsl:with-param name="olink.key" select="$olink.key"/> + <xsl:with-param name="target.database" select="$target.database"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="hottext"> + <xsl:call-template name="olink.hottext"> + <xsl:with-param name="target.database" select="$target.database"/> + <xsl:with-param name="olink.key" select="$olink.key"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="olink.docname.citation"> + <xsl:call-template name="olink.document.citation"> + <xsl:with-param name="olink.key" select="$olink.key"/> + <xsl:with-param name="target.database" select="$target.database"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="olink.page.citation"> + <xsl:call-template name="olink.page.citation"> + <xsl:with-param name="olink.key" select="$olink.key"/> + <xsl:with-param name="target.database" select="$target.database"/> + <xsl:with-param name="olink.lang" select="$olink.lang"/> + </xsl:call-template> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$href != ''"> + <a href="{$href}" class="olink"> + <xsl:copy-of select="$hottext"/> + </a> + <xsl:copy-of select="$olink.page.citation"/> + <xsl:copy-of select="$olink.docname.citation"/> + </xsl:when> + <xsl:otherwise> + <span class="olink"><xsl:copy-of select="$hottext"/></span> + <xsl:copy-of select="$olink.page.citation"/> + <xsl:copy-of select="$olink.docname.citation"/> + </xsl:otherwise> + </xsl:choose> + + </xsl:when> + + <!-- Or use old olink mechanism --> + <xsl:otherwise> + <xsl:variable name="href"> + <xsl:choose> + <xsl:when test="@linkmode"> + <!-- use the linkmode to get the base URI, use localinfo as fragid --> + <xsl:variable name="modespec" select="key('id',@linkmode)"/> + <xsl:if test="count($modespec) != 1 + or local-name($modespec) != 'modespec'"> + <xsl:message>Warning: olink linkmode pointer is wrong.</xsl:message> + </xsl:if> + <xsl:value-of select="$modespec"/> + <xsl:if test="@localinfo"> + <xsl:text>#</xsl:text> + <xsl:value-of select="@localinfo"/> + </xsl:if> + </xsl:when> + <xsl:when test="@type = 'href'"> + <xsl:call-template name="olink.outline"> + <xsl:with-param name="outline.base.uri" + select="unparsed-entity-uri(@targetdocent)"/> + <xsl:with-param name="localinfo" select="@localinfo"/> + <xsl:with-param name="return" select="'href'"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$olink.resolver"/> + <xsl:text>?</xsl:text> + <xsl:value-of select="$olink.sysid"/> + <xsl:value-of select="unparsed-entity-uri(@targetdocent)"/> + <!-- XSL gives no access to the public identifier (grumble...) --> + <xsl:if test="@localinfo"> + <xsl:text>&</xsl:text> + <xsl:value-of select="$olink.fragid"/> + <xsl:value-of select="@localinfo"/> + </xsl:if> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$href != ''"> + <a href="{$href}" class="olink"> + <xsl:call-template name="olink.hottext"/> + </a> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="olink.hottext"/> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="*" mode="pagenumber.markup"> + <!-- no-op in HTML --> +</xsl:template> + + +<xsl:template name="olink.outline"> + <xsl:param name="outline.base.uri"/> + <xsl:param name="localinfo"/> + <xsl:param name="return" select="href"/> + + <xsl:variable name="outline-file" + select="concat($outline.base.uri, + $olink.outline.ext)"/> + + <xsl:variable name="outline" select="document($outline-file,.)/div"/> + + <xsl:variable name="node-href"> + <xsl:choose> + <xsl:when test="$localinfo != ''"> + <xsl:variable name="node" select="$outline//*[@id=$localinfo]"/> + <xsl:value-of select="$node/@href"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$outline/@href"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:variable name="node-xref"> + <xsl:choose> + <xsl:when test="$localinfo != ''"> + <xsl:variable name="node" select="$outline//*[@id=$localinfo]"/> + <xsl:copy-of select="$node/xref"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$outline/xref"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$return = 'href'"> + <xsl:value-of select="$node-href"/> + </xsl:when> + <xsl:when test="$return = 'xref'"> + <xsl:value-of select="$node-xref"/> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$node-xref"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="xref.xreflabel"> + <!-- called to process an xreflabel...you might use this to make --> + <!-- xreflabels come out in the right font for different targets, --> + <!-- for example. --> + <xsl:param name="target" select="."/> + <xsl:value-of select="$target/@xreflabel"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="title" mode="xref"> + <xsl:apply-templates/> +</xsl:template> + +<xsl:template match="command" mode="xref"> + <xsl:call-template name="inline.boldseq"/> +</xsl:template> + +<xsl:template match="function" mode="xref"> + <xsl:call-template name="inline.monoseq"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="*" mode="insert.title.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="title"/> + + <xsl:choose> + <!-- FIXME: what about the case where titleabbrev is inside the info? --> + <xsl:when test="$purpose = 'xref' and titleabbrev"> + <xsl:apply-templates select="." mode="titleabbrev.markup"/> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$title"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="chapter|appendix" mode="insert.title.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="title"/> + + <xsl:choose> + <xsl:when test="$purpose = 'xref'"> + <i> + <xsl:copy-of select="$title"/> + </i> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$title"/> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<xsl:template match="*" mode="insert.subtitle.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="subtitle"/> + + <xsl:copy-of select="$subtitle"/> +</xsl:template> + +<xsl:template match="*" mode="insert.label.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="label"/> + + <xsl:copy-of select="$label"/> +</xsl:template> + +<xsl:template match="*" mode="insert.pagenumber.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="pagenumber"/> + + <xsl:copy-of select="$pagenumber"/> +</xsl:template> + +<xsl:template match="*" mode="insert.direction.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="direction"/> + + <xsl:copy-of select="$direction"/> +</xsl:template> + +<xsl:template match="*" mode="insert.olink.docname.markup"> + <xsl:param name="purpose"/> + <xsl:param name="xrefstyle"/> + <xsl:param name="docname"/> + + <span class="olinkdocname"> + <xsl:copy-of select="$docname"/> + </span> + +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/htmlhelp/htmlhelp-common.xsl b/src/documentation/docbook-xsl/htmlhelp/htmlhelp-common.xsl new file mode 100644 index 0000000000..20122e015e --- /dev/null +++ b/src/documentation/docbook-xsl/htmlhelp/htmlhelp-common.xsl @@ -0,0 +1,1064 @@ +<?xml version="1.0"?> +<!DOCTYPE xsl:stylesheet [ +<!ENTITY lf '<xsl:text xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> </xsl:text>'> +]> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" + xmlns:exsl="http://exslt.org/common" + xmlns:set="http://exslt.org/sets" + xmlns:h="urn:x-hex" + xmlns:ng="http://docbook.org/docbook-ng" + xmlns:db="http://docbook.org/ns/docbook" + version="1.0" + exclude-result-prefixes="doc exsl set h db ng"> + +<!-- ******************************************************************** + $Id: htmlhelp-common.xsl,v 1.38 2006/05/21 15:05:10 kosek Exp $ + ******************************************************************** --> + +<!-- ==================================================================== --> +<!-- Customizations of standard HTML stylesheet parameters --> + +<!-- no navigation on pages by default, HTML Help provides its own navigation controls --> +<xsl:param name="suppress.navigation" select="1"/> + +<!-- no separate HTML page with index, index is built inside CHM index pane --> +<xsl:param name="generate.index" select="0"/> + +<!-- ==================================================================== --> + +<xsl:param name="htmlhelp.generate.index" select="//indexterm[1]"/> + +<!-- Set up HTML Help flag --> +<xsl:variable name="htmlhelp.output" select="1"/> + +<xsl:variable name="raw.help.title"> + <xsl:choose> + <xsl:when test="$htmlhelp.title = ''"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="key('id',$rootid)" mode="title.markup"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/*" mode="title.markup"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$htmlhelp.title"/> + </xsl:otherwise> + </xsl:choose> +</xsl:variable> + +<xsl:variable name="help.title" select="normalize-space($raw.help.title)"/> + +<!-- ==================================================================== --> + +<xsl:template match="/"> + <xsl:if test="$htmlhelp.only != 1"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:choose> + <xsl:when test="count(key('id',$rootid)) = 0"> + <xsl:message terminate="yes"> + <xsl:text>ID '</xsl:text> + <xsl:value-of select="$rootid"/> + <xsl:text>' not found in document.</xsl:text> + </xsl:message> + </xsl:when> + <xsl:otherwise> + <xsl:message>Formatting from <xsl:value-of select="$rootid"/></xsl:message> + <xsl:apply-templates select="key('id',$rootid)" mode="process.root"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="process.root"/> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:call-template name="hhp"/> + <xsl:call-template name="hhc"/> + <xsl:if test="($rootid = '' and //processing-instruction('dbhh')) or + ($rootid != '' and key('id',$rootid)//processing-instruction('dbhh'))"> + <xsl:call-template name="hh-map"/> + <xsl:call-template name="hh-alias"/> + </xsl:if> + <xsl:if test="$htmlhelp.generate.index"> + <xsl:call-template name="hhk"/> + </xsl:if> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="hhp"> + <xsl:call-template name="write.text.chunk"> + <xsl:with-param name="filename"> + <xsl:if test="$manifest.in.base.dir != 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + <xsl:value-of select="$htmlhelp.hhp"/> + </xsl:with-param> + <xsl:with-param name="method" select="'text'"/> + <xsl:with-param name="content"> + <xsl:call-template name="hhp-main"/> + </xsl:with-param> + <xsl:with-param name="encoding" select="$htmlhelp.encoding"/> + </xsl:call-template> +</xsl:template> + +<!-- ==================================================================== --> +<xsl:template name="hhp-main"> +<xsl:variable name="default.topic"> + <xsl:choose> + <xsl:when test="$htmlhelp.default.topic != ''"> + <xsl:value-of select="$htmlhelp.default.topic"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.dir"> + <xsl:if test="$manifest.in.base.dir = 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + </xsl:with-param> + <xsl:with-param name="base.name"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="key('id',$rootid)" mode="chunk-filename"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="chunk-filename"/> + </xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:variable> +<xsl:variable name="xnavigation"> + <xsl:text>0x</xsl:text> + <xsl:call-template name="toHex"> + <xsl:with-param name="n" select="9504 + $htmlhelp.show.menu * 65536 + + $htmlhelp.show.advanced.search * 131072 + + $htmlhelp.show.favorities * 4096 + + (1 - $htmlhelp.show.toolbar.text) * 64 + + $htmlhelp.remember.window.position * 262144"/> + </xsl:call-template> +</xsl:variable> +<xsl:variable name="xbuttons"> + <xsl:text>0x</xsl:text> + <xsl:call-template name="toHex"> + <xsl:with-param name="n" select="0 + $htmlhelp.button.hideshow * 2 + + $htmlhelp.button.back * 4 + + $htmlhelp.button.forward * 8 + + $htmlhelp.button.stop * 16 + + $htmlhelp.button.refresh * 32 + + $htmlhelp.button.home * 64 + + $htmlhelp.button.options * 4096 + + $htmlhelp.button.print * 8192 + + $htmlhelp.button.locate * 2048 + + $htmlhelp.button.jump1 * 262144 + + $htmlhelp.button.jump2 * 524288 + + $htmlhelp.button.next * 2097152 + + $htmlhelp.button.prev * 4194304 + + $htmlhelp.button.zoom * 1048576"/> + </xsl:call-template> +</xsl:variable> +<xsl:text>[OPTIONS] +</xsl:text> +<xsl:if test="$htmlhelp.generate.index"> +<xsl:text>Auto Index=Yes +</xsl:text></xsl:if> +<xsl:if test="$htmlhelp.hhc.binary != 0"> +<xsl:text>Binary TOC=Yes +</xsl:text></xsl:if> +<xsl:text>Compatibility=1.1 or later +Compiled file=</xsl:text><xsl:value-of select="$htmlhelp.chm"/><xsl:text> +Contents file=</xsl:text><xsl:value-of select="$htmlhelp.hhc"/><xsl:text> +</xsl:text> +<xsl:if test="$htmlhelp.hhp.window != ''"> +<xsl:text>Default Window=</xsl:text><xsl:value-of select="$htmlhelp.hhp.window"/><xsl:text> +</xsl:text></xsl:if> +<xsl:text>Default topic=</xsl:text><xsl:value-of select="$default.topic"/> +<xsl:text> +Display compile progress=</xsl:text> + <xsl:choose> + <xsl:when test="$htmlhelp.display.progress != 1"> + <xsl:text>No</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:text>Yes</xsl:text> + </xsl:otherwise> + </xsl:choose> +<xsl:text> +Full-text search=Yes +</xsl:text> +<xsl:if test="$htmlhelp.generate.index"> +<xsl:text>Index file=</xsl:text><xsl:value-of select="$htmlhelp.hhk"/><xsl:text> +</xsl:text></xsl:if> +<xsl:text>Language=</xsl:text> +<xsl:for-each select="*"> <!-- Change context from / to root element --> + <xsl:call-template name="gentext.template"> + <xsl:with-param name="context" select="'htmlhelp'"/> + <xsl:with-param name="name" select="'langcode'"/> + </xsl:call-template> +</xsl:for-each> +<xsl:text> +Title=</xsl:text> + <xsl:value-of select="$help.title"/> +<xsl:text> +Enhanced decompilation=</xsl:text> + <xsl:choose> + <xsl:when test="$htmlhelp.enhanced.decompilation != 0"> + <xsl:text>Yes</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:text>No</xsl:text> + </xsl:otherwise> + </xsl:choose> + +<xsl:if test="$htmlhelp.hhp.window != ''"> + <xsl:text> + +[WINDOWS] +</xsl:text> +<xsl:value-of select="$htmlhelp.hhp.window"/> +<xsl:text>="</xsl:text> +<xsl:value-of select="$help.title"/> +<xsl:text>","</xsl:text><xsl:value-of select="$htmlhelp.hhc"/> +<xsl:text>",</xsl:text> +<xsl:if test="$htmlhelp.generate.index"> + <xsl:text>"</xsl:text> + <xsl:value-of select="$htmlhelp.hhk"/> + <xsl:text>"</xsl:text> +</xsl:if> +<xsl:text>,"</xsl:text> +<xsl:value-of select="$default.topic"/> +<xsl:text>",</xsl:text> +<xsl:text>"</xsl:text> +<xsl:choose> + <xsl:when test="$htmlhelp.button.home != 0"> + <xsl:value-of select="$htmlhelp.button.home.url"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$default.topic"/> + </xsl:otherwise> +</xsl:choose> +<xsl:text>"</xsl:text> +<xsl:text>,</xsl:text> +<xsl:if test="$htmlhelp.button.jump1 != 0"> + <xsl:text>"</xsl:text> + <xsl:value-of select="$htmlhelp.button.jump1.url"/> + <xsl:text>"</xsl:text> +</xsl:if> +<xsl:text>,</xsl:text> +<xsl:if test="$htmlhelp.button.jump1 != 0"> + <xsl:text>"</xsl:text> + <xsl:value-of select="$htmlhelp.button.jump1.title"/> + <xsl:text>"</xsl:text> +</xsl:if> +<xsl:text>,</xsl:text> +<xsl:if test="$htmlhelp.button.jump2 != 0"> + <xsl:text>"</xsl:text> + <xsl:value-of select="$htmlhelp.button.jump2.url"/> + <xsl:text>"</xsl:text> +</xsl:if> +<xsl:text>,</xsl:text> +<xsl:if test="$htmlhelp.button.jump2 != 0"> + <xsl:text>"</xsl:text> + <xsl:value-of select="$htmlhelp.button.jump2.title"/> + <xsl:text>"</xsl:text> +</xsl:if> +<xsl:text>,</xsl:text> +<xsl:value-of select="$xnavigation"/> +<xsl:text>,</xsl:text><xsl:value-of select="$htmlhelp.hhc.width"/><xsl:text>,</xsl:text> +<xsl:value-of select="$xbuttons"/> +<xsl:text>,</xsl:text><xsl:value-of select="$htmlhelp.window.geometry"/><xsl:text>,,,,,,,0 +</xsl:text> +</xsl:if> + +<!-- + Needs more investigation to generate propetly all fields +<xsl:text>search="</xsl:text> +<xsl:value-of select="normalize-space(//title[1])"/> +<xsl:text>","toc.hhc","index.hhk","</xsl:text> +<xsl:value-of select="$root.filename"/> +<xsl:text>.html","</xsl:text> +<xsl:value-of select="$root.filename"/> +<xsl:text>.html",,,,,</xsl:text> +<xsl:value-of select="$xnavigation"/> +<xsl:text>,</xsl:text> +<xsl:value-of select="$htmlhelp.hhc.width"/> +<xsl:text>,</xsl:text> +<xsl:value-of select="$xbuttons"/> +<xsl:text>,</xsl:text> +<xsl:value-of select="$htmlhelp.window.geometry"/> +<xsl:text>,,,,,2,,0 +</xsl:text> +--> + +<xsl:if test="$htmlhelp.hhp.windows"> + <xsl:value-of select="$htmlhelp.hhp.windows"/> +</xsl:if> +<xsl:text> + +[FILES] +</xsl:text> + +<xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="key('id',$rootid)" mode="enumerate-files"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="enumerate-files"/> + </xsl:otherwise> +</xsl:choose> + +<xsl:if test="$htmlhelp.enumerate.images"> + <xsl:variable name="imagelist"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="key('id',$rootid)" mode="enumerate-images"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="enumerate-images"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set') and function-available('set:distinct')"> + <xsl:for-each select="set:distinct(exsl:node-set($imagelist)/filename)"> + <xsl:value-of select="."/> + <xsl:text> </xsl:text> + </xsl:for-each> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$imagelist"/> + </xsl:otherwise> + </xsl:choose> +</xsl:if> + +<xsl:if test="($htmlhelp.force.map.and.alias != 0) or + ($rootid = '' and //processing-instruction('dbhh')) or + ($rootid != '' and key('id',$rootid)//processing-instruction('dbhh'))"> + <xsl:text> +[ALIAS] +#include </xsl:text><xsl:value-of select="$htmlhelp.alias.file"/><xsl:text> + +[MAP] +#include </xsl:text><xsl:value-of select="$htmlhelp.map.file"/><xsl:text> +</xsl:text> +</xsl:if> + +<xsl:value-of select="$htmlhelp.hhp.tail"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="graphic|inlinegraphic[@format!='linespecific']" mode="enumerate-images"> + <xsl:call-template name="write.filename.enumerate-images"> + <xsl:with-param name="filename"> + <xsl:call-template name="mediaobject.filename.enumerate-images"> + <xsl:with-param name="object" select="."/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> +</xsl:template> + +<xsl:template match="mediaobject|inlinemediaobject" mode="enumerate-images"> + <xsl:call-template name="select.mediaobject.enumerate-images"/> +</xsl:template> + +<xsl:template name="select.mediaobject.enumerate-images"> + <xsl:param name="olist" + select="imageobject|imageobjectco + |videoobject|audioobject|textobject"/> + <xsl:param name="count">1</xsl:param> + + <xsl:if test="$count <= count($olist)"> + <xsl:variable name="object" select="$olist[position()=$count]"/> + + <xsl:variable name="useobject"> + <xsl:choose> + <!-- The phrase is never used --> + <xsl:when test="name($object)='textobject' and $object/phrase"> + <xsl:text>0</xsl:text> + </xsl:when> + <!-- The first textobject is a reasonable fallback (but not for image in HH) --> + <xsl:when test="name($object)='textobject'"> + <xsl:text>0</xsl:text> + </xsl:when> + <!-- If there's only one object, use it --> + <xsl:when test="$count = 1 and count($olist) = 1"> + <xsl:text>1</xsl:text> + </xsl:when> + <!-- Otherwise, see if this one is a useable graphic --> + <xsl:otherwise> + <xsl:choose> + <!-- peek inside imageobjectco to simplify the test --> + <xsl:when test="local-name($object) = 'imageobjectco'"> + <xsl:call-template name="is.acceptable.mediaobject"> + <xsl:with-param name="object" select="$object/imageobject"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="is.acceptable.mediaobject"> + <xsl:with-param name="object" select="$object"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$useobject='1' and $object[not(*/@format='linespecific')]"> + <xsl:call-template name="write.filename.enumerate-images"> + <xsl:with-param name="filename"> + <xsl:call-template name="mediaobject.filename.enumerate-images"> + <xsl:with-param name="object" select="$object"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="select.mediaobject.enumerate-images"> + <xsl:with-param name="olist" select="$olist"/> + <xsl:with-param name="count" select="$count + 1"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> +</xsl:template> + +<xsl:template name="mediaobject.filename.enumerate-images"> + <xsl:param name="object"/> + + <xsl:variable name="urifilename"> + <xsl:call-template name="mediaobject.filename"> + <xsl:with-param name="object" select="$object"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="filename"> + <xsl:choose> + <xsl:when test="starts-with($urifilename, 'file:/')"> + <xsl:value-of select="substring-after($urifilename, 'file:/')"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$urifilename"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:value-of select="translate($filename, '/', '\')"/> + +</xsl:template> + +<xsl:template match="text()" mode="enumerate-images"> +</xsl:template> + +<xsl:template name="write.filename.enumerate-images"> + <xsl:param name="filename"/> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set') and function-available('set:distinct')"> + <filename><xsl:value-of select="$filename"/></filename> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$filename"/> + <xsl:text> </xsl:text> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<!-- HHC and HHK files are processed by compiler line by line + and therefore are very sensitive to whitespaces (linefeeds for sure). --> + +<xsl:template name="hhc"> + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename"> + <xsl:if test="$manifest.in.base.dir != 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + <xsl:value-of select="$htmlhelp.hhc"/> + </xsl:with-param> + <xsl:with-param name="indent" select="'no'"/> + <xsl:with-param name="content"> + <xsl:call-template name="hhc-main"/> + </xsl:with-param> + <xsl:with-param name="encoding" select="$htmlhelp.encoding"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="hhc-main"> +<HTML>&lf; + <HEAD></HEAD>&lf; + <BODY>&lf; + <xsl:if test="$htmlhelp.hhc.folders.instead.books != 0"> + <OBJECT type="text/site properties">&lf; + <param name="ImageType" value="Folder"/>&lf; + </OBJECT>&lf; + </xsl:if> + <xsl:variable name="content"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="key('id',$rootid)" mode="hhc"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="hhc"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$htmlhelp.hhc.show.root != 0"> + <UL>&lf; + <xsl:copy-of select="$content"/> + </UL>&lf; + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$content"/> + </xsl:otherwise> + </xsl:choose> + + </BODY> +</HTML> +</xsl:template> + +<xsl:template name="hhc.entry"> + <xsl:param name="title"> + <xsl:if test="$htmlhelp.autolabel=1"> + <xsl:variable name="label.markup"> + <xsl:apply-templates select="." mode="label.markup"/> + </xsl:variable> + <xsl:if test="normalize-space($label.markup)"> + <xsl:value-of select="concat($label.markup,$autotoc.label.separator)"/> + </xsl:if> + </xsl:if> + <xsl:apply-templates select="." mode="title.markup"/> + </xsl:param> + + <LI><OBJECT type="text/sitemap">&lf; + <param name="Name"> + <xsl:attribute name="value"> + <xsl:value-of select="normalize-space($title)"/> + </xsl:attribute> + </param>&lf; + <param name="Local"> + <xsl:attribute name="value"> + <xsl:call-template name="href.target.with.base.dir"/> + </xsl:attribute> + </param> + </OBJECT></LI>&lf; +</xsl:template> + +<xsl:template match="set" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="book"> + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + <UL> + <xsl:if test="contains($toc.params, 'toc') and $htmlhelp.hhc.show.root = 0"> + <LI><OBJECT type="text/sitemap">&lf; + <param name="Name"> + <xsl:attribute name="value"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'TableofContents'"/> + </xsl:call-template> + </xsl:attribute> + </param>&lf; + <param name="Local"> + <xsl:attribute name="value"> + <xsl:choose> + <xsl:when test="$chunk.tocs.and.lots != 0"> + <xsl:apply-templates select="." mode="recursive-chunk-filename"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + <xsl:text>-toc</xsl:text> + <xsl:value-of select="$html.ext"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="href.target.with.base.dir"/> + </xsl:otherwise> + </xsl:choose> + </xsl:attribute> + </param> + </OBJECT></LI>&lf; + </xsl:if> + <xsl:apply-templates select="book" mode="hhc"/> + </UL>&lf; + </xsl:if> +</xsl:template> + +<xsl:template match="book" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="part|reference|preface|chapter|appendix|bibliography|article|colophon|glossary"> + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + <UL> + <xsl:if test="contains($toc.params, 'toc') and $htmlhelp.hhc.show.root = 0 and not(parent::*)"> + <LI><OBJECT type="text/sitemap">&lf; + <param name="Name"> + <xsl:attribute name="value"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'TableofContents'"/> + </xsl:call-template> + </xsl:attribute> + </param>&lf; + <param name="Local"> + <xsl:attribute name="value"> + <xsl:choose> + <xsl:when test="$chunk.tocs.and.lots != 0"> + <xsl:apply-templates select="." mode="recursive-chunk-filename"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + <xsl:text>-toc</xsl:text> + <xsl:value-of select="$html.ext"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="href.target.with.base.dir"/> + </xsl:otherwise> + </xsl:choose> + </xsl:attribute> + </param> + </OBJECT></LI>&lf; + </xsl:if> + <xsl:apply-templates select="part|reference|preface|chapter|bibliography|appendix|article|colophon|glossary" + mode="hhc"/> + </UL>&lf; + </xsl:if> +</xsl:template> + +<xsl:template match="part|reference|preface|chapter|bibliography|appendix|article|glossary" + mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="reference|preface|chapter|appendix|refentry|section|sect1|bibliodiv"> + <UL>&lf; + <xsl:apply-templates + select="reference|preface|chapter|appendix|refentry|section|sect1|bibliodiv" + mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="section" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="section[count(ancestor::section) < $htmlhelp.hhc.section.depth]|refentry"> + <UL>&lf; + <xsl:apply-templates select="section|refentry" mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="sect1" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="sect2[$htmlhelp.hhc.section.depth > 1]|refentry"> + <UL>&lf; + <xsl:apply-templates select="sect2|refentry" + mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="sect2" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="sect3[$htmlhelp.hhc.section.depth > 2]|refentry"> + <UL>&lf; + <xsl:apply-templates select="sect3|refentry" + mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="sect3" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="sect4[$htmlhelp.hhc.section.depth > 3]|refentry"> + <UL>&lf; + <xsl:apply-templates select="sect4|refentry" + mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="sect4" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="sect5[$htmlhelp.hhc.section.depth > 4]|refentry"> + <UL>&lf; + <xsl:apply-templates select="sect5|refentry" + mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="sect5|refentry|colophon|bibliodiv" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="refentry"> + <UL>&lf; + <xsl:apply-templates select="refentry" + mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="indexterm"> + <xsl:choose> + <xsl:when test="$htmlhelp.use.hhk = 0"> + + <xsl:variable name="primary" select="normalize-space(primary)"/> + <xsl:variable name="secondary" select="normalize-space(secondary)"/> + <xsl:variable name="tertiary" select="normalize-space(tertiary)"/> + + <xsl:variable name="text"> + <xsl:value-of select="$primary"/> + <xsl:if test="secondary"> + <xsl:text>, </xsl:text> + <xsl:value-of select="$secondary"/> + </xsl:if> + <xsl:if test="tertiary"> + <xsl:text>, </xsl:text> + <xsl:value-of select="$tertiary"/> + </xsl:if> + </xsl:variable> + + <xsl:if test="secondary"> + <xsl:if test="not(//indexterm[normalize-space(primary)=$primary and not(secondary)])"> + <xsl:call-template name="write.indexterm"> + <xsl:with-param name="text" select="$primary"/> + </xsl:call-template> + </xsl:if> + </xsl:if> + + <xsl:if test="tertiary"> + <xsl:if test="not(//indexterm[normalize-space(primary)=$primary and + normalize-space(secondary)=$secondary and not(tertiary)])"> + <xsl:call-template name="write.indexterm"> + <xsl:with-param name="text" select="concat($primary, ', ', $secondary)"/> + </xsl:call-template> + </xsl:if> + </xsl:if> + + <xsl:call-template name="write.indexterm"> + <xsl:with-param name="text" select="$text"/> + </xsl:call-template> + + </xsl:when> + <xsl:otherwise> + <a> + <xsl:attribute name="name"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </a> + </xsl:otherwise> + + </xsl:choose> +</xsl:template> + +<xsl:template name="write.indexterm"> + <xsl:param name="text"/> + <OBJECT type="application/x-oleobject" + classid="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e"> + <param name="Keyword" value="{$text}"/> + </OBJECT> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="hhk"> + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename"> + <xsl:if test="$manifest.in.base.dir != 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + <xsl:value-of select="$htmlhelp.hhk"/> + </xsl:with-param> + <xsl:with-param name="indent" select="'no'"/> + <xsl:with-param name="content"><xsl:text disable-output-escaping="yes"><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML> +<HEAD> +<meta name="GENERATOR" content="Microsoft® HTML Help Workshop 4.1"> +<!-- Sitemap 1.0 --> +</HEAD><BODY> +<OBJECT type="text/site properties"> +</OBJECT> +<UL>]]> +</xsl:text> +<xsl:if test="($htmlhelp.use.hhk != 0) and $htmlhelp.generate.index"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="key('id',$rootid)" mode="hhk"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="hhk"/> + </xsl:otherwise> + </xsl:choose> +</xsl:if> +<xsl:text disable-output-escaping="yes"><![CDATA[</UL> +</BODY></HTML>]]> +</xsl:text></xsl:with-param> + <xsl:with-param name="encoding" select="$htmlhelp.encoding"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="indexterm[@class='endofrange']" mode="hhk"/> + +<xsl:template match="indexterm" mode="hhk"> + <xsl:variable name="primary" select="normalize-space(primary)"/> + <xsl:variable name="secondary" select="normalize-space(secondary)"/> + <xsl:variable name="tertiary" select="normalize-space(tertiary)"/> + + <xsl:call-template name="write.indexterm.hhk"> + <xsl:with-param name="text" select="$primary"/> + <xsl:with-param name="seealso" select="seealso"/> + </xsl:call-template> + + <xsl:if test="secondary"> + <xsl:if test="not(//indexterm[normalize-space(primary)=$primary and not(secondary)])"> + <xsl:call-template name="write.indexterm.hhk"> + <!-- We must create fake entry when there is secondary without primary --> + <xsl:with-param name="text" select="$primary"/> + <xsl:with-param name="seealso" select="$primary"/> + </xsl:call-template> + </xsl:if> + <UL> + <xsl:call-template name="write.indexterm.hhk"> + <xsl:with-param name="text" select="$secondary"/> + <xsl:with-param name="seealso" select="secondary/seealso"/> + </xsl:call-template> + <xsl:if test="tertiary"> + <UL>&lf; + <xsl:call-template name="write.indexterm.hhk"> + <xsl:with-param name="text" select="$tertiary"/> + <xsl:with-param name="seealso" select="tertiary/seealso"/> + </xsl:call-template> + </UL> + </xsl:if> + </UL> + </xsl:if> + +</xsl:template> + +<xsl:template name="write.indexterm.hhk"> + <xsl:param name="text"/> + <xsl:param name="seealso"/> + + <LI> <OBJECT type="text/sitemap">&lf; + <param name="Name"> + <xsl:attribute name="value"> + <xsl:value-of select="$text"/> + </xsl:attribute> + </param>&lf; + + <xsl:if test="not(seealso)"> + <xsl:variable name="href"> + <xsl:call-template name="href.target.with.base.dir"/> + </xsl:variable> + <xsl:variable name="title"> + <xsl:call-template name="nearest.title"> + <xsl:with-param name="object" select=".."/> + </xsl:call-template> + </xsl:variable> + + <param name="Name"> + <xsl:attribute name="value"> + <xsl:value-of select="$title"/> + </xsl:attribute> + </param>&lf; + <param name="Local"> + <xsl:attribute name="value"> + <xsl:value-of select="$href"/> + </xsl:attribute> + </param>&lf; + </xsl:if> + + <xsl:if test="seealso"> + <param name="See Also"> + <xsl:attribute name="value"> + <xsl:value-of select="$seealso"/> + </xsl:attribute> + </param>&lf; + </xsl:if> + </OBJECT></LI> +</xsl:template> + +<xsl:template match="text()" mode="hhk"/> + +<xsl:template name="nearest.title"> + <xsl:param name="object"/> + <xsl:apply-templates select="$object/ancestor-or-self::*[title][1]" mode="title.markup"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="hh-map"> + <xsl:call-template name="write.text.chunk"> + <xsl:with-param name="filename"> + <xsl:if test="$manifest.in.base.dir != 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + <xsl:value-of select="$htmlhelp.map.file"/> + </xsl:with-param> + <xsl:with-param name="method" select="'text'"/> + <xsl:with-param name="content"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="key('id',$rootid)" mode="hh-map"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="hh-map"/> + </xsl:otherwise> + </xsl:choose> + </xsl:with-param> + <xsl:with-param name="encoding" select="$htmlhelp.encoding"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="processing-instruction('dbhh')" mode="hh-map"> + <xsl:variable name="topicname"> + <xsl:call-template name="pi-attribute"> + <xsl:with-param name="pis" + select="."/> + <xsl:with-param name="attribute" select="'topicname'"/> + </xsl:call-template> + </xsl:variable> + <xsl:variable name="topicid"> + <xsl:call-template name="pi-attribute"> + <xsl:with-param name="pis" + select="."/> + <xsl:with-param name="attribute" select="'topicid'"/> + </xsl:call-template> + </xsl:variable> + <xsl:text>#define </xsl:text> + <xsl:value-of select="$topicname"/> + <xsl:text> </xsl:text> + <xsl:value-of select="$topicid"/> + <xsl:text> </xsl:text> +</xsl:template> + +<xsl:template match="text()" mode="hh-map"/> + +<!-- ==================================================================== --> + +<xsl:template name="hh-alias"> + <xsl:call-template name="write.text.chunk"> + <xsl:with-param name="filename"> + <xsl:if test="$manifest.in.base.dir != 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + <xsl:value-of select="$htmlhelp.alias.file"/> + </xsl:with-param> + <xsl:with-param name="method" select="'text'"/> + <xsl:with-param name="content"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="key('id',$rootid)" mode="hh-alias"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="hh-alias"/> + </xsl:otherwise> + </xsl:choose> + </xsl:with-param> + <xsl:with-param name="encoding" select="$htmlhelp.encoding"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="processing-instruction('dbhh')" mode="hh-alias"> + <xsl:variable name="topicname"> + <xsl:call-template name="pi-attribute"> + <xsl:with-param name="pis" + select="."/> + <xsl:with-param name="attribute" select="'topicname'"/> + </xsl:call-template> + </xsl:variable> + <xsl:variable name="href"> + <xsl:call-template name="href.target.with.base.dir"> + <xsl:with-param name="object" select=".."/> + </xsl:call-template> + </xsl:variable> + <xsl:value-of select="$topicname"/> + <xsl:text>=</xsl:text> + <!-- Some versions of HH doesn't like fragment identifires, but some does. --> + <!-- <xsl:value-of select="substring-before(concat($href, '#'), '#')"/> --> + <xsl:value-of select="$href"/> + <xsl:text> </xsl:text> +</xsl:template> + +<xsl:template match="text()" mode="hh-alias"/> + +<!-- ==================================================================== --> +<!-- This code can be used to convert any number to hexadecimal format --> + + <h:hex> + <d>0</d> + <d>1</d> + <d>2</d> + <d>3</d> + <d>4</d> + <d>5</d> + <d>6</d> + <d>7</d> + <d>8</d> + <d>9</d> + <d>A</d> + <d>B</d> + <d>C</d> + <d>D</d> + <d>E</d> + <d>F</d> + </h:hex> + + <xsl:template name="toHex"> + <xsl:param name="n" select="0"/> + <xsl:param name="digit" select="$n mod 16"/> + <xsl:param name="rest" select="floor($n div 16)"/> + <xsl:if test="$rest > 0"> + <xsl:call-template name="toHex"> + <xsl:with-param name="n" select="$rest"/> + </xsl:call-template> + </xsl:if> + <xsl:value-of select="document('')//h:hex/d[$digit+1]"/> + </xsl:template> + +<!-- ==================================================================== --> +<!-- Modification to standard HTML stylesheets --> + +<!-- There are links from ToC pane to bibliodivs, so there must be anchor --> +<xsl:template match="bibliodiv/title"> + <h3 class="{name(.)}"> + <xsl:call-template name="anchor"> + <xsl:with-param name="node" select=".."/> + <xsl:with-param name="conditional" select="0"/> + </xsl:call-template> + <xsl:apply-templates/> + </h3> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/htmlhelp/htmlhelp.xsl b/src/documentation/docbook-xsl/htmlhelp/htmlhelp.xsl new file mode 100644 index 0000000000..ebba6d8a45 --- /dev/null +++ b/src/documentation/docbook-xsl/htmlhelp/htmlhelp.xsl @@ -0,0 +1,22 @@ +<?xml version="1.0"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" + xmlns:exsl="http://exslt.org/common" + xmlns:set="http://exslt.org/sets" + version="1.0" + exclude-result-prefixes="doc exsl set"> + +<!-- ******************************************************************** + $Id: htmlhelp.xsl,v 1.25 2002/06/12 13:21:54 kosek Exp $ + ******************************************************************** + + This file is used by htmlhelp.xsl if you want to generate source + files for HTML Help. It is based on the XSL DocBook Stylesheet + distribution (especially on JavaHelp code) from Norman Walsh. + + ******************************************************************** --> + +<xsl:import href="../html/chunk.xsl"/> +<xsl:include href="htmlhelp-common.xsl"/> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/htmlhelp/profile-htmlhelp-common.xsl b/src/documentation/docbook-xsl/htmlhelp/profile-htmlhelp-common.xsl new file mode 100644 index 0000000000..2401c65a0b --- /dev/null +++ b/src/documentation/docbook-xsl/htmlhelp/profile-htmlhelp-common.xsl @@ -0,0 +1,1055 @@ +<?xml version="1.0" encoding="US-ASCII"?> +<!--This file was created automatically by xsl2profile--> +<!--from the DocBook XSL stylesheets. Do not edit this file.--> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" xmlns:exsl="http://exslt.org/common" xmlns:set="http://exslt.org/sets" xmlns:h="urn:x-hex" xmlns:ng="http://docbook.org/docbook-ng" xmlns:db="http://docbook.org/ns/docbook" xmlns:exslt="http://exslt.org/common" exslt:dummy="dummy" ng:dummy="dummy" db:dummy="dummy" extension-element-prefixes="exslt" version="1.0" exclude-result-prefixes="doc exsl set h db ng exslt"> + +<!-- ******************************************************************** + $Id: htmlhelp-common.xsl,v 1.38 2006/05/21 15:05:10 kosek Exp $ + ******************************************************************** --> + +<!-- ==================================================================== --> +<!-- Customizations of standard HTML stylesheet parameters --> + +<!-- no navigation on pages by default, HTML Help provides its own navigation controls --> +<xsl:param name="suppress.navigation" select="1"/> + +<!-- no separate HTML page with index, index is built inside CHM index pane --> +<xsl:param name="generate.index" select="0"/> + +<!-- ==================================================================== --> + +<xsl:param name="htmlhelp.generate.index" select="//indexterm[1]"/> + +<!-- Set up HTML Help flag --> +<xsl:variable name="htmlhelp.output" select="1"/> + +<xsl:variable name="raw.help.title"> + <xsl:choose> + <xsl:when test="$htmlhelp.title = ''"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="$profiled-nodes//*[@id=$rootid]" mode="title.markup"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$profiled-nodes/*" mode="title.markup"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$htmlhelp.title"/> + </xsl:otherwise> + </xsl:choose> +</xsl:variable> + +<xsl:variable name="help.title" select="normalize-space($raw.help.title)"/> + +<!-- ==================================================================== --> + +<xslo:include xmlns:xslo="http://www.w3.org/1999/XSL/Transform" href="../profiling/profile-mode.xsl"/><xslo:variable xmlns:xslo="http://www.w3.org/1999/XSL/Transform" name="profiled-content"><xslo:choose><xslo:when test="*/self::ng:* or */self::db:*"><xslo:message>Stripping NS from DocBook 5/NG document.</xslo:message><xslo:variable name="stripped-content"><xslo:apply-templates select="/" mode="stripNS"/></xslo:variable><xslo:message>Processing stripped document.</xslo:message><xslo:apply-templates select="exslt:node-set($stripped-content)" mode="profile"/></xslo:when><xslo:otherwise><xslo:apply-templates select="/" mode="profile"/></xslo:otherwise></xslo:choose></xslo:variable><xslo:variable xmlns:xslo="http://www.w3.org/1999/XSL/Transform" name="profiled-nodes" select="exslt:node-set($profiled-content)"/><xsl:template match="/"> + <xsl:if test="$htmlhelp.only != 1"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:choose> + <xsl:when test="count($profiled-nodes//*[@id=$rootid]) = 0"> + <xsl:message terminate="yes"> + <xsl:text>ID '</xsl:text> + <xsl:value-of select="$rootid"/> + <xsl:text>' not found in document.</xsl:text> + </xsl:message> + </xsl:when> + <xsl:otherwise> + <xsl:message>Formatting from <xsl:value-of select="$rootid"/></xsl:message> + <xsl:apply-templates select="$profiled-nodes//*[@id=$rootid]" mode="process.root"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$profiled-nodes" mode="process.root"/> + </xsl:otherwise> + </xsl:choose> + </xsl:if> + + <xsl:call-template name="hhp"/> + <xsl:call-template name="hhc"/> + <xsl:if test="($rootid = '' and //processing-instruction('dbhh')) or ($rootid != '' and $profiled-nodes//*[@id=$rootid]//processing-instruction('dbhh'))"> + <xsl:call-template name="hh-map"/> + <xsl:call-template name="hh-alias"/> + </xsl:if> + <xsl:if test="$htmlhelp.generate.index"> + <xsl:call-template name="hhk"/> + </xsl:if> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="hhp"> + <xsl:call-template name="write.text.chunk"> + <xsl:with-param name="filename"> + <xsl:if test="$manifest.in.base.dir != 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + <xsl:value-of select="$htmlhelp.hhp"/> + </xsl:with-param> + <xsl:with-param name="method" select="'text'"/> + <xsl:with-param name="content"> + <xsl:call-template name="hhp-main"/> + </xsl:with-param> + <xsl:with-param name="encoding" select="$htmlhelp.encoding"/> + </xsl:call-template> +</xsl:template> + +<!-- ==================================================================== --> +<xsl:template name="hhp-main"> +<xsl:variable name="default.topic"> + <xsl:choose> + <xsl:when test="$htmlhelp.default.topic != ''"> + <xsl:value-of select="$htmlhelp.default.topic"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="make-relative-filename"> + <xsl:with-param name="base.dir"> + <xsl:if test="$manifest.in.base.dir = 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + </xsl:with-param> + <xsl:with-param name="base.name"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="$profiled-nodes//*[@id=$rootid]" mode="chunk-filename"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$profiled-nodes" mode="chunk-filename"/> + </xsl:otherwise> + </xsl:choose> + </xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> +</xsl:variable> +<xsl:variable name="xnavigation"> + <xsl:text>0x</xsl:text> + <xsl:call-template name="toHex"> + <xsl:with-param name="n" select="9504 + $htmlhelp.show.menu * 65536 + $htmlhelp.show.advanced.search * 131072 + $htmlhelp.show.favorities * 4096 + (1 - $htmlhelp.show.toolbar.text) * 64 + $htmlhelp.remember.window.position * 262144"/> + </xsl:call-template> +</xsl:variable> +<xsl:variable name="xbuttons"> + <xsl:text>0x</xsl:text> + <xsl:call-template name="toHex"> + <xsl:with-param name="n" select="0 + $htmlhelp.button.hideshow * 2 + $htmlhelp.button.back * 4 + $htmlhelp.button.forward * 8 + $htmlhelp.button.stop * 16 + $htmlhelp.button.refresh * 32 + $htmlhelp.button.home * 64 + $htmlhelp.button.options * 4096 + $htmlhelp.button.print * 8192 + $htmlhelp.button.locate * 2048 + $htmlhelp.button.jump1 * 262144 + $htmlhelp.button.jump2 * 524288 + $htmlhelp.button.next * 2097152 + $htmlhelp.button.prev * 4194304 + $htmlhelp.button.zoom * 1048576"/> + </xsl:call-template> +</xsl:variable> +<xsl:text>[OPTIONS] +</xsl:text> +<xsl:if test="$htmlhelp.generate.index"> +<xsl:text>Auto Index=Yes +</xsl:text></xsl:if> +<xsl:if test="$htmlhelp.hhc.binary != 0"> +<xsl:text>Binary TOC=Yes +</xsl:text></xsl:if> +<xsl:text>Compatibility=1.1 or later +Compiled file=</xsl:text><xsl:value-of select="$htmlhelp.chm"/><xsl:text> +Contents file=</xsl:text><xsl:value-of select="$htmlhelp.hhc"/><xsl:text> +</xsl:text> +<xsl:if test="$htmlhelp.hhp.window != ''"> +<xsl:text>Default Window=</xsl:text><xsl:value-of select="$htmlhelp.hhp.window"/><xsl:text> +</xsl:text></xsl:if> +<xsl:text>Default topic=</xsl:text><xsl:value-of select="$default.topic"/> +<xsl:text> +Display compile progress=</xsl:text> + <xsl:choose> + <xsl:when test="$htmlhelp.display.progress != 1"> + <xsl:text>No</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:text>Yes</xsl:text> + </xsl:otherwise> + </xsl:choose> +<xsl:text> +Full-text search=Yes +</xsl:text> +<xsl:if test="$htmlhelp.generate.index"> +<xsl:text>Index file=</xsl:text><xsl:value-of select="$htmlhelp.hhk"/><xsl:text> +</xsl:text></xsl:if> +<xsl:text>Language=</xsl:text> +<xsl:for-each select="*"> <!-- Change context from / to root element --> + <xsl:call-template name="gentext.template"> + <xsl:with-param name="context" select="'htmlhelp'"/> + <xsl:with-param name="name" select="'langcode'"/> + </xsl:call-template> +</xsl:for-each> +<xsl:text> +Title=</xsl:text> + <xsl:value-of select="$help.title"/> +<xsl:text> +Enhanced decompilation=</xsl:text> + <xsl:choose> + <xsl:when test="$htmlhelp.enhanced.decompilation != 0"> + <xsl:text>Yes</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:text>No</xsl:text> + </xsl:otherwise> + </xsl:choose> + +<xsl:if test="$htmlhelp.hhp.window != ''"> + <xsl:text> + +[WINDOWS] +</xsl:text> +<xsl:value-of select="$htmlhelp.hhp.window"/> +<xsl:text>="</xsl:text> +<xsl:value-of select="$help.title"/> +<xsl:text>","</xsl:text><xsl:value-of select="$htmlhelp.hhc"/> +<xsl:text>",</xsl:text> +<xsl:if test="$htmlhelp.generate.index"> + <xsl:text>"</xsl:text> + <xsl:value-of select="$htmlhelp.hhk"/> + <xsl:text>"</xsl:text> +</xsl:if> +<xsl:text>,"</xsl:text> +<xsl:value-of select="$default.topic"/> +<xsl:text>",</xsl:text> +<xsl:text>"</xsl:text> +<xsl:choose> + <xsl:when test="$htmlhelp.button.home != 0"> + <xsl:value-of select="$htmlhelp.button.home.url"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$default.topic"/> + </xsl:otherwise> +</xsl:choose> +<xsl:text>"</xsl:text> +<xsl:text>,</xsl:text> +<xsl:if test="$htmlhelp.button.jump1 != 0"> + <xsl:text>"</xsl:text> + <xsl:value-of select="$htmlhelp.button.jump1.url"/> + <xsl:text>"</xsl:text> +</xsl:if> +<xsl:text>,</xsl:text> +<xsl:if test="$htmlhelp.button.jump1 != 0"> + <xsl:text>"</xsl:text> + <xsl:value-of select="$htmlhelp.button.jump1.title"/> + <xsl:text>"</xsl:text> +</xsl:if> +<xsl:text>,</xsl:text> +<xsl:if test="$htmlhelp.button.jump2 != 0"> + <xsl:text>"</xsl:text> + <xsl:value-of select="$htmlhelp.button.jump2.url"/> + <xsl:text>"</xsl:text> +</xsl:if> +<xsl:text>,</xsl:text> +<xsl:if test="$htmlhelp.button.jump2 != 0"> + <xsl:text>"</xsl:text> + <xsl:value-of select="$htmlhelp.button.jump2.title"/> + <xsl:text>"</xsl:text> +</xsl:if> +<xsl:text>,</xsl:text> +<xsl:value-of select="$xnavigation"/> +<xsl:text>,</xsl:text><xsl:value-of select="$htmlhelp.hhc.width"/><xsl:text>,</xsl:text> +<xsl:value-of select="$xbuttons"/> +<xsl:text>,</xsl:text><xsl:value-of select="$htmlhelp.window.geometry"/><xsl:text>,,,,,,,0 +</xsl:text> +</xsl:if> + +<!-- + Needs more investigation to generate propetly all fields +<xsl:text>search="</xsl:text> +<xsl:value-of select="normalize-space(//title[1])"/> +<xsl:text>","toc.hhc","index.hhk","</xsl:text> +<xsl:value-of select="$root.filename"/> +<xsl:text>.html","</xsl:text> +<xsl:value-of select="$root.filename"/> +<xsl:text>.html",,,,,</xsl:text> +<xsl:value-of select="$xnavigation"/> +<xsl:text>,</xsl:text> +<xsl:value-of select="$htmlhelp.hhc.width"/> +<xsl:text>,</xsl:text> +<xsl:value-of select="$xbuttons"/> +<xsl:text>,</xsl:text> +<xsl:value-of select="$htmlhelp.window.geometry"/> +<xsl:text>,,,,,2,,0 +</xsl:text> +--> + +<xsl:if test="$htmlhelp.hhp.windows"> + <xsl:value-of select="$htmlhelp.hhp.windows"/> +</xsl:if> +<xsl:text> + +[FILES] +</xsl:text> + +<xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="$profiled-nodes//*[@id=$rootid]" mode="enumerate-files"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$profiled-nodes" mode="enumerate-files"/> + </xsl:otherwise> +</xsl:choose> + +<xsl:if test="$htmlhelp.enumerate.images"> + <xsl:variable name="imagelist"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="$profiled-nodes//*[@id=$rootid]" mode="enumerate-images"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$profiled-nodes" mode="enumerate-images"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set') and function-available('set:distinct')"> + <xsl:for-each select="set:distinct(exsl:node-set($imagelist)/filename)"> + <xsl:value-of select="."/> + <xsl:text> +</xsl:text> + </xsl:for-each> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$imagelist"/> + </xsl:otherwise> + </xsl:choose> +</xsl:if> + +<xsl:if test="($htmlhelp.force.map.and.alias != 0) or ($rootid = '' and //processing-instruction('dbhh')) or ($rootid != '' and $profiled-nodes//*[@id=$rootid]//processing-instruction('dbhh'))"> + <xsl:text> +[ALIAS] +#include </xsl:text><xsl:value-of select="$htmlhelp.alias.file"/><xsl:text> + +[MAP] +#include </xsl:text><xsl:value-of select="$htmlhelp.map.file"/><xsl:text> +</xsl:text> +</xsl:if> + +<xsl:value-of select="$htmlhelp.hhp.tail"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="graphic|inlinegraphic[@format!='linespecific']" mode="enumerate-images"> + <xsl:call-template name="write.filename.enumerate-images"> + <xsl:with-param name="filename"> + <xsl:call-template name="mediaobject.filename.enumerate-images"> + <xsl:with-param name="object" select="."/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> +</xsl:template> + +<xsl:template match="mediaobject|inlinemediaobject" mode="enumerate-images"> + <xsl:call-template name="select.mediaobject.enumerate-images"/> +</xsl:template> + +<xsl:template name="select.mediaobject.enumerate-images"> + <xsl:param name="olist" select="imageobject|imageobjectco |videoobject|audioobject|textobject"/> + <xsl:param name="count">1</xsl:param> + + <xsl:if test="$count <= count($olist)"> + <xsl:variable name="object" select="$olist[position()=$count]"/> + + <xsl:variable name="useobject"> + <xsl:choose> + <!-- The phrase is never used --> + <xsl:when test="name($object)='textobject' and $object/phrase"> + <xsl:text>0</xsl:text> + </xsl:when> + <!-- The first textobject is a reasonable fallback (but not for image in HH) --> + <xsl:when test="name($object)='textobject'"> + <xsl:text>0</xsl:text> + </xsl:when> + <!-- If there's only one object, use it --> + <xsl:when test="$count = 1 and count($olist) = 1"> + <xsl:text>1</xsl:text> + </xsl:when> + <!-- Otherwise, see if this one is a useable graphic --> + <xsl:otherwise> + <xsl:choose> + <!-- peek inside imageobjectco to simplify the test --> + <xsl:when test="local-name($object) = 'imageobjectco'"> + <xsl:call-template name="is.acceptable.mediaobject"> + <xsl:with-param name="object" select="$object/imageobject"/> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="is.acceptable.mediaobject"> + <xsl:with-param name="object" select="$object"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$useobject='1' and $object[not(*/@format='linespecific')]"> + <xsl:call-template name="write.filename.enumerate-images"> + <xsl:with-param name="filename"> + <xsl:call-template name="mediaobject.filename.enumerate-images"> + <xsl:with-param name="object" select="$object"/> + </xsl:call-template> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="select.mediaobject.enumerate-images"> + <xsl:with-param name="olist" select="$olist"/> + <xsl:with-param name="count" select="$count + 1"/> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> +</xsl:template> + +<xsl:template name="mediaobject.filename.enumerate-images"> + <xsl:param name="object"/> + + <xsl:variable name="urifilename"> + <xsl:call-template name="mediaobject.filename"> + <xsl:with-param name="object" select="$object"/> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="filename"> + <xsl:choose> + <xsl:when test="starts-with($urifilename, 'file:/')"> + <xsl:value-of select="substring-after($urifilename, 'file:/')"/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$urifilename"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:value-of select="translate($filename, '/', '\')"/> + +</xsl:template> + +<xsl:template match="text()" mode="enumerate-images"> +</xsl:template> + +<xsl:template name="write.filename.enumerate-images"> + <xsl:param name="filename"/> + <xsl:choose> + <xsl:when test="function-available('exsl:node-set') and function-available('set:distinct')"> + <filename><xsl:value-of select="$filename"/></filename> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$filename"/> + <xsl:text> +</xsl:text> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + +<!-- ==================================================================== --> + +<!-- HHC and HHK files are processed by compiler line by line + and therefore are very sensitive to whitespaces (linefeeds for sure). --> + +<xsl:template name="hhc"> + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename"> + <xsl:if test="$manifest.in.base.dir != 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + <xsl:value-of select="$htmlhelp.hhc"/> + </xsl:with-param> + <xsl:with-param name="indent" select="'no'"/> + <xsl:with-param name="content"> + <xsl:call-template name="hhc-main"/> + </xsl:with-param> + <xsl:with-param name="encoding" select="$htmlhelp.encoding"/> + </xsl:call-template> +</xsl:template> + +<xsl:template name="hhc-main"> +<HTML><xsl:text> +</xsl:text> + <HEAD/><xsl:text> +</xsl:text> + <BODY><xsl:text> +</xsl:text> + <xsl:if test="$htmlhelp.hhc.folders.instead.books != 0"> + <OBJECT type="text/site properties"><xsl:text> +</xsl:text> + <param name="ImageType" value="Folder"/><xsl:text> +</xsl:text> + </OBJECT><xsl:text> +</xsl:text> + </xsl:if> + <xsl:variable name="content"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="$profiled-nodes//*[@id=$rootid]" mode="hhc"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="$profiled-nodes" mode="hhc"/> + </xsl:otherwise> + </xsl:choose> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$htmlhelp.hhc.show.root != 0"> + <UL><xsl:text> +</xsl:text> + <xsl:copy-of select="$content"/> + </UL><xsl:text> +</xsl:text> + </xsl:when> + <xsl:otherwise> + <xsl:copy-of select="$content"/> + </xsl:otherwise> + </xsl:choose> + + </BODY> +</HTML> +</xsl:template> + +<xsl:template name="hhc.entry"> + <xsl:param name="title"> + <xsl:if test="$htmlhelp.autolabel=1"> + <xsl:variable name="label.markup"> + <xsl:apply-templates select="." mode="label.markup"/> + </xsl:variable> + <xsl:if test="normalize-space($label.markup)"> + <xsl:value-of select="concat($label.markup,$autotoc.label.separator)"/> + </xsl:if> + </xsl:if> + <xsl:apply-templates select="." mode="title.markup"/> + </xsl:param> + + <LI><OBJECT type="text/sitemap"><xsl:text> +</xsl:text> + <param name="Name"> + <xsl:attribute name="value"> + <xsl:value-of select="normalize-space($title)"/> + </xsl:attribute> + </param><xsl:text> +</xsl:text> + <param name="Local"> + <xsl:attribute name="value"> + <xsl:call-template name="href.target.with.base.dir"/> + </xsl:attribute> + </param> + </OBJECT></LI><xsl:text> +</xsl:text> +</xsl:template> + +<xsl:template match="set" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="book"> + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + <UL> + <xsl:if test="contains($toc.params, 'toc') and $htmlhelp.hhc.show.root = 0"> + <LI><OBJECT type="text/sitemap"><xsl:text> +</xsl:text> + <param name="Name"> + <xsl:attribute name="value"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'TableofContents'"/> + </xsl:call-template> + </xsl:attribute> + </param><xsl:text> +</xsl:text> + <param name="Local"> + <xsl:attribute name="value"> + <xsl:choose> + <xsl:when test="$chunk.tocs.and.lots != 0"> + <xsl:apply-templates select="." mode="recursive-chunk-filename"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + <xsl:text>-toc</xsl:text> + <xsl:value-of select="$html.ext"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="href.target.with.base.dir"/> + </xsl:otherwise> + </xsl:choose> + </xsl:attribute> + </param> + </OBJECT></LI><xsl:text> +</xsl:text> + </xsl:if> + <xsl:apply-templates select="book" mode="hhc"/> + </UL><xsl:text> +</xsl:text> + </xsl:if> +</xsl:template> + +<xsl:template match="book" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="part|reference|preface|chapter|appendix|bibliography|article|colophon|glossary"> + <xsl:variable name="toc.params"> + <xsl:call-template name="find.path.params"> + <xsl:with-param name="table" select="normalize-space($generate.toc)"/> + </xsl:call-template> + </xsl:variable> + <UL> + <xsl:if test="contains($toc.params, 'toc') and $htmlhelp.hhc.show.root = 0 and not(parent::*)"> + <LI><OBJECT type="text/sitemap"><xsl:text> +</xsl:text> + <param name="Name"> + <xsl:attribute name="value"> + <xsl:call-template name="gentext"> + <xsl:with-param name="key" select="'TableofContents'"/> + </xsl:call-template> + </xsl:attribute> + </param><xsl:text> +</xsl:text> + <param name="Local"> + <xsl:attribute name="value"> + <xsl:choose> + <xsl:when test="$chunk.tocs.and.lots != 0"> + <xsl:apply-templates select="." mode="recursive-chunk-filename"> + <xsl:with-param name="recursive" select="true()"/> + </xsl:apply-templates> + <xsl:text>-toc</xsl:text> + <xsl:value-of select="$html.ext"/> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="href.target.with.base.dir"/> + </xsl:otherwise> + </xsl:choose> + </xsl:attribute> + </param> + </OBJECT></LI><xsl:text> +</xsl:text> + </xsl:if> + <xsl:apply-templates select="part|reference|preface|chapter|bibliography|appendix|article|colophon|glossary" mode="hhc"/> + </UL><xsl:text> +</xsl:text> + </xsl:if> +</xsl:template> + +<xsl:template match="part|reference|preface|chapter|bibliography|appendix|article|glossary" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="reference|preface|chapter|appendix|refentry|section|sect1|bibliodiv"> + <UL><xsl:text> +</xsl:text> + <xsl:apply-templates select="reference|preface|chapter|appendix|refentry|section|sect1|bibliodiv" mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="section" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="section[count(ancestor::section) < $htmlhelp.hhc.section.depth]|refentry"> + <UL><xsl:text> +</xsl:text> + <xsl:apply-templates select="section|refentry" mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="sect1" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="sect2[$htmlhelp.hhc.section.depth > 1]|refentry"> + <UL><xsl:text> +</xsl:text> + <xsl:apply-templates select="sect2|refentry" mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="sect2" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="sect3[$htmlhelp.hhc.section.depth > 2]|refentry"> + <UL><xsl:text> +</xsl:text> + <xsl:apply-templates select="sect3|refentry" mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="sect3" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="sect4[$htmlhelp.hhc.section.depth > 3]|refentry"> + <UL><xsl:text> +</xsl:text> + <xsl:apply-templates select="sect4|refentry" mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="sect4" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="sect5[$htmlhelp.hhc.section.depth > 4]|refentry"> + <UL><xsl:text> +</xsl:text> + <xsl:apply-templates select="sect5|refentry" mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<xsl:template match="sect5|refentry|colophon|bibliodiv" mode="hhc"> + <xsl:if test="$htmlhelp.hhc.show.root != 0 or parent::*"> + <xsl:call-template name="hhc.entry"/> + </xsl:if> + <xsl:if test="refentry"> + <UL><xsl:text> +</xsl:text> + <xsl:apply-templates select="refentry" mode="hhc"/> + </UL> + </xsl:if> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template match="indexterm"> + <xsl:choose> + <xsl:when test="$htmlhelp.use.hhk = 0"> + + <xsl:variable name="primary" select="normalize-space(primary)"/> + <xsl:variable name="secondary" select="normalize-space(secondary)"/> + <xsl:variable name="tertiary" select="normalize-space(tertiary)"/> + + <xsl:variable name="text"> + <xsl:value-of select="$primary"/> + <xsl:if test="secondary"> + <xsl:text>, </xsl:text> + <xsl:value-of select="$secondary"/> + </xsl:if> + <xsl:if test="tertiary"> + <xsl:text>, </xsl:text> + <xsl:value-of select="$tertiary"/> + </xsl:if> + </xsl:variable> + + <xsl:if test="secondary"> + <xsl:if test="not(//indexterm[normalize-space(primary)=$primary and not(secondary)])"> + <xsl:call-template name="write.indexterm"> + <xsl:with-param name="text" select="$primary"/> + </xsl:call-template> + </xsl:if> + </xsl:if> + + <xsl:if test="tertiary"> + <xsl:if test="not(//indexterm[normalize-space(primary)=$primary and normalize-space(secondary)=$secondary and not(tertiary)])"> + <xsl:call-template name="write.indexterm"> + <xsl:with-param name="text" select="concat($primary, ', ', $secondary)"/> + </xsl:call-template> + </xsl:if> + </xsl:if> + + <xsl:call-template name="write.indexterm"> + <xsl:with-param name="text" select="$text"/> + </xsl:call-template> + + </xsl:when> + <xsl:otherwise> + <a> + <xsl:attribute name="name"> + <xsl:call-template name="object.id"/> + </xsl:attribute> + </a> + </xsl:otherwise> + + </xsl:choose> +</xsl:template> + +<xsl:template name="write.indexterm"> + <xsl:param name="text"/> + <OBJECT type="application/x-oleobject" classid="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e"> + <param name="Keyword" value="{$text}"/> + </OBJECT> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="hhk"> + <xsl:call-template name="write.chunk"> + <xsl:with-param name="filename"> + <xsl:if test="$manifest.in.base.dir != 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + <xsl:value-of select="$htmlhelp.hhk"/> + </xsl:with-param> + <xsl:with-param name="indent" select="'no'"/> + <xsl:with-param name="content"><xsl:text disable-output-escaping="yes"><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> +<HTML> +<HEAD> +<meta name="GENERATOR" content="Microsoft&reg; HTML Help Workshop 4.1"> +<!-- Sitemap 1.0 --> +</HEAD><BODY> +<OBJECT type="text/site properties"> +</OBJECT> +<UL> +</xsl:text> +<xsl:if test="($htmlhelp.use.hhk != 0) and $htmlhelp.generate.index"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="key('id',$rootid)" mode="hhk"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="hhk"/> + </xsl:otherwise> + </xsl:choose> +</xsl:if> +<xsl:text disable-output-escaping="yes"></UL> +</BODY></HTML> +</xsl:text></xsl:with-param> + <xsl:with-param name="encoding" select="$htmlhelp.encoding"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="indexterm[@class='endofrange']" mode="hhk"/> + +<xsl:template match="indexterm" mode="hhk"> + <xsl:variable name="primary" select="normalize-space(primary)"/> + <xsl:variable name="secondary" select="normalize-space(secondary)"/> + <xsl:variable name="tertiary" select="normalize-space(tertiary)"/> + + <xsl:call-template name="write.indexterm.hhk"> + <xsl:with-param name="text" select="$primary"/> + <xsl:with-param name="seealso" select="seealso"/> + </xsl:call-template> + + <xsl:if test="secondary"> + <xsl:if test="not(//indexterm[normalize-space(primary)=$primary and not(secondary)])"> + <xsl:call-template name="write.indexterm.hhk"> + <!-- We must create fake entry when there is secondary without primary --> + <xsl:with-param name="text" select="$primary"/> + <xsl:with-param name="seealso" select="$primary"/> + </xsl:call-template> + </xsl:if> + <UL> + <xsl:call-template name="write.indexterm.hhk"> + <xsl:with-param name="text" select="$secondary"/> + <xsl:with-param name="seealso" select="secondary/seealso"/> + </xsl:call-template> + <xsl:if test="tertiary"> + <UL><xsl:text> +</xsl:text> + <xsl:call-template name="write.indexterm.hhk"> + <xsl:with-param name="text" select="$tertiary"/> + <xsl:with-param name="seealso" select="tertiary/seealso"/> + </xsl:call-template> + </UL> + </xsl:if> + </UL> + </xsl:if> + +</xsl:template> + +<xsl:template name="write.indexterm.hhk"> + <xsl:param name="text"/> + <xsl:param name="seealso"/> + + <LI> <OBJECT type="text/sitemap"><xsl:text> +</xsl:text> + <param name="Name"> + <xsl:attribute name="value"> + <xsl:value-of select="$text"/> + </xsl:attribute> + </param><xsl:text> +</xsl:text> + + <xsl:if test="not(seealso)"> + <xsl:variable name="href"> + <xsl:call-template name="href.target.with.base.dir"/> + </xsl:variable> + <xsl:variable name="title"> + <xsl:call-template name="nearest.title"> + <xsl:with-param name="object" select=".."/> + </xsl:call-template> + </xsl:variable> + + <param name="Name"> + <xsl:attribute name="value"> + <xsl:value-of select="$title"/> + </xsl:attribute> + </param><xsl:text> +</xsl:text> + <param name="Local"> + <xsl:attribute name="value"> + <xsl:value-of select="$href"/> + </xsl:attribute> + </param><xsl:text> +</xsl:text> + </xsl:if> + + <xsl:if test="seealso"> + <param name="See Also"> + <xsl:attribute name="value"> + <xsl:value-of select="$seealso"/> + </xsl:attribute> + </param><xsl:text> +</xsl:text> + </xsl:if> + </OBJECT></LI> +</xsl:template> + +<xsl:template match="text()" mode="hhk"/> + +<xsl:template name="nearest.title"> + <xsl:param name="object"/> + <xsl:apply-templates select="$object/ancestor-or-self::*[title][1]" mode="title.markup"/> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="hh-map"> + <xsl:call-template name="write.text.chunk"> + <xsl:with-param name="filename"> + <xsl:if test="$manifest.in.base.dir != 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + <xsl:value-of select="$htmlhelp.map.file"/> + </xsl:with-param> + <xsl:with-param name="method" select="'text'"/> + <xsl:with-param name="content"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="key('id',$rootid)" mode="hh-map"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="hh-map"/> + </xsl:otherwise> + </xsl:choose> + </xsl:with-param> + <xsl:with-param name="encoding" select="$htmlhelp.encoding"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="processing-instruction('dbhh')" mode="hh-map"> + <xsl:variable name="topicname"> + <xsl:call-template name="pi-attribute"> + <xsl:with-param name="pis" select="."/> + <xsl:with-param name="attribute" select="'topicname'"/> + </xsl:call-template> + </xsl:variable> + <xsl:variable name="topicid"> + <xsl:call-template name="pi-attribute"> + <xsl:with-param name="pis" select="."/> + <xsl:with-param name="attribute" select="'topicid'"/> + </xsl:call-template> + </xsl:variable> + <xsl:text>#define </xsl:text> + <xsl:value-of select="$topicname"/> + <xsl:text> </xsl:text> + <xsl:value-of select="$topicid"/> + <xsl:text> +</xsl:text> +</xsl:template> + +<xsl:template match="text()" mode="hh-map"/> + +<!-- ==================================================================== --> + +<xsl:template name="hh-alias"> + <xsl:call-template name="write.text.chunk"> + <xsl:with-param name="filename"> + <xsl:if test="$manifest.in.base.dir != 0"> + <xsl:value-of select="$base.dir"/> + </xsl:if> + <xsl:value-of select="$htmlhelp.alias.file"/> + </xsl:with-param> + <xsl:with-param name="method" select="'text'"/> + <xsl:with-param name="content"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:apply-templates select="key('id',$rootid)" mode="hh-alias"/> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="hh-alias"/> + </xsl:otherwise> + </xsl:choose> + </xsl:with-param> + <xsl:with-param name="encoding" select="$htmlhelp.encoding"/> + </xsl:call-template> +</xsl:template> + +<xsl:template match="processing-instruction('dbhh')" mode="hh-alias"> + <xsl:variable name="topicname"> + <xsl:call-template name="pi-attribute"> + <xsl:with-param name="pis" select="."/> + <xsl:with-param name="attribute" select="'topicname'"/> + </xsl:call-template> + </xsl:variable> + <xsl:variable name="href"> + <xsl:call-template name="href.target.with.base.dir"> + <xsl:with-param name="object" select=".."/> + </xsl:call-template> + </xsl:variable> + <xsl:value-of select="$topicname"/> + <xsl:text>=</xsl:text> + <!-- Some versions of HH doesn't like fragment identifires, but some does. --> + <!-- <xsl:value-of select="substring-before(concat($href, '#'), '#')"/> --> + <xsl:value-of select="$href"/> + <xsl:text> +</xsl:text> +</xsl:template> + +<xsl:template match="text()" mode="hh-alias"/> + +<!-- ==================================================================== --> +<!-- This code can be used to convert any number to hexadecimal format --> + + <h:hex> + <d>0</d> + <d>1</d> + <d>2</d> + <d>3</d> + <d>4</d> + <d>5</d> + <d>6</d> + <d>7</d> + <d>8</d> + <d>9</d> + <d>A</d> + <d>B</d> + <d>C</d> + <d>D</d> + <d>E</d> + <d>F</d> + </h:hex> + + <xsl:template name="toHex"> + <xsl:param name="n" select="0"/> + <xsl:param name="digit" select="$n mod 16"/> + <xsl:param name="rest" select="floor($n div 16)"/> + <xsl:if test="$rest > 0"> + <xsl:call-template name="toHex"> + <xsl:with-param name="n" select="$rest"/> + </xsl:call-template> + </xsl:if> + <xsl:value-of select="document('')//h:hex/d[$digit+1]"/> + </xsl:template> + +<!-- ==================================================================== --> +<!-- Modification to standard HTML stylesheets --> + +<!-- There are links from ToC pane to bibliodivs, so there must be anchor --> +<xsl:template match="bibliodiv/title"> + <h3 class="{name(.)}"> + <xsl:call-template name="anchor"> + <xsl:with-param name="node" select=".."/> + <xsl:with-param name="conditional" select="0"/> + </xsl:call-template> + <xsl:apply-templates/> + </h3> +</xsl:template> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/htmlhelp/profile-htmlhelp.xsl b/src/documentation/docbook-xsl/htmlhelp/profile-htmlhelp.xsl new file mode 100644 index 0000000000..c015f6cb01 --- /dev/null +++ b/src/documentation/docbook-xsl/htmlhelp/profile-htmlhelp.xsl @@ -0,0 +1,22 @@ +<?xml version="1.0"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" + xmlns:exsl="http://exslt.org/common" + xmlns:set="http://exslt.org/sets" + version="1.0" + exclude-result-prefixes="doc exsl set"> + +<!-- ******************************************************************** + $Id: profile-htmlhelp.xsl,v 1.1 2002/06/12 13:21:54 kosek Exp $ + ******************************************************************** + + This file is used by htmlhelp.xsl if you want to generate source + files for HTML Help. It is based on the XSL DocBook Stylesheet + distribution (especially on JavaHelp code) from Norman Walsh. + + ******************************************************************** --> + +<xsl:import href="../html/chunk.xsl"/> +<xsl:include href="profile-htmlhelp-common.xsl"/> + +</xsl:stylesheet> diff --git a/src/documentation/docbook-xsl/images/blank.png b/src/documentation/docbook-xsl/images/blank.png new file mode 100644 index 0000000000..764bf4f0c3 Binary files /dev/null and b/src/documentation/docbook-xsl/images/blank.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/1.gif b/src/documentation/docbook-xsl/images/callouts/1.gif new file mode 100644 index 0000000000..0d66977193 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/1.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/1.png b/src/documentation/docbook-xsl/images/callouts/1.png new file mode 100644 index 0000000000..7d473430b7 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/1.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/10.gif b/src/documentation/docbook-xsl/images/callouts/10.gif new file mode 100644 index 0000000000..fb50b06d15 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/10.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/10.png b/src/documentation/docbook-xsl/images/callouts/10.png new file mode 100644 index 0000000000..997bbc8246 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/10.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/11.gif b/src/documentation/docbook-xsl/images/callouts/11.gif new file mode 100644 index 0000000000..9f5dba4f8d Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/11.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/11.png b/src/documentation/docbook-xsl/images/callouts/11.png new file mode 100644 index 0000000000..ce47dac3f5 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/11.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/12.gif b/src/documentation/docbook-xsl/images/callouts/12.gif new file mode 100644 index 0000000000..a373d0b4f4 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/12.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/12.png b/src/documentation/docbook-xsl/images/callouts/12.png new file mode 100644 index 0000000000..31daf4e2f2 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/12.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/13.gif b/src/documentation/docbook-xsl/images/callouts/13.gif new file mode 100644 index 0000000000..b00b1637bd Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/13.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/13.png b/src/documentation/docbook-xsl/images/callouts/13.png new file mode 100644 index 0000000000..14021a89c2 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/13.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/14.gif b/src/documentation/docbook-xsl/images/callouts/14.gif new file mode 100644 index 0000000000..6d6642ee96 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/14.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/14.png b/src/documentation/docbook-xsl/images/callouts/14.png new file mode 100644 index 0000000000..64014b75fe Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/14.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/15.gif b/src/documentation/docbook-xsl/images/callouts/15.gif new file mode 100644 index 0000000000..cdd7072d28 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/15.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/15.png b/src/documentation/docbook-xsl/images/callouts/15.png new file mode 100644 index 0000000000..0d65765fcf Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/15.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/2.gif b/src/documentation/docbook-xsl/images/callouts/2.gif new file mode 100644 index 0000000000..100ff79f01 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/2.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/2.png b/src/documentation/docbook-xsl/images/callouts/2.png new file mode 100644 index 0000000000..5d09341b2f Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/2.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/3.gif b/src/documentation/docbook-xsl/images/callouts/3.gif new file mode 100644 index 0000000000..5008ca7dbc Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/3.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/3.png b/src/documentation/docbook-xsl/images/callouts/3.png new file mode 100644 index 0000000000..ef7b700471 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/3.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/4.gif b/src/documentation/docbook-xsl/images/callouts/4.gif new file mode 100644 index 0000000000..0e5617d2f2 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/4.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/4.png b/src/documentation/docbook-xsl/images/callouts/4.png new file mode 100644 index 0000000000..adb8364eb5 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/4.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/5.gif b/src/documentation/docbook-xsl/images/callouts/5.gif new file mode 100644 index 0000000000..9bc75ada64 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/5.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/5.png b/src/documentation/docbook-xsl/images/callouts/5.png new file mode 100644 index 0000000000..4d7eb46002 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/5.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/6.gif b/src/documentation/docbook-xsl/images/callouts/6.gif new file mode 100644 index 0000000000..d396407074 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/6.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/6.png b/src/documentation/docbook-xsl/images/callouts/6.png new file mode 100644 index 0000000000..0ba694af6c Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/6.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/7.gif b/src/documentation/docbook-xsl/images/callouts/7.gif new file mode 100644 index 0000000000..c90b2f3df0 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/7.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/7.png b/src/documentation/docbook-xsl/images/callouts/7.png new file mode 100644 index 0000000000..472e96f8ac Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/7.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/8.gif b/src/documentation/docbook-xsl/images/callouts/8.gif new file mode 100644 index 0000000000..6fe3287d25 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/8.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/8.png b/src/documentation/docbook-xsl/images/callouts/8.png new file mode 100644 index 0000000000..5e60973c21 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/8.png differ diff --git a/src/documentation/docbook-xsl/images/callouts/9.gif b/src/documentation/docbook-xsl/images/callouts/9.gif new file mode 100644 index 0000000000..bc5c8125b0 Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/9.gif differ diff --git a/src/documentation/docbook-xsl/images/callouts/9.png b/src/documentation/docbook-xsl/images/callouts/9.png new file mode 100644 index 0000000000..a0676d26cc Binary files /dev/null and b/src/documentation/docbook-xsl/images/callouts/9.png differ diff --git a/src/documentation/docbook-xsl/images/caution.gif b/src/documentation/docbook-xsl/images/caution.gif new file mode 100644 index 0000000000..d9f5e5b1bc Binary files /dev/null and b/src/documentation/docbook-xsl/images/caution.gif differ diff --git a/src/documentation/docbook-xsl/images/caution.png b/src/documentation/docbook-xsl/images/caution.png new file mode 100644 index 0000000000..5b7809ca4a Binary files /dev/null and b/src/documentation/docbook-xsl/images/caution.png differ diff --git a/src/documentation/docbook-xsl/images/caution.svg b/src/documentation/docbook-xsl/images/caution.svg new file mode 100644 index 0000000000..dd84f3fe36 --- /dev/null +++ b/src/documentation/docbook-xsl/images/caution.svg @@ -0,0 +1,25 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- Generator: Adobe Illustrator 9.0, SVG Export Plug-In --> +<!DOCTYPE svg [ + <!ENTITY st0 "fill:#FFFFFF;stroke:none;"> + <!ENTITY st1 "fill:#FFFFFF;stroke-width:6.6112;stroke-linecap:round;stroke-linejoin:round;"> + <!ENTITY st2 "stroke:#FFFFFF;stroke-width:6.6112;"> + <!ENTITY st3 "fill:none;stroke:none;"> + <!ENTITY st4 "fill-rule:nonzero;clip-rule:nonzero;stroke:#000000;stroke-miterlimit:4;"> + <!ENTITY st5 "stroke:none;"> +]> +<svg width="48pt" height="48pt" viewBox="0 0 48 48" xml:space="preserve" xmlns="http://www.w3.org/2000/svg"> + <g id="Layer_x0020_3" style="&st4;"> + <g> + <path style="&st2;" d="M41.7,35.3L26.6,9.4c-0.6-1-1.7-1.7-2.9-1.6c-1.2,0-2.3,0.7-2.9,1.7L6.3,35.4c-0.6,1-0.6,2.3,0,3.3c0.6,1,1.7,1.6,2.9,1.6h29.6c1.2,0,2.3-0.6,2.9-1.7c0.6-1,0.6-2.3,0-3.3z"/> + <path style="&st1;" d="M23.7,11L9.2,37h29.6L23.7,11z"/> + <path style="&st0;" d="M23.7,11.9L10.3,36.1h27.5l-14-24.1z"/> + <g> + <path style="&st5;" d="M24.1,34c-1.1,0-1.8-0.8-1.8-1.8c0-1.1,0.7-1.8,1.8-1.8c1.1,0,1.8,0.7,1.8,1.8c0,1-0.7,1.8-1.8,1.8h0z M22.9,29.3l-0.4-9.1h3.2l-0.4,9.1h-2.3z"/> + </g> + </g> + </g> + <g id="crop_x0020_marks" style="&st4;"> + <path style="&st3;" d="M48,48H0V0h48v48z"/> + </g> +</svg> diff --git a/src/documentation/docbook-xsl/images/caution.tif b/src/documentation/docbook-xsl/images/caution.tif new file mode 100644 index 0000000000..4a282948c4 Binary files /dev/null and b/src/documentation/docbook-xsl/images/caution.tif differ diff --git a/src/documentation/docbook-xsl/images/draft.png b/src/documentation/docbook-xsl/images/draft.png new file mode 100644 index 0000000000..59673fe1cc Binary files /dev/null and b/src/documentation/docbook-xsl/images/draft.png differ diff --git a/src/documentation/docbook-xsl/images/home.gif b/src/documentation/docbook-xsl/images/home.gif new file mode 100644 index 0000000000..6784f5bb01 Binary files /dev/null and b/src/documentation/docbook-xsl/images/home.gif differ diff --git a/src/documentation/docbook-xsl/images/home.png b/src/documentation/docbook-xsl/images/home.png new file mode 100644 index 0000000000..cbb711de71 Binary files /dev/null and b/src/documentation/docbook-xsl/images/home.png differ diff --git a/src/documentation/docbook-xsl/images/home.svg b/src/documentation/docbook-xsl/images/home.svg new file mode 100644 index 0000000000..e803a3178f --- /dev/null +++ b/src/documentation/docbook-xsl/images/home.svg @@ -0,0 +1,26 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- Generator: Adobe Illustrator 9.0, SVG Export Plug-In --> +<!DOCTYPE svg [ + <!ENTITY st0 "fill-rule:nonzero;clip-rule:nonzero;fill:#FFFFFF;stroke:#000000;stroke-miterlimit:4;"> + <!ENTITY st1 "fill:none;stroke:none;"> + <!ENTITY st2 "fill:#000000;"> + <!ENTITY st3 "fill:none;stroke:#FFFFFF;stroke-width:6.3469;stroke-linejoin:round;"> + <!ENTITY st4 "fill-rule:evenodd;clip-rule:evenodd;stroke:none;"> + <!ENTITY st5 "fill-rule:nonzero;clip-rule:nonzero;stroke:#000000;stroke-miterlimit:4;"> +]> +<svg width="48pt" height="48pt" viewBox="0 0 48 48" xml:space="preserve" xmlns="http://www.w3.org/2000/svg"> + <g id="Layer_x0020_3" style="&st0;"> + <g style="&st4;"> + <path style="&st3;" d="M22.9,7.1L5.1,21.8l0,0c-0.3,0.3-0.5,0.8-0.5,1.2c0,0.2,0,0.4,0.1,0.6c0.3,0.6,0.9,1,1.6,1c0,0,1.1,0,2.2,0c0,2.4,0,14.2,0,14.2c0,1.1,0.8,1.9,1.8,1.9h27.4c1.1,0,1.9-0.9,1.9-2c0,0,0-11.8,0-14.2c1,0,2,0,2,0c0.8,0,1.4-0.5,1.7-1.2 + c0.1-0.2,0.1-0.4,0.1-0.6c0-0.5-0.2-1-0.7-1.4c0,0-3.6-3-4.5-3.7c0-1.2,0-6.9,0-6.9c0-1.2-0.8-2-2-2h-4.8c-1,0-1.7,0.6-1.9,1.5c-1.9-1.6-4.1-3.5-4.1-3.5l0.1,0.1c-0.7-0.7-1.8-0.8-2.7-0.1z"/> + <path style="&st2;" d="M22.9,7.1L5.1,21.8l0,0c-0.3,0.3-0.5,0.8-0.5,1.2c0,0.2,0,0.4,0.1,0.6c0.3,0.6,0.9,1,1.6,1c0,0,1.1,0,2.2,0c0,2.4,0,14.2,0,14.2c0,1.1,0.8,1.9,1.8,1.9h27.4c1.1,0,1.9-0.9,1.9-2c0,0,0-11.8,0-14.2c1,0,2,0,2,0c0.8,0,1.4-0.5,1.7-1.2 + c0.1-0.2,0.1-0.4,0.1-0.6c0-0.5-0.2-1-0.7-1.4c0,0-3.6-3-4.5-3.7c0-1.2,0-6.9,0-6.9c0-1.2-0.8-2-2-2h-4.8c-1,0-1.7,0.6-1.9,1.5c-1.9-1.6-4.1-3.5-4.1-3.5l0.1,0.1c-0.7-0.7-1.8-0.8-2.7-0.1z"/> + <path style="&st2;" d="M41.8,22.8l-5.1-4.2v-0.1L31,13.7v0l-6.5-5.5C24.2,8,24,8,23.8,8.2L6.2,22.9c-0.1,0.1-0.1,0.3,0.1,0.3h1.6H10h28.1h1.2h2.3c0.2,0,0.4-0.2,0.2-0.4z"/> + <path d="M35.8,16.8l0-5.1c0-0.2-0.1-0.4-0.3-0.4h-3.2c-0.2,0-0.3,0.1-0.3,0.3v2.2l3.9,2.9z"/> + <path d="M11.9,24.7V37c0,0.3,0.1,0.4,0.3,0.4h23.6c0.3,0,0.4-0.2,0.4-0.4V24.7H11.9z"/> + </g> + </g> + <g id="crop_x0020_marks" style="&st5;"> + <path style="&st1;" d="M48,48H0V0h48v48z"/> + </g> +</svg> diff --git a/src/documentation/docbook-xsl/images/important.gif b/src/documentation/docbook-xsl/images/important.gif new file mode 100644 index 0000000000..6795d9a819 Binary files /dev/null and b/src/documentation/docbook-xsl/images/important.gif differ diff --git a/src/documentation/docbook-xsl/images/important.png b/src/documentation/docbook-xsl/images/important.png new file mode 100644 index 0000000000..12c90f607a Binary files /dev/null and b/src/documentation/docbook-xsl/images/important.png differ diff --git a/src/documentation/docbook-xsl/images/important.svg b/src/documentation/docbook-xsl/images/important.svg new file mode 100644 index 0000000000..dd84f3fe36 --- /dev/null +++ b/src/documentation/docbook-xsl/images/important.svg @@ -0,0 +1,25 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- Generator: Adobe Illustrator 9.0, SVG Export Plug-In --> +<!DOCTYPE svg [ + <!ENTITY st0 "fill:#FFFFFF;stroke:none;"> + <!ENTITY st1 "fill:#FFFFFF;stroke-width:6.6112;stroke-linecap:round;stroke-linejoin:round;"> + <!ENTITY st2 "stroke:#FFFFFF;stroke-width:6.6112;"> + <!ENTITY st3 "fill:none;stroke:none;"> + <!ENTITY st4 "fill-rule:nonzero;clip-rule:nonzero;stroke:#000000;stroke-miterlimit:4;"> + <!ENTITY st5 "stroke:none;"> +]> +<svg width="48pt" height="48pt" viewBox="0 0 48 48" xml:space="preserve" xmlns="http://www.w3.org/2000/svg"> + <g id="Layer_x0020_3" style="&st4;"> + <g> + <path style="&st2;" d="M41.7,35.3L26.6,9.4c-0.6-1-1.7-1.7-2.9-1.6c-1.2,0-2.3,0.7-2.9,1.7L6.3,35.4c-0.6,1-0.6,2.3,0,3.3c0.6,1,1.7,1.6,2.9,1.6h29.6c1.2,0,2.3-0.6,2.9-1.7c0.6-1,0.6-2.3,0-3.3z"/> + <path style="&st1;" d="M23.7,11L9.2,37h29.6L23.7,11z"/> + <path style="&st0;" d="M23.7,11.9L10.3,36.1h27.5l-14-24.1z"/> + <g> + <path style="&st5;" d="M24.1,34c-1.1,0-1.8-0.8-1.8-1.8c0-1.1,0.7-1.8,1.8-1.8c1.1,0,1.8,0.7,1.8,1.8c0,1-0.7,1.8-1.8,1.8h0z M22.9,29.3l-0.4-9.1h3.2l-0.4,9.1h-2.3z"/> + </g> + </g> + </g> + <g id="crop_x0020_marks" style="&st4;"> + <path style="&st3;" d="M48,48H0V0h48v48z"/> + </g> +</svg> diff --git a/src/documentation/docbook-xsl/images/important.tif b/src/documentation/docbook-xsl/images/important.tif new file mode 100644 index 0000000000..184de63711 Binary files /dev/null and b/src/documentation/docbook-xsl/images/important.tif differ diff --git a/src/documentation/docbook-xsl/images/next.gif b/src/documentation/docbook-xsl/images/next.gif new file mode 100644 index 0000000000..aa1516e691 Binary files /dev/null and b/src/documentation/docbook-xsl/images/next.gif differ diff --git a/src/documentation/docbook-xsl/images/next.png b/src/documentation/docbook-xsl/images/next.png new file mode 100644 index 0000000000..45835bf89a Binary files /dev/null and b/src/documentation/docbook-xsl/images/next.png differ diff --git a/src/documentation/docbook-xsl/images/next.svg b/src/documentation/docbook-xsl/images/next.svg new file mode 100644 index 0000000000..75fa83ed8c --- /dev/null +++ b/src/documentation/docbook-xsl/images/next.svg @@ -0,0 +1,19 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- Generator: Adobe Illustrator 9.0, SVG Export Plug-In --> +<!DOCTYPE svg [ + <!ENTITY st0 "fill:none;stroke:none;"> + <!ENTITY st1 "fill:#FFFFFF;stroke:#FFFFFF;stroke-width:7.5901;stroke-linejoin:round;"> + <!ENTITY st2 "fill-rule:nonzero;clip-rule:nonzero;stroke:#000000;stroke-miterlimit:4;"> + <!ENTITY st3 "stroke:none;"> +]> +<svg width="48pt" height="48pt" viewBox="0 0 48 48" xml:space="preserve" xmlns="http://www.w3.org/2000/svg"> + <g id="Layer_x0020_3" style="&st2;"> + <g> + <path style="&st1;" d="M22.4,41.1c0,0.3,0.3,0.3,0.5,0.2l16.6-16.9c0.5-0.5,0.4-0.7,0-1L22.9,6.7c-0.1-0.1-0.4-0.1-0.4,0.1v10H8.9c-0.3,0-0.5,0.2-0.5,0.4l0,13.3C8.4,30.9,8.6,31,9,31h13.5l-0.1,10.1z"/> + <path style="&st3;" d="M22.4,41.1c0,0.3,0.3,0.3,0.5,0.2l16.6-16.9c0.5-0.5,0.4-0.7,0-1L22.9,6.7c-0.1-0.1-0.4-0.1-0.4,0.1v10H8.9c-0.3,0-0.5,0.2-0.5,0.4l0,13.3C8.4,30.9,8.6,31,9,31h13.5l-0.1,10.1z"/> + </g> + </g> + <g id="crop_x0020_marks" style="&st2;"> + <path style="&st0;" d="M48,48H0V0h48v48z"/> + </g> +</svg> diff --git a/src/documentation/docbook-xsl/images/note.gif b/src/documentation/docbook-xsl/images/note.gif new file mode 100644 index 0000000000..f329d359e5 Binary files /dev/null and b/src/documentation/docbook-xsl/images/note.gif differ diff --git a/src/documentation/docbook-xsl/images/note.png b/src/documentation/docbook-xsl/images/note.png new file mode 100644 index 0000000000..d0c3c645ab Binary files /dev/null and b/src/documentation/docbook-xsl/images/note.png differ diff --git a/src/documentation/docbook-xsl/images/note.svg b/src/documentation/docbook-xsl/images/note.svg new file mode 100644 index 0000000000..648299d26f --- /dev/null +++ b/src/documentation/docbook-xsl/images/note.svg @@ -0,0 +1,33 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- Generator: Adobe Illustrator 9.0, SVG Export Plug-In --> +<!DOCTYPE svg [ + <!ENTITY st0 "fill:none;stroke:#FFFFFF;stroke-width:12.1438;stroke-linejoin:round;"> + <!ENTITY st1 "fill:none;stroke-width:1.2429;"> + <!ENTITY st2 "fill:#FFFFFF;stroke:none;"> + <!ENTITY st3 "fill:none;stroke:#FFFFFF;stroke-width:12.7649;stroke-linejoin:round;"> + <!ENTITY st4 "fill:#FFFFFF;stroke-width:6.3824;stroke-linejoin:round;"> + <!ENTITY st5 "fill:none;stroke:none;"> + <!ENTITY st6 "fill-rule:nonzero;clip-rule:nonzero;stroke:#000000;stroke-miterlimit:4;"> + <!ENTITY st7 "fill:#FFFFFF;stroke:#FFFFFF;stroke-width:12.7649;stroke-linejoin:round;"> + <!ENTITY st8 "stroke:none;"> + <!ENTITY st9 "fill:none;stroke-width:4.9715;stroke-linejoin:round;"> +]> +<svg xmlns="http://www.w3.org/2000/svg" width="48pt" height="48pt" viewBox="0 0 48 48" xml:space="preserve"> + <g id="Layer_x0020_1" style="&st6;"> + <path style="&st0;" d="M35.7,19.8v18.9H11V8.8h13.9l10.8,11z"/> + <path style="&st3;" d="M38.7,30.4L25,16.7l-7.7-3l2.7,8.7l13.3,13.4l5.4-5.4z"/> + <path style="&st7;" d="M35.7,8.8H11v29.9h24.7V8.8z"/> + <path style="&st4;" d="M35.7,8.8H11v29.9h24.7V8.8z"/> + <path style="&st2;" d="M35.7,8.8H11v29.9h24.7V8.8z"/> + </g> + <g id="Layer_x0020_4" style="&st6;"> + <path style="&st9;" d="M38.7,30.4L25,16.7l-7.7-3l2.7,8.7l13.3,13.4l5.4-5.4z"/> + <path style="&st8;" d="M38.7,30.4L25,16.7l-7.7-3l2.7,8.7l13.3,13.4l5.4-5.4z"/> + <path style="&st8;" d="M20.6,14.7l-2.5,2.5L17,13.4l3.6,1.3z"/> + <path style="&st1;" d="M19.6,22.2l3-0.3l2.4-2.4l0.4-2.8"/> + <path style="&st2;" d="M20.4,14.9L18.3,17l1.6,5.2l2.7-0.3l2.4-2.4l0.3-2.4l-5-2.2z"/> + </g> + <g id="crop" style="&st6;"> + <path style="&st5;" d="M48,48H0V0h48v48z"/> + </g> +</svg> diff --git a/src/documentation/docbook-xsl/images/note.tif b/src/documentation/docbook-xsl/images/note.tif new file mode 100644 index 0000000000..08644d6b5d Binary files /dev/null and b/src/documentation/docbook-xsl/images/note.tif differ diff --git a/src/documentation/docbook-xsl/images/prev.gif b/src/documentation/docbook-xsl/images/prev.gif new file mode 100644 index 0000000000..64ca8f3c7c Binary files /dev/null and b/src/documentation/docbook-xsl/images/prev.gif differ diff --git a/src/documentation/docbook-xsl/images/prev.png b/src/documentation/docbook-xsl/images/prev.png new file mode 100644 index 0000000000..cf24654f8a Binary files /dev/null and b/src/documentation/docbook-xsl/images/prev.png differ diff --git a/src/documentation/docbook-xsl/images/prev.svg b/src/documentation/docbook-xsl/images/prev.svg new file mode 100644 index 0000000000..6d88ffdd0d --- /dev/null +++ b/src/documentation/docbook-xsl/images/prev.svg @@ -0,0 +1,19 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- Generator: Adobe Illustrator 9.0, SVG Export Plug-In --> +<!DOCTYPE svg [ + <!ENTITY st0 "fill:none;stroke:none;"> + <!ENTITY st1 "fill:#FFFFFF;stroke:#FFFFFF;stroke-width:7.5901;stroke-linejoin:round;"> + <!ENTITY st2 "fill-rule:nonzero;clip-rule:nonzero;stroke:#000000;stroke-miterlimit:4;"> + <!ENTITY st3 "stroke:none;"> +]> +<svg width="48pt" height="48pt" viewBox="0 0 48 48" xml:space="preserve" xmlns="http://www.w3.org/2000/svg"> + <g id="Layer_x0020_3" style="&st2;"> + <g> + <path style="&st1;" d="M25.6,6.9c0-0.3-0.3-0.3-0.5-0.2L8.4,23.6c-0.5,0.5-0.4,0.7,0,1l16.6,16.6c0.1,0.1,0.4,0.1,0.4-0.1v-10h13.6c0.3,0,0.5-0.2,0.5-0.4l0-13.3c0-0.3-0.2-0.5-0.5-0.5H25.5l0.1-10.1z"/> + <path style="&st3;" d="M25.6,6.9c0-0.3-0.3-0.3-0.5-0.2L8.4,23.6c-0.5,0.5-0.4,0.7,0,1l16.6,16.6c0.1,0.1,0.4,0.1,0.4-0.1v-10h13.6c0.3,0,0.5-0.2,0.5-0.4l0-13.3c0-0.3-0.2-0.5-0.5-0.5H25.5l0.1-10.1z"/> + </g> + </g> + <g id="crop_x0020_marks" style="&st2;"> + <path style="&st0;" d="M48,48H0V0h48v48z"/> + </g> +</svg> diff --git a/src/documentation/docbook-xsl/images/tip.gif b/src/documentation/docbook-xsl/images/tip.gif new file mode 100644 index 0000000000..823f2b417c Binary files /dev/null and b/src/documentation/docbook-xsl/images/tip.gif differ diff --git a/src/documentation/docbook-xsl/images/tip.png b/src/documentation/docbook-xsl/images/tip.png new file mode 100644 index 0000000000..5c4aab3bb3 Binary files /dev/null and b/src/documentation/docbook-xsl/images/tip.png differ diff --git a/src/documentation/docbook-xsl/images/tip.svg b/src/documentation/docbook-xsl/images/tip.svg new file mode 100644 index 0000000000..4a64a1500e --- /dev/null +++ b/src/documentation/docbook-xsl/images/tip.svg @@ -0,0 +1,31 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- Generator: Adobe Illustrator 9.0, SVG Export Plug-In --> +<!DOCTYPE svg [ + <!ENTITY st0 "fill:none;stroke:#000000;stroke-width:1.0944;"> + <!ENTITY st1 "fill:#FFFFFF;stroke:none;"> + <!ENTITY st2 "fill-rule:nonzero;clip-rule:nonzero;stroke:#FFFFFF;stroke-width:5.6139;stroke-miterlimit:4;"> + <!ENTITY st3 "fill:none;stroke:none;"> + <!ENTITY st4 "fill-rule:nonzero;clip-rule:nonzero;stroke:#000000;stroke-miterlimit:4;"> + <!ENTITY st5 "stroke:none;"> +]> +<svg width="48pt" height="48pt" viewBox="0 0 48 48" xml:space="preserve" xmlns="http://www.w3.org/2000/svg"> + <g id="Layer_x0020_3" style="&st2;"> + <g> + <path d="M9.5,18.6c0,8,6.5,14.4,14.4,14.4c8,0,14.4-6.5,14.4-14.4c0-8-6.5-14.4-14.4-14.4c-8,0-14.4,6.5-14.4,14.4z M12.8,18.6c0-6.2,5-11.2,11.2-11.2c6.2,0,11.2,5,11.2,11.2c0,6.2-5,11.2-11.2,11.2c-6.2,0-11.2-5-11.2-11.2z"/> + <path d="M28.1,37.9l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8c0.1,0.9,0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8c-0.1-0.9-0.9-1.5-1.8-1.4z"/> + <path d="M28.1,34.8l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8c0.1,0.9,0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8c-0.1-0.9-0.9-1.5-1.8-1.4z"/> + <path d="M28.1,31.6l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8s0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8s-0.9-1.5-1.8-1.4z"/> + <path d="M23.1,41.3v0.9c0,0.9,0.7,1.6,1.6,1.6c0.9,0,1.6-0.7,1.6-1.6v-0.9h-3.3z"/> + <path style="&st1;" d="M35.9,18.7c0,6.6-5.4,12-12,12c-6.6,0-12-5.4-12-12s5.4-12,12-12c6.6,0,12,5.4,12,12z"/> + <path style="&st5;" d="M9.6,18.6c0,8,6.5,14.4,14.4,14.4c8,0,14.4-6.5,14.4-14.4c0-8-6.5-14.4-14.4-14.4c-8,0-14.4,6.5-14.4,14.4z M12.9,18.6c0-6.2,5-11.2,11.2-11.2c6.2,0,11.2,5,11.2,11.2c0,6.2-5,11.2-11.2,11.2c-6.2,0-11.2-5-11.2-11.2z"/> + <path style="&st5;" d="M28.2,37.9l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8c0.1,0.9,0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8c-0.1-0.9-0.9-1.5-1.8-1.4z"/> + <path style="&st5;" d="M28.2,34.7l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8c0.1,0.9,0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8c-0.1-0.9-0.9-1.5-1.8-1.4z"/> + <path style="&st5;" d="M28.2,31.6l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8c0.1,0.9,0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8c-0.1-0.9-0.9-1.5-1.8-1.4z"/> + <path style="&st5;" d="M23.1,41.3v0.9c0,0.9,0.7,1.6,1.6,1.6s1.6-0.7,1.6-1.6v-0.9h-3.3z"/> + <path style="&st0;" d="M22.3,28.3l-3.5-10.7c0,0,6.6,3.9,10.5,0"/> + </g> + </g> + <g id="crop_x0020_marks" style="&st4;"> + <path style="&st3;" d="M48,48H0V0h48v48z"/> + </g> +</svg> diff --git a/src/documentation/docbook-xsl/images/tip.tif b/src/documentation/docbook-xsl/images/tip.tif new file mode 100644 index 0000000000..4a3d8c75fd Binary files /dev/null and b/src/documentation/docbook-xsl/images/tip.tif differ diff --git a/src/documentation/docbook-xsl/images/toc-blank.png b/src/documentation/docbook-xsl/images/toc-blank.png new file mode 100644 index 0000000000..6ffad17a0c Binary files /dev/null and b/src/documentation/docbook-xsl/images/toc-blank.png differ diff --git a/src/documentation/docbook-xsl/images/toc-minus.png b/src/documentation/docbook-xsl/images/toc-minus.png new file mode 100644 index 0000000000..abbb020c8e Binary files /dev/null and b/src/documentation/docbook-xsl/images/toc-minus.png differ diff --git a/src/documentation/docbook-xsl/images/toc-plus.png b/src/documentation/docbook-xsl/images/toc-plus.png new file mode 100644 index 0000000000..941312ce0d Binary files /dev/null and b/src/documentation/docbook-xsl/images/toc-plus.png differ diff --git a/src/documentation/docbook-xsl/images/up.gif b/src/documentation/docbook-xsl/images/up.gif new file mode 100644 index 0000000000..aabc2d0165 Binary files /dev/null and b/src/documentation/docbook-xsl/images/up.gif differ diff --git a/src/documentation/docbook-xsl/images/up.png b/src/documentation/docbook-xsl/images/up.png new file mode 100644 index 0000000000..07634de26b Binary files /dev/null and b/src/documentation/docbook-xsl/images/up.png differ diff --git a/src/documentation/docbook-xsl/images/up.svg b/src/documentation/docbook-xsl/images/up.svg new file mode 100644 index 0000000000..d31aa9c809 --- /dev/null +++ b/src/documentation/docbook-xsl/images/up.svg @@ -0,0 +1,19 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- Generator: Adobe Illustrator 9.0, SVG Export Plug-In --> +<!DOCTYPE svg [ + <!ENTITY st0 "fill:none;stroke:none;"> + <!ENTITY st1 "fill:#FFFFFF;stroke:#FFFFFF;stroke-width:7.5901;stroke-linejoin:round;"> + <!ENTITY st2 "fill-rule:nonzero;clip-rule:nonzero;stroke:#000000;stroke-miterlimit:4;"> + <!ENTITY st3 "stroke:none;"> +]> +<svg width="48pt" height="48pt" viewBox="0 0 48 48" xml:space="preserve" xmlns="http://www.w3.org/2000/svg"> + <g id="Layer_x0020_3" style="&st2;"> + <g> + <path style="&st1;" d="M41.1,25.6c0.3,0,0.3-0.3,0.2-0.5L24.4,8.4c-0.5-0.5-0.7-0.4-1,0L6.7,25.1c-0.1,0.1-0.1,0.4,0.1,0.4h10v13.6c0,0.3,0.2,0.5,0.4,0.5l13.3,0c0.3,0,0.5-0.2,0.5-0.5V25.5l10.1,0.1z"/> + <path style="&st3;" d="M41.1,25.6c0.3,0,0.3-0.3,0.2-0.5L24.4,8.4c-0.5-0.5-0.7-0.4-1,0L6.7,25.1c-0.1,0.1-0.1,0.4,0.1,0.4h10v13.6c0,0.3,0.2,0.5,0.4,0.5l13.3,0c0.3,0,0.5-0.2,0.5-0.5V25.5l10.1,0.1z"/> + </g> + </g> + <g id="crop_x0020_marks" style="&st2;"> + <path style="&st0;" d="M48,48H0V0h48v48z"/> + </g> +</svg> diff --git a/src/documentation/docbook-xsl/images/warning.gif b/src/documentation/docbook-xsl/images/warning.gif new file mode 100644 index 0000000000..3adf191293 Binary files /dev/null and b/src/documentation/docbook-xsl/images/warning.gif differ diff --git a/src/documentation/docbook-xsl/images/warning.png b/src/documentation/docbook-xsl/images/warning.png new file mode 100644 index 0000000000..1c33db8f34 Binary files /dev/null and b/src/documentation/docbook-xsl/images/warning.png differ diff --git a/src/documentation/docbook-xsl/images/warning.svg b/src/documentation/docbook-xsl/images/warning.svg new file mode 100644 index 0000000000..fc8d7484cb --- /dev/null +++ b/src/documentation/docbook-xsl/images/warning.svg @@ -0,0 +1,23 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- Generator: Adobe Illustrator 9.0, SVG Export Plug-In --> +<!DOCTYPE svg [ + <!ENTITY st0 "fill:#000000;stroke:#FFFFFF;stroke-width:7.9139;stroke-linejoin:round;"> + <!ENTITY st1 "fill-rule:nonzero;clip-rule:nonzero;fill:#FFFFFF;stroke:#000000;stroke-miterlimit:4;"> + <!ENTITY st2 "fill:none;stroke:none;"> + <!ENTITY st3 "fill:#000000;"> + <!ENTITY st4 "fill-rule:evenodd;clip-rule:evenodd;stroke:none;"> + <!ENTITY st5 "fill-rule:nonzero;clip-rule:nonzero;stroke:#000000;stroke-miterlimit:4;"> +]> +<svg width="48pt" height="48pt" viewBox="0 0 48 48" xml:space="preserve" xmlns="http://www.w3.org/2000/svg"> + <g id="Layer_x0020_4" style="&st1;"> + <g style="&st4;"> + <path style="&st0;" d="M16.4,42.3L5.7,31.6V16.4L16.4,5.7h15.2l10.7,10.7v15.2L31.6,42.3H16.4z"/> + <path style="&st3;" d="M16.4,42.3L5.7,31.6V16.4L16.4,5.7h15.2l10.7,10.7v15.2L31.6,42.3H16.4z"/> + <path d="M11.7,17.7l18.7,18.7l5.9-5.9L17.6,11.7l-5.9,5.9z"/> + <path d="M11.7,30.5l5.9,5.9l18.7-18.7l-5.9-5.9L11.7,30.5z"/> + </g> + </g> + <g id="crop_x0020_marks" style="&st5;"> + <path style="&st2;" d="M48,48H0V0h48v48z"/> + </g> +</svg> diff --git a/src/documentation/docbook-xsl/images/warning.tif b/src/documentation/docbook-xsl/images/warning.tif new file mode 100644 index 0000000000..7b6611ec7a Binary files /dev/null and b/src/documentation/docbook-xsl/images/warning.tif differ diff --git a/src/documentation/docbook-xsl/install.sh b/src/documentation/docbook-xsl/install.sh new file mode 100755 index 0000000000..0b148675f3 --- /dev/null +++ b/src/documentation/docbook-xsl/install.sh @@ -0,0 +1,918 @@ +#!/bin/bash +# $Id: install.sh,v 1.15 2006/04/13 15:19:51 xmldoc Exp $ +# $Source: /cvsroot/docbook/releasetools/install.sh,v $ # + +# install.sh - Set up catalogs & locating rules for a XML/XSLT distribution + +# This is as a interactive installer for updating a single-user +# environment to make use of XML catalog and schema "locating +# rules" data provided in an XML/XSLT distribution. +# +# Although this installer was created for the DocBook project, it +# is a general-purpose tool that can be used with any XML/XSLT +# distribution that provides XML/SGML catalogs and locating rules. +# +# It is mainly intended to make things easier for users who want +# to install a particular XML/XSLT distribution that has not (yet) +# been packaged for their OS distro (Debian, Fedora, whatever). +# +# It works by updating the user's shell startup files (e.g., +# .bashrc and .cshrc) and .emacs file and by finding or creating a +# writable CatalogManager.properties file to update. +# +# It makes backup copies of any files it touches, and also +# generates a uninstall.sh script for reverting its changes. +# +# In the same directory where it is located, it expects to find +# four files (below). And if it is unable to locate a +# CatalogManager.properties file in the user environment, it +# expects to find an "example" one in the same directory, which it +# copies over to the user's ~/.resolver directory. + +mydir=$(readlink -f $(dirname $0)) +thisLocatingRules=$mydir/locatingrules.xml +thisXmlCatalog=$mydir/catalog.xml +thisSgmlCatalog=$mydir/catalog +# .urilist file contains a list of pairs of local pathnames and +# URIs to test for catalog resolution +thisUriList=$mydir/.urilist + +exampleCatalogManager=$mydir/.CatalogManager.properties.example +thisCatalogManager=$HOME/.resolver/CatalogManager.properties + +emit_message() { + echo $1 1>&2 +} + +if [ ! "${*#--batch}" = "$*" ]; then + batchmode="Yes"; +else + batchmode="No"; + emit_message + if [ ! "$1" = "--test" ]; then + emit_message "NOTE: For non-interactive installs/uninstalls, use --batch" + if [ ! "$1" = "--uninstall" ]; then + emit_message + fi + fi +fi + +osName=$(uname -o) +classPathSeparator=":" +if [ "$osName" = "Cygwin" ]; then + thisJavaXmlCatalog=$(cygpath -m $thisXmlCatalog) + classPathSeparator=";" +else + thisJavaXmlCatalog=$thisXmlCatalog +fi + +main() { + removeOldFiles + checkRoot + updateCatalogManager + checkForResolver + writeDotFiles + updateUserStartupFiles + updateUserDotEmacs + writeUninstallFile + writeTestFile + printExitMessage +} + +removeOldFiles() { + rm -f $mydir/.profile.incl + rm -f $mydir/.cshrc.incl + rm -f $mydir/.emacs.el +} + +checkRoot() { + if [ $(id -u) == "0" ]; then + cat 1>&2 <<EOF + +WARNING: This install script is meant to be run as a non-root + user, but you are running it as root. + +EOF + read -s -n1 -p "Are you sure you want to continue? [No] " + emit_message "$REPLY" + case $REPLY in + [yY]) + emit_message + ;; + *) emit_message "OK, exiting without making changes." + exit + ;; + esac + fi + return 0 +} + +updateCatalogManager() { + + # - finds or creates a writable CatalogManager.properties file + # + # - adds the catalog.xml file for this distribution to the + # CatalogManager.properties file found + + if [ -z "$CLASSPATH" ]; then + cat 1>&2 <<EOF + +NOTE: There is no CLASSPATH variable set in your environment. + No attempt was made to find a CatalogManager.properties + file. Using $thisCatalogManager instead +EOF + else + # split CLASSPATH in a list of pathnames by replacing all separator + # characters with spaces + if [ "$osName" = "Cygwin" ]; then + pathnames=$(echo $CLASSPATH | tr ";" " ") + else + pathnames=$(echo $CLASSPATH | tr ":" " ") + fi + for path in $pathnames; do + if [ "$osName" = "Cygwin" ]; then + path=$(cygpath -u $path) + fi + # strip out trailing slash from pathname + path=$(echo $path | sed 's/\/$//') + # find CatalogManager.properties file + if [ -f $path/CatalogManager.properties ]; + then + existingCatalogManager=$path/CatalogManager.properties + break + fi + done + fi + # end of CLASSPATH check + + if [ -w "$existingCatalogManager" ]; then + # existing CatalogManager.properties was found and it is + # writable, so use it + myCatalogManager=$existingCatalogManager + else + if [ -f "$existingCatalogManager" ]; then + # a non-writable CatalogManager.properties exists, so emit a + # note saying that it won't be used + cat 1>&2 <<EOF +NOTE: $existingCatalogManager file found, + but you don't have permission to write to it. + Will instead use $thisCatalogManager +EOF + else + # CLASSPATH is set, but no CatalogManager.properties found + if [ -n "$CLASSPATH" ]; then + cat 1>&2 <<EOF +NOTE: No CatalogManager.properties found from CLASSPATH. + Will instead use $thisCatalogManager +EOF + fi + fi + if [ "$batchmode" = "Yes" ]; then + emit_message + fi + # end of check for existing writable CatalogManager.properties + + if [ -f $thisCatalogManager ]; then + myCatalogManager=$thisCatalogManager + else + REPLY="" + if [ ! "$batchmode" = "Yes" ]; then + emit_message + read -s -n1 -p "Create $thisCatalogManager file? [Yes] " + emit_message "$REPLY" + emit_message + fi + case $REPLY in + [nNqQ]) + emitNoChangeMsg + ;; + *) + if [ ! -d "${thisCatalogManager%/*}" ]; then + mkdir -p ${thisCatalogManager%/*} + fi + cp $mydir/.CatalogManager.properties.example $thisCatalogManager || exit 1 + emit_message "NOTE: $thisCatalogManager file created" + myCatalogManager=$thisCatalogManager + ;; + esac + # end of creating "private" CatalogManager.properties + fi + # end of check for "private" CatalogManager.properties + fi + # end of check finding/creating writable CatalogManager.properties + + if [ -n "$myCatalogManager" ]; then + etcXmlCatalog= + catalogsLine=$(grep "^catalogs=" $myCatalogManager) + if [ -f /etc/xml/catalog ] && [ "$osName" != "Cygwin" ] \ + && [ "${catalogsLine#*/etc/xml/catalog*}" = "$catalogsLine" ]; then + cat 1>&2 <<EOF + +WARNING: /etc/xml/catalog exists but was not found in the + $myCatalogManager file. If the + /etc/xml/catalog file has content, you probably should reference + it in your $myCatalogManager + file. This installer can automatically add it for you, + but BE WARNED that once it has been added, the uninstaller + for this distribution CANNOT REMOVE IT automatically + during uninstall. If you no longer want it included, you + will need to remove it manually. + +EOF + REPLY="" + if [ ! "$batchmode" = "Yes" ]; then + read -s -n1 -p "Add /etc/xml/catalog to $myCatalogManager? [Yes] " + emit_message "$REPLY" + fi + case $REPLY in + [nNqQ]) + emit_message + ;; + *) + etcXmlCatalog=/etc/xml/catalog + ;; + esac + fi + + catalogBackup="$myCatalogManager.$$.bak" + if [ ! -w "${myCatalogManager%/*}" ]; then + emit_message + emit_message "WARNING: ${myCatalogManager%/*} directory is not writable." + emit_message + emitNoChangeMsg + else + REPLY="" + if [ ! "$batchmode" = "Yes" ]; then + emit_message + emit_message "Add $thisJavaXmlCatalog" + read -s -n1 -p "to $myCatalogManager file? [Yes] " + emit_message "$REPLY" + emit_message + fi + case $REPLY in + [nNqQ]) + emitNoChangeMsg + ;; + *) + if [ "$catalogsLine" ] ; then + if [ "${catalogsLine#*$thisJavaXmlCatalog*}" != "$catalogsLine" ]; then + emit_message "NOTE: $thisJavaXmlCatalog already" + emit_message " in $myCatalogManager" + else + mv $myCatalogManager $catalogBackup || exit 1 + sed "s#^catalogs=\(.*\)\$#catalogs=$thisJavaXmlCatalog;\1;$etcXmlCatalog#" $catalogBackup \ + | sed 's/;\+/;/' | sed 's/;$//' > $myCatalogManager || exit 1 + emit_message "NOTE: $myCatalogManager file successfully updated." + emit_message " Backup written to $catalogBackup" + fi + else + mv $myCatalogManager $catalogBackup || exit 1 + cp $catalogBackup $myCatalogManager + echo "catalogs=$thisJavaXmlCatalog;$etcXmlCatalog" \ + | sed 's/;\+/;/' | sed 's/;$//' >> $myCatalogManager || exit 1 + emit_message "NOTE: \"catalogs=\" line added to $myCatalogManager." + emit_message " Backup written to $catalogBackup" + fi + ;; + esac + # end of backing up and updating CatalogManager.properties + fi + fi + # end of CatalogManager.properties updates + + if [ "$osName" = "Cygwin" ]; then + myCatalogManager=$(cygpath -m $myCatalogManager) + fi + return 0 +} + +writeDotFiles() { + while read; do + echo "$REPLY" >> $mydir/.profile.incl + done <<EOF +if [ -z "\$XML_CATALOG_FILES" ]; then + XML_CATALOG_FILES="$thisXmlCatalog" +else + # $thisXmlCatalog is not in XML_CATALOG_FILES, so add it + if [ "\${XML_CATALOG_FILES#*$thisXmlCatalog*}" = "\$XML_CATALOG_FILES" ]; then + XML_CATALOG_FILES="$thisXmlCatalog \$XML_CATALOG_FILES" + fi +fi +# /etc/xml/catalog exists but is not in XML_CATALOG_FILES, so add it +if [ -f /etc/xml/catalog ] && \ + [ "\${XML_CATALOG_FILES#*/etc/xml/catalog*}" = "\$XML_CATALOG_FILES" ]; then + XML_CATALOG_FILES="\$XML_CATALOG_FILES /etc/xml/catalog" +fi +export XML_CATALOG_FILES + +if [ -z "\$SGML_CATALOG_FILES" ]; then + SGML_CATALOG_FILES="$thisSgmlCatalog" +else + # $thisSgmlCatalog is not in SGML_CATALOG_FILES, so add it + if [ "\${SGML_CATALOG_FILES#*$thisSgmlCatalog}" = "\$SGML_CATALOG_FILES" ]; then + SGML_CATALOG_FILES="$thisSgmlCatalog:\$SGML_CATALOG_FILES" + fi +fi +# /etc/sgml/catalog exists but is not in SGML_CATALOG_FILES, so add it +if [ -f /etc/sgml/catalog ] && \ + [ "\${SGML_CATALOG_FILES#*/etc/sgml/catalog*}" = "\$SGML_CATALOG_FILES" ]; then + SGML_CATALOG_FILES="\$SGML_CATALOG_FILES:/etc/sgml/catalog" +fi +export SGML_CATALOG_FILES +EOF + +while read; do + echo "$REPLY" >> $mydir/.cshrc.incl +done <<EOF +if ( ! $\?XML_CATALOG_FILES ) then + setenv XML_CATALOG_FILES "$thisXmlCatalog" +# $thisXmlCatalog is not in XML_CATALOG_FILES, so add it +else if ( "\\\`echo \$XML_CATALOG_FILES | grep -v $thisXmlCatalog\\\`" != "" ) then + setenv XML_CATALOG_FILES "$thisXmlCatalog \$XML_CATALOG_FILES" +endif +endif +# /etc/xml/catalog exists but is not in XML_CATALOG_FILES, so add it +if ( -f /etc/xml/catalog && "\\\`echo \$XML_CATALOG_FILES | grep -v /etc/xml/catalog\\\`" != "" ) then + setenv XML_CATALOG_FILES "\$XML_CATALOG_FILES /etc/xml/catalog" +endif + +endif +if ( ! $\?SGML_CATALOG_FILES ) then + setenv SGML_CATALOG_FILES "$thisSgmlCatalog" +else if ( "\\\`echo \$SGML_CATALOG_FILES | grep -v $thisSgmlCatalog\\\`" != "" ) then + setenv SGML_CATALOG_FILES "$thisSgmlCatalog \$SGML_CATALOG_FILES" +endif +endif +# /etc/SGML/catalog exists but is not in SGML_CATALOG_FILES, so add it +if ( -f /etc/sgml/catalog && "\\\`echo \$SGML_CATALOG_FILES | grep -v /etc/sgml/catalog\\\`" != "" ) then + setenv SGML_CATALOG_FILES "\$SGML_CATALOG_FILES /etc/sgml/catalog" +endif +EOF + +if [ -n "$myCatalogManager" ]; then + myCatalogManagerDir=${myCatalogManager%/*} + while read; do + echo "$REPLY" >> $mydir/.profile.incl + done <<EOF + + +if [ -z "\$CLASSPATH" ]; then + CLASSPATH="$myCatalogManagerDir" +else + # $myCatalogManagerDir is not in CLASSPATH, so add it + if [ "\${CLASSPATH#*$myCatalogManagerDir*}" = "\$CLASSPATH" ]; then + CLASSPATH="$myCatalogManagerDir$classPathSeparator\$CLASSPATH" + fi +fi +export CLASSPATH +EOF + + while read; do + echo "$REPLY" >> $mydir/.cshrc.incl + done <<EOF + + +if ( ! $\?CLASSPATH ) then + setenv CLASSPATH "$myCatalogManagerDir" +# $myCatalogManagerDir is not in CLASSPATH, so add it +else if ( "\\\`echo \$CLASSPATH | grep -v $myCatalogManagerDir\\\`" != "" ) then + setenv CLASSPATH "$myCatalogManagerDir$classPathSeparator\$CLASSPATH" +endif +endif +EOF + +fi + +while read; do + echo "$REPLY" >> $mydir/.emacs.el +done <<EOF +(add-hook + 'nxml-mode-hook + (lambda () + (setq rng-schema-locating-files-default + (append '("$thisLocatingRules") + rng-schema-locating-files-default )))) +EOF + +return 0 +} + +updateUserStartupFiles() { + if [ ! "$batchmode" = "Yes" ]; then + cat 1>&2 <<EOF + +NOTE: To source your environment correctly for using the catalog + files in this distribution, you need to update one or more + of your shell startup files. This installer can + automatically make the necessary changes. Or, if you prefer, + you can make the changes manually. + +EOF + else + emit_message + fi + + # if user is running csh or tcsh, target .cshrc and .tcshrc + # files for update; otherwise, target .bash_* and .profiles + + parent=$(ps $PPID | grep "/") + if [ "${parent#*csh}" != "$parent" ] || [ "${parent#*tcsh}" != "$parent" ]; then + myStartupFiles=".cshrc .tcshrc" + appendLine="source $mydir/.cshrc.incl" + else + myStartupFiles=".bash_profile .bash_login .profile .bashrc" + appendLine=". $mydir/.profile.incl" + fi + + for file in $myStartupFiles; do + if [ -f "$HOME/$file" ]; then + dotFileBackup=$HOME/$file.$$.bak + REPLY="" + if [ ! "$batchmode" = "Yes" ]; then + read -s -n1 -p "Update $HOME/$file? [Yes] " + emit_message "$REPLY" + fi + case $REPLY in + [nNqQ]) + cat 1>&2 <<EOF + +NOTE: No change made to $HOME/$file. You either need + to add the following line to it, or manually source + the shell environment for this distribution each + time you want use it. + +$appendLine + +EOF + ;; + *) + lineExists="$(grep "$appendLine" $HOME/$file )" + if [ ! "$lineExists" ]; then + mv $HOME/$file $dotFileBackup || exit 1 + cp $dotFileBackup $HOME/$file || exit 1 + echo "$appendLine" >> $HOME/$file || exit 1 + cat 1>&2 <<EOF +NOTE: $HOME/$file file successfully updated. + Backup written to $dotFileBackup + +EOF + else + cat 1>&2 <<EOF +NOTE: $HOME/$file already contains information for this distribution. + $HOME/$file not updated. + +EOF + fi + ;; + esac + fi + done + if [ -z "$dotFileBackup" ]; then + if [ ! "$batchmode" = "Yes" ]; then + emit_message + fi + cat 1>&2 <<EOF +NOTE: No shell startup files updated. You can source the + environment for this distribution manually, each time you + want to use it, by typing the following. + +$appendLine + +EOF + fi +} + +updateUserDotEmacs() { + if [ -f $thisLocatingRules ]; then + cat 1>&2 <<EOF + +NOTE: This distribution includes a "schema locating rules" file + for Emacs/nXML. To use it, you should update either your + .emacs or .emacs.el file. This installer can automatically + make the necessary changes. Or, if you prefer, you can make + the changes manually. + +EOF + + emacsAppendLine="(load-file \"$mydir/.emacs.el\")" + myEmacsFile= + for file in .emacs .emacs.el; do + if [ -f "$HOME/$file" ]; then + myEmacsFile=$HOME/$file + break + fi + done + if [ ! -f "$myEmacsFile" ]; then + REPLY="" + if [ ! "$batchmode" = "Yes" ]; then + read -s -n1 -p "No .emacs or .emacs.el file. Create one? [No] " + emit_message "$REPLY" + emit_message + fi + case $REPLY in + [yY]) + myEmacsFile=$HOME/.emacs + touch $myEmacsFile + ;; + *) + cat 1>&2 <<EOF +NOTE: No Emacs changes made. To use this distribution with, + Emacs/nXML, you can create a .emacs file and manually add + the following line to it, or you can run it as a command + within Emacs. + +$emacsAppendLine + +EOF + ;; + esac + fi + if [ -n "$myEmacsFile" ]; then + REPLY="" + if [ ! "$batchmode" = "Yes" ]; then + read -s -n1 -p "Update $myEmacsFile? [Yes] " + emit_message "$REPLY" + emit_message + fi + case $REPLY in + [nNqQ]) + cat 1>&2 <<EOF + +NOTE: No change made to $myEmacsFile. To use this distribution + with Emacs/nXML, you can manually add the following line + to your $myEmacsFile, or you can run it as a command + within Emacs. + +$emacsAppendLine + +EOF + ;; + *) + lineExists="$(grep "$emacsAppendLine" $myEmacsFile)" + if [ ! "$lineExists" ]; then + dotEmacsBackup=$myEmacsFile.$$.bak + mv $myEmacsFile $dotEmacsBackup || exit 1 + cp $dotEmacsBackup $myEmacsFile || exit 1 + echo "$emacsAppendLine" >> $myEmacsFile || exit 1 + cat 1>&2 <<EOF +NOTE: $myEmacsFile file successfully updated. + Backup written to $dotEmacsBackup +EOF + else + cat 1>&2 <<EOF + +NOTE: $myEmacsFile already contains information for this distribution. + $myEmacsFile not updated. + +EOF + fi + ;; + esac + fi +fi +} + +uninstall() { + if [ ! "$batchmode" = "Yes" ]; then + cat 1>&2 <<EOF + +NOTE: To "uninstall" this distribution, the changes made to your + CatalogManagers.properties, startup files, and/or .emacs + file need to be reverted. This uninstaller can automatically + revert them. Or, if you prefer, you can revert them manually. + +EOF + fi + + if [ "$osName" = "Cygwin" ]; then + thisXmlCatalog=$thisJavaXmlCatalog + fi + + # make "escaped" version of PWD to use with sed and grep + escapedPwd=$(echo $mydir | sed "s#/#\\\\\/#g") + + # check to see if a non-empty value for catalogManager was fed + # to uninstaller. + if [ -n ${1#--catalogManager=} ]; then + myCatalogManager=${1#--catalogManager=} + catalogBackup="$myCatalogManager.$$.bak" + catalogsLine=$(grep "^catalogs=" $myCatalogManager) + if [ "$catalogsLine" ] ; then + if [ "${catalogsLine#*$thisXmlCatalog*}" != "$catalogsLine" ]; then + REPLY="" + if [ ! "$batchmode" = "Yes" ]; then + read -s -n1 -p "Revert $myCatalogManager? [Yes] " + emit_message "$REPLY" + fi + case $REPLY in + [nNqQ]*) + cat 1>&2 <<EOF + +NOTE: No change made to $myCatalogManager. You need to manually + remove the following path from the "catalog=" line. + + $thisXmlCatalog + +EOF + ;; + *) + mv $myCatalogManager $catalogBackup || exit 1 + sed "s#^catalogs=\(.*\)$thisXmlCatalog\(.*\)\$#catalogs=\1\2#" $catalogBackup \ + | sed 's/;\+/;/' | sed 's/;$//' | sed 's/=;/=/' > $myCatalogManager || exit 1 + cat 1>&2 <<EOF +NOTE: $myCatalogManager file successfully reverted. + Backup written to $catalogBackup + +EOF + ;; + esac + else + emit_message "NOTE: No data for this distribution found in $myCatalogManager" + emit_message + fi + else + cat 1>&2 <<EOF +NOTE: No data for this distribution found in $myCatalogManager + So, nothing to revert in $myCatalogManager +EOF + fi + fi + + if [ -n "$myEmacsFile" ]; then + # check to see if a non-empty value for --dotEmacs file was fed + # to uninstaller. + if [ -n ${2#--dotEmacs=} ]; then + myEmacsFile=${2#--dotEmacs=} + revertLine="(load-file \"$escapedPwd\/\.emacs\.el\")" + loadLine="$(grep "$revertLine" "$myEmacsFile")" + if [ -n "$loadLine" ]; then + emit_message + REPLY="" + if [ ! "$batchmode" = "Yes" ]; then + read -s -n1 -p "Revert $myEmacsFile? [Yes] " + emit_message "$REPLY" + fi + case $REPLY in + [nNqQ]*) + cat 1>&2 <<EOF + +NOTE: No change made to $myEmacsFile. You need to manually +remove the following line. + +(load-file \"$mydir/.emacs.el\") + +EOF + ;; + *) + dotEmacsBackup=$myEmacsFile.$$.bak + mv $myEmacsFile $dotEmacsBackup || exit 1 + cp $dotEmacsBackup $myEmacsFile || exit 1 + sed -i "/$revertLine/d" $myEmacsFile || exit 1 + cat 1>&2 <<EOF +NOTE: $myEmacsFile file successfully reverted. +Backup written to $dotEmacsBackup + +EOF + ;; + esac + else + emit_message "NOTE: No data for this distribution found in $myEmacsFile" + fi + fi + fi + + # check all startup files + myStartupFiles=".bash_profile .bash_login .profile .bashrc .cshrc .tcshrc" + for file in $myStartupFiles; do + if [ -e "$HOME/$file" ]; then + case $file in + .tcshrc|.cshrc) + revertLine="source $mydir/.cshrc.incl" + revertLineEsc="source $escapedPwd\/\.cshrc\.incl" + ;; + *) + revertLine=". $mydir/.profile.incl" + revertLineEsc="\. $escapedPwd\/\.profile\.incl" + ;; + esac + lineExists="$(grep "$revertLineEsc" $HOME/$file )" + if [ "$lineExists" ]; then + REPLY="" + if [ ! "$batchmode" = "Yes" ]; then + read -s -n1 -p "Update $HOME/$file? [Yes] " + emit_message "$REPLY" + fi + case $REPLY in + [nNqQ]*) + cat 1>&2 <<EOF + +NOTE: No change made to $HOME/$file. You need to manually remove + the following line from it. + + $revertLine + +EOF + ;; + *) + dotFileBackup=$HOME/$file.$$.bak + mv $HOME/$file $dotFileBackup || exit 1 + cp $dotFileBackup $HOME/$file || exit 1 + sed -i "/$revertLineEsc/d" $HOME/$file || exit 1 + cat 1>&2 <<EOF +NOTE: $HOME/$file file successfully updated. + Backup written to $dotFileBackup + +EOF + ;; + esac + else + emit_message "NOTE: No data for this distribution found in $HOME/$file" + emit_message + fi + fi + done + removeOldFiles + emit_message "Done. Deleted uninstall.sh file." + rm -f $mydir/test.sh || exit 1 + rm -f $mydir/uninstall.sh || exit 1 +} + +writeUninstallFile() { + uninstallFile=$mydir/uninstall.sh + echo "#!/bin/bash" > $uninstallFile || exit 1 + echo "mydir=\$(readlink -f \$(dirname \$0))" >> $uninstallFile || exit 1 + echo "\$mydir/install.sh \\" >> $uninstallFile || exit 1 + echo " --uninstall \\" >> $uninstallFile || exit 1 + echo " --catalogManager=$myCatalogManager \\" >> $uninstallFile || exit 1 + echo " --dotEmacs=$myEmacsFile \\" >> $uninstallFile || exit 1 + echo " \$@" >> $uninstallFile || exit 1 + chmod 755 $uninstallFile || exit 1 +} + +writeTestFile() { + testFile=$mydir/test.sh + echo "#!/bin/bash" > $testFile || exit 1 + echo "mydir=\$(readlink -f \$(dirname \$0))" >> $testFile || exit 1 + echo "\$mydir/install.sh --test" >> $testFile || exit 1 + chmod 755 $testFile || exit 1 +} + +printExitMessage() { + cat 1>&2 <<EOF +Type the following to source your shell environment for the distribution + +$appendLine + +EOF +} + +checkForResolver() { + resolverResponse="$(java org.apache.xml.resolver.apps.resolver uri -u foo 2>/dev/null)" + if [ -z "$resolverResponse" ]; then + cat 1>&2 <<EOF + +NOTE: Your environment does not seem to contain the Apache XML Commons + Resolver; without that, you can't use XML catalogs with Java. + For more information, see the "How to use a catalog file" section + in Bob Stayton's "DocBook XSL: The Complete Guide" + + http://sagehill.net/docbookxsl/UseCatalog.html + +EOF + fi +} + +emitNoChangeMsg() { + cat 1>&2 <<EOF + +NOTE: No changes was made to CatalogManagers.properties. To + provide your Java tools with XML catalog information for + this distribution, you will need to make the appropriate + changes manually. + +EOF +} + +testCatalogs() { + readlinkResponse="$(readlink -f . 2>/dev/null)" + if [ -z "$readlinkResponse" ]; then + cat 1>&2 <<EOF + +FATAL: Cannot locate the "readlink" command. Stopping. +EOF + exit + fi + + if [ ! -f "$thisXmlCatalog" ]; then + cat 1>&2 <<EOF + +FATAL: $thisXmlCatalog file needed but not found. Stopping. +EOF + exit + fi + + if [ -z "$XML_CATALOG_FILES" ]; then + emit_message + emit_message "WARNING: XML_CATALOG_FILES not set. Not testing with xmlcatalog." + else + xmlCatalogResponse="$(xmlcatalog 2>/dev/null)" + if [ -z "$xmlCatalogResponse" ]; then + cat 1>&2 <<EOF + +WARNING: Cannot locate the "xmlcatalog" command. Make sure that + you have libxml2 and its associated utilities installed. + + http://xmlsoft.org/ + +EOF + else + emit_message "Testing with xmlcatalog..." + while read pair; do + path=$(readlink -f "$mydir/${pair%* *}") + uri=${pair#* *} + emit_message + emit_message " Tested: $uri" + for catalog in $XML_CATALOG_FILES; do + response="$(readlink -f "$(xmlcatalog $catalog $uri| grep -v "No entry")")" + if [ -n "$response" ]; then + if [ "$response" = "$path" ]; then + emit_message " Result: $path" + break + else + emit_message " Result: FAILED" + fi + fi + done + done < $mydir/.urilist + fi + fi + + if [ -z "$CLASSPATH" ]; then + emit_message + emit_message "NOTE: CLASSPATH not set. Not testing with Apache XML Commons Resolver." + else + if [ "$(checkForResolver)" ]; then + checkForResolver + else + emit_message + emit_message "Testing with Apache XML Commons Resolver..." + while read pair; do + path=$(readlink -f "$mydir/${pair%* *}") + uri=${pair#* *} + emit_message + emit_message " Tested: $uri" + if [ ${uri%.dtd} != $uri ]; then + response="$(java org.apache.xml.resolver.apps.resolver system -s $uri | grep "Result")" + else + response="$(java org.apache.xml.resolver.apps.resolver uri -u $uri | grep "Result")" + fi + if [ "$response" ]; then + if [ "${response#*$path}" != "$response" ]; then + emit_message " Result: $path" + else + emit_message " Result: FAILED" + fi + fi + done < $mydir/.urilist + fi + fi +} + +# get opts and execute appropriate function +case $1 in + *-uninstall) + uninstall $2 $3 $4 + ;; + *-test) + testCatalogs + ;; + *) + main + ;; +esac + +# Copyright +# --------- +# Copyright 2005 Michael Smith <smith@sideshowbarker.net> +# +# Permission is hereby granted, free of charge, to any person +# obtaining a copy of this software and associated documentation +# files (the "Software"), to deal in the Software without +# restriction, including without limitation the rights to use, copy, +# modify, merge, publish, distribute, sublicense, and/or sell copies +# of the Software, and to permit persons to whom the Software is +# furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice shall be +# included in all copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT +# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +# DEALINGS IN THE SOFTWARE. + +# vim: number diff --git a/src/documentation/docbook-xsl/javahelp/javahelp.xsl b/src/documentation/docbook-xsl/javahelp/javahelp.xsl new file mode 100644 index 0000000000..8cda3fa61f --- /dev/null +++ b/src/documentation/docbook-xsl/javahelp/javahelp.xsl @@ -0,0 +1,543 @@ +<?xml version="1.0"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" + xmlns:ng="http://docbook.org/docbook-ng" + xmlns:db="http://docbook.org/ns/docbook" + version="1.0" + exclude-result-prefixes="doc ng db"> + +<xsl:import href="../html/chunk.xsl"/> + +<xsl:output method="html"/> + +<!-- ******************************************************************** + $Id: javahelp.xsl,v 1.13 2006/04/14 19:20:59 kosek Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> +<xsl:param name="javahelp.encoding" select="'ISO-8859-1'"/> + +<doc:param name="javahelp.encoding" xmlns=""> +<refpurpose>Character encoding to use in control files for Java Help.</refpurpose> +<refdescription> +<para>Java Help crashes on some characters when written as character +references. In that case you can select appropriate encoding here.</para> +</refdescription> +</doc:param> + +<!-- ==================================================================== --> + +<xsl:template match="/"> + <xsl:choose> + <xsl:when test="$rootid != ''"> + <xsl:choose> + <xsl:when test="count(key('id',$rootid)) = 0"> + <xsl:message terminate="yes"> + <xsl:text>ID '</xsl:text> + <xsl:value-of select="$rootid"/> + <xsl:text>' not found in document.</xsl:text> + </xsl:message> + </xsl:when> + <xsl:otherwise> + <xsl:message>Formatting from <xsl:value-of select="$rootid"/></xsl:message> + <xsl:apply-templates select="key('id',$rootid)" mode="process.root"/> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:apply-templates select="/" mode="process.root"/> + </xsl:otherwise> + </xsl:choose> + + <xsl:for-each select="/"> <!-- This is just a hook for building profiling stylesheets --> + <xsl:call-template name="helpset"/> + <xsl:call-template name="helptoc"/> + <xsl:call-template name="helpmap"/> + <xsl:call-template name="helpidx"/> + </xsl:for-each> +</xsl:template> + + +<xsl:template name="header.navigation"> +</xsl:template> + +<xsl:template name="footer.navigation"> +</xsl:template> + +<!-- ==================================================================== --> + +<xsl:template name="helpset"> + <xsl:call-template name="write.chunk.with.doctype"> + <xsl:with-param name="filename" select="concat($base.dir,'jhelpset.hs')"/> + <xsl:with-param name="method" select="'xml'"/> + <xsl:with-param name="indent" select="'yes'"/> + <xsl:with-param name="doctype-public" select="'-//Sun Microsystems Inc.//DTD JavaHelp HelpSet Version 1.0//EN'"/> + <xsl:with-param name="doctype-system" select="'http://java.sun.com/products/javahelp/helpset_1_0.dtd'"/> + <xsl:with-param name="content"> + <xsl:call-template name="helpset.content"/> + </xsl:with-param> + </xsl:call-template> +</xsl:template> + +<xsl:template name="helpset.content"> + <xsl:variable name="title"> + <xsl:apply-templates select="." mode="title.markup"/> + </xsl:variable> + + <helpset version="1.0"> + <title> + <xsl:value-of select="$title"/> + + + + + top + + + + + + TOC + + javax.help.TOCView + jhelptoc.xml + + + + Index + + javax.help.IndexView + jhelpidx.xml + + + + Search + + javax.help.SearchView + JavaHelpSearch + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + , + + + + , + + + + + + + + + + + + + + + + + + + + + bullet + + + • + © + + + + TM + + ™ + + + ® + (SM) +   + “ + ” + ‘ + ’ + — + — + – + – + + • + + + + + diff --git a/src/documentation/docbook-xsl/javahelp/profile-javahelp.xsl b/src/documentation/docbook-xsl/javahelp/profile-javahelp.xsl new file mode 100644 index 0000000000..1be7f8d452 --- /dev/null +++ b/src/documentation/docbook-xsl/javahelp/profile-javahelp.xsl @@ -0,0 +1,498 @@ + + + + + + + + + + + + + + + +Character encoding to use in control files for Java Help. + +Java Help crashes on some characters when written as character +references. In that case you can select appropriate encoding here. + + + + + +Stripping NS from DocBook 5/NG document.Processing stripped document. + + + + + + ID ' + + ' not found in document. + + + + Formatting from + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="$title"/> + + + + + top + + + + + + TOC + + javax.help.TOCView + jhelptoc.xml + + + + Index + + javax.help.IndexView + jhelpidx.xml + + + + Search + + javax.help.SearchView + JavaHelpSearch + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + , + + + + , + + + + + + + + + + + + + + + + + + + + + bullet + + + • + © + + + + TM + + ™ + + + ® + (SM) +   + “ + ” + ‘ + ’ + — + — + – + – + + • + + + + + diff --git a/src/documentation/docbook-xsl/lib/lib.xml b/src/documentation/docbook-xsl/lib/lib.xml new file mode 100644 index 0000000000..64a1ca4d7d --- /dev/null +++ b/src/documentation/docbook-xsl/lib/lib.xml @@ -0,0 +1,1193 @@ + + + + +XSL Library Template Reference +$Id: lib.xweb,v 1.14 2005/10/24 06:39:31 xmldoc Exp $ + +DocBook Open Repository Team + + 1999 + 2000 + 2001 + 2002 + 2005 + Norman Walsh + + + +Introduction + +This is technical reference documentation for the DocBook XSL +Stylesheets; it documents (some of) the parameters, templates, and +other elements of the stylesheets. + +This is not intended to be user documentation. +It is provided for developers writing customization layers for the +stylesheets, and for anyone who's interested in how it +works. + +Although I am trying to be thorough, this documentation is known +to be incomplete. Don't forget to read the source, too :-) + + + + +General Library Templates + + + +dot.count +Returns the number of . characters in a string + + +Description + + +<xsl:template name="dot.count"> + <!-- Returns the number of "." characters in a string --> + <xsl:param name="string"></xsl:param> + <xsl:param name="count" select="0"></xsl:param> + <xsl:choose> + <xsl:when test="contains($string, '.')"> + <xsl:call-template name="dot.count"> + <xsl:with-param name="string" select="substring-after($string, '.')"></xsl:with-param> + <xsl:with-param name="count" select="$count+1"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$count"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + + + + + +copy-string +Returns count copies of a string + + +Description + + +<xsl:template name="copy-string"> + <!-- returns 'count' copies of 'string' --> + <xsl:param name="string"></xsl:param> + <xsl:param name="count" select="0"></xsl:param> + <xsl:param name="result"></xsl:param> + + <xsl:choose> + <xsl:when test="$count>0"> + <xsl:call-template name="copy-string"> + <xsl:with-param name="string" select="$string"></xsl:with-param> + <xsl:with-param name="count" select="$count - 1"></xsl:with-param> + <xsl:with-param name="result"> + <xsl:value-of select="$result"></xsl:value-of> + <xsl:value-of select="$string"></xsl:value-of> + </xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$result"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + + + + + +string.subst +Substitute one text string for another in a string + + +Description + +The string.subst template replaces all +occurances of target in string +with replacement and returns the result. + + + +<xsl:template name="string.subst"> + <xsl:param name="string"></xsl:param> + <xsl:param name="target"></xsl:param> + <xsl:param name="replacement"></xsl:param> + + <xsl:choose> + <xsl:when test="contains($string, $target)"> + <xsl:variable name="rest"> + <xsl:call-template name="string.subst"> + <xsl:with-param name="string" select="substring-after($string, $target)"></xsl:with-param> + <xsl:with-param name="target" select="$target"></xsl:with-param> + <xsl:with-param name="replacement" select="$replacement"></xsl:with-param> + </xsl:call-template> + </xsl:variable> + <xsl:value-of select="concat(substring-before($string, $target), $replacement, $rest)"></xsl:value-of> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$string"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + + + + + +xpointer.idref +Extract IDREF from an XPointer + + +Description + +The xpointer.idref template returns the +ID portion of an XPointer which is a pointer to an ID within the current +document, or the empty string if it is not. +In other words, xpointer.idref returns +foo when passed either #foo +or #xpointer(id('foo')), otherwise it returns +the empty string. + + +<xsl:template name="xpointer.idref"> + <xsl:param name="xpointer">http://...</xsl:param> + <xsl:choose> + <xsl:when test="starts-with($xpointer, '#xpointer(id(')"> + <xsl:variable name="rest" select="substring-after($xpointer, '#xpointer(id(')"></xsl:variable> + <xsl:variable name="quote" select="substring($rest, 1, 1)"></xsl:variable> + <xsl:value-of select="substring-before(substring-after($xpointer, $quote), $quote)"></xsl:value-of> + </xsl:when> + <xsl:when test="starts-with($xpointer, '#')"> + <xsl:value-of select="substring-after($xpointer, '#')"></xsl:value-of> + </xsl:when> + <!-- otherwise it's a pointer to some other document --> + </xsl:choose> +</xsl:template> + + + + + + + + + + +length-magnitude +Return the unqualified dimension from a length specification + + +Description + +The length-magnitude template returns the +unqualified length ("20" for "20pt") from a dimension. + + + +<xsl:template name="length-magnitude"> + <xsl:param name="length" select="'0pt'"></xsl:param> + + <xsl:choose> + <xsl:when test="string-length($length) = 0"></xsl:when> + <xsl:when test="substring($length,1,1) = '0' or substring($length,1,1) = '1' or substring($length,1,1) = '2' or substring($length,1,1) = '3' or substring($length,1,1) = '4' or substring($length,1,1) = '5' or substring($length,1,1) = '6' or substring($length,1,1) = '7' or substring($length,1,1) = '8' or substring($length,1,1) = '9' or substring($length,1,1) = '.'"> + <xsl:value-of select="substring($length,1,1)"></xsl:value-of> + <xsl:call-template name="length-magnitude"> + <xsl:with-param name="length" select="substring($length,2)"></xsl:with-param> + </xsl:call-template> + </xsl:when> + </xsl:choose> +</xsl:template> + + + + + + + + + +length-units +Return the units from a length specification + + +Description + +The length-units template returns the +units ("pt" for "20pt") from a length. If no units are supplied on the +length, the defauilt.units are returned. + + +<xsl:template name="length-units"> + <xsl:param name="length" select="'0pt'"></xsl:param> + <xsl:param name="default.units" select="'px'"></xsl:param> + <xsl:variable name="magnitude"> + <xsl:call-template name="length-magnitude"> + <xsl:with-param name="length" select="$length"></xsl:with-param> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="units"> + <xsl:value-of select="substring($length, string-length($magnitude)+1)"></xsl:value-of> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$units = ''"> + <xsl:value-of select="$default.units"></xsl:value-of> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$units"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + + + + + +length-spec +Return a fully qualified length specification + + +Description + +The length-spec template returns the +qualified length from a dimension. If an unqualified length is given, +the default.units will be added to it. + + + +<xsl:template name="length-spec"> + <xsl:param name="length" select="'0pt'"></xsl:param> + <xsl:param name="default.units" select="'px'"></xsl:param> + + <xsl:variable name="magnitude"> + <xsl:call-template name="length-magnitude"> + <xsl:with-param name="length" select="$length"></xsl:with-param> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="units"> + <xsl:value-of select="substring($length, string-length($magnitude)+1)"></xsl:value-of> + </xsl:variable> + + <xsl:value-of select="$magnitude"></xsl:value-of> + <xsl:choose> + <xsl:when test="$units='cm' or $units='mm' or $units='in' or $units='pt' or $units='pc' or $units='px' or $units='em'"> + <xsl:value-of select="$units"></xsl:value-of> + </xsl:when> + <xsl:when test="$units = ''"> + <xsl:value-of select="$default.units"></xsl:value-of> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>Unrecognized unit of measure: </xsl:text> + <xsl:value-of select="$units"></xsl:value-of> + <xsl:text>.</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + + + + + +length-in-points +Returns the size, in points, of a specified length + + +Description + +The length-in-points template converts a length +specification to points and returns that value as an unqualified +number. + + + +There is no way for the template to infer the size of an +em. It relies on the default em.size +which is initially 10 (for 10pt). + +Similarly, converting pixels to points relies on the +pixels.per.inch parameter which is initially +90. + + + + +<xsl:template name="length-in-points"> + <xsl:param name="length" select="'0pt'"></xsl:param> + <xsl:param name="em.size" select="10"></xsl:param> + <xsl:param name="pixels.per.inch" select="90"></xsl:param> + + <xsl:variable name="magnitude"> + <xsl:call-template name="length-magnitude"> + <xsl:with-param name="length" select="$length"></xsl:with-param> + </xsl:call-template> + </xsl:variable> + + <xsl:variable name="units"> + <xsl:value-of select="substring($length, string-length($magnitude)+1)"></xsl:value-of> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$units = 'pt'"> + <xsl:value-of select="$magnitude"></xsl:value-of> + </xsl:when> + <xsl:when test="$units = 'cm'"> + <xsl:value-of select="$magnitude div 2.54 * 72.0"></xsl:value-of> + </xsl:when> + <xsl:when test="$units = 'mm'"> + <xsl:value-of select="$magnitude div 25.4 * 72.0"></xsl:value-of> + </xsl:when> + <xsl:when test="$units = 'in'"> + <xsl:value-of select="$magnitude * 72.0"></xsl:value-of> + </xsl:when> + <xsl:when test="$units = 'pc'"> + <xsl:value-of select="$magnitude * 12.0"></xsl:value-of> + </xsl:when> + <xsl:when test="$units = 'px'"> + <xsl:value-of select="$magnitude div $pixels.per.inch * 72.0"></xsl:value-of> + </xsl:when> + <xsl:when test="$units = 'em'"> + <xsl:value-of select="$magnitude * $em.size"></xsl:value-of> + </xsl:when> + <xsl:otherwise> + <xsl:message> + <xsl:text>Unrecognized unit of measure: </xsl:text> + <xsl:value-of select="$units"></xsl:value-of> + <xsl:text>.</xsl:text> + </xsl:message> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + + + + + +pi-attribute +Extract a pseudo-attribute from a PI + + +Description + +The pi-attribute template extracts a pseudo-attribute +from a processing instruction. For example, given the PI +<?foo bar="1" baz='red'?>, +<xsl:call-template name="pi-attribute"> + <xsl:with-param name="pis" select="processing-instruction('foo')"/> + <xsl:with-param name="attribute" select="'baz'"/> +</xsl:call-template> +will return red. This template returns the first matching +attribute that it finds. Presented with processing instructions that +contain badly formed pseudo-attributes (missing or unbalanced quotes, +for example), the template may silently return erroneous results. + + +<xsl:template name="pi-attribute"> + <xsl:param name="pis" select="processing-instruction('BOGUS_PI')"></xsl:param> + <xsl:param name="attribute">filename</xsl:param> + <xsl:param name="count">1</xsl:param> + + <xsl:choose> + <xsl:when test="$count>count($pis)"> + <!-- not found --> + </xsl:when> + <xsl:otherwise> + <xsl:variable name="pi"> + <xsl:value-of select="$pis[$count]"></xsl:value-of> + </xsl:variable> + <xsl:variable name="pivalue"> + <xsl:value-of select="concat(' ', normalize-space($pi))"></xsl:value-of> + </xsl:variable> + <xsl:choose> + <xsl:when test="contains($pivalue,concat(' ', $attribute, '='))"> + <xsl:variable name="rest" select="substring-after($pivalue,concat(' ', $attribute,'='))"></xsl:variable> + <xsl:variable name="quote" select="substring($rest,1,1)"></xsl:variable> + <xsl:value-of select="substring-before(substring($rest,2),$quote)"></xsl:value-of> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="pi-attribute"> + <xsl:with-param name="pis" select="$pis"></xsl:with-param> + <xsl:with-param name="attribute" select="$attribute"></xsl:with-param> + <xsl:with-param name="count" select="$count + 1"></xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + + + + + +lookup.key +Retrieve the value associated with a particular key in a table + + +Description + +Given a table of space-delimited key/value pairs, +the lookup.key template extracts the value associated +with a particular key. + + +<xsl:template name="lookup.key"> + <xsl:param name="key" select="''"></xsl:param> + <xsl:param name="table" select="''"></xsl:param> + + <xsl:if test="contains($table, ' ')"> + <xsl:choose> + <xsl:when test="substring-before($table, ' ') = $key"> + <xsl:variable name="rest" select="substring-after($table, ' ')"></xsl:variable> + <xsl:choose> + <xsl:when test="contains($rest, ' ')"> + <xsl:value-of select="substring-before($rest, ' ')"></xsl:value-of> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$rest"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="lookup.key"> + <xsl:with-param name="key" select="$key"></xsl:with-param> + <xsl:with-param name="table" select="substring-after(substring-after($table,' '), ' ')"></xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:if> +</xsl:template> + + + + + + + + + +xpath.location +Calculate the XPath child-sequence to the current node + + +Description + +The xpath.location template calculates the +absolute path from the root of the tree to the current element node. + + + +<xsl:template name="xpath.location"> + <xsl:param name="node" select="."></xsl:param> + <xsl:param name="path" select="''"></xsl:param> + + <xsl:variable name="next.path"> + <xsl:value-of select="local-name($node)"></xsl:value-of> + <xsl:if test="$path != ''">/</xsl:if> + <xsl:value-of select="$path"></xsl:value-of> + </xsl:variable> + + <xsl:choose> + <xsl:when test="$node/parent::*"> + <xsl:call-template name="xpath.location"> + <xsl:with-param name="node" select="$node/parent::*"></xsl:with-param> + <xsl:with-param name="path" select="$next.path"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:text>/</xsl:text> + <xsl:value-of select="$next.path"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + + + + + +comment-escape-string +Prepare a string for inclusion in an XML comment + + +Description + +The comment-escape-string template returns a string +that has been transformed so that it can safely be output as an XML comment. +Internal occurrences of "--" will be replaced with "- -" and a leading and/or +trailing space will be added to the string, if necessary. + + +<xsl:template name="comment-escape-string"> + <xsl:param name="string" select="''"></xsl:param> + + <xsl:if test="starts-with($string, '-')"> + <xsl:text> </xsl:text> + </xsl:if> + + <xsl:call-template name="comment-escape-string.recursive"> + <xsl:with-param name="string" select="$string"></xsl:with-param> + </xsl:call-template> + + <xsl:if test="substring($string, string-length($string), 1) = '-'"> + <xsl:text> </xsl:text> + </xsl:if> +</xsl:template> + + + + + + + + + +comment-escape-string.recursive +Internal function used by comment-escape-string + + +Description + +The comment-escape-string.recursive template is used +by comment-escape-string. + + +<xsl:template name="comment-escape-string.recursive"> + <xsl:param name="string" select="''"></xsl:param> + <xsl:choose> + <xsl:when test="contains($string, '--')"> + <xsl:value-of select="substring-before($string, '--')"></xsl:value-of> + <xsl:value-of select="'- -'"></xsl:value-of> + <xsl:call-template name="comment-escape-string.recursive"> + <xsl:with-param name="string" select="substring-after($string, '--')"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$string"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + + + + +prepend-pad +Right-pad a string out to a certain length + + +Description + +This function takes string padVar and +pads it out to the string-length length, using +string padChar (a space character by default) +as the padding string (note that padChar can be +a string; it is not limited to just being a single character). + + + This function is a copy of Nate Austin's + prepend-pad function in the Padding + Content section of Dave Pawson's XSLT + FAQ. + + + + <xsl:template name="prepend-pad"> + <!-- recursive template to right justify and prepend--> + <!-- the value with whatever padChar is passed in --> + <xsl:param name="padChar" select="' '"></xsl:param> + <xsl:param name="padVar"></xsl:param> + <xsl:param name="length"></xsl:param> + <xsl:choose> + <xsl:when test="string-length($padVar) < $length"> + <xsl:call-template name="prepend-pad"> + <xsl:with-param name="padChar" select="$padChar"></xsl:with-param> + <xsl:with-param name="padVar" select="concat($padChar,$padVar)"></xsl:with-param> + <xsl:with-param name="length" select="$length"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="substring($padVar,string-length($padVar) - $length + 1)"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + + + + + + + + + +trim.text +Trim leading and trailing whitespace from a text node + + +Description + +Given a text node, this function trims leading and trailing +whitespace from it and returns the trimmed contents. + + + + <xsl:template name="trim.text"> + <xsl:param name="contents" select="."></xsl:param> + <xsl:variable name="contents-left-trimmed"> + <xsl:call-template name="trim-left"> + <xsl:with-param name="contents" select="$contents"></xsl:with-param> + </xsl:call-template> + </xsl:variable> + <xsl:variable name="contents-trimmed"> + <xsl:call-template name="trim-right"> + <xsl:with-param name="contents" select="$contents-left-trimmed"></xsl:with-param> + </xsl:call-template> + </xsl:variable> + <xsl:value-of select="$contents-trimmed"></xsl:value-of> + </xsl:template> + + <xsl:template name="trim-left"> + <xsl:param name="contents"></xsl:param> + <xsl:choose> + <xsl:when test="starts-with($contents,' +') or starts-with($contents,' +') or starts-with($contents,' ') or starts-with($contents,' ')"> + <xsl:call-template name="trim-left"> + <xsl:with-param name="contents" select="substring($contents, 2)"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$contents"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + + <xsl:template name="trim-right"> + <xsl:param name="contents"></xsl:param> + <xsl:variable name="last-char"> + <xsl:value-of select="substring($contents, string-length($contents), 1)"></xsl:value-of> + </xsl:variable> + <xsl:choose> + <xsl:when test="($last-char = ' +') or ($last-char = ' ') or ($last-char = ' ') or ($last-char = ' ')"> + <xsl:call-template name="trim-right"> + <xsl:with-param name="contents" select="substring($contents, 1, string-length($contents) - 1)"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$contents"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + + + + + + + + + +str.tokenize.keep.delimiters +Tokenize a string while preserving any delimiters + + +Description + +Based on the occurrence of one or more delimiter characters, +this function breaks a string into a list of tokens and delimiters, +marking up each of the tokens with a token element +and preserving the delimiters as text nodes between the tokens. + + + This function is a very slightly modified version of a + function from the EXSLT + site. The original is available at: + +
                  + + The str.tokenize.keep.delimiters function + differs only in that it preserves the delimiters instead of + discarding them.                   +                   + + + + <xsl:template name="str.tokenize.keep.delimiters"> + <xsl:param name="string" select="''"></xsl:param> + <xsl:param name="delimiters" select="' '"></xsl:param> + <xsl:choose> + <xsl:when test="not($string)"></xsl:when> + <xsl:when test="not($delimiters)"> + <xsl:call-template name="str.tokenize.keep.delimiters-characters"> + <xsl:with-param name="string" select="$string"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="str.tokenize.keep.delimiters-delimiters"> + <xsl:with-param name="string" select="$string"></xsl:with-param> + <xsl:with-param name="delimiters" select="$delimiters"></xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + + <xsl:template name="str.tokenize.keep.delimiters-characters"> + <xsl:param name="string"></xsl:param> + <xsl:if test="$string"> + <token><xsl:value-of select="substring($string, 1, 1)"></xsl:value-of></token> + <xsl:call-template name="str.tokenize.keep.delimiters-characters"> + <xsl:with-param name="string" select="substring($string, 2)"></xsl:with-param> + </xsl:call-template> + </xsl:if> + </xsl:template> + + <xsl:template name="str.tokenize.keep.delimiters-delimiters"> + <xsl:param name="string"></xsl:param> + <xsl:param name="delimiters"></xsl:param> + <xsl:variable name="delimiter" select="substring($delimiters, 1, 1)"></xsl:variable> + <xsl:choose> + <xsl:when test="not($delimiter)"> + <token><xsl:value-of select="$string"></xsl:value-of></token> + </xsl:when> + <xsl:when test="contains($string, $delimiter)"> + <xsl:if test="not(starts-with($string, $delimiter))"> + <xsl:call-template name="str.tokenize.keep.delimiters-delimiters"> + <xsl:with-param name="string" select="substring-before($string, $delimiter)"></xsl:with-param> + <xsl:with-param name="delimiters" select="substring($delimiters, 2)"></xsl:with-param> + </xsl:call-template> + </xsl:if> + <!-- output each delimiter --> + <xsl:value-of select="$delimiter"></xsl:value-of> + <xsl:call-template name="str.tokenize.keep.delimiters-delimiters"> + <xsl:with-param name="string" select="substring-after($string, $delimiter)"></xsl:with-param> + <xsl:with-param name="delimiters" select="$delimiters"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:call-template name="str.tokenize.keep.delimiters-delimiters"> + <xsl:with-param name="string" select="$string"></xsl:with-param> + <xsl:with-param name="delimiters" select="substring($delimiters, 2)"></xsl:with-param> + </xsl:call-template> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + + +                   +                   + + + + + + apply-string-subst-map + Apply a string-substitution map + + + Description + + This function applies a "string substitution" map. Use it when + you want to do multiple string substitutions on the same target + content. It reads in two things: content, the + content on which to perform the substitution, and + map.contents, a node set of + elements (the names of the elements don't matter), with each element + having the following attributes: + + + oldstring, a string to + be replaced + + + newstring, a string with + which to replace oldstring + + + The function uses map.contents to + do substitution on content, and then + returns the modified contents. + + + This function is a very slightly modified version of Jeni + Tennison's replace_strings function in the + multiple string replacements section of Dave Pawson's + XSLT + FAQ. + + The apply-string-subst-map function is + essentially the same function as the + apply-character-map function; the only + difference is that in the map that + apply-string-subst-map expects, oldstring and newstring attributes are used instead of + character and string attributes. + + + + <xsl:template name="apply-string-subst-map"> + <xsl:param name="content"></xsl:param> + <xsl:param name="map.contents"></xsl:param> + <xsl:variable name="replaced_text"> + <xsl:call-template name="string.subst"> + <xsl:with-param name="string" select="$content"></xsl:with-param> + <xsl:with-param name="target" select="$map.contents[1]/@oldstring"></xsl:with-param> + <xsl:with-param name="replacement" select="$map.contents[1]/@newstring"></xsl:with-param> + </xsl:call-template> + </xsl:variable> + <xsl:choose> + <xsl:when test="$map.contents[2]"> + <xsl:call-template name="apply-string-subst-map"> + <xsl:with-param name="content" select="$replaced_text"></xsl:with-param> + <xsl:with-param name="map.contents" select="$map.contents[position() > 1]"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$replaced_text"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + + + + + + + + + + apply-character-map + Apply an XSLT character map + + + Description + + This function applies an XSLT character + map; that is, it cause certain individual characters to be + substituted with strings of one or more characters. It is useful + mainly for replacing multiple "special" chararacters or symbols in + the same target content. It reads in two things: + content, the content on which to perform the + substitution, and map.contents, a + node set of elements (the names of the elements don't matter), with + each element having the following attributes: + + + character, a character to + be replaced + + + string, a string with + which to replace character + + + This function uses map.contents to + do substitution on content, and then returns + the modified contents. + + + This function is a very slightly modified version of Jeni + Tennison's replace_strings function in the + multiple string replacements section of Dave Pawson's + XSLT + FAQ. + + The apply-string-subst-map function is + essentially the same function as the + apply-character-map function; the only + difference is that in the map that + apply-string-subst-map expects, oldstring and newstring attributes are used instead of + character and string attributes. + + + + <xsl:template name="apply-character-map"> + <xsl:param name="content"></xsl:param> + <xsl:param name="map.contents"></xsl:param> + <xsl:variable name="replaced_text"> + <xsl:call-template name="string.subst"> + <xsl:with-param name="string" select="$content"></xsl:with-param> + <xsl:with-param name="target" select="$map.contents[1]/@character"></xsl:with-param> + <xsl:with-param name="replacement" select="$map.contents[1]/@string"></xsl:with-param> + </xsl:call-template> + </xsl:variable> + <xsl:choose> + <xsl:when test="$map.contents[2]"> + <xsl:call-template name="apply-character-map"> + <xsl:with-param name="content" select="$replaced_text"></xsl:with-param> + <xsl:with-param name="map.contents" select="$map.contents[position() > 1]"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$replaced_text"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + + + + + + + + + +read-character-map +Read in all or part of an XSLT character map + + +Description + +The XSLT 2.0 specification describes character +maps and explains how they may be used to allow a specific +character appearing in a text or attribute node in a final results +tree to be substituted by a specified string of characters during +serialization. The read-character-map function +provides a means for reading and using character maps with XSLT +1.0-based tools. + +It reads the character-map contents from +uri (in full or in part, depending on the value +of the use.subset parameter), then passes those +contents to the apply-character-map function, +along with content, the data on which to +perform the character substition. + +Using the character map "in part" means that it uses only those +output-character elements that match the XPATH expression +given in the value of the subset.profile +parameter. The current implementation of that capability here relies +on the evaluate extension XSLT function. + + + <xsl:template name="read-character-map"> + <xsl:param name="use.subset"></xsl:param> + <xsl:param name="subset.profile"></xsl:param> + <xsl:param name="uri"></xsl:param> + <xsl:choose> + <xsl:when test="$use.subset != 0"> + <!-- use a subset of the character map instead of the full map --> + <xsl:choose> + <!-- xsltproc and Xalan both support dyn:evaluate() --> + <xsl:when test="function-available('dyn:evaluate')"> + <xsl:copy-of select="document($uri)//*[local-name()='output-character'] [dyn:evaluate($subset.profile)]"></xsl:copy-of> + </xsl:when> + <!-- Saxon has its own evaluate() & doesn't support dyn:evaluate() --> + <xsl:when test="function-available('saxon:evaluate')"> + <xsl:copy-of select="document($uri)//*[local-name()='output-character'] [saxon:evaluate($subset.profile)]"></xsl:copy-of> + </xsl:when> + <xsl:otherwise> + <xsl:message terminate="yes"> +Error: To process character-map subsets, you must use an XSLT engine +that supports the evaluate() XSLT extension function. Your XSLT engine +does not support it. +</xsl:message> + </xsl:otherwise> + </xsl:choose> + </xsl:when> + <xsl:otherwise> + <!-- value of $use.subset is non-zero, so use the full map --> + <xsl:copy-of select="document($uri)//*[local-name()='output-character']"></xsl:copy-of> + </xsl:otherwise> + </xsl:choose> + </xsl:template> + + + + +                   + + + + +Relative URI Functions + +Introduction + +These functions manipulate relative URI references. + +The following assumptions must hold true: + + + +All URIs are relative. + + +No URI contains the ../ sequence +which would effectively move up the hierarchy. + + + +If these assumptions do not hold, the results are unpredictable. + + + + + + + +count.uri.path.depth +Count the number of path components in a relative URI + + +Description + +This function counts the number of path components in a relative URI. + + +<xsl:template name="count.uri.path.depth"> + <xsl:param name="filename" select="''"></xsl:param> + <xsl:param name="count" select="0"></xsl:param> + + <xsl:choose> + <xsl:when test="contains($filename, '/')"> + <xsl:call-template name="count.uri.path.depth"> + <xsl:with-param name="filename" select="substring-after($filename, '/')"></xsl:with-param> + <xsl:with-param name="count" select="$count + 1"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$count"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + + + + + +trim.common.uri.paths +Trim common leading path components from a relative URI + + +Description + +This function trims common leading path components from a relative URI. + + +<xsl:template name="trim.common.uri.paths"> + <xsl:param name="uriA" select="''"></xsl:param> + <xsl:param name="uriB" select="''"></xsl:param> + <xsl:param name="return" select="'A'"></xsl:param> + + <xsl:choose> + <xsl:when test="contains($uriA, '/') and contains($uriB, '/') and substring-before($uriA, '/') = substring-before($uriB, '/')"> + <xsl:call-template name="trim.common.uri.paths"> + <xsl:with-param name="uriA" select="substring-after($uriA, '/')"></xsl:with-param> + <xsl:with-param name="uriB" select="substring-after($uriB, '/')"></xsl:with-param> + <xsl:with-param name="return" select="$return"></xsl:with-param> + </xsl:call-template> + </xsl:when> + <xsl:otherwise> + <xsl:choose> + <xsl:when test="$return = 'A'"> + <xsl:value-of select="$uriA"></xsl:value-of> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select="$uriB"></xsl:value-of> + </xsl:otherwise> + </xsl:choose> + </xsl:otherwise> + </xsl:choose> +</xsl:template> + + + + + + + + + +The Stylesheet + +The lib.xsl stylesheet is just a wrapper +around these functions. + + + +<!-- ******************************************************************** + $Id: lib.xweb,v 1.14 2005/10/24 06:39:31 xmldoc Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + This module implements DTD-independent functions + + ******************************************************************** --> + +<xsl:stylesheet exclude-result-prefixes="src" version="1.0"> + +<src:fragref linkend="dot.count.frag"></src:fragref> +<src:fragref linkend="copy-string.frag"></src:fragref> +<src:fragref linkend="string.subst.frag"></src:fragref> +<src:fragref linkend="xpointer.idref.frag"></src:fragref> +<src:fragref linkend="length-magnitude.frag"></src:fragref> +<src:fragref linkend="length-units.frag"></src:fragref> +<src:fragref linkend="length-spec.frag"></src:fragref> +<src:fragref linkend="length-in-points.frag"></src:fragref> +<src:fragref linkend="pi-attribute.frag"></src:fragref> +<src:fragref linkend="lookup.key.frag"></src:fragref> +<src:fragref linkend="xpath.location.frag"></src:fragref> +<src:fragref linkend="comment-escape-string"></src:fragref> +<src:fragref linkend="comment-escape-string.recursive"></src:fragref> +<src:fragref linkend="prepend-pad.frag"></src:fragref> +<src:fragref linkend="str.tokenize.keep.delimiters.frag"></src:fragref> +<src:fragref linkend="apply-string-subst-map.frag"></src:fragref> +<src:fragref linkend="apply-character-map.frag"></src:fragref> +<src:fragref linkend="read-character-map.frag"></src:fragref> +<src:fragref linkend="count.uri.path.depth.frag"></src:fragref> +<src:fragref linkend="trim.common.uri.paths.frag"></src:fragref> +<src:fragref linkend="trim.text.frag"></src:fragref> + +</xsl:stylesheet> + + + +                   \ No newline at end of file diff --git a/src/documentation/docbook-xsl/lib/lib.xsl b/src/documentation/docbook-xsl/lib/lib.xsl new file mode 100644 index 0000000000..8ac788f507 --- /dev/null +++ b/src/documentation/docbook-xsl/lib/lib.xsl @@ -0,0 +1,954 @@ + + + + + +dot.count +Returns the number of . characters in a string +Description + + + + + + + + + + + + + + + + + + + + + + + +copy-string +Returns count copies of a string +Description + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +string.subst +Substitute one text string for another in a string +Description + +The string.subst template replaces all +occurances of target in string +with replacement and returns the result. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +xpointer.idref +Extract IDREF from an XPointer +Description + +The xpointer.idref template returns the +ID portion of an XPointer which is a pointer to an ID within the current +document, or the empty string if it is not. +In other words, xpointer.idref returns +foo when passed either #foo +or #xpointer(id('foo')), otherwise it returns +the empty string. + + + + + + + http://... + + + + + + + + + + + + + + +length-magnitude +Return the unqualified dimension from a length specification +Description + +The length-magnitude template returns the +unqualified length ("20" for "20pt") from a dimension. + + + + + + + + + + + + + + + + + + + + + +length-units +Return the units from a length specification +Description + +The length-units template returns the +units ("pt" for "20pt") from a length. If no units are supplied on the +length, the defauilt.units are returned. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +length-spec +Return a fully qualified length specification +Description + +The length-spec template returns the +qualified length from a dimension. If an unqualified length is given, +the default.units will be added to it. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unrecognized unit of measure: + + . + + + + + + +length-in-points +Returns the size, in points, of a specified length +Description + +The length-in-points template converts a length +specification to points and returns that value as an unqualified +number. + + + +There is no way for the template to infer the size of an +em. It relies on the default em.size +which is initially 10 (for 10pt). + +Similarly, converting pixels to points relies on the +pixels.per.inch parameter which is initially +90. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unrecognized unit of measure: + + . + + + + + + +pi-attribute +Extract a pseudo-attribute from a PI +Description + +The pi-attribute template extracts a pseudo-attribute +from a processing instruction. For example, given the PI +<?foo bar="1" baz='red'?>, +<xsl:call-template name="pi-attribute"> + <xsl:with-param name="pis" select="processing-instruction('foo')"/> + <xsl:with-param name="attribute" select="'baz'"/> +</xsl:call-template> +will return red. This template returns the first matching +attribute that it finds. Presented with processing instructions that +contain badly formed pseudo-attributes (missing or unbalanced quotes, +for example), the template may silently return erroneous results. + + + + + + + + filename + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +lookup.key +Retrieve the value associated with a particular key in a table +Description + +Given a table of space-delimited key/value pairs, +the lookup.key template extracts the value associated +with a particular key. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +xpath.location +Calculate the XPath child-sequence to the current node +Description + +The xpath.location template calculates the +absolute path from the root of the tree to the current element node. + + + + + + + + + + + + + / + + + + + + + + + + + + / + + + + + + +comment-escape-string +Prepare a string for inclusion in an XML comment +Description + +The comment-escape-string template returns a string +that has been transformed so that it can safely be output as an XML comment. +Internal occurrences of "--" will be replaced with "- -" and a leading and/or +trailing space will be added to the string, if necessary. + + + + + + + + + + + + + + + + + + + + + + +comment-escape-string.recursive +Internal function used by comment-escape-string +Description + +The comment-escape-string.recursive template is used +by comment-escape-string. + + + + + + + + + + + + + + + + + + + + + +prepend-pad +Right-pad a string out to a certain length +Description + +This function takes string padVar and +pads it out to the string-length length, using +string padChar (a space character by default) +as the padding string (note that padChar can be +a string; it is not limited to just being a single character). + + + This function is a copy of Nate Austin's + prepend-pad function in the Padding + Content section of Dave Pawson's XSLT + FAQ. + + + + + + + + + + + + + + + + + + + + + + + + + + + +trim.text +Trim leading and trailing whitespace from a text node +Description + +Given a text node, this function trims leading and trailing +whitespace from it and returns the trimmed contents. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +str.tokenize.keep.delimiters +Tokenize a string while preserving any delimiters +Description + +Based on the occurrence of one or more delimiter characters, +this function breaks a string into a list of tokens and delimiters, +marking up each of the tokens with a token element +and preserving the delimiters as text nodes between the tokens. + + + This function is a very slightly modified version of a + function from the EXSLT + site. The original is available at: + +
                  + + The str.tokenize.keep.delimiters function + differs only in that it preserves the delimiters instead of + discarding them.                   +                   + + + +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + apply-string-subst-map + Apply a string-substitution map + Description + + This function applies a "string substitution" map. Use it when + you want to do multiple string substitutions on the same target + content. It reads in two things: content, the + content on which to perform the substitution, and + map.contents, a node set of + elements (the names of the elements don't matter), with each element + having the following attributes: + + + oldstring, a string to + be replaced + + + newstring, a string with + which to replace oldstring + + + The function uses map.contents to + do substitution on content, and then + returns the modified contents. + + + This function is a very slightly modified version of Jeni + Tennison's replace_strings function in the + multiple string replacements section of Dave Pawson's + XSLT + FAQ. + + The apply-string-subst-map function is + essentially the same function as the + apply-character-map function; the only + difference is that in the map that + apply-string-subst-map expects, oldstring and newstring attributes are used instead of + character and string attributes. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + apply-character-map + Apply an XSLT character map + Description + + This function applies an XSLT character + map; that is, it cause certain individual characters to be + substituted with strings of one or more characters. It is useful + mainly for replacing multiple "special" chararacters or symbols in + the same target content. It reads in two things: + content, the content on which to perform the + substitution, and map.contents, a + node set of elements (the names of the elements don't matter), with + each element having the following attributes: + + + character, a character to + be replaced + + + string, a string with + which to replace character + + + This function uses map.contents to + do substitution on content, and then returns + the modified contents. + + + This function is a very slightly modified version of Jeni + Tennison's replace_strings function in the + multiple string replacements section of Dave Pawson's + XSLT + FAQ. + + The apply-string-subst-map function is + essentially the same function as the + apply-character-map function; the only + difference is that in the map that + apply-string-subst-map expects, oldstring and newstring attributes are used instead of + character and string attributes. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +read-character-map +Read in all or part of an XSLT character map +Description + +The XSLT 2.0 specification describes character +maps and explains how they may be used to allow a specific +character appearing in a text or attribute node in a final results +tree to be substituted by a specified string of characters during +serialization. The read-character-map function +provides a means for reading and using character maps with XSLT +1.0-based tools. + +It reads the character-map contents from +uri (in full or in part, depending on the value +of the use.subset parameter), then passes those +contents to the apply-character-map function, +along with content, the data on which to +perform the character substition. + +Using the character map "in part" means that it uses only those +output-character elements that match the XPATH expression +given in the value of the subset.profile +parameter. The current implementation of that capability here relies +on the evaluate extension XSLT function. + + + + + + + + + + + + + + + + + + + + + + +Error: To process character-map subsets, you must use an XSLT engine +that supports the evaluate() XSLT extension function. Your XSLT engine +does not support it. + + + + + + + + + + + + +count.uri.path.depth +Count the number of path components in a relative URI +Description + +This function counts the number of path components in a relative URI. + + + + + + + + + + + + + + + + + + + + + + + +trim.common.uri.paths +Trim common leading path components from a relative URI +Description + +This function trims common leading path components from a relative URI. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   \ No newline at end of file diff --git a/src/documentation/docbook-xsl/lib/lib.xweb b/src/documentation/docbook-xsl/lib/lib.xweb new file mode 100644 index 0000000000..7eafc70dd1 --- /dev/null +++ b/src/documentation/docbook-xsl/lib/lib.xweb @@ -0,0 +1,1246 @@ + + + +XSL Library Template Reference +$Id: lib.xweb,v 1.14 2005/10/24 06:39:31 xmldoc Exp $ + +DocBook Open Repository Team + + 1999 + 2000 + 2001 + 2002 + 2005 + Norman Walsh + + + +Introduction + +This is technical reference documentation for the DocBook XSL +Stylesheets; it documents (some of) the parameters, templates, and +other elements of the stylesheets. + +This is not intended to be user documentation. +It is provided for developers writing customization layers for the +stylesheets, and for anyone who's interested in how it +works. + +Although I am trying to be thorough, this documentation is known +to be incomplete. Don't forget to read the source, too :-) + + + + +General Library Templates + + + +dot.count +Returns the number of . characters in a string + + +Description + + + + + + + + + + + + + + + + + + + + + + + + + + + +copy-string +Returns count copies of a string + + +Description + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +string.subst +Substitute one text string for another in a string + + +Description + +The string.subst template replaces all +occurances of target in string +with replacement and returns the result. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +xpointer.idref +Extract IDREF from an XPointer + + +Description + +The xpointer.idref template returns the +ID portion of an XPointer which is a pointer to an ID within the current +document, or the empty string if it is not. +In other words, xpointer.idref returns +foo when passed either #foo +or #xpointer(id('foo')), otherwise it returns +the empty string. + + + + http://... + + + + + + + + + + + + + + + + + + + + + + +length-magnitude +Return the unqualified dimension from a length specification + + +Description + +The length-magnitude template returns the +unqualified length ("20" for "20pt") from a dimension. + + + + + + + + + + + + + + + + + + + + + + + + + +length-units +Return the units from a length specification + + +Description + +The length-units template returns the +units ("pt" for "20pt") from a length. If no units are supplied on the +length, the defauilt.units are returned. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +length-spec +Return a fully qualified length specification + + +Description + +The length-spec template returns the +qualified length from a dimension. If an unqualified length is given, +the default.units will be added to it. + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unrecognized unit of measure: + + . + + + + + + + + + + + + + +length-in-points +Returns the size, in points, of a specified length + + +Description + +The length-in-points template converts a length +specification to points and returns that value as an unqualified +number. + + + +There is no way for the template to infer the size of an +em. It relies on the default em.size +which is initially 10 (for 10pt). + +Similarly, converting pixels to points relies on the +pixels.per.inch parameter which is initially +90. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unrecognized unit of measure: + + . + + + + + + + + + + + + + +pi-attribute +Extract a pseudo-attribute from a PI + + +Description + +The pi-attribute template extracts a pseudo-attribute +from a processing instruction. For example, given the PI +<?foo bar="1" baz='red'?>, + + + +]]> +will return red. This template returns the first matching +attribute that it finds. Presented with processing instructions that +contain badly formed pseudo-attributes (missing or unbalanced quotes, +for example), the template may silently return erroneous results. + + + + + filename + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +lookup.key +Retrieve the value associated with a particular key in a table + + +Description + +Given a table of space-delimited key/value pairs, +the lookup.key template extracts the value associated +with a particular key. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +xpath.location +Calculate the XPath child-sequence to the current node + + +Description + +The xpath.location template calculates the +absolute path from the root of the tree to the current element node. + + + + + + + + + + / + + + + + + + + + + + + / + + + + + + + + + + + + + +comment-escape-string +Prepare a string for inclusion in an XML comment + + +Description + +The comment-escape-string template returns a string +that has been transformed so that it can safely be output as an XML comment. +Internal occurrences of "--" will be replaced with "- -" and a leading and/or +trailing space will be added to the string, if necessary. + + + + + + + + + + + + + + + + + + + + + + + + + + +comment-escape-string.recursive +Internal function used by comment-escape-string + + +Description + +The comment-escape-string.recursive template is used +by comment-escape-string. + + + + + + + + + + + + + + + + + + + + + + + + + +prepend-pad +Right-pad a string out to a certain length + + +Description + +This function takes string padVar and +pads it out to the string-length length, using +string padChar (a space character by default) +as the padding string (note that padChar can be +a string; it is not limited to just being a single character). + + + This function is a copy of Nate Austin's + prepend-pad function in the Padding + Content section of Dave Pawson's XSLT + FAQ. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +trim.text +Trim leading and trailing whitespace from a text node + + +Description + +Given a text node, this function trims leading and trailing +whitespace from it and returns the trimmed contents. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +str.tokenize.keep.delimiters +Tokenize a string while preserving any delimiters + + +Description + +Based on the occurrence of one or more delimiter characters, +this function breaks a string into a list of tokens and delimiters, +marking up each of the tokens with a token element +and preserving the delimiters as text nodes between the tokens. + + + This function is a very slightly modified version of a + function from the EXSLT + site. The original is available at: + +
                  + + The str.tokenize.keep.delimiters function + differs only in that it preserves the delimiters instead of + discarding them.                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   +                   + + + + + + apply-string-subst-map + Apply a string-substitution map + + + Description + + This function applies a "string substitution" map. Use it when + you want to do multiple string substitutions on the same target + content. It reads in two things: content, the + content on which to perform the substitution, and + map.contents, a node set of + elements (the names of the elements don't matter), with each element + having the following attributes: + + + oldstring, a string to + be replaced + + + newstring, a string with + which to replace oldstring + + + The function uses map.contents to + do substitution on content, and then + returns the modified contents. + + + This function is a very slightly modified version of Jeni + Tennison's replace_strings function in the + multiple string replacements section of Dave Pawson's + XSLT + FAQ. + + The apply-string-subst-map function is + essentially the same function as the + apply-character-map function; the only + difference is that in the map that + apply-string-subst-map expects, oldstring and newstring attributes are used instead of + character and string attributes. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + apply-character-map + Apply an XSLT character map + + + Description + + This function applies an XSLT character + map; that is, it cause certain individual characters to be + substituted with strings of one or more characters. It is useful + mainly for replacing multiple "special" chararacters or symbols in + the same target content. It reads in two things: + content, the content on which to perform the + substitution, and map.contents, a + node set of elements (the names of the elements don't matter), with + each element having the following attributes: + + + character, a character to + be replaced + + + string, a string with + which to replace character + + + This function uses map.contents to + do substitution on content, and then returns + the modified contents. + + + This function is a very slightly modified version of Jeni + Tennison's replace_strings function in the + multiple string replacements section of Dave Pawson's + XSLT + FAQ. + + The apply-string-subst-map function is + essentially the same function as the + apply-character-map function; the only + difference is that in the map that + apply-string-subst-map expects, oldstring and newstring attributes are used instead of + character and string attributes. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +read-character-map +Read in all or part of an XSLT character map + + +Description + +The XSLT 2.0 specification describes character +maps and explains how they may be used to allow a specific +character appearing in a text or attribute node in a final results +tree to be substituted by a specified string of characters during +serialization. The read-character-map function +provides a means for reading and using character maps with XSLT +1.0-based tools. + +It reads the character-map contents from +uri (in full or in part, depending on the value +of the use.subset parameter), then passes those +contents to the apply-character-map function, +along with content, the data on which to +perform the character substition. + +Using the character map "in part" means that it uses only those +output-character elements that match the XPATH expression +given in the value of the subset.profile +parameter. The current implementation of that capability here relies +on the evaluate extension XSLT function. + + + + + + + + + + + + + + + + + + + + +Error: To process character-map subsets, you must use an XSLT engine +that supports the evaluate() XSLT extension function. Your XSLT engine +does not support it. + + + + + + + + + + + + + + +                   + + + + +Relative URI Functions + +Introduction + +These functions manipulate relative URI references. + +The following assumptions must hold true: + + + +All URIs are relative. + + +No URI contains the ../ sequence +which would effectively move up the hierarchy. + + + +If these assumptions do not hold, the results are unpredictable. + + + + + + + +count.uri.path.depth +Count the number of path components in a relative URI + + +Description + +This function counts the number of path components in a relative URI. + + + + + + + + + + + + + + + + + + + + + + + + + + + +trim.common.uri.paths +Trim common leading path components from a relative URI + + +Description + +This function trims common leading path components from a relative URI. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +The Stylesheet + +The lib.xsl stylesheet is just a wrapper +around these functions. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/manpages/ChangeLog.20020917 b/src/documentation/docbook-xsl/manpages/ChangeLog.20020917 new file mode 100644 index 0000000000..c170cc0560 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/ChangeLog.20020917 @@ -0,0 +1,195 @@ +Note: This changelog is a record of descriptions of all changes +made to the DocBook XSL manpages stylesheets during the time when +they were maintained in their original home in the +[cvs]/docbook/contrib/xsl/db2man area of the DocBook Project +source-code repository at Sourceforge; that is, from October 2001 +(when they were contributed to the project by Martijn van Beers) +until September 2002 (when they were moved to the +[cvs]/docbook/xsl/manpages area and became a standard part of all +subsequent DocBook XSL Stylesheets releases). + +2002-09-17 Norman Walsh + + * README, db2man.xsl, lists.xsl, sect23.xsl, synop.xsl, xref.xsl: + Moved to docbook/xsl/manpages + + * db2man.xsl, synop.xsl: Patch from Joe Orton + +2002-06-16 + + * db2man.xsl: commit patch sent by Joe Orton: + + This patch adds support for using the productname, date and title out of + a if one is present, rather than having to add each of + these individually for every refentry. + + * db2man.xsl: Tim Waugh sent: + + This patch normalizes space in each refname before displaying it in + the name section. + +2002-05-21 + + * xref.xsl: from Joe Orton: + this patch allows cross-referencing to a specific refname. I + need this since I'm documenting several different (but related) + functions per refentry, and want to cross-reference them individually, + rather than just by the title used for the refentry as a whole. + +2002-05-17 + + * lists.xsl: apply glosslist support patch from twaugh + +2002-05-15 + + * db2man.xsl: slightly sanitize the filenames we generate. again from twaugh + + * db2man.xsl: Apply twaugh's fix for making the entity transform stuff work + +2002-05-14 + + * db2man.xsl: generalize the tip template for all admonitions + (caution,important,note,tip,warning) + + * db2man.xsl: Apply Joe Orton's patch, modified to be indented. Also show "Tip" + in the title. + + so if foo, you get + Tip: foo + + * synop.xsl: rewrote funcprototype. It used to convert all its children to a single + string and the split it up again through recursion. Now has a nice + foreach loop for the paramdefs, which seems much cleaner than throwing + everything in a big string before processing it. + +2002-05-10 + + * db2man.xsl: add support for simpara + + * db2man.xsl, lists.xsl: fix refsect2 titles + + * synop.xsl: also from twaugh: + + I found some input that goes wrong with the synop.xsl we have in CVS: + + + -o FILE + --output=FILE + + + It gets rendered as (with *bold* and _italic_): + + [*-o FILE* | *--output=FILE*] + + The desired markup should look like: + The following macro does the trick: + + [\fB-o \fIFILE\fR\fR | \fB--output=\fIFILE\fR\fR] + + The trouble is that the named template 'bold' uses value-of, and so + strips of its significance. + + Another thing I found is that the arg/replaceable template is + superfluous altogether: db2man.xsl has a 'replaceable' template which + does the same thing. + + Here is a patch to make those two modifications. + + NOTE TO SELF: must try to fix bold template so we can use it everywhere + +2002-05-09 + + * db2man.xsl: oops, removed too much + + * db2man.xsl: remove stuff that's apparently left-over from sect23.xsl + + * db2man.xsl, lists.xsl, synop.xsl: batch of patches from twaugh: + * This patch (based on one from Jirka Kosek) adds support for + block-level elements inside s---s for example, or lists. + * This patch replaces entities (like '舒') with sensible + characters or groups of characters. + * This patch adds support for sbr. + * This patch normalizes spaces in varlistentry terms. + * This patch normalizes spaces in terminal varlistentry terms. + * This patch allows variable lists to be nested (once). + * This patch prevents variable list item paragraphs from merging into + one another. + * This patch improves the rendering of itemized lists, and adds support + for ordered lists and procedures. + * This patch makes some small adjustments to group/arg: don't put extra + spaces in where they aren't needed, and normalize the space of $arg. + * This patch makes adjustments to cmdsynopsis elements. In particular, + they can now be wrapped if no is provided. + * This patch adds funcsynopsis//* support. Again, wrapping is done + automatically. + + * synop.xsl: make synopsises work for --arg=foo s too + + * synop.xsl: remove unneccesary adding of whitespace for arg/replaceable + +2002-05-01 + + * db2man.xsl: This patch adds support for multiple refnames. + + (another twaugh patch) + + * db2man.xsl: modified ulink patch from twaugh. Be nice to content-less ulinks. But we + don't accomodate silly people who don't understand ulink and put the + url as the content too. + + * db2man.xsl, synop.xsl: db2man.xsl: + * temporarily add some params that chunker.xsl needs + * fix bold/italic templates + * update calls to bold/italic templates for new syntax + synop.xsl: + * add support for synopfragment + * update calls to bold/italic templates for new syntax + +2002-04-30 + + * db2man.xsl: Add twaug's patch for xref support + + * db2man.xsl: This patch adds support for: + + - Multiple authors. + - A (single) man page editor. + + (another patch from twaugh) + + * db2man.xsl: more twaugh patches: + - Use refentrytitle, not refname[1], for title. + - Upper-case it. + - Use date, productname, and title. + - Pick up author from main document if not contained in refentry. + - Use refname[1] for man page filename, not refentrytitle. + + * db2man.xsl: add varname support + + * db2man.xsl: This patch makes userinput (an inline element) have inline formatting. + + * db2man.xsl: This patch adds support for the top-level document being something + other than an article. + + It also emits a helpful warning if no refentry elements are found. + + * db2man.xsl: next twaugh patch: + Instead of writing to stdout, create a file for each + refentry. Plus, for bonus points, a file for each additional refname + within that entry (pointing to the main page). + + * db2man.xsl: Add named templates for bold-ifying and italicizing stuff. Inspired + by yet another twaugh patch + + * db2man.xsl, lists.xsl, sect23.xsl: consistently use instead of a newline + + * db2man.xsl, synop.xsl: * add support for informalexample, screen, errorcode, constant, type, + quote, programlisting and citerefentry + * use the 'bold' and 'italic' named templates + + * xref.xsl: New file. + +2001-12-01 Norman Walsh + + * README, db2man.xsl, lists.xsl, sect23.xsl, synop.xsl: + New file. + diff --git a/src/documentation/docbook-xsl/manpages/README b/src/documentation/docbook-xsl/manpages/README new file mode 100644 index 0000000000..9d210ba4a5 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/README @@ -0,0 +1,73 @@ +$Id: README,v 1.3 2005/06/07 09:34:13 xmldoc Exp $ + +----------------------------------------------------------------- +Notes +----------------------------------------------------------------- + +Here are some minimal details (contributed by Barry Rountree) +about the behavior of the manpages stylesheets. + + The first found is used to create the + file name of the man page. + + The contents of are converted to + ALL CAPS and used, with , to decorate the + bottom right and top corners of the page. + + Any is not used in man-page output. + + In order to document two or more items using the + same page, add additional refnames to . + Each addtiona. refname will generate a small file + that points to (via the magic of *roff) + + man[manvolnum]/[primaryRefname].gz + +More detailed how-to information about processing DocBook XML +documents for man-page output will be available in the future. +Somewhere. Written by someone... + +----------------------------------------------------------------- +A short history of the DocBook manpages stylesheets +----------------------------------------------------------------- + +October 2001 - September 2002: "The Silver Age" + Martijn van Beers contributes XSL + stylesheets[1] for converting DocBook documents to *roff man pages, + and maintains them in the [cvs]/docbook/contrib/xsl/db2man area + of the project source-code repository, with frequent application + of patches from Tim Waugh . + + [1] http://sourceforge.net/tracker/download.php?group_id=21935&atid=373749&file_id=11659&aid=468779 + http://docbook.sourceforge.net/archive/db2man.tar.gz + +September 2002 - March 2003: "The Joe Orton Era" + The man-pages stylesheets are moved to [cvs]/docbook/xsl/manpages + and become a standard part of all subsequent DocBook XSL + Stylesheets releases. Joe Orton + takes over manpages maintenance; more patches from Tim Waugh. + +March 2003 - May 2005: "Tim Waugh At the Helm" + Tim Waugh, eventually realizing that the possibility exists to + commit changes to to a source-code repository *directly*, joins + the project and takes over manpages maintenance, making a lot of + fixes and refinements. + +May 2005 - present: "Journey Into Mystery" + A sense of apprehension and uncertainty sets in as the + least-skilled and most frequently inebriated member of the + project takes over manpages maintenance. + +----------------------------------------------------------------- +Original circa 2001 README contributed by Martijn van Beers +----------------------------------------------------------------- + +README for db2man by Martijn van Beers (lotr@users.sourceforge.net) + +I've been working on some stylesheets to convert s to man +format. I thought I'd submit what I have for inclusion in the +docbook-xsl package. + +See also: + + http://sourceforge.net/tracker/index.php?func=detail&aid=468779&group_id=21935&atid=373749 diff --git a/src/documentation/docbook-xsl/manpages/block.xsl b/src/documentation/docbook-xsl/manpages/block.xsl new file mode 100644 index 0000000000..158ed50af3 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/block.xsl @@ -0,0 +1,219 @@ + + + + + + + + + + + + + + + + + .PP + + + + . + + + + + + + + + + + .PP + + + + + + + + + + + .sp + + + + + + + + + + + Yes + + + + + + + + + + + + + + + + + .sp + + + + + .RS + + + + + + + + + + + + + + + + + + + + + + + + + + .ft + + + .nf + + + .fi + .ft + + + + .nf + + + .fi + + + + + .RE + + + + + .sp + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + before + + + + + + + .PP + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/manpages/charmap.groff.xsl b/src/documentation/docbook-xsl/manpages/charmap.groff.xsl new file mode 100644 index 0000000000..cc3665d6ae --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/charmap.groff.xsl @@ -0,0 +1,5985 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/manpages/docbook.xsl b/src/documentation/docbook-xsl/manpages/docbook.xsl new file mode 100644 index 0000000000..f60ff33205 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/docbook.xsl @@ -0,0 +1,265 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Note: Stripping NS from DocBook 5/NG document. + + + + Note: Processing stripped document. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + MAN.MANIFEST + + + + + + + + + + + + + + + + + + + + + + + Note: No refentry elements found in " + + + + + + ... + + + + + + + " + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/manpages/html-synop.xsl b/src/documentation/docbook-xsl/manpages/html-synop.xsl new file mode 100644 index 0000000000..ccd066ee8d --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/html-synop.xsl @@ -0,0 +1,1475 @@ + + + + + + + + + + + +
                  +

                  + + +

                  +
                  +                   + + + +. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +. + + + + + + + + + + + + + ( + + ) + +   + + + + + + + + + + + + +

                  + + ( + + ) + + + +

                  +                   + + + + + + + .sp +.nf +
                  +.fi + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

                  + + + +. + + + +

                  +                   + + + + + ( + + + + + + + + + + + + + + + + ) + ; + + + + ... + ) + ; + + + + + + + , + + + ) + ; + + + + + + + + + + + + + + + + + + + + + +. + + + + + ; + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + +
                  + +
                   
                  + + + + padding-bottom: 1em + + +
                  +                   +                   + + + + + ( + + + + + + + + + + + + + + + + + ) + ; + +   + + + + + ... + ) + ; + +   + + + + + + + + , + + + ) + ; + + + +   + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + + + + + + + + + +   + + + + + + ; + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + ; + + + + + + +

                  + +

                  +                   + + + + + ( + + + + + + + + + + + + + + + + void) + ; + + + + ... + ) + ; + + + + + + + , + + + ) + ; + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + padding-bottom: 1em + + + + + + + + + + + +
                  + +
                   
                  +                   + + + + + ( + + + + + + + + + + + + + + + + + void) + ; + +   + + + + + ... + ) + ; + +   + + + + + + + +   + + + + + + , + + + ) + ; + + + + + + + +   + + + + + + + , + + + ) + ; + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + +java + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unrecognized language on + + : + + + + + + + + + + + + +. + + + + + + + + + .sp +.nf +
                  +    
+    
+       extends
+      
+      
+        
+.
+
+	    
+      
+    
+    
+      implements
+      
+      
+        
+.
+
+	    
+      
+    
+    
+      throws
+      
+    
+     {
+    
+.
+
+    
+    }
+
                  +.fi + +                   + + + + + + + + + , + + + + + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + 0 + + , + +. + + + +   + + + + + + + + + + + + + + + + + + + + + +    + + + + + + + + + + + + + + ( + + + + ) + + +. + +     throws  + + + + + + + ; + + + + + + + + .sp +.nf +
                  +    
+    
+      : 
+      
+      
+        
+.
+
+	    
+      
+    
+    
+       implements
+      
+      
+        
+.
+
+	    
+      
+    
+    
+       throws
+      
+    
+     {
+    
+.
+
+    
+    }
+
                  +.fi + +                   + + + + + + + + , + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + +    + + + + + + + + + + ( + + ) + + +. + +     throws  + + + + + + + ; + + + + + + + + .sp +.nf +
                  +    interface 
+    
+    
+      : 
+      
+      
+        
+.
+
+	    
+      
+    
+    
+       implements
+      
+      
+        
+.
+
+	    
+      
+    
+    
+       throws
+      
+    
+     {
+    
+.
+
+    
+    }
+
                  +.fi + +                   + + + + + + + + , + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + +    + + + + + + + + + + ( + + ) + + +. + +     raises( + + ) + + + + + + ; + + + + + + + + .sp +.nf +
                  +    package 
+    
+    ;
+    
+.
+
+
+    
+      @ISA = (
+      
+      );
+      
+.
+
+    
+
+    
+
                  +.fi + +                   + + + + + + + + , + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + sub + + + { ... }; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   \ No newline at end of file diff --git a/src/documentation/docbook-xsl/manpages/html2roff.xsl b/src/documentation/docbook-xsl/manpages/html2roff.xsl new file mode 100644 index 0000000000..4422be89b9 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/html2roff.xsl @@ -0,0 +1,51 @@ + + + + + + + + + + + + + + + + + + + + + + + + . + + + + .sp + .nf + + + + .fi + + + diff --git a/src/documentation/docbook-xsl/manpages/info.xsl b/src/documentation/docbook-xsl/manpages/info.xsl new file mode 100644 index 0000000000..575ebd5143 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/info.xsl @@ -0,0 +1,508 @@ + + + + + + + + + + + + + + + + \n(zqu + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + .SH " + + + + + + + + + + + + + + + + + + + + Author + + + Authors + + + + + + + + + + + " + + + + .PP + + + + + + + + + + + + + + + + + + .PP + + + + + + + + + + .PP + + + + + + + + + + .PP + + + + + + + + + + + .sp -1n + .IP "" + + + + + + + + + . + + + + + + + + + + + < + + > + + + + + , + + + + + + + + + + + + + + + .br + + + + + + + + + + , + + + + + + + + + + + .br + + + + + + + + + + + + .br + + + + + + + + + + + + + + + + + .sp -1n + .IP "" + + + + + + + + + . + + + .sp -1n + .IP "" + + + + + + + + + . + + + + + + + .sp -1n + .IP "" + + + + + + + + + . + + + + + + + + + + + + + + + + .sp -1n + .IP "" + + + + + + + + + + + + + + + + . + + + + + + + + + + + .sp -1n + .IP "" + + + + + + + + + + + + + + + + + + + .SH " + + + + Copyright + + + + " + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/manpages/inline.xsl b/src/documentation/docbook-xsl/manpages/inline.xsl new file mode 100644 index 0000000000..ec23e676e5 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/inline.xsl @@ -0,0 +1,155 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + + © + + + ® + + + ℠ + + + ™ + + + + + ™ + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/manpages/links.xsl b/src/documentation/docbook-xsl/manpages/links.xsl new file mode 100644 index 0000000000..3f23bcef74 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/links.xsl @@ -0,0 +1,434 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \% + + + + + + + + + + + + + + + + + + + + + + + + + [ + + ]\& + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + .SH " + + + + + + + + + + + + + + + + + " + + + + + + .  + + + + .TP + + + + + + + + + + + + + + + + + + + + + + + + + + \% + + + + + + + + + + + + + + + .br + + + + + + + + + ftn. + + + + + + # + + + + + + [ + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/manpages/lists.xsl b/src/documentation/docbook-xsl/manpages/lists.xsl new file mode 100644 index 0000000000..72e2e3ad12 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/lists.xsl @@ -0,0 +1,369 @@ + + + + + + + + + + + + + + + + \n(zqu + + + + + + + + + + + + + + .sp + + + + + + .PP + + + + + + + + + + + + + .PP + + + .TP + + + + + + + + + + + + + + + + + + + + + + + + + + + .br + + + + + + + + + + .RS + + + + + + + .RE + + + + + + + + + + + + .RS + + + + + + + .RE + + .IP "" + + + + + + + + + + + + + + + + + + • + + + .TP + + + + + + + + + + + + + + .TP + + + + + + + + + + + .PP + + + + .TP + + + + + + + + .sp + .RE + + + + + .RS + + + + + + + .PP + + + + .TP + + + + + + + .RE + + .IP "" + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + .IP "" + + + + + + + + + + + + + + + + + .PP + + + + .\" line length increase to cope w/ tbl weirdness + .ll +(\n(LLu * 62u / 100u) + + .TS + + + + + + l + + . + + + + + + + + + + + + + + .TE + .\" line length decrease back to previous value + .ll -(\n(LLu * 62u / 100u) + + .sp + + + + + + + + + + + + + + + + + + + + + + + + + + + T{ + + + + + T} + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/manpages/other.xsl b/src/documentation/docbook-xsl/manpages/other.xsl new file mode 100644 index 0000000000..87a763e7cb --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/other.xsl @@ -0,0 +1,472 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + .\" Title: + + + .\" Author: + + + + + .\" Generator: DocBook XSL Stylesheets v + + <http://docbook.sf.net/> + + .\" Date: + + + + + + + + .\" Manual: + + + .\" Source: + + + .\" + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + .TH " + + + + + + + + + + + + + " " + + " " + + + + + + + " " + + + + + + + + + + + + " " + + + + + + + + + + + + " + + + + + + + + + + + + + .\" disable hyphenation + .nh + + + + + .\" disable justification + (adjust text to left margin only) + .ad l + + + .\" store initial "default indentation value" + .nr zq \n(IN + .\" adjust default indentation + .nr IN + + + .\" adjust indentation of SS headings + .nr SN \n(IN + + + + + + .\" enable line breaks after slashes + .cflags 4 / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Note: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Note: + (soelim stub) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Note: + (manifest file) + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/manpages/param.ent b/src/documentation/docbook-xsl/manpages/param.ent new file mode 100644 index 0000000000..3c7fc8ab3d --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/param.ent @@ -0,0 +1,56 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/manpages/param.xml b/src/documentation/docbook-xsl/manpages/param.xml new file mode 100644 index 0000000000..e5524aad41 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/param.xml @@ -0,0 +1,2853 @@ + + + + + + Manpages Parameter Reference + + $Id: param.xweb,v 1.24 2006/04/26 04:38:28 xmldoc Exp $ + + + The DocBook Project + + + 2005 + The DocBook Project + + + + + Introduction + + This is reference documentation for all user-configurable + parameters in the DocBook XSL "manpages" stylesheets (for + generating groff/nroff output). + + + + + Hyphenation, justification, and breaking + + +man.hyphenate +boolean + + +man.hyphenate +Enable hyphenation? + + + + +<xsl:param name="man.hyphenate">0</xsl:param> + + +Description + +If non-zero, hyphenation is enabled. + + +The default value for this parameter is zero because groff is +not particularly smart about how it does hyphenation; it can end up +hyphenating a lot of things that you don't want hyphenated. To +mitigate that, the default behavior of the stylesheets is to suppress +hyphenation of computer inlines, filenames, and URLs. (You can +override the default behavior by setting non-zero values for the +man.hyphenate.urls, +man.hyphenate.filenames, and +man.hyphenate.computer.inlines parameters.) But +the best way is still to just globally disable hyphenation, as the +stylesheets do by default. + +The only good reason to enabled hyphenation is if you have also +enabled justification (which is disabled by default). The reason is +that justified text can look very bad unless you also hyphenate it; to +quote the Hypenation node from the groff info page: + +
                  + Since the odds are not great for finding a set of + words, for every output line, which fit nicely on a line without + inserting excessive amounts of space between words, 'gtroff' + hyphenates words so that it can justify lines without inserting too + much space between words. +
                  + +So, if you set a non-zero value for the +man.justify parameter (to enable +justification), then you should probably also set a non-zero value for +man.hyphenate (to enable hyphenation).                   +                   + + +                   +                   + + + +man.hyphenate.urls +boolean + + +man.hyphenate.urls +Hyphenate URLs? + + + + +<xsl:param name="man.hyphenate.urls">0</xsl:param> + + +Description + +If zero (the default), hyphenation is suppressed for output of +the ulink url attribute. + + + If hyphenation is already turned off globally (that is, if + man.hyphenate is zero, setting + man.hyphenate.urls is not necessary. + + +If man.hyphenate.urls is non-zero, URLs +will not be treated specially and are subject to hyphenation just like +other words. + + + If you are thinking about setting a non-zero value for + man.hyphenate.urls in order to make long + URLs break across lines, you'd probably be better off + experimenting with setting the + man.break.after.slash parameter first. That + will cause long URLs to be broken after slashes. + + + + + + + +man.hyphenate.filenames +boolean + + +man.hyphenate.filenames +Hyphenate filenames? + + + + +<xsl:param name="man.hyphenate.filenames">0</xsl:param> + + +Description + +If zero (the default), hyphenation is suppressed for +filename output. + + + If hyphenation is already turned off globally (that is, if + man.hyphenate is zero, setting + man.hyphenate.filenames is not + necessary. + + +If man.hyphenate.filenames is non-zero, +filenames will not be treated specially and are subject to hyphenation +just like other words. + + + If you are thinking about setting a non-zero value for + man.hyphenate.filenames in order to make long + filenames/pathnames break across lines, you'd probably be better off + experimenting with setting the + man.break.after.slash parameter first. That + will cause long pathnames to be broken after slashes. + + + + + + + +man.hyphenate.computer.inlines +boolean + + +man.hyphenate.computer.inlines +Hyphenate computer inlines? + + + + +<xsl:param name="man.hyphenate.computer.inlines">0</xsl:param> + + +Description + +If zero (the default), hyphenation is suppressed for +computer inlines such as environment variables, +constants, etc. This parameter current affects output of the following +elements: + + + classname + constant + envar + errorcode + option + replaceable + userinput + type + varname + + + + + If hyphenation is already turned off globally (that is, if + man.hyphenate is zero, setting the + man.hyphenate.computer.inlines is not + necessary. + + +If man.hyphenate.computer.inlines is +non-zero, computer inlines will not be treated specially and will be +hyphenated like other words when needed. + + + + + + +man.justify +boolean + + +man.justify +Justify text to both right and left margins? + + + + +<xsl:param name="man.justify">0</xsl:param> + + +Description + +If non-zero, text is justified to both the right and left +margins (or, in roff terminology, "adjusted and filled" to both the +right and left margins). If zero (the default), text is adjusted to +the left margin only -- producing what is traditionally called +"ragged-right" text. + + +The default value for this parameter is zero because justified +text looks good only when it is also hyphenated. Without hyphenation, +excessive amounts of space often end up getting between words, in +order to "pad" lines out to align on the right margin. + +The problem is that groff is not particularly smart about how it +does hyphenation; it can end up hyphenating a lot of things that you +don't want hyphenated. So, disabling both justification and +hyphenation ensures that hyphens won't get inserted where you don't +want to them, and you don't end up with lines containing excessive +amounts of space between words. + +However, if do you decide to set a non-zero value for the +man.justify parameter (to enable +justification), then you should probably also set a non-zero value for +man.hyphenate (to enable hyphenation). + +Yes, these default settings run counter to how most existing man +pages are formatted. But there are some notable exceptions, such as +the perl man pages. + + + + + + +man.break.after.slash +boolean + + +man.break.after.slash +Enable line-breaking after slashes? + + + + +<xsl:param name="man.break.after.slash">0</xsl:param> + + +Description + +If non-zero, line-breaking after slashes is enabled. This is +mainly useful for causing long URLs or pathnames/filenames to be +broken up or "wrapped" across lines (though it also has the side +effect of sometimes causing relatively short URLs and pathnames to be +broken up across lines too). + +If zero (the default), line-breaking after slashes is +disabled. In that case, strings containing slashes (for example, URLs +or filenames) are not broken across lines, even if they exceed the +maximum column widith. + + + If you set a non-zero value for this parameter, check your + man-page output carefuly afterwards, in order to make sure that the + setting has not introduced an excessive amount of breaking-up of URLs + or pathnames. If your content contains mostly short URLs or + pathnames, setting a non-zero value for + man.break.after.slash will probably result in + in a significant number of relatively short URLs and pathnames being + broken across lines, which is probably not what you want. + + + + + +                   + + Indentation + + +man.indent.width +Specifies width used for adjusted indents + + + + +<xsl:param name="man.indent.width">3n</xsl:param> + + + +Description +The man.indent.width parameter specifies +the width used for adjusted indents. The value of +man.indent.width is used for indenting of +lists, verbatims, headings, and elsewhere, depending on whether the +values of certain man.indent.* boolean parameters +are non-zero. + +The value of man.indent.width should +include a valid roff measurement unit (for example, +n or u). The default value of +3n specifies a 3-en width; when viewed on a +console, that amounts to the width of three characters. For details +about roff measurment units, see the Measurements +node in the groff info page. + + + + + + +man.indent.refsect +boolean + + +man.indent.refsect +Adjust indentation of refsect* and refsection? + + + + +<xsl:param name="man.indent.refsect" select="0"></xsl:param> + + +Description + +If the value of man.indent.refsect is +non-zero, the width of the left margin for +refsect1, refsect2 and +refsect3 contents and titles (and first-level, +second-level, and third-level nested +refsectioninstances) is adjusted by the value of +the man.indent.width parameter. With +man.indent.width set to its default value of +3n, the main results are that: + + + + contents of refsect1 are output with a + left margin of three characters instead the roff default of seven + or eight characters + + + contents of refsect2 are displayed in + console output with a left margin of six characters instead the of + the roff default of seven characters + + + the contents of refsect3 and nested + refsection instances are adjusted + accordingly. + + + +If instead the value of man.indent.refsect is +zero, no margin adjustment is done for refsect* +output. + + + If your content is primarly comprised of + refsect1 and refsect2 content + (or the refsection equivalent) – with few or + no refsect3 or lower nested sections , you may be + able to “conserve” space in your output by setting + man.indent.refsect to a non-zero value. Doing + so will “squeeze” the left margin in such as way as to provide an + additional four characters of “room” per line in + refsect1 output. That extra room may be useful + if, for example, you have many verbatim sections with long lines in + them. + + + + + + + +man.indent.blurbs +boolean + + +man.indent.blurbs +Adjust indentation of blurbs? + + + + +<xsl:param name="man.indent.blurbs" select="1"></xsl:param> + + +Description + +If the value of man.indent.blurbs is +non-zero, the width of the left margin for +authorblurb, personblurb, and +contrib output is set to the value of the +man.indent.width parameter +(3n by default). If instead the value of +man.indent.blurbs is zero, the built-in roff +default width (7.2n) is used. + + + + + + +man.indent.lists +boolean + + +man.indent.lists +Adjust indentation of lists? + + + + +<xsl:param name="man.indent.lists" select="1"></xsl:param> + + +Description + +If the value of man.indent.lists is +non-zero, the width of the left margin for list items in +itemizedlist, +orderedlist, +variablelist output (and output of some other +lists) is set to the value of the +man.indent.width parameter +(3n by default). If instead the value of +man.indent.lists is zero, the built-in roff +default width (7.2n) is used. + + + + + + +man.indent.verbatims +boolean + + +man.indent.verbatims +Adjust indentation of verbatims? + + + + +<xsl:param name="man.indent.verbatims" select="1"></xsl:param> + + +Description + +If the value of man.indent.verbatims is +non-zero, the width of the left margin for output of verbatim +environments (programlisting, +screen, and so on) is set to the value of the +man.indent.width parameter +(3n by default). If instead the value of +man.indent.verbatims is zero, the built-in roff +default width (7.2n) is used. + + + + + + + Fonts + + +man.font.funcprototype + + + +man.font.funcprototype +Specifies font for funcprototype output + + + + + <xsl:param name="man.font.funcprototype">BI</xsl:param> + + + +Description + +The man.font.funcprototype parameter +specifies the font for funcprototype output. It +should be a valid roff font name, such as BI or +B. + + + + + + +man.font.funcsynopsisinfo + + + +man.font.funcsynopsisinfo +Specifies font for funcsynopsisinfo output + + + + + <xsl:param name="man.font.funcsynopsisinfo">B</xsl:param> + + + +Description + +The man.font.funcsynopsisinfo parameter +specifies the font for funcsynopsisinfo output. It +should be a valid roff font name, such as B or +I. + + + + + + +man.font.table.headings + + + +man.font.table.headings +Specifies font for table headings + + + + + <xsl:param name="man.font.table.headings">B</xsl:param> + + + +Description + +The man.font.table.headings parameter +specifies the font for table headings. It should be +a valid roff font, such as B or +I. + + + + + + +man.font.table.title + + + +man.font.table.title +Specifies font for table headings + + + + + <xsl:param name="man.font.table.title">B</xsl:param> + + + +Description + +The man.font.table.title parameter +specifies the font for table titles. It should be +a valid roff font, such as B or +I. + + + + + + + Link handling + + +man.links.are.numbered +boolean + + +man.links.are.numbered +Number links? + + + + +<xsl:param name="man.links.are.numbered">1</xsl:param> + + + +Description + +If the value of man.links.are.numbered is +non-zero (the default), then for each non-empty +A non-empty link is one that looks like +this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/">manpages</ulink> +an empty link is on that looks like this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/"/> + link: + + + + a number (in square brackets) is displayed inline before the + rendered contents of the link + + + the URL for the link is included in a numbered list of links + that is generated at the end of each man page; the number for each + links corresponds to the inline number for the link with which it is + associated + + +The default heading for the list of links is +REFERENCES. To output a different heading, set a value +for the man.links.section.heading +parameter. + + + The link list is also displayed (but without numbers) if the + value of man.links.list.enabled is + non-zero. + + + +If the value of man.links.are.numbered is +zero, numbering of links is suppressed; only the link contents are +displayed inline. + + If you are thinking about disabling link numbering by setting + the value of man.links.are.numbered to zero, + before you do so, first take some time to carefully + consider the information needs and experiences of your users. The + square-bracketed numbers displayed inline before links may seem + obstrusive and aesthetically unpleasingYou might + think that it would be better to just display URLs for non-empty + links inline, after their content, rather than displaying + square-bracketed numbers all over the place. But it's not better. In + fact, it's not even practical, because many (most) URLs for links + are too long to be displayed inline. They end up overflowing the + right margin. You can set a non-zero value for + man.break.after.slash parameter to deal with + that, but it could be argued that what you end up with is at least + as ugly, and definitely more obstrusive, then having short + square-bracketed numbers displayed inline., + + but in a text-only output format, the numbered-links/link-listing + mechanism is the only practical way of associating inline text with + URLs. + + Also, users of text based browsers such as + lynx will already be accustomed to seeing inline + numbers for links. And various "man to html" applications, such as + the widely used man2html (VH-Man2html) + application, can automatically turn URLs into "real" HTML hyperlinks + in output. So leaving man.links.are.numbered + at its default (non-zero) value ensures that no link information is + lost in your man-page output. It just gets + rearranged. + + +The handling of empty links is not affected by this +parameter. Empty links are handled simply by displaying their URLs +inline. Empty links are never auto-numbered. + + Currently, this parameter only affects output for + ulinks. + + +If you disable link numbering, you should probably also set +man.links.are.underlined to zero (to disable +link underlining). + + + + + +man.links.are.underlined +boolean + + +man.links.are.underlined +Underline links? + + + + +<xsl:param name="man.links.are.underlined">1</xsl:param> + + + +Description + +If the value of man.links.are.underlined +is non-zero (the default), then the contents of links are rendered +with an underline. + +If the value of man.links.are.underlined +is zero, links are displayed without any underlining. + + + Currently, this parameter only affects output for + ulinks. + + +If you set man.links.are.numbered and/or +man.links.list.enabled to zero (disabled), then +you should probably also set +man.links.are.underlined to zero. But if +man.links.are.numbered is non-zero (enabled), +you should probably set a non-zero value for +man.links.are.underlined alsoIf the main purpose of underlining of links in most output +formats it to indicate that the underlined text is +clickable, given that links rendered in man pages are +not real hyperlinks that users can click on, it might +seem like there is never a good reason to have link contents +underlined in man output. In fact, if you suppress the +display of inline link references (by setting +man.links.are.numbered to zero), there is no +good reason to have links underlined. However, if +man.links.are.numbered is non-zero, having +links underlined may (arguably) serve a purpose: It provides +context information about exactly what part of the text +is being annotated by the link. Depending on how you +use mark up your content, that context information may or may not have +value.. + + + + + +man.links.list.enabled +boolean + + +man.links.list.enabled +Display list of links at end of man page? + + + + +<xsl:param name="man.links.list.enabled">1</xsl:param> + + + +Description + +If the value of man.links.list.enabled is +non-zero (the default), then a list of links is added to the end of +the output man page. + +If the value of man.links.list.enabled is +zero, the list is suppressed -- unless link numbering is enabled (that +is, if man.links.are.numbered is non-zero), in +which case, that setting overrides the +man.links.list.enabled setting, and the link +list is still displayed. The reason is that link numbering only makes +sense if a (numbered) list of links is also generated. + + + Various man to html applications, such as the + widely used man2html (VH-Man2html) + application, can automatically turn URLs into real + HTML hyperlinks in output. So leaving + man.links.list.enabled at its default + (non-zero) value ensures that no link URLs are lost in your man-page + output. They just get rearranged. So if you are + thinking about disabling link listing by setting the value of + man.links.list.enabled to zero, before you do + so, first take some time to carefully consider the information needs + and experiences of your users. The URLs are useful information even + if they aren't real (clickable) hyperlinks. + + +To turn off numbering of links in the list, set +man.links.are.numbered to zero. The list will +still be displayed; it will just be displayed without the +numbersIt can still make sense to have +the list of links displayed even if you have link numbering turned +off. In that case, your list of links basically becomes a list +of references without any association with specific text in +your document. This is probably the best option if you find the inline +link numbering obtrusive. Your users will still have access to the +URLs and link contents, without being annoyed by the presence of +inline link numbering. + + +The default heading for the section in which the list appears is +REFERENCES. To change that, set a non-empty value +for the man.links.list.heading +parameter. + +Along with the URL for each link, the link list includes the contents +of the link. The list thus includes only non-empty + +A non-empty link is one that looks like +this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/">manpages</ulink> +an empty link is on that looks like this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/"/> + links. + +Empty links are never included, and never numbered. They are simply +displayed inline, without any numbering. + +In addition, if there are multiple instances of links in a +refentry that have the same URL, the URL is listed only +once. The contents listed for that link are the contents of the first +link which has that URL. + + + Currently, this parameter only affects output for + ulinks. + + +If you disable link listing, you should probably also set +man.links.are.underlined to zero (to disable +link underlining). + + + + + +man.links.list.heading +string + + +man.links.list.heading +Specifies an alternate name for links list + + + + +<xsl:param name="man.links.list.heading" select="''"></xsl:param> + + + +Description + +If the value of the +man.links.are.numbered parameter and/or the +man.links.list.enabled parameter is non-zero +(the defaults for both are non-zero), a numbered list of URLs is +generated near the end of each man page. The default section heading +for the list of links is the equivalent of the English word +REFERENCES in the current locale. To cause an +alternate heading to be displayed, set a non-empty value for the +man.links.list.heading parameter -- for +example, LINKS. + + + + + + Lists + + +man.segtitle.suppress +boolean + + +man.segtitle.suppress +Suppress display of segtitle contents? + + + + +<xsl:param name="man.segtitle.suppress" select="0"></xsl:param> + + +Description + +If the value of man.segtitle.suppress is +non-zero, then display of segtitle contents is +suppressed in output. + + + + + + +variablelist.term.separator +string + + +variablelist.term.separator +Text to separate terms within a multi-term +varlistentry + + + + +<xsl:param name="variablelist.term.separator">, </xsl:param> + + +Description + +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is placed +after each term except the last. + + + To generate a line break between multiple terms in + a varlistentry, set a non-zero value for the + variablelist.term.break.after parameter. If + you do so, you may also want to set the value of the + variablelist.term.separator parameter to an + empty string (to suppress rendering of the default comma and space + after each term). + + + + + + + +variablelist.term.break.after +boolean + + +variablelist.term.break.after +Generate line break after each term within a +multi-term varlistentry? + + + + +<xsl:param name="variablelist.term.break.after">0</xsl:param> + + +Description + +Set a non-zero value for the +variablelist.term.break.after parameter to +generate a line break between terms in a +multi-term varlistentry. + + +If you set a non-zero value for +variablelist.term.break.after, you may also +want to set the value of the +variablelist.term.separator parameter to an +empty string (to suppress rendering of the default comma and space +after each term). + + + + + + + + Character/string substitution + + +man.charmap.enabled +boolean + + +man.charmap.enabled +Apply character map before final output? + + + + +<xsl:param name="man.charmap.enabled" select="1"></xsl:param> + + + +Description + +If the value of the man.charmap.enabled +parameter is non-zero, a "character map" is used to substitute certain +Unicode symbols and special characters with appropriate roff/groff +equivalents, just before writing each man-page file to the +filesystem. If instead the value of +man.charmap.enabled is zero, Unicode characters +are passed through "as is". + + +Details +For converting certain Unicode symbols and special characters in +UTF-8 or UTF-16 encoded XML source to appropriate groff/roff +equivalents in man-page output, the DocBook XSL Stylesheets +distribution includes a roff character map that is compliant with the XSLT character +map format as detailed in the XSLT 2.0 specification. The map +contains more than 800 character mappings and can be considered the +standard roff character map for the distribution. + +You can use the man.charmap.uri +parameter to specify a URI for the location for an alternate roff +character map to use in place of the standard roff character map +provided in the distribution. + +You can also use a subset of a character map. For details, see +the man.charmap.use.subset and +man.charmap.subset.profile parameters. + + + + + + + +man.charmap.uri +uri + + +man.charmap.uri +URI for custom roff character map + + + + +<xsl:param name="man.charmap.uri" select="''"></xsl:param> + + + +Description + +For converting certain Unicode symbols and special characters in +UTF-8 or UTF-16 encoded XML source to appropriate groff/roff +equivalents in man-page output, the DocBook XSL Stylesheets +distribution includes an XSLT character +map. That character map can be considered the standard roff +character map for the distribution. + +If the value of the man.charmap.uri +parameter is non-empty, that value is used as the URI for the location +for an alternate roff character map to use in place of the standard +roff character map provided in the distribution. + + +Do not set a value for man.charmap.uri +unless you have a custom roff character map that differs from the +standard one provided in the distribution. + + + + + + +man.charmap.use.subset +boolean + + +man.charmap.use.subset +Use subset of character map instead of full map? + + + + +<xsl:param name="man.charmap.use.subset" select="1"></xsl:param> + + + +Description + +If the value of the +man.charmap.use.subset parameter is non-zero, +a subset of the roff character map is used instead of the full roff +character map. The profile of the subset used is specified by the +man.charmap.subset.profile parameter. + + + You may want to experiment with setting a non-zero value of + man.charmap.use.subset, so that the full + character map is used. Depending on which XSLT engine you run, + setting a non-zero value for + man.charmap.use.subset may significantly + increase the time needed to process your documents. Or it may + not. For example, if you set it and run it with xsltproc, it seems + to dramatically increase processing time; on the other hand, if you + set it and run it with Saxon, it does not seem to increase + processing time nearly as much. + + If processing time is not a important concern and/or you can + tolerate the increase in processing time imposed by using the full + character map, set man.charmap.use.subset to + zero. + + + +Details +For converting certain Unicode symbols and special characters in +UTF-8 or UTF-16 encoded XML source to appropriate groff/roff +equivalents in man-page output, the DocBook XSL Stylesheets +distribution includes a roff character map that is compliant with the XSLT character +map format as detailed in the XSLT 2.0 specification. The map +contains more than 800 character mappings and can be considered the +standard roff character map for the distribution. + + +You can use the man.charmap.uri +parameter to specify a URI for the location for an alternate roff +character map to use in place of the standard roff character map +provided in the distribution. + + +Because it is not terrifically efficient to use the standard +800-character character map in full -- and for most (or all) users, +never necessary to use it in full -- the DocBook XSL Stylesheets +support a mechanism for using, within any given character map, a +subset of character mappings instead of the full set. You can use the +man.charmap.subset.profile parameter to tune +the profile of that subset to use. + + + + + + + +man.charmap.subset.profile +string + + +man.charmap.subset.profile +Profile of character map subset + + + + +<xsl:param name="man.charmap.subset.profile"> +@*[local-name() = 'block'] = 'Miscellaneous Technical' or +(@*[local-name() = 'block'] = 'C1 Controls And Latin-1 Supplement (Latin-1 Supplement)' and + @*[local-name() = 'class'] = 'symbols' +) or +(@*[local-name() = 'block'] = 'General Punctuation' and + (@*[local-name() = 'class'] = 'spaces' or + @*[local-name() = 'class'] = 'dashes' or + @*[local-name() = 'class'] = 'quotes' or + @*[local-name() = 'class'] = 'bullets' + ) +) or +@*[local-name() = 'name'] = 'HORIZONTAL ELLIPSIS' or +@*[local-name() = 'name'] = 'WORD JOINER' or +@*[local-name() = 'name'] = 'SERVICE MARK' or +@*[local-name() = 'name'] = 'TRADE MARK SIGN' or +@*[local-name() = 'name'] = 'ZERO WIDTH NO-BREAK SPACE' +</xsl:param> + + + +Description + +If the value of the +man.charmap.use.subset parameter is non-zero, +The character-map subset specified by the +man.charmap.subset.profile parameter is used +instead of the full roff character map. + +The value of man.charmap.subset.profile +is a string representating an XPath expression that matches attribute +names and values for output-character elements in the character map. + +The attributes supported in the standard roff character map included in the distribution are: + + + character + + a raw Unicode character or numeric Unicode + character-entity value (either in decimal or hex); all + characters have this attribute + + + + name + + a standard full/long ISO/Unicode character name (e.g., + "OHM SIGN"); all characters have this attribute + + + + block + + a standard Unicode "block" name (e.g., "General + Punctuation"); all characters have this attribute. For the full + list of Unicode block names supported in the standard roff + character map, see . + + + + class + + a class of characters (e.g., "spaces"). Not all + characters have this attribute; currently, it is used only with + certain characters within the "C1 Controls And Latin-1 + Supplement" and "General Punctuation" blocks. For details, see + . + + + + entity + + an ISO entity name (e.g., "ohm"); not all characters + have this attribute, because not all characters have ISO entity + names; for example, of the 800 or so characters in the standard + roff character map included in the distribution, only around 300 + have ISO entity names. + + + + + string + + a string representating an roff/groff escape-code (with + "@esc@" used in place of the backslash), or a simple ASCII + string; all characters in the roff character map have this + attribute + + + + +The value of man.charmap.subset.profile +is evaluated as an XPath expression at run-time to select a portion of +the roff character map to use. You can tune the subset used by adding +or removing parts. For example, if you need to use a wide range of +mathematical operators in a document, and you want to have them +converted into roff markup properly, you might add the following: + + @*[local-name() = 'block'] ='MathematicalOperators' + +That will cause a additional set of around 67 additional "math" +characters to be converted into roff markup. + + +Depending on which XSLT engine you use, either the EXSLT +dyn:evaluate extension function (for xsltproc or +Xalan) or saxon:evaluate extensio function (for +Saxon) are used to dynamically evaluate the value of +man.charmap.subset.profile at run-time. If you +don't use xsltproc, Saxon, Xalan -- or some other XSLT engine that +supports dyn:evaluate -- you must either set the +value of the man.charmap.use.subset parameter +to zero and process your documents using the full character map +instead, or set the value of the +man.charmap.enabled parameter to zero instead +(so that character-map processing is disabled completely. + + +An alternative to using +man.charmap.subset.profile is to create your +own custom character map, and set the value of +man.charmap.uri to the URI/filename for +that. If you use a custom character map, you will probably want to +include in it just the characters you want to use, and so you will +most likely also want to set the value of +man.charmap.use.subset to zero. +You can create a +custom character map by making a copy of the standard roff character map provided in the distribution, and +then adding to, changing, and/or deleting from that. + + +If you author your DocBook XML source in UTF-8 or UTF-16 +encoding and aren't sure what OSes or environments your man-page +output might end up being viewed on, and not sure what version of +nroff/groff those environments might have, you should be careful about +what Unicode symbols and special characters you use in your source and +what parts you add to the value of +man.charmap.subset.profile. +Many of the escape codes used are specific to groff and using +them may not provide the expected output on an OS or environment that +uses nroff instead of groff. +On the other hand, if you intend for your man-page output to be +viewed only on modern systems (for example, GNU/Linux systems, FreeBSD +systems, or Cygwin environments) that have a good, up-to-date groff, +then you can safely include a wide range of Unicode symbols and +special characters in your UTF-8 or UTF-16 encoded DocBook XML source +and add any of the supported Unicode block names to the value of +man.charmap.subset.profile. + + + +For other details, see the documentation for the +man.charmap.use.subset parameter. + + + Supported Unicode block names and "class" values + + Below is the full list of Unicode block names and "class" + values supported in the standard roff stylesheet provided in the + distribution, along with a description of which codepoints from the + Unicode range corresponding to that block name or block/class + combination are supported. + + + + C1 Controls And Latin-1 Supplement (Latin-1 Supplement) (x00a0 to x00ff) + + class values + + symbols + + + letters + + + + + Latin Extended-A (x0100 to x017f, partial) + + + Spacing Modifier Letters (x02b0 to x02ee, partial) + + + Greek and Coptic (x0370 to x03ff, partial) + + + General Punctuation (x2000 to x206f, partial) + + class values + + spaces + + + dashes + + + quotes + + + daggers + + + bullets + + + leaders + + + primes + + + + + + Superscripts and Subscripts (x2070 to x209f) + + + Currency Symbols (x20a0 to x20b1) + + + Letterlike Symbols (x2100 to x214b) + + + Number Forms (x2150 to x218f) + + + Arrows (x2190 to x21ff, partial) + + + Mathematical Operators (x2200 to x22ff, partial) + + + Control Pictures (x2400 to x243f) + + + Enclosed Alphanumerics (x2460 to x24ff) + + + Geometric Shapes (x25a0 to x25f7, partial) + + + Miscellaneous Symbols (x2600 to x26ff, partial) + + + Dingbats (x2700 to x27be, partial) + + + Alphabetic Presentation Forms (xfb00 to xfb04 only) + + + + + + + + +man.string.subst.map +string + + +man.string.subst.map +Specifies a set of string substitutions + + + + +<xsl:param name="man.string.subst.map"> + <substitution oldstring="\" newstring="\\"></substitution> + <!-- * now, we need to restore single-backslashes in all roff --> + <!-- * requests (because the substitution above doubled them) --> + <substitution oldstring="\\fB" newstring="\fB"></substitution> + <substitution oldstring="\\fI" newstring="\fI"></substitution> + <substitution oldstring="\\fR" newstring="\fR"></substitution> + <substitution oldstring="\\n" newstring="\n"></substitution> + <!-- * requests in .SH sectsions output from Refsect1-level source --> + <!-- * end up getting capitalized... --> + <substitution oldstring="\\FB" newstring="\fB"></substitution> + <substitution oldstring="\\FI" newstring="\fI"></substitution> + <substitution oldstring="\\FR" newstring="\fR"></substitution> + <substitution oldstring="\\%" newstring="\%"></substitution> + <substitution oldstring="\\&" newstring="\&"></substitution> + <substitution oldstring=".\\"" newstring=".\""></substitution> + <!-- * although the groff docs do not make it clear, it appears that --> + <!-- * the only way to get a non-breaking hyphen in roff is to put a --> + <!-- * backslash in front of it; and, unfortunately, groff is not smart --> + <!-- * about where it breaks things (for example, it'll break an --> + <!-- * argument for a command across a line, if that argument contains --> + <!-- * a dash/hyphen); so, we must globally change all hyphens to "\-" --> + <substitution oldstring="-" newstring="\-"></substitution> + <!-- * now, we need to restore single-hypens in all roff requests --> + <!-- * (because the substitution above added backslashes before them) --> + <substitution oldstring=".sp \-" newstring=".sp -"></substitution> + <substitution oldstring=".it 1 an\-trap" newstring=".it 1 an-trap"></substitution> + <substitution oldstring=".nr an\-no\-space\-flag 1" newstring=".nr an-no-space-flag 1"></substitution> + <substitution oldstring=".nr an\-break\-flag 1" newstring=".nr an-break-flag 1"></substitution> + <substitution oldstring=".ll \-" newstring=".ll -"></substitution> + <!-- * squeeze multiple newlines before a roff request --> + <substitution oldstring=" + +." newstring=" +."></substitution> + <!-- * remove any .sp occurences that directly follow a .PP --> + <substitution oldstring=".PP +.sp" newstring=".PP"></substitution> + <!-- * squeeze multiple newlines after start of no-fill (verbatim) env. --> + <substitution oldstring=".nf + +" newstring=".nf +"></substitution> + <!-- * squeeze multiple newlines after REstoring margin --> + <substitution oldstring=".RE + +" newstring=".RE +"></substitution> + <!-- * an apostrophe at the beginning of a line gets interpreted as a --> + <!-- * roff request (groff(7) says it is "the non-breaking control --> + <!-- * character"); so we must add backslash before any apostrophe --> + <!-- * found at the start of a line --> + <substitution oldstring=" +'" newstring=" +\'"></substitution> + <!-- * --> + <!-- * non-breaking space --> + <!-- * --> + <!-- * A no-break space can be written two ways in roff; the difference, --> + <!-- * according to the "Page Motions" node in the groff info page, ixsl: --> + <!-- * --> + <!-- * "\ " = --> + <!-- * An unbreakable and unpaddable (i.e. not expanded during filling) --> + <!-- * space. --> + <!-- * --> + <!-- * "\~" = --> + <!-- * An unbreakable space that stretches like a normal --> + <!-- * inter-word space when a line is adjusted." --> + <!-- * --> + <!-- * Unfortunately, roff seems to do some weird things with long --> + <!-- * lines that only have words separated by "\~" spaces, so it's --> + <!-- * safer just to stick with the "\ " space --> + <substitution oldstring=" " newstring="\ "></substitution> + <!-- * x2008 is a "punctuation space"; we must replace it here because, --> + <!-- * for certain reasons, the stylesheets add it before and after --> + <!-- * every Parameter in Funcprototype output --> + <substitution oldstring=" " newstring=" "></substitution> + <substitution oldstring="⌂" newstring=" "></substitution> + <!-- * --> + <!-- * Now deal with some other characters that are added by the --> + <!-- * stylesheets during processing. --> + <!-- * --> + <!-- * bullet --> + <substitution oldstring="•" newstring="\(bu"></substitution> + <!-- * left double quote --> + <substitution oldstring="“" newstring="\(lq"></substitution> + <!-- * right double quote --> + <substitution oldstring="”" newstring="\(rq"></substitution> + <!-- * left single quote --> + <substitution oldstring="‘" newstring="\(oq"></substitution> + <!-- * right single quote --> + <substitution oldstring="’" newstring="\(cq"></substitution> + <!-- * copyright sign --> + <substitution oldstring="©" newstring="\(co"></substitution> + <!-- * registered sign --> + <substitution oldstring="®" newstring="\(rg"></substitution> + <!-- * servicemark... --> + <!-- * There is no groff equivalent for it. --> + <substitution oldstring="℠" newstring="(SM)"></substitution> + <!-- * trademark... --> + <!-- * We don't do "\(tm" because for console output, --> + <!-- * groff just renders that as "tm"; that is: --> + <!-- * --> + <!-- * Product&#x2122; -> Producttm --> + <!-- * --> + <!-- * So we just make it to "(TM)" instead; thus: --> + <!-- * --> + <!-- * Product&#x2122; -> Product(TM) --> + <substitution oldstring="™" newstring="(TM)"></substitution> +</xsl:param> + + + +Description + +The man.string.subst.map parameter +contains a map that specifies a set of +string substitutions to perform over the entire roff source for each +man page, either just before generating final man-page output (that +is, before writing man-page files to disk) or, if the value of the +man.charmap.enabled parameter is non-zero, +before applying the roff character map. + +You can use man.string.subst.map as a +"lightweight" character map to perform "essential" substitutions -- +that is, substitutions that are always performed, +even if the value of the man.charmap.enabled +parameter is zero. For example, you can use it to replace quotation +marks or other special characters that are generated by the DocBook +XSL stylesheets for a particular locale setting (as opposed to those +characters that are actually in source XML documents), or to replace +any special characters that may be automatically generated by a +particular customization of the DocBook XSL stylesheets. + + + Do you not change value of the + man.string.subst.map parameter unless + you are sure what you are doing. If you remove any of the default + mappings, you are likely to end up with broken output. And be very + careful about adding anything to it. Because it is used for doing + string substitution over the entire roff source of each man page, it + causes target strings to be replaced in roff requests and escapes, + not just in the visible contents. + + In particular, do not attempt to add a mapping for the + dot/period character. Doing so will break your output. For an + explanation, see . + + + + + Contents of the substitution map + The string-substitution map contains one or more substitution elements, each of which has two attributes: + + + oldstring + + string to replace + + + + newstring + + string with which to replace oldstring + + + + It may also include XML comments (that is, delimited with + "<!--" and "-->"). + + + + + About adding backslashes before dots + The stylesheets do not add backslashes before + periods/dots. One reason is that, because string substitution is + performed over the entire roff source of each man page, it would be + complicated to replace dots in visible contents without also causing + them to be replaced in roff requests and escapes; for example, + without causing, say, the .TH roff macro to be + replaced with \.TH. Additionally, backslashes in + front of periods/dots are needed only in the very rare case where a + period is the very first character in a line, without any space in + front of it. A better way to deal with that rare case is to add a + zero-width space in front of the offending dot(s) in your + source. + + + + + + + + Refentry metadata gathering + + +refentry.meta.get.quietly + + + +refentry.meta.get.quietly +Suppress notes and warnings when gathering refentry metadata? + + + + +<xsl:param name="refentry.meta.get.quietly" select="0"></xsl:param> + + + +Description + +If zero (the default), notes and warnings about “missing” markup +are generated during gathering of refentry metadata. If non-zero, the +metadata is gathered “quietly” -- that is, the notes and warnings are +suppressed. + + + If you are processing a large amount of refentry + content, you may be able to speed up processing significantly by + setting a non-zero value for + refentry.meta.get.quietly. + + + + + + + +refentry.date.profile +string + + +refentry.date.profile +Specifies profile for refentry "date" data + + + + +<xsl:param name="refentry.date.profile"> + (($info[//date])[last()]/date)[1]| + (($info[//pubdate])[last()]/pubdate)[1] +</xsl:param> + + + +Description + +The value of refentry.date.profile is a +string representing an XPath expression. It is evaluated at run-time +and used only if refentry.date.profile.enabled +is non-zero. Otherwise, the refentry metadata-gathering +logic "hard coded" into the stylesheets is used. + + The man(7) man page describes this content +as "the date of the last revision". In man pages, it is the content +that is usually displayed in the center footer. + + + + + + +refentry.date.profile.enabled +boolean + + +refentry.date.profile.enabled +Enable refentry "date" profiling? + + + + +<xsl:param name="refentry.date.profile.enabled">0</xsl:param> + + +Description + +If the value of +refentry.date.profile.enabled is non-zero, then +during refentry metadata gathering, the info profile +specified by the customizable +refentry.date.profile parameter is used. + +If instead the value of +refentry.date.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "date" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "date" data to show +up in your output, then consider setting a non-zero value for +refentry.date.profile.enabled and adjusting the +value of refentry.date.profile to cause correct +data to be gathered. + +Note that the terms "source" and "date" have special meanings in +this context. For details, see the documentation for the +refentry.date.profile parameter. + + + + + + +refentry.manual.profile +string + + +refentry.manual.profile +Specifies profile for refentry "manual" data + + + + +<xsl:param name="refentry.manual.profile"> + (($info[//title])[last()]/title)[1]| + ../title/node() +</xsl:param> + + + +Description + +The value of refentry.manual.profile is +a string representing an XPath expression. It is evaluated at +run-time and used only if +refentry.manual.profile.enabled is +non-zero. Otherwise, the refentry metadata-gathering logic +"hard coded" into the stylesheets is used. + +In man pages, this content is usually displayed in the middle of +the header of the page. The man(7) man page +describes this as "the title of the manual (e.g., Linux +Programmer's Manual)". Here are some examples from +existing man pages: + + + dpkg utilities + (dpkg-name) + + + User Contributed Perl Documentation + (GET) + + + GNU Development Tools + (ld) + + + Emperor Norton Utilities + (ddate) + + + Debian GNU/Linux manual + (faked) + + + GIMP Manual Pages + (gimp) + + + KDOC Documentation System + (qt2kdoc) + + + + + + + + + +refentry.manual.profile.enabled +boolean + + +refentry.manual.profile.enabled +Enable refentry "manual" profiling? + + + + +<xsl:param name="refentry.manual.profile.enabled">0</xsl:param> + + +Description + +If the value of +refentry.manual.profile.enabled is +non-zero, then during refentry metadata gathering, the info +profile specified by the customizable +refentry.manual.profile parameter is +used. + +If instead the value of +refentry.manual.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "manual" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "manual" data to show +up in your output, then consider setting a non-zero value for +refentry.manual.profile.enabled and adjusting +the value of refentry.manual.profile to cause +correct data to be gathered. + +Note that the term "manual" has a special meanings in this +context. For details, see the documentation for the +refentry.manual.profile parameter. + + + + + + +refentry.source.name.suppress +boolean + + +refentry.source.name.suppress +Suppress "name" part of refentry "source" contents? + + + + +<xsl:param name="refentry.source.name.suppress">0</xsl:param> + + +Description + +If the value of +refentry.source.name.suppress is non-zero, then +during refentry metadata gathering, no "source name" data +is added to the refentry "source" contents. Instead (unless +refentry.version.suppress is also non-zero), +only "version" data is added to the "source" contents. + +If you find that the refentry metadata gathering +mechanism is causing unwanted "source name" data to show up in your +output -- for example, in the footer (or possibly header) of a man +page -- then you might consider setting a non-zero value for +refentry.source.name.suppress. + +Note that the terms "source", "source name", and "version" have +special meanings in this context. For details, see the documentation +for the refentry.source.name.profile +parameter. + + + + + + +refentry.source.name.profile +string + + +refentry.source.name.profile +Specifies profile for refentry "source name" data + + + + +<xsl:param name="refentry.source.name.profile"> + (($info[//productname])[last()]/productname)[1]| + (($info[//corpname])[last()]/corpname)[1]| + (($info[//corpcredit])[last()]/corpcredit)[1]| + (($info[//corpauthor])[last()]/corpauthor)[1]| + (($info[//orgname])[last()]/orgname)[1]| + (($info[//publishername])[last()]/publishername)[1] +</xsl:param> + + + +Description + +The value of refentry.source.name.profile +is a string representing an XPath expression. It is evaluated at +run-time and used only if +refentry.source.name.profile.enabled is +non-zero. Otherwise, the refentry metadata-gathering logic +"hard coded" into the stylesheets is used. + +A "source name" is one part of a (potentially) two-part +Name Version +"source" field. In man pages, it is usually displayed in the left +footer of the page. It typically indicates the software system or +product that the item documented in the man page belongs to. The +man(7) man page describes it as "the source of +the command", and provides the following examples: + + + For binaries, use something like: GNU, NET-2, SLS + Distribution, MCC Distribution. + + + For system calls, use the version of the kernel that you + are currently looking at: Linux 0.99.11. + + + For library calls, use the source of the function: GNU, BSD + 4.3, Linux DLL 4.4.1. + + + + +In practice, there are many pages that simply have a Version +number in the "source" field. So, it looks like what we have is a +two-part field, +Name Version, +where: + + + Name + + product name (e.g., BSD) or org. name (e.g., GNU) + + + + Version + + version number + + + +Each part is optional. If the Name is a +product name, then the Version is probably +the version of the product. Or there may be no +Name, in which case, if there is a +Version, it is probably the version +of the item itself, not the product it is part of. Or, if the +Name is an organization name, then there +probably will be no Version. + + + + + +refentry.source.name.profile.enabled +boolean + + +refentry.source.name.profile.enabled +Enable refentry "source name" profiling? + + + + +<xsl:param name="refentry.source.name.profile.enabled">0</xsl:param> + + +Description + +If the value of +refentry.source.name.profile.enabled is +non-zero, then during refentry metadata gathering, the info +profile specified by the customizable +refentry.source.name.profile parameter is +used. + +If instead the value of +refentry.source.name.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "source name" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "source name" data to +show up in your output, then consider setting a non-zero value for +refentry.source.name.profile.enabled and +adjusting the value of +refentry.source.name.profile to cause correct +data to be gathered. + +Note that the terms "source" and "source name" have special +meanings in this context. For details, see the documentation for the +refentry.source.name.profile parameter. + + + + + + +refentry.version.suppress +boolean + + +refentry.version.suppress +Suppress "version" part of refentry "source" contents? + + + + +<xsl:param name="refentry.version.suppress">0</xsl:param> + + +Description + +If the value of refentry.version.suppress +is non-zero, then during refentry metadata gathering, no +"version" data is added to the refentry "source" +contents. Instead (unless +refentry.source.name.suppress is also +non-zero), only "source name" data is added to the "source" +contents. + +If you find that the refentry metadata gathering +mechanism is causing unwanted "version" data to show up in your output +-- for example, in the footer (or possibly header) of a man page -- +then you might consider setting a non-zero value for +refentry.version.suppress. + +Note that the terms "source", "source name", and "version" have +special meanings in this context. For details, see the documentation +for the refentry.source.name.profile +parameter. + + + + + + +refentry.version.profile +string + + +refentry.version.profile +Specifies profile for refentry "version" data + + + + +<xsl:param name="refentry.version.profile"> + (($info[//productnumber])[last()]/productnumber)[1]| + (($info[//edition])[last()]/edition)[1]| + (($info[//releaseinfo])[last()]/releaseinfo)[1] +</xsl:param> + + + +Description + +The value of refentry.version.profile is +a string representing an XPath expression. It is evaluated at +run-time and used only if +refentry.version.profile.enabled is +non-zero. Otherwise, the refentry metadata-gathering logic +"hard coded" into the stylesheets is used. + +A "source.name" is one part of a (potentially) two-part +Name Version +"source" field. For more details, see the documentation for the +refentry.source.name.profile parameter. + + + + + + +refentry.version.profile.enabled +boolean + + +refentry.version.profile.enabled +Enable refentry "version" profiling? + + + + +<xsl:param name="refentry.version.profile.enabled">0</xsl:param> + + +Description + +If the value of +refentry.version.profile.enabled is +non-zero, then during refentry metadata gathering, the info +profile specified by the customizable +refentry.version.profile parameter is +used. + +If instead the value of +refentry.version.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "version" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "version" data to show +up in your output, then consider setting a non-zero value for +refentry.version.profile.enabled and adjusting +the value of refentry.version.profile to cause +correct data to be gathered. + +Note that the terms "source" and "version" have special +meanings in this context. For details, see the documentation for the +refentry.version.profile parameter. + + + + + + +refentry.manual.fallback.profile +string + + +refentry.manual.fallback.profile +Specifies profile of "fallback" for refentry "manual" data + + + + +<xsl:param name="refentry.manual.fallback.profile"> +refmeta/refmiscinfo[1]/node()</xsl:param> + + + +Description + +The value of +refentry.manual.fallback.profile is a string +representing an XPath expression. It is evaluated at run-time and +used only if no "manual" data can be found by other means (that is, +either using the refentry metadata-gathering logic "hard +coded" in the stylesheets, or the value of +refentry.manual.profile, if it is +enabled). + + +Depending on which XSLT engine you run, either the EXSLT +dyn:evaluate extension function (for xsltproc or +Xalan) or saxon:evaluate extension function (for +Saxon) are used to dynamically evaluate the value of +refentry.manual.fallback.profile at +run-time. If you don't use xsltproc, Saxon, Xalan -- or some other +XSLT engine that supports dyn:evaluate -- you +must manually disable fallback processing by setting an empty value +for the refentry.manual.fallback.profile +parameter. + + + + + + + +refentry.source.fallback.profile +string + + +refentry.source.fallback.profile +Specifies profile of "fallback" for refentry "source" data + + + + +<xsl:param name="refentry.source.fallback.profile"> +refmeta/refmiscinfo[1]/node()</xsl:param> + + + +Description + +The value of +refentry.source.fallback.profile is a string +representing an XPath expression. It is evaluated at run-time and used +only if no "source" data can be found by other means (that is, either +using the refentry metadata-gathering logic "hard coded" in +the stylesheets, or the value of the +refentry.source.name.profile and +refentry.version.profile parameters, if those +are enabled). + + +Depending on which XSLT engine you run, either the EXSLT +dyn:evaluate extension function (for xsltproc or +Xalan) or saxon:evaluate extension function (for +Saxon) are used to dynamically evaluate the value of +refentry.source.fallback.profile at +run-time. If you don't use xsltproc, Saxon, Xalan -- or some other +XSLT engine that supports dyn:evaluate -- you +must manually disable fallback processing by setting an empty value +for the refentry.source.fallback.profile +parameter. + + + + + + + + Page header/footer + + +man.th.extra1.suppress +boolean + + +man.th.extra1.suppress +Suppress extra1 part of header/footer? + + + + +<xsl:param name="man.th.extra1.suppress">0</xsl:param> + + +Description + +If the value of man.th.extra1.suppress is +non-zero, then the extra1 part of the +.TH title line header/footer is suppressed. + +The content of the extra1 field is almost +always displayed in the center footer of the page and is, universally, +a date. + + + + + + +man.th.extra2.suppress +boolean + + +man.th.extra2.suppress +Suppress extra2 part of header/footer? + + + + +<xsl:param name="man.th.extra2.suppress">0</xsl:param> + + +Description + +If the value of man.th.extra2.suppress is +non-zero, then the extra2 part of the +.TH title line header/footer is suppressed. + +The content of the extra2 field is usually +displayed in the left footer of the page and is typically "source" +data, often in the form +Name Version; +for example, "GTK+ 1.2" (from the gtk-options(7) +man page). + + + You can use the + refentry.source.name.suppress and + refentry.version.suppress parameters to + independently suppress the Name and + Version parts of the + extra2 field. + + + + + + + +man.th.extra3.suppress +boolean + + +man.th.extra3.suppress +Suppress extra3 part of header/footer? + + + + +<xsl:param name="man.th.extra3.suppress">0</xsl:param> + + +Description + +If the value of man.th.extra3.suppress is +non-zero, then the extra3 part of the +.TH title line header/footer is +suppressed. + +The content of the extra3 field is usually +displayed in the middle header of the page and is typically a "manual +name"; for example, "GTK+ User's Manual" (from the +gtk-options(7) man page). + + + + + + +man.th.title.max.length +integer + + +man.th.title.max.length +Maximum length of title in header/footer + + + + +<xsl:param name="man.th.title.max.length">20</xsl:param> + + + +Description + +Specifies the maximum permitted length of the title part of the +man-page .TH title line header/footer. If the title +exceeds the maxiumum specified, it is truncated down to the maximum +permitted length. + + + Details + +Every man page generated using the DocBook stylesheets has a +title line, specified using the TH roff +macro. Within that title line, there is always, at a minimum, a title, +followed by a section value (representing a man "section" -- usually +just a number). + +The title and section are displayed, together, in the visible +header of each page. Where in the header they are displayed depends on +OS the man page is viewed on, and on what version of nroff/groff/man +is used for viewing the page. But, at a minimum and across all +systems, the title and section are displayed on the right-hand column +of the header. On many systems -- those with a modern groff, including +Linux systems -- they are displayed twice: both in the left and right +columns of the header. + +So if the length of the title exceeds a certain percentage of +the column width in which the page is viewed, the left and right +titles can end up overlapping, making them unreadable, or breaking to +another line, which doesn't look particularly good. + +So the stylesheets provide the +man.th.title.max.length parameter as a means +for truncating titles that exceed the maximum length that can be +viewing properly in a page header. + +The default value is reasonable but somewhat arbitrary. If you +have pages with long titles, you may want to experiment with changing +the value in order to achieve the correct aesthetic results. + + + + + + + +man.th.extra2.max.length +integer + + +man.th.extra2.max.length +Maximum length of extra2 in header/footer + + + + +<xsl:param name="man.th.extra2.max.length">30</xsl:param> + + + +Description + +Specifies the maximum permitted length of the +extra2 part of the man-page part of the +.TH title line header/footer. If the +extra2 content exceeds the maxiumum specified, it +is truncated down to the maximum permitted length. + +The content of the extra2 field is usually +displayed in the left footer of the page and is typically "source" +data indicating the software system or product that the item +documented in the man page belongs to, often in the form +Name Version; +for example, "GTK+ 1.2" (from the gtk-options(7) +man page). + +The default value for this parameter is reasonable but somewhat +arbitrary. If you are processing pages with long "source" information, +you may want to experiment with changing the value in order to achieve +the correct aesthetic results. + + + + + +man.th.extra3.max.length +integer + + +man.th.extra3.max.length +Maximum length of extra3 in header/footer + + + + +<xsl:param name="man.th.extra3.max.length">30</xsl:param> + + + +Description + +Specifies the maximum permitted length of the +extra3 part of the man-page .TH +title line header/footer. If the extra3 content +exceeds the maxiumum specified, it is truncated down to the maximum +permitted length. + +The content of the extra3 field is usually +displayed in the middle header of the page and is typically a "manual +name"; for example, "GTK+ User's Manual" (from the +gtk-options(7) man page). + +The default value for this parameter is reasonable but somewhat +arbitrary. If you are processing pages with long "manual names" -- or +especially if you are processing pages that have both long "title" +parts (command/function, etc. names) and long +manual names -- you may want to experiment with changing the value in +order to achieve the correct aesthetic results. + + + + + + Output + + + man.output.manifest.enabled + boolean + + + man.output.manifest.enabled + Generate a manifest file? + + + + <xsl:param name="man.output.manifest.enabled" select="0"></xsl:param> + + + Description + + If non-zero, a list of filenames for man pages generated by + the stylesheet transformation is written to the file named by the + man.output.manifest.filename parameter. + + + + + + + man.output.manifest.filename + string + + + man.output.manifest.filename + Name of manifest file + + + + <xsl:param name="man.output.manifest.filename">MAN.MANIFEST</xsl:param> + + + Description + + The man.output.manifest.filename parameter + specifies the name of the file to which the manpages manifest file + is written (if the value of the + man.output.manifest.enabled parameter is + non-zero). + + + + + + +man.output.in.separate.dir + + + +man.output.in.separate.dir +Output man-page files in separate output directory? + + + + +<xsl:param name="man.output.in.separate.dir" select="0"></xsl:param> + + + +Description + +If the value of man.output.in.separate.dir +parameter is non-zero, man-page files are output in a separate +directory, specified by the man.output.base.dir +parameter; otherwise, if the value of +man.output.in.separate.dir is zero, man-page files +are not output in a separate directory. + + + + + + +man.output.base.dir + + + +man.output.base.dir +Specifies separate output directory + + + +<xsl:param name="man.output.base.dir">man/</xsl:param> + + +Description + +The man.output.base.dir parameter +specifies the base directory into which man-page files are output. The +man.output.subdirs.enabled parameter controls +whether the files are output in subdirectories within the base +directory. + + + The values of the man.output.base.dir + and man.output.subdirs.enabled parameters are + used only if the value of + man.output.in.separate.dir parameter is + non-zero. If the value of the + man.output.in.separate.dir is zero, man-page + files are not output in a separate directory. + + + + + + + +man.output.subdirs.enabled + + + +man.output.subdirs.enabled +Output man-page files in subdirectories within base output directory? + + + + +<xsl:param name="man.output.subdirs.enabled" select="1"></xsl:param> + + + +Description + +The man.output.subdirs.enabled parameter +controls whether man-pages files are output in subdirectories within +the base directory specified by the directory specified by the +man.output.base.dir parameter. + + + The values of the man.output.base.dir + and man.output.subdirs.enabled parameters are + used only if the value of + man.output.in.separate.dir parameter is + non-zero. If the value of the + man.output.in.separate.dir is zero, man-page + files are not output in a separate directory. + + + + + + + +man.output.quietly + + + +man.output.quietly +Suppress filename messages emitted when generating output? + + + + +<xsl:param name="man.output.quietly" select="0"></xsl:param> + + + +Description + +If zero (the default), for each man-page file created, a message +with the name of the file is emitted. If non-zero, the files are +output "quietly" -- that is, the filename messages are +suppressed. + + + If you are processing a large amount of refentry + content, you may be able to speed up processing significantly by + setting a non-zero value for + man.output.quietly. + + + + + + + +man.output.encoding +string + + +man.output.encoding +Encoding used for man-page output + + + + +<xsl:param name="man.output.encoding" select="'UTF-8'"></xsl:param> + + +Description + +This parameter specifies the encoding to use for files generated +by the manpages stylesheet. Not all processors support specification +of this parameter. + + + If the value of the man.charmap.enabled + parameter is non-zero (the default), keeping the + man.output.encoding parameter at its default + value (UTF-8) or setting it to + UTF-16 does not cause your + man pages to be output in raw UTF-8 or UTF-16 -- because + any Unicode characters for which matches are found in the enabled + character map will be replaced with roff escape sequences before the + final man-page files are generated. + + So if you want to generate "real" UTF-8 man pages, without any + character substitution being performed on your content, you need to + set man.charmap.enabled to zero (which will + completely disable character-map processing). + + You may also need to set + man.charmap.enabled to zero if you want to + output man pages in an encoding other than UTF-8 + or UTF-16. Character-map processing is based on + Unicode character values and may not work with other output + encodings. + + + + + + + + Other + + +man.table.footnotes.divider +string + + +man.table.footnotes.divider +Specifies divider string that appears before table footnotes + + + + +<xsl:param name="man.table.footnotes.divider">----</xsl:param> + + + +Description + +In each table that contains footenotes, the string specified by +the man.table.footnotes.divider parameter is +output before the list of footnotes for the table. + + + + + + +man.subheading.divider.enabled +string + + +man.subheading.divider.enabled +Add divider comment to roff source before/after subheadings? + + + + +<xsl:param name="man.subheading.divider.enabled">0</xsl:param> + + + +Description + +If the value of the +man.subheading.divider.enabled parameter is +non-zero, the contents of the +man.subheading.divider parameter are used to +add a "divider" before and after subheadings in the roff +output. The divider is not visisble in the +rendered man page; it is added as a comment, in the source, +simply for the purpose of increasing reability of the source. + +If man.subheading.divider.enabled is zero +(the default), the subheading divider is suppressed. + + + + + + +man.subheading.divider +string + + +man.subheading.divider +Specifies string to use as divider comment before/after subheadings + + + + +<xsl:param name="man.subheading.divider">========================================================================</xsl:param> + + + +Description + +If the value of the +man.subheading.divider.enabled parameter is +non-zero, the contents of the +man.subheading.divider parameter are used to +add a "divider" before and after subheadings in the roff +output. The divider is not visisble in the +rendered man page; it is added as a comment, in the source, +simply for the purpose of increasing reability of the source. + +If man.subheading.divider.enabled is zero +(the default), the subheading divider is suppressed. + + + + + + + The Stylesheet + + The param.xsl stylesheet is just a + wrapper around all of these parameters. + + +<xsl:stylesheet exclude-result-prefixes="src" version="1.0"> + +<!-- This file is generated from param.xweb; do not edit this file! --> + +<!-- ******************************************************************** + $Id: param.xweb,v 1.24 2006/04/26 04:38:28 xmldoc Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<src:fragref linkend="man.break.after.slash.frag"></src:fragref> +<src:fragref linkend="man.hyphenate.frag"></src:fragref> +<src:fragref linkend="man.hyphenate.urls.frag"></src:fragref> +<src:fragref linkend="man.hyphenate.filenames.frag"></src:fragref> +<src:fragref linkend="man.hyphenate.computer.inlines.frag"></src:fragref> +<src:fragref linkend="man.justify.frag"></src:fragref> +<src:fragref linkend="man.indent.width.frag"></src:fragref> +<src:fragref linkend="man.indent.refsect.frag"></src:fragref> +<src:fragref linkend="man.indent.blurbs.frag"></src:fragref> +<src:fragref linkend="man.indent.lists.frag"></src:fragref> +<src:fragref linkend="man.indent.verbatims.frag"></src:fragref> +<src:fragref linkend="man.font.funcprototype.frag"></src:fragref> +<src:fragref linkend="man.font.funcsynopsisinfo.frag"></src:fragref> +<src:fragref linkend="man.font.table.headings.frag"></src:fragref> +<src:fragref linkend="man.font.table.title.frag"></src:fragref> +<src:fragref linkend="man.output.manifest.enabled.frag"></src:fragref> +<src:fragref linkend="man.output.manifest.filename.frag"></src:fragref> +<src:fragref linkend="man.output.quietly.frag"></src:fragref> +<src:fragref linkend="man.output.encoding.frag"></src:fragref> +<src:fragref linkend="man.output.in.separate.dir.frag"></src:fragref> +<src:fragref linkend="man.output.base.dir.frag"></src:fragref> +<src:fragref linkend="man.output.subdirs.enabled.frag"></src:fragref> +<src:fragref linkend="man.string.subst.map.frag"></src:fragref> +<src:fragref linkend="man.links.are.numbered.frag"></src:fragref> +<src:fragref linkend="man.links.are.underlined.frag"></src:fragref> +<src:fragref linkend="man.links.list.enabled.frag"></src:fragref> +<src:fragref linkend="man.links.list.heading.frag"></src:fragref> +<src:fragref linkend="variablelist.term.separator.frag"></src:fragref> +<src:fragref linkend="variablelist.term.break.after.frag"></src:fragref> +<src:fragref linkend="man.charmap.enabled.frag"></src:fragref> +<src:fragref linkend="man.charmap.uri.frag"></src:fragref> +<src:fragref linkend="man.charmap.use.subset.frag"></src:fragref> +<src:fragref linkend="man.charmap.subset.profile.frag"></src:fragref> +<src:fragref linkend="man.segtitle.suppress.frag"></src:fragref> +<src:fragref linkend="man.table.footnotes.divider.frag"></src:fragref> +<src:fragref linkend="man.subheading.divider.frag"></src:fragref> +<src:fragref linkend="man.subheading.divider.enabled.frag"></src:fragref> +<src:fragref linkend="refentry.date.profile.enabled.frag"></src:fragref> +<src:fragref linkend="refentry.meta.get.quietly.frag"></src:fragref> +<src:fragref linkend="refentry.manual.profile.enabled.frag"></src:fragref> +<src:fragref linkend="refentry.source.name.profile.enabled.frag"></src:fragref> +<src:fragref linkend="refentry.version.profile.enabled.frag"></src:fragref> +<src:fragref linkend="refentry.source.name.suppress.frag"></src:fragref> +<src:fragref linkend="refentry.version.suppress.frag"></src:fragref> +<src:fragref linkend="refentry.date.profile.frag"></src:fragref> +<src:fragref linkend="refentry.manual.fallback.profile.frag"></src:fragref> +<src:fragref linkend="refentry.manual.profile.frag"></src:fragref> +<src:fragref linkend="refentry.source.fallback.profile.frag"></src:fragref> +<src:fragref linkend="refentry.source.name.profile.frag"></src:fragref> +<src:fragref linkend="refentry.version.profile.frag"></src:fragref> +<src:fragref linkend="man.th.title.max.length.frag"></src:fragref> +<src:fragref linkend="man.th.extra2.max.length.frag"></src:fragref> +<src:fragref linkend="man.th.extra3.max.length.frag"></src:fragref> +<src:fragref linkend="man.th.extra1.suppress.frag"></src:fragref> +<src:fragref linkend="man.th.extra2.suppress.frag"></src:fragref> +<src:fragref linkend="man.th.extra3.suppress.frag"></src:fragref> +</xsl:stylesheet> + + + +                   \ No newline at end of file diff --git a/src/documentation/docbook-xsl/manpages/param.xsl b/src/documentation/docbook-xsl/manpages/param.xsl new file mode 100644 index 0000000000..3b3e6922b0 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/param.xsl @@ -0,0 +1,2353 @@ + + + + + + + +man.hyphenate +boolean + +man.hyphenate +Enable hyphenation? + + +Description + +If non-zero, hyphenation is enabled. + + +The default value for this parameter is zero because groff is +not particularly smart about how it does hyphenation; it can end up +hyphenating a lot of things that you don't want hyphenated. To +mitigate that, the default behavior of the stylesheets is to suppress +hyphenation of computer inlines, filenames, and URLs. (You can +override the default behavior by setting non-zero values for the +man.hyphenate.urls, +man.hyphenate.filenames, and +man.hyphenate.computer.inlines parameters.) But +the best way is still to just globally disable hyphenation, as the +stylesheets do by default. + +The only good reason to enabled hyphenation is if you have also +enabled justification (which is disabled by default). The reason is +that justified text can look very bad unless you also hyphenate it; to +quote the Hypenation node from the groff info page: + +
                  + Since the odds are not great for finding a set of + words, for every output line, which fit nicely on a line without + inserting excessive amounts of space between words, 'gtroff' + hyphenates words so that it can justify lines without inserting too + much space between words. +
                  + +So, if you set a non-zero value for the +man.justify parameter (to enable +justification), then you should probably also set a non-zero value for +man.hyphenate (to enable hyphenation).                   +                   + + +                   +                   +0 + + +man.hyphenate.urls +boolean + +man.hyphenate.urls +Hyphenate URLs? + + +Description + +If zero (the default), hyphenation is suppressed for output of +the ulink url attribute. + + + If hyphenation is already turned off globally (that is, if + man.hyphenate is zero, setting + man.hyphenate.urls is not necessary. + + +If man.hyphenate.urls is non-zero, URLs +will not be treated specially and are subject to hyphenation just like +other words. + + + If you are thinking about setting a non-zero value for + man.hyphenate.urls in order to make long + URLs break across lines, you'd probably be better off + experimenting with setting the + man.break.after.slash parameter first. That + will cause long URLs to be broken after slashes. + + + + +0 + + +man.hyphenate.filenames +boolean + +man.hyphenate.filenames +Hyphenate filenames? + + +Description + +If zero (the default), hyphenation is suppressed for +filename output. + + + If hyphenation is already turned off globally (that is, if + man.hyphenate is zero, setting + man.hyphenate.filenames is not + necessary. + + +If man.hyphenate.filenames is non-zero, +filenames will not be treated specially and are subject to hyphenation +just like other words. + + + If you are thinking about setting a non-zero value for + man.hyphenate.filenames in order to make long + filenames/pathnames break across lines, you'd probably be better off + experimenting with setting the + man.break.after.slash parameter first. That + will cause long pathnames to be broken after slashes. + + + + +0 + + +man.hyphenate.computer.inlines +boolean + +man.hyphenate.computer.inlines +Hyphenate computer inlines? + + +Description + +If zero (the default), hyphenation is suppressed for +computer inlines such as environment variables, +constants, etc. This parameter current affects output of the following +elements: + + + classname + constant + envar + errorcode + option + replaceable + userinput + type + varname + + + + + If hyphenation is already turned off globally (that is, if + man.hyphenate is zero, setting the + man.hyphenate.computer.inlines is not + necessary. + + +If man.hyphenate.computer.inlines is +non-zero, computer inlines will not be treated specially and will be +hyphenated like other words when needed. + + + +0 + + +man.justify +boolean + +man.justify +Justify text to both right and left margins? + + +Description + +If non-zero, text is justified to both the right and left +margins (or, in roff terminology, "adjusted and filled" to both the +right and left margins). If zero (the default), text is adjusted to +the left margin only -- producing what is traditionally called +"ragged-right" text. + + +The default value for this parameter is zero because justified +text looks good only when it is also hyphenated. Without hyphenation, +excessive amounts of space often end up getting between words, in +order to "pad" lines out to align on the right margin. + +The problem is that groff is not particularly smart about how it +does hyphenation; it can end up hyphenating a lot of things that you +don't want hyphenated. So, disabling both justification and +hyphenation ensures that hyphens won't get inserted where you don't +want to them, and you don't end up with lines containing excessive +amounts of space between words. + +However, if do you decide to set a non-zero value for the +man.justify parameter (to enable +justification), then you should probably also set a non-zero value for +man.hyphenate (to enable hyphenation). + +Yes, these default settings run counter to how most existing man +pages are formatted. But there are some notable exceptions, such as +the perl man pages. + + + +0 + + +man.break.after.slash +boolean + +man.break.after.slash +Enable line-breaking after slashes? + + +Description + +If non-zero, line-breaking after slashes is enabled. This is +mainly useful for causing long URLs or pathnames/filenames to be +broken up or "wrapped" across lines (though it also has the side +effect of sometimes causing relatively short URLs and pathnames to be +broken up across lines too). + +If zero (the default), line-breaking after slashes is +disabled. In that case, strings containing slashes (for example, URLs +or filenames) are not broken across lines, even if they exceed the +maximum column widith. + + + If you set a non-zero value for this parameter, check your + man-page output carefuly afterwards, in order to make sure that the + setting has not introduced an excessive amount of breaking-up of URLs + or pathnames. If your content contains mostly short URLs or + pathnames, setting a non-zero value for + man.break.after.slash will probably result in + in a significant number of relatively short URLs and pathnames being + broken across lines, which is probably not what you want. + + + + +0 + + +man.indent.width +Specifies width used for adjusted indents + + +Description +The man.indent.width parameter specifies +the width used for adjusted indents. The value of +man.indent.width is used for indenting of +lists, verbatims, headings, and elsewhere, depending on whether the +values of certain man.indent.* boolean parameters +are non-zero. + +The value of man.indent.width should +include a valid roff measurement unit (for example, +n or u). The default value of +3n specifies a 3-en width; when viewed on a +console, that amounts to the width of three characters. For details +about roff measurment units, see the Measurements +node in the groff info page. + + + +3n + + +man.indent.refsect +boolean + +man.indent.refsect +Adjust indentation of refsect* and refsection? + + +Description + +If the value of man.indent.refsect is +non-zero, the width of the left margin for +refsect1, refsect2 and +refsect3 contents and titles (and first-level, +second-level, and third-level nested +refsectioninstances) is adjusted by the value of +the man.indent.width parameter. With +man.indent.width set to its default value of +3n, the main results are that: + + + + contents of refsect1 are output with a + left margin of three characters instead the roff default of seven + or eight characters + + + contents of refsect2 are displayed in + console output with a left margin of six characters instead the of + the roff default of seven characters + + + the contents of refsect3 and nested + refsection instances are adjusted + accordingly. + + + +If instead the value of man.indent.refsect is +zero, no margin adjustment is done for refsect* +output. + + + If your content is primarly comprised of + refsect1 and refsect2 content + (or the refsection equivalent) – with few or + no refsect3 or lower nested sections , you may be + able to “conserve” space in your output by setting + man.indent.refsect to a non-zero value. Doing + so will “squeeze” the left margin in such as way as to provide an + additional four characters of “room” per line in + refsect1 output. That extra room may be useful + if, for example, you have many verbatim sections with long lines in + them. + + + + + + + +man.indent.blurbs +boolean + +man.indent.blurbs +Adjust indentation of blurbs? + + +Description + +If the value of man.indent.blurbs is +non-zero, the width of the left margin for +authorblurb, personblurb, and +contrib output is set to the value of the +man.indent.width parameter +(3n by default). If instead the value of +man.indent.blurbs is zero, the built-in roff +default width (7.2n) is used. + + + + + + +man.indent.lists +boolean + +man.indent.lists +Adjust indentation of lists? + + +Description + +If the value of man.indent.lists is +non-zero, the width of the left margin for list items in +itemizedlist, +orderedlist, +variablelist output (and output of some other +lists) is set to the value of the +man.indent.width parameter +(3n by default). If instead the value of +man.indent.lists is zero, the built-in roff +default width (7.2n) is used. + + + + + + +man.indent.verbatims +boolean + +man.indent.verbatims +Adjust indentation of verbatims? + + +Description + +If the value of man.indent.verbatims is +non-zero, the width of the left margin for output of verbatim +environments (programlisting, +screen, and so on) is set to the value of the +man.indent.width parameter +(3n by default). If instead the value of +man.indent.verbatims is zero, the built-in roff +default width (7.2n) is used. + + + + + + +man.font.funcprototype + + +man.font.funcprototype +Specifies font for funcprototype output + + +Description + +The man.font.funcprototype parameter +specifies the font for funcprototype output. It +should be a valid roff font name, such as BI or +B. + + + + BI + + +man.font.funcsynopsisinfo + + +man.font.funcsynopsisinfo +Specifies font for funcsynopsisinfo output + + +Description + +The man.font.funcsynopsisinfo parameter +specifies the font for funcsynopsisinfo output. It +should be a valid roff font name, such as B or +I. + + + + B + + +man.font.table.headings + + +man.font.table.headings +Specifies font for table headings + + +Description + +The man.font.table.headings parameter +specifies the font for table headings. It should be +a valid roff font, such as B or +I. + + + + B + + +man.font.table.title + + +man.font.table.title +Specifies font for table headings + + +Description + +The man.font.table.title parameter +specifies the font for table titles. It should be +a valid roff font, such as B or +I. + + + + B + + +man.links.are.numbered +boolean + +man.links.are.numbered +Number links? + + +Description + +If the value of man.links.are.numbered is +non-zero (the default), then for each non-empty +A non-empty link is one that looks like +this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/">manpages</ulink> +an empty link is on that looks like this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/"/> + link: + + + + a number (in square brackets) is displayed inline before the + rendered contents of the link + + + the URL for the link is included in a numbered list of links + that is generated at the end of each man page; the number for each + links corresponds to the inline number for the link with which it is + associated + + +The default heading for the list of links is +REFERENCES. To output a different heading, set a value +for the man.links.section.heading +parameter. + + + The link list is also displayed (but without numbers) if the + value of man.links.list.enabled is + non-zero. + + + +If the value of man.links.are.numbered is +zero, numbering of links is suppressed; only the link contents are +displayed inline. + + If you are thinking about disabling link numbering by setting + the value of man.links.are.numbered to zero, + before you do so, first take some time to carefully + consider the information needs and experiences of your users. The + square-bracketed numbers displayed inline before links may seem + obstrusive and aesthetically unpleasingYou might + think that it would be better to just display URLs for non-empty + links inline, after their content, rather than displaying + square-bracketed numbers all over the place. But it's not better. In + fact, it's not even practical, because many (most) URLs for links + are too long to be displayed inline. They end up overflowing the + right margin. You can set a non-zero value for + man.break.after.slash parameter to deal with + that, but it could be argued that what you end up with is at least + as ugly, and definitely more obstrusive, then having short + square-bracketed numbers displayed inline., + + but in a text-only output format, the numbered-links/link-listing + mechanism is the only practical way of associating inline text with + URLs. + + Also, users of text based browsers such as + lynx will already be accustomed to seeing inline + numbers for links. And various "man to html" applications, such as + the widely used man2html (VH-Man2html) + application, can automatically turn URLs into "real" HTML hyperlinks + in output. So leaving man.links.are.numbered + at its default (non-zero) value ensures that no link information is + lost in your man-page output. It just gets + rearranged. + + +The handling of empty links is not affected by this +parameter. Empty links are handled simply by displaying their URLs +inline. Empty links are never auto-numbered. + + Currently, this parameter only affects output for + ulinks. + + +If you disable link numbering, you should probably also set +man.links.are.underlined to zero (to disable +link underlining). + + +1 + + +man.links.are.underlined +boolean + +man.links.are.underlined +Underline links? + + +Description + +If the value of man.links.are.underlined +is non-zero (the default), then the contents of links are rendered +with an underline. + +If the value of man.links.are.underlined +is zero, links are displayed without any underlining. + + + Currently, this parameter only affects output for + ulinks. + + +If you set man.links.are.numbered and/or +man.links.list.enabled to zero (disabled), then +you should probably also set +man.links.are.underlined to zero. But if +man.links.are.numbered is non-zero (enabled), +you should probably set a non-zero value for +man.links.are.underlined alsoIf the main purpose of underlining of links in most output +formats it to indicate that the underlined text is +clickable, given that links rendered in man pages are +not real hyperlinks that users can click on, it might +seem like there is never a good reason to have link contents +underlined in man output. In fact, if you suppress the +display of inline link references (by setting +man.links.are.numbered to zero), there is no +good reason to have links underlined. However, if +man.links.are.numbered is non-zero, having +links underlined may (arguably) serve a purpose: It provides +context information about exactly what part of the text +is being annotated by the link. Depending on how you +use mark up your content, that context information may or may not have +value.. + + +1 + + +man.links.list.enabled +boolean + +man.links.list.enabled +Display list of links at end of man page? + + +Description + +If the value of man.links.list.enabled is +non-zero (the default), then a list of links is added to the end of +the output man page. + +If the value of man.links.list.enabled is +zero, the list is suppressed -- unless link numbering is enabled (that +is, if man.links.are.numbered is non-zero), in +which case, that setting overrides the +man.links.list.enabled setting, and the link +list is still displayed. The reason is that link numbering only makes +sense if a (numbered) list of links is also generated. + + + Various man to html applications, such as the + widely used man2html (VH-Man2html) + application, can automatically turn URLs into real + HTML hyperlinks in output. So leaving + man.links.list.enabled at its default + (non-zero) value ensures that no link URLs are lost in your man-page + output. They just get rearranged. So if you are + thinking about disabling link listing by setting the value of + man.links.list.enabled to zero, before you do + so, first take some time to carefully consider the information needs + and experiences of your users. The URLs are useful information even + if they aren't real (clickable) hyperlinks. + + +To turn off numbering of links in the list, set +man.links.are.numbered to zero. The list will +still be displayed; it will just be displayed without the +numbersIt can still make sense to have +the list of links displayed even if you have link numbering turned +off. In that case, your list of links basically becomes a list +of references without any association with specific text in +your document. This is probably the best option if you find the inline +link numbering obtrusive. Your users will still have access to the +URLs and link contents, without being annoyed by the presence of +inline link numbering. + + +The default heading for the section in which the list appears is +REFERENCES. To change that, set a non-empty value +for the man.links.list.heading +parameter. + +Along with the URL for each link, the link list includes the contents +of the link. The list thus includes only non-empty + +A non-empty link is one that looks like +this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/">manpages</ulink> +an empty link is on that looks like this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/"/> + links. + +Empty links are never included, and never numbered. They are simply +displayed inline, without any numbering. + +In addition, if there are multiple instances of links in a +refentry that have the same URL, the URL is listed only +once. The contents listed for that link are the contents of the first +link which has that URL. + + + Currently, this parameter only affects output for + ulinks. + + +If you disable link listing, you should probably also set +man.links.are.underlined to zero (to disable +link underlining). + + +1 + + +man.links.list.heading +string + +man.links.list.heading +Specifies an alternate name for links list + + +Description + +If the value of the +man.links.are.numbered parameter and/or the +man.links.list.enabled parameter is non-zero +(the defaults for both are non-zero), a numbered list of URLs is +generated near the end of each man page. The default section heading +for the list of links is the equivalent of the English word +REFERENCES in the current locale. To cause an +alternate heading to be displayed, set a non-empty value for the +man.links.list.heading parameter -- for +example, LINKS. + + + + + +man.segtitle.suppress +boolean + +man.segtitle.suppress +Suppress display of segtitle contents? + + +Description + +If the value of man.segtitle.suppress is +non-zero, then display of segtitle contents is +suppressed in output. + + + + + + +variablelist.term.separator +string + +variablelist.term.separator +Text to separate terms within a multi-term +varlistentry + + +Description + +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is placed +after each term except the last. + + + To generate a line break between multiple terms in + a varlistentry, set a non-zero value for the + variablelist.term.break.after parameter. If + you do so, you may also want to set the value of the + variablelist.term.separator parameter to an + empty string (to suppress rendering of the default comma and space + after each term). + + + + +, + + +variablelist.term.break.after +boolean + +variablelist.term.break.after +Generate line break after each term within a +multi-term varlistentry? + + +Description + +Set a non-zero value for the +variablelist.term.break.after parameter to +generate a line break between terms in a +multi-term varlistentry. + + +If you set a non-zero value for +variablelist.term.break.after, you may also +want to set the value of the +variablelist.term.separator parameter to an +empty string (to suppress rendering of the default comma and space +after each term). + + + + +0 + + +man.charmap.enabled +boolean + +man.charmap.enabled +Apply character map before final output? + + +Description + +If the value of the man.charmap.enabled +parameter is non-zero, a "character map" is used to substitute certain +Unicode symbols and special characters with appropriate roff/groff +equivalents, just before writing each man-page file to the +filesystem. If instead the value of +man.charmap.enabled is zero, Unicode characters +are passed through "as is". + + +Details +For converting certain Unicode symbols and special characters in +UTF-8 or UTF-16 encoded XML source to appropriate groff/roff +equivalents in man-page output, the DocBook XSL Stylesheets +distribution includes a roff character map that is compliant with the XSLT character +map format as detailed in the XSLT 2.0 specification. The map +contains more than 800 character mappings and can be considered the +standard roff character map for the distribution. + +You can use the man.charmap.uri +parameter to specify a URI for the location for an alternate roff +character map to use in place of the standard roff character map +provided in the distribution. + +You can also use a subset of a character map. For details, see +the man.charmap.use.subset and +man.charmap.subset.profile parameters. + + + + + + + +man.charmap.uri +uri + +man.charmap.uri +URI for custom roff character map + + +Description + +For converting certain Unicode symbols and special characters in +UTF-8 or UTF-16 encoded XML source to appropriate groff/roff +equivalents in man-page output, the DocBook XSL Stylesheets +distribution includes an XSLT character +map. That character map can be considered the standard roff +character map for the distribution. + +If the value of the man.charmap.uri +parameter is non-empty, that value is used as the URI for the location +for an alternate roff character map to use in place of the standard +roff character map provided in the distribution. + + +Do not set a value for man.charmap.uri +unless you have a custom roff character map that differs from the +standard one provided in the distribution. + + + + + + +man.charmap.use.subset +boolean + +man.charmap.use.subset +Use subset of character map instead of full map? + + +Description + +If the value of the +man.charmap.use.subset parameter is non-zero, +a subset of the roff character map is used instead of the full roff +character map. The profile of the subset used is specified by the +man.charmap.subset.profile parameter. + + + You may want to experiment with setting a non-zero value of + man.charmap.use.subset, so that the full + character map is used. Depending on which XSLT engine you run, + setting a non-zero value for + man.charmap.use.subset may significantly + increase the time needed to process your documents. Or it may + not. For example, if you set it and run it with xsltproc, it seems + to dramatically increase processing time; on the other hand, if you + set it and run it with Saxon, it does not seem to increase + processing time nearly as much. + + If processing time is not a important concern and/or you can + tolerate the increase in processing time imposed by using the full + character map, set man.charmap.use.subset to + zero. + + + +Details +For converting certain Unicode symbols and special characters in +UTF-8 or UTF-16 encoded XML source to appropriate groff/roff +equivalents in man-page output, the DocBook XSL Stylesheets +distribution includes a roff character map that is compliant with the XSLT character +map format as detailed in the XSLT 2.0 specification. The map +contains more than 800 character mappings and can be considered the +standard roff character map for the distribution. + + +You can use the man.charmap.uri +parameter to specify a URI for the location for an alternate roff +character map to use in place of the standard roff character map +provided in the distribution. + + +Because it is not terrifically efficient to use the standard +800-character character map in full -- and for most (or all) users, +never necessary to use it in full -- the DocBook XSL Stylesheets +support a mechanism for using, within any given character map, a +subset of character mappings instead of the full set. You can use the +man.charmap.subset.profile parameter to tune +the profile of that subset to use. + + + + + + + +man.charmap.subset.profile +string + +man.charmap.subset.profile +Profile of character map subset + + +Description + +If the value of the +man.charmap.use.subset parameter is non-zero, +The character-map subset specified by the +man.charmap.subset.profile parameter is used +instead of the full roff character map. + +The value of man.charmap.subset.profile +is a string representating an XPath expression that matches attribute +names and values for output-character elements in the character map. + +The attributes supported in the standard roff character map included in the distribution are: + + + character + + a raw Unicode character or numeric Unicode + character-entity value (either in decimal or hex); all + characters have this attribute + + + + name + + a standard full/long ISO/Unicode character name (e.g., + "OHM SIGN"); all characters have this attribute + + + + block + + a standard Unicode "block" name (e.g., "General + Punctuation"); all characters have this attribute. For the full + list of Unicode block names supported in the standard roff + character map, see . + + + + class + + a class of characters (e.g., "spaces"). Not all + characters have this attribute; currently, it is used only with + certain characters within the "C1 Controls And Latin-1 + Supplement" and "General Punctuation" blocks. For details, see + . + + + + entity + + an ISO entity name (e.g., "ohm"); not all characters + have this attribute, because not all characters have ISO entity + names; for example, of the 800 or so characters in the standard + roff character map included in the distribution, only around 300 + have ISO entity names. + + + + + string + + a string representating an roff/groff escape-code (with + "@esc@" used in place of the backslash), or a simple ASCII + string; all characters in the roff character map have this + attribute + + + + +The value of man.charmap.subset.profile +is evaluated as an XPath expression at run-time to select a portion of +the roff character map to use. You can tune the subset used by adding +or removing parts. For example, if you need to use a wide range of +mathematical operators in a document, and you want to have them +converted into roff markup properly, you might add the following: + + @*[local-name() = 'block'] ='MathematicalOperators' + +That will cause a additional set of around 67 additional "math" +characters to be converted into roff markup. + + +Depending on which XSLT engine you use, either the EXSLT +dyn:evaluate extension function (for xsltproc or +Xalan) or saxon:evaluate extensio function (for +Saxon) are used to dynamically evaluate the value of +man.charmap.subset.profile at run-time. If you +don't use xsltproc, Saxon, Xalan -- or some other XSLT engine that +supports dyn:evaluate -- you must either set the +value of the man.charmap.use.subset parameter +to zero and process your documents using the full character map +instead, or set the value of the +man.charmap.enabled parameter to zero instead +(so that character-map processing is disabled completely. + + +An alternative to using +man.charmap.subset.profile is to create your +own custom character map, and set the value of +man.charmap.uri to the URI/filename for +that. If you use a custom character map, you will probably want to +include in it just the characters you want to use, and so you will +most likely also want to set the value of +man.charmap.use.subset to zero. +You can create a +custom character map by making a copy of the standard roff character map provided in the distribution, and +then adding to, changing, and/or deleting from that. + + +If you author your DocBook XML source in UTF-8 or UTF-16 +encoding and aren't sure what OSes or environments your man-page +output might end up being viewed on, and not sure what version of +nroff/groff those environments might have, you should be careful about +what Unicode symbols and special characters you use in your source and +what parts you add to the value of +man.charmap.subset.profile. +Many of the escape codes used are specific to groff and using +them may not provide the expected output on an OS or environment that +uses nroff instead of groff. +On the other hand, if you intend for your man-page output to be +viewed only on modern systems (for example, GNU/Linux systems, FreeBSD +systems, or Cygwin environments) that have a good, up-to-date groff, +then you can safely include a wide range of Unicode symbols and +special characters in your UTF-8 or UTF-16 encoded DocBook XML source +and add any of the supported Unicode block names to the value of +man.charmap.subset.profile. + + + +For other details, see the documentation for the +man.charmap.use.subset parameter. + + + Supported Unicode block names and "class" values + + Below is the full list of Unicode block names and "class" + values supported in the standard roff stylesheet provided in the + distribution, along with a description of which codepoints from the + Unicode range corresponding to that block name or block/class + combination are supported. + + + + C1 Controls And Latin-1 Supplement (Latin-1 Supplement) (x00a0 to x00ff) + + class values + + symbols + + + letters + + + + + Latin Extended-A (x0100 to x017f, partial) + + + Spacing Modifier Letters (x02b0 to x02ee, partial) + + + Greek and Coptic (x0370 to x03ff, partial) + + + General Punctuation (x2000 to x206f, partial) + + class values + + spaces + + + dashes + + + quotes + + + daggers + + + bullets + + + leaders + + + primes + + + + + + Superscripts and Subscripts (x2070 to x209f) + + + Currency Symbols (x20a0 to x20b1) + + + Letterlike Symbols (x2100 to x214b) + + + Number Forms (x2150 to x218f) + + + Arrows (x2190 to x21ff, partial) + + + Mathematical Operators (x2200 to x22ff, partial) + + + Control Pictures (x2400 to x243f) + + + Enclosed Alphanumerics (x2460 to x24ff) + + + Geometric Shapes (x25a0 to x25f7, partial) + + + Miscellaneous Symbols (x2600 to x26ff, partial) + + + Dingbats (x2700 to x27be, partial) + + + Alphabetic Presentation Forms (xfb00 to xfb04 only) + + + + + + +@*[local-name() = 'block'] = 'Miscellaneous Technical' or +(@*[local-name() = 'block'] = 'C1 Controls And Latin-1 Supplement (Latin-1 Supplement)' and + @*[local-name() = 'class'] = 'symbols' +) or +(@*[local-name() = 'block'] = 'General Punctuation' and + (@*[local-name() = 'class'] = 'spaces' or + @*[local-name() = 'class'] = 'dashes' or + @*[local-name() = 'class'] = 'quotes' or + @*[local-name() = 'class'] = 'bullets' + ) +) or +@*[local-name() = 'name'] = 'HORIZONTAL ELLIPSIS' or +@*[local-name() = 'name'] = 'WORD JOINER' or +@*[local-name() = 'name'] = 'SERVICE MARK' or +@*[local-name() = 'name'] = 'TRADE MARK SIGN' or +@*[local-name() = 'name'] = 'ZERO WIDTH NO-BREAK SPACE' + + + +man.string.subst.map +string + +man.string.subst.map +Specifies a set of string substitutions + + +Description + +The man.string.subst.map parameter +contains a map that specifies a set of +string substitutions to perform over the entire roff source for each +man page, either just before generating final man-page output (that +is, before writing man-page files to disk) or, if the value of the +man.charmap.enabled parameter is non-zero, +before applying the roff character map. + +You can use man.string.subst.map as a +"lightweight" character map to perform "essential" substitutions -- +that is, substitutions that are always performed, +even if the value of the man.charmap.enabled +parameter is zero. For example, you can use it to replace quotation +marks or other special characters that are generated by the DocBook +XSL stylesheets for a particular locale setting (as opposed to those +characters that are actually in source XML documents), or to replace +any special characters that may be automatically generated by a +particular customization of the DocBook XSL stylesheets. + + + Do you not change value of the + man.string.subst.map parameter unless + you are sure what you are doing. If you remove any of the default + mappings, you are likely to end up with broken output. And be very + careful about adding anything to it. Because it is used for doing + string substitution over the entire roff source of each man page, it + causes target strings to be replaced in roff requests and escapes, + not just in the visible contents. + + In particular, do not attempt to add a mapping for the + dot/period character. Doing so will break your output. For an + explanation, see . + + + + + Contents of the substitution map + The string-substitution map contains one or more substitution elements, each of which has two attributes: + + + oldstring + + string to replace + + + + newstring + + string with which to replace oldstring + + + + It may also include XML comments (that is, delimited with + "<!--" and "-->"). + + + + + About adding backslashes before dots + The stylesheets do not add backslashes before + periods/dots. One reason is that, because string substitution is + performed over the entire roff source of each man page, it would be + complicated to replace dots in visible contents without also causing + them to be replaced in roff requests and escapes; for example, + without causing, say, the .TH roff macro to be + replaced with \.TH. Additionally, backslashes in + front of periods/dots are needed only in the very rare case where a + period is the very first character in a line, without any space in + front of it. A better way to deal with that rare case is to add a + zero-width space in front of the offending dot(s) in your + source. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +refentry.meta.get.quietly + + +refentry.meta.get.quietly +Suppress notes and warnings when gathering refentry metadata? + + +Description + +If zero (the default), notes and warnings about “missing” markup +are generated during gathering of refentry metadata. If non-zero, the +metadata is gathered “quietly” -- that is, the notes and warnings are +suppressed. + + + If you are processing a large amount of refentry + content, you may be able to speed up processing significantly by + setting a non-zero value for + refentry.meta.get.quietly. + + + + + + + +refentry.date.profile +string + +refentry.date.profile +Specifies profile for refentry "date" data + + +Description + +The value of refentry.date.profile is a +string representing an XPath expression. It is evaluated at run-time +and used only if refentry.date.profile.enabled +is non-zero. Otherwise, the refentry metadata-gathering +logic "hard coded" into the stylesheets is used. + + The man(7) man page describes this content +as "the date of the last revision". In man pages, it is the content +that is usually displayed in the center footer. + + + + + (($info[//date])[last()]/date)[1]| + (($info[//pubdate])[last()]/pubdate)[1] + + + +refentry.date.profile.enabled +boolean + +refentry.date.profile.enabled +Enable refentry "date" profiling? + + +Description + +If the value of +refentry.date.profile.enabled is non-zero, then +during refentry metadata gathering, the info profile +specified by the customizable +refentry.date.profile parameter is used. + +If instead the value of +refentry.date.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "date" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "date" data to show +up in your output, then consider setting a non-zero value for +refentry.date.profile.enabled and adjusting the +value of refentry.date.profile to cause correct +data to be gathered. + +Note that the terms "source" and "date" have special meanings in +this context. For details, see the documentation for the +refentry.date.profile parameter. + + + +0 + + +refentry.manual.profile +string + +refentry.manual.profile +Specifies profile for refentry "manual" data + + +Description + +The value of refentry.manual.profile is +a string representing an XPath expression. It is evaluated at +run-time and used only if +refentry.manual.profile.enabled is +non-zero. Otherwise, the refentry metadata-gathering logic +"hard coded" into the stylesheets is used. + +In man pages, this content is usually displayed in the middle of +the header of the page. The man(7) man page +describes this as "the title of the manual (e.g., Linux +Programmer's Manual)". Here are some examples from +existing man pages: + + + dpkg utilities + (dpkg-name) + + + User Contributed Perl Documentation + (GET) + + + GNU Development Tools + (ld) + + + Emperor Norton Utilities + (ddate) + + + Debian GNU/Linux manual + (faked) + + + GIMP Manual Pages + (gimp) + + + KDOC Documentation System + (qt2kdoc) + + + + + + + + (($info[//title])[last()]/title)[1]| + ../title/node() + + + +refentry.manual.profile.enabled +boolean + +refentry.manual.profile.enabled +Enable refentry "manual" profiling? + + +Description + +If the value of +refentry.manual.profile.enabled is +non-zero, then during refentry metadata gathering, the info +profile specified by the customizable +refentry.manual.profile parameter is +used. + +If instead the value of +refentry.manual.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "manual" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "manual" data to show +up in your output, then consider setting a non-zero value for +refentry.manual.profile.enabled and adjusting +the value of refentry.manual.profile to cause +correct data to be gathered. + +Note that the term "manual" has a special meanings in this +context. For details, see the documentation for the +refentry.manual.profile parameter. + + + +0 + + +refentry.source.name.suppress +boolean + +refentry.source.name.suppress +Suppress "name" part of refentry "source" contents? + + +Description + +If the value of +refentry.source.name.suppress is non-zero, then +during refentry metadata gathering, no "source name" data +is added to the refentry "source" contents. Instead (unless +refentry.version.suppress is also non-zero), +only "version" data is added to the "source" contents. + +If you find that the refentry metadata gathering +mechanism is causing unwanted "source name" data to show up in your +output -- for example, in the footer (or possibly header) of a man +page -- then you might consider setting a non-zero value for +refentry.source.name.suppress. + +Note that the terms "source", "source name", and "version" have +special meanings in this context. For details, see the documentation +for the refentry.source.name.profile +parameter. + + + +0 + + +refentry.source.name.profile +string + +refentry.source.name.profile +Specifies profile for refentry "source name" data + + +Description + +The value of refentry.source.name.profile +is a string representing an XPath expression. It is evaluated at +run-time and used only if +refentry.source.name.profile.enabled is +non-zero. Otherwise, the refentry metadata-gathering logic +"hard coded" into the stylesheets is used. + +A "source name" is one part of a (potentially) two-part +Name Version +"source" field. In man pages, it is usually displayed in the left +footer of the page. It typically indicates the software system or +product that the item documented in the man page belongs to. The +man(7) man page describes it as "the source of +the command", and provides the following examples: + + + For binaries, use something like: GNU, NET-2, SLS + Distribution, MCC Distribution. + + + For system calls, use the version of the kernel that you + are currently looking at: Linux 0.99.11. + + + For library calls, use the source of the function: GNU, BSD + 4.3, Linux DLL 4.4.1. + + + + +In practice, there are many pages that simply have a Version +number in the "source" field. So, it looks like what we have is a +two-part field, +Name Version, +where: + + + Name + + product name (e.g., BSD) or org. name (e.g., GNU) + + + + Version + + version number + + + +Each part is optional. If the Name is a +product name, then the Version is probably +the version of the product. Or there may be no +Name, in which case, if there is a +Version, it is probably the version +of the item itself, not the product it is part of. Or, if the +Name is an organization name, then there +probably will be no Version. + + + + (($info[//productname])[last()]/productname)[1]| + (($info[//corpname])[last()]/corpname)[1]| + (($info[//corpcredit])[last()]/corpcredit)[1]| + (($info[//corpauthor])[last()]/corpauthor)[1]| + (($info[//orgname])[last()]/orgname)[1]| + (($info[//publishername])[last()]/publishername)[1] + + + +refentry.source.name.profile.enabled +boolean + +refentry.source.name.profile.enabled +Enable refentry "source name" profiling? + + +Description + +If the value of +refentry.source.name.profile.enabled is +non-zero, then during refentry metadata gathering, the info +profile specified by the customizable +refentry.source.name.profile parameter is +used. + +If instead the value of +refentry.source.name.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "source name" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "source name" data to +show up in your output, then consider setting a non-zero value for +refentry.source.name.profile.enabled and +adjusting the value of +refentry.source.name.profile to cause correct +data to be gathered. + +Note that the terms "source" and "source name" have special +meanings in this context. For details, see the documentation for the +refentry.source.name.profile parameter. + + + +0 + + +refentry.version.suppress +boolean + +refentry.version.suppress +Suppress "version" part of refentry "source" contents? + + +Description + +If the value of refentry.version.suppress +is non-zero, then during refentry metadata gathering, no +"version" data is added to the refentry "source" +contents. Instead (unless +refentry.source.name.suppress is also +non-zero), only "source name" data is added to the "source" +contents. + +If you find that the refentry metadata gathering +mechanism is causing unwanted "version" data to show up in your output +-- for example, in the footer (or possibly header) of a man page -- +then you might consider setting a non-zero value for +refentry.version.suppress. + +Note that the terms "source", "source name", and "version" have +special meanings in this context. For details, see the documentation +for the refentry.source.name.profile +parameter. + + + +0 + + +refentry.version.profile +string + +refentry.version.profile +Specifies profile for refentry "version" data + + +Description + +The value of refentry.version.profile is +a string representing an XPath expression. It is evaluated at +run-time and used only if +refentry.version.profile.enabled is +non-zero. Otherwise, the refentry metadata-gathering logic +"hard coded" into the stylesheets is used. + +A "source.name" is one part of a (potentially) two-part +Name Version +"source" field. For more details, see the documentation for the +refentry.source.name.profile parameter. + + + + + (($info[//productnumber])[last()]/productnumber)[1]| + (($info[//edition])[last()]/edition)[1]| + (($info[//releaseinfo])[last()]/releaseinfo)[1] + + + +refentry.version.profile.enabled +boolean + +refentry.version.profile.enabled +Enable refentry "version" profiling? + + +Description + +If the value of +refentry.version.profile.enabled is +non-zero, then during refentry metadata gathering, the info +profile specified by the customizable +refentry.version.profile parameter is +used. + +If instead the value of +refentry.version.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "version" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "version" data to show +up in your output, then consider setting a non-zero value for +refentry.version.profile.enabled and adjusting +the value of refentry.version.profile to cause +correct data to be gathered. + +Note that the terms "source" and "version" have special +meanings in this context. For details, see the documentation for the +refentry.version.profile parameter. + + + +0 + + +refentry.manual.fallback.profile +string + +refentry.manual.fallback.profile +Specifies profile of "fallback" for refentry "manual" data + + +Description + +The value of +refentry.manual.fallback.profile is a string +representing an XPath expression. It is evaluated at run-time and +used only if no "manual" data can be found by other means (that is, +either using the refentry metadata-gathering logic "hard +coded" in the stylesheets, or the value of +refentry.manual.profile, if it is +enabled). + + +Depending on which XSLT engine you run, either the EXSLT +dyn:evaluate extension function (for xsltproc or +Xalan) or saxon:evaluate extension function (for +Saxon) are used to dynamically evaluate the value of +refentry.manual.fallback.profile at +run-time. If you don't use xsltproc, Saxon, Xalan -- or some other +XSLT engine that supports dyn:evaluate -- you +must manually disable fallback processing by setting an empty value +for the refentry.manual.fallback.profile +parameter. + + + + + +refmeta/refmiscinfo[1]/node() + + +refentry.source.fallback.profile +string + +refentry.source.fallback.profile +Specifies profile of "fallback" for refentry "source" data + + +Description + +The value of +refentry.source.fallback.profile is a string +representing an XPath expression. It is evaluated at run-time and used +only if no "source" data can be found by other means (that is, either +using the refentry metadata-gathering logic "hard coded" in +the stylesheets, or the value of the +refentry.source.name.profile and +refentry.version.profile parameters, if those +are enabled). + + +Depending on which XSLT engine you run, either the EXSLT +dyn:evaluate extension function (for xsltproc or +Xalan) or saxon:evaluate extension function (for +Saxon) are used to dynamically evaluate the value of +refentry.source.fallback.profile at +run-time. If you don't use xsltproc, Saxon, Xalan -- or some other +XSLT engine that supports dyn:evaluate -- you +must manually disable fallback processing by setting an empty value +for the refentry.source.fallback.profile +parameter. + + + + + +refmeta/refmiscinfo[1]/node() + + +man.th.extra1.suppress +boolean + +man.th.extra1.suppress +Suppress extra1 part of header/footer? + + +Description + +If the value of man.th.extra1.suppress is +non-zero, then the extra1 part of the +.TH title line header/footer is suppressed. + +The content of the extra1 field is almost +always displayed in the center footer of the page and is, universally, +a date. + + + +0 + + +man.th.extra2.suppress +boolean + +man.th.extra2.suppress +Suppress extra2 part of header/footer? + + +Description + +If the value of man.th.extra2.suppress is +non-zero, then the extra2 part of the +.TH title line header/footer is suppressed. + +The content of the extra2 field is usually +displayed in the left footer of the page and is typically "source" +data, often in the form +Name Version; +for example, "GTK+ 1.2" (from the gtk-options(7) +man page). + + + You can use the + refentry.source.name.suppress and + refentry.version.suppress parameters to + independently suppress the Name and + Version parts of the + extra2 field. + + + + +0 + + +man.th.extra3.suppress +boolean + +man.th.extra3.suppress +Suppress extra3 part of header/footer? + + +Description + +If the value of man.th.extra3.suppress is +non-zero, then the extra3 part of the +.TH title line header/footer is +suppressed. + +The content of the extra3 field is usually +displayed in the middle header of the page and is typically a "manual +name"; for example, "GTK+ User's Manual" (from the +gtk-options(7) man page). + + + +0 + + +man.th.title.max.length +integer + +man.th.title.max.length +Maximum length of title in header/footer + + +Description + +Specifies the maximum permitted length of the title part of the +man-page .TH title line header/footer. If the title +exceeds the maxiumum specified, it is truncated down to the maximum +permitted length. + + + Details + +Every man page generated using the DocBook stylesheets has a +title line, specified using the TH roff +macro. Within that title line, there is always, at a minimum, a title, +followed by a section value (representing a man "section" -- usually +just a number). + +The title and section are displayed, together, in the visible +header of each page. Where in the header they are displayed depends on +OS the man page is viewed on, and on what version of nroff/groff/man +is used for viewing the page. But, at a minimum and across all +systems, the title and section are displayed on the right-hand column +of the header. On many systems -- those with a modern groff, including +Linux systems -- they are displayed twice: both in the left and right +columns of the header. + +So if the length of the title exceeds a certain percentage of +the column width in which the page is viewed, the left and right +titles can end up overlapping, making them unreadable, or breaking to +another line, which doesn't look particularly good. + +So the stylesheets provide the +man.th.title.max.length parameter as a means +for truncating titles that exceed the maximum length that can be +viewing properly in a page header. + +The default value is reasonable but somewhat arbitrary. If you +have pages with long titles, you may want to experiment with changing +the value in order to achieve the correct aesthetic results. + + + + +20 + + +man.th.extra2.max.length +integer + +man.th.extra2.max.length +Maximum length of extra2 in header/footer + + +Description + +Specifies the maximum permitted length of the +extra2 part of the man-page part of the +.TH title line header/footer. If the +extra2 content exceeds the maxiumum specified, it +is truncated down to the maximum permitted length. + +The content of the extra2 field is usually +displayed in the left footer of the page and is typically "source" +data indicating the software system or product that the item +documented in the man page belongs to, often in the form +Name Version; +for example, "GTK+ 1.2" (from the gtk-options(7) +man page). + +The default value for this parameter is reasonable but somewhat +arbitrary. If you are processing pages with long "source" information, +you may want to experiment with changing the value in order to achieve +the correct aesthetic results. + + +30 + + +man.th.extra3.max.length +integer + +man.th.extra3.max.length +Maximum length of extra3 in header/footer + + +Description + +Specifies the maximum permitted length of the +extra3 part of the man-page .TH +title line header/footer. If the extra3 content +exceeds the maxiumum specified, it is truncated down to the maximum +permitted length. + +The content of the extra3 field is usually +displayed in the middle header of the page and is typically a "manual +name"; for example, "GTK+ User's Manual" (from the +gtk-options(7) man page). + +The default value for this parameter is reasonable but somewhat +arbitrary. If you are processing pages with long "manual names" -- or +especially if you are processing pages that have both long "title" +parts (command/function, etc. names) and long +manual names -- you may want to experiment with changing the value in +order to achieve the correct aesthetic results. + + +30 + + + man.output.manifest.enabled + boolean + + man.output.manifest.enabled + Generate a manifest file? + + + Description + + If non-zero, a list of filenames for man pages generated by + the stylesheet transformation is written to the file named by the + man.output.manifest.filename parameter. + + + + + + + man.output.manifest.filename + string + + man.output.manifest.filename + Name of manifest file + + + Description + + The man.output.manifest.filename parameter + specifies the name of the file to which the manpages manifest file + is written (if the value of the + man.output.manifest.enabled parameter is + non-zero). + + + +MAN.MANIFEST + + +man.output.in.separate.dir + + +man.output.in.separate.dir +Output man-page files in separate output directory? + + +Description + +If the value of man.output.in.separate.dir +parameter is non-zero, man-page files are output in a separate +directory, specified by the man.output.base.dir +parameter; otherwise, if the value of +man.output.in.separate.dir is zero, man-page files +are not output in a separate directory. + + + + + + +man.output.base.dir + + +man.output.base.dir +Specifies separate output directory + + +Description + +The man.output.base.dir parameter +specifies the base directory into which man-page files are output. The +man.output.subdirs.enabled parameter controls +whether the files are output in subdirectories within the base +directory. + + + The values of the man.output.base.dir + and man.output.subdirs.enabled parameters are + used only if the value of + man.output.in.separate.dir parameter is + non-zero. If the value of the + man.output.in.separate.dir is zero, man-page + files are not output in a separate directory. + + + + +man/ + + +man.output.subdirs.enabled + + +man.output.subdirs.enabled +Output man-page files in subdirectories within base output directory? + + +Description + +The man.output.subdirs.enabled parameter +controls whether man-pages files are output in subdirectories within +the base directory specified by the directory specified by the +man.output.base.dir parameter. + + + The values of the man.output.base.dir + and man.output.subdirs.enabled parameters are + used only if the value of + man.output.in.separate.dir parameter is + non-zero. If the value of the + man.output.in.separate.dir is zero, man-page + files are not output in a separate directory. + + + + + + + +man.output.quietly + + +man.output.quietly +Suppress filename messages emitted when generating output? + + +Description + +If zero (the default), for each man-page file created, a message +with the name of the file is emitted. If non-zero, the files are +output "quietly" -- that is, the filename messages are +suppressed. + + + If you are processing a large amount of refentry + content, you may be able to speed up processing significantly by + setting a non-zero value for + man.output.quietly. + + + + + + + +man.output.encoding +string + +man.output.encoding +Encoding used for man-page output + + +Description + +This parameter specifies the encoding to use for files generated +by the manpages stylesheet. Not all processors support specification +of this parameter. + + + If the value of the man.charmap.enabled + parameter is non-zero (the default), keeping the + man.output.encoding parameter at its default + value (UTF-8) or setting it to + UTF-16 does not cause your + man pages to be output in raw UTF-8 or UTF-16 -- because + any Unicode characters for which matches are found in the enabled + character map will be replaced with roff escape sequences before the + final man-page files are generated. + + So if you want to generate "real" UTF-8 man pages, without any + character substitution being performed on your content, you need to + set man.charmap.enabled to zero (which will + completely disable character-map processing). + + You may also need to set + man.charmap.enabled to zero if you want to + output man pages in an encoding other than UTF-8 + or UTF-16. Character-map processing is based on + Unicode character values and may not work with other output + encodings. + + + + + + + +man.table.footnotes.divider +string + +man.table.footnotes.divider +Specifies divider string that appears before table footnotes + + +Description + +In each table that contains footenotes, the string specified by +the man.table.footnotes.divider parameter is +output before the list of footnotes for the table. + + + +---- + + +man.subheading.divider.enabled +string + +man.subheading.divider.enabled +Add divider comment to roff source before/after subheadings? + + +Description + +If the value of the +man.subheading.divider.enabled parameter is +non-zero, the contents of the +man.subheading.divider parameter are used to +add a "divider" before and after subheadings in the roff +output. The divider is not visisble in the +rendered man page; it is added as a comment, in the source, +simply for the purpose of increasing reability of the source. + +If man.subheading.divider.enabled is zero +(the default), the subheading divider is suppressed. + + + +0 + + +man.subheading.divider +string + +man.subheading.divider +Specifies string to use as divider comment before/after subheadings + + +Description + +If the value of the +man.subheading.divider.enabled parameter is +non-zero, the contents of the +man.subheading.divider parameter are used to +add a "divider" before and after subheadings in the roff +output. The divider is not visisble in the +rendered man page; it is added as a comment, in the source, +simply for the purpose of increasing reability of the source. + +If man.subheading.divider.enabled is zero +(the default), the subheading divider is suppressed. + + + +======================================================================== +                   \ No newline at end of file diff --git a/src/documentation/docbook-xsl/manpages/param.xweb b/src/documentation/docbook-xsl/manpages/param.xweb new file mode 100644 index 0000000000..65109e6381 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/param.xweb @@ -0,0 +1,200 @@ + +%param.ent; +]> + + + + Manpages Parameter Reference + + $Id: param.xweb,v 1.24 2006/04/26 04:38:28 xmldoc Exp $ + + + The DocBook Project + + + 2005 + The DocBook Project + + + + + Introduction + + This is reference documentation for all user-configurable + parameters in the DocBook XSL "manpages" stylesheets (for + generating groff/nroff output). + + + + + Hyphenation, justification, and breaking +&man.hyphenate; +&man.hyphenate.urls; +&man.hyphenate.filenames; +&man.hyphenate.computer.inlines; +&man.justify; +&man.break.after.slash; + + + Indentation +&man.indent.width; +&man.indent.refsect; +&man.indent.blurbs; +&man.indent.lists; +&man.indent.verbatims; + + + Fonts +&man.font.funcprototype; +&man.font.funcsynopsisinfo; +&man.font.table.headings; +&man.font.table.title; + + + Link handling +&man.links.are.numbered; +&man.links.are.underlined; +&man.links.list.enabled; +&man.links.list.heading; + + + Lists +&man.segtitle.suppress; +&variablelist.term.separator; +&variablelist.term.break.after; + + + Character/string substitution +&man.charmap.enabled; +&man.charmap.uri; +&man.charmap.use.subset; +&man.charmap.subset.profile; +&man.string.subst.map; + + + Refentry metadata gathering +&refentry.meta.get.quietly; +&refentry.date.profile; +&refentry.date.profile.enabled; +&refentry.manual.profile; +&refentry.manual.profile.enabled; +&refentry.source.name.suppress; +&refentry.source.name.profile; +&refentry.source.name.profile.enabled; +&refentry.version.suppress; +&refentry.version.profile; +&refentry.version.profile.enabled; +&refentry.manual.fallback.profile; +&refentry.source.fallback.profile; + + + Page header/footer +&man.th.extra1.suppress; +&man.th.extra2.suppress; +&man.th.extra3.suppress; +&man.th.title.max.length; +&man.th.extra2.max.length; +&man.th.extra3.max.length; + + + Output +&man.output.manifest.enabled; +&man.output.manifest.filename; +&man.output.in.separate.dir; +&man.output.base.dir; +&man.output.subdirs.enabled; +&man.output.quietly; +&man.output.encoding; + + + Other +&man.table.footnotes.divider; +&man.subheading.divider.enabled; +&man.subheading.divider; + + + The Stylesheet + + The param.xsl stylesheet is just a + wrapper around all of these parameters. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/manpages/refentry.xsl b/src/documentation/docbook-xsl/manpages/refentry.xsl new file mode 100644 index 0000000000..1159c34a31 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/refentry.xsl @@ -0,0 +1,258 @@ + + + + + + + + + + + + + .br + + + + .SH " + + " + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + .SH " + + " + + + + + + + .SH " + + " + + + + + + + + + + .SS " + + " + + + + + + .RS + + .RE + + + + + + + + + + + + + .\" end of SS subsection " + + " + + + + + + + + + + + + .RS + + .RE + + + + + + + + + + .ti (\n(SNu * 5u / 3u) + + + + + .\" end of subsection " + + " + + + + + + + + + + + + + + + (\n(SNu) + + + + .RS (\n(SNu) + + .RE + .\" end of subsection " + + " + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/manpages/synop.xsl b/src/documentation/docbook-xsl/manpages/synop.xsl new file mode 100644 index 0000000000..2c2260ba65 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/synop.xsl @@ -0,0 +1,305 @@ + + + + + + | + + + + + + + + + + + ( + + ) +   + + + + + + + + + + + + + + + + + + + + + + .sp -1n + + .HP + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + .br + + + + + + .ad l + + + + .hy 0 + + .HP + + + + + + + .ad + + + + .hy + + + + + + + + + + + + + + + + + + .ad l + + + + .hy 0 + + + + + .ad + + + + .hy + + + + + + + + + + + + + + + + + + + + + + + + + + + + .HP + + + + + . + + + + + + + + " + + ( + + " + + + + + + + + + + + + + void); + + + + ...); + + + + + + + , + + + ); + + + + + + + + + + + + + + + " " + + " " + + + + ( + + ) + + + diff --git a/src/documentation/docbook-xsl/manpages/table.xsl b/src/documentation/docbook-xsl/manpages/table.xsl new file mode 100644 index 0000000000..8a93161041 --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/table.xsl @@ -0,0 +1,563 @@ + + + + + + + : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + allbox + + + + + + + + center + + + + + + + + expand + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   +                   + + + + + + + +                   +                   + + + + + + + + + + + + + + + + + + .PP + . + + + + *[nested table] + + + + .sp -1n + + + + + .TS + + + H + + + + + + + + + + + tab( + + ) + + + + ; + + + + + + + + + + + + + + + + .TH + + + + + + + + + + + .T& + + + + + + + + + + + + + + + + + + + + + + .TE + + .sp + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + T{ + + T} + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warn + + + tbl convert : Extracted a nested table + + + [\fInested table\fR]* + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + . + + + + + + + + + + + + + + + + + + + + + + + ^ + + + c + + + r + + + n + + + + l + + + + + + + + t + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ^ + + + + s + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/manpages/utility.xsl b/src/documentation/docbook-xsl/manpages/utility.xsl new file mode 100644 index 0000000000..dbb90f406d --- /dev/null +++ b/src/documentation/docbook-xsl/manpages/utility.xsl @@ -0,0 +1,268 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + \fB + + \fR + + + + + + \fI + + \fR + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \% + + + + + + + + + + + .sp + .it 1 an-trap + .nr an-no-space-flag 1 + .nr an-break-flag 1 + .br + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + .sp + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + .\" + + + + + + diff --git a/src/documentation/docbook-xsl/params/abstract.properties.xml b/src/documentation/docbook-xsl/params/abstract.properties.xml new file mode 100644 index 0000000000..55ebb36ebf --- /dev/null +++ b/src/documentation/docbook-xsl/params/abstract.properties.xml @@ -0,0 +1,23 @@ + + +abstract.properties +Properties associated with the block surrounding an abstract + + + + + + 0.0in + 0.0in + + + + +Description + +Block styling properties for abstract. + +See also abstract.title.properties. + + + diff --git a/src/documentation/docbook-xsl/params/abstract.title.properties.xml b/src/documentation/docbook-xsl/params/abstract.title.properties.xml new file mode 100644 index 0000000000..b28110ef52 --- /dev/null +++ b/src/documentation/docbook-xsl/params/abstract.title.properties.xml @@ -0,0 +1,38 @@ + + +abstract.title.properties +attribute set + + +abstract.title.properties +Properties for abstract titles + + + + + + + bold + always + always + + + + false + center + + + + +Description + +The properties for abstract titles. + +See also abstract.properties. + + + diff --git a/src/documentation/docbook-xsl/params/admon.graphics.extension.xml b/src/documentation/docbook-xsl/params/admon.graphics.extension.xml new file mode 100644 index 0000000000..3eb973f0a9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/admon.graphics.extension.xml @@ -0,0 +1,20 @@ + + +admon.graphics.extension +string + + +admon.graphics.extension +Extension for admonition graphics + + + + + + +Description + +Sets the extension to use on admonition graphics. + + + diff --git a/src/documentation/docbook-xsl/params/admon.graphics.path.xml b/src/documentation/docbook-xsl/params/admon.graphics.path.xml new file mode 100644 index 0000000000..a0df85b4d3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/admon.graphics.path.xml @@ -0,0 +1,22 @@ + + +admon.graphics.path +string + + +admon.graphics.path +Path to admonition graphics + + + +images/ + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the admonition graphics. + + + + diff --git a/src/documentation/docbook-xsl/params/admon.graphics.xml b/src/documentation/docbook-xsl/params/admon.graphics.xml new file mode 100644 index 0000000000..eb2bc2b194 --- /dev/null +++ b/src/documentation/docbook-xsl/params/admon.graphics.xml @@ -0,0 +1,24 @@ + + +admon.graphics +boolean + + +admon.graphics +Use graphics in admonitions? + + + + + + + + +Description + +If true (non-zero), admonitions are presented in an alternate style that uses +a graphic. Default graphics are provided in the distribution. + + + + diff --git a/src/documentation/docbook-xsl/params/admon.style.xml b/src/documentation/docbook-xsl/params/admon.style.xml new file mode 100644 index 0000000000..a49c7f34bc --- /dev/null +++ b/src/documentation/docbook-xsl/params/admon.style.xml @@ -0,0 +1,24 @@ + + +admon.style +string + + +admon.style +CSS style attributes for admonitions + + + + + margin-left: 0.5in; margin-right: 0.5in; + + + +Description + +Specifies the value of the STYLE +attribute that should be added to admonitions. + + + + diff --git a/src/documentation/docbook-xsl/params/admon.textlabel.xml b/src/documentation/docbook-xsl/params/admon.textlabel.xml new file mode 100644 index 0000000000..744b258ab2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/admon.textlabel.xml @@ -0,0 +1,28 @@ + + +admon.textlabel +boolean + + +admon.textlabel +Use text label in admonitions? + + + + + + + + +Description + +If true (non-zero), admonitions are presented with a generated +text label such as Note or Warning in the appropriate language. +If zero, such labels are turned off, but any title child +of the admonition element are still output. +The default value is 1. + + + + + diff --git a/src/documentation/docbook-xsl/params/admonition.properties.xml b/src/documentation/docbook-xsl/params/admonition.properties.xml new file mode 100644 index 0000000000..e127e56524 --- /dev/null +++ b/src/documentation/docbook-xsl/params/admonition.properties.xml @@ -0,0 +1,16 @@ + + +admonition.properties +To set the style for admonitions. + + + + + + +Description +How do you want admonitions styled? +Set the font-size, weight, etc. to the style required + + + diff --git a/src/documentation/docbook-xsl/params/admonition.title.properties.xml b/src/documentation/docbook-xsl/params/admonition.title.properties.xml new file mode 100644 index 0000000000..851391b363 --- /dev/null +++ b/src/documentation/docbook-xsl/params/admonition.title.properties.xml @@ -0,0 +1,22 @@ + + +admonition.title.properties +To set the style for admonitions titles. + + + + + + 14pt + bold + false + always + + + +Description +How do you want admonitions titles styled? +Set the font-size, weight etc to the style required. + + + diff --git a/src/documentation/docbook-xsl/params/alignment.xml b/src/documentation/docbook-xsl/params/alignment.xml new file mode 100644 index 0000000000..ab304dcf6a --- /dev/null +++ b/src/documentation/docbook-xsl/params/alignment.xml @@ -0,0 +1,21 @@ + + +alignment + + + +alignment +Specify the default text alignment + + + +justify + + +Description + +The default text alignment is used for most body text. + + + + diff --git a/src/documentation/docbook-xsl/params/annotate.toc.xml b/src/documentation/docbook-xsl/params/annotate.toc.xml new file mode 100644 index 0000000000..a6dec4ad66 --- /dev/null +++ b/src/documentation/docbook-xsl/params/annotate.toc.xml @@ -0,0 +1,23 @@ + + +annotate.toc +boolean + + +annotate.toc +Annotate the Table of Contents? + + + + + + +Description + +If true, TOCs will be annotated. At present, this just means +that the RefPurpose of RefEntry +TOC entries will be displayed. + + + + diff --git a/src/documentation/docbook-xsl/params/annotation.css.xml b/src/documentation/docbook-xsl/params/annotation.css.xml new file mode 100644 index 0000000000..864ded7f30 --- /dev/null +++ b/src/documentation/docbook-xsl/params/annotation.css.xml @@ -0,0 +1,66 @@ + + +annotation.css +boolean + + +annotation.css +Enable annotations? + + + + + +/* ====================================================================== + Annotations +*/ + +div.annotation-list { visibility: hidden; + } + +div.annotation-nocss { position: absolute; + visibility: hidden; + } + +div.annotation-popup { position: absolute; + z-index: 4; + visibility: hidden; + padding: 0px; + margin: 2px; + border-style: solid; + border-width: 1px; + width: 200px; + background-color: white; + } + +div.annotation-title { padding: 1px; + font-weight: bold; + border-bottom-style: solid; + border-bottom-width: 1px; + color: white; + background-color: black; + } + +div.annotation-body { padding: 2px; + } + +div.annotation-body p { margin-top: 0px; + padding-top: 0px; + } + +div.annotation-close { position: absolute; + top: 2px; + right: 2px; + } + + + + +Description + +If annotation.support is enabled and the +document contains annotations, then the CSS in this +parameter will be included in the document. + + + diff --git a/src/documentation/docbook-xsl/params/annotation.graphic.close.xml b/src/documentation/docbook-xsl/params/annotation.graphic.close.xml new file mode 100644 index 0000000000..1d86d4563c --- /dev/null +++ b/src/documentation/docbook-xsl/params/annotation.graphic.close.xml @@ -0,0 +1,24 @@ + + +annotation.graphic.close +boolean + + +annotation.graphic.close +Enable annotations? + + + + + + + + +Description + +This image is used on popup annotations as the “x” that the +user can click to dismiss the popup. + + + diff --git a/src/documentation/docbook-xsl/params/annotation.graphic.open.xml b/src/documentation/docbook-xsl/params/annotation.graphic.open.xml new file mode 100644 index 0000000000..82c8441e4c --- /dev/null +++ b/src/documentation/docbook-xsl/params/annotation.graphic.open.xml @@ -0,0 +1,24 @@ + + +annotation.graphic.open +boolean + + +annotation.graphic.open +Enable annotations? + + + + + + + + +Description + +This image is used inline to identify the location of +annotations. + + + diff --git a/src/documentation/docbook-xsl/params/annotation.js.xml b/src/documentation/docbook-xsl/params/annotation.js.xml new file mode 100644 index 0000000000..fc537958fa --- /dev/null +++ b/src/documentation/docbook-xsl/params/annotation.js.xml @@ -0,0 +1,27 @@ + + +annotation.js +boolean + + +annotation.js +Enable annotations? + + + + + + + + +Description + +If annotation.support is enabled and the +document contains annotations, then the URIs listed +in this parameter will be included. These JavaScript files are required +for popup annotation support. + + + diff --git a/src/documentation/docbook-xsl/params/annotation.support.xml b/src/documentation/docbook-xsl/params/annotation.support.xml new file mode 100644 index 0000000000..cd6e626f5d --- /dev/null +++ b/src/documentation/docbook-xsl/params/annotation.support.xml @@ -0,0 +1,24 @@ + + +annotation.support +boolean + + +annotation.support +Enable annotations? + + + + + + + + +Description + +If non-zero, the stylesheets will attempt to support annotation +elements in HTML by including some JavaScript (see +annotation.js). + + + diff --git a/src/documentation/docbook-xsl/params/appendix.autolabel.xml b/src/documentation/docbook-xsl/params/appendix.autolabel.xml new file mode 100644 index 0000000000..b974c70e3a --- /dev/null +++ b/src/documentation/docbook-xsl/params/appendix.autolabel.xml @@ -0,0 +1,62 @@ + + +appendix.autolabel +boolean + + +appendix.autolabel +Specifies the labeling format for Appendix titles + + + + + + + + +Description + +If zero, then appendices will not be numbered. +Otherwise appendices will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperalpha). + + + + diff --git a/src/documentation/docbook-xsl/params/arbortext.extensions.xml b/src/documentation/docbook-xsl/params/arbortext.extensions.xml new file mode 100644 index 0000000000..69755e967a --- /dev/null +++ b/src/documentation/docbook-xsl/params/arbortext.extensions.xml @@ -0,0 +1,25 @@ + + +arbortext.extensions +boolean + + +arbortext.extensions +Enable Arbortext extensions? + + + + + + +Description + +If non-zero, +Arbortext +extensions will be used. + +This parameter can also affect which graphics file formats +are supported + + + diff --git a/src/documentation/docbook-xsl/params/article.appendix.title.properties.xml b/src/documentation/docbook-xsl/params/article.appendix.title.properties.xml new file mode 100644 index 0000000000..006f2bb45e --- /dev/null +++ b/src/documentation/docbook-xsl/params/article.appendix.title.properties.xml @@ -0,0 +1,31 @@ + + +article.appendix.title.properties +attribute set + + +article.appendix.title.properties +Properties for appendix titles that appear in an article + + + + + + + + + + + + +Description + +The properties for the title of an appendix that +appears inside an article. The default is to use +the properties of sect1 titles. + + + + diff --git a/src/documentation/docbook-xsl/params/author.othername.in.middle.xml b/src/documentation/docbook-xsl/params/author.othername.in.middle.xml new file mode 100644 index 0000000000..60300224b8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/author.othername.in.middle.xml @@ -0,0 +1,25 @@ + + +author.othername.in.middle +boolean + + +author.othername.in.middle +Is othername in author a +middle name? + + + + + + +Description + +If true (non-zero), the othername of an author +appears between the firstname and +surname. Otherwise, othername +is suppressed. + + + + diff --git a/src/documentation/docbook-xsl/params/autotoc.label.in.hyperlink.xml b/src/documentation/docbook-xsl/params/autotoc.label.in.hyperlink.xml new file mode 100644 index 0000000000..15f93d0869 --- /dev/null +++ b/src/documentation/docbook-xsl/params/autotoc.label.in.hyperlink.xml @@ -0,0 +1,24 @@ + + +autotoc.label.in.hyperlink +boolean + + +autotoc.label.in.hyperlink +Include lable in hyperlinked titles in TOC? + + + + + + +Description + +If the value of +autotoc.label.in.hyperlink is non-zero, labels +are included in hyperlinked titles in the TOC. If it is instead zero, +labels are still displayed prior to the hyperlinked titles, but +are not hyperlinked along with the titles. + + + diff --git a/src/documentation/docbook-xsl/params/autotoc.label.separator.xml b/src/documentation/docbook-xsl/params/autotoc.label.separator.xml new file mode 100644 index 0000000000..20a8f00394 --- /dev/null +++ b/src/documentation/docbook-xsl/params/autotoc.label.separator.xml @@ -0,0 +1,20 @@ + + +autotoc.label.separator +string + + +autotoc.label.separator +Separator between labels and titles in the ToC + + + + + + +Description + +String to use to seperate labels and title in a table of contents. + + + diff --git a/src/documentation/docbook-xsl/params/axf.extensions.xml b/src/documentation/docbook-xsl/params/axf.extensions.xml new file mode 100644 index 0000000000..b5c6c52b45 --- /dev/null +++ b/src/documentation/docbook-xsl/params/axf.extensions.xml @@ -0,0 +1,28 @@ + + +axf.extensions +boolean + + +axf.extensions +Enable XSL Formatter extensions? + + + + + + + + +Description + +If non-zero, +XSL Formatter +extensions will be used. XSL Formatter extensions consists of PDF bookmarks, +document information and better index processing. + +This parameter can also affect which graphics file formats +are supported + + + diff --git a/src/documentation/docbook-xsl/params/base.dir.xml b/src/documentation/docbook-xsl/params/base.dir.xml new file mode 100644 index 0000000000..704e91c829 --- /dev/null +++ b/src/documentation/docbook-xsl/params/base.dir.xml @@ -0,0 +1,22 @@ + + +base.dir + + + +base.dir +The base directory of chunks + + + + + + +Description + +If specified, the base.dir identifies +the output directory for chunks. (If not specified, the output directory +is system dependent.) + + + diff --git a/src/documentation/docbook-xsl/params/biblioentry.item.separator.xml b/src/documentation/docbook-xsl/params/biblioentry.item.separator.xml new file mode 100644 index 0000000000..0146e69366 --- /dev/null +++ b/src/documentation/docbook-xsl/params/biblioentry.item.separator.xml @@ -0,0 +1,21 @@ + + +biblioentry.item.separator +string + + +biblioentry.item.separator +Text to separate bibliography entries + + + +. + + +Description + +Text to separate bibliography entries + + + + diff --git a/src/documentation/docbook-xsl/params/biblioentry.properties.xml b/src/documentation/docbook-xsl/params/biblioentry.properties.xml new file mode 100644 index 0000000000..290ef80f2a --- /dev/null +++ b/src/documentation/docbook-xsl/params/biblioentry.properties.xml @@ -0,0 +1,19 @@ + + +biblioentry.properties +To set the style for biblioentry. + + + + + 0.5in + -0.5in + + + +Description +How do you want biblioentry styled? +Set the font-size, weight, space-above and space-below, indents, etc. to the style required + + + diff --git a/src/documentation/docbook-xsl/params/bibliography.collection.xml b/src/documentation/docbook-xsl/params/bibliography.collection.xml new file mode 100644 index 0000000000..2e69e7dddd --- /dev/null +++ b/src/documentation/docbook-xsl/params/bibliography.collection.xml @@ -0,0 +1,96 @@ + + +bibliography.collection +string + + +bibliography.collection +Name of the bibliography collection file + + + + + + +Description + +Maintaining bibliography entries across a set of documents is tedious, time +consuming, and error prone. It makes much more sense, usually, to store all of +the bibliography entries in a single place and simply extract +the ones you need in each document. + +That's the purpose of the +bibliography.collection parameter. To setup a global +bibliography database, follow these steps: + +First, create a stand-alone bibliography document that contains all of +the documents that you wish to reference. Make sure that each bibliography +entry (whether you use biblioentry or bibliomixed) +has an ID. + +My global bibliography, ~/bibliography.xml begins +like this: + + + +References + +XML 1.0Tim Bray, +Jean Paoli, C. M. Sperberg-McQueen, and Eve Maler, editors. +Extensible Markup +Language (XML) 1.0 Second Edition. +World Wide Web Consortium, 2000. + + +NamespacesTim Bray, +Dave Hollander, +and Andrew Layman, editors. +Namespaces in +XML. +World Wide Web Consortium, 1999. + + + + +]]> + + +When you create a bibliography in your document, simply +provide empty bibliomixed +entries for each document that you wish to cite. Make sure that these +elements have the same ID as the corresponding real +entry in your global bibliography. + +For example: + + +Bibliography + + + +Donald E. Knuth. Computers and +Typesetting: Volume B, TeX: The Program. Addison-Wesley, +1986. ISBN 0-201-13437-3. + + + +]]> + + +Note that it's perfectly acceptable to mix entries from your +global bibliography with normal entries. You can use +xref or other elements to cross-reference your +bibliography entries in exactly the same way you do now. + +Finally, when you are ready to format your document, simply set the +bibliography.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global bibliography. + +The stylesheets will format the bibliography in your document as if +all of the entries referenced appeared there literally. + + + diff --git a/src/documentation/docbook-xsl/params/bibliography.numbered.xml b/src/documentation/docbook-xsl/params/bibliography.numbered.xml new file mode 100644 index 0000000000..13cc104eca --- /dev/null +++ b/src/documentation/docbook-xsl/params/bibliography.numbered.xml @@ -0,0 +1,22 @@ + + +bibliography.numbered +boolean + + +bibliography.numbered +Should bibliography entries be numbered? + + + + + + + + +Description + +If non-zero bibliography entries will be numbered + + + diff --git a/src/documentation/docbook-xsl/params/blockquote.properties.xml b/src/documentation/docbook-xsl/params/blockquote.properties.xml new file mode 100644 index 0000000000..7a0f237ca8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/blockquote.properties.xml @@ -0,0 +1,25 @@ + + +blockquote.properties +To set the style for block quotations. + + + + + +0.5in +0.5in +0.5em +1em +2em + + + + +Description + +The blockquote.properties attribute set specifies +the formating properties of block quotations. + + + diff --git a/src/documentation/docbook-xsl/params/body.end.indent.xml b/src/documentation/docbook-xsl/params/body.end.indent.xml new file mode 100644 index 0000000000..86617cf22f --- /dev/null +++ b/src/documentation/docbook-xsl/params/body.end.indent.xml @@ -0,0 +1,32 @@ + + +body.end.indent + + + +body.end.indent +The end-indent for the body text + + + + + + + + +Description + +This end-indent property is added to the fo:flow +for certain page sequences. Which page-sequences it is +applied to is determined by the template named +set.flow.properties. +By default, that template adds it to the flow +for page-sequences using the body +master-reference, as well as appendixes and prefaces. + + +See also body.start.indent. + + + + diff --git a/src/documentation/docbook-xsl/params/body.font.family.xml b/src/documentation/docbook-xsl/params/body.font.family.xml new file mode 100644 index 0000000000..b5e75fe3d7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/body.font.family.xml @@ -0,0 +1,23 @@ + + +body.font.family + + + +body.font.family +The default font family for body text + + + + + + + + +Description + +The body font family is the default font used for text in the page body. + + + + diff --git a/src/documentation/docbook-xsl/params/body.font.master.xml b/src/documentation/docbook-xsl/params/body.font.master.xml new file mode 100644 index 0000000000..4c532b80d5 --- /dev/null +++ b/src/documentation/docbook-xsl/params/body.font.master.xml @@ -0,0 +1,25 @@ + + +body.font.master + + + +body.font.master +Specifies the default point size for body text + + + + +10 + + + +Description + +The body font size is specified in two parameters +(body.font.master and body.font.size) +so that math can be performed on the font size by XSLT. + + + + diff --git a/src/documentation/docbook-xsl/params/body.font.size.xml b/src/documentation/docbook-xsl/params/body.font.size.xml new file mode 100644 index 0000000000..56134c879b --- /dev/null +++ b/src/documentation/docbook-xsl/params/body.font.size.xml @@ -0,0 +1,25 @@ + + +body.font.size + + + +body.font.size +Specifies the default font size for body text + + + + + pt + + + +Description + +The body font size is specified in two parameters +(body.font.master and body.font.size) +so that math can be performed on the font size by XSLT. + + + + diff --git a/src/documentation/docbook-xsl/params/body.margin.bottom.xml b/src/documentation/docbook-xsl/params/body.margin.bottom.xml new file mode 100644 index 0000000000..98d1233b3d --- /dev/null +++ b/src/documentation/docbook-xsl/params/body.margin.bottom.xml @@ -0,0 +1,24 @@ + + +body.margin.bottom + + + +body.margin.bottom +The bottom margin of the body text + + + + + + + + +Description + +The body bottom margin is the distance from the last line of text +in the page body to the bottom of the region-after. + + + + diff --git a/src/documentation/docbook-xsl/params/body.margin.top.xml b/src/documentation/docbook-xsl/params/body.margin.top.xml new file mode 100644 index 0000000000..96ea6906b4 --- /dev/null +++ b/src/documentation/docbook-xsl/params/body.margin.top.xml @@ -0,0 +1,24 @@ + + +body.margin.top + + + +body.margin.top +To specify the size of the top margin of a page + + + + + + + + +Description + +The body top margin is the distance from the top of the region-before +to the first line of text in the page body. + + + + diff --git a/src/documentation/docbook-xsl/params/body.start.indent.xml b/src/documentation/docbook-xsl/params/body.start.indent.xml new file mode 100644 index 0000000000..2807ca65bd --- /dev/null +++ b/src/documentation/docbook-xsl/params/body.start.indent.xml @@ -0,0 +1,57 @@ + + +body.start.indent + + + +body.start.indent +The start-indent for the body text + + + + + + + 0pt + 0pt + 4pc + + + + + +Description + +This parameter provides +one means of indenting the body text relative to +the left page margin. +It is used in place of the +title.margin.left for +all XSL-FO processors except FOP. +It enables support for side floats to appear +in the indented margin area. + +This start-indent property is added to the fo:flow +for certain page sequences. Which page-sequences it is +applied to is determined by the template named +set.flow.properties. +By default, that template adds it to the flow +for page-sequences using the body +master-reference, as well as appendixes and prefaces. + +If this parameter is used, section titles should have +a start-indent value of 0pt if they are to be +outdented relative to the body text. + + +If you are using FOP, then set this parameter to a zero +width value and set the title.margin.left +parameter to the negative value of the desired indent. + + +See also body.end.indent and +title.margin.left. + + + + diff --git a/src/documentation/docbook-xsl/params/bridgehead.in.toc.xml b/src/documentation/docbook-xsl/params/bridgehead.in.toc.xml new file mode 100644 index 0000000000..4fbc4f6d4d --- /dev/null +++ b/src/documentation/docbook-xsl/params/bridgehead.in.toc.xml @@ -0,0 +1,23 @@ + + +bridgehead.in.toc +boolean + + +bridgehead.in.toc +Should bridgehead elements appear in the TOC? + + + + + + +Description + +If non-zero, bridgeheads appear in the TOC. Note that this option +is not fully supported and may be removed in a future version of the +stylesheets. + + + + diff --git a/src/documentation/docbook-xsl/params/callout.defaultcolumn.xml b/src/documentation/docbook-xsl/params/callout.defaultcolumn.xml new file mode 100644 index 0000000000..059a5e5d14 --- /dev/null +++ b/src/documentation/docbook-xsl/params/callout.defaultcolumn.xml @@ -0,0 +1,23 @@ + + +callout.defaultcolumn +integer + + +callout.defaultcolumn +Indicates what column callouts appear in by default + + + + + + +Description + +If a callout does not identify a column (for example, if it uses +the linerange unit), +it will appear in the default column. + + + + diff --git a/src/documentation/docbook-xsl/params/callout.graphics.extension.xml b/src/documentation/docbook-xsl/params/callout.graphics.extension.xml new file mode 100644 index 0000000000..4503569ea4 --- /dev/null +++ b/src/documentation/docbook-xsl/params/callout.graphics.extension.xml @@ -0,0 +1,20 @@ + + +callout.graphics.extension +string + + +callout.graphics.extension +Extension for callout graphics + + + + + + +Description + +Sets the extension to use on callout graphics. + + + diff --git a/src/documentation/docbook-xsl/params/callout.graphics.number.limit.xml b/src/documentation/docbook-xsl/params/callout.graphics.number.limit.xml new file mode 100644 index 0000000000..f3d78030b4 --- /dev/null +++ b/src/documentation/docbook-xsl/params/callout.graphics.number.limit.xml @@ -0,0 +1,28 @@ + + +callout.graphics.number.limit +integer + + +callout.graphics.number.limit +Number of the largest callout graphic + + + + + + +Description + +If callout.graphics +is non-zero, graphics are used to represent +callout numbers. The value of +callout.graphics.number.limit +is +the largest number for which a graphic exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + diff --git a/src/documentation/docbook-xsl/params/callout.graphics.path.xml b/src/documentation/docbook-xsl/params/callout.graphics.path.xml new file mode 100644 index 0000000000..33f5a15bff --- /dev/null +++ b/src/documentation/docbook-xsl/params/callout.graphics.path.xml @@ -0,0 +1,24 @@ + + +callout.graphics.path +string + + +callout.graphics.path +Path to callout graphics + + + + + + + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the callout graphics. + + + + diff --git a/src/documentation/docbook-xsl/params/callout.graphics.xml b/src/documentation/docbook-xsl/params/callout.graphics.xml new file mode 100644 index 0000000000..ed54e97056 --- /dev/null +++ b/src/documentation/docbook-xsl/params/callout.graphics.xml @@ -0,0 +1,25 @@ + + +callout.graphics +boolean + + +callout.graphics +Use graphics for callouts? + + + + + + + + +Description + +If non-zero, callouts are presented with graphics (e.g., reverse-video +circled numbers instead of "(1)", "(2)", etc.). +Default graphics are provided in the distribution. + + + + diff --git a/src/documentation/docbook-xsl/params/callout.list.table.xml b/src/documentation/docbook-xsl/params/callout.list.table.xml new file mode 100644 index 0000000000..bbfcb7aca0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/callout.list.table.xml @@ -0,0 +1,25 @@ + + +callout.list.table +boolean + + +callout.list.table +Present callout lists using a table? + + + + + + +Description + +The default presentation of CalloutLists uses +an HTML DL. Some browsers don't align DLs very well +if callout.graphics are used. With this option +turned on, CalloutLists are presented in an HTML +TABLE, which usually results in better alignment +of the callout number with the callout description. + + + diff --git a/src/documentation/docbook-xsl/params/callout.unicode.font.xml b/src/documentation/docbook-xsl/params/callout.unicode.font.xml new file mode 100644 index 0000000000..efcbdd08db --- /dev/null +++ b/src/documentation/docbook-xsl/params/callout.unicode.font.xml @@ -0,0 +1,22 @@ + + +callout.unicode.font + + + +callout.unicode.font +Specify a font for Unicode glyphs + + + + + + +Description + +The name of the font to specify around Unicode callout glyphs. +If set to the empty string, no font change will occur. + + + + diff --git a/src/documentation/docbook-xsl/params/callout.unicode.number.limit.xml b/src/documentation/docbook-xsl/params/callout.unicode.number.limit.xml new file mode 100644 index 0000000000..f02ae3dfe7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/callout.unicode.number.limit.xml @@ -0,0 +1,28 @@ + + +callout.unicode.number.limit +integer + + +callout.unicode.number.limit +Number of the largest callout graphic + + + + + + +Description + +If callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.number.limit +is +the largest number for which a unicode character exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + diff --git a/src/documentation/docbook-xsl/params/callout.unicode.start.character.xml b/src/documentation/docbook-xsl/params/callout.unicode.start.character.xml new file mode 100644 index 0000000000..6423eb5f94 --- /dev/null +++ b/src/documentation/docbook-xsl/params/callout.unicode.start.character.xml @@ -0,0 +1,26 @@ + + +callout.unicode.start.character +integer + + +callout.unicode.start.character +First Unicode character to use, decimal value. + + + + + + +Description + +If callout.graphics is zero and callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.start.character +is the decimal unicode value used for callout number one. Currently, +only 10102 is supported in the stylesheets for this parameter. + + + + diff --git a/src/documentation/docbook-xsl/params/callout.unicode.xml b/src/documentation/docbook-xsl/params/callout.unicode.xml new file mode 100644 index 0000000000..f0a00b06d0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/callout.unicode.xml @@ -0,0 +1,21 @@ + + +callout.unicode +boolean + + +callout.unicode +Use Unicode characters rather than images for callouts. + + + + + + +Description + +The stylesheets can use either an image of the numbers one to ten, or the single Unicode character which represents the numeral, in white on a black background. Use this to select the Unicode character option. + + + + diff --git a/src/documentation/docbook-xsl/params/callouts.extension.xml b/src/documentation/docbook-xsl/params/callouts.extension.xml new file mode 100644 index 0000000000..8480870899 --- /dev/null +++ b/src/documentation/docbook-xsl/params/callouts.extension.xml @@ -0,0 +1,23 @@ + + +callouts.extension +boolean + + +callouts.extension +Enable the callout extension + + + + + + +Description + +The callouts extension processes areaset +elements in ProgramListingCO and other text-based +callout elements. + + + + diff --git a/src/documentation/docbook-xsl/params/chapter.autolabel.xml b/src/documentation/docbook-xsl/params/chapter.autolabel.xml new file mode 100644 index 0000000000..77b58977ec --- /dev/null +++ b/src/documentation/docbook-xsl/params/chapter.autolabel.xml @@ -0,0 +1,60 @@ + + +chapter.autolabel +boolean + + +chapter.autolabel +Specifies the labeling format for Chapter titles + + + + + + +Description + +If zero, then chapters will not be numbered. +Otherwise chapters will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + diff --git a/src/documentation/docbook-xsl/params/chunk.first.sections.xml b/src/documentation/docbook-xsl/params/chunk.first.sections.xml new file mode 100644 index 0000000000..f1f9a0a477 --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunk.first.sections.xml @@ -0,0 +1,26 @@ + + +chunk.first.sections + + + +chunk.first.sections +Chunk the first top-level section? + + + + + + + + +Description + +If non-zero, a chunk will be created for the first top-level +sect1 or section elements in +each component. Otherwise, that section will be part of the chunk for +its parent. + + + + diff --git a/src/documentation/docbook-xsl/params/chunk.quietly.xml b/src/documentation/docbook-xsl/params/chunk.quietly.xml new file mode 100644 index 0000000000..78200a5e7a --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunk.quietly.xml @@ -0,0 +1,25 @@ + + +chunk.quietly + + + +chunk.quietly +Omit the chunked filename messages. + + + + + + + + +Description + +If zero (the default), the XSL processor emits a message naming +each separate chunk filename as it is being output. +If nonzero, then the messages are suppressed. + + + + diff --git a/src/documentation/docbook-xsl/params/chunk.section.depth.xml b/src/documentation/docbook-xsl/params/chunk.section.depth.xml new file mode 100644 index 0000000000..af29641b96 --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunk.section.depth.xml @@ -0,0 +1,22 @@ + + +chunk.section.depth +integer + + +chunk.section.depth +Depth to which sections should be chunked + + + + + + + + +Description + +This parameter sets the depth of section chunking. + + + diff --git a/src/documentation/docbook-xsl/params/chunk.sections.xml b/src/documentation/docbook-xsl/params/chunk.sections.xml new file mode 100644 index 0000000000..38bf39ece4 --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunk.sections.xml @@ -0,0 +1,23 @@ + + +chunk.sections + + + +chunk.sections +Should top-level sections be chunks in their own right? + + + + + + +Description + +If non-zero, chunks will be created for top-level +sect1 and section elements in +each component. + + + + diff --git a/src/documentation/docbook-xsl/params/chunk.separate.lots.xml b/src/documentation/docbook-xsl/params/chunk.separate.lots.xml new file mode 100644 index 0000000000..3a0c8c224d --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunk.separate.lots.xml @@ -0,0 +1,31 @@ + + +chunk.separate.lots +boolean + + +chunk.separate.lots +Should each LoT be in its own separate chunk? + + + + + + + + +Description + +If non-zero, each of the ToC and LoTs +(List of Examples, List of Figures, etc.) +will be put in its own separate chunk. +The title page includes generated links to each of the separate files. + + +This feature depends on the +chunk.tocs.and.lots +parameter also being non-zero. + + + + diff --git a/src/documentation/docbook-xsl/params/chunk.toc.xml b/src/documentation/docbook-xsl/params/chunk.toc.xml new file mode 100644 index 0000000000..279b1c2cc0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunk.toc.xml @@ -0,0 +1,25 @@ + + +chunk.toc +string + + +chunk.toc +An explicit TOC to be used for chunking + + + + + + + + +Description + +The chunk.toc identifies an explicit TOC that +will be used for chunking. This parameter is only used by the +chunktoc.xsl stylesheet (and customization layers built +from it). + + + diff --git a/src/documentation/docbook-xsl/params/chunk.tocs.and.lots.has.title.xml b/src/documentation/docbook-xsl/params/chunk.tocs.and.lots.has.title.xml new file mode 100644 index 0000000000..a27b358895 --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunk.tocs.and.lots.has.title.xml @@ -0,0 +1,23 @@ + + +chunk.tocs.and.lots.has.title +boolean + + +chunk.tocs.and.lots.has.title +Should ToC and LoTs in a separate chunks have title? + + + + + + + + +Description + +If non-zero title of document is shown before ToC/LoT in +separate chunk. + + + diff --git a/src/documentation/docbook-xsl/params/chunk.tocs.and.lots.xml b/src/documentation/docbook-xsl/params/chunk.tocs.and.lots.xml new file mode 100644 index 0000000000..655b3ffb0a --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunk.tocs.and.lots.xml @@ -0,0 +1,27 @@ + + +chunk.tocs.and.lots +boolean + + +chunk.tocs.and.lots +Should ToC and LoTs be in separate chunks? + + + + + + + + +Description + +If non-zero, ToC and LoT (List of Examples, List of Figures, etc.) +will be put in a separate chunk. At the moment, this chunk is not in the +normal forward/backward navigation list. Instead, a new link is added to the +navigation footer. + +This feature is still somewhat experimental. Feedback welcome. + + + diff --git a/src/documentation/docbook-xsl/params/chunker.output.cdata-section-elements.xml b/src/documentation/docbook-xsl/params/chunker.output.cdata-section-elements.xml new file mode 100644 index 0000000000..0f77056a08 --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunker.output.cdata-section-elements.xml @@ -0,0 +1,27 @@ + + +chunker.output.cdata-section-elements +string + + +chunker.output.cdata-section-elements +List of elements to escape with CDATA sections + + +<xsl:param name="chunker.output.cdata-section-elements" select="''"/> + + +Description + +This parameter specifies the list of elements that should be escaped +as CDATA sections by the chunking stylesheet. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + diff --git a/src/documentation/docbook-xsl/params/chunker.output.doctype-public.xml b/src/documentation/docbook-xsl/params/chunker.output.doctype-public.xml new file mode 100644 index 0000000000..06e342354d --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunker.output.doctype-public.xml @@ -0,0 +1,28 @@ + + +chunker.output.doctype-public +string + + +chunker.output.doctype-public +Public identifer to use in the document type of generated pages + + +<xsl:param name="chunker.output.doctype-public" select="''"/> + + +Description + +This parameter specifies the public identifier that should be used by +the chunking stylesheet in the document type declaration of chunked pages. +Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + diff --git a/src/documentation/docbook-xsl/params/chunker.output.doctype-system.xml b/src/documentation/docbook-xsl/params/chunker.output.doctype-system.xml new file mode 100644 index 0000000000..6147e0d7a8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunker.output.doctype-system.xml @@ -0,0 +1,28 @@ + + +chunker.output.doctype-system +uri + + +chunker.output.doctype-system +System identifier to use for the document type in generated pages + + +<xsl:param name="chunker.output.doctype-system" select="''"/> + + +Description + +This parameter specifies the system identifier that should be used by +the chunking stylesheet in the document type declaration of chunked pages. +Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + diff --git a/src/documentation/docbook-xsl/params/chunker.output.encoding.xml b/src/documentation/docbook-xsl/params/chunker.output.encoding.xml new file mode 100644 index 0000000000..c10b13703b --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunker.output.encoding.xml @@ -0,0 +1,29 @@ + + +chunker.output.encoding +string + + +chunker.output.encoding +Encoding used in generated pages + + +<xsl:param name="chunker.output.encoding" select="'ISO-8859-1'"/> + + +Description + +This parameter specifies the encoding to be used in files +generated by the chunking stylesheet. Not all processors support +specification of this parameter. + + +This parameter used to be named default.encoding. + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + diff --git a/src/documentation/docbook-xsl/params/chunker.output.indent.xml b/src/documentation/docbook-xsl/params/chunker.output.indent.xml new file mode 100644 index 0000000000..3dadc05280 --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunker.output.indent.xml @@ -0,0 +1,27 @@ + + +chunker.output.indent +string + + +chunker.output.indent +Specification of indentation on generated pages + + +<xsl:param name="chunker.output.indent" select="'no'"/> + + +Description + +This parameter specifies the value of the indent +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + diff --git a/src/documentation/docbook-xsl/params/chunker.output.media-type.xml b/src/documentation/docbook-xsl/params/chunker.output.media-type.xml new file mode 100644 index 0000000000..5b07e0e8b8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunker.output.media-type.xml @@ -0,0 +1,27 @@ + + +chunker.output.media-type +string + + +chunker.output.media-type +Media type to use in generated pages + + +<xsl:param name="chunker.output.media-type" select="''"/> + + +Description + +This parameter specifies the media type that should be used by +the chunking stylesheet. Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + diff --git a/src/documentation/docbook-xsl/params/chunker.output.method.xml b/src/documentation/docbook-xsl/params/chunker.output.method.xml new file mode 100644 index 0000000000..df16f06293 --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunker.output.method.xml @@ -0,0 +1,30 @@ + + +chunker.output.method +list +html +xml + + +chunker.output.method +Method used in generated pages + + +<xsl:param name="chunker.output.method" select="'html'"/> + + +Description + +This parameter specifies the output method to be used in files +generated by the chunking stylesheet. + + +This parameter used to be named output.method. + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + diff --git a/src/documentation/docbook-xsl/params/chunker.output.omit-xml-declaration.xml b/src/documentation/docbook-xsl/params/chunker.output.omit-xml-declaration.xml new file mode 100644 index 0000000000..84ed80a44f --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunker.output.omit-xml-declaration.xml @@ -0,0 +1,27 @@ + + +chunker.output.omit-xml-declaration + + + +chunker.output.omit-xml-declaration +Omit-xml-declaration for generated pages + + +<xsl:param name="chunker.output.omit-xml-declaration" select="'no'"/> + + +Description + +This parameter specifies the value of the omit-xml-declaration +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + diff --git a/src/documentation/docbook-xsl/params/chunker.output.standalone.xml b/src/documentation/docbook-xsl/params/chunker.output.standalone.xml new file mode 100644 index 0000000000..bfd145c6a7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/chunker.output.standalone.xml @@ -0,0 +1,27 @@ + + +chunker.output.standalone +string + + +chunker.output.standalone +Standalone declaration for generated pages + + +<xsl:param name="chunker.output.standalone" select="'no'"/> + + +Description + +This parameter specifies the value of the standalone +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + diff --git a/src/documentation/docbook-xsl/params/citerefentry.link.xml b/src/documentation/docbook-xsl/params/citerefentry.link.xml new file mode 100644 index 0000000000..bd413c49ff --- /dev/null +++ b/src/documentation/docbook-xsl/params/citerefentry.link.xml @@ -0,0 +1,23 @@ + + +citerefentry.link +boolean + + +citerefentry.link +Generate URL links when cross-referencing RefEntrys? + + + + + + +Description + +If true, a web link will be generated, presumably +to an online man->HTML gateway. The text of the link is +generated by the generate.citerefentry.link template. + + + + diff --git a/src/documentation/docbook-xsl/params/collect.xref.targets.xml b/src/documentation/docbook-xsl/params/collect.xref.targets.xml new file mode 100644 index 0000000000..846a01fd42 --- /dev/null +++ b/src/documentation/docbook-xsl/params/collect.xref.targets.xml @@ -0,0 +1,25 @@ + + +collect.xref.targets +string + + +collect.xref.targets +Controls whether cross reference data is +collected + + + + + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter determines whether the collection process is run when the document is processed by the stylesheet. The default value is no, which means the data file is not generated during processing. The other choices are yes, which means the data file is created and the document is processed for output, and only, which means the data file is created but the document is not processed for output. +See also targets.filename. + + + diff --git a/src/documentation/docbook-xsl/params/column.count.back.xml b/src/documentation/docbook-xsl/params/column.count.back.xml new file mode 100644 index 0000000000..ee30af9468 --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.count.back.xml @@ -0,0 +1,22 @@ + + +column.count.back +integer + + +column.count.back +Number of columns on back matter pages + + + + + + + + +Description + +Number of columns on back matter (appendix, glossary, etc.) pages. + + + diff --git a/src/documentation/docbook-xsl/params/column.count.body.xml b/src/documentation/docbook-xsl/params/column.count.body.xml new file mode 100644 index 0000000000..d76b0d768d --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.count.body.xml @@ -0,0 +1,22 @@ + + +column.count.body +integer + + +column.count.body +Number of columns on body pages + + + + + + + + +Description + +Number of columns on body pages. + + + diff --git a/src/documentation/docbook-xsl/params/column.count.front.xml b/src/documentation/docbook-xsl/params/column.count.front.xml new file mode 100644 index 0000000000..1fd023a2bc --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.count.front.xml @@ -0,0 +1,22 @@ + + +column.count.front +integer + + +column.count.front +Number of columns on front matter pages + + + + + + + + +Description + +Number of columns on front matter (dedication, preface, etc.) pages. + + + diff --git a/src/documentation/docbook-xsl/params/column.count.index.xml b/src/documentation/docbook-xsl/params/column.count.index.xml new file mode 100644 index 0000000000..26d0c1eeb9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.count.index.xml @@ -0,0 +1,22 @@ + + +column.count.index +integer + + +column.count.index +Number of columns on index pages + + + + + + + + +Description + +Number of columns on index pages. + + + diff --git a/src/documentation/docbook-xsl/params/column.count.lot.xml b/src/documentation/docbook-xsl/params/column.count.lot.xml new file mode 100644 index 0000000000..611482768c --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.count.lot.xml @@ -0,0 +1,23 @@ + + +column.count.lot +integer + + +column.count.lot +Number of columns on a 'List-of-Titles' page + + + + + + + + +Description + +Number of columns on a page sequence containing the Table of Contents, +List of Figures, etc. + + + diff --git a/src/documentation/docbook-xsl/params/column.count.titlepage.xml b/src/documentation/docbook-xsl/params/column.count.titlepage.xml new file mode 100644 index 0000000000..2718058ed2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.count.titlepage.xml @@ -0,0 +1,22 @@ + + +column.count.titlepage +integer + + +column.count.titlepage +Number of columns on a title page + + + + + + + + +Description + +Number of columns on a title page + + + diff --git a/src/documentation/docbook-xsl/params/column.gap.back.xml b/src/documentation/docbook-xsl/params/column.gap.back.xml new file mode 100644 index 0000000000..0515481889 --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.gap.back.xml @@ -0,0 +1,23 @@ + + +column.gap.back +length + + +column.gap.back +Gap between columns in back matter + + + + + + + + +Description + +Specifies the gap between columns in back matter (if +column.count.back is greater than one). + + + diff --git a/src/documentation/docbook-xsl/params/column.gap.body.xml b/src/documentation/docbook-xsl/params/column.gap.body.xml new file mode 100644 index 0000000000..4a7bd10a55 --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.gap.body.xml @@ -0,0 +1,23 @@ + + +column.gap.body +length + + +column.gap.body +Gap between columns in the body + + + + + + + + +Description + +Specifies the gap between columns in body matter (if +column.count.body is greater than one). + + + diff --git a/src/documentation/docbook-xsl/params/column.gap.front.xml b/src/documentation/docbook-xsl/params/column.gap.front.xml new file mode 100644 index 0000000000..9a7f19d536 --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.gap.front.xml @@ -0,0 +1,23 @@ + + +column.gap.front +length + + +column.gap.front +Gap between columns in the front matter + + + + + + + + +Description + +Specifies the gap between columns in front matter (if +column.count.front is greater than one). + + + diff --git a/src/documentation/docbook-xsl/params/column.gap.index.xml b/src/documentation/docbook-xsl/params/column.gap.index.xml new file mode 100644 index 0000000000..f21221e855 --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.gap.index.xml @@ -0,0 +1,23 @@ + + +column.gap.index +length + + +column.gap.index +Gap between columns in the index + + + + + + + + +Description + +Specifies the gap between columns in indexes (if +column.count.index is greater than one). + + + diff --git a/src/documentation/docbook-xsl/params/column.gap.lot.xml b/src/documentation/docbook-xsl/params/column.gap.lot.xml new file mode 100644 index 0000000000..a620e7553c --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.gap.lot.xml @@ -0,0 +1,23 @@ + + +column.gap.lot +length + + +column.gap.lot +Gap between columns on a 'List-of-Titles' page + + + + + + + + +Description + +Specifies the gap between columns on 'List-of-Titles' pages (if +column.count.lot is greater than one). + + + diff --git a/src/documentation/docbook-xsl/params/column.gap.titlepage.xml b/src/documentation/docbook-xsl/params/column.gap.titlepage.xml new file mode 100644 index 0000000000..f379020117 --- /dev/null +++ b/src/documentation/docbook-xsl/params/column.gap.titlepage.xml @@ -0,0 +1,24 @@ + + +column.gap.titlepage +length + + +column.gap.titlepage +Gap between columns on title pages + + + + + + + + +Description + +Specifies the gap between columns on title pages (if +column.count.titlepage is greater than one). + + + + diff --git a/src/documentation/docbook-xsl/params/compact.list.item.spacing.xml b/src/documentation/docbook-xsl/params/compact.list.item.spacing.xml new file mode 100644 index 0000000000..43a1b69510 --- /dev/null +++ b/src/documentation/docbook-xsl/params/compact.list.item.spacing.xml @@ -0,0 +1,19 @@ + + +compact.list.item.spacing +What space do you want between list items (when spacing=compact)? + + + + + 0em + 0em + 0.2em + + +Description +Specify what spacing you want between each list item when +spacing is +compact. + + diff --git a/src/documentation/docbook-xsl/params/component.label.includes.part.label.xml b/src/documentation/docbook-xsl/params/component.label.includes.part.label.xml new file mode 100644 index 0000000000..8984c60e4f --- /dev/null +++ b/src/documentation/docbook-xsl/params/component.label.includes.part.label.xml @@ -0,0 +1,34 @@ + + +component.label.includes.part.label +boolean + + +component.label.includes.part.label +Do component labels include the part label? + + + + + + +Description + +If true (non-zero), number labels for chapters, appendices, and other component +elements are prefixed with the label of the +part element that contains them. +So you might see Chapter II.3 instead of Chapter 3. +Also, the labels for formal elements such as table and figure will +include the part label. +If there is no part element container, then no prefix is generated. + + +This feature is most useful when the +label.from.part parameter is turned on. +In that case, there would be more than one chapter +1, and the extra part label prefix will identify +each chapter unambiguously. + + + + diff --git a/src/documentation/docbook-xsl/params/component.title.properties.xml b/src/documentation/docbook-xsl/params/component.title.properties.xml new file mode 100644 index 0000000000..0b7e0fb8e6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/component.title.properties.xml @@ -0,0 +1,40 @@ + + +component.title.properties +attribute set + + +component.title.properties +Properties for component titles + + + + + + always + + + + false + + + center + left + + + + + + + +Description + +The properties common to all component titles. + + + diff --git a/src/documentation/docbook-xsl/params/crop.mark.bleed.xml b/src/documentation/docbook-xsl/params/crop.mark.bleed.xml new file mode 100644 index 0000000000..1eae0cddcb --- /dev/null +++ b/src/documentation/docbook-xsl/params/crop.mark.bleed.xml @@ -0,0 +1,21 @@ + + +crop.mark.bleed +string + + +crop.mark.bleed +Length of invisible part of crop marks. + + + + + + +Description + +Length of invisible part of crop marks. Crop marks are controlled by +crop.marks parameter. + + + diff --git a/src/documentation/docbook-xsl/params/crop.mark.offset.xml b/src/documentation/docbook-xsl/params/crop.mark.offset.xml new file mode 100644 index 0000000000..d94d06eca0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/crop.mark.offset.xml @@ -0,0 +1,21 @@ + + +crop.mark.offset +string + + +crop.mark.offset +Length of crop marks. + + + + + + +Description + +Length of crop marks. Crop marks are controlled by +crop.marks parameter. + + + diff --git a/src/documentation/docbook-xsl/params/crop.mark.width.xml b/src/documentation/docbook-xsl/params/crop.mark.width.xml new file mode 100644 index 0000000000..bbfe4ff9df --- /dev/null +++ b/src/documentation/docbook-xsl/params/crop.mark.width.xml @@ -0,0 +1,21 @@ + + +crop.mark.width +string + + +crop.mark.width +Width of crop marks. + + + + + + +Description + +Width of crop marks. Crop marks are controlled by +crop.marks parameter. + + + diff --git a/src/documentation/docbook-xsl/params/crop.marks.xml b/src/documentation/docbook-xsl/params/crop.marks.xml new file mode 100644 index 0000000000..f483629f22 --- /dev/null +++ b/src/documentation/docbook-xsl/params/crop.marks.xml @@ -0,0 +1,21 @@ + + +crop.marks +boolean + + +crop.marks +Output crop marks? + + + + + + +Description + +If non-zero, crop marks will be added to each page. Currently this +works only with XEP if you have xep.extensions set. + + + diff --git a/src/documentation/docbook-xsl/params/css.decoration.xml b/src/documentation/docbook-xsl/params/css.decoration.xml new file mode 100644 index 0000000000..645e7a4dcc --- /dev/null +++ b/src/documentation/docbook-xsl/params/css.decoration.xml @@ -0,0 +1,28 @@ + + +css.decoration +boolean + + +css.decoration +Enable CSS decoration of elements + + + + + + + + +Description + + +If css.decoration is turned on, then HTML elements +produced by the +stylesheet may be decorated with STYLE attributes. For example, the +LI tags produced for list items may include a fragment of CSS in the +STYLE attribute which sets the CSS property "list-style-type". + + + + diff --git a/src/documentation/docbook-xsl/params/current.docid.xml b/src/documentation/docbook-xsl/params/current.docid.xml new file mode 100644 index 0000000000..86593e134e --- /dev/null +++ b/src/documentation/docbook-xsl/params/current.docid.xml @@ -0,0 +1,21 @@ + + +current.docid +string + + +current.docid +targetdoc identifier for the document being +processed + + + + + +Description +When olinks between documents are resolved for HTML output, the stylesheet can compute the relative path between the current document and the target document. The stylesheet needs to know the targetdoc identifiers for both documents, as they appear in the target.database.document database file. This parameter passes to the stylesheet +the targetdoc identifier of the current document, since that +identifier does not appear in the document itself. +This parameter can also be used for print output. If an olink's targetdoc id differs from the current.docid, then the stylesheet can append the target document's title to the generated olink text. That identifies to the reader that the link is to a different document, not the current document. See also olink.doctitle to enable that feature. + + diff --git a/src/documentation/docbook-xsl/params/default.float.class.xml b/src/documentation/docbook-xsl/params/default.float.class.xml new file mode 100644 index 0000000000..59a4d4dec7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/default.float.class.xml @@ -0,0 +1,27 @@ + + +default.float.class +string + + +default.float.class +Specifies the default float class + + + + + + + left + before + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/default.image.width.xml b/src/documentation/docbook-xsl/params/default.image.width.xml new file mode 100644 index 0000000000..edda404ccc --- /dev/null +++ b/src/documentation/docbook-xsl/params/default.image.width.xml @@ -0,0 +1,26 @@ + + +default.image.width +length + + +default.image.width +The default width of images + + + + + + + + +Description + +If specified, this value will be used for the +width attribute on +images that do not specify any +viewport +dimensions. + + + diff --git a/src/documentation/docbook-xsl/params/default.table.frame.xml b/src/documentation/docbook-xsl/params/default.table.frame.xml new file mode 100644 index 0000000000..e550b0d212 --- /dev/null +++ b/src/documentation/docbook-xsl/params/default.table.frame.xml @@ -0,0 +1,20 @@ + + +default.table.frame +string + + +default.table.frame +The default framing of tables + + + + + + +Description + +This value will be used when there is no frame attribute on the table. + + + diff --git a/src/documentation/docbook-xsl/params/default.table.width.xml b/src/documentation/docbook-xsl/params/default.table.width.xml new file mode 100644 index 0000000000..f908e3edbd --- /dev/null +++ b/src/documentation/docbook-xsl/params/default.table.width.xml @@ -0,0 +1,22 @@ + + +default.table.width +length + + +default.table.width +The default width of tables + + + + + + +Description + +If specified, this value will be used for the WIDTH attribute on +tables that do not specify an alternate width (with the dbhtml processing +instruction). + + + diff --git a/src/documentation/docbook-xsl/params/default.units.xml b/src/documentation/docbook-xsl/params/default.units.xml new file mode 100644 index 0000000000..16e74a1094 --- /dev/null +++ b/src/documentation/docbook-xsl/params/default.units.xml @@ -0,0 +1,30 @@ + + +default.units +list +cm +mm +in +pt +pc +px +em + + +default.units +Default units for an unqualified dimension + + + + + + +Description + +If an unqualified dimension is encountered (for example, in a +graphic width), the default-units will be used for the +units. Unqualified dimensions are not allowed in XSL Formatting Objects. + + + + diff --git a/src/documentation/docbook-xsl/params/dingbat.font.family.xml b/src/documentation/docbook-xsl/params/dingbat.font.family.xml new file mode 100644 index 0000000000..3136ae9e04 --- /dev/null +++ b/src/documentation/docbook-xsl/params/dingbat.font.family.xml @@ -0,0 +1,24 @@ + + +dingbat.font.family + + + +dingbat.font.family +The font family for copyright, quotes, and other symbols + + + + + + + + +Description + +The dingbat font family is used for dingbats. If it is defined +as the empty string, no font change is effected around dingbats. + + + + diff --git a/src/documentation/docbook-xsl/params/double.sided.xml b/src/documentation/docbook-xsl/params/double.sided.xml new file mode 100644 index 0000000000..3c676b98bf --- /dev/null +++ b/src/documentation/docbook-xsl/params/double.sided.xml @@ -0,0 +1,26 @@ + + +double.sided + + + +double.sided +Is the document to be printed double sided? + + + + + + + + +Description + +Double-sided documents are printed with a slightly wider margin +on the binding edge of the page. + +FIXME: The current set of parameters does not take writing direction +into account. + + + diff --git a/src/documentation/docbook-xsl/params/draft.mode.xml b/src/documentation/docbook-xsl/params/draft.mode.xml new file mode 100644 index 0000000000..542efa0dd7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/draft.mode.xml @@ -0,0 +1,28 @@ + + +draft.mode +list + + +draft.mode +Select draft mode + + + + + + + + +Description + +Selects draft mode. If draft.mode is +yes, the entire document will be treated +as a draft. If it is no, the entire document +will be treated as a final copy. If it is maybe, +individual sections will be treated as draft or final independently, depending +on how their status attribute is set. + + + + diff --git a/src/documentation/docbook-xsl/params/draft.watermark.image.xml b/src/documentation/docbook-xsl/params/draft.watermark.image.xml new file mode 100644 index 0000000000..1f5aa89460 --- /dev/null +++ b/src/documentation/docbook-xsl/params/draft.watermark.image.xml @@ -0,0 +1,22 @@ + + +draft.watermark.image +uri + + +draft.watermark.image +The URI of the image to be used for draft watermarks + + + + + + + + +Description + +The image to be used for draft watermarks. + + + diff --git a/src/documentation/docbook-xsl/params/ebnf.assignment.xml b/src/documentation/docbook-xsl/params/ebnf.assignment.xml new file mode 100644 index 0000000000..516a9cc444 --- /dev/null +++ b/src/documentation/docbook-xsl/params/ebnf.assignment.xml @@ -0,0 +1,35 @@ + + +ebnf.assignment +rtf + + +ebnf.assignment +The EBNF production assignment operator + + + + + +::= + + + + ::= + + + + + +Description + +The ebnf.assignment parameter determines what +text is used to show assignment in productions +in productionsets. + +While ::= is common, so are several +other operators. + + + diff --git a/src/documentation/docbook-xsl/params/ebnf.statement.terminator.xml b/src/documentation/docbook-xsl/params/ebnf.statement.terminator.xml new file mode 100644 index 0000000000..b3a8d86153 --- /dev/null +++ b/src/documentation/docbook-xsl/params/ebnf.statement.terminator.xml @@ -0,0 +1,27 @@ + + +ebnf.statement.terminator +rtf + + +ebnf.statement.terminator +Punctuation that ends an EBNF statement. + + + + + + + + + +Description + +The ebnf.statement.terminator parameter determines what +text is used to terminate each production +in productionset. + +Some notations end each statement with a period. + + + diff --git a/src/documentation/docbook-xsl/params/ebnf.table.bgcolor.xml b/src/documentation/docbook-xsl/params/ebnf.table.bgcolor.xml new file mode 100644 index 0000000000..82c89967c2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/ebnf.table.bgcolor.xml @@ -0,0 +1,23 @@ + + +ebnf.table.bgcolor +string + + +ebnf.table.bgcolor +Background color for EBNF tables + + + + + + +Description + +Sets the background color for EBNF tables. No bgcolor +attribute is output if ebnf.table.bgcolor is set to +the null string. The default value matches the value used in recent +online versions of the W3C's XML Spec productions. + + + diff --git a/src/documentation/docbook-xsl/params/ebnf.table.border.xml b/src/documentation/docbook-xsl/params/ebnf.table.border.xml new file mode 100644 index 0000000000..80916c25a7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/ebnf.table.border.xml @@ -0,0 +1,21 @@ + + +ebnf.table.border + + + +ebnf.table.border +Selects border on EBNF tables + + + + + + +Description + +Selects the border on EBNF tables. If non-zero, the tables have +borders, otherwise they don't. + + + diff --git a/src/documentation/docbook-xsl/params/eclipse.autolabel.xml b/src/documentation/docbook-xsl/params/eclipse.autolabel.xml new file mode 100644 index 0000000000..480aa37788 --- /dev/null +++ b/src/documentation/docbook-xsl/params/eclipse.autolabel.xml @@ -0,0 +1,23 @@ + + +eclipse.autolabel +boolean + + +eclipse.autolabel +Should tree-like ToC use autonumbering feature? + + + + + + + + +Description + +If you want to include chapter and section numbers into ToC in +the left panel, set this parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/eclipse.plugin.id.xml b/src/documentation/docbook-xsl/params/eclipse.plugin.id.xml new file mode 100644 index 0000000000..11718d7488 --- /dev/null +++ b/src/documentation/docbook-xsl/params/eclipse.plugin.id.xml @@ -0,0 +1,23 @@ + + +eclipse.plugin.id +string + + +eclipse.plugin.id +Eclipse Help plugin id + + + + +com.example.help + + + +Description + +Eclipse Help plugin id. You should change this id to something +unique for each help. + + + diff --git a/src/documentation/docbook-xsl/params/eclipse.plugin.name.xml b/src/documentation/docbook-xsl/params/eclipse.plugin.name.xml new file mode 100644 index 0000000000..f7b10a89bd --- /dev/null +++ b/src/documentation/docbook-xsl/params/eclipse.plugin.name.xml @@ -0,0 +1,22 @@ + + +eclipse.plugin.name +string + + +eclipse.plugin.name +Eclipse Help plugin name + + + + +DocBook Online Help Sample + + + +Description + +Eclipse Help plugin name. + + + diff --git a/src/documentation/docbook-xsl/params/eclipse.plugin.provider.xml b/src/documentation/docbook-xsl/params/eclipse.plugin.provider.xml new file mode 100644 index 0000000000..b3156da654 --- /dev/null +++ b/src/documentation/docbook-xsl/params/eclipse.plugin.provider.xml @@ -0,0 +1,22 @@ + + +eclipse.plugin.provider +string + + +eclipse.plugin.provider +Eclipse Help plugin provider name + + + + +Example provider + + + +Description + +Eclipse Help plugin provider name. + + + diff --git a/src/documentation/docbook-xsl/params/emphasis.propagates.style.xml b/src/documentation/docbook-xsl/params/emphasis.propagates.style.xml new file mode 100644 index 0000000000..5a2c70ced7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/emphasis.propagates.style.xml @@ -0,0 +1,24 @@ + + +emphasis.propagates.style +boolean + + +emphasis.propagates.style +Pass emphasis role attribute through to HTML? + + + + + + + + +Description + +If true, the role attribute of emphasis elements +will be passed through to the HTML as a class attribute on a +span that surrounds the emphasis. + + + diff --git a/src/documentation/docbook-xsl/params/entry.propagates.style.xml b/src/documentation/docbook-xsl/params/entry.propagates.style.xml new file mode 100644 index 0000000000..02853c6208 --- /dev/null +++ b/src/documentation/docbook-xsl/params/entry.propagates.style.xml @@ -0,0 +1,25 @@ + + +entry.propagates.style +boolean + + +entry.propagates.style +Pass entry role attribute through to HTML? + + + + + + + + +Description + +If true, the role attribute of entry elements +will be passed through to the HTML as a class attribute on the +td or th generated for the table +cell. + + + diff --git a/src/documentation/docbook-xsl/params/equation.properties.xml b/src/documentation/docbook-xsl/params/equation.properties.xml new file mode 100644 index 0000000000..8dc70ddc71 --- /dev/null +++ b/src/documentation/docbook-xsl/params/equation.properties.xml @@ -0,0 +1,18 @@ + + +equation.properties +Properties associated with a equation + + + + + + + + +Description + +The styling for equations. + + + diff --git a/src/documentation/docbook-xsl/params/example.properties.xml b/src/documentation/docbook-xsl/params/example.properties.xml new file mode 100644 index 0000000000..116c58d90f --- /dev/null +++ b/src/documentation/docbook-xsl/params/example.properties.xml @@ -0,0 +1,18 @@ + + +example.properties +Properties associated with a example + + + + + + + + +Description + +The styling for examples. + + + diff --git a/src/documentation/docbook-xsl/params/figure.properties.xml b/src/documentation/docbook-xsl/params/figure.properties.xml new file mode 100644 index 0000000000..e232e123cc --- /dev/null +++ b/src/documentation/docbook-xsl/params/figure.properties.xml @@ -0,0 +1,18 @@ + + +figure.properties +Properties associated with a figure + + + + + + + + +Description + +The styling for figures. + + + diff --git a/src/documentation/docbook-xsl/params/firstterm.only.link.xml b/src/documentation/docbook-xsl/params/firstterm.only.link.xml new file mode 100644 index 0000000000..eb53b36d90 --- /dev/null +++ b/src/documentation/docbook-xsl/params/firstterm.only.link.xml @@ -0,0 +1,24 @@ + + +firstterm.only.link +boolean + + +firstterm.only.link +Does automatic glossterm linking only apply to firstterms? + + + + + + + + +Description + +If true, only firstterms will be automatically linked +to the glossary. If glossary linking is not enabled, this parameter +has no effect. + + + diff --git a/src/documentation/docbook-xsl/params/footer.column.widths.xml b/src/documentation/docbook-xsl/params/footer.column.widths.xml new file mode 100644 index 0000000000..63c6478863 --- /dev/null +++ b/src/documentation/docbook-xsl/params/footer.column.widths.xml @@ -0,0 +1,69 @@ + + +footer.column.widths +string + + +footer.column.widths +Specify relative widths of footer areas + + + + + + +Description + +Page footers in print output use a three column table +to position text at the left, center, and right side of +the footer on the page. +This parameter lets you specify the relative sizes of the +three columns. The default value is +"1 1 1". + +The parameter value must be three numbers, separated +by white space. The first number represents the relative +width of the left footer for +single-sided output, or the inside footer for +double-sided output. The second number is the relative +width of the center footer. The third number is the +relative width of the right footer for +single-sided output, or the outside footer for +double-sided output. + + +The numbers are used to specify the column widths +for the table that makes up the footer area. +In the FO output, this looks like: + + + +<fo:table-column column-number="1" + column-width="proportional-column-width(1)"/> + + + +The proportional-column-width() +function computes a column width by dividing its +argument by the total of the arguments for all the columns, and +then multiplying the result by the width of the whole table +(assuming all the column specs use the function). +Its argument can be any positive integer or floating point number. +Zero is an acceptable value, although some FO processors +may warn about it, in which case using a very small number might +be more satisfactory. + + +For example, the value "1 2 1" means the center +footer should have twice the width of the other areas. +A value of "0 0 1" means the entire footer area +is reserved for the right (or outside) footer text. +Note that to keep the center area centered on +the page, the left and right values must be +the same. A specification like "1 2 3" means the +center area is no longer centered on the page +since the right area is three times the width of the left area. + + + + diff --git a/src/documentation/docbook-xsl/params/footer.content.properties.xml b/src/documentation/docbook-xsl/params/footer.content.properties.xml new file mode 100644 index 0000000000..d31c4ed9b3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/footer.content.properties.xml @@ -0,0 +1,29 @@ + + +footer.content.properties + + + +footer.content.properties + + + + + + + + + + + + + + + + +Description + +Properties of page footer content. + + + diff --git a/src/documentation/docbook-xsl/params/footer.rule.xml b/src/documentation/docbook-xsl/params/footer.rule.xml new file mode 100644 index 0000000000..f34b9ac101 --- /dev/null +++ b/src/documentation/docbook-xsl/params/footer.rule.xml @@ -0,0 +1,22 @@ + + +footer.rule +boolean + + +footer.rule +Rule over footers? + + + + + + + + +Description + +If non-zero, a rule will be drawn above the page footers. + + + diff --git a/src/documentation/docbook-xsl/params/footer.table.height.xml b/src/documentation/docbook-xsl/params/footer.table.height.xml new file mode 100644 index 0000000000..6c06f92dd5 --- /dev/null +++ b/src/documentation/docbook-xsl/params/footer.table.height.xml @@ -0,0 +1,27 @@ + + +footer.table.height +string + + +footer.table.height +Specify the minimum height of the table containing the running page footers + + + + + + +Description + +Page footers in print output use a three column table +to position text at the left, center, and right side of +the footer on the page. +This parameter lets you specify the minimum height +of the single row in the table. +Since this specifies only the minimum height, +the table should automatically grow to fit taller content. +The default value is "14pt". + + + diff --git a/src/documentation/docbook-xsl/params/footers.on.blank.pages.xml b/src/documentation/docbook-xsl/params/footers.on.blank.pages.xml new file mode 100644 index 0000000000..fbf2ff8a32 --- /dev/null +++ b/src/documentation/docbook-xsl/params/footers.on.blank.pages.xml @@ -0,0 +1,22 @@ + + +footers.on.blank.pages +boolean + + +footers.on.blank.pages +Put footers on blank pages? + + + + + + + + +Description + +If non-zero, footers will be placed on blank pages. + + + diff --git a/src/documentation/docbook-xsl/params/footnote.font.size.xml b/src/documentation/docbook-xsl/params/footnote.font.size.xml new file mode 100644 index 0000000000..9ab2a4153d --- /dev/null +++ b/src/documentation/docbook-xsl/params/footnote.font.size.xml @@ -0,0 +1,23 @@ + + +footnote.font.size + + + +footnote.font.size +The font size for footnotes + + + + + pt + + + +Description + +The footnote font size is used for...footnotes! + + + + diff --git a/src/documentation/docbook-xsl/params/footnote.mark.properties.xml b/src/documentation/docbook-xsl/params/footnote.mark.properties.xml new file mode 100644 index 0000000000..8a99388461 --- /dev/null +++ b/src/documentation/docbook-xsl/params/footnote.mark.properties.xml @@ -0,0 +1,31 @@ + + +footnote.mark.properties +Properties applied to each footnote mark + + + + + + + 75% + normal + normal + + + + +Description + +This attribute set is applied to the footnote mark used +for each footnote. +It should contain only inline properties. + + +The property to make the mark a superscript is contained in the +footnote template itself, because the current version of FOP reports +an error if baseline-shift is used. + + + + diff --git a/src/documentation/docbook-xsl/params/footnote.number.format.xml b/src/documentation/docbook-xsl/params/footnote.number.format.xml new file mode 100644 index 0000000000..672cfec52f --- /dev/null +++ b/src/documentation/docbook-xsl/params/footnote.number.format.xml @@ -0,0 +1,23 @@ + + +footnote.number.format +string + + +footnote.number.format +Identifies the format used for footnote numbers + + + + + + + + +Description + +The footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A). + + + diff --git a/src/documentation/docbook-xsl/params/footnote.number.symbols.xml b/src/documentation/docbook-xsl/params/footnote.number.symbols.xml new file mode 100644 index 0000000000..f02351177c --- /dev/null +++ b/src/documentation/docbook-xsl/params/footnote.number.symbols.xml @@ -0,0 +1,34 @@ + + +footnote.number.symbols + + + +footnote.number.symbols +Special characters to use as footnote markers + + + + + + + + +Description + +If footnote.number.symbols is not the empty string, +footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + diff --git a/src/documentation/docbook-xsl/params/footnote.properties.xml b/src/documentation/docbook-xsl/params/footnote.properties.xml new file mode 100644 index 0000000000..89a054282f --- /dev/null +++ b/src/documentation/docbook-xsl/params/footnote.properties.xml @@ -0,0 +1,34 @@ + + +footnote.properties +Properties applied to each footnote body + + + + + + + + + normal + normal + + 0pt + 0pt + + + + +Description + +This attribute set is applied to the footnote-block +for each footnote. +It can be used to set the +font-size, font-family, and other inheritable properties that will be +applied to all footnotes. + + + diff --git a/src/documentation/docbook-xsl/params/footnote.sep.leader.properties.xml b/src/documentation/docbook-xsl/params/footnote.sep.leader.properties.xml new file mode 100644 index 0000000000..10ade858e8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/footnote.sep.leader.properties.xml @@ -0,0 +1,30 @@ + + +footnote.sep.leader.properties +Properties associated with a procedure + + + + + + black + rule + 1in + + + + +Description + +The styling for the rule line that separates the +footnotes from the body text. +These are properties applied to the fo:leader used as +the separator. + +If you want to do more than just set properties on +the leader element, then you can customize the template +named footnote.separator in +fo/pagesetup.xsl. + + + diff --git a/src/documentation/docbook-xsl/params/fop.extensions.xml b/src/documentation/docbook-xsl/params/fop.extensions.xml new file mode 100644 index 0000000000..c0c5a7e55b --- /dev/null +++ b/src/documentation/docbook-xsl/params/fop.extensions.xml @@ -0,0 +1,31 @@ + + +fop.extensions +boolean + + +fop.extensions +Enable FOP extensions for version 0.20.5 and earlier + + + + + + +Description + +If non-zero, extensions intended for +FOP +version 0.20.5 and earlier will be used. +At present, this consists of PDF bookmarks. + + +This parameter can also affect which graphics file formats +are supported + +If you are using a version of FOP beyond +version 0.20.5, then use the fop1.extensions +instead. + + + diff --git a/src/documentation/docbook-xsl/params/fop1.extensions.xml b/src/documentation/docbook-xsl/params/fop1.extensions.xml new file mode 100644 index 0000000000..27863041f1 --- /dev/null +++ b/src/documentation/docbook-xsl/params/fop1.extensions.xml @@ -0,0 +1,29 @@ + + +fop1.extensions +boolean + + +fop1.extensions +Enable extensions for FOP version 1 and later + + + + + + +Description + +If non-zero, extensions for +FOP +version 1 and later will be used. + + +This parameter can also affect which graphics file formats +are supported + +The original fop.extensions +should still be used for FOP version 0.20.5 and earlier. + + + diff --git a/src/documentation/docbook-xsl/params/formal.object.properties.xml b/src/documentation/docbook-xsl/params/formal.object.properties.xml new file mode 100644 index 0000000000..d8b7c42175 --- /dev/null +++ b/src/documentation/docbook-xsl/params/formal.object.properties.xml @@ -0,0 +1,27 @@ + + +formal.object.properties +Properties associated with a formal object such as a figure, or other component that has a title + + + + + + 0.5em + 1em + 2em + 0.5em + 1em + 2em + always + + + + +Description + +The styling for formal objects in docbook. Specify the spacing +before and after the object. + + + diff --git a/src/documentation/docbook-xsl/params/formal.procedures.xml b/src/documentation/docbook-xsl/params/formal.procedures.xml new file mode 100644 index 0000000000..04286747f9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/formal.procedures.xml @@ -0,0 +1,23 @@ + + +formal.procedures +boolean + + +formal.procedures +Selects formal or informal procedures + + + + + + + + +Description + +Formal procedures are numbered and always have a title. + + + + diff --git a/src/documentation/docbook-xsl/params/formal.title.placement.xml b/src/documentation/docbook-xsl/params/formal.title.placement.xml new file mode 100644 index 0000000000..4786894b9b --- /dev/null +++ b/src/documentation/docbook-xsl/params/formal.title.placement.xml @@ -0,0 +1,36 @@ + + +formal.title.placement + + + +formal.title.placement +Specifies where formal object titles should occur + + + + + +figure before +example before +equation before +table before +procedure before +task before + + + + +Description + +Specifies where formal object titles should occur. For each formal object +type (figure, +example, +equation, +table, and procedure) +you can specify either the keyword +before or +after. + + + diff --git a/src/documentation/docbook-xsl/params/formal.title.properties.xml b/src/documentation/docbook-xsl/params/formal.title.properties.xml new file mode 100644 index 0000000000..25edc72071 --- /dev/null +++ b/src/documentation/docbook-xsl/params/formal.title.properties.xml @@ -0,0 +1,26 @@ + + +formal.title.properties +Style the title element of formal object such as a figure. + + + + + + bold + + + pt + + false + 0.4em + 0.6em + 0.8em + + + +Description +Specify how the title should be styled. Specify the font size and weight of the title of the formal object. + + diff --git a/src/documentation/docbook-xsl/params/funcsynopsis.decoration.xml b/src/documentation/docbook-xsl/params/funcsynopsis.decoration.xml new file mode 100644 index 0000000000..6aabbdfc5c --- /dev/null +++ b/src/documentation/docbook-xsl/params/funcsynopsis.decoration.xml @@ -0,0 +1,23 @@ + + +funcsynopsis.decoration +boolean + + +funcsynopsis.decoration +Decorate elements of a FuncSynopsis? + + + + + + +Description + +If true (non-zero), elements of the FuncSynopsis will be decorated (e.g. bold or +italic). The decoration is controlled by functions that can be redefined +in a customization layer. + + + + diff --git a/src/documentation/docbook-xsl/params/funcsynopsis.style.xml b/src/documentation/docbook-xsl/params/funcsynopsis.style.xml new file mode 100644 index 0000000000..cb21392a90 --- /dev/null +++ b/src/documentation/docbook-xsl/params/funcsynopsis.style.xml @@ -0,0 +1,26 @@ + + +funcsynopsis.style +list +ansi +kr + + +funcsynopsis.style +What style of 'FuncSynopsis' should be generated? + + + +kr + + +Description + +If funcsynopsis.style is ansi, +ANSI-style function synopses are generated for a +funcsynopsis, otherwise K&R-style +function synopses are generated. + + + + diff --git a/src/documentation/docbook-xsl/params/funcsynopsis.tabular.threshold.xml b/src/documentation/docbook-xsl/params/funcsynopsis.tabular.threshold.xml new file mode 100644 index 0000000000..9760b9d300 --- /dev/null +++ b/src/documentation/docbook-xsl/params/funcsynopsis.tabular.threshold.xml @@ -0,0 +1,24 @@ + + +funcsynopsis.tabular.threshold +integer + + +funcsynopsis.tabular.threshold +Width beyond which a tabular presentation will be used + + + + + + + + +Description + +If funcsynopsis.tabular.threshold is greater than +zero then if a funcprototype is wider than the threshold +value, it will be presented in a table. + + + diff --git a/src/documentation/docbook-xsl/params/function.parens.xml b/src/documentation/docbook-xsl/params/function.parens.xml new file mode 100644 index 0000000000..4856045b13 --- /dev/null +++ b/src/documentation/docbook-xsl/params/function.parens.xml @@ -0,0 +1,23 @@ + + +function.parens +boolean + + +function.parens +Generate parens after a function? + + + +0 + + +Description + +If not 0, the formatting of +a function element will include +generated parenthesis. + + + + diff --git a/src/documentation/docbook-xsl/params/generate.id.attributes.xml b/src/documentation/docbook-xsl/params/generate.id.attributes.xml new file mode 100644 index 0000000000..6c638dca73 --- /dev/null +++ b/src/documentation/docbook-xsl/params/generate.id.attributes.xml @@ -0,0 +1,54 @@ + + +generate.id.attributes + + + +generate.id.attributes + + + + + + + + + +Description + +If non-zero, the HTML stylesheet will generate ID attributes on +containers. For example, the markup: + +Some Title +Some para. +]]> + +might produce: + + +

                  Some Title

                  +

                  Some para.

                  +
                  ]]> + +The alternative is to generate anchors: + + +

                  Some Title

                  +

                  Some para.

                  +]]>                   + +Because the name attribute of +the a element and the id +attribute of other tags are both of type ID, producing both +generates invalid documents. + +As of version 1.50, you can use this switch to control which type of +identifier is generated. For backwards-compatibility, generating +a anchors is preferred. + +Note: at present, this switch is incompletely implemented. +Disabling ID attributes will suppress them, but enabling ID attributes +will not suppress the anchors. + + + diff --git a/src/documentation/docbook-xsl/params/generate.index.xml b/src/documentation/docbook-xsl/params/generate.index.xml new file mode 100644 index 0000000000..0dc2058794 --- /dev/null +++ b/src/documentation/docbook-xsl/params/generate.index.xml @@ -0,0 +1,20 @@ + + +generate.index +boolean + + +generate.index +Do you want an index? + + + + + + +Description + +Specify if an index should be generated. + + + diff --git a/src/documentation/docbook-xsl/params/generate.legalnotice.link.xml b/src/documentation/docbook-xsl/params/generate.legalnotice.link.xml new file mode 100644 index 0000000000..e843ec7095 --- /dev/null +++ b/src/documentation/docbook-xsl/params/generate.legalnotice.link.xml @@ -0,0 +1,44 @@ + + +generate.legalnotice.link +boolean + + +generate.legalnotice.link +Write legalnotice to separate chunk and generate link? + + + + + + +Description + +If the value of generate.legalnotice.link +is non-zero, the stylesheet: + + + + writes the contents of legalnotice to a separate + HTML file + + + inserts a hyperlink to the legalnotice file + + + adds (in the HTML head) either a single + link or element or multiple + link elements (depending on the value of the + html.head.legalnotice.link.multiple + parameter), with the value or values derived from the + html.head.legalnotice.link.types + parameter + + + + Otherwise, if generate.legalnotice.link is + zero, legalnotice contents are rendered on the title + page. + + + diff --git a/src/documentation/docbook-xsl/params/generate.manifest.xml b/src/documentation/docbook-xsl/params/generate.manifest.xml new file mode 100644 index 0000000000..44344afcc6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/generate.manifest.xml @@ -0,0 +1,23 @@ + + + generate.manifest + boolean + + + generate.manifest + Generate a manifest file? + + + + + + + Description + + If non-zero, a list of HTML files generated by the + stylesheet transformation is written to the file named by + the manifest parameter. + + + diff --git a/src/documentation/docbook-xsl/params/generate.meta.abstract.xml b/src/documentation/docbook-xsl/params/generate.meta.abstract.xml new file mode 100644 index 0000000000..6cf6891944 --- /dev/null +++ b/src/documentation/docbook-xsl/params/generate.meta.abstract.xml @@ -0,0 +1,23 @@ + + +generate.meta.abstract +boolean + + +generate.meta.abstract +Generate HTML META element from abstract? + + + + + + + + +Description + +If non-zero, document abstracts will be reproduced in the HTML +HEAD with meta name="description" content="...". + + + diff --git a/src/documentation/docbook-xsl/params/generate.revhistory.link.xml b/src/documentation/docbook-xsl/params/generate.revhistory.link.xml new file mode 100644 index 0000000000..abbcd7aeda --- /dev/null +++ b/src/documentation/docbook-xsl/params/generate.revhistory.link.xml @@ -0,0 +1,23 @@ + + +generate.revhistory.link +boolean + + +generate.revhistory.link +Write revhistory to separate chunk and generate link? + + + + + + +Description + +If non-zero, the contents of revhistory are written +to a separate HTML file and a link to the file is +generated. Otherwise, revhistory contents are rendered on +the title page. + + + diff --git a/src/documentation/docbook-xsl/params/generate.section.toc.level.xml b/src/documentation/docbook-xsl/params/generate.section.toc.level.xml new file mode 100644 index 0000000000..ba9bf294d2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/generate.section.toc.level.xml @@ -0,0 +1,30 @@ + + +generate.section.toc.level +integer + + +generate.section.toc.level +Control depth of TOC generation in sections + + + + + + + + +Description + +The generate.section.toc.level parameter +controls the depth of section in which TOCs will be generated. Note +that this is related to, but not the same as +toc.section.depth, which controls the depth to +which TOC entries will be generated in a given TOC. +If, for example, generate.section.toc.level +is 3, TOCs will be generated in first, second, and third +level sections, but not in fourth level sections. + + + + diff --git a/src/documentation/docbook-xsl/params/generate.toc.xml b/src/documentation/docbook-xsl/params/generate.toc.xml new file mode 100644 index 0000000000..258910075c --- /dev/null +++ b/src/documentation/docbook-xsl/params/generate.toc.xml @@ -0,0 +1,103 @@ + + +generate.toc +table + + +generate.toc +Control generation of ToCs and LoTs + + + + + +appendix toc,title +article/appendix nop +article toc,title +book toc,title,figure,table,example,equation +chapter toc,title +part toc,title +preface toc,title +qandadiv toc +qandaset toc +reference toc,title +sect1 toc +sect2 toc +sect3 toc +sect4 toc +sect5 toc +section toc +set toc,title + + +/appendix toc,title +article/appendix nop +/article toc,title +book toc,title,figure,table,example,equation +/chapter toc,title +part toc,title +/preface toc,title +reference toc,title +/sect1 toc +/sect2 toc +/sect3 toc +/sect4 toc +/sect5 toc +/section toc +set toc,title + + + + +Description + +This parameter has a structured value. It is a table of space-delimited +path/value pairs. Each path identifies some element in the source document +using a restricted subset of XPath (only the implicit child axis, no wildcards, +no predicates). Paths can be either relative or absolute. + +When processing a particular element, the stylesheets consult this table to +determine if a ToC (or LoT(s)) should be generated. + +For example, consider the entry: + +book toc,figure + +This indicates that whenever a book is formatted, a +Table Of Contents and a List of Figures should be generated. Similarly, + +/chapter toc + +indicates that whenever a document that has a root +of chapter is formatted, a Table of +Contents should be generated. The entry chapter would match +all chapters, but /chapter matches only chapter +document elements. + +Generally, the longest match wins. So, for example, if you want to distinguish +articles in books from articles in parts, you could use these two entries: + +book/article toc,figure +part/article toc + +Note that an article in a part can never match a book/article, +so if you want nothing to be generated for articles in parts, you can simply leave +that rule out. + +If you want to leave the rule in, to make it explicit that you're turning +something off, use the value nop. For example, the following +entry disables ToCs and LoTs for articles: + +article nop + +Do not simply leave the word article in the file +without a matching value. That'd be just begging the silly little +path/value parser to get confused. + +Section ToCs are further controlled by the +generate.section.toc.level parameter. +For a given section level to have a ToC, it must have both an entry in +generate.toc and be within the range enabled by +generate.section.toc.level. + + diff --git a/src/documentation/docbook-xsl/params/glossary.as.blocks.xml b/src/documentation/docbook-xsl/params/glossary.as.blocks.xml new file mode 100644 index 0000000000..dd92f05630 --- /dev/null +++ b/src/documentation/docbook-xsl/params/glossary.as.blocks.xml @@ -0,0 +1,33 @@ + + +glossary.as.blocks +boolean + + +glossary.as.blocks +Present glossarys using blocks instead of lists? + + + + + + + + +Description + +If non-zero, glossarys will be formatted as +blocks. + +If you have long glossterms, proper list +markup in the FO case may produce unattractive lists. By setting this +parameter, you can force the stylesheets to produce block markup +instead of proper lists. + +You can override this setting with a processing instruction as the +child of glossary: dbfo +glossary-presentation="blocks" or dbfo +glossary-presentation="list" + + + diff --git a/src/documentation/docbook-xsl/params/glossary.collection.xml b/src/documentation/docbook-xsl/params/glossary.collection.xml new file mode 100644 index 0000000000..eb26556ce6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/glossary.collection.xml @@ -0,0 +1,247 @@ + + +glossary.collection +string + + +glossary.collection +Name of the glossary collection file + + + + + + + + +Description + +Glossaries maintained independently across a set of documents +are likely to become inconsistent unless considerable effort is +expended to keep them in sync. It makes much more sense, usually, to +store all of the glossary entries in a single place and simply +extract the ones you need in each document. + +That's the purpose of the +glossary.collection parameter. To setup a global +glossary database, follow these steps: + +Setting Up the Glossary Database + +First, create a stand-alone glossary document that contains all of +the entries that you wish to reference. Make sure that each glossary +entry has an ID. + +Here's an example glossary: + + + + + + +EricRaymond +Jargon File 4.2.3 (abridged) +Just some test data + + +0 + + +0 + +Numeric zero, as opposed to the letter `O' (the 15th letter of +the English alphabet). In their unmodified forms they look a lot +alike, and various kluges invented to make them visually distinct have +compounded the confusion. If your zero is center-dotted and letter-O +is not, or if letter-O looks almost rectangular but zero looks more +like an American football stood on end (or the reverse), you're +probably looking at a modern character display (though the dotted zero +seems to have originated as an option on IBM 3270 controllers). If +your zero is slashed but letter-O is not, you're probably looking at +an old-style ASCII graphic set descended from the default typewheel on +the venerable ASR-33 Teletype (Scandinavians, for whom /O is a letter, +curse this arrangement). (Interestingly, the slashed zero long +predates computers; Florian Cajori's monumental "A History of +Mathematical Notations" notes that it was used in the twelfth and +thirteenth centuries.) If letter-O has a slash across it and the zero +does not, your display is tuned for a very old convention used at IBM +and a few other early mainframe makers (Scandinavians curse this +arrangement even more, because it means two of their letters collide). +Some Burroughs/Unisys equipment displays a zero with a reversed +slash. Old CDC computers rendered letter O as an unbroken oval and 0 +as an oval broken at upper right and lower left. And yet another +convention common on early line printers left zero unornamented but +added a tail or hook to the letter-O so that it resembled an inverted +Q or cursive capital letter-O (this was endorsed by a draft ANSI +standard for how to draw ASCII characters, but the final standard +changed the distinguisher to a tick-mark in the upper-left corner). +Are we sufficiently confused yet? + + + + +1TBS + + + +n + +The "One True Brace Style" +indent style + + + + + + + + + +]]> + + + + +Marking Up Glossary Terms + +That takes care of the glossary database, now you have to get the entries +into your document. Unlike bibliography entries, which can be empty, creating +placeholder glossary entries would be very tedious. So instead, +support for glossary.collection relies on implicit linking. + +In your source document, simply use firstterm and +glossterm to identify the terms you wish to have included +in the glossary. The stylesheets assume that you will either set the +baseform attribute correctly, or that the +content of the element exactly matches a term in your glossary. + +If you're using a glossary.collection, don't +make explicit links on the terms in your document. + +So, in your document, you might write things like this: + + +This is dummy text, without any real meaning. +The point is simply to reference glossary terms like 0 +and the One True Brace Style (1TBS). +The 1TBS, as you can probably imagine, is a nearly +religious issue.]]> + + +If you set the firstterm.only.link parameter, +only the terms marked with firstterm will be links. +Otherwise, all the terms will be linked. + + + +Marking Up the Glossary + +The glossary itself has to be identified for the stylesheets. For lack +of a better choice, the role is used. +To identify the glossary as the target for automatic processing, set +the role to auto. The title of this +glossary (and any other information from the glossaryinfo +that's rendered by your stylesheet) will be displayed, but the entries will +come from the database. + + +Unfortunately, the glossary can't be empty, so you must put in +at least one glossentry. The content of this entry +is irrelevant, it will not be rendered: + + + + +Irrelevant + +If you can see this, the document was processed incorrectly. Use +the glossary.collection parameter. + + +]]> + + +What about glossary divisions? If your glossary database has glossary +divisions and your automatic glossary contains at least +one glossdiv, the automic glossary will have divisions. +If the glossdiv is missing from either location, no divisions +will be rendered. + +Glossary entries (and divisions, if appropriate) in the glossary will +occur in precisely the order they occur in your database. + + + +Formatting the Document + +Finally, when you are ready to format your document, simply set the +glossary.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global glossary. + +The stylesheets will format the glossary in your document as if +all of the entries implicilty referenced appeared there literally. + + +Limitations + +Glossary cross-references within the glossary are +not supported. For example, this will not work: + + + +gloss-1 +A description that references gloss-2. +gloss-2 + +]]> + + +If you put glossary cross-references in your glossary that way, +you'll get the cryptic error: Warning: +glossary.collection specified, but there are 0 automatic +glossaries. + +Instead, you must do two things: + + + +Markup your glossary using glossseealso: + + + +gloss-1 +A description that references gloss-2. +gloss-2 + +]]> + + + + +Make sure there is at least one glossterm reference to +gloss-2 in your document. The +easiest way to do that is probably within a remark in your +automatic glossary: + + + +Make sure there's a reference to gloss-2. + +Irrelevant + +If you can see this, the document was processed incorrectly. Use +the glossary.collection parameter. + + +]]> + + + + + + + diff --git a/src/documentation/docbook-xsl/params/glossentry.show.acronym.xml b/src/documentation/docbook-xsl/params/glossentry.show.acronym.xml new file mode 100644 index 0000000000..feacb9f7c8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/glossentry.show.acronym.xml @@ -0,0 +1,29 @@ + + +glossentry.show.acronym +list + + +glossentry.show.acronym +Display glossentry acronyms? + + + + + + + + +Description + +A setting of yes means they should be displayed; +no means they shouldn't. If primary is used, +then they are shown as the primary text for the entry. + + +This setting controls both acronym and +abbrev elements in the glossentry. + + + + diff --git a/src/documentation/docbook-xsl/params/glosslist.as.blocks.xml b/src/documentation/docbook-xsl/params/glosslist.as.blocks.xml new file mode 100644 index 0000000000..53af6ee2f7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/glosslist.as.blocks.xml @@ -0,0 +1,22 @@ + + +glosslist.as.blocks +boolean + + +glosslist.as.blocks +Use blocks for glosslists? + + + + + + + + +Description + +See glossary.as.blocks. + + + diff --git a/src/documentation/docbook-xsl/params/glossterm.auto.link.xml b/src/documentation/docbook-xsl/params/glossterm.auto.link.xml new file mode 100644 index 0000000000..0478977bc6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/glossterm.auto.link.xml @@ -0,0 +1,28 @@ + + +glossterm.auto.link +boolean + + +glossterm.auto.link +Generate links from glossterm to glossentry automaticaly? + + + + + + + + +Description + +If true, a link will be automatically created from glossterm +to glossentry for that glossary term. This is usefull when your +glossterm names are consistent and you don't want to add links +manually. +If there is linkend on +glossterm then is used instead of autogeneration of +link. + + + diff --git a/src/documentation/docbook-xsl/params/glossterm.separation.xml b/src/documentation/docbook-xsl/params/glossterm.separation.xml new file mode 100644 index 0000000000..d69a2b9281 --- /dev/null +++ b/src/documentation/docbook-xsl/params/glossterm.separation.xml @@ -0,0 +1,23 @@ + + +glossterm.separation +length + + +glossterm.separation +Separation between glossary terms and descriptions in list mode + + + + + + + + +Description + +Specifies the separation between glossary terms and descriptions when +glossarys are presented using lists. + + + diff --git a/src/documentation/docbook-xsl/params/glossterm.width.xml b/src/documentation/docbook-xsl/params/glossterm.width.xml new file mode 100644 index 0000000000..6f26d76f66 --- /dev/null +++ b/src/documentation/docbook-xsl/params/glossterm.width.xml @@ -0,0 +1,23 @@ + + +glossterm.width +length + + +glossterm.width +Width of glossterm in list presentation mode + + + + + + + + +Description + +This parameter specifies the width reserved for glossary terms when +a list presentation is used. + + + diff --git a/src/documentation/docbook-xsl/params/graphic.default.extension.xml b/src/documentation/docbook-xsl/params/graphic.default.extension.xml new file mode 100644 index 0000000000..58d763c659 --- /dev/null +++ b/src/documentation/docbook-xsl/params/graphic.default.extension.xml @@ -0,0 +1,24 @@ + + +graphic.default.extension +string + + +graphic.default.extension +Default extension for graphic filenames + + + + + + +Description + +If a graphic or mediaobject +includes a reference to a filename that does not include an extension, +and the format attribute is +unspecified, the default extension will be used. + + + + diff --git a/src/documentation/docbook-xsl/params/graphical.admonition.properties.xml b/src/documentation/docbook-xsl/params/graphical.admonition.properties.xml new file mode 100644 index 0000000000..e892a29cad --- /dev/null +++ b/src/documentation/docbook-xsl/params/graphical.admonition.properties.xml @@ -0,0 +1,33 @@ + + +graphical.admonition.properties +To add properties to the outer block of a graphical admonition. + + + + + 1em + 0.8em + 1.2em + 1em + 0.8em + 1.2em + + + +Description +These properties are added to the outer block containing the +entire graphical admonition, including its title. +It is used when the parameter +admon.graphics is set to nonzero. +Use this attribute-set to set the space above and below, +and any indent for the whole admonition. + +In addition to these properties, a graphical admonition +also applies the admonition.title.properties +attribute-set to the title, and applies the +admonition.properties attribute-set +to the rest of the content. + + + diff --git a/src/documentation/docbook-xsl/params/graphicsize.extension.xml b/src/documentation/docbook-xsl/params/graphicsize.extension.xml new file mode 100644 index 0000000000..e8cacff037 --- /dev/null +++ b/src/documentation/docbook-xsl/params/graphicsize.extension.xml @@ -0,0 +1,25 @@ + + +graphicsize.extension +boolean + + +graphicsize.extension +Enable the getWidth()/getDepth() extension functions + + + + + + + + +Description + +If non-zero (and if use.extensions is non-zero +and if you're using a processor that supports extension functions), the +getWidth and getDepth functions +will be used to extract image sizes from graphics. + + + diff --git a/src/documentation/docbook-xsl/params/graphicsize.use.img.src.path.xml b/src/documentation/docbook-xsl/params/graphicsize.use.img.src.path.xml new file mode 100644 index 0000000000..74cc56eda6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/graphicsize.use.img.src.path.xml @@ -0,0 +1,25 @@ + + +graphicsize.use.img.src.path +boolean + + +graphicsize.use.img.src.path +Prepend img.src.path before +filenames passed to extension functions + + + + + + + + +Description + +If non-zero img.src.path parameter will +be appended before filenames passed to extension functions for +measuring image dimensions. + + + diff --git a/src/documentation/docbook-xsl/params/header.column.widths.xml b/src/documentation/docbook-xsl/params/header.column.widths.xml new file mode 100644 index 0000000000..f88dc6fb13 --- /dev/null +++ b/src/documentation/docbook-xsl/params/header.column.widths.xml @@ -0,0 +1,69 @@ + + +header.column.widths +string + + +header.column.widths +Specify relative widths of header areas + + + + + + +Description + +Page headers in print output use a three column table +to position text at the left, center, and right side of +the header on the page. +This parameter lets you specify the relative sizes of the +three columns. The default value is +"1 1 1". + +The parameter value must be three numbers, separated +by white space. The first number represents the relative +width of the left header for +single-sided output, or the inside header for +double-sided output. The second number is the relative +width of the center header. The third number is the +relative width of the right header for +single-sided output, or the outside header for +double-sided output. + + +The numbers are used to specify the column widths +for the table that makes up the header area. +In the FO output, this looks like: + + + +<fo:table-column column-number="1" + column-width="proportional-column-width(1)"/> + + + +The proportional-column-width() +function computes a column width by dividing its +argument by the total of the arguments for all the columns, and +then multiplying the result by the width of the whole table +(assuming all the column specs use the function). +Its argument can be any positive integer or floating point number. +Zero is an acceptable value, although some FO processors +may warn about it, in which case using a very small number might +be more satisfactory. + + +For example, the value "1 2 1" means the center +header should have twice the width of the other areas. +A value of "0 0 1" means the entire header area +is reserved for the right (or outside) header text. +Note that to keep the center area centered on +the page, the left and right values must be +the same. A specification like "1 2 3" means the +center area is no longer centered on the page +since the right area is three times the width of the left area. + + + + diff --git a/src/documentation/docbook-xsl/params/header.content.properties.xml b/src/documentation/docbook-xsl/params/header.content.properties.xml new file mode 100644 index 0000000000..7ba0986fdc --- /dev/null +++ b/src/documentation/docbook-xsl/params/header.content.properties.xml @@ -0,0 +1,29 @@ + + +header.content.properties + + + +header.content.properties + + + + + + + + + + + + + + + + +Description + +Properties of page header content. + + + diff --git a/src/documentation/docbook-xsl/params/header.rule.xml b/src/documentation/docbook-xsl/params/header.rule.xml new file mode 100644 index 0000000000..0455f1a0c2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/header.rule.xml @@ -0,0 +1,22 @@ + + +header.rule +boolean + + +header.rule +Rule under headers? + + + + + + + + +Description + +If non-zero, a rule will be drawn below the page headers. + + + diff --git a/src/documentation/docbook-xsl/params/header.table.height.xml b/src/documentation/docbook-xsl/params/header.table.height.xml new file mode 100644 index 0000000000..a919d05012 --- /dev/null +++ b/src/documentation/docbook-xsl/params/header.table.height.xml @@ -0,0 +1,27 @@ + + +header.table.height +string + + +header.table.height +Specify the minimum height of the table containing the running page headers + + + + + + +Description + +Page headers in print output use a three column table +to position text at the left, center, and right side of +the header on the page. +This parameter lets you specify the minimum height +of the single row in the table. +Since this specifies only the minimum height, +the table should automatically grow to fit taller content. +The default value is "14pt". + + + diff --git a/src/documentation/docbook-xsl/params/headers.on.blank.pages.xml b/src/documentation/docbook-xsl/params/headers.on.blank.pages.xml new file mode 100644 index 0000000000..ba8fb0f28d --- /dev/null +++ b/src/documentation/docbook-xsl/params/headers.on.blank.pages.xml @@ -0,0 +1,22 @@ + + +headers.on.blank.pages +boolean + + +headers.on.blank.pages +Put headers on blank pages? + + + + + + + + +Description + +If non-zero, headers will be placed on blank pages. + + + diff --git a/src/documentation/docbook-xsl/params/html.base.xml b/src/documentation/docbook-xsl/params/html.base.xml new file mode 100644 index 0000000000..0398894181 --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.base.xml @@ -0,0 +1,23 @@ + + +html.base +uri + + +html.base +An HTML base URI + + + + + + +Description + +If html.base is set, it is used for the BASE +element in the HEAD of the HTML documents. +This is useful for dynamically served HTML where the base URI needs +to be shifted. + + + diff --git a/src/documentation/docbook-xsl/params/html.cellpadding.xml b/src/documentation/docbook-xsl/params/html.cellpadding.xml new file mode 100644 index 0000000000..0180a139fc --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.cellpadding.xml @@ -0,0 +1,23 @@ + + +html.cellpadding +integer + + +html.cellpadding +Default value for cellpadding in HTML tables + + + + + + + + +Description + +If specified, this value will be used as the default cellpadding value +in HTML tables. + + + diff --git a/src/documentation/docbook-xsl/params/html.cellspacing.xml b/src/documentation/docbook-xsl/params/html.cellspacing.xml new file mode 100644 index 0000000000..10fbe0182b --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.cellspacing.xml @@ -0,0 +1,23 @@ + + +html.cellspacing +integer + + +html.cellspacing +Default value for cellspacing in HTML tables + + + + + + + + +Description + +If specified, this value will be used as the default cellspacing value +in HTML tables. + + + diff --git a/src/documentation/docbook-xsl/params/html.cleanup.xml b/src/documentation/docbook-xsl/params/html.cleanup.xml new file mode 100644 index 0000000000..43fa6b4f1e --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.cleanup.xml @@ -0,0 +1,29 @@ + + +html.cleanup +boolean + + +html.cleanup +Attempt to clean up the resulting HTML? + + + + + + + + +Description + +If non-zero, and if the EXSLT +extensions are supported by your processor, the resulting HTML will be +cleaned up. This improves the chances that the +resulting HTML will be valid. It may also improve the formatting of +some elements. + +This parameter is different from make.valid.html +because it uses extension functions to manipulate result-tree-fragments. + + + diff --git a/src/documentation/docbook-xsl/params/html.ext.xml b/src/documentation/docbook-xsl/params/html.ext.xml new file mode 100644 index 0000000000..dd202057a6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.ext.xml @@ -0,0 +1,24 @@ + + +html.ext + + + +html.ext +Identifies the extension of generated HTML files + + + + + + + + +Description + +The extension identified by html.ext will +be used as the filename extension for chunks created by this stylesheet. + + + + diff --git a/src/documentation/docbook-xsl/params/html.extra.head.links.xml b/src/documentation/docbook-xsl/params/html.extra.head.links.xml new file mode 100644 index 0000000000..5680e59754 --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.extra.head.links.xml @@ -0,0 +1,26 @@ + + +html.extra.head.links +boolean + + +html.extra.head.links +Toggle extra HTML head link information + + + + + + + + +Description + +If non-zero, extra link elements will be +generated in the head of chunked HTML files. These +extra links point to chapters, appendixes, sections, etc. as supported +by the Site Navigation Bar in Mozilla 1.0 (as of CR1, at least). + + + + diff --git a/src/documentation/docbook-xsl/params/html.head.legalnotice.link.multiple.xml b/src/documentation/docbook-xsl/params/html.head.legalnotice.link.multiple.xml new file mode 100644 index 0000000000..5f02ff9c18 --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.head.legalnotice.link.multiple.xml @@ -0,0 +1,37 @@ + + +html.head.legalnotice.link.multiple +boolean + + +html.head.legalnotice.link.multiple +Generate multiple link instances in html head for legalnotice? + + + + + + +Description + +If html.head.legalnotice.link.multiple is +non-zero and the value of +html.head.legalnotice.link.types contains +multiple link types, then the stylesheet generates (in the +head section of the HTML source) one +link element for each link type specified. For +example, if the value of +html.head.legalnotice.link.types is +“copyright license”: + + <link rel="copyright" href="ln-id2524073.html" title="Legal Notice"> + <link rel="license" href="ln-id2524073.html" title="Legal Notice"> + + Otherwise, the stylesheet generates generates a single + link instance; for example: + + <link rel="copyright license" href="ln-id2524073.html" title="Legal Notice"> + + + + diff --git a/src/documentation/docbook-xsl/params/html.head.legalnotice.link.types.xml b/src/documentation/docbook-xsl/params/html.head.legalnotice.link.types.xml new file mode 100644 index 0000000000..69313b7d36 --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.head.legalnotice.link.types.xml @@ -0,0 +1,72 @@ + + +html.head.legalnotice.link.types +string + + +html.head.legalnotice.link.types +Specifies link types for legalnotice link in html head + + + + +copyright + + + +Description + +The value of +html.head.legalnotice.link.types is a +space-separated list of link types, as described in Section 6.12 +of the HTML 4.01 specification. If the value of the +generate.legalnotice.link parameter is +non-zero, then the stylesheet generates (in the +head section of the HTML source) either a single +HTML link element or, if the value of the +html.head.legalnotice.link.multiple is +non-zero, one link element for each link type +specified. Each link has the following attributes: + + + + a rel attribute whose + value is derived from the value of + html.head.legalnotice.link.types + + + an href attribute whose + value is set to the URL of the file containing the + legalnotice + + + a title attribute whose + value is set to the title of the corresponding + legalnotice (or a title programatically + determined by the stylesheet) + + + +For example: + + <link rel="license" href="ln-id2524073.html" title="Legal Notice"> + + + + About the default value + In an ideal world, the default value of + html.head.legalnotice.link.types would + probably be “license”, since the content of the + DocBook legalnotice is typically license + information, not copyright information. However, the default value + is “copyright” for pragmatic reasons: because + that’s among the set of “recognized link types” listed in Section + 6.12 of the HTML 4.01 specification, and because certain + browsers and browser extensions are preconfigured to recognize that + value. + + + + diff --git a/src/documentation/docbook-xsl/params/html.longdesc.link.xml b/src/documentation/docbook-xsl/params/html.longdesc.link.xml new file mode 100644 index 0000000000..a3406f29b5 --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.longdesc.link.xml @@ -0,0 +1,29 @@ + + +html.longdesc.link +boolean + + +html.longdesc.link +Should a link to the longdesc be included in the HTML? + + + + + + + + +Description + +If non-zero, links will be created to the +HTML files created for the +longdesc attribute. It makes no +sense to turn enable this option without also enabling the +$html.longdesc parameter. + +The longdesc.link named template is called +to construct the link. + + + diff --git a/src/documentation/docbook-xsl/params/html.longdesc.xml b/src/documentation/docbook-xsl/params/html.longdesc.xml new file mode 100644 index 0000000000..1098b69e4a --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.longdesc.xml @@ -0,0 +1,27 @@ + + +html.longdesc +boolean + + +html.longdesc +Should longdesc URIs be created? + + + + + + + + +Description + +If non-zero, HTML files will be created for the +longdesc attribute. These files +are created from the textobjects in +mediaobjects and +inlinemediaobject. + + + + diff --git a/src/documentation/docbook-xsl/params/html.stylesheet.type.xml b/src/documentation/docbook-xsl/params/html.stylesheet.type.xml new file mode 100644 index 0000000000..8cea763b89 --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.stylesheet.type.xml @@ -0,0 +1,21 @@ + + +html.stylesheet.type +string + + +html.stylesheet.type +The type of the stylesheet used in the generated HTML + + + +text/css + + +Description + +The type of the stylesheet to place in the HTML link tag. + + + + diff --git a/src/documentation/docbook-xsl/params/html.stylesheet.xml b/src/documentation/docbook-xsl/params/html.stylesheet.xml new file mode 100644 index 0000000000..d78332fbcf --- /dev/null +++ b/src/documentation/docbook-xsl/params/html.stylesheet.xml @@ -0,0 +1,30 @@ + + +html.stylesheet +string + + +html.stylesheet +Name of the stylesheet(s) to use in the generated HTML + + + + + + + + +Description + +The html.stylesheet parameter is either empty, +indicating that no stylesheet LINK tag should be generated +in the HTML output, or it is a list of one or more stylesheets. + +Multiple stylesheets are space-delimited. If you need to +reference a stylesheet URI that includes a space, encode it with +%20. A seprate HTML LINK element will +be generated for each stylesheet in the order they are listed in the +parameter. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.alias.file.xml b/src/documentation/docbook-xsl/params/htmlhelp.alias.file.xml new file mode 100644 index 0000000000..ff67d1c14c --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.alias.file.xml @@ -0,0 +1,23 @@ + + +htmlhelp.alias.file +string + + +htmlhelp.alias.file +Filename of map file. + + + + + + + + +Description + +Change this parameter if you want different name of map file +than alias.h. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.autolabel.xml b/src/documentation/docbook-xsl/params/htmlhelp.autolabel.xml new file mode 100644 index 0000000000..25c65cbda9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.autolabel.xml @@ -0,0 +1,23 @@ + + +htmlhelp.autolabel +boolean + + +htmlhelp.autolabel +Should tree-like ToC use autonumbering feature? + + + + + + + + +Description + +If you want to include chapter and section numbers into ToC in +the left panel, set this parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.back.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.back.xml new file mode 100644 index 0000000000..99f2dc6065 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.back.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.back +boolean + + +htmlhelp.button.back +Should be Back button shown? + + + + + + + + +Description + +If you want Back button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.forward.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.forward.xml new file mode 100644 index 0000000000..c4e699a385 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.forward.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.forward +boolean + + +htmlhelp.button.forward +Should be Forward button shown? + + + + + + + + +Description + +If you want Forward button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.hideshow.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.hideshow.xml new file mode 100644 index 0000000000..118d3754c9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.hideshow.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.hideshow +boolean + + +htmlhelp.button.hideshow +Should be Hide/Show button shown? + + + + + + + + +Description + +If you want Hide/Show button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.home.url.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.home.url.xml new file mode 100644 index 0000000000..5d19ff7470 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.home.url.xml @@ -0,0 +1,22 @@ + + +htmlhelp.button.home.url +string + + +htmlhelp.button.home.url +URL address of page accessible by Home button + + + + + + + + +Description + +URL address of page accessible by Home button. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.home.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.home.xml new file mode 100644 index 0000000000..ab7c6f2929 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.home.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.home +boolean + + +htmlhelp.button.home +Should be Home button shown? + + + + + + + + +Description + +If you want Home button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.jump1.title.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.jump1.title.xml new file mode 100644 index 0000000000..ddcc65cfdf --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.jump1.title.xml @@ -0,0 +1,22 @@ + + +htmlhelp.button.jump1.title +string + + +htmlhelp.button.jump1.title +Title of Jump1 button + + + + + + + + +Description + +Title of Jump1 button. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.jump1.url.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.jump1.url.xml new file mode 100644 index 0000000000..f800538c85 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.jump1.url.xml @@ -0,0 +1,22 @@ + + +htmlhelp.button.jump1.url +string + + +htmlhelp.button.jump1.url +URL address of page accessible by Jump1 button + + + + + + + + +Description + +URL address of page accessible by Jump1 button. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.jump1.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.jump1.xml new file mode 100644 index 0000000000..a578dd675b --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.jump1.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.jump1 +boolean + + +htmlhelp.button.jump1 +Should be Jump1 button shown? + + + + + + + + +Description + +If you want Jump1 button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.jump2.title.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.jump2.title.xml new file mode 100644 index 0000000000..05a1c2992f --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.jump2.title.xml @@ -0,0 +1,22 @@ + + +htmlhelp.button.jump2.title +string + + +htmlhelp.button.jump2.title +Title of Jump2 button + + + + + + + + +Description + +Title of Jump2 button. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.jump2.url.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.jump2.url.xml new file mode 100644 index 0000000000..492b52b2e8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.jump2.url.xml @@ -0,0 +1,22 @@ + + +htmlhelp.button.jump2.url +string + + +htmlhelp.button.jump2.url +URL address of page accessible by Jump2 button + + + + + + + + +Description + +URL address of page accessible by Jump2 button. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.jump2.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.jump2.xml new file mode 100644 index 0000000000..3d89acf702 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.jump2.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.jump2 +boolean + + +htmlhelp.button.jump2 +Should be Jump2 button shown? + + + + + + + + +Description + +If you want Jump2 button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.locate.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.locate.xml new file mode 100644 index 0000000000..ffa89cda85 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.locate.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.locate +boolean + + +htmlhelp.button.locate +Should be Locate button shown? + + + + + + + + +Description + +If you want Locate button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.next.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.next.xml new file mode 100644 index 0000000000..aa7552d5f8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.next.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.next +boolean + + +htmlhelp.button.next +Should be Next button shown? + + + + + + + + +Description + +If you want Next button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.options.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.options.xml new file mode 100644 index 0000000000..70ca16b2dc --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.options.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.options +boolean + + +htmlhelp.button.options +Should be Options button shown? + + + + + + + + +Description + +If you want Options button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.prev.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.prev.xml new file mode 100644 index 0000000000..f47a78a9ac --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.prev.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.prev +boolean + + +htmlhelp.button.prev +Should be Prev button shown? + + + + + + + + +Description + +If you want Prev button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.print.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.print.xml new file mode 100644 index 0000000000..58eb7cf0b9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.print.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.print +boolean + + +htmlhelp.button.print +Should be Print button shown? + + + + + + + + +Description + +If you want Print button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.refresh.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.refresh.xml new file mode 100644 index 0000000000..9a9e14037c --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.refresh.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.refresh +boolean + + +htmlhelp.button.refresh +Should be Refresh button shown? + + + + + + + + +Description + +If you want Refresh button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.stop.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.stop.xml new file mode 100644 index 0000000000..5b88acb91f --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.stop.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.stop +boolean + + +htmlhelp.button.stop +Should be Stop button shown? + + + + + + + + +Description + +If you want Stop button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.button.zoom.xml b/src/documentation/docbook-xsl/params/htmlhelp.button.zoom.xml new file mode 100644 index 0000000000..f6e4a18d04 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.button.zoom.xml @@ -0,0 +1,23 @@ + + +htmlhelp.button.zoom +boolean + + +htmlhelp.button.zoom +Should be Zoom button shown? + + + + + + + + +Description + +If you want Zoom button shown on toolbar, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.chm.xml b/src/documentation/docbook-xsl/params/htmlhelp.chm.xml new file mode 100644 index 0000000000..7d571e3208 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.chm.xml @@ -0,0 +1,23 @@ + + +htmlhelp.chm +string + + +htmlhelp.chm +Filename of output HTML Help file. + + + + + + + + +Description + +Change this parameter if you want different name of result +CHM file than htmlhelp.chm. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.default.topic.xml b/src/documentation/docbook-xsl/params/htmlhelp.default.topic.xml new file mode 100644 index 0000000000..9350d7b3a2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.default.topic.xml @@ -0,0 +1,31 @@ + + +htmlhelp.default.topic +string + + +htmlhelp.default.topic +Name of file with default topic + + + + + + + + +Description + +Normally first chunk of document is displayed when you open HTML +Help file. If you want to display another topic, simply set its +filename by this parameter. + +This is useful especially if you don't generate ToC in front of +your document and you also hide root element in ToC. E.g.: + + + +]]> + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.display.progress.xml b/src/documentation/docbook-xsl/params/htmlhelp.display.progress.xml new file mode 100644 index 0000000000..fee4164d8d --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.display.progress.xml @@ -0,0 +1,24 @@ + + +htmlhelp.display.progress +boolean + + +htmlhelp.display.progress +Display compile progress? + + + + + + + + +Description + +You can swith off display of compile progress by setting this +parameter to 0. + + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.encoding.xml b/src/documentation/docbook-xsl/params/htmlhelp.encoding.xml new file mode 100644 index 0000000000..f7c04b5458 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.encoding.xml @@ -0,0 +1,23 @@ + + +htmlhelp.encoding +string + + +htmlhelp.encoding +Character encoding to use in files for HTML Help compiler. + + + + + + + + +Description + +HTML Help Compiler is not UTF-8 aware, so you should always use +apropriate single-byte encoding here. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.enhanced.decompilation.xml b/src/documentation/docbook-xsl/params/htmlhelp.enhanced.decompilation.xml new file mode 100644 index 0000000000..881b00a88b --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.enhanced.decompilation.xml @@ -0,0 +1,23 @@ + + +htmlhelp.enhanced.decompilation +boolean + + +htmlhelp.enhanced.decompilation +Allow enhanced decompilation of CHM? + + + + + + + + +Description + +When set to 1 this parameter enables enhanced decompilation of CHM. + + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.enumerate.images.xml b/src/documentation/docbook-xsl/params/htmlhelp.enumerate.images.xml new file mode 100644 index 0000000000..723dbdafa0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.enumerate.images.xml @@ -0,0 +1,23 @@ + + +htmlhelp.enumerate.images +boolean + + +htmlhelp.enumerate.images +Should be paths to all used images added to project file? + + + + + + + + +Description + +You should turn on this flag, if you insert images into your documents +as external binary entities or if you are using absolute path in image names. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.force.map.and.alias.xml b/src/documentation/docbook-xsl/params/htmlhelp.force.map.and.alias.xml new file mode 100644 index 0000000000..92a9e69597 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.force.map.and.alias.xml @@ -0,0 +1,24 @@ + + +htmlhelp.force.map.and.alias +boolean + + +htmlhelp.force.map.and.alias +Should be [MAP] and [ALIAS] section added to project file unconditionaly? + + + + + + + + +Description + +You should turn on this flag, if you have your own +alias.h and contex.h files +and you want include reference to them in project file. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.hhc.binary.xml b/src/documentation/docbook-xsl/params/htmlhelp.hhc.binary.xml new file mode 100644 index 0000000000..b8cc986df8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.hhc.binary.xml @@ -0,0 +1,24 @@ + + +htmlhelp.hhc.binary + + + +htmlhelp.hhc.binary +Generate binary ToC? + + + + + + + + +Description + +This parametr controls whether binary TOC will be generated. You +must create binary TOC if you want to add Prev/Next buttons to toolbar +(which is default behaviour). Files with binary TOC can't be merged. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.hhc.folders.instead.books.xml b/src/documentation/docbook-xsl/params/htmlhelp.hhc.folders.instead.books.xml new file mode 100644 index 0000000000..f3a914e4eb --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.hhc.folders.instead.books.xml @@ -0,0 +1,25 @@ + + +htmlhelp.hhc.folders.instead.books + + + +htmlhelp.hhc.folders.instead.books +Use folder icons in ToC (instead of book icons)? + + + + + + + + +Description + +This parameter controls whether there should be folder-like +icons (1) or book-like icons (0) in ToC. If you want to use +folder-like icons you must swith off binary ToC using +htmlhelp.hhc.binary. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.hhc.section.depth.xml b/src/documentation/docbook-xsl/params/htmlhelp.hhc.section.depth.xml new file mode 100644 index 0000000000..b00f4d8020 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.hhc.section.depth.xml @@ -0,0 +1,23 @@ + + +htmlhelp.hhc.section.depth +integer + + +htmlhelp.hhc.section.depth +Depth of TOC for sections in a left pane. + + + + + + + + +Description + +Change this parameter if you want shallower ToC in a left pane +of HTML Help viewer. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.hhc.show.root.xml b/src/documentation/docbook-xsl/params/htmlhelp.hhc.show.root.xml new file mode 100644 index 0000000000..3d4a5b424b --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.hhc.show.root.xml @@ -0,0 +1,24 @@ + + +htmlhelp.hhc.show.root +boolean + + +htmlhelp.hhc.show.root +Should be entry for root element shown in ToC? + + + + + + + + +Description + +If set to 0, there will be no entry for root element in +ToC. This is useful when you want provide user with expanded ToC as +a default. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.hhc.width.xml b/src/documentation/docbook-xsl/params/htmlhelp.hhc.width.xml new file mode 100644 index 0000000000..63236b7008 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.hhc.width.xml @@ -0,0 +1,23 @@ + + +htmlhelp.hhc.width +integer + + +htmlhelp.hhc.width +Width of navigation (ToC) pane + + + + + + + + +Description + +This parameter specifies width of ToC pane in pixels. + + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.hhc.xml b/src/documentation/docbook-xsl/params/htmlhelp.hhc.xml new file mode 100644 index 0000000000..dadb0a613d --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.hhc.xml @@ -0,0 +1,23 @@ + + +htmlhelp.hhc +string + + +htmlhelp.hhc +Filename of TOC file. + + + + + + + + +Description + +Change this parameter if you want different name of TOC file +than toc.hhc. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.hhk.xml b/src/documentation/docbook-xsl/params/htmlhelp.hhk.xml new file mode 100644 index 0000000000..49506a8ca1 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.hhk.xml @@ -0,0 +1,23 @@ + + +htmlhelp.hhk +string + + +htmlhelp.hhk +Filename of index file. + + + + + + + + +Description + +Change this parameter if you want different name of index file +than index.hhk. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.hhp.tail.xml b/src/documentation/docbook-xsl/params/htmlhelp.hhp.tail.xml new file mode 100644 index 0000000000..0792bbb65b --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.hhp.tail.xml @@ -0,0 +1,23 @@ + + +htmlhelp.hhp.tail +string + + +htmlhelp.hhp.tail +Additional content for project file. + + + + + + + + +Description + +If you want to include some additional parameters into project file, +store appropriate part of project file into this parameter. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.hhp.window.xml b/src/documentation/docbook-xsl/params/htmlhelp.hhp.window.xml new file mode 100644 index 0000000000..7ba52966d9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.hhp.window.xml @@ -0,0 +1,23 @@ + + +htmlhelp.hhp.window +string + + +htmlhelp.hhp.window +Name of default window. + + + + + + + + +Description + +Name of default window. If empty no [WINDOWS] section will be +added to project file. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.hhp.windows.xml b/src/documentation/docbook-xsl/params/htmlhelp.hhp.windows.xml new file mode 100644 index 0000000000..81d0b73046 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.hhp.windows.xml @@ -0,0 +1,25 @@ + + +htmlhelp.hhp.windows +string + + +htmlhelp.hhp.windows +Definition of additional windows + + + + + + + + +Description + +Content of this parameter is placed at the end of [WINDOWS] +section of project file. You can use it for defining your own +addtional windows. + + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.hhp.xml b/src/documentation/docbook-xsl/params/htmlhelp.hhp.xml new file mode 100644 index 0000000000..4058f0a9c2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.hhp.xml @@ -0,0 +1,23 @@ + + +htmlhelp.hhp +string + + +htmlhelp.hhp +Filename of project file. + + + + + + + + +Description + +Change this parameter if you want different name of project +file than htmlhelp.hhp. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.map.file.xml b/src/documentation/docbook-xsl/params/htmlhelp.map.file.xml new file mode 100644 index 0000000000..49ee9cb0cd --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.map.file.xml @@ -0,0 +1,23 @@ + + +htmlhelp.map.file +string + + +htmlhelp.map.file +Filename of map file. + + + + + + + + +Description + +Change this parameter if you want different name of map file +than context.h. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.only.xml b/src/documentation/docbook-xsl/params/htmlhelp.only.xml new file mode 100644 index 0000000000..17755dfd94 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.only.xml @@ -0,0 +1,25 @@ + + +htmlhelp.only +boolean + + +htmlhelp.only +Should be only project files generated? + + + + + + + + +Description + +If you want to play with various HTML Help parameters and you +don't need to regenerate all HTML files, you can set this parameter to +1. This setting will not process whole document, only project files +(hhp, hhc, hhk,...) will be generated. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.remember.window.position.xml b/src/documentation/docbook-xsl/params/htmlhelp.remember.window.position.xml new file mode 100644 index 0000000000..4cf97fe404 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.remember.window.position.xml @@ -0,0 +1,24 @@ + + +htmlhelp.remember.window.position +boolean + + +htmlhelp.remember.window.position +Remember help window position? + + + + + + + + +Description + +To remember help window position between starts set this +parameter to 1. + + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.show.advanced.search.xml b/src/documentation/docbook-xsl/params/htmlhelp.show.advanced.search.xml new file mode 100644 index 0000000000..85e4c4da3b --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.show.advanced.search.xml @@ -0,0 +1,23 @@ + + +htmlhelp.show.advanced.search +boolean + + +htmlhelp.show.advanced.search +Should be advanced search available? + + + + + + + + +Description + +If you want advanced search features in your help, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.show.favorities.xml b/src/documentation/docbook-xsl/params/htmlhelp.show.favorities.xml new file mode 100644 index 0000000000..c1811d11d0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.show.favorities.xml @@ -0,0 +1,23 @@ + + +htmlhelp.show.favorities +boolean + + +htmlhelp.show.favorities +Should be favorities tab shown? + + + + + + + + +Description + +If you want favorities tab shown in your help, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.show.menu.xml b/src/documentation/docbook-xsl/params/htmlhelp.show.menu.xml new file mode 100644 index 0000000000..0fad24e423 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.show.menu.xml @@ -0,0 +1,23 @@ + + +htmlhelp.show.menu +boolean + + +htmlhelp.show.menu +Should be menu shown? + + + + + + + + +Description + +If you want application menu in your HTML Help file, turn this +parameter to 1. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.show.toolbar.text.xml b/src/documentation/docbook-xsl/params/htmlhelp.show.toolbar.text.xml new file mode 100644 index 0000000000..44f8d24074 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.show.toolbar.text.xml @@ -0,0 +1,24 @@ + + +htmlhelp.show.toolbar.text +boolean + + +htmlhelp.show.toolbar.text +Show text under toolbar buttons? + + + + + + + + +Description + +You can switch off display of texts under toolbar buttons by +setting this parameter to 0. + + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.title.xml b/src/documentation/docbook-xsl/params/htmlhelp.title.xml new file mode 100644 index 0000000000..c5b1cb3986 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.title.xml @@ -0,0 +1,23 @@ + + +htmlhelp.title +string + + +htmlhelp.title +Title of HTML Help + + + + + + + + +Description + +Content of this parameter will be used as a title for generated +HTML Help. If empty, title will be automatically taken from document. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.use.hhk.xml b/src/documentation/docbook-xsl/params/htmlhelp.use.hhk.xml new file mode 100644 index 0000000000..6c9da07749 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.use.hhk.xml @@ -0,0 +1,23 @@ + + +htmlhelp.use.hhk +boolean + + +htmlhelp.use.hhk +Should be index built using HHK file? + + + + + + + + +Description + +If non-zero, index is created using HHK file. This provides some +new features. + + + diff --git a/src/documentation/docbook-xsl/params/htmlhelp.window.geometry.xml b/src/documentation/docbook-xsl/params/htmlhelp.window.geometry.xml new file mode 100644 index 0000000000..e0742b10d0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/htmlhelp.window.geometry.xml @@ -0,0 +1,26 @@ + + +htmlhelp.window.geometry +string + + +htmlhelp.window.geometry +Set initial geometry of help window + + + + + + + + +Description + +This parameter specifies initial position of help +window. E.g. + +[160,64,992,704]]]> + + + + diff --git a/src/documentation/docbook-xsl/params/hyphenate.verbatim.characters.xml b/src/documentation/docbook-xsl/params/hyphenate.verbatim.characters.xml new file mode 100644 index 0000000000..dadf3b05b7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/hyphenate.verbatim.characters.xml @@ -0,0 +1,23 @@ + + +hyphenate.verbatim.characters +string + + +hyphenate.verbatim.characters +List of characters after which line break can occur in listings + + + + + + +Description + +If you enable hyphenate.verbatim line +breaks are allowed only on space characters. If this is not enough for +your document, you can specify list of additional characters after +which line break is allowed in this parameter. + + + diff --git a/src/documentation/docbook-xsl/params/hyphenate.verbatim.xml b/src/documentation/docbook-xsl/params/hyphenate.verbatim.xml new file mode 100644 index 0000000000..35b295ebc7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/hyphenate.verbatim.xml @@ -0,0 +1,42 @@ + + +hyphenate.verbatim +boolean + + +hyphenate.verbatim +Should verbatim environments be hyphenated on space characters? + + + + + + +Description + +If the lines of program listing are too long to fit into one +line it is quite common to split them at space and indicite by hook +arrow that code continues on the next line. You can turn on this +behaviour for programlisting, +screen and synopsis elements by +using this parameter. + +Note that you must also enable line wrapping for verbatim environments and +select appropriate hyphenation character (e.g. hook arrow). This can +be done using monospace.verbatim.properties +attribute set: + + + wrap + ► +]]> + +For a list of arrows available in Unicode see and and make sure that +selected character is available in the font you are using for verbatim +environments. + + + diff --git a/src/documentation/docbook-xsl/params/hyphenate.xml b/src/documentation/docbook-xsl/params/hyphenate.xml new file mode 100644 index 0000000000..429bf7fc8b --- /dev/null +++ b/src/documentation/docbook-xsl/params/hyphenate.xml @@ -0,0 +1,21 @@ + + +hyphenate + + + +hyphenate +Specify hyphenation behavior + + + +true + + +Description + +If true, words may be hyphenated. Otherwise, they may not. + + + + diff --git a/src/documentation/docbook-xsl/params/id.warnings.xml b/src/documentation/docbook-xsl/params/id.warnings.xml new file mode 100644 index 0000000000..37be8e6eb5 --- /dev/null +++ b/src/documentation/docbook-xsl/params/id.warnings.xml @@ -0,0 +1,24 @@ + + +id.warnings +boolean + + +id.warnings +Should warnings be generated for titled elements without IDs? + + + + + + + + +Description + +If non-zero, the stylesheet will issue a warning for +any element (other than the root element) which +has a title but does not have an ID. + + + diff --git a/src/documentation/docbook-xsl/params/ignore.image.scaling.xml b/src/documentation/docbook-xsl/params/ignore.image.scaling.xml new file mode 100644 index 0000000000..40aaa77336 --- /dev/null +++ b/src/documentation/docbook-xsl/params/ignore.image.scaling.xml @@ -0,0 +1,23 @@ + + +ignore.image.scaling +boolean + + +ignore.image.scaling +Tell the stylesheets to ignore the author's image scaling attributes + + + + + + + + +Description + +If non-zero, the scaling attributes on graphics and media objects are +ignored. + + + diff --git a/src/documentation/docbook-xsl/params/img.src.path.xml b/src/documentation/docbook-xsl/params/img.src.path.xml new file mode 100644 index 0000000000..1364aefef2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/img.src.path.xml @@ -0,0 +1,31 @@ + + +img.src.path +string + + +img.src.path +Path to HTML image files + + + + + + +Description + +Add a path prefix to each HTML +img or FO +fo:external-graphics element's +src attribute. +This path could relative to the directory where the HTML/FO +files are created, or it could be an absolute URI. +The default value is empty. +Be sure to include a trailing slash if needed. + +This prefix is not applied to any filerefs that start +with "/" or contain "//:". + + + + diff --git a/src/documentation/docbook-xsl/params/index.div.title.properties.xml b/src/documentation/docbook-xsl/params/index.div.title.properties.xml new file mode 100644 index 0000000000..cf82ad59d5 --- /dev/null +++ b/src/documentation/docbook-xsl/params/index.div.title.properties.xml @@ -0,0 +1,34 @@ + + +index.div.title.properties +Properties associated with the letter headings in an +index + + + + + + 0pt + 14.4pt + + bold + always + + + + 0pt + + + + +Description + +This attribute set is used on the letter headings that separate +the divisions in an index. + + + diff --git a/src/documentation/docbook-xsl/params/index.entry.properties.xml b/src/documentation/docbook-xsl/params/index.entry.properties.xml new file mode 100644 index 0000000000..b5f27d85ff --- /dev/null +++ b/src/documentation/docbook-xsl/params/index.entry.properties.xml @@ -0,0 +1,24 @@ + + +index.entry.properties +Properties applied to the formatted entries +in an index + + + + + + 0pt + + + + +Description + +This attribute set is applied to the block containing +the entries in a letter division in an index. It can be used to set the +font-size, font-family, and other inheritable properties that will be +applied to all index entries. + + + diff --git a/src/documentation/docbook-xsl/params/index.method.xml b/src/documentation/docbook-xsl/params/index.method.xml new file mode 100644 index 0000000000..687fde4f4b --- /dev/null +++ b/src/documentation/docbook-xsl/params/index.method.xml @@ -0,0 +1,133 @@ + + +index.method +string + + +index.method +Select method used to group index entries in an index + + + + + + + + +Description + +This parameter lets you select which method should be +used to sort and group index entries in an index. +Indexes in languages that have accented characters typically +sort together accented words and unaccented words. +So Á (A acute) would sort together +with A, so both would appear in the A +section of the index. + + +The default indexing method does not sort accented characters this way. +Words that start with an accented character will instead appear in the +Symbols section of the index. +As such, the default method is only suitable for +English and other unaccented languages. +The other indexing methods require extensions of one type or +another, which is why there are not used by default. + +The three choices for indexing method are: + + +english + + +(default) Sort and groups words based only on the Latin alphabet. +Accented words and words in non-Latin alphabets will be +put in the Symbols section of the index. + + + + +kosek + + +Sort and groups words based on letter groups configured in +the DocBook locale file for the given language. +For example, the French locale file is common/fr.xml. +This method requires support for EXSLT extensions in +the XSL processor. It also requires support for using +user-defined functions in xsl:key (xsltproc does not). + +This method is suitable for any language for which you can +list all the individual characters that should appear +in each letter group in an index. +It is probably not practical to use it for ideographic languages +such as Chinese that have hundreds or thousands of characters. + +To use this method, your customization must set this +parameter and import an additional stylesheet module: + +kosek +]]> + +The stylesheet module defines functions and adds an xsl:key +used by the method. + + + + +kimber + + +This method uses extensions to the Saxon processor to implement +sophisticated indexing processes. It uses its own +configuration file, which can include information for any number of +languages. Each language's configuration can group +words using either an +enumerated method similar to the kosek method, or it can +designate the first character in each group when viewed in sort order. +The latter configuration is useful for ideographic languages +such as Chinese, Japanese, and Korean. +You can also define your own collation algorithms and where you +want Latin-alphabet words sorted. + + +For a whitepaper describing the extensions, see: +. + + + +To download the extension library, see +. + + + + +To use this method, you must: + + + +Use Saxon as your XSLT processor. + + + +Install and configure the Innodata Isogen library, using +the documentation that comes with it. + + + +Set this parameter's value to kimber. + + + +Import the index extensions stylesheet module +common/autoidx-ng.xsl into your +customization. + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/params/index.number.separator.xml b/src/documentation/docbook-xsl/params/index.number.separator.xml new file mode 100644 index 0000000000..7780b6cb14 --- /dev/null +++ b/src/documentation/docbook-xsl/params/index.number.separator.xml @@ -0,0 +1,49 @@ + + +index.number.separator +string + + +index.number.separator +Override for punctuation separating page numbers in index + + + + + + + + +Description + +This parameter permits you to override the text to insert between +page references in a formatted index entry. Typically +that would be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'number-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. This punctuation appears between +such section titles in an HTML index. + + + + diff --git a/src/documentation/docbook-xsl/params/index.on.role.xml b/src/documentation/docbook-xsl/params/index.on.role.xml new file mode 100644 index 0000000000..804c7de6a5 --- /dev/null +++ b/src/documentation/docbook-xsl/params/index.on.role.xml @@ -0,0 +1,43 @@ + + +index.on.role +boolean + + +index.on.role +Select indexterms based on role value + + + + + + + + +Description + + +If non-zero, +then an index element that has a +role attribute +value will contain only those indexterm +elements with a matching role value. +If an index has no role +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + +If index.on.role is zero, then the +role attribute has no effect +on selecting indexterms for an index. + + +If you are using DocBook version 4.3 or later, you should +use the type attribute instead of role +on indexterm and index, +and set the index.on.type to a nonzero +value. + + + + diff --git a/src/documentation/docbook-xsl/params/index.on.type.xml b/src/documentation/docbook-xsl/params/index.on.type.xml new file mode 100644 index 0000000000..3c5df73fc0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/index.on.type.xml @@ -0,0 +1,47 @@ + + +index.on.type +boolean + + +index.on.type +Select indexterms based on type +attribute value + + + + + + + + +Description + + +If non-zero, +then an index element that has a +type attribute +value will contain only those indexterm +elements with a matching type attribute value. +If an index has no type +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + + +If index.on.type is zero, then the +type attribute has no effect +on selecting indexterms for an index. + + +For those using DocBook version 4.2 or earlier, +the type attribute is not available +for index terms. However, you can achieve the same +effect by using the role attribute +in the same manner on indexterm +and index, and setting the stylesheet parameter +index.on.role to a nonzero value. + + + + diff --git a/src/documentation/docbook-xsl/params/index.prefer.titleabbrev.xml b/src/documentation/docbook-xsl/params/index.prefer.titleabbrev.xml new file mode 100644 index 0000000000..a3d7359749 --- /dev/null +++ b/src/documentation/docbook-xsl/params/index.prefer.titleabbrev.xml @@ -0,0 +1,23 @@ + + +index.prefer.titleabbrev +boolean + + +index.prefer.titleabbrev +Should be abbreviated titles used as back references + + + + + + + + +Description + +FIXME: + + + + diff --git a/src/documentation/docbook-xsl/params/index.preferred.page.properties.xml b/src/documentation/docbook-xsl/params/index.preferred.page.properties.xml new file mode 100644 index 0000000000..994e4aab78 --- /dev/null +++ b/src/documentation/docbook-xsl/params/index.preferred.page.properties.xml @@ -0,0 +1,26 @@ + + +index.preferred.page.properties +Properties used to emphasize page number references for +significant index terms + + + + + + bold + + + + +Description + +Properties used to emphasize page number references for +significant index terms (significance=preffered). Currently works only with +XEP. + + + + diff --git a/src/documentation/docbook-xsl/params/index.range.separator.xml b/src/documentation/docbook-xsl/params/index.range.separator.xml new file mode 100644 index 0000000000..6d5bce526b --- /dev/null +++ b/src/documentation/docbook-xsl/params/index.range.separator.xml @@ -0,0 +1,52 @@ + + +index.range.separator +string + + +index.range.separator +Override for punctuation separating the two numbers +in a page range in index + + + + + + + + +Description + +This parameter permits you +to override the text to insert between +the two numbers of a page range in an index. +This parameter is only used by those XSL-FO processors +that support an extension for generating such page ranges +(such as XEP). + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'range-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. So there are no page ranges +and this parameter has no effect. + + + + diff --git a/src/documentation/docbook-xsl/params/index.term.separator.xml b/src/documentation/docbook-xsl/params/index.term.separator.xml new file mode 100644 index 0000000000..ed501241cc --- /dev/null +++ b/src/documentation/docbook-xsl/params/index.term.separator.xml @@ -0,0 +1,49 @@ + + +index.term.separator +string + + +index.term.separator +Override for punctuation separating an index term +from its list of page references in an index + + + + + + + + +Description + +This parameter permits you to override +the text to insert between +the end of an index term and its list of page references. +Typically that might be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'term-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +fill in the content for this normally empty +override parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. +For fo output, it could be an fo:leader +element to provide space of a specific length, or a dot leader. + + + + diff --git a/src/documentation/docbook-xsl/params/informal.object.properties.xml b/src/documentation/docbook-xsl/params/informal.object.properties.xml new file mode 100644 index 0000000000..6092cc0836 --- /dev/null +++ b/src/documentation/docbook-xsl/params/informal.object.properties.xml @@ -0,0 +1,20 @@ + + +informal.object.properties +Properties associated with a formal object such as a figure, or other component that has a title + + + + + 0.5em + 1em + 2em + 0.5em + 1em + 2em + + +Description +The styling for informal objects in docbook. Specify the spacing before and after the object. + + diff --git a/src/documentation/docbook-xsl/params/informalequation.properties.xml b/src/documentation/docbook-xsl/params/informalequation.properties.xml new file mode 100644 index 0000000000..8843b9b3f5 --- /dev/null +++ b/src/documentation/docbook-xsl/params/informalequation.properties.xml @@ -0,0 +1,18 @@ + + +informalequation.properties +Properties associated with a informalequation + + + + + + + + +Description + +The styling for informalequations. + + + diff --git a/src/documentation/docbook-xsl/params/informalexample.properties.xml b/src/documentation/docbook-xsl/params/informalexample.properties.xml new file mode 100644 index 0000000000..e541ce35aa --- /dev/null +++ b/src/documentation/docbook-xsl/params/informalexample.properties.xml @@ -0,0 +1,18 @@ + + +informalexample.properties +Properties associated with an informalexample + + + + + + + + +Description + +The styling for informalexamples. + + + diff --git a/src/documentation/docbook-xsl/params/informalfigure.properties.xml b/src/documentation/docbook-xsl/params/informalfigure.properties.xml new file mode 100644 index 0000000000..28a1a0e7f3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/informalfigure.properties.xml @@ -0,0 +1,18 @@ + + +informalfigure.properties +Properties associated with an informalfigure + + + + + + + + +Description + +The styling for informalfigures. + + + diff --git a/src/documentation/docbook-xsl/params/informaltable.properties.xml b/src/documentation/docbook-xsl/params/informaltable.properties.xml new file mode 100644 index 0000000000..ab9a195402 --- /dev/null +++ b/src/documentation/docbook-xsl/params/informaltable.properties.xml @@ -0,0 +1,24 @@ + + +informaltable.properties +Properties associated with the block surrounding an informaltable + + + + + + + + +Description + +Block styling properties for informaltables. This parameter should really +have been called informaltable.block.properties or something +like that, but we’re leaving it to avoid backwards-compatibility +problems. + +See also table.table.properties. + + + diff --git a/src/documentation/docbook-xsl/params/inherit.keywords.xml b/src/documentation/docbook-xsl/params/inherit.keywords.xml new file mode 100644 index 0000000000..fd4152947c --- /dev/null +++ b/src/documentation/docbook-xsl/params/inherit.keywords.xml @@ -0,0 +1,25 @@ + + +inherit.keywords +boolean + + +inherit.keywords +Inherit keywords from ancestor elements? + + + + + + +Description + +If inherit.keywords +is non-zero, the keyword META for each HTML +HEAD element will include all of the keywords from +ancestral elements. Otherwise, only the keywords from the current section +will be used. + + + + diff --git a/src/documentation/docbook-xsl/params/insert.link.page.number.xml b/src/documentation/docbook-xsl/params/insert.link.page.number.xml new file mode 100644 index 0000000000..a5d1e8a615 --- /dev/null +++ b/src/documentation/docbook-xsl/params/insert.link.page.number.xml @@ -0,0 +1,61 @@ + + +insert.link.page.number +string + + +insert.link.page.number +Turns page numbers in link elements on and off + + + + +no + + + +Description + +The value of this parameter determines if +cross references using the link element in +printed output will +include standard page number citations. +It has three possible values. + + + +no +No page number references will be generated. + + + +yes +Page number references will be generated +for all link elements. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for a link element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + + +Although the xrefstyle attribute +can be used to turn the page reference on or off, it cannot be +used to control the formatting of the page number as it +can in xref. +In link it will always format with +the style established by the +gentext template with name="page.citation" +in the l:context name="xref". + + + diff --git a/src/documentation/docbook-xsl/params/insert.olink.page.number.xml b/src/documentation/docbook-xsl/params/insert.olink.page.number.xml new file mode 100644 index 0000000000..13f8b46365 --- /dev/null +++ b/src/documentation/docbook-xsl/params/insert.olink.page.number.xml @@ -0,0 +1,75 @@ + + +insert.olink.page.number +string + + +insert.olink.page.number +Turns page numbers in olinks on and off + + + + +no + + + +Description + +The value of this parameter determines if +cross references made between documents with +olink will +include page number citations. +In most cases this is only applicable to references in printed output. + +The parameter has three possible values. + + + +no +No page number references will be generated for olinks. + + + +yes +Page number references will be generated +for all olink references. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an olink element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + +Olinks that point to targets within the same document +are treated as xrefs, and controlled by +the insert.xref.page.number parameter. + + +Page number references for olinks to +external documents can only be inserted if the +information exists in the olink database. +This means each olink target element +(div or obj) +must have a page attribute +whose value is its page number in the target document. +The XSL stylesheets are not able to extract that information +during processing because pages have not yet been created in +XSLT transformation. Only the XSL-FO processor knows what +page each element is placed on. +Therefore some postprocessing must take place to populate +page numbers in the olink database. + + + + + + diff --git a/src/documentation/docbook-xsl/params/insert.olink.pdf.frag.xml b/src/documentation/docbook-xsl/params/insert.olink.pdf.frag.xml new file mode 100644 index 0000000000..8939f2798e --- /dev/null +++ b/src/documentation/docbook-xsl/params/insert.olink.pdf.frag.xml @@ -0,0 +1,63 @@ + + +insert.olink.pdf.frag +boolean + + +insert.olink.pdf.frag +Add fragment identifiers for links into PDF files + + + + + + + + +Description + +The value of this parameter determines whether +the cross reference URIs to PDF documents made with +olink will +include fragment identifiers. + + +When forming a URI to link to a PDF document, +a fragment identifier (typically a '#' followed by an +id value) appended to the PDF filename can be used by +the PDF viewer to open +the PDF file to a location within the document instead of +the first page. +However, not all PDF files have id +values embedded in them, and not all PDF viewers can +handle fragment identifiers. + + +If insert.olink.pdf.frag is set +to a non-zero value, then any olink targeting a +PDF file will have the fragment identifier appended to the URI. +The URI is formed by concatenating the value of the +olink.base.uri parameter, the +value of the baseuri +attribute from the document +element in the olink database with the matching +targetdoc value, +and the value of the href +attribute for the targeted element in the olink database. +The href attribute +contains the fragment identifier. + + +If insert.olink.pdf.frag is set +to zero (the default value), then +the href attribute +from the olink database +is not appended to PDF olinks, so the fragment identifier is left off. +A PDF olink is any olink for which the +baseuri attribute +from the matching document +element in the olink database ends with '.pdf'. +Any other olinks will still have the fragment identifier added. + + + diff --git a/src/documentation/docbook-xsl/params/insert.xref.page.number.xml b/src/documentation/docbook-xsl/params/insert.xref.page.number.xml new file mode 100644 index 0000000000..c1b8147784 --- /dev/null +++ b/src/documentation/docbook-xsl/params/insert.xref.page.number.xml @@ -0,0 +1,52 @@ + + +insert.xref.page.number +string + + +insert.xref.page.number +Turns page numbers in xrefs on and off + + + + +no + + + +Description + +The value of this parameter determines if +cross references (xrefs) in +printed output will +include page number citations. +It has three possible values. + + + +no +No page number references will be generated. + + + +yes +Page number references will be generated +for all xref elements. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an xref element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + + + + diff --git a/src/documentation/docbook-xsl/params/itemizedlist.label.properties.xml b/src/documentation/docbook-xsl/params/itemizedlist.label.properties.xml new file mode 100644 index 0000000000..2fc6cd6804 --- /dev/null +++ b/src/documentation/docbook-xsl/params/itemizedlist.label.properties.xml @@ -0,0 +1,17 @@ + + +itemizedlist.label.properties +Properties that apply to each label inside itemized list. + + + + + + +Description +Properties that apply to each label inside itemized list. E.g.: + + right +]]> + + diff --git a/src/documentation/docbook-xsl/params/itemizedlist.label.width.xml b/src/documentation/docbook-xsl/params/itemizedlist.label.width.xml new file mode 100644 index 0000000000..d83c0c963a --- /dev/null +++ b/src/documentation/docbook-xsl/params/itemizedlist.label.width.xml @@ -0,0 +1,19 @@ + + +itemizedlist.label.width +The default width of the label (bullet) in an itemized list. + + + + + + + + +Description +Specifies the default width of the label (usually a bullet or other +symbol) in an itemized list. You can override the default value on any +particular list with the “dbfo” processing instruction using the +“label-width” pseudoattribute. + + diff --git a/src/documentation/docbook-xsl/params/itemizedlist.properties.xml b/src/documentation/docbook-xsl/params/itemizedlist.properties.xml new file mode 100644 index 0000000000..31c6b5bc9f --- /dev/null +++ b/src/documentation/docbook-xsl/params/itemizedlist.properties.xml @@ -0,0 +1,14 @@ + + +itemizedlist.properties +Properties that apply to each list-block generated by itemizedlist. + + + + + + +Description +Properties that apply to each fo:list-block generated by itemizedlist. + + diff --git a/src/documentation/docbook-xsl/params/keep.relative.image.uris.xml b/src/documentation/docbook-xsl/params/keep.relative.image.uris.xml new file mode 100644 index 0000000000..cee478d005 --- /dev/null +++ b/src/documentation/docbook-xsl/params/keep.relative.image.uris.xml @@ -0,0 +1,28 @@ + + +keep.relative.image.uris +boolean + + +keep.relative.image.uris +Should image URIs be resolved against xml:base? + + + + + + + + + +Description + +If non-zeor, relative URIs (in, for example fileref attributes) will +be used in the generated output. Otherwise, the URIs will be made absolute +with respect to the base URI. + +Note that the stylesheets calculate (and use) the absolute form +for some purposes, this only applies to the resulting output. + + + diff --git a/src/documentation/docbook-xsl/params/l10n.gentext.default.language.xml b/src/documentation/docbook-xsl/params/l10n.gentext.default.language.xml new file mode 100644 index 0000000000..9420c0b778 --- /dev/null +++ b/src/documentation/docbook-xsl/params/l10n.gentext.default.language.xml @@ -0,0 +1,24 @@ + + +l10n.gentext.default.language +string + + +l10n.gentext.default.language +Sets the default language for generated text + + + + + + + + +Description + +The value of the l10n.gentext.default.language +parameter is used as the language for generated text if no setting is provided +in the source document. + + + diff --git a/src/documentation/docbook-xsl/params/l10n.gentext.language.xml b/src/documentation/docbook-xsl/params/l10n.gentext.language.xml new file mode 100644 index 0000000000..cb5d90ea8a --- /dev/null +++ b/src/documentation/docbook-xsl/params/l10n.gentext.language.xml @@ -0,0 +1,28 @@ + + +l10n.gentext.language +string + + +l10n.gentext.language +Sets the gentext language + + + + + + + + +Description + +If this parameter is set to any value other than the empty string, its +value will be used as the value for the language when generating text. Setting +l10n.gentext.language overrides any settings within the +document being formatted. + +It's much more likely that you might want to set the +l10n.gentext.default.language parameter. + + + diff --git a/src/documentation/docbook-xsl/params/l10n.gentext.use.xref.language.xml b/src/documentation/docbook-xsl/params/l10n.gentext.use.xref.language.xml new file mode 100644 index 0000000000..5554de0828 --- /dev/null +++ b/src/documentation/docbook-xsl/params/l10n.gentext.use.xref.language.xml @@ -0,0 +1,48 @@ + + +l10n.gentext.use.xref.language +boolean + + +l10n.gentext.use.xref.language +Use the language of target when generating cross-reference text? + + + + + + + + +Description + +If non-zero, the language of the target will be used when +generating cross reference text. Usually, the current +language is used when generating text (that is, the language of the +element that contains the cross-reference element). But setting this parameter +allows the language of the element pointed to to control +the generated text. + +Consider the following example: + + +See also .]]> + + + +Suppose that Chapter 3 happens to be written in German. +If l10n.gentext.use.xref.language is non-zero, the +resulting text will be something like this: + +
                  +See also Kapital 3. +
                  + +Where the more traditional rendering would be: + +
                  +See also Chapter 3. +
                  + +                   +                   diff --git a/src/documentation/docbook-xsl/params/l10n.lang.value.rfc.compliant.xml b/src/documentation/docbook-xsl/params/l10n.lang.value.rfc.compliant.xml new file mode 100644 index 0000000000..8168d48936 --- /dev/null +++ b/src/documentation/docbook-xsl/params/l10n.lang.value.rfc.compliant.xml @@ -0,0 +1,60 @@ + + +l10n.lang.value.rfc.compliant +boolean + + +l10n.lang.value.rfc.compliant +Make value of lang attribute RFC compliant? + + + + + + + + +Description + +If non-zero, ensure that the values for all lang attributes in HTML output are RFC +compliantSection 8.1.1, Language Codes, in the HTML 4.0 Recommendation states that: + +
                  [RFC1766] defines and explains the language codes +that must be used in HTML documents. +Briefly, language codes consist of a primary code and a possibly +empty series of subcodes: + +language-code = primary-code ( "-" subcode )* + +And in RFC 1766, Tags for the Identification +of Languages, the EBNF for "language tag" is given as: + +Language-Tag = Primary-tag *( "-" Subtag ) +Primary-tag = 1*8ALPHA +Subtag = 1*8ALPHA + +
                  +                  . + +by taking any underscore characters in any lang values found in source documents, and +replacing them with hyphen characters in output HTML files. For +example, zh_CN in a source document becomes +zh-CN in the HTML output form that source. + + +This parameter does not cause any case change in lang values, because RFC 1766 +explicitly states that all "language tags" (as it calls them) "are +to be treated as case insensitive". + +                   + +                   +                   diff --git a/src/documentation/docbook-xsl/params/label.from.part.xml b/src/documentation/docbook-xsl/params/label.from.part.xml new file mode 100644 index 0000000000..b4866ca41d --- /dev/null +++ b/src/documentation/docbook-xsl/params/label.from.part.xml @@ -0,0 +1,25 @@ + + +label.from.part +boolean + + +label.from.part +Renumber chapters in each part? + + + + + + +Description + +If label.from.part is non-zero, components +(chapters, appendixes, etc.) +will be numbered from 1 in each part. Otherwise, +they will be numbered monotonically throughout each +book. + + + + diff --git a/src/documentation/docbook-xsl/params/line-height.xml b/src/documentation/docbook-xsl/params/line-height.xml new file mode 100644 index 0000000000..7bb6e639a8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/line-height.xml @@ -0,0 +1,22 @@ + + +line-height +string + + +line-height +Specify the line-height property + + + + + + + + +Description + +Sets the line-height property. + + + diff --git a/src/documentation/docbook-xsl/params/linenumbering.everyNth.xml b/src/documentation/docbook-xsl/params/linenumbering.everyNth.xml new file mode 100644 index 0000000000..b288480072 --- /dev/null +++ b/src/documentation/docbook-xsl/params/linenumbering.everyNth.xml @@ -0,0 +1,21 @@ + + +linenumbering.everyNth +integer + + +linenumbering.everyNth +Indicate which lines should be numbered + + + + + + +Description + +If line numbering is enabled, everyNth line will be numbered. + + + + diff --git a/src/documentation/docbook-xsl/params/linenumbering.extension.xml b/src/documentation/docbook-xsl/params/linenumbering.extension.xml new file mode 100644 index 0000000000..b9322dd1ec --- /dev/null +++ b/src/documentation/docbook-xsl/params/linenumbering.extension.xml @@ -0,0 +1,24 @@ + + +linenumbering.extension +boolean + + +linenumbering.extension +Enable the line numbering extension + + + + + + +Description + +If true, verbatim environments (elements that have the +format='linespecific' notation attribute: address, literallayout, +programlisting, screen, synopsis) that specify line numbering will +have, surprise, line numbers. + + + + diff --git a/src/documentation/docbook-xsl/params/linenumbering.separator.xml b/src/documentation/docbook-xsl/params/linenumbering.separator.xml new file mode 100644 index 0000000000..1e81b5b940 --- /dev/null +++ b/src/documentation/docbook-xsl/params/linenumbering.separator.xml @@ -0,0 +1,22 @@ + + +linenumbering.separator +string + + +linenumbering.separator +Specify a separator between line numbers and lines + + + + + + +Description + +The separator is inserted between line numbers and lines in +the verbatim environment. + + + + diff --git a/src/documentation/docbook-xsl/params/linenumbering.width.xml b/src/documentation/docbook-xsl/params/linenumbering.width.xml new file mode 100644 index 0000000000..3571487d6a --- /dev/null +++ b/src/documentation/docbook-xsl/params/linenumbering.width.xml @@ -0,0 +1,22 @@ + + +linenumbering.width +integer + + +linenumbering.width +Indicates the width of line numbers + + + + + + +Description + +If line numbering is enabled, line numbers will appear right +justified in a field "width" characters wide. + + + + diff --git a/src/documentation/docbook-xsl/params/link.mailto.url.xml b/src/documentation/docbook-xsl/params/link.mailto.url.xml new file mode 100644 index 0000000000..c7e7fecd80 --- /dev/null +++ b/src/documentation/docbook-xsl/params/link.mailto.url.xml @@ -0,0 +1,22 @@ + + +link.mailto.url +string + + +link.mailto.url +Mailto URL for the LINK REL=made HTML HEAD element + + + + + + +Description + +If not the empty string, this address will be used for the +REL=made LINK element in the HTML HEAD. + + + + diff --git a/src/documentation/docbook-xsl/params/list.block.properties.xml b/src/documentation/docbook-xsl/params/list.block.properties.xml new file mode 100644 index 0000000000..8fbab86a65 --- /dev/null +++ b/src/documentation/docbook-xsl/params/list.block.properties.xml @@ -0,0 +1,16 @@ + + +list.block.properties +Properties that apply to each list-block generated by list. + + + + + 0.2em + 1.5em + + +Description +Properties that apply to each fo:list-block generated by itemizedlist/orderedlist. + + diff --git a/src/documentation/docbook-xsl/params/list.block.spacing.xml b/src/documentation/docbook-xsl/params/list.block.spacing.xml new file mode 100644 index 0000000000..14a2129139 --- /dev/null +++ b/src/documentation/docbook-xsl/params/list.block.spacing.xml @@ -0,0 +1,20 @@ + + +list.block.spacing +What spacing do you want before and after lists? + + + + + 1em + 0.8em + 1.2em + 1em + 0.8em + 1.2em + + +Description +Specify the spacing required before and after a list. It is necessary to specify the space after a list block because lists can come inside of paras. + + diff --git a/src/documentation/docbook-xsl/params/list.item.spacing.xml b/src/documentation/docbook-xsl/params/list.item.spacing.xml new file mode 100644 index 0000000000..1ae484e9fa --- /dev/null +++ b/src/documentation/docbook-xsl/params/list.item.spacing.xml @@ -0,0 +1,17 @@ + + +list.item.spacing +What space do you want between list items? + + + + + 1em + 0.8em + 1.2em + + +Description +Specify what spacing you want between each list item. + + diff --git a/src/documentation/docbook-xsl/params/make.graphic.viewport.xml b/src/documentation/docbook-xsl/params/make.graphic.viewport.xml new file mode 100644 index 0000000000..1d3a25b50f --- /dev/null +++ b/src/documentation/docbook-xsl/params/make.graphic.viewport.xml @@ -0,0 +1,30 @@ + + +make.graphic.viewport +boolean + + +make.graphic.viewport +Use tables in HTML to make viewports for graphics + + + + + + + + +Description + +The HTML img element only supports the notion +of content-area scaling; it doesn't support the distinction between a +content-area and a viewport-area, so we have to make some compromises. + +If make.graphic.viewport is non-zero, a table +will be used to frame the image. This creates an effective viewport-area. + + +Tables and alignment don't work together, so this parameter is ignored +if alignment is specified on an image. + + diff --git a/src/documentation/docbook-xsl/params/make.index.markup.xml b/src/documentation/docbook-xsl/params/make.index.markup.xml new file mode 100644 index 0000000000..eec982b362 --- /dev/null +++ b/src/documentation/docbook-xsl/params/make.index.markup.xml @@ -0,0 +1,68 @@ + + +make.index.markup +boolean + + +make.index.markup +Generate XML index markup in the index? + + + + + + + + +Description + +This parameter enables a very neat trick for getting properly +merged, collated back-of-the-book indexes. G. Ken Holman suggested +this trick at Extreme Markup Languages 2002 and I'm indebted to him +for it. + +Jeni Tennison's excellent code in +autoidx.xsl does a great job of merging and +sorting indexterms in the document and building a +back-of-the-book index. However, there's one thing that it cannot +reasonably be expected to do: merge page numbers into ranges. (I would +not have thought that it could collate and suppress duplicate page +numbers, but in fact it appears to manage that task somehow.) + +Ken's trick is to produce a document in which the index at the +back of the book is displayed in XML. Because the index +is generated by the FO processor, all of the page numbers have been resolved. +It's a bit hard to explain, but what it boils down to is that instead of having +an index at the back of the book that looks like this: + +
                  +A +ap1, 1, 2, 3 + +
                  + +you get one that looks like this: + +
                  +A + +ap1, +1, +2, +3 +]]> +
                  + +After building a PDF file with this sort of odd-looking index, you can +extract the text from the PDF file and the result is a proper index expressed in +XML. + +Now you have data that's amenable to processing and a simple Perl script +(such as fo/pdf2index) can +merge page ranges and generate a proper index. + +Finally, reformat your original document using this literal index instead of +an automatically generated one and bingo! + +                   +                   diff --git a/src/documentation/docbook-xsl/params/make.single.year.ranges.xml b/src/documentation/docbook-xsl/params/make.single.year.ranges.xml new file mode 100644 index 0000000000..bf2af8e9ee --- /dev/null +++ b/src/documentation/docbook-xsl/params/make.single.year.ranges.xml @@ -0,0 +1,22 @@ + + +make.single.year.ranges +boolean + + +make.single.year.ranges +Print single-year ranges (e.g., 1998-1999) + + + + + + +Description + +If non-zero, year ranges that span a single year will be printed +in range notation (1998-1999) instead of discrete notation +(1998, 1999). + + + diff --git a/src/documentation/docbook-xsl/params/make.valid.html.xml b/src/documentation/docbook-xsl/params/make.valid.html.xml new file mode 100644 index 0000000000..d73a1881a4 --- /dev/null +++ b/src/documentation/docbook-xsl/params/make.valid.html.xml @@ -0,0 +1,30 @@ + + +make.valid.html +boolean + + +make.valid.html +Attempt to make sure the HTML output is valid HTML + + + + + + + + +Description + +If make.valid.html is true, the stylesheets take +extra effort to ensure that the resulting HTML is valid. This may mean that some +para tags are translated into HTML divs or +that other substitutions occur. + +This parameter is different from html.cleanup +because it changes the resulting markup; it does not use extension functions +to manipulate result-tree-fragments and is therefore applicable to any +XSLT processor. + + + diff --git a/src/documentation/docbook-xsl/params/make.year.ranges.xml b/src/documentation/docbook-xsl/params/make.year.ranges.xml new file mode 100644 index 0000000000..17f80876e6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/make.year.ranges.xml @@ -0,0 +1,20 @@ + + +make.year.ranges +boolean + + +make.year.ranges +Collate copyright years into ranges? + + + + + + +Description + +If non-zero, copyright years will be collated into ranges. + + + diff --git a/src/documentation/docbook-xsl/params/man.break.after.slash.xml b/src/documentation/docbook-xsl/params/man.break.after.slash.xml new file mode 100644 index 0000000000..b885d02003 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.break.after.slash.xml @@ -0,0 +1,41 @@ + + +man.break.after.slash +boolean + + +man.break.after.slash +Enable line-breaking after slashes? + + + + +0 + + +Description + +If non-zero, line-breaking after slashes is enabled. This is +mainly useful for causing long URLs or pathnames/filenames to be +broken up or "wrapped" across lines (though it also has the side +effect of sometimes causing relatively short URLs and pathnames to be +broken up across lines too). + +If zero (the default), line-breaking after slashes is +disabled. In that case, strings containing slashes (for example, URLs +or filenames) are not broken across lines, even if they exceed the +maximum column widith. + + + If you set a non-zero value for this parameter, check your + man-page output carefuly afterwards, in order to make sure that the + setting has not introduced an excessive amount of breaking-up of URLs + or pathnames. If your content contains mostly short URLs or + pathnames, setting a non-zero value for + man.break.after.slash will probably result in + in a significant number of relatively short URLs and pathnames being + broken across lines, which is probably not what you want. + + + + diff --git a/src/documentation/docbook-xsl/params/man.charmap.enabled.xml b/src/documentation/docbook-xsl/params/man.charmap.enabled.xml new file mode 100644 index 0000000000..cb426ea481 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.charmap.enabled.xml @@ -0,0 +1,51 @@ + + +man.charmap.enabled +boolean + + +man.charmap.enabled +Apply character map before final output? + + + + + + + + +Description + +If the value of the man.charmap.enabled +parameter is non-zero, a "character map" is used to substitute certain +Unicode symbols and special characters with appropriate roff/groff +equivalents, just before writing each man-page file to the +filesystem. If instead the value of +man.charmap.enabled is zero, Unicode characters +are passed through "as is". + + +Details +For converting certain Unicode symbols and special characters in +UTF-8 or UTF-16 encoded XML source to appropriate groff/roff +equivalents in man-page output, the DocBook XSL Stylesheets +distribution includes a roff character map that is compliant with the XSLT character +map format as detailed in the XSLT 2.0 specification. The map +contains more than 800 character mappings and can be considered the +standard roff character map for the distribution. + +You can use the man.charmap.uri +parameter to specify a URI for the location for an alternate roff +character map to use in place of the standard roff character map +provided in the distribution. + +You can also use a subset of a character map. For details, see +the man.charmap.use.subset and +man.charmap.subset.profile parameters. + + + + diff --git a/src/documentation/docbook-xsl/params/man.charmap.subset.profile.xml b/src/documentation/docbook-xsl/params/man.charmap.subset.profile.xml new file mode 100644 index 0000000000..c05549fd1d --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.charmap.subset.profile.xml @@ -0,0 +1,310 @@ + + +man.charmap.subset.profile +string + + +man.charmap.subset.profile +Profile of character map subset + + + + + +@*[local-name() = 'block'] = 'Miscellaneous Technical' or +(@*[local-name() = 'block'] = 'C1 Controls And Latin-1 Supplement (Latin-1 Supplement)' and + @*[local-name() = 'class'] = 'symbols' +) or +(@*[local-name() = 'block'] = 'General Punctuation' and + (@*[local-name() = 'class'] = 'spaces' or + @*[local-name() = 'class'] = 'dashes' or + @*[local-name() = 'class'] = 'quotes' or + @*[local-name() = 'class'] = 'bullets' + ) +) or +@*[local-name() = 'name'] = 'HORIZONTAL ELLIPSIS' or +@*[local-name() = 'name'] = 'WORD JOINER' or +@*[local-name() = 'name'] = 'SERVICE MARK' or +@*[local-name() = 'name'] = 'TRADE MARK SIGN' or +@*[local-name() = 'name'] = 'ZERO WIDTH NO-BREAK SPACE' + + + + +Description + +If the value of the +man.charmap.use.subset parameter is non-zero, +The character-map subset specified by the +man.charmap.subset.profile parameter is used +instead of the full roff character map. + +The value of man.charmap.subset.profile +is a string representating an XPath expression that matches attribute +names and values for output-character elements in the character map. + +The attributes supported in the standard roff character map included in the distribution are: + + + character + + a raw Unicode character or numeric Unicode + character-entity value (either in decimal or hex); all + characters have this attribute + + + + name + + a standard full/long ISO/Unicode character name (e.g., + "OHM SIGN"); all characters have this attribute + + + + block + + a standard Unicode "block" name (e.g., "General + Punctuation"); all characters have this attribute. For the full + list of Unicode block names supported in the standard roff + character map, see . + + + + class + + a class of characters (e.g., "spaces"). Not all + characters have this attribute; currently, it is used only with + certain characters within the "C1 Controls And Latin-1 + Supplement" and "General Punctuation" blocks. For details, see + . + + + + entity + + an ISO entity name (e.g., "ohm"); not all characters + have this attribute, because not all characters have ISO entity + names; for example, of the 800 or so characters in the standard + roff character map included in the distribution, only around 300 + have ISO entity names. + + + + + string + + a string representating an roff/groff escape-code (with + "@esc@" used in place of the backslash), or a simple ASCII + string; all characters in the roff character map have this + attribute + + + + +The value of man.charmap.subset.profile +is evaluated as an XPath expression at run-time to select a portion of +the roff character map to use. You can tune the subset used by adding +or removing parts. For example, if you need to use a wide range of +mathematical operators in a document, and you want to have them +converted into roff markup properly, you might add the following: + + @*[local-name() = 'block'] ='MathematicalOperators' + +That will cause a additional set of around 67 additional "math" +characters to be converted into roff markup. + + +Depending on which XSLT engine you use, either the EXSLT +dyn:evaluate extension function (for xsltproc or +Xalan) or saxon:evaluate extensio function (for +Saxon) are used to dynamically evaluate the value of +man.charmap.subset.profile at run-time. If you +don't use xsltproc, Saxon, Xalan -- or some other XSLT engine that +supports dyn:evaluate -- you must either set the +value of the man.charmap.use.subset parameter +to zero and process your documents using the full character map +instead, or set the value of the +man.charmap.enabled parameter to zero instead +(so that character-map processing is disabled completely. + + +An alternative to using +man.charmap.subset.profile is to create your +own custom character map, and set the value of +man.charmap.uri to the URI/filename for +that. If you use a custom character map, you will probably want to +include in it just the characters you want to use, and so you will +most likely also want to set the value of +man.charmap.use.subset to zero. +You can create a +custom character map by making a copy of the standard roff character map provided in the distribution, and +then adding to, changing, and/or deleting from that. + + +If you author your DocBook XML source in UTF-8 or UTF-16 +encoding and aren't sure what OSes or environments your man-page +output might end up being viewed on, and not sure what version of +nroff/groff those environments might have, you should be careful about +what Unicode symbols and special characters you use in your source and +what parts you add to the value of +man.charmap.subset.profile. +Many of the escape codes used are specific to groff and using +them may not provide the expected output on an OS or environment that +uses nroff instead of groff. +On the other hand, if you intend for your man-page output to be +viewed only on modern systems (for example, GNU/Linux systems, FreeBSD +systems, or Cygwin environments) that have a good, up-to-date groff, +then you can safely include a wide range of Unicode symbols and +special characters in your UTF-8 or UTF-16 encoded DocBook XML source +and add any of the supported Unicode block names to the value of +man.charmap.subset.profile. + + + +For other details, see the documentation for the +man.charmap.use.subset parameter. + + + Supported Unicode block names and "class" values + + Below is the full list of Unicode block names and "class" + values supported in the standard roff stylesheet provided in the + distribution, along with a description of which codepoints from the + Unicode range corresponding to that block name or block/class + combination are supported. + + + + C1 Controls And Latin-1 Supplement (Latin-1 Supplement) (x00a0 to x00ff) + + class values + + symbols + + + letters + + + + + Latin Extended-A (x0100 to x017f, partial) + + + Spacing Modifier Letters (x02b0 to x02ee, partial) + + + Greek and Coptic (x0370 to x03ff, partial) + + + General Punctuation (x2000 to x206f, partial) + + class values + + spaces + + + dashes + + + quotes + + + daggers + + + bullets + + + leaders + + + primes + + + + + + Superscripts and Subscripts (x2070 to x209f) + + + Currency Symbols (x20a0 to x20b1) + + + Letterlike Symbols (x2100 to x214b) + + + Number Forms (x2150 to x218f) + + + Arrows (x2190 to x21ff, partial) + + + Mathematical Operators (x2200 to x22ff, partial) + + + Control Pictures (x2400 to x243f) + + + Enclosed Alphanumerics (x2460 to x24ff) + + + Geometric Shapes (x25a0 to x25f7, partial) + + + Miscellaneous Symbols (x2600 to x26ff, partial) + + + Dingbats (x2700 to x27be, partial) + + + Alphabetic Presentation Forms (xfb00 to xfb04 only) + + + + + diff --git a/src/documentation/docbook-xsl/params/man.charmap.uri.xml b/src/documentation/docbook-xsl/params/man.charmap.uri.xml new file mode 100644 index 0000000000..2a81f33a92 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.charmap.uri.xml @@ -0,0 +1,38 @@ + + +man.charmap.uri +uri + + +man.charmap.uri +URI for custom roff character map + + + + + + + + +Description + +For converting certain Unicode symbols and special characters in +UTF-8 or UTF-16 encoded XML source to appropriate groff/roff +equivalents in man-page output, the DocBook XSL Stylesheets +distribution includes an XSLT character +map. That character map can be considered the standard roff +character map for the distribution. + +If the value of the man.charmap.uri +parameter is non-empty, that value is used as the URI for the location +for an alternate roff character map to use in place of the standard +roff character map provided in the distribution. + + +Do not set a value for man.charmap.uri +unless you have a custom roff character map that differs from the +standard one provided in the distribution. + + + diff --git a/src/documentation/docbook-xsl/params/man.charmap.use.subset.xml b/src/documentation/docbook-xsl/params/man.charmap.use.subset.xml new file mode 100644 index 0000000000..f733a28fa5 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.charmap.use.subset.xml @@ -0,0 +1,73 @@ + + +man.charmap.use.subset +boolean + + +man.charmap.use.subset +Use subset of character map instead of full map? + + + + + + + + +Description + +If the value of the +man.charmap.use.subset parameter is non-zero, +a subset of the roff character map is used instead of the full roff +character map. The profile of the subset used is specified by the +man.charmap.subset.profile parameter. + + + You may want to experiment with setting a non-zero value of + man.charmap.use.subset, so that the full + character map is used. Depending on which XSLT engine you run, + setting a non-zero value for + man.charmap.use.subset may significantly + increase the time needed to process your documents. Or it may + not. For example, if you set it and run it with xsltproc, it seems + to dramatically increase processing time; on the other hand, if you + set it and run it with Saxon, it does not seem to increase + processing time nearly as much. + + If processing time is not a important concern and/or you can + tolerate the increase in processing time imposed by using the full + character map, set man.charmap.use.subset to + zero. + + + +Details +For converting certain Unicode symbols and special characters in +UTF-8 or UTF-16 encoded XML source to appropriate groff/roff +equivalents in man-page output, the DocBook XSL Stylesheets +distribution includes a roff character map that is compliant with the XSLT character +map format as detailed in the XSLT 2.0 specification. The map +contains more than 800 character mappings and can be considered the +standard roff character map for the distribution. + + +You can use the man.charmap.uri +parameter to specify a URI for the location for an alternate roff +character map to use in place of the standard roff character map +provided in the distribution. + + +Because it is not terrifically efficient to use the standard +800-character character map in full -- and for most (or all) users, +never necessary to use it in full -- the DocBook XSL Stylesheets +support a mechanism for using, within any given character map, a +subset of character mappings instead of the full set. You can use the +man.charmap.subset.profile parameter to tune +the profile of that subset to use. + + + + diff --git a/src/documentation/docbook-xsl/params/man.font.funcprototype.xml b/src/documentation/docbook-xsl/params/man.font.funcprototype.xml new file mode 100644 index 0000000000..a769b4c386 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.font.funcprototype.xml @@ -0,0 +1,25 @@ + + +man.font.funcprototype + + + +man.font.funcprototype +Specifies font for funcprototype output + + + + + BI + + + +Description + +The man.font.funcprototype parameter +specifies the font for funcprototype output. It +should be a valid roff font name, such as BI or +B. + + + diff --git a/src/documentation/docbook-xsl/params/man.font.funcsynopsisinfo.xml b/src/documentation/docbook-xsl/params/man.font.funcsynopsisinfo.xml new file mode 100644 index 0000000000..4071bf4d2d --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.font.funcsynopsisinfo.xml @@ -0,0 +1,25 @@ + + +man.font.funcsynopsisinfo + + + +man.font.funcsynopsisinfo +Specifies font for funcsynopsisinfo output + + + + + B + + + +Description + +The man.font.funcsynopsisinfo parameter +specifies the font for funcsynopsisinfo output. It +should be a valid roff font name, such as B or +I. + + + diff --git a/src/documentation/docbook-xsl/params/man.font.table.headings.xml b/src/documentation/docbook-xsl/params/man.font.table.headings.xml new file mode 100644 index 0000000000..c9dabc3b06 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.font.table.headings.xml @@ -0,0 +1,25 @@ + + +man.font.table.headings + + + +man.font.table.headings +Specifies font for table headings + + + + + B + + + +Description + +The man.font.table.headings parameter +specifies the font for table headings. It should be +a valid roff font, such as B or +I. + + + diff --git a/src/documentation/docbook-xsl/params/man.font.table.title.xml b/src/documentation/docbook-xsl/params/man.font.table.title.xml new file mode 100644 index 0000000000..e646f27ec6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.font.table.title.xml @@ -0,0 +1,25 @@ + + +man.font.table.title + + + +man.font.table.title +Specifies font for table headings + + + + + B + + + +Description + +The man.font.table.title parameter +specifies the font for table titles. It should be +a valid roff font, such as B or +I. + + + diff --git a/src/documentation/docbook-xsl/params/man.hyphenate.computer.inlines.xml b/src/documentation/docbook-xsl/params/man.hyphenate.computer.inlines.xml new file mode 100644 index 0000000000..0af99b9b28 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.hyphenate.computer.inlines.xml @@ -0,0 +1,48 @@ + + +man.hyphenate.computer.inlines +boolean + + +man.hyphenate.computer.inlines +Hyphenate computer inlines? + + + + +0 + + +Description + +If zero (the default), hyphenation is suppressed for +computer inlines such as environment variables, +constants, etc. This parameter current affects output of the following +elements: + + + classname + constant + envar + errorcode + option + replaceable + userinput + type + varname + + + + + If hyphenation is already turned off globally (that is, if + man.hyphenate is zero, setting the + man.hyphenate.computer.inlines is not + necessary. + + +If man.hyphenate.computer.inlines is +non-zero, computer inlines will not be treated specially and will be +hyphenated like other words when needed. + + + diff --git a/src/documentation/docbook-xsl/params/man.hyphenate.filenames.xml b/src/documentation/docbook-xsl/params/man.hyphenate.filenames.xml new file mode 100644 index 0000000000..23fa1cd332 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.hyphenate.filenames.xml @@ -0,0 +1,42 @@ + + +man.hyphenate.filenames +boolean + + +man.hyphenate.filenames +Hyphenate filenames? + + + + +0 + + +Description + +If zero (the default), hyphenation is suppressed for +filename output. + + + If hyphenation is already turned off globally (that is, if + man.hyphenate is zero, setting + man.hyphenate.filenames is not + necessary. + + +If man.hyphenate.filenames is non-zero, +filenames will not be treated specially and are subject to hyphenation +just like other words. + + + If you are thinking about setting a non-zero value for + man.hyphenate.filenames in order to make long + filenames/pathnames break across lines, you'd probably be better off + experimenting with setting the + man.break.after.slash parameter first. That + will cause long pathnames to be broken after slashes. + + + + diff --git a/src/documentation/docbook-xsl/params/man.hyphenate.urls.xml b/src/documentation/docbook-xsl/params/man.hyphenate.urls.xml new file mode 100644 index 0000000000..525b9f29a0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.hyphenate.urls.xml @@ -0,0 +1,41 @@ + + +man.hyphenate.urls +boolean + + +man.hyphenate.urls +Hyphenate URLs? + + + + +0 + + +Description + +If zero (the default), hyphenation is suppressed for output of +the ulink url attribute. + + + If hyphenation is already turned off globally (that is, if + man.hyphenate is zero, setting + man.hyphenate.urls is not necessary. + + +If man.hyphenate.urls is non-zero, URLs +will not be treated specially and are subject to hyphenation just like +other words. + + + If you are thinking about setting a non-zero value for + man.hyphenate.urls in order to make long + URLs break across lines, you'd probably be better off + experimenting with setting the + man.break.after.slash parameter first. That + will cause long URLs to be broken after slashes. + + + + diff --git a/src/documentation/docbook-xsl/params/man.hyphenate.xml b/src/documentation/docbook-xsl/params/man.hyphenate.xml new file mode 100644 index 0000000000..fe04b6bac6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.hyphenate.xml @@ -0,0 +1,54 @@ + + +man.hyphenate +boolean + + +man.hyphenate +Enable hyphenation? + + + + +0 + + +Description + +If non-zero, hyphenation is enabled. + + +The default value for this parameter is zero because groff is +not particularly smart about how it does hyphenation; it can end up +hyphenating a lot of things that you don't want hyphenated. To +mitigate that, the default behavior of the stylesheets is to suppress +hyphenation of computer inlines, filenames, and URLs. (You can +override the default behavior by setting non-zero values for the +man.hyphenate.urls, +man.hyphenate.filenames, and +man.hyphenate.computer.inlines parameters.) But +the best way is still to just globally disable hyphenation, as the +stylesheets do by default. + +The only good reason to enabled hyphenation is if you have also +enabled justification (which is disabled by default). The reason is +that justified text can look very bad unless you also hyphenate it; to +quote the Hypenation node from the groff info page: + +
                  + Since the odds are not great for finding a set of + words, for every output line, which fit nicely on a line without + inserting excessive amounts of space between words, 'gtroff' + hyphenates words so that it can justify lines without inserting too + much space between words. +
                  + +So, if you set a non-zero value for the +man.justify parameter (to enable +justification), then you should probably also set a non-zero value for +man.hyphenate (to enable hyphenation).                   +                   + + +                   +                   diff --git a/src/documentation/docbook-xsl/params/man.indent.blurbs.xml b/src/documentation/docbook-xsl/params/man.indent.blurbs.xml new file mode 100644 index 0000000000..ad3affc9cc --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.indent.blurbs.xml @@ -0,0 +1,28 @@ + + +man.indent.blurbs +boolean + + +man.indent.blurbs +Adjust indentation of blurbs? + + + + + + + +Description + +If the value of man.indent.blurbs is +non-zero, the width of the left margin for +authorblurb, personblurb, and +contrib output is set to the value of the +man.indent.width parameter +(3n by default). If instead the value of +man.indent.blurbs is zero, the built-in roff +default width (7.2n) is used. + + + diff --git a/src/documentation/docbook-xsl/params/man.indent.lists.xml b/src/documentation/docbook-xsl/params/man.indent.lists.xml new file mode 100644 index 0000000000..ee06ca765c --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.indent.lists.xml @@ -0,0 +1,30 @@ + + +man.indent.lists +boolean + + +man.indent.lists +Adjust indentation of lists? + + + + + + + +Description + +If the value of man.indent.lists is +non-zero, the width of the left margin for list items in +itemizedlist, +orderedlist, +variablelist output (and output of some other +lists) is set to the value of the +man.indent.width parameter +(3n by default). If instead the value of +man.indent.lists is zero, the built-in roff +default width (7.2n) is used. + + + diff --git a/src/documentation/docbook-xsl/params/man.indent.refsect.xml b/src/documentation/docbook-xsl/params/man.indent.refsect.xml new file mode 100644 index 0000000000..6d013036af --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.indent.refsect.xml @@ -0,0 +1,65 @@ + + +man.indent.refsect +boolean + + +man.indent.refsect +Adjust indentation of refsect* and refsection? + + + + + + + +Description + +If the value of man.indent.refsect is +non-zero, the width of the left margin for +refsect1, refsect2 and +refsect3 contents and titles (and first-level, +second-level, and third-level nested +refsectioninstances) is adjusted by the value of +the man.indent.width parameter. With +man.indent.width set to its default value of +3n, the main results are that: + + + + contents of refsect1 are output with a + left margin of three characters instead the roff default of seven + or eight characters + + + contents of refsect2 are displayed in + console output with a left margin of six characters instead the of + the roff default of seven characters + + + the contents of refsect3 and nested + refsection instances are adjusted + accordingly. + + + +If instead the value of man.indent.refsect is +zero, no margin adjustment is done for refsect* +output. + + + If your content is primarly comprised of + refsect1 and refsect2 content + (or the refsection equivalent) – with few or + no refsect3 or lower nested sections , you may be + able to “conserve” space in your output by setting + man.indent.refsect to a non-zero value. Doing + so will “squeeze” the left margin in such as way as to provide an + additional four characters of “room” per line in + refsect1 output. That extra room may be useful + if, for example, you have many verbatim sections with long lines in + them. + + + + diff --git a/src/documentation/docbook-xsl/params/man.indent.verbatims.xml b/src/documentation/docbook-xsl/params/man.indent.verbatims.xml new file mode 100644 index 0000000000..f18dbecc19 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.indent.verbatims.xml @@ -0,0 +1,28 @@ + + +man.indent.verbatims +boolean + + +man.indent.verbatims +Adjust indentation of verbatims? + + + + + + + +Description + +If the value of man.indent.verbatims is +non-zero, the width of the left margin for output of verbatim +environments (programlisting, +screen, and so on) is set to the value of the +man.indent.width parameter +(3n by default). If instead the value of +man.indent.verbatims is zero, the built-in roff +default width (7.2n) is used. + + + diff --git a/src/documentation/docbook-xsl/params/man.indent.width.xml b/src/documentation/docbook-xsl/params/man.indent.width.xml new file mode 100644 index 0000000000..7adc276220 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.indent.width.xml @@ -0,0 +1,30 @@ + + +man.indent.width +Specifies width used for adjusted indents + + + + +3n + + + +Description +The man.indent.width parameter specifies +the width used for adjusted indents. The value of +man.indent.width is used for indenting of +lists, verbatims, headings, and elsewhere, depending on whether the +values of certain man.indent.* boolean parameters +are non-zero. + +The value of man.indent.width should +include a valid roff measurement unit (for example, +n or u). The default value of +3n specifies a 3-en width; when viewed on a +console, that amounts to the width of three characters. For details +about roff measurment units, see the Measurements +node in the groff info page. + + + diff --git a/src/documentation/docbook-xsl/params/man.justify.xml b/src/documentation/docbook-xsl/params/man.justify.xml new file mode 100644 index 0000000000..4de8e299ea --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.justify.xml @@ -0,0 +1,47 @@ + + +man.justify +boolean + + +man.justify +Justify text to both right and left margins? + + + + +0 + + +Description + +If non-zero, text is justified to both the right and left +margins (or, in roff terminology, "adjusted and filled" to both the +right and left margins). If zero (the default), text is adjusted to +the left margin only -- producing what is traditionally called +"ragged-right" text. + + +The default value for this parameter is zero because justified +text looks good only when it is also hyphenated. Without hyphenation, +excessive amounts of space often end up getting between words, in +order to "pad" lines out to align on the right margin. + +The problem is that groff is not particularly smart about how it +does hyphenation; it can end up hyphenating a lot of things that you +don't want hyphenated. So, disabling both justification and +hyphenation ensures that hyphens won't get inserted where you don't +want to them, and you don't end up with lines containing excessive +amounts of space between words. + +However, if do you decide to set a non-zero value for the +man.justify parameter (to enable +justification), then you should probably also set a non-zero value for +man.hyphenate (to enable hyphenation). + +Yes, these default settings run counter to how most existing man +pages are formatted. But there are some notable exceptions, such as +the perl man pages. + + + diff --git a/src/documentation/docbook-xsl/params/man.links.are.numbered.xml b/src/documentation/docbook-xsl/params/man.links.are.numbered.xml new file mode 100644 index 0000000000..dc6faa92ea --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.links.are.numbered.xml @@ -0,0 +1,104 @@ + + +man.links.are.numbered +boolean + + +man.links.are.numbered +Number links? + + + + +1 + + + +Description + +If the value of man.links.are.numbered is +non-zero (the default), then for each non-empty +A non-empty link is one that looks like +this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/">manpages</ulink> +an empty link is on that looks like this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/"/> + link: + + + + a number (in square brackets) is displayed inline before the + rendered contents of the link + + + the URL for the link is included in a numbered list of links + that is generated at the end of each man page; the number for each + links corresponds to the inline number for the link with which it is + associated + + +The default heading for the list of links is +REFERENCES. To output a different heading, set a value +for the man.links.section.heading +parameter. + + + The link list is also displayed (but without numbers) if the + value of man.links.list.enabled is + non-zero. + + + +If the value of man.links.are.numbered is +zero, numbering of links is suppressed; only the link contents are +displayed inline. + + If you are thinking about disabling link numbering by setting + the value of man.links.are.numbered to zero, + before you do so, first take some time to carefully + consider the information needs and experiences of your users. The + square-bracketed numbers displayed inline before links may seem + obstrusive and aesthetically unpleasingYou might + think that it would be better to just display URLs for non-empty + links inline, after their content, rather than displaying + square-bracketed numbers all over the place. But it's not better. In + fact, it's not even practical, because many (most) URLs for links + are too long to be displayed inline. They end up overflowing the + right margin. You can set a non-zero value for + man.break.after.slash parameter to deal with + that, but it could be argued that what you end up with is at least + as ugly, and definitely more obstrusive, then having short + square-bracketed numbers displayed inline., + + but in a text-only output format, the numbered-links/link-listing + mechanism is the only practical way of associating inline text with + URLs. + + Also, users of text based browsers such as + lynx will already be accustomed to seeing inline + numbers for links. And various "man to html" applications, such as + the widely used man2html (VH-Man2html) + application, can automatically turn URLs into "real" HTML hyperlinks + in output. So leaving man.links.are.numbered + at its default (non-zero) value ensures that no link information is + lost in your man-page output. It just gets + rearranged. + + +The handling of empty links is not affected by this +parameter. Empty links are handled simply by displaying their URLs +inline. Empty links are never auto-numbered. + + Currently, this parameter only affects output for + ulinks. + + +If you disable link numbering, you should probably also set +man.links.are.underlined to zero (to disable +link underlining). + + diff --git a/src/documentation/docbook-xsl/params/man.links.are.underlined.xml b/src/documentation/docbook-xsl/params/man.links.are.underlined.xml new file mode 100644 index 0000000000..1314aaadcc --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.links.are.underlined.xml @@ -0,0 +1,54 @@ + + +man.links.are.underlined +boolean + + +man.links.are.underlined +Underline links? + + + + +1 + + + +Description + +If the value of man.links.are.underlined +is non-zero (the default), then the contents of links are rendered +with an underline. + +If the value of man.links.are.underlined +is zero, links are displayed without any underlining. + + + Currently, this parameter only affects output for + ulinks. + + +If you set man.links.are.numbered and/or +man.links.list.enabled to zero (disabled), then +you should probably also set +man.links.are.underlined to zero. But if +man.links.are.numbered is non-zero (enabled), +you should probably set a non-zero value for +man.links.are.underlined alsoIf the main purpose of underlining of links in most output +formats it to indicate that the underlined text is +clickable, given that links rendered in man pages are +not real hyperlinks that users can click on, it might +seem like there is never a good reason to have link contents +underlined in man output. In fact, if you suppress the +display of inline link references (by setting +man.links.are.numbered to zero), there is no +good reason to have links underlined. However, if +man.links.are.numbered is non-zero, having +links underlined may (arguably) serve a purpose: It provides +context information about exactly what part of the text +is being annotated by the link. Depending on how you +use mark up your content, that context information may or may not have +value.. + + diff --git a/src/documentation/docbook-xsl/params/man.links.list.enabled.xml b/src/documentation/docbook-xsl/params/man.links.list.enabled.xml new file mode 100644 index 0000000000..23a37bd924 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.links.list.enabled.xml @@ -0,0 +1,93 @@ + + +man.links.list.enabled +boolean + + +man.links.list.enabled +Display list of links at end of man page? + + + + +1 + + + +Description + +If the value of man.links.list.enabled is +non-zero (the default), then a list of links is added to the end of +the output man page. + +If the value of man.links.list.enabled is +zero, the list is suppressed -- unless link numbering is enabled (that +is, if man.links.are.numbered is non-zero), in +which case, that setting overrides the +man.links.list.enabled setting, and the link +list is still displayed. The reason is that link numbering only makes +sense if a (numbered) list of links is also generated. + + + Various man to html applications, such as the + widely used man2html (VH-Man2html) + application, can automatically turn URLs into real + HTML hyperlinks in output. So leaving + man.links.list.enabled at its default + (non-zero) value ensures that no link URLs are lost in your man-page + output. They just get rearranged. So if you are + thinking about disabling link listing by setting the value of + man.links.list.enabled to zero, before you do + so, first take some time to carefully consider the information needs + and experiences of your users. The URLs are useful information even + if they aren't real (clickable) hyperlinks. + + +To turn off numbering of links in the list, set +man.links.are.numbered to zero. The list will +still be displayed; it will just be displayed without the +numbersIt can still make sense to have +the list of links displayed even if you have link numbering turned +off. In that case, your list of links basically becomes a list +of references without any association with specific text in +your document. This is probably the best option if you find the inline +link numbering obtrusive. Your users will still have access to the +URLs and link contents, without being annoyed by the presence of +inline link numbering. + + +The default heading for the section in which the list appears is +REFERENCES. To change that, set a non-empty value +for the man.links.list.heading +parameter. + +Along with the URL for each link, the link list includes the contents +of the link. The list thus includes only non-empty + +A non-empty link is one that looks like +this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/">manpages</ulink> +an empty link is on that looks like this: <ulink url="http://docbook.sf.net/snapshot/xsl/doc/manpages/"/> + links. + +Empty links are never included, and never numbered. They are simply +displayed inline, without any numbering. + +In addition, if there are multiple instances of links in a +refentry that have the same URL, the URL is listed only +once. The contents listed for that link are the contents of the first +link which has that URL. + + + Currently, this parameter only affects output for + ulinks. + + +If you disable link listing, you should probably also set +man.links.are.underlined to zero (to disable +link underlining). + + diff --git a/src/documentation/docbook-xsl/params/man.links.list.heading.xml b/src/documentation/docbook-xsl/params/man.links.list.heading.xml new file mode 100644 index 0000000000..1b3e452390 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.links.list.heading.xml @@ -0,0 +1,30 @@ + + +man.links.list.heading +string + + +man.links.list.heading +Specifies an alternate name for links list + + + + + + + + +Description + +If the value of the +man.links.are.numbered parameter and/or the +man.links.list.enabled parameter is non-zero +(the defaults for both are non-zero), a numbered list of URLs is +generated near the end of each man page. The default section heading +for the list of links is the equivalent of the English word +REFERENCES in the current locale. To cause an +alternate heading to be displayed, set a non-empty value for the +man.links.list.heading parameter -- for +example, LINKS. + + diff --git a/src/documentation/docbook-xsl/params/man.output.base.dir.xml b/src/documentation/docbook-xsl/params/man.output.base.dir.xml new file mode 100644 index 0000000000..bee20f162f --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.output.base.dir.xml @@ -0,0 +1,36 @@ + + +man.output.base.dir + + + +man.output.base.dir +Specifies separate output directory + + + +man/ + + +Description + +The man.output.base.dir parameter +specifies the base directory into which man-page files are output. The +man.output.subdirs.enabled parameter controls +whether the files are output in subdirectories within the base +directory. + + + The values of the man.output.base.dir + and man.output.subdirs.enabled parameters are + used only if the value of + man.output.in.separate.dir parameter is + non-zero. If the value of the + man.output.in.separate.dir is zero, man-page + files are not output in a separate directory. + + + + diff --git a/src/documentation/docbook-xsl/params/man.output.encoding.xml b/src/documentation/docbook-xsl/params/man.output.encoding.xml new file mode 100644 index 0000000000..0eb37802eb --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.output.encoding.xml @@ -0,0 +1,47 @@ + + +man.output.encoding +string + + +man.output.encoding +Encoding used for man-page output + + + + + + + +Description + +This parameter specifies the encoding to use for files generated +by the manpages stylesheet. Not all processors support specification +of this parameter. + + + If the value of the man.charmap.enabled + parameter is non-zero (the default), keeping the + man.output.encoding parameter at its default + value (UTF-8) or setting it to + UTF-16 does not cause your + man pages to be output in raw UTF-8 or UTF-16 -- because + any Unicode characters for which matches are found in the enabled + character map will be replaced with roff escape sequences before the + final man-page files are generated. + + So if you want to generate "real" UTF-8 man pages, without any + character substitution being performed on your content, you need to + set man.charmap.enabled to zero (which will + completely disable character-map processing). + + You may also need to set + man.charmap.enabled to zero if you want to + output man pages in an encoding other than UTF-8 + or UTF-16. Character-map processing is based on + Unicode character values and may not work with other output + encodings. + + + + diff --git a/src/documentation/docbook-xsl/params/man.output.in.separate.dir.xml b/src/documentation/docbook-xsl/params/man.output.in.separate.dir.xml new file mode 100644 index 0000000000..f6cad04e02 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.output.in.separate.dir.xml @@ -0,0 +1,27 @@ + + +man.output.in.separate.dir + + + +man.output.in.separate.dir +Output man-page files in separate output directory? + + + + + + + + +Description + +If the value of man.output.in.separate.dir +parameter is non-zero, man-page files are output in a separate +directory, specified by the man.output.base.dir +parameter; otherwise, if the value of +man.output.in.separate.dir is zero, man-page files +are not output in a separate directory. + + + diff --git a/src/documentation/docbook-xsl/params/man.output.manifest.enabled.xml b/src/documentation/docbook-xsl/params/man.output.manifest.enabled.xml new file mode 100644 index 0000000000..108804e1cc --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.output.manifest.enabled.xml @@ -0,0 +1,23 @@ + + + man.output.manifest.enabled + boolean + + + man.output.manifest.enabled + Generate a manifest file? + + + + + + + Description + + If non-zero, a list of filenames for man pages generated by + the stylesheet transformation is written to the file named by the + man.output.manifest.filename parameter. + + + diff --git a/src/documentation/docbook-xsl/params/man.output.manifest.filename.xml b/src/documentation/docbook-xsl/params/man.output.manifest.filename.xml new file mode 100644 index 0000000000..30811578bc --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.output.manifest.filename.xml @@ -0,0 +1,25 @@ + + + man.output.manifest.filename + string + + + man.output.manifest.filename + Name of manifest file + + + + MAN.MANIFEST + + + Description + + The man.output.manifest.filename parameter + specifies the name of the file to which the manpages manifest file + is written (if the value of the + man.output.manifest.enabled parameter is + non-zero). + + + diff --git a/src/documentation/docbook-xsl/params/man.output.quietly.xml b/src/documentation/docbook-xsl/params/man.output.quietly.xml new file mode 100644 index 0000000000..5460b52bb0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.output.quietly.xml @@ -0,0 +1,32 @@ + + +man.output.quietly + + + +man.output.quietly +Suppress filename messages emitted when generating output? + + + + + + + + +Description + +If zero (the default), for each man-page file created, a message +with the name of the file is emitted. If non-zero, the files are +output "quietly" -- that is, the filename messages are +suppressed. + + + If you are processing a large amount of refentry + content, you may be able to speed up processing significantly by + setting a non-zero value for + man.output.quietly. + + + + diff --git a/src/documentation/docbook-xsl/params/man.output.subdirs.enabled.xml b/src/documentation/docbook-xsl/params/man.output.subdirs.enabled.xml new file mode 100644 index 0000000000..cb97562dbd --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.output.subdirs.enabled.xml @@ -0,0 +1,35 @@ + + +man.output.subdirs.enabled + + + +man.output.subdirs.enabled +Output man-page files in subdirectories within base output directory? + + + + + + + + +Description + +The man.output.subdirs.enabled parameter +controls whether man-pages files are output in subdirectories within +the base directory specified by the directory specified by the +man.output.base.dir parameter. + + + The values of the man.output.base.dir + and man.output.subdirs.enabled parameters are + used only if the value of + man.output.in.separate.dir parameter is + non-zero. If the value of the + man.output.in.separate.dir is zero, man-page + files are not output in a separate directory. + + + + diff --git a/src/documentation/docbook-xsl/params/man.segtitle.suppress.xml b/src/documentation/docbook-xsl/params/man.segtitle.suppress.xml new file mode 100644 index 0000000000..29c54ccb58 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.segtitle.suppress.xml @@ -0,0 +1,23 @@ + + +man.segtitle.suppress +boolean + + +man.segtitle.suppress +Suppress display of segtitle contents? + + + + + + + +Description + +If the value of man.segtitle.suppress is +non-zero, then display of segtitle contents is +suppressed in output. + + + diff --git a/src/documentation/docbook-xsl/params/man.string.subst.map.xml b/src/documentation/docbook-xsl/params/man.string.subst.map.xml new file mode 100644 index 0000000000..ad12cd2798 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.string.subst.map.xml @@ -0,0 +1,193 @@ + + +man.string.subst.map +string + + +man.string.subst.map +Specifies a set of string substitutions + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Description + +The man.string.subst.map parameter +contains a map that specifies a set of +string substitutions to perform over the entire roff source for each +man page, either just before generating final man-page output (that +is, before writing man-page files to disk) or, if the value of the +man.charmap.enabled parameter is non-zero, +before applying the roff character map. + +You can use man.string.subst.map as a +"lightweight" character map to perform "essential" substitutions -- +that is, substitutions that are always performed, +even if the value of the man.charmap.enabled +parameter is zero. For example, you can use it to replace quotation +marks or other special characters that are generated by the DocBook +XSL stylesheets for a particular locale setting (as opposed to those +characters that are actually in source XML documents), or to replace +any special characters that may be automatically generated by a +particular customization of the DocBook XSL stylesheets. + + + Do you not change value of the + man.string.subst.map parameter unless + you are sure what you are doing. If you remove any of the default + mappings, you are likely to end up with broken output. And be very + careful about adding anything to it. Because it is used for doing + string substitution over the entire roff source of each man page, it + causes target strings to be replaced in roff requests and escapes, + not just in the visible contents. + + In particular, do not attempt to add a mapping for the + dot/period character. Doing so will break your output. For an + explanation, see . + + + + + Contents of the substitution map + The string-substitution map contains one or more substitution elements, each of which has two attributes: + + + oldstring + + string to replace + + + + newstring + + string with which to replace oldstring + + + + It may also include XML comments (that is, delimited with + "<!--" and "-->"). + + + + + About adding backslashes before dots + The stylesheets do not add backslashes before + periods/dots. One reason is that, because string substitution is + performed over the entire roff source of each man page, it would be + complicated to replace dots in visible contents without also causing + them to be replaced in roff requests and escapes; for example, + without causing, say, the .TH roff macro to be + replaced with \.TH. Additionally, backslashes in + front of periods/dots are needed only in the very rare case where a + period is the very first character in a line, without any space in + front of it. A better way to deal with that rare case is to add a + zero-width space in front of the offending dot(s) in your + source. + + + + diff --git a/src/documentation/docbook-xsl/params/man.subheading.divider.enabled.xml b/src/documentation/docbook-xsl/params/man.subheading.divider.enabled.xml new file mode 100644 index 0000000000..c30c939273 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.subheading.divider.enabled.xml @@ -0,0 +1,32 @@ + + +man.subheading.divider.enabled +string + + +man.subheading.divider.enabled +Add divider comment to roff source before/after subheadings? + + + + +0 + + + +Description + +If the value of the +man.subheading.divider.enabled parameter is +non-zero, the contents of the +man.subheading.divider parameter are used to +add a "divider" before and after subheadings in the roff +output. The divider is not visisble in the +rendered man page; it is added as a comment, in the source, +simply for the purpose of increasing reability of the source. + +If man.subheading.divider.enabled is zero +(the default), the subheading divider is suppressed. + + + diff --git a/src/documentation/docbook-xsl/params/man.subheading.divider.xml b/src/documentation/docbook-xsl/params/man.subheading.divider.xml new file mode 100644 index 0000000000..fed4c63cda --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.subheading.divider.xml @@ -0,0 +1,33 @@ + + +man.subheading.divider +string + + +man.subheading.divider +Specifies string to use as divider comment before/after subheadings + + + + +======================================================================== + + + +Description + +If the value of the +man.subheading.divider.enabled parameter is +non-zero, the contents of the +man.subheading.divider parameter are used to +add a "divider" before and after subheadings in the roff +output. The divider is not visisble in the +rendered man page; it is added as a comment, in the source, +simply for the purpose of increasing reability of the source. + +If man.subheading.divider.enabled is zero +(the default), the subheading divider is suppressed. + + + diff --git a/src/documentation/docbook-xsl/params/man.table.footnotes.divider.xml b/src/documentation/docbook-xsl/params/man.table.footnotes.divider.xml new file mode 100644 index 0000000000..62b697e12a --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.table.footnotes.divider.xml @@ -0,0 +1,24 @@ + + +man.table.footnotes.divider +string + + +man.table.footnotes.divider +Specifies divider string that appears before table footnotes + + + + +---- + + + +Description + +In each table that contains footenotes, the string specified by +the man.table.footnotes.divider parameter is +output before the list of footnotes for the table. + + + diff --git a/src/documentation/docbook-xsl/params/man.th.extra1.suppress.xml b/src/documentation/docbook-xsl/params/man.th.extra1.suppress.xml new file mode 100644 index 0000000000..0dcca9fc15 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.th.extra1.suppress.xml @@ -0,0 +1,27 @@ + + +man.th.extra1.suppress +boolean + + +man.th.extra1.suppress +Suppress extra1 part of header/footer? + + + + +0 + + +Description + +If the value of man.th.extra1.suppress is +non-zero, then the extra1 part of the +.TH title line header/footer is suppressed. + +The content of the extra1 field is almost +always displayed in the center footer of the page and is, universally, +a date. + + + diff --git a/src/documentation/docbook-xsl/params/man.th.extra2.max.length.xml b/src/documentation/docbook-xsl/params/man.th.extra2.max.length.xml new file mode 100644 index 0000000000..f0d643850c --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.th.extra2.max.length.xml @@ -0,0 +1,38 @@ + + +man.th.extra2.max.length +integer + + +man.th.extra2.max.length +Maximum length of extra2 in header/footer + + + + +30 + + + +Description + +Specifies the maximum permitted length of the +extra2 part of the man-page part of the +.TH title line header/footer. If the +extra2 content exceeds the maxiumum specified, it +is truncated down to the maximum permitted length. + +The content of the extra2 field is usually +displayed in the left footer of the page and is typically "source" +data indicating the software system or product that the item +documented in the man page belongs to, often in the form +Name Version; +for example, "GTK+ 1.2" (from the gtk-options(7) +man page). + +The default value for this parameter is reasonable but somewhat +arbitrary. If you are processing pages with long "source" information, +you may want to experiment with changing the value in order to achieve +the correct aesthetic results. + + diff --git a/src/documentation/docbook-xsl/params/man.th.extra2.suppress.xml b/src/documentation/docbook-xsl/params/man.th.extra2.suppress.xml new file mode 100644 index 0000000000..8bc0a8228b --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.th.extra2.suppress.xml @@ -0,0 +1,39 @@ + + +man.th.extra2.suppress +boolean + + +man.th.extra2.suppress +Suppress extra2 part of header/footer? + + + + +0 + + +Description + +If the value of man.th.extra2.suppress is +non-zero, then the extra2 part of the +.TH title line header/footer is suppressed. + +The content of the extra2 field is usually +displayed in the left footer of the page and is typically "source" +data, often in the form +Name Version; +for example, "GTK+ 1.2" (from the gtk-options(7) +man page). + + + You can use the + refentry.source.name.suppress and + refentry.version.suppress parameters to + independently suppress the Name and + Version parts of the + extra2 field. + + + + diff --git a/src/documentation/docbook-xsl/params/man.th.extra3.max.length.xml b/src/documentation/docbook-xsl/params/man.th.extra3.max.length.xml new file mode 100644 index 0000000000..5406da3fe3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.th.extra3.max.length.xml @@ -0,0 +1,37 @@ + + +man.th.extra3.max.length +integer + + +man.th.extra3.max.length +Maximum length of extra3 in header/footer + + + + +30 + + + +Description + +Specifies the maximum permitted length of the +extra3 part of the man-page .TH +title line header/footer. If the extra3 content +exceeds the maxiumum specified, it is truncated down to the maximum +permitted length. + +The content of the extra3 field is usually +displayed in the middle header of the page and is typically a "manual +name"; for example, "GTK+ User's Manual" (from the +gtk-options(7) man page). + +The default value for this parameter is reasonable but somewhat +arbitrary. If you are processing pages with long "manual names" -- or +especially if you are processing pages that have both long "title" +parts (command/function, etc. names) and long +manual names -- you may want to experiment with changing the value in +order to achieve the correct aesthetic results. + + diff --git a/src/documentation/docbook-xsl/params/man.th.extra3.suppress.xml b/src/documentation/docbook-xsl/params/man.th.extra3.suppress.xml new file mode 100644 index 0000000000..b7c51c1f1f --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.th.extra3.suppress.xml @@ -0,0 +1,29 @@ + + +man.th.extra3.suppress +boolean + + +man.th.extra3.suppress +Suppress extra3 part of header/footer? + + + + +0 + + +Description + +If the value of man.th.extra3.suppress is +non-zero, then the extra3 part of the +.TH title line header/footer is +suppressed. + +The content of the extra3 field is usually +displayed in the middle header of the page and is typically a "manual +name"; for example, "GTK+ User's Manual" (from the +gtk-options(7) man page). + + + diff --git a/src/documentation/docbook-xsl/params/man.th.title.max.length.xml b/src/documentation/docbook-xsl/params/man.th.title.max.length.xml new file mode 100644 index 0000000000..c07d20ab51 --- /dev/null +++ b/src/documentation/docbook-xsl/params/man.th.title.max.length.xml @@ -0,0 +1,58 @@ + + +man.th.title.max.length +integer + + +man.th.title.max.length +Maximum length of title in header/footer + + + + +20 + + + +Description + +Specifies the maximum permitted length of the title part of the +man-page .TH title line header/footer. If the title +exceeds the maxiumum specified, it is truncated down to the maximum +permitted length. + + + Details + +Every man page generated using the DocBook stylesheets has a +title line, specified using the TH roff +macro. Within that title line, there is always, at a minimum, a title, +followed by a section value (representing a man "section" -- usually +just a number). + +The title and section are displayed, together, in the visible +header of each page. Where in the header they are displayed depends on +OS the man page is viewed on, and on what version of nroff/groff/man +is used for viewing the page. But, at a minimum and across all +systems, the title and section are displayed on the right-hand column +of the header. On many systems -- those with a modern groff, including +Linux systems -- they are displayed twice: both in the left and right +columns of the header. + +So if the length of the title exceeds a certain percentage of +the column width in which the page is viewed, the left and right +titles can end up overlapping, making them unreadable, or breaking to +another line, which doesn't look particularly good. + +So the stylesheets provide the +man.th.title.max.length parameter as a means +for truncating titles that exceed the maximum length that can be +viewing properly in a page header. + +The default value is reasonable but somewhat arbitrary. If you +have pages with long titles, you may want to experiment with changing +the value in order to achieve the correct aesthetic results. + + + + diff --git a/src/documentation/docbook-xsl/params/manifest.in.base.dir.xml b/src/documentation/docbook-xsl/params/manifest.in.base.dir.xml new file mode 100644 index 0000000000..a13a5c674c --- /dev/null +++ b/src/documentation/docbook-xsl/params/manifest.in.base.dir.xml @@ -0,0 +1,25 @@ + + +manifest.in.base.dir +boolean + + +manifest.in.base.dir +Should be manifest file written in $base.dir? + + + + + + + + +Description + +If non-zero manifest file and project files for HTML Help and +Eclipse Help are written into base.dir instead +of current directory. + + + + diff --git a/src/documentation/docbook-xsl/params/manifest.xml b/src/documentation/docbook-xsl/params/manifest.xml new file mode 100644 index 0000000000..4022d9ce7b --- /dev/null +++ b/src/documentation/docbook-xsl/params/manifest.xml @@ -0,0 +1,23 @@ + + + manifest + string + + + manifest + Name of manifest file + + + + + + + Description + + The name of the file to which a manifest is written (if the + value of the generate.manifest parameter + is non-zero). + + + diff --git a/src/documentation/docbook-xsl/params/manual.toc.xml b/src/documentation/docbook-xsl/params/manual.toc.xml new file mode 100644 index 0000000000..760e612cbb --- /dev/null +++ b/src/documentation/docbook-xsl/params/manual.toc.xml @@ -0,0 +1,24 @@ + + +manual.toc +string + + +manual.toc +An explicit TOC to be used for the TOC + + + + + + + + +Description + +The manual.toc identifies an explicit TOC that +will be used for building the printed TOC. + + + + diff --git a/src/documentation/docbook-xsl/params/margin.note.float.type.xml b/src/documentation/docbook-xsl/params/margin.note.float.type.xml new file mode 100644 index 0000000000..a735dbbceb --- /dev/null +++ b/src/documentation/docbook-xsl/params/margin.note.float.type.xml @@ -0,0 +1,64 @@ + + +margin.note.float.type +list + + +margin.note.float.type +Select type of float for margin note customizations + + + + + + + + +Description + +Selects the type of float for margin notes. +DocBook does not define a margin note element, so this +feature must be implemented as a customization of the stylesheet. +See margin.note.properties for +an example. + + + +If margin.note.float.type is +none, then +no float is used. + + + +If margin.note.float.type is +before, then +the float appears at the top of the page. On some processors, +that may be the next page rather than the current page. + + + +If margin.note.float.type is +left or +start, then +a left side float is used. + + + +If margin.note.float.type is +right or +end, then +a right side float is used. + + + +If your XSL-FO processor supports floats positioned on the +inside or +outside +of double-sided pages, then you have those two +options for side floats as well. + + + + + + diff --git a/src/documentation/docbook-xsl/params/margin.note.properties.xml b/src/documentation/docbook-xsl/params/margin.note.properties.xml new file mode 100644 index 0000000000..b6b5518583 --- /dev/null +++ b/src/documentation/docbook-xsl/params/margin.note.properties.xml @@ -0,0 +1,49 @@ + + +margin.note.properties +attribute set + + +margin.note.properties +Attribute set for margin.note properties + + + + + + 90% + start + + + + +Description + +The styling for margin notes. +By default, margin notes are not implemented for any +element. A stylesheet customization is needed to make +use of this attribute-set. + +You can use a template named floater +to create the customization. +That template can create side floats by specifying the +content and characteristics as template parameters. + + +For example: + + + + + + + + + + + + +                  ]]> + + + diff --git a/src/documentation/docbook-xsl/params/margin.note.title.properties.xml b/src/documentation/docbook-xsl/params/margin.note.title.properties.xml new file mode 100644 index 0000000000..67ac3ad51c --- /dev/null +++ b/src/documentation/docbook-xsl/params/margin.note.title.properties.xml @@ -0,0 +1,27 @@ + + +margin.note.title.properties +attribute set + + +margin.note.title.properties +Attribute set for margin note titles + + + + + + bold + false + start + always + + + + +Description + +The styling for margin note titles. + + + diff --git a/src/documentation/docbook-xsl/params/margin.note.width.xml b/src/documentation/docbook-xsl/params/margin.note.width.xml new file mode 100644 index 0000000000..342d3150b2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/margin.note.width.xml @@ -0,0 +1,29 @@ + + +margin.note.width + + +margin.note.width +Set the default width for margin notes + + + + + + + + +Description + +Sets the default width for margin notes when used as a side float. +The width determines the degree to which the margin note block intrudes into +the text area. + +If margin.note.float.type is +before or +none, then +this parameter is ignored. + + + + diff --git a/src/documentation/docbook-xsl/params/marker.section.level.xml b/src/documentation/docbook-xsl/params/marker.section.level.xml new file mode 100644 index 0000000000..b944f9caf3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/marker.section.level.xml @@ -0,0 +1,45 @@ + + +marker.section.level +integer + + +marker.section.level +Control depth of sections shown in running headers or footers + + + + + + + + +Description + +The marker.section.level parameter +controls the depth of section levels that may be displayed +in running headers and footers. For example, if the value +is 2 (the default), then titles from sect1 and +sect2 or equivalent section +elements are candidates for use in running headers and +footers. + +Each candidate title is marked in the FO output with a +<fo:marker marker-class-name="section.head.marker"> +element. + +In order for such titles to appear in headers +or footers, the header.content +or footer.content template +must be customized to retrieve the marker using +an output element such as: + + +<fo:retrieve-marker retrieve-class-name="section.head.marker" + retrieve-position="first-including-carryover" + retrieve-boundary="page-sequence"/> + + + + + diff --git a/src/documentation/docbook-xsl/params/menuchoice.menu.separator.xml b/src/documentation/docbook-xsl/params/menuchoice.menu.separator.xml new file mode 100644 index 0000000000..9888227fe5 --- /dev/null +++ b/src/documentation/docbook-xsl/params/menuchoice.menu.separator.xml @@ -0,0 +1,37 @@ + + +menuchoice.menu.separator + + + +menuchoice.menu.separator +Separator between items of a menuchoice +with guimenuitem or +guisubmenu + + + + + → + + + +Description + +Separator used to connect items of a menuchoice with +guimenuitem or guisubmenu. Other elements +are linked with menuchoice.separator. + +The default value is &#x2192;, which is the +&rarr; (right arrow) character entity. +The current FOP (0.20.5) requires setting the font-family +explicitly. + +The default value also includes spaces around the arrow, +which will allow a line to break. Replace the spaces with +&#xA0; (nonbreaking space) if you don't want those +spaces to break. + + + + diff --git a/src/documentation/docbook-xsl/params/menuchoice.separator.xml b/src/documentation/docbook-xsl/params/menuchoice.separator.xml new file mode 100644 index 0000000000..3d3fb1662b --- /dev/null +++ b/src/documentation/docbook-xsl/params/menuchoice.separator.xml @@ -0,0 +1,27 @@ + + +menuchoice.separator + + + +menuchoice.separator +Separator between items of a menuchoice +other than guimenuitem and +guisubmenu + + + + + + + + +Description + +Separator used to connect items of a menuchoice other +than guimenuitem and guisubmenu. The latter +elements are linked with menuchoice.menu.separator. + + + + diff --git a/src/documentation/docbook-xsl/params/monospace.font.family.xml b/src/documentation/docbook-xsl/params/monospace.font.family.xml new file mode 100644 index 0000000000..d14bd1e3a3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/monospace.font.family.xml @@ -0,0 +1,24 @@ + + +monospace.font.family + + + +monospace.font.family +The default font family for monospace environments + + + + + + + + +Description + +The monospace font family is used for verbatim environments +(program listings, screens, etc.). + + + + diff --git a/src/documentation/docbook-xsl/params/monospace.properties.xml b/src/documentation/docbook-xsl/params/monospace.properties.xml new file mode 100644 index 0000000000..c066879980 --- /dev/null +++ b/src/documentation/docbook-xsl/params/monospace.properties.xml @@ -0,0 +1,33 @@ + + +monospace.properties +attribute set + + +monospace.properties +Properties of monospaced content + + + + + + + + + + + + +Description + +Specifies the font name for monospaced output. This property set +used to set the font-size as well, but that doesn't work very well +when different fonts are used (as they are in titles and paragraphs, +for example). + +If you want to set the font-size in a customization layer, it's +probably going to be more appropriate to set font-size-adjust, if your +formatter supports it. + + + diff --git a/src/documentation/docbook-xsl/params/monospace.verbatim.properties.xml b/src/documentation/docbook-xsl/params/monospace.verbatim.properties.xml new file mode 100644 index 0000000000..228be1a4e2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/monospace.verbatim.properties.xml @@ -0,0 +1,18 @@ + + +monospace.verbatim.properties +What font and size do you want for monospaced content? + + + + + + start + no-wrap + + + +Description +Specify the font name and size you want for monospaced output + + diff --git a/src/documentation/docbook-xsl/params/navig.graphics.extension.xml b/src/documentation/docbook-xsl/params/navig.graphics.extension.xml new file mode 100644 index 0000000000..833a1061ba --- /dev/null +++ b/src/documentation/docbook-xsl/params/navig.graphics.extension.xml @@ -0,0 +1,21 @@ + + +navig.graphics.extension +string + + +navig.graphics.extension +Extension for navigational graphics + + + + + + +Description + +Sets the filename extension to use on navigational graphics used +in the headers and footers of chunked HTML. + + + diff --git a/src/documentation/docbook-xsl/params/navig.graphics.path.xml b/src/documentation/docbook-xsl/params/navig.graphics.path.xml new file mode 100644 index 0000000000..3a36a41a5c --- /dev/null +++ b/src/documentation/docbook-xsl/params/navig.graphics.path.xml @@ -0,0 +1,23 @@ + + +navig.graphics.path +string + + +navig.graphics.path +Path to navigational graphics + + + +images/ + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the navigational graphics used in the +headers and footers of chunked HTML. + + + + diff --git a/src/documentation/docbook-xsl/params/navig.graphics.xml b/src/documentation/docbook-xsl/params/navig.graphics.xml new file mode 100644 index 0000000000..fa83f3efc9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/navig.graphics.xml @@ -0,0 +1,24 @@ + + +navig.graphics +boolean + + +navig.graphics +Use graphics in navigational headers and footers? + + + + + + +Description + +If true (non-zero), the navigational headers and footers in chunked +HTML are presented in an alternate style that uses +graphical icons for Next, Previous, Up, and Home. +Default graphics are provided in the distribution. + + + + diff --git a/src/documentation/docbook-xsl/params/navig.showtitles.xml b/src/documentation/docbook-xsl/params/navig.showtitles.xml new file mode 100644 index 0000000000..aa40588e02 --- /dev/null +++ b/src/documentation/docbook-xsl/params/navig.showtitles.xml @@ -0,0 +1,27 @@ + + +navig.showtitles +boolean + + +navig.showtitles +Display titles in HTML headers and footers? + + + +1 + + +Description + +If true (non-zero), +the headers and footers of chunked HTML +display the titles of the next and previous chunks, +along with the words 'Next' and 'Previous' (or the +equivalent graphical icons if navig.graphics is true). +If false (zero), then only the words 'Next' and 'Previous' +(or the icons) are displayed. + + + + diff --git a/src/documentation/docbook-xsl/params/nominal.image.depth.xml b/src/documentation/docbook-xsl/params/nominal.image.depth.xml new file mode 100644 index 0000000000..ac4935b00d --- /dev/null +++ b/src/documentation/docbook-xsl/params/nominal.image.depth.xml @@ -0,0 +1,22 @@ + + +nominal.image.depth +length + + +nominal.image.depth +Nominal image depth + + + + + + + + +Description + +See nominal.image.width. + + + diff --git a/src/documentation/docbook-xsl/params/nominal.image.width.xml b/src/documentation/docbook-xsl/params/nominal.image.width.xml new file mode 100644 index 0000000000..f630af9c06 --- /dev/null +++ b/src/documentation/docbook-xsl/params/nominal.image.width.xml @@ -0,0 +1,38 @@ + + +nominal.image.width +length + + +nominal.image.width +The nominal image width + + + + + + + + +Description + +Graphic widths expressed as a percentage are problematic. In the +following discussion, we speak of width and contentwidth, but +the same issues apply to depth and contentdepth. + +A width of 50% means "half of the available space for the image." +That's fine. But note that in HTML, this is a dynamic property and +the image size will vary if the browser window is resized. + +A contentwidth of 50% means "half of the actual image width". +But what does that mean if the stylesheets cannot assess the image's +actual size? Treating this as a width of 50% is one possibility, but +it produces behavior (dynamic scaling) that seems entirely out of +character with the meaning. + +Instead, the stylesheets define a +nominal.image.width and convert percentages to +actual values based on that nominal size. + + + diff --git a/src/documentation/docbook-xsl/params/nominal.table.width.xml b/src/documentation/docbook-xsl/params/nominal.table.width.xml new file mode 100644 index 0000000000..6abbf0b20c --- /dev/null +++ b/src/documentation/docbook-xsl/params/nominal.table.width.xml @@ -0,0 +1,23 @@ + + +nominal.table.width +length + + +nominal.table.width +The (absolute) nominal width of tables + + + + + + +Description + +In order to convert CALS column widths into HTML column widths, it +is sometimes necessary to have an absolute table width to use for conversion +of mixed absolute and relative widths. This value must be an absolute +length (not a percentag). + + + diff --git a/src/documentation/docbook-xsl/params/nongraphical.admonition.properties.xml b/src/documentation/docbook-xsl/params/nongraphical.admonition.properties.xml new file mode 100644 index 0000000000..9d59abdf16 --- /dev/null +++ b/src/documentation/docbook-xsl/params/nongraphical.admonition.properties.xml @@ -0,0 +1,32 @@ + + +nongraphical.admonition.properties +To add properties to the outer block of a nongraphical admonition. + + + + + 0.8em + 1em + 1.2em + 0.25in + 0.25in + + + +Description +These properties are added to the outer block containing the +entire nongraphical admonition, including its title. +It is used when the parameter +admon.graphics is set to zero. +Use this attribute-set to set the space above and below, +and any indent for the whole admonition. + +In addition to these properties, a nongraphical admonition +also applies the admonition.title.properties +attribute-set to the title, and the +admonition.properties attribute-set +to the rest of the content. + + + diff --git a/src/documentation/docbook-xsl/params/normal.para.spacing.xml b/src/documentation/docbook-xsl/params/normal.para.spacing.xml new file mode 100644 index 0000000000..4e68217a17 --- /dev/null +++ b/src/documentation/docbook-xsl/params/normal.para.spacing.xml @@ -0,0 +1,17 @@ + + +normal.para.spacing +What space do you want between normal paragraphs + + + + + 1em + 0.8em + 1.2em + + +Description +Specify the spacing required between normal paragraphs + + diff --git a/src/documentation/docbook-xsl/params/olink.base.uri.xml b/src/documentation/docbook-xsl/params/olink.base.uri.xml new file mode 100644 index 0000000000..266030ec06 --- /dev/null +++ b/src/documentation/docbook-xsl/params/olink.base.uri.xml @@ -0,0 +1,17 @@ + + +olink.base.uri +uri + + +olink.base.uri +Base URI used in olink hrefs + + + + + +Description +When cross reference data is collected for resolving olinks, it may be necessary to prepend a base URI to each target's href. This parameter lets you set that base URI when cross reference data is collected. This feature is needed when you want to link to a document that is processed without chunking. The output filename for such a document is not known to the XSL stylesheet; the only target information consists of fragment identifiers such as #idref. To enable the resolution of olinks between documents, you should pass the name of the HTML output file as the value of this parameter. Then the hrefs recorded in the cross reference data collection look like outfile.html#idref, which can be reached as links from other documents. + + diff --git a/src/documentation/docbook-xsl/params/olink.debug.xml b/src/documentation/docbook-xsl/params/olink.debug.xml new file mode 100644 index 0000000000..318920a580 --- /dev/null +++ b/src/documentation/docbook-xsl/params/olink.debug.xml @@ -0,0 +1,31 @@ + + +olink.debug +boolean + + +olink.debug +Turn on debugging messages for olinks + + + + + + + + +Description + +If non-zero, then each olink will generate several +messages about how it is being resolved during processing. +This is useful when an olink does not resolve properly +and the standard error messages are not sufficient to +find the problem. + + +You may need to read through the olink XSL templates +to understand the context for some of the debug messages. + + + + diff --git a/src/documentation/docbook-xsl/params/olink.doctitle.xml b/src/documentation/docbook-xsl/params/olink.doctitle.xml new file mode 100644 index 0000000000..b82d966d2e --- /dev/null +++ b/src/documentation/docbook-xsl/params/olink.doctitle.xml @@ -0,0 +1,137 @@ + + +olink.doctitle +string + + +olink.doctitle +show the document title for external olinks? + + + + + + +Description +When olinks between documents are resolved, the generated text +may not make it clear that the reference is to another document. +It is possible for the stylesheets to append the other document's +title to external olinks. For this to happen, two parameters must +be set. + + +This olink.doctitle parameter +should be set to either yes or maybe +to enable this feature. + + + +And you should also set the current.docid +parameter to the document id for the document currently +being processed for output. + + + + + +Then if an olink's targetdoc id differs from +the current.docid value, the stylesheet knows +that it is a reference to another document and can +append the target document's +title to the generated olink text. + +The text for the target document's title is copied from the +olink database from the ttl element +of the top-level div for that document. +If that ttl element is missing or empty, +no title is output. + + +The supported values for olink.doctitle are: + + + +yes + + +Always insert the title to the target document if it is not +the current document. + + + + +no + + +Never insert the title to the target document, even if requested +in an xrefstyle attribute. + + + + +maybe + + +Only insert the title to the target document, if requested +in an xrefstyle attribute. + + + + +An xrefstyle attribute +may override the global setting for individual olinks. +The following values are supported in an +xrefstyle +attribute using the select: syntax: + + + + +docname + + +Insert the target document name for this olink using the +docname gentext template, but only +if the value of olink.doctitle +is not no. + + + + +docnamelong + + +Insert the target document name for this olink using the +docnamelong gentext template, but only +if the value of olink.doctitle +is not no. + + + + +nodocname + + +Omit the target document name even if +the value of olink.doctitle +is yes. + + + + +Another way of inserting the target document name +for a single olink is to employ an +xrefstyle +attribute using the template: syntax. +The %o placeholder (the letter o, not zero) +in such a template +will be filled in with the target document's title when it is processed. +This will occur regardless of +the value of olink.doctitle. + +Note that prior to version 1.66 of the XSL stylesheets, +the allowed values for this parameter were 0 and 1. Those +values are still supported and mapped to 'no' and 'yes', respectively. + + + diff --git a/src/documentation/docbook-xsl/params/olink.fragid.xml b/src/documentation/docbook-xsl/params/olink.fragid.xml new file mode 100644 index 0000000000..0e6d33d997 --- /dev/null +++ b/src/documentation/docbook-xsl/params/olink.fragid.xml @@ -0,0 +1,20 @@ + + +olink.fragid +string + + +olink.fragid +Names the fragment identifier portion of an OLink resolver query + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/olink.lang.fallback.sequence.xml b/src/documentation/docbook-xsl/params/olink.lang.fallback.sequence.xml new file mode 100644 index 0000000000..b7aea9eef9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/olink.lang.fallback.sequence.xml @@ -0,0 +1,77 @@ + + +olink.lang.fallback.sequence +string + + +olink.lang.fallback.sequence +look up translated documents if olink not found? + + + + + + +Description + +This parameter defines a list of lang values +to search among to resolve olinks. + + +Normally an olink tries to resolve to a document in the same +language as the olink itself. The language of an olink +is determined by its nearest ancestor element with a +lang attribute, otherwise the +value of the l10n.gentext.default.lang +parameter. + + +An olink database can contain target data for the same +document in multiple languages. Each set of data has the +same value for the targetdoc attribute in +the document element in the database, but with a +different lang attribute value. + + +When an olink is being resolved, the target is first +sought in the document with the same language as the olink. +If no match is found there, then this parameter is consulted +for additional languages to try. + +The olink.lang.fallback.sequence +must be a whitespace separated list of lang values to +try. The first one with a match in the olink database is used. +The default value is empty. + +For example, a document might be written in German +and contain an olink with +targetdoc="adminguide". +When the document is processed, the processor +first looks for a target dataset in the +olink database starting with: + +<document targetdoc="adminguide" lang="de">. + + +If there is no such element, then the +olink.lang.fallback.sequence +parameter is consulted. +If its value is, for example, fr en, then the processor next +looks for targetdoc="adminguide" lang="fr", and +then for targetdoc="adminguide" lang="en". +If there is still no match, it looks for +targetdoc="adminguide" with no +lang attribute. + + +This parameter is useful when a set of documents is only +partially translated, or is in the process of being translated. +If a target of an olink has not yet been translated, then this +parameter permits the processor to look for the document in +other languages. This assumes the reader would rather have +a link to a document in a different language than to have +a broken link. + + + + diff --git a/src/documentation/docbook-xsl/params/olink.outline.ext.xml b/src/documentation/docbook-xsl/params/olink.outline.ext.xml new file mode 100644 index 0000000000..f0ac801bf7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/olink.outline.ext.xml @@ -0,0 +1,20 @@ + + +olink.outline.ext +string + + +olink.outline.ext +The extension of OLink outline files + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/olink.properties.xml b/src/documentation/docbook-xsl/params/olink.properties.xml new file mode 100644 index 0000000000..7797bd05de --- /dev/null +++ b/src/documentation/docbook-xsl/params/olink.properties.xml @@ -0,0 +1,23 @@ + + +olink.properties +Properties associated with the cross-reference +text of an olink. + + + + + + + + + +Description + +This attribute set is used on cross reference text +from an olink. It is not applied to the +optional page number or +optional title of the external document. + + + diff --git a/src/documentation/docbook-xsl/params/olink.pubid.xml b/src/documentation/docbook-xsl/params/olink.pubid.xml new file mode 100644 index 0000000000..1b22818168 --- /dev/null +++ b/src/documentation/docbook-xsl/params/olink.pubid.xml @@ -0,0 +1,20 @@ + + +olink.pubid +string + + +olink.pubid +Names the public identifier portion of an OLink resolver query + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/olink.resolver.xml b/src/documentation/docbook-xsl/params/olink.resolver.xml new file mode 100644 index 0000000000..5926a16dc1 --- /dev/null +++ b/src/documentation/docbook-xsl/params/olink.resolver.xml @@ -0,0 +1,20 @@ + + +olink.resolver + + + +olink.resolver +The root name of the OLink resolver (usually a script) + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/olink.sysid.xml b/src/documentation/docbook-xsl/params/olink.sysid.xml new file mode 100644 index 0000000000..cc6f3bc4d3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/olink.sysid.xml @@ -0,0 +1,20 @@ + + +olink.sysid +string + + +olink.sysid +Names the system identifier portion of an OLink resolver query + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/orderedlist.label.properties.xml b/src/documentation/docbook-xsl/params/orderedlist.label.properties.xml new file mode 100644 index 0000000000..ca7d4752d8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/orderedlist.label.properties.xml @@ -0,0 +1,17 @@ + + +orderedlist.label.properties +Properties that apply to each label inside ordered list. + + + + + + +Description +Properties that apply to each label inside ordered list. E.g.: + + right +]]> + + diff --git a/src/documentation/docbook-xsl/params/orderedlist.label.width.xml b/src/documentation/docbook-xsl/params/orderedlist.label.width.xml new file mode 100644 index 0000000000..88bed0f848 --- /dev/null +++ b/src/documentation/docbook-xsl/params/orderedlist.label.width.xml @@ -0,0 +1,19 @@ + + +orderedlist.label.width +The default width of the label (number) in an ordered list. + + + + + + + + +Description +Specifies the default width of the label (usually a number or +sequence of numbers) in an ordered list. You can override the default +value on any particular list with the “dbfo” processing instruction +using the “label-width” pseudoattribute. + + diff --git a/src/documentation/docbook-xsl/params/orderedlist.properties.xml b/src/documentation/docbook-xsl/params/orderedlist.properties.xml new file mode 100644 index 0000000000..fb8303a6d9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/orderedlist.properties.xml @@ -0,0 +1,15 @@ + + +orderedlist.properties +Properties that apply to each list-block generated by orderedlist. + + + + + 2em + + +Description +Properties that apply to each fo:list-block generated by orderedlist. + + diff --git a/src/documentation/docbook-xsl/params/page.height.portrait.xml b/src/documentation/docbook-xsl/params/page.height.portrait.xml new file mode 100644 index 0000000000..cffafd9c90 --- /dev/null +++ b/src/documentation/docbook-xsl/params/page.height.portrait.xml @@ -0,0 +1,64 @@ + + +page.height.portrait + + + +page.height.portrait +Specify the physical size of the long edge of the page + + + + + + 210mm + 11in + 8.5in + 2378mm + 1682mm + 1189mm + 841mm + 594mm + 420mm + 297mm + 210mm + 148mm + 105mm + 74mm + 52mm + 37mm + 1414mm + 1000mm + 707mm + 500mm + 353mm + 250mm + 176mm + 125mm + 88mm + 62mm + 44mm + 1297mm + 917mm + 648mm + 458mm + 324mm + 229mm + 162mm + 114mm + 81mm + 57mm + 40mm + 11in + + + + +Description + +The portrait page height is the length of the long +edge of the physical page. + + + + diff --git a/src/documentation/docbook-xsl/params/page.height.xml b/src/documentation/docbook-xsl/params/page.height.xml new file mode 100644 index 0000000000..02ce412cad --- /dev/null +++ b/src/documentation/docbook-xsl/params/page.height.xml @@ -0,0 +1,32 @@ + + +page.height + + + +page.height +The height of the physical page + + + + + + + + + + + + + + + +Description + +The page height is generally calculated from the +paper.type and +page.orientation. + + + + diff --git a/src/documentation/docbook-xsl/params/page.margin.bottom.xml b/src/documentation/docbook-xsl/params/page.margin.bottom.xml new file mode 100644 index 0000000000..1a3b29fba3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/page.margin.bottom.xml @@ -0,0 +1,24 @@ + + +page.margin.bottom + + + +page.margin.bottom +The bottom margin of the page + + + + + + + + +Description + +The bottom page margin is the distance from the bottom of the region-after +to the physical bottom of the page. + + + + diff --git a/src/documentation/docbook-xsl/params/page.margin.inner.xml b/src/documentation/docbook-xsl/params/page.margin.inner.xml new file mode 100644 index 0000000000..cb3b3b8d2c --- /dev/null +++ b/src/documentation/docbook-xsl/params/page.margin.inner.xml @@ -0,0 +1,30 @@ + + +page.margin.inner + + + +page.margin.inner +The inner page margin + + + + + + 1.25in + 1in + + + + +Description + +The inner page margin is the distance from binding edge of the +page to the first column of text. In the left-to-right, top-to-bottom writing +direction, this is the left margin of recto pages. +The inner and outer margins are usually the same unless the output +is double-sided. + + + + diff --git a/src/documentation/docbook-xsl/params/page.margin.outer.xml b/src/documentation/docbook-xsl/params/page.margin.outer.xml new file mode 100644 index 0000000000..d66e11a6d7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/page.margin.outer.xml @@ -0,0 +1,30 @@ + + +page.margin.outer + + + +page.margin.outer +The outer page margin + + + + + + 0.75in + 1in + + + + +Description + +The outer page margin is the distance from non-binding edge of the +page to the last column of text. In the left-to-right, top-to-bottom writing +direction, this is the right margin of recto pages. +The inner and outer margins are usually the same unless the output +is double-sided. + + + + diff --git a/src/documentation/docbook-xsl/params/page.margin.top.xml b/src/documentation/docbook-xsl/params/page.margin.top.xml new file mode 100644 index 0000000000..5c98bb5b4d --- /dev/null +++ b/src/documentation/docbook-xsl/params/page.margin.top.xml @@ -0,0 +1,23 @@ + + +page.margin.top + + + +page.margin.top +The top margin of the page + + + + + + + + +Description + +The top page margin is the distance from the physical top of the +page to the top of the region-before. + + + diff --git a/src/documentation/docbook-xsl/params/page.orientation.xml b/src/documentation/docbook-xsl/params/page.orientation.xml new file mode 100644 index 0000000000..22871ff03f --- /dev/null +++ b/src/documentation/docbook-xsl/params/page.orientation.xml @@ -0,0 +1,22 @@ + + +page.orientation + + + +page.orientation +Select the page orientation + + + + + + +Description + +In portrait orientation, the short edge is horizontal; in +landscape orientation, it is vertical. + + + + diff --git a/src/documentation/docbook-xsl/params/page.width.portrait.xml b/src/documentation/docbook-xsl/params/page.width.portrait.xml new file mode 100644 index 0000000000..a00584e18a --- /dev/null +++ b/src/documentation/docbook-xsl/params/page.width.portrait.xml @@ -0,0 +1,62 @@ + + +page.width.portrait + + + +page.width.portrait +Specify the physical size of the short edge of the page + + + + + + 8.5in + 1682mm + 1189mm + 841mm + 594mm + 420mm + 297mm + 210mm + 148mm + 105mm + 74mm + 52mm + 37mm + 26mm + 1000mm + 707mm + 500mm + 353mm + 250mm + 176mm + 125mm + 88mm + 62mm + 44mm + 31mm + 917mm + 648mm + 458mm + 324mm + 229mm + 162mm + 114mm + 81mm + 57mm + 40mm + 28mm + 8.5in + + + + +Description + +The portrait page width is the length of the short +edge of the physical page. + + + + diff --git a/src/documentation/docbook-xsl/params/page.width.xml b/src/documentation/docbook-xsl/params/page.width.xml new file mode 100644 index 0000000000..8c3f7b8562 --- /dev/null +++ b/src/documentation/docbook-xsl/params/page.width.xml @@ -0,0 +1,31 @@ + + +page.width + + + +page.width +The width of the physical page + + + + + + + + + + + + + + + +Description + +The page width is generally calculated from the +paper.type and page.orientation. + + + + diff --git a/src/documentation/docbook-xsl/params/pages.template.xml b/src/documentation/docbook-xsl/params/pages.template.xml new file mode 100644 index 0000000000..1c90bebced --- /dev/null +++ b/src/documentation/docbook-xsl/params/pages.template.xml @@ -0,0 +1,23 @@ + + +pages.template + + +pages.template +Specify the template Pages document + + + + + + + + +Description + +The pages.template parameter specifies a Pages (the Apple word processing application) document to use as a template for the generated document. The template document is used to define the (extensive) headers for the generated document, in particular the paragraph and character styles that are used to format the various elements. Any content in the template document is ignored. + +A template document is used in order to allow maintenance of the paragraph and character styles to be done using Pages itself, rather than these XSL stylesheets. + + + diff --git a/src/documentation/docbook-xsl/params/paper.type.xml b/src/documentation/docbook-xsl/params/paper.type.xml new file mode 100644 index 0000000000..f9092516b9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/paper.type.xml @@ -0,0 +1,23 @@ + + +paper.type + + + +paper.type +Select the paper type + + + + + + +Description + +The paper type is a convenient way to specify the paper size. +The list of known paper sizes includes USletter and most of the A, +B, and C sizes. See page.width.portrait, for example. + + + + diff --git a/src/documentation/docbook-xsl/params/para.propagates.style.xml b/src/documentation/docbook-xsl/params/para.propagates.style.xml new file mode 100644 index 0000000000..81dbd11cb9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/para.propagates.style.xml @@ -0,0 +1,24 @@ + + +para.propagates.style +boolean + + +para.propagates.style +Pass para role attribute through to HTML? + + + + + + + + +Description + +If true, the role attribute of para elements +will be passed through to the HTML as a class attribute on the +p generated for the paragraph. + + + diff --git a/src/documentation/docbook-xsl/params/part.autolabel.xml b/src/documentation/docbook-xsl/params/part.autolabel.xml new file mode 100644 index 0000000000..e6c3643a61 --- /dev/null +++ b/src/documentation/docbook-xsl/params/part.autolabel.xml @@ -0,0 +1,61 @@ + + +part.autolabel +boolean + + +part.autolabel +Specifies the labeling format for Part titles + + + + + + +Description + +If zero, then parts will not be numbered. +Otherwise parts will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperroman). + + + + + diff --git a/src/documentation/docbook-xsl/params/passivetex.extensions.xml b/src/documentation/docbook-xsl/params/passivetex.extensions.xml new file mode 100644 index 0000000000..e5430e5579 --- /dev/null +++ b/src/documentation/docbook-xsl/params/passivetex.extensions.xml @@ -0,0 +1,26 @@ + + +passivetex.extensions +boolean + + +passivetex.extensions +Enable PassiveTeX extensions? + + + + + + +Description + +If non-zero, +PassiveTeX +extensions will be used. At present, this consists of PDF bookmarks +and sorted index terms. + + +This parameter can also affect which graphics file formats +are supported + + diff --git a/src/documentation/docbook-xsl/params/pgwide.properties.xml b/src/documentation/docbook-xsl/params/pgwide.properties.xml new file mode 100644 index 0000000000..e3aa8e9428 --- /dev/null +++ b/src/documentation/docbook-xsl/params/pgwide.properties.xml @@ -0,0 +1,43 @@ + + +pgwide.properties +Properties to make a figure or table page wide. + + + + + + + 0pt + + + + +Description + +This attribute set is used to set the properties +that make a figure or table "page wide" in fo output. +It comes into effect when an attribute pgwide="1" +is used. + + + +By default, it sets start-indent +to 0pt. +In a stylesheet that sets the parameter +body.start.indent +to a non-zero value in order to indent body text, +this attribute set can be used to outdent pgwide +figures to the left margin. + + +If a document uses a multi-column page layout, +then this attribute set could try setting span +to a value of all. However, this may +not work with some processors because a span property must be on an +fo:block that is a direct child of fo:flow. It may work in +some processors anyway. + + + + diff --git a/src/documentation/docbook-xsl/params/phrase.propagates.style.xml b/src/documentation/docbook-xsl/params/phrase.propagates.style.xml new file mode 100644 index 0000000000..ad17380ee0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/phrase.propagates.style.xml @@ -0,0 +1,22 @@ + + +phrase.propagates.style +boolean + + +phrase.propagates.style +Pass phrase role attribute through to HTML? + + + + + + +Description + +If true, the role attribute of phrase elements +will be passed through to the HTML as a class attribute on a +span that surrounds the phrase. + + + diff --git a/src/documentation/docbook-xsl/params/pixels.per.inch.xml b/src/documentation/docbook-xsl/params/pixels.per.inch.xml new file mode 100644 index 0000000000..dbce98a62d --- /dev/null +++ b/src/documentation/docbook-xsl/params/pixels.per.inch.xml @@ -0,0 +1,26 @@ + + +pixels.per.inch +integer + + +pixels.per.inch +How many pixels are there per inch? + + + + + + + + +Description + +When lengths are converted to pixels, this value is used to +determine the size of a pixel. The default value is taken from the +XSL +Recommendation. + + + + diff --git a/src/documentation/docbook-xsl/params/points.per.em.xml b/src/documentation/docbook-xsl/params/points.per.em.xml new file mode 100644 index 0000000000..17d1ac27fe --- /dev/null +++ b/src/documentation/docbook-xsl/params/points.per.em.xml @@ -0,0 +1,22 @@ + + +points.per.em +number + + +points.per.em +Specify the nominal size of an em-space in points + + + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/preface.autolabel.xml b/src/documentation/docbook-xsl/params/preface.autolabel.xml new file mode 100644 index 0000000000..1d0381d898 --- /dev/null +++ b/src/documentation/docbook-xsl/params/preface.autolabel.xml @@ -0,0 +1,61 @@ + + +preface.autolabel +boolean + + +preface.autolabel +Specifices the labeling format for Preface titles + + + + + + +Description + +If zero (default), then prefaces will not be numbered. +Otherwise prefaces will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + + diff --git a/src/documentation/docbook-xsl/params/prefer.internal.olink.xml b/src/documentation/docbook-xsl/params/prefer.internal.olink.xml new file mode 100644 index 0000000000..86c2fe3f05 --- /dev/null +++ b/src/documentation/docbook-xsl/params/prefer.internal.olink.xml @@ -0,0 +1,73 @@ + + +prefer.internal.olink +boolean + + +prefer.internal.olink +Prefer a local olink reference to an external reference + + + + + + + + +Description + +If you are re-using XML content modules in multiple documents, +you may want to redirect some of your olinks. This parameter +permits you to redirect an olink to the current document. + + +For example: you are writing documentation for a product, +which includes 3 manuals: a little installation +booklet (booklet.xml), a user +guide (user.xml), and a reference manual (reference.xml). +All 3 documents begin with the same introduction section (intro.xml) that +contains a reference to the customization section (custom.xml) which is +included in both user.xml and reference.xml documents. + + +How do you write the link to custom.xml in intro.xml +so that it is interpreted correctly in all 3 documents? + +If you use xref, it will fail in user.xml. + +If you use olink (pointing to reference.xml), +the reference in user.xml +will point to the customization section of the reference manual, while it is +actually available in user.xml. + + + +If you set the prefer.internal.olink +parameter to a non-zero value, then the processor will +first look in the olink database +for the olink's targetptr attribute value +in document matching the current.docid +parameter value. If it isn't found there, then +it tries the document in the database +with the targetdoc +value that matches the olink's targetdoc +attribute. + + +This feature permits an olink reference to resolve to +the current document if there is an element +with an id matching the olink's targetptr +value. The current document's olink data must be +included in the target database for this to work. + + +There is a potential for incorrect links if +the same id attribute value is used for different +content in different documents. +Some of your olinks may be redirected to the current document +when they shouldn't be. It is not possible to control +individual olink instances. + + + + diff --git a/src/documentation/docbook-xsl/params/preferred.mediaobject.role.xml b/src/documentation/docbook-xsl/params/preferred.mediaobject.role.xml new file mode 100644 index 0000000000..7c664c5c10 --- /dev/null +++ b/src/documentation/docbook-xsl/params/preferred.mediaobject.role.xml @@ -0,0 +1,33 @@ + + +preferred.mediaobject.role + + +preferred.mediaobject.role +Select which mediaobject to use based on +this value of an object's role attribute. + + + + + + + + + +Description + +A mediaobject may contain several objects such as imageobjects. +If the parameter use.role.for.mediaobject +is non-zero, then the role attribute on +imageobjects and other objects within a mediaobject container will be used to select which object will be +used. If one of the objects has a role value that matches the +preferred.mediaobject.role parameter, then it has first +priority for selection. If more than one has such a +role value, the first one is used. + + +See the use.role.for.mediaobject parameter +for the sequence of selection. + + diff --git a/src/documentation/docbook-xsl/params/procedure.properties.xml b/src/documentation/docbook-xsl/params/procedure.properties.xml new file mode 100644 index 0000000000..b8dcbfefe4 --- /dev/null +++ b/src/documentation/docbook-xsl/params/procedure.properties.xml @@ -0,0 +1,18 @@ + + +procedure.properties +Properties associated with a procedure + + + + + + + + +Description + +The styling for procedures. + + + diff --git a/src/documentation/docbook-xsl/params/process.empty.source.toc.xml b/src/documentation/docbook-xsl/params/process.empty.source.toc.xml new file mode 100644 index 0000000000..933d145606 --- /dev/null +++ b/src/documentation/docbook-xsl/params/process.empty.source.toc.xml @@ -0,0 +1,33 @@ + + +process.empty.source.toc +boolean + + +process.empty.source.toc +Generate automated TOC if toc element occurs in a source document? + + + + + + +Description + +Specifies that if an empty toc element is +found in a source document, an automated TOC is generated. + + Depending on what the value of the + generate.toc parameter is, setting this + parameter to 1 could result in generation of + duplicate automated TOCs. So the + process.empty.source.toc is primarily useful + as an "override": by placing an empty toc in your + document and setting this parameter to 1, you can + force a TOC to be generated even if generate.toc + says not to. + + + + + diff --git a/src/documentation/docbook-xsl/params/process.source.toc.xml b/src/documentation/docbook-xsl/params/process.source.toc.xml new file mode 100644 index 0000000000..a1d254b4e0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/process.source.toc.xml @@ -0,0 +1,34 @@ + + +process.source.toc +boolean + + +process.source.toc +Process a non-empty toc element if it occurs in a source document? + + + + + + +Description + +Specifies that the contents of a non-empty "hard-coded" +toc element in a source document are processed to +generate a TOC in output. + + This parameter has no effect on automated generation of + TOCs. An automated TOC may still be generated along with the + "hard-coded" TOC. To suppress automated TOC generation, adjust the + value of the generate.toc paramameter. + + The process.source.toc parameter also has + no effect if the toc element is empty; handling + for empty toc is controlled by the + process.empty.source.toc parameter. + + + + + diff --git a/src/documentation/docbook-xsl/params/profile.arch.xml b/src/documentation/docbook-xsl/params/profile.arch.xml new file mode 100644 index 0000000000..d29cb9c862 --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.arch.xml @@ -0,0 +1,33 @@ + + +profile.arch +string + + +profile.arch +Target profile for arch +attribute + + + + + + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/profile.attribute.xml b/src/documentation/docbook-xsl/params/profile.attribute.xml new file mode 100644 index 0000000000..5653723237 --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.attribute.xml @@ -0,0 +1,29 @@ + + +profile.attribute +string + + +profile.attribute +Name of user-specified profiling attribute + + + + + + + + +Description + +This parameter is used in conjuction with profile.value. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/profile.condition.xml b/src/documentation/docbook-xsl/params/profile.condition.xml new file mode 100644 index 0000000000..f8e7753b05 --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.condition.xml @@ -0,0 +1,33 @@ + + +profile.condition +string + + +profile.condition +Target profile for condition +attribute + + + + + + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/profile.conformance.xml b/src/documentation/docbook-xsl/params/profile.conformance.xml new file mode 100644 index 0000000000..1b4441e46e --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.conformance.xml @@ -0,0 +1,33 @@ + + +profile.conformance +string + + +profile.conformance +Target profile for conformance +attribute + + + + + + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/profile.lang.xml b/src/documentation/docbook-xsl/params/profile.lang.xml new file mode 100644 index 0000000000..97961383ab --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.lang.xml @@ -0,0 +1,33 @@ + + +profile.lang +string + + +profile.lang +Target profile for lang +attribute + + + + + + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/profile.os.xml b/src/documentation/docbook-xsl/params/profile.os.xml new file mode 100644 index 0000000000..45172a5960 --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.os.xml @@ -0,0 +1,33 @@ + + +profile.os +string + + +profile.os +Target profile for os +attribute + + + + + + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/profile.revision.xml b/src/documentation/docbook-xsl/params/profile.revision.xml new file mode 100644 index 0000000000..ea4769d62e --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.revision.xml @@ -0,0 +1,33 @@ + + +profile.revision +string + + +profile.revision +Target profile for revision +attribute + + + + + + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/profile.revisionflag.xml b/src/documentation/docbook-xsl/params/profile.revisionflag.xml new file mode 100644 index 0000000000..5a443731b2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.revisionflag.xml @@ -0,0 +1,33 @@ + + +profile.revisionflag +string + + +profile.revisionflag +Target profile for revisionflag +attribute + + + + + + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/profile.role.xml b/src/documentation/docbook-xsl/params/profile.role.xml new file mode 100644 index 0000000000..6f223528b7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.role.xml @@ -0,0 +1,54 @@ + + +profile.role +string + + +profile.role +Target profile for role +attribute + + + + + + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + +Note that role is often +used for other purposes than profiling. For example it is commonly +used to get emphasize in bold font: + +very important]]> + +If you are using role for +these purposes do not forget to add values like bold to +value of this parameter. If you forgot you will get document with +small pieces missing which are very hard to track. + +For this reason it is not recommended to use role attribute for profiling. You should +rather use profiling specific attributes like userlevel, os, arch, condition, etc. + + + + diff --git a/src/documentation/docbook-xsl/params/profile.security.xml b/src/documentation/docbook-xsl/params/profile.security.xml new file mode 100644 index 0000000000..935363238e --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.security.xml @@ -0,0 +1,33 @@ + + +profile.security +string + + +profile.security +Target profile for security +attribute + + + + + + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/profile.separator.xml b/src/documentation/docbook-xsl/params/profile.separator.xml new file mode 100644 index 0000000000..f48fd02e86 --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.separator.xml @@ -0,0 +1,22 @@ + + +profile.separator +string + + +profile.separator +Separator character for compound profile values + + + + + + + + +Description + +Separator character for compound profile values. + + + diff --git a/src/documentation/docbook-xsl/params/profile.userlevel.xml b/src/documentation/docbook-xsl/params/profile.userlevel.xml new file mode 100644 index 0000000000..d2aeae00fe --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.userlevel.xml @@ -0,0 +1,33 @@ + + +profile.userlevel +string + + +profile.userlevel +Target profile for userlevel +attribute + + + + + + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/profile.value.xml b/src/documentation/docbook-xsl/params/profile.value.xml new file mode 100644 index 0000000000..c22c5c96e0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.value.xml @@ -0,0 +1,36 @@ + + +profile.value +string + + +profile.value +Target profile for user-specified attribute + + + + + + + + +Description + +When you are using this parameter you must also specify name of +profiling attribute with parameter profile.attribute. + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/profile.vendor.xml b/src/documentation/docbook-xsl/params/profile.vendor.xml new file mode 100644 index 0000000000..06800d8d17 --- /dev/null +++ b/src/documentation/docbook-xsl/params/profile.vendor.xml @@ -0,0 +1,33 @@ + + +profile.vendor +string + + +profile.vendor +Target profile for vendor +attribute + + + + + + + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + diff --git a/src/documentation/docbook-xsl/params/punct.honorific.xml b/src/documentation/docbook-xsl/params/punct.honorific.xml new file mode 100644 index 0000000000..c34143c764 --- /dev/null +++ b/src/documentation/docbook-xsl/params/punct.honorific.xml @@ -0,0 +1,23 @@ + + +punct.honorific +string + + +punct.honorific +Punctuation after an honorific in a personal name. + + + + + + + + +Description + +This parameter specifies the punctuation that should be added after an +honorific in a personal name. + + + diff --git a/src/documentation/docbook-xsl/params/qanda.defaultlabel.xml b/src/documentation/docbook-xsl/params/qanda.defaultlabel.xml new file mode 100644 index 0000000000..58b0f8ae56 --- /dev/null +++ b/src/documentation/docbook-xsl/params/qanda.defaultlabel.xml @@ -0,0 +1,23 @@ + + +qanda.defaultlabel +boolean + + +qanda.defaultlabel +Sets the default for defaultlabel on QandASet. + + + +number + + +Description + +If no defaultlabel attribute is specified on a QandASet, this +value is used. It must be one of the legal values for the defaultlabel +attribute. + + + + diff --git a/src/documentation/docbook-xsl/params/qanda.inherit.numeration.xml b/src/documentation/docbook-xsl/params/qanda.inherit.numeration.xml new file mode 100644 index 0000000000..9005355155 --- /dev/null +++ b/src/documentation/docbook-xsl/params/qanda.inherit.numeration.xml @@ -0,0 +1,22 @@ + + +qanda.inherit.numeration +boolean + + +qanda.inherit.numeration +Does enumeration of QandASet components inherit the numeration of parent elements? + + + + + + +Description + +If true (non-zero), numbered QandADiv elements and Questions and Answers inherit +the numeration of the ancestors of the QandASet. + + + + diff --git a/src/documentation/docbook-xsl/params/qanda.title.level1.properties.xml b/src/documentation/docbook-xsl/params/qanda.title.level1.properties.xml new file mode 100644 index 0000000000..600687a947 --- /dev/null +++ b/src/documentation/docbook-xsl/params/qanda.title.level1.properties.xml @@ -0,0 +1,27 @@ + + +qanda.title.level1.properties +attribute set + + +qanda.title.level1.properties +Properties for level-1 qanda set titles + + + + + + + + pt + + + + + +Description + +The properties of level-1 qanda set titles. + + + diff --git a/src/documentation/docbook-xsl/params/qanda.title.level2.properties.xml b/src/documentation/docbook-xsl/params/qanda.title.level2.properties.xml new file mode 100644 index 0000000000..d6800bc10e --- /dev/null +++ b/src/documentation/docbook-xsl/params/qanda.title.level2.properties.xml @@ -0,0 +1,27 @@ + + +qanda.title.level2.properties +attribute set + + +qanda.title.level2.properties +Properties for level-2 qanda set titles + + + + + + + + pt + + + + + +Description + +The properties of level-2 qanda set titles. + + + diff --git a/src/documentation/docbook-xsl/params/qanda.title.level3.properties.xml b/src/documentation/docbook-xsl/params/qanda.title.level3.properties.xml new file mode 100644 index 0000000000..ef793442d1 --- /dev/null +++ b/src/documentation/docbook-xsl/params/qanda.title.level3.properties.xml @@ -0,0 +1,27 @@ + + +qanda.title.level3.properties +attribute set + + +qanda.title.level3.properties +Properties for level-3 qanda set titles + + + + + + + + pt + + + + + +Description + +The properties of level-3 qanda set titles. + + + diff --git a/src/documentation/docbook-xsl/params/qanda.title.level4.properties.xml b/src/documentation/docbook-xsl/params/qanda.title.level4.properties.xml new file mode 100644 index 0000000000..599edf7a46 --- /dev/null +++ b/src/documentation/docbook-xsl/params/qanda.title.level4.properties.xml @@ -0,0 +1,27 @@ + + +qanda.title.level4.properties +attribute set + + +qanda.title.level4.properties +Properties for level-4 qanda set titles + + + + + + + + pt + + + + + +Description + +The properties of level-4 qanda set titles. + + + diff --git a/src/documentation/docbook-xsl/params/qanda.title.level5.properties.xml b/src/documentation/docbook-xsl/params/qanda.title.level5.properties.xml new file mode 100644 index 0000000000..560ef31ed4 --- /dev/null +++ b/src/documentation/docbook-xsl/params/qanda.title.level5.properties.xml @@ -0,0 +1,27 @@ + + +qanda.title.level5.properties +attribute set + + +qanda.title.level5.properties +Properties for level-5 qanda set titles + + + + + + + + pt + + + + + +Description + +The properties of level-5 qanda set titles. + + + diff --git a/src/documentation/docbook-xsl/params/qanda.title.level6.properties.xml b/src/documentation/docbook-xsl/params/qanda.title.level6.properties.xml new file mode 100644 index 0000000000..6864172e46 --- /dev/null +++ b/src/documentation/docbook-xsl/params/qanda.title.level6.properties.xml @@ -0,0 +1,29 @@ + + +qanda.title.level6.properties +attribute set + + +qanda.title.level6.properties +Properties for level-6 qanda set titles + + + + + + + + pt + + + + + +Description + +The properties of level-6 qanda set titles. +This property set is actually +used for all titles below level 5. + + + diff --git a/src/documentation/docbook-xsl/params/qanda.title.properties.xml b/src/documentation/docbook-xsl/params/qanda.title.properties.xml new file mode 100644 index 0000000000..0e580c7c09 --- /dev/null +++ b/src/documentation/docbook-xsl/params/qanda.title.properties.xml @@ -0,0 +1,33 @@ + + +qanda.title.properties +attribute set + + +qanda.title.properties +Properties for qanda set titles + + + + + + + + + bold + + always + 0.8em + 1.0em + 1.2em + + + + +Description + +The properties common to all qanda set titles. + + + + diff --git a/src/documentation/docbook-xsl/params/qandadiv.autolabel.xml b/src/documentation/docbook-xsl/params/qandadiv.autolabel.xml new file mode 100644 index 0000000000..a3a62c4584 --- /dev/null +++ b/src/documentation/docbook-xsl/params/qandadiv.autolabel.xml @@ -0,0 +1,21 @@ + + +qandadiv.autolabel +boolean + + +qandadiv.autolabel +Are divisions in QAndASets enumerated? + + + + + + +Description + +If true (non-zero), unlabeled qandadivs will be enumerated. + + + + diff --git a/src/documentation/docbook-xsl/params/refclass.suppress.xml b/src/documentation/docbook-xsl/params/refclass.suppress.xml new file mode 100644 index 0000000000..b2ab620b19 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refclass.suppress.xml @@ -0,0 +1,23 @@ + + +refclass.suppress +boolean + + +refclass.suppress +Suppress display of refclass contents? + + + + + + + +Description + +If the value of refclass.suppress is +non-zero, then display of refclass contents is +suppressed in output. + + + diff --git a/src/documentation/docbook-xsl/params/refentry.date.profile.enabled.xml b/src/documentation/docbook-xsl/params/refentry.date.profile.enabled.xml new file mode 100644 index 0000000000..6a5f2d2bf0 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.date.profile.enabled.xml @@ -0,0 +1,41 @@ + + +refentry.date.profile.enabled +boolean + + +refentry.date.profile.enabled +Enable refentry "date" profiling? + + + + +0 + + +Description + +If the value of +refentry.date.profile.enabled is non-zero, then +during refentry metadata gathering, the info profile +specified by the customizable +refentry.date.profile parameter is used. + +If instead the value of +refentry.date.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "date" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "date" data to show +up in your output, then consider setting a non-zero value for +refentry.date.profile.enabled and adjusting the +value of refentry.date.profile to cause correct +data to be gathered. + +Note that the terms "source" and "date" have special meanings in +this context. For details, see the documentation for the +refentry.date.profile parameter. + + + diff --git a/src/documentation/docbook-xsl/params/refentry.date.profile.xml b/src/documentation/docbook-xsl/params/refentry.date.profile.xml new file mode 100644 index 0000000000..ce51de15d2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.date.profile.xml @@ -0,0 +1,33 @@ + + +refentry.date.profile +string + + +refentry.date.profile +Specifies profile for refentry "date" data + + + + + + (($info[//date])[last()]/date)[1]| + (($info[//pubdate])[last()]/pubdate)[1] + + + + +Description + +The value of refentry.date.profile is a +string representing an XPath expression. It is evaluated at run-time +and used only if refentry.date.profile.enabled +is non-zero. Otherwise, the refentry metadata-gathering +logic "hard coded" into the stylesheets is used. + + The man(7) man page describes this content +as "the date of the last revision". In man pages, it is the content +that is usually displayed in the center footer. + + + diff --git a/src/documentation/docbook-xsl/params/refentry.generate.name.xml b/src/documentation/docbook-xsl/params/refentry.generate.name.xml new file mode 100644 index 0000000000..f2b714f1f6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.generate.name.xml @@ -0,0 +1,26 @@ + + +refentry.generate.name +boolean + + +refentry.generate.name +Output NAME header before 'RefName'(s)? + + + + + + +Description + +If true (non-zero), a "NAME" section title is output before the list +of 'RefName's. This parameter and +refentry.generate.title are mutually +exclusive. This means that if you change this parameter to zero, you +should set refentry.generate.title to 1 unless +you want get quite strange output. + + + + diff --git a/src/documentation/docbook-xsl/params/refentry.generate.title.xml b/src/documentation/docbook-xsl/params/refentry.generate.title.xml new file mode 100644 index 0000000000..6c3936235d --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.generate.title.xml @@ -0,0 +1,28 @@ + + +refentry.generate.title +boolean + + +refentry.generate.title +Output title before 'RefName'(s)? + + + + + + + + +Description + +If true (non-zero), the reference page title or first name is +output before the list of 'RefName's. This parameter and +refentry.generate.name are mutually exclusive. +This means that if you change this parameter to 1, you +should set refentry.generate.name to 0 unless +you want get quite strange output. + + + + diff --git a/src/documentation/docbook-xsl/params/refentry.manual.fallback.profile.xml b/src/documentation/docbook-xsl/params/refentry.manual.fallback.profile.xml new file mode 100644 index 0000000000..ce137428b3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.manual.fallback.profile.xml @@ -0,0 +1,43 @@ + + +refentry.manual.fallback.profile +string + + +refentry.manual.fallback.profile +Specifies profile of "fallback" for refentry "manual" data + + + + + +refmeta/refmiscinfo[1]/node() + + + +Description + +The value of +refentry.manual.fallback.profile is a string +representing an XPath expression. It is evaluated at run-time and +used only if no "manual" data can be found by other means (that is, +either using the refentry metadata-gathering logic "hard +coded" in the stylesheets, or the value of +refentry.manual.profile, if it is +enabled). + + +Depending on which XSLT engine you run, either the EXSLT +dyn:evaluate extension function (for xsltproc or +Xalan) or saxon:evaluate extension function (for +Saxon) are used to dynamically evaluate the value of +refentry.manual.fallback.profile at +run-time. If you don't use xsltproc, Saxon, Xalan -- or some other +XSLT engine that supports dyn:evaluate -- you +must manually disable fallback processing by setting an empty value +for the refentry.manual.fallback.profile +parameter. + + + + diff --git a/src/documentation/docbook-xsl/params/refentry.manual.profile.enabled.xml b/src/documentation/docbook-xsl/params/refentry.manual.profile.enabled.xml new file mode 100644 index 0000000000..3e346dcd07 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.manual.profile.enabled.xml @@ -0,0 +1,42 @@ + + +refentry.manual.profile.enabled +boolean + + +refentry.manual.profile.enabled +Enable refentry "manual" profiling? + + + + +0 + + +Description + +If the value of +refentry.manual.profile.enabled is +non-zero, then during refentry metadata gathering, the info +profile specified by the customizable +refentry.manual.profile parameter is +used. + +If instead the value of +refentry.manual.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "manual" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "manual" data to show +up in your output, then consider setting a non-zero value for +refentry.manual.profile.enabled and adjusting +the value of refentry.manual.profile to cause +correct data to be gathered. + +Note that the term "manual" has a special meanings in this +context. For details, see the documentation for the +refentry.manual.profile parameter. + + + diff --git a/src/documentation/docbook-xsl/params/refentry.manual.profile.xml b/src/documentation/docbook-xsl/params/refentry.manual.profile.xml new file mode 100644 index 0000000000..be058e5a10 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.manual.profile.xml @@ -0,0 +1,67 @@ + + +refentry.manual.profile +string + + +refentry.manual.profile +Specifies profile for refentry "manual" data + + + + + + (($info[//title])[last()]/title)[1]| + ../title/node() + + + + +Description + +The value of refentry.manual.profile is +a string representing an XPath expression. It is evaluated at +run-time and used only if +refentry.manual.profile.enabled is +non-zero. Otherwise, the refentry metadata-gathering logic +"hard coded" into the stylesheets is used. + +In man pages, this content is usually displayed in the middle of +the header of the page. The man(7) man page +describes this as "the title of the manual (e.g., Linux +Programmer's Manual)". Here are some examples from +existing man pages: + + + dpkg utilities + (dpkg-name) + + + User Contributed Perl Documentation + (GET) + + + GNU Development Tools + (ld) + + + Emperor Norton Utilities + (ddate) + + + Debian GNU/Linux manual + (faked) + + + GIMP Manual Pages + (gimp) + + + KDOC Documentation System + (qt2kdoc) + + + + + + diff --git a/src/documentation/docbook-xsl/params/refentry.meta.get.quietly.xml b/src/documentation/docbook-xsl/params/refentry.meta.get.quietly.xml new file mode 100644 index 0000000000..04d75f424d --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.meta.get.quietly.xml @@ -0,0 +1,32 @@ + + +refentry.meta.get.quietly + + + +refentry.meta.get.quietly +Suppress notes and warnings when gathering refentry metadata? + + + + + + + + +Description + +If zero (the default), notes and warnings about “missing” markup +are generated during gathering of refentry metadata. If non-zero, the +metadata is gathered “quietly” -- that is, the notes and warnings are +suppressed. + + + If you are processing a large amount of refentry + content, you may be able to speed up processing significantly by + setting a non-zero value for + refentry.meta.get.quietly. + + + + diff --git a/src/documentation/docbook-xsl/params/refentry.pagebreak.xml b/src/documentation/docbook-xsl/params/refentry.pagebreak.xml new file mode 100644 index 0000000000..446c37a4bf --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.pagebreak.xml @@ -0,0 +1,28 @@ + + +refentry.pagebreak +boolean + + +refentry.pagebreak +Start each refentry on a new page + + + + + + +Description + +If non-zero (the default), each refentry +element will start on a new page. If zero, a page +break will not be generated between refentry elements. +The exception is when the refentry elements are children of +a part element, in which case the page breaks are always +retained. That is because a part element does not generate +a page-sequence for its children, so each refentry must +start its own page-sequence. + + + + diff --git a/src/documentation/docbook-xsl/params/refentry.separator.xml b/src/documentation/docbook-xsl/params/refentry.separator.xml new file mode 100644 index 0000000000..26d0ef0ffd --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.separator.xml @@ -0,0 +1,22 @@ + + +refentry.separator +boolean + + +refentry.separator +Generate a separator between consecutive RefEntry elements? + + + + + + +Description + +If true, a separator will be generated between consecutive +reference pages. + + + + diff --git a/src/documentation/docbook-xsl/params/refentry.source.fallback.profile.xml b/src/documentation/docbook-xsl/params/refentry.source.fallback.profile.xml new file mode 100644 index 0000000000..d574ff5759 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.source.fallback.profile.xml @@ -0,0 +1,44 @@ + + +refentry.source.fallback.profile +string + + +refentry.source.fallback.profile +Specifies profile of "fallback" for refentry "source" data + + + + + +refmeta/refmiscinfo[1]/node() + + + +Description + +The value of +refentry.source.fallback.profile is a string +representing an XPath expression. It is evaluated at run-time and used +only if no "source" data can be found by other means (that is, either +using the refentry metadata-gathering logic "hard coded" in +the stylesheets, or the value of the +refentry.source.name.profile and +refentry.version.profile parameters, if those +are enabled). + + +Depending on which XSLT engine you run, either the EXSLT +dyn:evaluate extension function (for xsltproc or +Xalan) or saxon:evaluate extension function (for +Saxon) are used to dynamically evaluate the value of +refentry.source.fallback.profile at +run-time. If you don't use xsltproc, Saxon, Xalan -- or some other +XSLT engine that supports dyn:evaluate -- you +must manually disable fallback processing by setting an empty value +for the refentry.source.fallback.profile +parameter. + + + + diff --git a/src/documentation/docbook-xsl/params/refentry.source.name.profile.enabled.xml b/src/documentation/docbook-xsl/params/refentry.source.name.profile.enabled.xml new file mode 100644 index 0000000000..09c7bc3046 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.source.name.profile.enabled.xml @@ -0,0 +1,43 @@ + + +refentry.source.name.profile.enabled +boolean + + +refentry.source.name.profile.enabled +Enable refentry "source name" profiling? + + + + +0 + + +Description + +If the value of +refentry.source.name.profile.enabled is +non-zero, then during refentry metadata gathering, the info +profile specified by the customizable +refentry.source.name.profile parameter is +used. + +If instead the value of +refentry.source.name.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "source name" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "source name" data to +show up in your output, then consider setting a non-zero value for +refentry.source.name.profile.enabled and +adjusting the value of +refentry.source.name.profile to cause correct +data to be gathered. + +Note that the terms "source" and "source name" have special +meanings in this context. For details, see the documentation for the +refentry.source.name.profile parameter. + + + diff --git a/src/documentation/docbook-xsl/params/refentry.source.name.profile.xml b/src/documentation/docbook-xsl/params/refentry.source.name.profile.xml new file mode 100644 index 0000000000..c07e667b2a --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.source.name.profile.xml @@ -0,0 +1,84 @@ + + +refentry.source.name.profile +string + + +refentry.source.name.profile +Specifies profile for refentry "source name" data + + + + + + (($info[//productname])[last()]/productname)[1]| + (($info[//corpname])[last()]/corpname)[1]| + (($info[//corpcredit])[last()]/corpcredit)[1]| + (($info[//corpauthor])[last()]/corpauthor)[1]| + (($info[//orgname])[last()]/orgname)[1]| + (($info[//publishername])[last()]/publishername)[1] + + + + +Description + +The value of refentry.source.name.profile +is a string representing an XPath expression. It is evaluated at +run-time and used only if +refentry.source.name.profile.enabled is +non-zero. Otherwise, the refentry metadata-gathering logic +"hard coded" into the stylesheets is used. + +A "source name" is one part of a (potentially) two-part +Name Version +"source" field. In man pages, it is usually displayed in the left +footer of the page. It typically indicates the software system or +product that the item documented in the man page belongs to. The +man(7) man page describes it as "the source of +the command", and provides the following examples: + + + For binaries, use something like: GNU, NET-2, SLS + Distribution, MCC Distribution. + + + For system calls, use the version of the kernel that you + are currently looking at: Linux 0.99.11. + + + For library calls, use the source of the function: GNU, BSD + 4.3, Linux DLL 4.4.1. + + + + +In practice, there are many pages that simply have a Version +number in the "source" field. So, it looks like what we have is a +two-part field, +Name Version, +where: + + + Name + + product name (e.g., BSD) or org. name (e.g., GNU) + + + + Version + + version number + + + +Each part is optional. If the Name is a +product name, then the Version is probably +the version of the product. Or there may be no +Name, in which case, if there is a +Version, it is probably the version +of the item itself, not the product it is part of. Or, if the +Name is an organization name, then there +probably will be no Version. + + diff --git a/src/documentation/docbook-xsl/params/refentry.source.name.suppress.xml b/src/documentation/docbook-xsl/params/refentry.source.name.suppress.xml new file mode 100644 index 0000000000..c5f8733963 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.source.name.suppress.xml @@ -0,0 +1,37 @@ + + +refentry.source.name.suppress +boolean + + +refentry.source.name.suppress +Suppress "name" part of refentry "source" contents? + + + + +0 + + +Description + +If the value of +refentry.source.name.suppress is non-zero, then +during refentry metadata gathering, no "source name" data +is added to the refentry "source" contents. Instead (unless +refentry.version.suppress is also non-zero), +only "version" data is added to the "source" contents. + +If you find that the refentry metadata gathering +mechanism is causing unwanted "source name" data to show up in your +output -- for example, in the footer (or possibly header) of a man +page -- then you might consider setting a non-zero value for +refentry.source.name.suppress. + +Note that the terms "source", "source name", and "version" have +special meanings in this context. For details, see the documentation +for the refentry.source.name.profile +parameter. + + + diff --git a/src/documentation/docbook-xsl/params/refentry.title.properties.xml b/src/documentation/docbook-xsl/params/refentry.title.properties.xml new file mode 100644 index 0000000000..c0d8378cb4 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.title.properties.xml @@ -0,0 +1,56 @@ + + +refentry.title.properties +attribute set + + +refentry.title.properties +Title properties for a refentry title + + + + + + + + + 18pt + bold + 1em + false + always + 0.8em + 1.0em + 1.2em + 0.5em + 0.4em + 0.6em + + + + + +Description + +Formatting properties applied to the title generated for the +refnamediv part of output for +refentry when the value of the +refentry.generate.title parameter is +non-zero. The font size is supplied by the appropriate section.levelX.title.properties +attribute-set, computed from the location of the +refentry in the section hierarchy. + + + This parameter has no effect on the the title generated for + the refnamediv part of output for + refentry when the value of the + refentry.generate.name parameter is + non-zero. By default, that title is formatted with the same + properties as the titles for all other first-level children of + refentry. + + + + diff --git a/src/documentation/docbook-xsl/params/refentry.version.profile.enabled.xml b/src/documentation/docbook-xsl/params/refentry.version.profile.enabled.xml new file mode 100644 index 0000000000..267687b4d7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.version.profile.enabled.xml @@ -0,0 +1,42 @@ + + +refentry.version.profile.enabled +boolean + + +refentry.version.profile.enabled +Enable refentry "version" profiling? + + + + +0 + + +Description + +If the value of +refentry.version.profile.enabled is +non-zero, then during refentry metadata gathering, the info +profile specified by the customizable +refentry.version.profile parameter is +used. + +If instead the value of +refentry.version.profile.enabled is zero (the +default), then "hard coded" logic within the DocBook XSL stylesheets +is used for gathering refentry "version" data. + +If you find that the default refentry +metadata-gathering behavior is causing incorrect "version" data to show +up in your output, then consider setting a non-zero value for +refentry.version.profile.enabled and adjusting +the value of refentry.version.profile to cause +correct data to be gathered. + +Note that the terms "source" and "version" have special +meanings in this context. For details, see the documentation for the +refentry.version.profile parameter. + + + diff --git a/src/documentation/docbook-xsl/params/refentry.version.profile.xml b/src/documentation/docbook-xsl/params/refentry.version.profile.xml new file mode 100644 index 0000000000..faef22a745 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.version.profile.xml @@ -0,0 +1,36 @@ + + +refentry.version.profile +string + + +refentry.version.profile +Specifies profile for refentry "version" data + + + + + + (($info[//productnumber])[last()]/productnumber)[1]| + (($info[//edition])[last()]/edition)[1]| + (($info[//releaseinfo])[last()]/releaseinfo)[1] + + + + +Description + +The value of refentry.version.profile is +a string representing an XPath expression. It is evaluated at +run-time and used only if +refentry.version.profile.enabled is +non-zero. Otherwise, the refentry metadata-gathering logic +"hard coded" into the stylesheets is used. + +A "source.name" is one part of a (potentially) two-part +Name Version +"source" field. For more details, see the documentation for the +refentry.source.name.profile parameter. + + + diff --git a/src/documentation/docbook-xsl/params/refentry.version.suppress.xml b/src/documentation/docbook-xsl/params/refentry.version.suppress.xml new file mode 100644 index 0000000000..1f447bd41e --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.version.suppress.xml @@ -0,0 +1,38 @@ + + +refentry.version.suppress +boolean + + +refentry.version.suppress +Suppress "version" part of refentry "source" contents? + + + + +0 + + +Description + +If the value of refentry.version.suppress +is non-zero, then during refentry metadata gathering, no +"version" data is added to the refentry "source" +contents. Instead (unless +refentry.source.name.suppress is also +non-zero), only "source name" data is added to the "source" +contents. + +If you find that the refentry metadata gathering +mechanism is causing unwanted "version" data to show up in your output +-- for example, in the footer (or possibly header) of a man page -- +then you might consider setting a non-zero value for +refentry.version.suppress. + +Note that the terms "source", "source name", and "version" have +special meanings in this context. For details, see the documentation +for the refentry.source.name.profile +parameter. + + + diff --git a/src/documentation/docbook-xsl/params/refentry.xref.manvolnum.xml b/src/documentation/docbook-xsl/params/refentry.xref.manvolnum.xml new file mode 100644 index 0000000000..d790793354 --- /dev/null +++ b/src/documentation/docbook-xsl/params/refentry.xref.manvolnum.xml @@ -0,0 +1,24 @@ + + +refentry.xref.manvolnum +boolean + + +refentry.xref.manvolnum +Output manvolnum as part of +refentry cross-reference? + + + + + + +Description + +if true (non-zero), the manvolnum is used when cross-referencing +refentrys, either with xref +or citerefentry. + + + + diff --git a/src/documentation/docbook-xsl/params/region.after.extent.xml b/src/documentation/docbook-xsl/params/region.after.extent.xml new file mode 100644 index 0000000000..3ddf3ec92a --- /dev/null +++ b/src/documentation/docbook-xsl/params/region.after.extent.xml @@ -0,0 +1,24 @@ + + +region.after.extent + + + +region.after.extent +Specifies the height of the footer. + + + + + + + + +Description + +The region after extent is the height of the area where footers +are printed. + + + + diff --git a/src/documentation/docbook-xsl/params/region.before.extent.xml b/src/documentation/docbook-xsl/params/region.before.extent.xml new file mode 100644 index 0000000000..2a1a279397 --- /dev/null +++ b/src/documentation/docbook-xsl/params/region.before.extent.xml @@ -0,0 +1,24 @@ + + +region.before.extent + + + +region.before.extent +Specifies the height of the header + + + + + + + + +Description + +The region before extent is the height of the area where headers +are printed. + + + + diff --git a/src/documentation/docbook-xsl/params/revhistory.table.cell.properties.xml b/src/documentation/docbook-xsl/params/revhistory.table.cell.properties.xml new file mode 100644 index 0000000000..c82b20e49c --- /dev/null +++ b/src/documentation/docbook-xsl/params/revhistory.table.cell.properties.xml @@ -0,0 +1,23 @@ + + +revhistory.table.cell.properties +attribute set + + +revhistory.table.cell.properties +The properties of table cells used for formatting revhistory + + + + + + + + + +Description + +This property set defines appearance of individual cells in revhistory table. + + + diff --git a/src/documentation/docbook-xsl/params/revhistory.table.properties.xml b/src/documentation/docbook-xsl/params/revhistory.table.properties.xml new file mode 100644 index 0000000000..7efd6f238e --- /dev/null +++ b/src/documentation/docbook-xsl/params/revhistory.table.properties.xml @@ -0,0 +1,23 @@ + + +revhistory.table.properties +attribute set + + +revhistory.table.properties +The properties of table used for formatting revhistory + + + + + + + + + +Description + +This property set defines appearance of revhistory table. + + + diff --git a/src/documentation/docbook-xsl/params/revhistory.title.properties.xml b/src/documentation/docbook-xsl/params/revhistory.title.properties.xml new file mode 100644 index 0000000000..3f915ecc1a --- /dev/null +++ b/src/documentation/docbook-xsl/params/revhistory.title.properties.xml @@ -0,0 +1,23 @@ + + +revhistory.title.properties +attribute set + + +revhistory.title.properties +The properties of revhistory title + + + + + + + + + +Description + +This property set defines appearance of revhistory title. + + + diff --git a/src/documentation/docbook-xsl/params/root.filename.xml b/src/documentation/docbook-xsl/params/root.filename.xml new file mode 100644 index 0000000000..c62670fc3b --- /dev/null +++ b/src/documentation/docbook-xsl/params/root.filename.xml @@ -0,0 +1,22 @@ + + +root.filename + + + +root.filename +Identifies the name of the root HTML file when chunking + + + + + + +Description + +The root.filename is the base filename for +the chunk created for the root of each document processed. + + + + diff --git a/src/documentation/docbook-xsl/params/root.properties.xml b/src/documentation/docbook-xsl/params/root.properties.xml new file mode 100644 index 0000000000..6424412c01 --- /dev/null +++ b/src/documentation/docbook-xsl/params/root.properties.xml @@ -0,0 +1,38 @@ + + +root.properties +attribute set + + +root.properties +The properties of the fo:root element + + + + + + + + + + + + + + + + + + character-by-character + disregard-shifts + + + + +Description + +This property set is used on the fo:root element of +an FO file. It defines a set of default, global parameters. + + + diff --git a/src/documentation/docbook-xsl/params/rootid.xml b/src/documentation/docbook-xsl/params/rootid.xml new file mode 100644 index 0000000000..49108ffa48 --- /dev/null +++ b/src/documentation/docbook-xsl/params/rootid.xml @@ -0,0 +1,27 @@ + + +rootid +string + + +rootid +Specify the root element to format + + + + + + +Description + +If rootid is specified, it must be the +value of an ID that occurs in the document being formatted. The entire +document will be loaded and parsed, but formatting will begin at the +element identified, rather than at the root. For example, this allows +you to process only chapter 4 of a book. +Because the entire document is available to the processor, automatic +numbering, cross references, and other dependencies are correctly +resolved. + + + diff --git a/src/documentation/docbook-xsl/params/runinhead.default.title.end.punct.xml b/src/documentation/docbook-xsl/params/runinhead.default.title.end.punct.xml new file mode 100644 index 0000000000..0fe73431f2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/runinhead.default.title.end.punct.xml @@ -0,0 +1,21 @@ + + +runinhead.default.title.end.punct +string + + +runinhead.default.title.end.punct +Default punctuation character on a run-in-head + + + + + + +Description + +FIXME: + + + + diff --git a/src/documentation/docbook-xsl/params/runinhead.title.end.punct.xml b/src/documentation/docbook-xsl/params/runinhead.title.end.punct.xml new file mode 100644 index 0000000000..a82487bfe4 --- /dev/null +++ b/src/documentation/docbook-xsl/params/runinhead.title.end.punct.xml @@ -0,0 +1,21 @@ + + +runinhead.title.end.punct +string + + +runinhead.title.end.punct +Characters that count as punctuation on a run-in-head + + + + + + +Description + +FIXME: + + + + diff --git a/src/documentation/docbook-xsl/params/sans.font.family.xml b/src/documentation/docbook-xsl/params/sans.font.family.xml new file mode 100644 index 0000000000..c07ad4cc1a --- /dev/null +++ b/src/documentation/docbook-xsl/params/sans.font.family.xml @@ -0,0 +1,24 @@ + + +sans.font.family + + + +sans.font.family +The default sans-serif font family + + + + + + + + +Description + +The default sans-serif font family. At the present, this isn't +actually used by the stylesheets. + + + + diff --git a/src/documentation/docbook-xsl/params/saxon.callouts.xml b/src/documentation/docbook-xsl/params/saxon.callouts.xml new file mode 100644 index 0000000000..362c3b737f --- /dev/null +++ b/src/documentation/docbook-xsl/params/saxon.callouts.xml @@ -0,0 +1,23 @@ + + +saxon.callouts +boolean + + +saxon.callouts +Enable the callout extension + + + + + + +Description + +The callouts extension processes areaset +elements in ProgramListingCO and other text-based +callout elements. + + + + diff --git a/src/documentation/docbook-xsl/params/saxon.character.representation.xml b/src/documentation/docbook-xsl/params/saxon.character.representation.xml new file mode 100644 index 0000000000..167f6c7754 --- /dev/null +++ b/src/documentation/docbook-xsl/params/saxon.character.representation.xml @@ -0,0 +1,27 @@ + + +saxon.character.representation +string + + +saxon.character.representation +Saxon character representation used in generated HTML pages + + +<xsl:param name="saxon.character.representation" select="'entity;decimal'"/> + + +Description + +This character representation is used in files generated by chunking stylesheet. If +you want to suppress entity references for characters with direct representation +in default.encoding, set this parameter to value native. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + diff --git a/src/documentation/docbook-xsl/params/saxon.linenumbering.xml b/src/documentation/docbook-xsl/params/saxon.linenumbering.xml new file mode 100644 index 0000000000..8b3d5578c3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/saxon.linenumbering.xml @@ -0,0 +1,24 @@ + + +saxon.linenumbering +boolean + + +saxon.linenumbering +Enable the line numbering extension + + + + + + +Description + +If true, verbatim environments (elements that have the +format='linespecific' notation attribute: address, literallayout, +programlisting, screen, synopsis) that specify line numbering will +have, surprise, line numbers. + + + + diff --git a/src/documentation/docbook-xsl/params/saxon.tablecolumns.xml b/src/documentation/docbook-xsl/params/saxon.tablecolumns.xml new file mode 100644 index 0000000000..8a7482ab2f --- /dev/null +++ b/src/documentation/docbook-xsl/params/saxon.tablecolumns.xml @@ -0,0 +1,23 @@ + + +saxon.tablecolumns +boolean + + +saxon.tablecolumns +Enable the table columns extension function + + + + + + +Description + +The table columns extension function adjusts the widths of table +columns in the HTML result to more accurately reflect the specifications +in the CALS table. + + + + diff --git a/src/documentation/docbook-xsl/params/section.autolabel.max.depth.xml b/src/documentation/docbook-xsl/params/section.autolabel.max.depth.xml new file mode 100644 index 0000000000..4e100a3025 --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.autolabel.max.depth.xml @@ -0,0 +1,26 @@ + + +section.autolabel.max.depth +integer + + +section.autolabel.max.depth +The deepest level of sections that are numbered. + + + + + + +Description + +When section numbering is turned on by the +section.autolabel parameter, +then this parameter controls the depth of section nesting +that is numbered. +Sections nested to a level deeper than this value will +not be numbered. + + + + diff --git a/src/documentation/docbook-xsl/params/section.autolabel.xml b/src/documentation/docbook-xsl/params/section.autolabel.xml new file mode 100644 index 0000000000..d68966d0db --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.autolabel.xml @@ -0,0 +1,21 @@ + + +section.autolabel +boolean + + +section.autolabel +Are sections enumerated? + + + + + + +Description + +If true (non-zero), unlabeled sections will be enumerated. + + + + diff --git a/src/documentation/docbook-xsl/params/section.label.includes.component.label.xml b/src/documentation/docbook-xsl/params/section.label.includes.component.label.xml new file mode 100644 index 0000000000..124d233eab --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.label.includes.component.label.xml @@ -0,0 +1,22 @@ + + +section.label.includes.component.label +boolean + + +section.label.includes.component.label +Do section labels include the component label? + + + + + + +Description + +If true (non-zero), section labels are prefixed with the label of the +component that contains them. + + + + diff --git a/src/documentation/docbook-xsl/params/section.level1.properties.xml b/src/documentation/docbook-xsl/params/section.level1.properties.xml new file mode 100644 index 0000000000..c0a804d7bb --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.level1.properties.xml @@ -0,0 +1,39 @@ + + +section.level1.properties +attribute set + + +section.level1.properties +Properties for level-1 sections + + + + + + + + + +Description + +The properties that apply to the containing +block of a level-1 section, and therefore apply to +the whole section. This includes sect1 +elements and section elements at level 1. + + +For example, you could start each level-1 section on +a new page by using: +<xsl:attribute-set name="section.level1.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + diff --git a/src/documentation/docbook-xsl/params/section.level2.properties.xml b/src/documentation/docbook-xsl/params/section.level2.properties.xml new file mode 100644 index 0000000000..15af8aaba1 --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.level2.properties.xml @@ -0,0 +1,39 @@ + + +section.level2.properties +attribute set + + +section.level2.properties +Properties for level-2 sections + + + + + + + + + +Description + +The properties that apply to the containing +block of a level-2 section, and therefore apply to +the whole section. This includes sect2 +elements and section elements at level 2. + + +For example, you could start each level-2 section on +a new page by using: +<xsl:attribute-set name="section.level2.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + diff --git a/src/documentation/docbook-xsl/params/section.level3.properties.xml b/src/documentation/docbook-xsl/params/section.level3.properties.xml new file mode 100644 index 0000000000..c6a29b032b --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.level3.properties.xml @@ -0,0 +1,39 @@ + + +section.level3.properties +attribute set + + +section.level3.properties +Properties for level-3 sections + + + + + + + + + +Description + +The properties that apply to the containing +block of a level-3 section, and therefore apply to +the whole section. This includes sect3 +elements and section elements at level 3. + + +For example, you could start each level-3 section on +a new page by using: +<xsl:attribute-set name="section.level3.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + diff --git a/src/documentation/docbook-xsl/params/section.level4.properties.xml b/src/documentation/docbook-xsl/params/section.level4.properties.xml new file mode 100644 index 0000000000..967ed94e5f --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.level4.properties.xml @@ -0,0 +1,39 @@ + + +section.level4.properties +attribute set + + +section.level4.properties +Properties for level-4 sections + + + + + + + + + +Description + +The properties that apply to the containing +block of a level-4 section, and therefore apply to +the whole section. This includes sect4 +elements and section elements at level 4. + + +For example, you could start each level-4 section on +a new page by using: +<xsl:attribute-set name="section.level4.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + diff --git a/src/documentation/docbook-xsl/params/section.level5.properties.xml b/src/documentation/docbook-xsl/params/section.level5.properties.xml new file mode 100644 index 0000000000..d1a30c93b7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.level5.properties.xml @@ -0,0 +1,39 @@ + + +section.level5.properties +attribute set + + +section.level5.properties +Properties for level-5 sections + + + + + + + + + +Description + +The properties that apply to the containing +block of a level-5 section, and therefore apply to +the whole section. This includes sect5 +elements and section elements at level 5. + + +For example, you could start each level-5 section on +a new page by using: +<xsl:attribute-set name="section.level5.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + diff --git a/src/documentation/docbook-xsl/params/section.level6.properties.xml b/src/documentation/docbook-xsl/params/section.level6.properties.xml new file mode 100644 index 0000000000..8bd590c5ee --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.level6.properties.xml @@ -0,0 +1,39 @@ + + +section.level6.properties +attribute set + + +section.level6.properties +Properties for level-6 sections + + + + + + + + + +Description + +The properties that apply to the containing +block of a level 6 or lower section, and therefore apply to +the whole section. This includes +section elements at level 6 and lower. + + +For example, you could start each level-6 section on +a new page by using: +<xsl:attribute-set name="section.level6.properties"> + <xsl:attribute name="break-before">page</xsl:attribute> +</xsl:attribute-set> + + +This attribute set inherits attributes from the +general section.properties attribute set. + + + + diff --git a/src/documentation/docbook-xsl/params/section.properties.xml b/src/documentation/docbook-xsl/params/section.properties.xml new file mode 100644 index 0000000000..bd83a7403e --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.properties.xml @@ -0,0 +1,30 @@ + + +section.properties +attribute set + + +section.properties +Properties for all section levels + + + + + + + + + +Description + +The properties that apply to the containing +block of all section levels, and therefore apply to +the whole section. +This attribute set is inherited by the +more specific attribute sets such as +section.level1.properties. +The default is empty. + + + + diff --git a/src/documentation/docbook-xsl/params/section.title.level1.properties.xml b/src/documentation/docbook-xsl/params/section.title.level1.properties.xml new file mode 100644 index 0000000000..9b8584554e --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.title.level1.properties.xml @@ -0,0 +1,27 @@ + + +section.title.level1.properties +attribute set + + +section.title.level1.properties +Properties for level-1 section titles + + + + + + + + pt + + + + + +Description + +The properties of level-1 section titles. + + + diff --git a/src/documentation/docbook-xsl/params/section.title.level2.properties.xml b/src/documentation/docbook-xsl/params/section.title.level2.properties.xml new file mode 100644 index 0000000000..f6f7d206a8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.title.level2.properties.xml @@ -0,0 +1,27 @@ + + +section.title.level2.properties +attribute set + + +section.title.level2.properties +Properties for level-1 section titles + + + + + + + + pt + + + + + +Description + +The properties of level-2 section titles. + + + diff --git a/src/documentation/docbook-xsl/params/section.title.level3.properties.xml b/src/documentation/docbook-xsl/params/section.title.level3.properties.xml new file mode 100644 index 0000000000..b895e232b7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.title.level3.properties.xml @@ -0,0 +1,27 @@ + + +section.title.level3.properties +attribute set + + +section.title.level3.properties +Properties for level-1 section titles + + + + + + + + pt + + + + + +Description + +The properties of level-3 section titles. + + + diff --git a/src/documentation/docbook-xsl/params/section.title.level4.properties.xml b/src/documentation/docbook-xsl/params/section.title.level4.properties.xml new file mode 100644 index 0000000000..36c7b72ffb --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.title.level4.properties.xml @@ -0,0 +1,27 @@ + + +section.title.level4.properties +attribute set + + +section.title.level4.properties +Properties for level-1 section titles + + + + + + + + pt + + + + + +Description + +The properties of level-4 section titles. + + + diff --git a/src/documentation/docbook-xsl/params/section.title.level5.properties.xml b/src/documentation/docbook-xsl/params/section.title.level5.properties.xml new file mode 100644 index 0000000000..464afa7bf8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.title.level5.properties.xml @@ -0,0 +1,27 @@ + + +section.title.level5.properties +attribute set + + +section.title.level5.properties +Properties for level-1 section titles + + + + + + + + pt + + + + + +Description + +The properties of level-5 section titles. + + + diff --git a/src/documentation/docbook-xsl/params/section.title.level6.properties.xml b/src/documentation/docbook-xsl/params/section.title.level6.properties.xml new file mode 100644 index 0000000000..af3896764b --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.title.level6.properties.xml @@ -0,0 +1,28 @@ + + +section.title.level6.properties +attribute set + + +section.title.level6.properties +Properties for level-1 section titles + + + + + + + + pt + + + + + +Description + +The properties of level-6 section titles. This property set is actually +used for all titles below level 5. + + + diff --git a/src/documentation/docbook-xsl/params/section.title.properties.xml b/src/documentation/docbook-xsl/params/section.title.properties.xml new file mode 100644 index 0000000000..1e94aa7dbe --- /dev/null +++ b/src/documentation/docbook-xsl/params/section.title.properties.xml @@ -0,0 +1,35 @@ + + +section.title.properties +attribute set + + +section.title.properties +Properties for section titles + + + + + + + + + bold + + always + 0.8em + 1.0em + 1.2em + left + + + + + +Description + +The properties common to all section titles. + + + diff --git a/src/documentation/docbook-xsl/params/segmentedlist.as.table.xml b/src/documentation/docbook-xsl/params/segmentedlist.as.table.xml new file mode 100644 index 0000000000..e7ce9c8b51 --- /dev/null +++ b/src/documentation/docbook-xsl/params/segmentedlist.as.table.xml @@ -0,0 +1,23 @@ + + +segmentedlist.as.table +boolean + + +segmentedlist.as.table +Format segmented lists as tables? + + + + + + + + +Description + +If non-zero, segmentedlists will be formatted as +tables. + + + diff --git a/src/documentation/docbook-xsl/params/shade.verbatim.style.xml b/src/documentation/docbook-xsl/params/shade.verbatim.style.xml new file mode 100644 index 0000000000..34805cedad --- /dev/null +++ b/src/documentation/docbook-xsl/params/shade.verbatim.style.xml @@ -0,0 +1,28 @@ + + +shade.verbatim.style + + + +shade.verbatim.style +Properties that specify the style of shaded verbatim listings + + + + + + 0 + #E0E0E0 + + + #E0E0E0 + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/shade.verbatim.xml b/src/documentation/docbook-xsl/params/shade.verbatim.xml new file mode 100644 index 0000000000..8519f855fe --- /dev/null +++ b/src/documentation/docbook-xsl/params/shade.verbatim.xml @@ -0,0 +1,25 @@ + + +shade.verbatim +boolean + + +shade.verbatim +Should verbatim environments be shaded? + + + + + + +Description + +In the FO stylesheet, if this parameter is non-zero then the +shade.verbatim.style properties will be applied +to verbatim environments. + +In the HTML stylesheet, this parameter is now deprecated. Use +CSS instead. + + + diff --git a/src/documentation/docbook-xsl/params/show.comments.xml b/src/documentation/docbook-xsl/params/show.comments.xml new file mode 100644 index 0000000000..1757fb4e8d --- /dev/null +++ b/src/documentation/docbook-xsl/params/show.comments.xml @@ -0,0 +1,24 @@ + + +show.comments +boolean + + +show.comments +Display comment elements? + + + +1 + + +Description + +If true (non-zero), comments will be displayed, otherwise they are suppressed. +Comments here refers to the comment element, +which will be renamed remark in DocBook V4.0, +not XML comments (<-- like this -->) which are unavailable. + + + + diff --git a/src/documentation/docbook-xsl/params/show.revisionflag.xml b/src/documentation/docbook-xsl/params/show.revisionflag.xml new file mode 100644 index 0000000000..94360b5f37 --- /dev/null +++ b/src/documentation/docbook-xsl/params/show.revisionflag.xml @@ -0,0 +1,35 @@ + + +show.revisionflag +boolean + + +show.revisionflag +Enable decoration of elements that have a revisionflag + + + +0 + + +Description + + +If show.revisionflag is turned on, then the stylesheets +may produce additional markup designed to allow a CSS stylesheet to +highlight elements that have specific revisionflag settings. + +The markup inserted will be usually be either a <span> or <div> +with an appropriate class attribute. (The value of +the class attribute will be the same as the value of the revisionflag +attribute). In some contexts, for example tables, where extra markup +would be structurally illegal, the class attribute will be added to the +appropriate container element. + +In general, the stylesheets only test for revisionflag in contexts +where an importing stylesheet would have to redefine whole templates. +Most of the revisionflag processing is expected to be done by another +stylesheet, for example changebars.xsl. + + + diff --git a/src/documentation/docbook-xsl/params/side.float.properties.xml b/src/documentation/docbook-xsl/params/side.float.properties.xml new file mode 100644 index 0000000000..789615acf7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/side.float.properties.xml @@ -0,0 +1,45 @@ + + +side.float.properties +attribute set + + +side.float.properties +Attribute set for side float container properties + + + + + + 2in + 4pt + 4pt + 2pt + 2pt + 0pt + 0pt + left + + + + +Description + +Properties that are applied to the +fo:block-container inside of +a side float that is generated by the template named +floater. +That template generates a side float +when the side.float.type is set to one +of the values for a side float. + +If you do only left or +start side floats, you may want to set the +padding-left attribute to zero. +If you do only right or +end side floats, you may want to set the +padding-right attribute to zero. + + + + diff --git a/src/documentation/docbook-xsl/params/sidebar.float.type.xml b/src/documentation/docbook-xsl/params/sidebar.float.type.xml new file mode 100644 index 0000000000..12f39df802 --- /dev/null +++ b/src/documentation/docbook-xsl/params/sidebar.float.type.xml @@ -0,0 +1,60 @@ + + +sidebar.float.type +list + + +sidebar.float.type +Select type of float for sidebar elements + + + + + + + + +Description + +Selects the type of float for sidebar elements. + + + +If sidebar.float.type is +none, then +no float is used. + + + +If sidebar.float.type is +before, then +the float appears at the top of the page. On some processors, +that may be the next page rather than the current page. + + + +If sidebar.float.type is +left or +start, then +a left side float is used. + + + +If sidebar.float.type is +right or +end, then +a right side float is used. + + + +If your XSL-FO processor supports floats positioned on the +inside or +outside +of double-sided pages, then you have those two +options for side floats as well. + + + + + + diff --git a/src/documentation/docbook-xsl/params/sidebar.float.width.xml b/src/documentation/docbook-xsl/params/sidebar.float.width.xml new file mode 100644 index 0000000000..ee5e3fe5c8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/sidebar.float.width.xml @@ -0,0 +1,29 @@ + + +sidebar.float.width + + +sidebar.float.width +Set the default width for sidebars + + + + + + + + +Description + +Sets the default width for sidebars when used as a side float. +The width determines the degree to which the sidebar block intrudes into +the text area. + +If sidebar.float.type is +before or +none, then +this parameter is ignored. + + + + diff --git a/src/documentation/docbook-xsl/params/sidebar.properties.xml b/src/documentation/docbook-xsl/params/sidebar.properties.xml new file mode 100644 index 0000000000..94d79814c6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/sidebar.properties.xml @@ -0,0 +1,38 @@ + + +sidebar.properties +attribute set + + +sidebar.properties +Attribute set for sidebar properties + + + + + + solid + 1pt + black + #DDDDDD + 12pt + 12pt + 6pt + 6pt + 0pt + 0pt + + + + + +Description + +The styling for sidebars. + + + diff --git a/src/documentation/docbook-xsl/params/sidebar.title.properties.xml b/src/documentation/docbook-xsl/params/sidebar.title.properties.xml new file mode 100644 index 0000000000..e9594666cc --- /dev/null +++ b/src/documentation/docbook-xsl/params/sidebar.title.properties.xml @@ -0,0 +1,27 @@ + + +sidebar.title.properties +attribute set + + +sidebar.title.properties +Attribute set for sidebar titles + + + + + + bold + false + start + always + + + + +Description + +The styling for sidebars titles. + + + diff --git a/src/documentation/docbook-xsl/params/simplesect.in.toc.xml b/src/documentation/docbook-xsl/params/simplesect.in.toc.xml new file mode 100644 index 0000000000..8d19e0b43d --- /dev/null +++ b/src/documentation/docbook-xsl/params/simplesect.in.toc.xml @@ -0,0 +1,21 @@ + + +simplesect.in.toc +boolean + + +simplesect.in.toc +Should simplesect elements appear in the TOC? + + + + + + +Description + +If non-zero, simplesects appear in the TOC. + + + + diff --git a/src/documentation/docbook-xsl/params/spacing.paras.xml b/src/documentation/docbook-xsl/params/spacing.paras.xml new file mode 100644 index 0000000000..f9fa226730 --- /dev/null +++ b/src/documentation/docbook-xsl/params/spacing.paras.xml @@ -0,0 +1,23 @@ + + +spacing.paras +boolean + + +spacing.paras +Insert additional <p> elements for spacing? + + + + + + +Description + +When non-zero, additional, empty paragraphs are inserted in +several contexts (for example, around informal figures), to create a +more pleasing visual appearance in many browsers. + + + + diff --git a/src/documentation/docbook-xsl/params/subscript.properties.xml b/src/documentation/docbook-xsl/params/subscript.properties.xml new file mode 100644 index 0000000000..bd90a09d0e --- /dev/null +++ b/src/documentation/docbook-xsl/params/subscript.properties.xml @@ -0,0 +1,24 @@ + + +subscript.properties + + + +subscript.properties +Properties associated with subscripts + + + + + + 75% + + + + +Description + +Specifies styling properties for subscripts. + + + diff --git a/src/documentation/docbook-xsl/params/superscript.properties.xml b/src/documentation/docbook-xsl/params/superscript.properties.xml new file mode 100644 index 0000000000..8a5d5c070e --- /dev/null +++ b/src/documentation/docbook-xsl/params/superscript.properties.xml @@ -0,0 +1,24 @@ + + +superscript.properties + + + +superscript.properties +Properties associated with superscripts + + + + + + 75% + + + + +Description + +Specifies styling properties for superscripts. + + + diff --git a/src/documentation/docbook-xsl/params/suppress.footer.navigation.xml b/src/documentation/docbook-xsl/params/suppress.footer.navigation.xml new file mode 100644 index 0000000000..90101d45ad --- /dev/null +++ b/src/documentation/docbook-xsl/params/suppress.footer.navigation.xml @@ -0,0 +1,22 @@ + + +suppress.footer.navigation +boolean + + +suppress.footer.navigation +Disable footer navigation + + + +0 + + +Description + + +If suppress.footer.navigation is turned on, footer +navigation will be suppressed. + + + diff --git a/src/documentation/docbook-xsl/params/suppress.header.navigation.xml b/src/documentation/docbook-xsl/params/suppress.header.navigation.xml new file mode 100644 index 0000000000..276e28c6b4 --- /dev/null +++ b/src/documentation/docbook-xsl/params/suppress.header.navigation.xml @@ -0,0 +1,22 @@ + + +suppress.header.navigation +boolean + + +suppress.header.navigation +Disable header navigation + + + +0 + + +Description + + +If suppress.header.navigation is turned on, header +navigation will be suppressed. + + + diff --git a/src/documentation/docbook-xsl/params/suppress.navigation.xml b/src/documentation/docbook-xsl/params/suppress.navigation.xml new file mode 100644 index 0000000000..a06568e2f8 --- /dev/null +++ b/src/documentation/docbook-xsl/params/suppress.navigation.xml @@ -0,0 +1,22 @@ + + +suppress.navigation +boolean + + +suppress.navigation +Disable header and footer navigation + + + +0 + + +Description + + +If suppress.navigation is turned on, header and +footer navigation will be suppressed. + + + diff --git a/src/documentation/docbook-xsl/params/symbol.font.family.xml b/src/documentation/docbook-xsl/params/symbol.font.family.xml new file mode 100644 index 0000000000..0f038e78c7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/symbol.font.family.xml @@ -0,0 +1,36 @@ + + +symbol.font.family + + + +symbol.font.family +The font families to be searched for symbols outside + of the body font + + + + + + + + +Description + +A typical body or title font does not contain all +the character glyphs that DocBook supports. This parameter +specifies additional fonts that should be searched for +special characters not in the normal font. +These symbol font names are automatically appended +to the body or title font family name when fonts +are specified in a +font-family +property in the FO output. + +The symbol font names should be entered as a +comma-separated list. The default value is +Symbol,ZapfDingbats. + + + + diff --git a/src/documentation/docbook-xsl/params/table.borders.with.css.xml b/src/documentation/docbook-xsl/params/table.borders.with.css.xml new file mode 100644 index 0000000000..2054b73933 --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.borders.with.css.xml @@ -0,0 +1,23 @@ + + +table.borders.with.css +boolean + + +table.borders.with.css +Use CSS to specify table, row, and cell borders? + + + + + + + + +Description + +If true (non-zero), CSS will be used to draw table borders. + + + + diff --git a/src/documentation/docbook-xsl/params/table.cell.border.color.xml b/src/documentation/docbook-xsl/params/table.cell.border.color.xml new file mode 100644 index 0000000000..1299a9e6e3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.cell.border.color.xml @@ -0,0 +1,23 @@ + + +table.cell.border.color + + + +table.cell.border.color + + + + + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/table.cell.border.style.xml b/src/documentation/docbook-xsl/params/table.cell.border.style.xml new file mode 100644 index 0000000000..26b416d8d9 --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.cell.border.style.xml @@ -0,0 +1,22 @@ + + +table.cell.border.style + + + +table.cell.border.style + + + + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/table.cell.border.thickness.xml b/src/documentation/docbook-xsl/params/table.cell.border.thickness.xml new file mode 100644 index 0000000000..9c2c8ea9a6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.cell.border.thickness.xml @@ -0,0 +1,22 @@ + + +table.cell.border.thickness + + + +table.cell.border.thickness + + + + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/table.cell.padding.xml b/src/documentation/docbook-xsl/params/table.cell.padding.xml new file mode 100644 index 0000000000..5b3342fc98 --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.cell.padding.xml @@ -0,0 +1,27 @@ + + +table.cell.padding + + + +table.cell.padding + + + + + + + 2pt + 2pt + 2pt + 2pt + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/table.entry.padding.xml b/src/documentation/docbook-xsl/params/table.entry.padding.xml new file mode 100644 index 0000000000..4775f6c4f7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.entry.padding.xml @@ -0,0 +1,22 @@ + + +table.entry.padding + + + +table.entry.padding + + + + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/table.footnote.number.format.xml b/src/documentation/docbook-xsl/params/table.footnote.number.format.xml new file mode 100644 index 0000000000..7ea911e725 --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.footnote.number.format.xml @@ -0,0 +1,23 @@ + + +table.footnote.number.format +string + + +table.footnote.number.format +Identifies the format used for footnote numbers in tables + + + + + + + + +Description + +The table.footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A) in tables. + + + diff --git a/src/documentation/docbook-xsl/params/table.footnote.number.symbols.xml b/src/documentation/docbook-xsl/params/table.footnote.number.symbols.xml new file mode 100644 index 0000000000..d8004cfd8a --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.footnote.number.symbols.xml @@ -0,0 +1,34 @@ + + +table.footnote.number.symbols + + + +table.footnote.number.symbols +Special characters to use a footnote markers in tables + + + + + + + + +Description + +If table.footnote.number.symbols is not the empty string, +table footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +table.footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + diff --git a/src/documentation/docbook-xsl/params/table.footnote.properties.xml b/src/documentation/docbook-xsl/params/table.footnote.properties.xml new file mode 100644 index 0000000000..eedffb8c02 --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.footnote.properties.xml @@ -0,0 +1,33 @@ + + +table.footnote.properties +Properties applied to each table footnote body + + + + + + + + + normal + normal + 2pt + + + + + +Description + +This attribute set is applied to the footnote-block +for each table footnote. +It can be used to set the +font-size, font-family, and other inheritable properties that will be +applied to all table footnotes. + + + diff --git a/src/documentation/docbook-xsl/params/table.frame.border.color.xml b/src/documentation/docbook-xsl/params/table.frame.border.color.xml new file mode 100644 index 0000000000..b0e229fcf5 --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.frame.border.color.xml @@ -0,0 +1,23 @@ + + +table.frame.border.color + + + +table.frame.border.color + + + + + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/table.frame.border.style.xml b/src/documentation/docbook-xsl/params/table.frame.border.style.xml new file mode 100644 index 0000000000..5a15e06fe1 --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.frame.border.style.xml @@ -0,0 +1,22 @@ + + +table.frame.border.style + + + +table.frame.border.style + + + + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/table.frame.border.thickness.xml b/src/documentation/docbook-xsl/params/table.frame.border.thickness.xml new file mode 100644 index 0000000000..0b5f2cbd1f --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.frame.border.thickness.xml @@ -0,0 +1,22 @@ + + +table.frame.border.thickness + + + +table.frame.border.thickness +Specifies the thickness of the frame border + + + + + + + + +Description + +Specifies the thickness of the border on the table's frame. + + + diff --git a/src/documentation/docbook-xsl/params/table.properties.xml b/src/documentation/docbook-xsl/params/table.properties.xml new file mode 100644 index 0000000000..4abff03ade --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.properties.xml @@ -0,0 +1,24 @@ + + +table.properties +Properties associated with the block surrounding a table + + + + + + + + +Description + +Block styling properties for tables. This parameter should really +have been called table.block.properties or something +like that, but we’re leaving it to avoid backwards-compatibility +problems. + +See also table.table.properties. + + + diff --git a/src/documentation/docbook-xsl/params/table.table.properties.xml b/src/documentation/docbook-xsl/params/table.table.properties.xml new file mode 100644 index 0000000000..581b9898bd --- /dev/null +++ b/src/documentation/docbook-xsl/params/table.table.properties.xml @@ -0,0 +1,27 @@ + + +table.table.properties +Properties associated with a table + + + + + + retain + collapse + + + + +Description + +The styling for tables. This parameter should really +have been called table.properties, but that parameter +name was inadvertantly established for the block-level properties +of the table as a whole. + + +See also table.properties. + + + diff --git a/src/documentation/docbook-xsl/params/tablecolumns.extension.xml b/src/documentation/docbook-xsl/params/tablecolumns.extension.xml new file mode 100644 index 0000000000..7726312586 --- /dev/null +++ b/src/documentation/docbook-xsl/params/tablecolumns.extension.xml @@ -0,0 +1,23 @@ + + +tablecolumns.extension +boolean + + +tablecolumns.extension +Enable the table columns extension function + + + + + + +Description + +The table columns extension function adjusts the widths of table +columns in the HTML result to more accurately reflect the specifications +in the CALS table. + + + + diff --git a/src/documentation/docbook-xsl/params/target.database.document.xml b/src/documentation/docbook-xsl/params/target.database.document.xml new file mode 100644 index 0000000000..01d95ab8c2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/target.database.document.xml @@ -0,0 +1,27 @@ + + +target.database.document +uri + + +target.database.document +Name of master database file for resolving +olinks + + + + + + +Description + +To resolve olinks between documents, the stylesheets use +a master database document that identifies the target datafiles for all the documents within the scope +of the olinks. This parameter value is the URI of +the master document to be read during processing to resolve olinks. +The default value is olinkdb.xml. +The data structure of the file is defined in the targetdatabase.dtd DTD. The database file provides the high level elements to record the identifiers, locations, and relationships of documents. The cross reference data for individual documents is generally pulled into the database using system entity references or XIncludes. See also targets.filename. + + + + diff --git a/src/documentation/docbook-xsl/params/targets.filename.xml b/src/documentation/docbook-xsl/params/targets.filename.xml new file mode 100644 index 0000000000..d9b71a2346 --- /dev/null +++ b/src/documentation/docbook-xsl/params/targets.filename.xml @@ -0,0 +1,27 @@ + + +targets.filename +string + + +targets.filename +Name of cross reference targets data file + + + + + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter lets you change the name of the generated +file from the default name target.db. +The name must agree with that used in the target database +used to resolve olinks during processing. +See also target.database.document. + + + diff --git a/src/documentation/docbook-xsl/params/template.xml b/src/documentation/docbook-xsl/params/template.xml new file mode 100644 index 0000000000..0b97c3a74c --- /dev/null +++ b/src/documentation/docbook-xsl/params/template.xml @@ -0,0 +1,22 @@ + + +[[NAME]] + + + +[[NAME]] + + + + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/params/tex.math.delims.xml b/src/documentation/docbook-xsl/params/tex.math.delims.xml new file mode 100644 index 0000000000..d2e01f983b --- /dev/null +++ b/src/documentation/docbook-xsl/params/tex.math.delims.xml @@ -0,0 +1,24 @@ + + +tex.math.delims +boolean + + +tex.math.delims +Should be equations outputed for processing by TeX +automatically surrounded by math mode delimiters + + + + + + + + +Description + +For compatibility with DSSSL based DBTeXMath from Allin Cottrell +you should set this parameter to 0. + + + diff --git a/src/documentation/docbook-xsl/params/tex.math.file.xml b/src/documentation/docbook-xsl/params/tex.math.file.xml new file mode 100644 index 0000000000..566177a3b2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/tex.math.file.xml @@ -0,0 +1,24 @@ + + +tex.math.file +string + + +tex.math.file +Name of temporary file for generating images from equations + + + + + + + + +Description + +Name of auxiliary file for TeX equations. This file can be +processed by dvi2bitmap to get bitmap versions of equations for HTML +output. + + + diff --git a/src/documentation/docbook-xsl/params/tex.math.in.alt.xml b/src/documentation/docbook-xsl/params/tex.math.in.alt.xml new file mode 100644 index 0000000000..0b956c6c83 --- /dev/null +++ b/src/documentation/docbook-xsl/params/tex.math.in.alt.xml @@ -0,0 +1,56 @@ + + +tex.math.in.alt +string + + +tex.math.in.alt +TeX notation used for equations + + + + + + + + +Description + +If you want type math directly in TeX notation in equations, +this parameter specifies notation used. Currently are supported two +values -- plain and latex. Empty +value means that you are not using TeX math at all. + +Preferred way for including TeX alternative of math is inside of +textobject element. Eg.: + + + + + + +E=mc squared +E=mc^2 + +]]> + +If you are using graphic element, you can +store TeX inside alt element: + + +a^2+b^2=c^2 + +]]> + +If you want use this feature, you should process your FO with +PassiveTeX, which only supports TeX math notation. When calling +stylsheet, don't forget to specify also +passivetex.extensions=1. + +If you want equations in HTML, just process generated file +tex-math-equations.tex by TeX or LaTeX. Then run +dvi2bitmap program on result DVI file. You will get images for +equations in your document. + + + diff --git a/src/documentation/docbook-xsl/params/textdata.default.encoding.xml b/src/documentation/docbook-xsl/params/textdata.default.encoding.xml new file mode 100644 index 0000000000..bb68226a55 --- /dev/null +++ b/src/documentation/docbook-xsl/params/textdata.default.encoding.xml @@ -0,0 +1,28 @@ + + +textdata.default.encoding +string + + +textdata.default.encoding +Default encoding of external text files which are included +using textdata element + + + + + + + + +Description + +Default encoding of external text files which are included using +textdata element. This value is used only when you do not specify +encoding by appropriate attribute directly on textdata. Default +encoding (empty string) is interpreted as system default +encoding. + + + + diff --git a/src/documentation/docbook-xsl/params/textinsert.extension.xml b/src/documentation/docbook-xsl/params/textinsert.extension.xml new file mode 100644 index 0000000000..8a3a0f2234 --- /dev/null +++ b/src/documentation/docbook-xsl/params/textinsert.extension.xml @@ -0,0 +1,22 @@ + + +textinsert.extension +boolean + + +textinsert.extension +Enable the textinsert extension element + + + + + + +Description + +The textinsert extension element inserts the contents of a +a file into the result tree (as text). + + + + diff --git a/src/documentation/docbook-xsl/params/title.font.family.xml b/src/documentation/docbook-xsl/params/title.font.family.xml new file mode 100644 index 0000000000..75996076f4 --- /dev/null +++ b/src/documentation/docbook-xsl/params/title.font.family.xml @@ -0,0 +1,24 @@ + + +title.font.family + + + +title.font.family +The default font family for titles + + + + + + + + +Description + +The title font family is used for titles (chapter, section, figure, +etc.) + + + + diff --git a/src/documentation/docbook-xsl/params/title.margin.left.xml b/src/documentation/docbook-xsl/params/title.margin.left.xml new file mode 100644 index 0000000000..dfd2990a86 --- /dev/null +++ b/src/documentation/docbook-xsl/params/title.margin.left.xml @@ -0,0 +1,59 @@ + + +title.margin.left + + + +title.margin.left +Adjust the left margin for titles + + + + + + + -4pc + 0pt + 0pt + + + + + +Description + +This parameter provides +one means of adjusting the left margin for titles. +The left margin of the body region +is calculated to include this space, +and titles are outdented to the left by this amount, +effectively leaving titles at the left margin +and the body text indented. +Currently this method is only used for FOP because +it cannot properly use the body.start.indent +parameter. +the relative + + +The default value for FOP is -4pc, which means the +body text is indented 4 picas relative to +the titles. +The default value for other processors is 0pt, and +the body indent is provided by the body.start.indent +parameter. + + +If you set the value to zero, be sure to still include +a unit indicator such as 0pt, or +the FO processor will report errors. + + +This parameter must be set to 0pt if the +passivetex.extensions +parameter is nonzero because PassiveTeX cannot handle +the math expression with negative values +used to calculate the indents. + + + + diff --git a/src/documentation/docbook-xsl/params/toc.indent.width.xml b/src/documentation/docbook-xsl/params/toc.indent.width.xml new file mode 100644 index 0000000000..5ca83a45e2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/toc.indent.width.xml @@ -0,0 +1,28 @@ + + +toc.indent.width +float + + +toc.indent.width +Amount of indentation for TOC entries + + + + + + + + +Description + +Specifies, in points, the distance by which each level of the +TOC is indented from its parent. + +This value is expressed in points, without +a unit (in other words, it is a bare number). Using a bare number allows the stylesheet +to perform calculations that would otherwise have to be performed by the FO processor +because not all processors support expressions. + + + diff --git a/src/documentation/docbook-xsl/params/toc.line.properties.xml b/src/documentation/docbook-xsl/params/toc.line.properties.xml new file mode 100644 index 0000000000..2abb47ad92 --- /dev/null +++ b/src/documentation/docbook-xsl/params/toc.line.properties.xml @@ -0,0 +1,35 @@ + + +toc.line.properties +attribute set + + +toc.line.properties +Properties for lines in ToC and LoTs + + + + + + justify + start + + + + +Description + +Properties which are applied to every line in ToC (or LoT). You can +modify them in order to change appearance of all, or some lines. For +example in order to make lines for chapters in bold specify the +following in your customization layer. + + + + bold + normal + +]]> + + + diff --git a/src/documentation/docbook-xsl/params/toc.list.type.xml b/src/documentation/docbook-xsl/params/toc.list.type.xml new file mode 100644 index 0000000000..a0475b8a0d --- /dev/null +++ b/src/documentation/docbook-xsl/params/toc.list.type.xml @@ -0,0 +1,25 @@ + + +toc.list.type +list +dl +ul +ol + + +toc.list.type +Type of HTML list element to use for Tables of Contents + + + +dl + + +Description + +When an automatically generated Table of Contents (or List of Titles) +is produced, this HTML element will be used to make the list. + + + + diff --git a/src/documentation/docbook-xsl/params/toc.margin.properties.xml b/src/documentation/docbook-xsl/params/toc.margin.properties.xml new file mode 100644 index 0000000000..0773967762 --- /dev/null +++ b/src/documentation/docbook-xsl/params/toc.margin.properties.xml @@ -0,0 +1,24 @@ + + +toc.margin.properties +Margin properties used on Tables of Contents + + + + + + 0.5em + 1em + 2em + 0.5em + 1em + 2em + + + + +Description +This attribute set is used on Tables of Contents. These attributes are set +on the wrapper that surrounds the ToC block, not on each individual lines. + + diff --git a/src/documentation/docbook-xsl/params/toc.max.depth.xml b/src/documentation/docbook-xsl/params/toc.max.depth.xml new file mode 100644 index 0000000000..d96d026583 --- /dev/null +++ b/src/documentation/docbook-xsl/params/toc.max.depth.xml @@ -0,0 +1,20 @@ + + +toc.max.depth +integer + + +toc.max.depth +How maximaly deep should be each TOC? + + + +8 + + +Description + +Specifies the maximal depth of TOC on all levels. + + + diff --git a/src/documentation/docbook-xsl/params/toc.section.depth.xml b/src/documentation/docbook-xsl/params/toc.section.depth.xml new file mode 100644 index 0000000000..3051219a9b --- /dev/null +++ b/src/documentation/docbook-xsl/params/toc.section.depth.xml @@ -0,0 +1,23 @@ + + +toc.section.depth +integer + + +toc.section.depth +How deep should recursive sections appear +in the TOC? + + + +2 + + +Description + +Specifies the depth to which recursive sections should appear in the +TOC. + + + + diff --git a/src/documentation/docbook-xsl/params/ulink.footnotes.xml b/src/documentation/docbook-xsl/params/ulink.footnotes.xml new file mode 100644 index 0000000000..9a1ee1ca98 --- /dev/null +++ b/src/documentation/docbook-xsl/params/ulink.footnotes.xml @@ -0,0 +1,24 @@ + + +ulink.footnotes +boolean + + +ulink.footnotes +Generate footnotes for ULinks? + + + + + + + + +Description + +If non-zero, the URL of each ULink will +appear as a footnote. + + + + diff --git a/src/documentation/docbook-xsl/params/ulink.hyphenate.chars.xml b/src/documentation/docbook-xsl/params/ulink.hyphenate.chars.xml new file mode 100644 index 0000000000..e582671c08 --- /dev/null +++ b/src/documentation/docbook-xsl/params/ulink.hyphenate.chars.xml @@ -0,0 +1,32 @@ + + +ulink.hyphenate.chars +string + + +ulink.hyphenate.chars +List of characters to allow ulink URLs to be automatically hyphenated on + + + + + + + + +Description + +If the ulink.hyphenate is not empty, then +hyphenation of ulinks is turned on, and any +character contained in this parameter is treated as an allowable +hyphenation point. + +The default value is /, but the parameter +could be customized +to contain other URL characters, as for example: + +<xsl:param name="ulink.hyphenate.chars">:/@&?.#</xsl:param> + + + + diff --git a/src/documentation/docbook-xsl/params/ulink.hyphenate.xml b/src/documentation/docbook-xsl/params/ulink.hyphenate.xml new file mode 100644 index 0000000000..1838777d34 --- /dev/null +++ b/src/documentation/docbook-xsl/params/ulink.hyphenate.xml @@ -0,0 +1,30 @@ + + +ulink.hyphenate +string + + +ulink.hyphenate +Allow URLs to be automatically hyphenated + + + + + + + + +Description + +If not empty, the specified character (or more generally, content) is +added to URLs after every character included in the string +in the ulink.hyphenate.chars parameter (default +is /). If the character in this parameter is a +Unicode soft hyphen (0x00AD) or Unicode zero-width space (0x200B), some FO +processors will be able to reasonably hyphenate long URLs. + +As of 28 Jan 2002, discretionary hyphens are more widely and correctly +supported than zero-width spaces for this purpose. + + + diff --git a/src/documentation/docbook-xsl/params/ulink.show.xml b/src/documentation/docbook-xsl/params/ulink.show.xml new file mode 100644 index 0000000000..be6bcc2387 --- /dev/null +++ b/src/documentation/docbook-xsl/params/ulink.show.xml @@ -0,0 +1,24 @@ + + +ulink.show +boolean + + +ulink.show +Display URLs after ulinks? + + + + + + + + +Description + +If non-zero, the URL of each ULink will +appear after the text of the link. If the text of the link and the URL +are identical, the URL is suppressed. + + + diff --git a/src/documentation/docbook-xsl/params/ulink.target.xml b/src/documentation/docbook-xsl/params/ulink.target.xml new file mode 100644 index 0000000000..010effe21a --- /dev/null +++ b/src/documentation/docbook-xsl/params/ulink.target.xml @@ -0,0 +1,22 @@ + + +ulink.target +string + + +ulink.target +The HTML anchor target for ULinks + + + + + + +Description + +If ulink.target is set, its value will +be used for the target attribute +on anchors generated for ulinks. + + + diff --git a/src/documentation/docbook-xsl/params/use.embed.for.svg.xml b/src/documentation/docbook-xsl/params/use.embed.for.svg.xml new file mode 100644 index 0000000000..9b82c60af7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/use.embed.for.svg.xml @@ -0,0 +1,28 @@ + + +use.embed.for.svg +boolean + + +use.embed.for.svg +Use HTML embed for SVG? + + + + + + + + +Description + +If non-zero, an embed element will be created for +SVG figures. An object is always created, +this parameter merely controls whether or not an additional embed +is generated inside the object. + +On the plus side, this may be more portable among browsers and plug-ins. +On the minus side, it isn't valid HTML. + + + diff --git a/src/documentation/docbook-xsl/params/use.extensions.xml b/src/documentation/docbook-xsl/params/use.extensions.xml new file mode 100644 index 0000000000..721bf59d54 --- /dev/null +++ b/src/documentation/docbook-xsl/params/use.extensions.xml @@ -0,0 +1,24 @@ + + +use.extensions +boolean + + +use.extensions +Enable extensions + + + + + + +Description + +If non-zero, extensions may be used. Each extension is +further controlled by its own parameter. But if +use.extensions is zero, no extensions will +be used. + + + + diff --git a/src/documentation/docbook-xsl/params/use.id.as.filename.xml b/src/documentation/docbook-xsl/params/use.id.as.filename.xml new file mode 100644 index 0000000000..90beb8df03 --- /dev/null +++ b/src/documentation/docbook-xsl/params/use.id.as.filename.xml @@ -0,0 +1,23 @@ + + +use.id.as.filename +boolean + + +use.id.as.filename +Use ID value of chunk elements as the filename? + + + + + + +Description + +If use.id.as.filename +is non-zero, the filename of chunk elements that have IDs will be +derived from the ID value. + + + + diff --git a/src/documentation/docbook-xsl/params/use.id.function.xml b/src/documentation/docbook-xsl/params/use.id.function.xml new file mode 100644 index 0000000000..b9ceb58904 --- /dev/null +++ b/src/documentation/docbook-xsl/params/use.id.function.xml @@ -0,0 +1,25 @@ + + +use.id.function +boolean + + +use.id.function +Use the XPath id() function to find link targets? + + + + + + +Description + +If 1, the stylesheets use the id() function +to find the targets of cross reference elements. This is more +efficient, but only works if your XSLT processor implements the +id() function, naturally. +THIS PARAMETER IS NOT SUPPORTED. IT IS ALWAYS ASSUMED TO BE 1. +SEE xref.xsl IF YOU NEED TO TURN IT OFF. + + + diff --git a/src/documentation/docbook-xsl/params/use.local.olink.style.xml b/src/documentation/docbook-xsl/params/use.local.olink.style.xml new file mode 100644 index 0000000000..3b893792e1 --- /dev/null +++ b/src/documentation/docbook-xsl/params/use.local.olink.style.xml @@ -0,0 +1,23 @@ + + +use.local.olink.style +boolean + + +use.local.olink.style +Process olinks using xref style of current +document + + + + + +Description +When cross reference data is collected for use by olinks, the data for each potential target includes one field containing a completely assembled cross reference string, as if it were an xref generated in that document. Other fields record the separate title, number, and element name of each target. When an olink is formed to a target from another document, the olink resolves to that preassembled string by default. If the use.local.olink.style parameter is set to non-zero, then instead the cross +reference string is formed again from the target title, number, and +element name, using the stylesheet processing the targeting document. +Then olinks will match the xref style in the targeting document +rather than in the target document. If both documents are processed +with the same stylesheet, then the results will be the same. + + diff --git a/src/documentation/docbook-xsl/params/use.role.as.xrefstyle.xml b/src/documentation/docbook-xsl/params/use.role.as.xrefstyle.xml new file mode 100644 index 0000000000..9f29e95c2f --- /dev/null +++ b/src/documentation/docbook-xsl/params/use.role.as.xrefstyle.xml @@ -0,0 +1,91 @@ + + +use.role.as.xrefstyle +boolean + + +use.role.as.xrefstyle +Use role attribute for +xrefstyle on xref? + + + + + + + + +Description + +If non-zero, the role attribute on +xref will be used to select the cross reference style. +The DocBook +Technical Committee recently added an +xrefstyle attribute for this purpose. +If the xrefstyle attribute +is present, role will be ignored, regardless +of this setting. + +Until an official DocBook release that includes the new +attribute, this flag allows role +to serve that purpose. + + + +Example + +The following small stylesheet shows how to configure the stylesheets to make +use of the cross reference style: + + + + + + + + + + + + + + + + + + +]]> + +With this stylesheet, the cross references in the following document: + + + +Book + + +Preface + +Normal: . +Title: . + + + + +First Chapter + +Irrelevant. + + +]]> + +will appear as: + + +Normal: Chapter 1. +Title: Chapter 1, First Chapter. + + + + diff --git a/src/documentation/docbook-xsl/params/use.role.for.mediaobject.xml b/src/documentation/docbook-xsl/params/use.role.for.mediaobject.xml new file mode 100644 index 0000000000..d78df18979 --- /dev/null +++ b/src/documentation/docbook-xsl/params/use.role.for.mediaobject.xml @@ -0,0 +1,51 @@ + + +use.role.for.mediaobject +boolean + + +use.role.for.mediaobject +Use role attribute +value for selecting which of several objects within a mediaobject to use. + + + + + + + + + +Description + +If non-zero, the role attribute on +imageobjects or other objects within a mediaobject container will be used to select which object will be +used. + + +The order of selection when then parameter is non-zero is: + + + + If the stylesheet parameter preferred.mediaobject.role has a value, then the object whose role equals that value is selected. + + +Else if an object's role attribute has a value of +html for HTML processing or +fo for FO output, then the first +of such objects is selected. + + + +Else the first suitable object is selected. + + + +If the value of +use.role.for.mediaobject +is zero, then role attributes are not considered +and the first suitable object +with or without a role value is used. + + + diff --git a/src/documentation/docbook-xsl/params/use.svg.xml b/src/documentation/docbook-xsl/params/use.svg.xml new file mode 100644 index 0000000000..041d1addc6 --- /dev/null +++ b/src/documentation/docbook-xsl/params/use.svg.xml @@ -0,0 +1,25 @@ + + +use.svg +boolean + + +use.svg +Allow SVG in the result tree? + + + + + + + + +Description + +If non-zero, SVG will be considered an acceptable image format. SVG +is passed through to the result tree, so correct rendering of the resulting +diagram depends on the formatter (FO processor or web browser) that is used +to process the output from the stylesheet. + + + diff --git a/src/documentation/docbook-xsl/params/variablelist.as.blocks.xml b/src/documentation/docbook-xsl/params/variablelist.as.blocks.xml new file mode 100644 index 0000000000..7d9ba46af2 --- /dev/null +++ b/src/documentation/docbook-xsl/params/variablelist.as.blocks.xml @@ -0,0 +1,57 @@ + + +variablelist.as.blocks +boolean + + +variablelist.as.blocks +Format variablelists lists as blocks? + + + + + + + + +Description + +If non-zero, variablelists will be formatted as +blocks. + +If you have long terms, proper list markup in the FO case may produce +unattractive lists. By setting this parameter, you can force the stylesheets +to produce block markup instead of proper lists. + +You can override this setting with a processing instruction as the +child of variablelist: dbfo +list-presentation="blocks" or dbfo +list-presentation="list". + +When using list-presentation="list", +you can also control the amount of space used for the terms with +the dbfo term-width=".25in" processing instruction, +the termlength attribute on variablelist, +or allow the stylesheets to attempt to calculate the amount of space to leave based on the +number of letters in the longest term. + + + + + + + + + list + + + Formatted as a list even if variablelist.as.blocks is set to 1. + + + + ]]> + + + + + diff --git a/src/documentation/docbook-xsl/params/variablelist.as.table.xml b/src/documentation/docbook-xsl/params/variablelist.as.table.xml new file mode 100644 index 0000000000..b9148ea9dd --- /dev/null +++ b/src/documentation/docbook-xsl/params/variablelist.as.table.xml @@ -0,0 +1,49 @@ + + +variablelist.as.table +boolean + + +variablelist.as.table +Format variablelists as tables? + + + + + + + + +Description + +If non-zero, variablelists will be formatted as +tables. A processing instruction exists to specify a particualar width for the +column containing the terms: +dbhtml term-width=".25in" + +You can override this setting with a processing instruction as the +child of variablelist: dbhtml +list-presentation="table" or dbhtml +list-presentation="list". + +This parameter only applys to the HTML transformations. In the +FO case, proper list markup is robust enough to handle the formatting. +But see also variablelist.as.blocks. + + + + + + + + list + + + Formatted as a table even if variablelist.as.table is set to 0. + + + + ]]> + + + diff --git a/src/documentation/docbook-xsl/params/variablelist.max.termlength.xml b/src/documentation/docbook-xsl/params/variablelist.max.termlength.xml new file mode 100644 index 0000000000..8cad72df7d --- /dev/null +++ b/src/documentation/docbook-xsl/params/variablelist.max.termlength.xml @@ -0,0 +1,41 @@ + + +variablelist.max.termlength + + + +variablelist.max.termlength +Specifies the longest term in variablelists + + + + +24 + + + +Description + +In variablelists, the listitem +is indented to leave room for the +term elements. That indent may be computed +if it is not specified with a termlength +attribute on the variablelist element. + + +The computation counts characters in the +term elements in the list +to find the longest term. However, some terms are very long +and would produce extreme indents. This parameter lets you +set a maximum character count. Any terms longer than the maximum +would line wrap. The default value is 24. + + +The character counts are converted to physical widths +by multiplying by 0.50em. There will be some variability +in how many actual characters fit in the space +since some characters are wider than others. + + + + diff --git a/src/documentation/docbook-xsl/params/variablelist.term.break.after.xml b/src/documentation/docbook-xsl/params/variablelist.term.break.after.xml new file mode 100644 index 0000000000..f488d53351 --- /dev/null +++ b/src/documentation/docbook-xsl/params/variablelist.term.break.after.xml @@ -0,0 +1,34 @@ + + +variablelist.term.break.after +boolean + + +variablelist.term.break.after +Generate line break after each term within a +multi-term varlistentry? + + + + +0 + + +Description + +Set a non-zero value for the +variablelist.term.break.after parameter to +generate a line break between terms in a +multi-term varlistentry. + + +If you set a non-zero value for +variablelist.term.break.after, you may also +want to set the value of the +variablelist.term.separator parameter to an +empty string (to suppress rendering of the default comma and space +after each term). + + + + diff --git a/src/documentation/docbook-xsl/params/variablelist.term.separator.xml b/src/documentation/docbook-xsl/params/variablelist.term.separator.xml new file mode 100644 index 0000000000..74b28cd57b --- /dev/null +++ b/src/documentation/docbook-xsl/params/variablelist.term.separator.xml @@ -0,0 +1,35 @@ + + +variablelist.term.separator +string + + +variablelist.term.separator +Text to separate terms within a multi-term +varlistentry + + + + +, + + +Description + +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is placed +after each term except the last. + + + To generate a line break between multiple terms in + a varlistentry, set a non-zero value for the + variablelist.term.break.after parameter. If + you do so, you may also want to set the value of the + variablelist.term.separator parameter to an + empty string (to suppress rendering of the default comma and space + after each term). + + + + diff --git a/src/documentation/docbook-xsl/params/verbatim.properties.xml b/src/documentation/docbook-xsl/params/verbatim.properties.xml new file mode 100644 index 0000000000..be93b35154 --- /dev/null +++ b/src/documentation/docbook-xsl/params/verbatim.properties.xml @@ -0,0 +1,24 @@ + + +verbatim.properties +Properties associated with verbatim text + + + + + + 0.8em + 1em + 1.2em + 0.8em + 1em + 1.2em + false + + + +Description +This attribute set is used on all verbatim environments. + + + diff --git a/src/documentation/docbook-xsl/params/wordml.template.xml b/src/documentation/docbook-xsl/params/wordml.template.xml new file mode 100644 index 0000000000..a3ef3f9bda --- /dev/null +++ b/src/documentation/docbook-xsl/params/wordml.template.xml @@ -0,0 +1,23 @@ + + +wordml.template + + +wordml.template +Specify the template WordML document + + + + + + + + +Description + +The wordml.template parameter specifies a WordML document to use as a template for the generated document. The template document is used to define the (extensive) headers for the generated document, in particular the paragraph and character styles that are used to format the various elements. Any content in the template document is ignored. + +A template document is used in order to allow maintenance of the paragraph and character styles to be done using Word itself, rather than these XSL stylesheets. + + + diff --git a/src/documentation/docbook-xsl/params/xep.extensions.xml b/src/documentation/docbook-xsl/params/xep.extensions.xml new file mode 100644 index 0000000000..f28029c9c7 --- /dev/null +++ b/src/documentation/docbook-xsl/params/xep.extensions.xml @@ -0,0 +1,26 @@ + + +xep.extensions +boolean + + +xep.extensions +Enable XEP extensions? + + + + + + +Description + +If non-zero, +XEP +extensions will be used. XEP extensions consists of PDF bookmarks, +document information and better index processing. + + +This parameter can also affect which graphics file formats +are supported + + diff --git a/src/documentation/docbook-xsl/params/xep.index.item.properties.xml b/src/documentation/docbook-xsl/params/xep.index.item.properties.xml new file mode 100644 index 0000000000..460daf5892 --- /dev/null +++ b/src/documentation/docbook-xsl/params/xep.index.item.properties.xml @@ -0,0 +1,24 @@ + + +xep.index.item.properties +Properties associated with XEP index-items + + + + + + true + true + + + + +Description + +Properties associated with XEP index-items. For more info see +the section "Indexes" in +. + + + diff --git a/src/documentation/docbook-xsl/params/xref.label-page.separator.xml b/src/documentation/docbook-xsl/params/xref.label-page.separator.xml new file mode 100644 index 0000000000..a544002948 --- /dev/null +++ b/src/documentation/docbook-xsl/params/xref.label-page.separator.xml @@ -0,0 +1,33 @@ + + +xref.label-page.separator +string + + +xref.label-page.separator +Punctuation or space separating label from page number in xref + + + + + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and page +but no title, +then the value of this parameter is inserted between +label and page number in the output. +If a title is included, then other separators are used. + + + + diff --git a/src/documentation/docbook-xsl/params/xref.label-title.separator.xml b/src/documentation/docbook-xsl/params/xref.label-title.separator.xml new file mode 100644 index 0000000000..7e21c25c84 --- /dev/null +++ b/src/documentation/docbook-xsl/params/xref.label-title.separator.xml @@ -0,0 +1,31 @@ + + +xref.label-title.separator +string + + +xref.label-title.separator +Punctuation or space separating label from title in xref + + + +: + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and title, +then the value of this parameter is inserted between +label and title in the output. + + + + diff --git a/src/documentation/docbook-xsl/params/xref.properties.xml b/src/documentation/docbook-xsl/params/xref.properties.xml new file mode 100644 index 0000000000..2465cae0f3 --- /dev/null +++ b/src/documentation/docbook-xsl/params/xref.properties.xml @@ -0,0 +1,20 @@ + + +xref.properties +Properties associated with cross-reference text + + + + + + + + + +Description + +This attribute set is used to set properties +on cross reference text. + + + diff --git a/src/documentation/docbook-xsl/params/xref.title-page.separator.xml b/src/documentation/docbook-xsl/params/xref.title-page.separator.xml new file mode 100644 index 0000000000..c38ebb400d --- /dev/null +++ b/src/documentation/docbook-xsl/params/xref.title-page.separator.xml @@ -0,0 +1,31 @@ + + +xref.title-page.separator +string + + +xref.title-page.separator +Punctuation or space separating title from page number in xref + + + + + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both title and page number, +then the value of this parameter is inserted between +title and page number in the output. + + + + diff --git a/src/documentation/docbook-xsl/params/xref.with.number.and.title.xml b/src/documentation/docbook-xsl/params/xref.with.number.and.title.xml new file mode 100644 index 0000000000..0656835d09 --- /dev/null +++ b/src/documentation/docbook-xsl/params/xref.with.number.and.title.xml @@ -0,0 +1,22 @@ + + +xref.with.number.and.title +boolean + + +xref.with.number.and.title +Use number and title in cross references + + + + + + + + +Description + +FIXME: + + + diff --git a/src/documentation/docbook-xsl/profiling/profile-mode.xsl b/src/documentation/docbook-xsl/profiling/profile-mode.xsl new file mode 100644 index 0000000000..4d549e1893 --- /dev/null +++ b/src/documentation/docbook-xsl/profiling/profile-mode.xsl @@ -0,0 +1,191 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/profiling/profile.xsl b/src/documentation/docbook-xsl/profiling/profile.xsl new file mode 100644 index 0000000000..4f5029688c --- /dev/null +++ b/src/documentation/docbook-xsl/profiling/profile.xsl @@ -0,0 +1,46 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/profiling/strip-attributes.xsl b/src/documentation/docbook-xsl/profiling/strip-attributes.xsl new file mode 100644 index 0000000000..d6f55fb503 --- /dev/null +++ b/src/documentation/docbook-xsl/profiling/strip-attributes.xsl @@ -0,0 +1,27 @@ + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/profiling/xsl2profile.xsl b/src/documentation/docbook-xsl/profiling/xsl2profile.xsl new file mode 100644 index 0000000000..eea98c90a2 --- /dev/null +++ b/src/documentation/docbook-xsl/profiling/xsl2profile.xsl @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + This file was created automatically by xsl2profile + + from the DocBook XSL stylesheets. Do not edit this file. + + + + + + + + + dummy + dummy + dummy + + exslt + + + exslt + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Stripping NS from DocBook 5/NG document. + + + + Processing stripped document. + + + + + + + + + + + + + + + + + + + + + + + + + + + $profiled-nodes + + + $profiled-nodes + + + + + + + + + + + + + + + + + + + key('id',$rootid) + $profiled-nodes//*[@id=$rootid] + + + + + + + + + + + + + + + + + $profiled-nodes/node() + + + + + + + + false() + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/slides/browser/CTOCWidget.js b/src/documentation/docbook-xsl/slides/browser/CTOCWidget.js new file mode 100644 index 0000000000..a411ea9959 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/CTOCWidget.js @@ -0,0 +1,169 @@ +/* + * CTOCWidget.js + * $Revision: 1.3 $ $Date: 2003/07/14 06:02:50 $ + */ + +/* ***** BEGIN LICENSE BLOCK ***** + * Version: MPL 1.1/GPL 2.0/LGPL 2.1 + * + * The contents of this file are subject to the Mozilla Public License Version + * 1.1 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * http://www.mozilla.org/MPL/ + * + * Software distributed under the License is distributed on an "AS IS" basis, + * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License + * for the specific language governing rights and limitations under the + * License. + * + * The Original Code is Netscape code. + * + * The Initial Developer of the Original Code is + * Netscape Corporation. + * Portions created by the Initial Developer are Copyright (C) 2003 + * the Initial Developer. All Rights Reserved. + * + * Contributor(s): Bob Clary + * + * ***** END LICENSE BLOCK ***** */ + +function CTOCWidget(domTOCModel, target) +{ + if (domTOCModel.documentElement.nodeName != 'toc') + { + throw 'CTOCWidget called on non toc Document: ' + domTOCModel.nodeName; + } + + this.model = domTOCModel; + this.target = target; + this.view = document.createElement('div'); + this.view.setAttribute('class', CTOCWidget._classprefix + '_view'); + + var modelItems = domTOCModel.documentElement.childNodes; + for (var i = 0; i < modelItems.length; i++) + { + var modelItem = modelItems.item(i); + if (modelItem.nodeType == Node.ELEMENT_NODE) + { + var viewItem = CTOCWidget.createItemView(modelItem, target); + this.view.appendChild(viewItem); + } + } +} + +CTOCWidget._handleImages = { open: '/toolbox/examples/2003/CTOCWidget/minus.gif', closed: '/toolbox/examples/2003/CTOCWidget/plus.gif', height: '12px', width: '16px'}; +CTOCWidget._classprefix = 'CTOCWidget'; + +CTOCWidget.createItemView = function (modelItem, target) +{ + if (modelItem.nodeType != Node.ELEMENT_NODE) + { + throw 'CTOCWidget.createItemView called on non-Element: ' + modelItem.nodeName; + } + + var i; + + var viewItem = document.createElement('div'); + viewItem.setAttribute('class', CTOCWidget._classprefix + '_item'); + + var viewItemHandle = document.createElement('div'); + viewItemHandle.setAttribute('class', CTOCWidget._classprefix + '_itemhandle'); + viewItemHandle.style.cursor = 'pointer'; + + var viewItemHandleImg = document.createElement('img'); + viewItemHandleImg.style.height = CTOCWidget._handleImages.height; + viewItemHandleImg.style.width = CTOCWidget._handleImages.width; + viewItemHandleImg.addEventListener('click', CTOCWidget.toggleHandle, false); + + var viewItemHandleLink; + if (!modelItem.getAttribute('url')) + { + viewItemHandleLink = document.createElement('span'); + } + else + { + viewItemHandleLink = document.createElement('a'); + viewItemHandleLink.setAttribute('href', modelItem.getAttribute('url')); + viewItemHandleLink.setAttribute('target', target); + } + viewItemHandleLink.appendChild(document.createTextNode(modelItem.getAttribute('title'))); + + viewItemHandle.appendChild(viewItemHandleImg); + viewItemHandle.appendChild(viewItemHandleLink); + viewItem.appendChild(viewItemHandle); + + if (modelItem.childNodes.length == 0) + { + viewItemHandleImg.setAttribute('src', CTOCWidget._handleImages.open); + } + else + { + viewItemHandleImg.setAttribute('src', CTOCWidget._handleImages.closed); + + var viewItemChildren = document.createElement('div'); + viewItemChildren.setAttribute('class', CTOCWidget._classprefix + '_itemchildren'); + viewItemChildren.style.display = 'none'; + viewItemChildren.style.position = 'relative'; + viewItemChildren.style.left = '1em'; + + for (i = 0; i < modelItem.childNodes.length; i++) + { + var modelItemChild = modelItem.childNodes.item(i); + if (modelItemChild.nodeType == Node.ELEMENT_NODE) + { + viewItemChildren.appendChild(CTOCWidget.createItemView(modelItemChild, target)); + } + } + + viewItem.appendChild(viewItemChildren); + } + + return viewItem; +}; + +// fires on img part of the handle +CTOCWidget.toggleHandle = function(e) +{ + switch (e.eventPhase) + { + case Event.CAPTURING_PHASE: + case Event.BUBBLING_PHASE: + return true; + + case Event.AT_TARGET: + + e.preventBubble(); + + var domHandle = e.target.parentNode; + var domChildren = domHandle.nextSibling; + + if (!domChildren) + { + return true; + } + + switch(domChildren.style.display) + { + case '': + case 'block': + domChildren.style.display = 'none'; + e.target.setAttribute('src', CTOCWidget._handleImages.closed); + break; + case 'none': + domChildren.style.display = 'block'; + e.target.setAttribute('src', CTOCWidget._handleImages.open); + break; + default: + return false; + } + + return true; + + default: + dump('Unknown Event Phase ' + e.eventPhase); + break; + } + + return true; +} + diff --git a/src/documentation/docbook-xsl/slides/browser/overlay.js b/src/documentation/docbook-xsl/slides/browser/overlay.js new file mode 100644 index 0000000000..fc010fbe96 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/overlay.js @@ -0,0 +1,142 @@ +// -*- Java -*- +// +// Overlay.js, adapted from Floating image II on dynamicdrive.com +/* Usage: + + + +...rest of head... + + +
                  +...body of overlay... +
                  +...rest of page... +*/ + +var overlayNS4 = document.layers ? 1 : 0; +var overlayIE = document.all ? 1 : 0; +var overlayNS6 = document.getElementById && !document.all ? 1 : 0; + +var overlayPadX = 15; +var overlayPadY = 15; +var overlayDelay = 60; + +var overlayCorner = 'ur'; // ul, ll, ur, lr, uc, lc, cl, cr + +function overlayRefresh() { + var overlayLx = 0; + var overlayLy = 0; + + var overlayX = 0; + var overlayY = 0; + var overlayW = 0; + var overlayH = 0; + var contentH = 0; + + var links = document.getElementsByTagName("body")[0]; + + if (overlayIE) { + overlayLx = document.body.clientWidth; + overlayLy = document.body.clientHeight; + + if (document.body.parentElement) { + // For IE6 + overlayLx = document.body.parentElement.clientWidth; + overlayLy = document.body.parentElement.clientHeight; + } + + overlayH = overlayDiv.offsetHeight; + overlayW = body.offsetWidth; // overlayDiv.offsetWidth; + contentH = body.offsetHeight; + } else if (overlayNS4) { + overlayLy = window.innerHeight; + overlayLx = window.innerWidth; + overlayH = document.overlayDiv.clip.height; + overlayW = body.clip.width; // document.overlayDiv.clip.width; + contentH = body.clip.height; + } else if (overlayNS6) { + var odiv = document.getElementById('overlayDiv'); + + overlayLy = window.innerHeight; + overlayLx = window.innerWidth; + overlayH = odiv.offsetHeight; + overlayW = odiv.offsetWidth; // body.offsetWidth; + contentH = odiv.offsetHeight; + } + + if (overlayCorner == 'ul') { + overlayX = overlayPadX; + overlayY = overlayPadY; + } else if (overlayCorner == 'cl') { + overlayX = overlayPadX; + overlayY = (overlayLy - overlayH) / 2; + } else if (overlayCorner == 'll') { + overlayX = overlayPadX; + overlayY = (overlayLy - overlayH) - overlayPadY; + } else if (overlayCorner == 'ur') { + overlayX = (overlayLx - overlayW) - overlayPadX; + overlayY = overlayPadY; + } else if (overlayCorner == 'cr') { + overlayX = (overlayLx - overlayW) - overlayPadX; + overlayY = (overlayLy - overlayH) / 2; + } else if (overlayCorner == 'lr') { + overlayX = (overlayLx - overlayW) - overlayPadX; + overlayY = (overlayLy - overlayH) - overlayPadY; + } else if (overlayCorner == 'uc') { + overlayX = (overlayLx - overlayW) / 2; + overlayY = overlayPadY; + } else { // overlayCorner == 'lc' + overlayX = (overlayLx - overlayW) / 2; + overlayY = (overlayLy - overlayH) - overlayPadY; + } + + if (overlayIE) { + overlayDiv.style.left=overlayX; + overlayDiv.style.top=overlayY+document.body.scrollTop; + + if (contentH > overlayLy) { + overlayDiv.style.visibility = "hidden"; + } + } else if (overlayNS4) { + document.overlayDiv.pageX=overlayX; + document.overlayDiv.pageY=overlayY+window.pageYOffset; + document.overlayDiv.visibility="visible"; + + if (contentH > overlayLy) { + document.overlayDiv.style.visibility = "hidden"; + } + } else if (overlayNS6) { + var div = document.getElementById("overlayDiv"); + var leftpx = overlayX; + var toppx = overlayY+window.pageYOffset; + var widthpx = overlayW; + + div.style.left = leftpx + "px"; + div.style.top = toppx + "px"; + div.style.width = widthpx + "px"; + + if (contentH > overlayLy) { + div.style.visibility = "hidden"; + } else { + div.style.visibility = "visible"; + } + } +} + +function onad() { + loopfunc(); +} + +function loopfunc() { + overlayRefresh(); + setTimeout('loopfunc()',overlayDelay); +} + +function overlaySetup(corner) { + overlayCorner = corner; + + if (overlayIE || overlayNS4 || overlayNS6) { + onad(); + } +} diff --git a/src/documentation/docbook-xsl/slides/browser/slides-default.css b/src/documentation/docbook-xsl/slides/browser/slides-default.css new file mode 100644 index 0000000000..1022d6bc0e --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/slides-default.css @@ -0,0 +1,9 @@ +@import url('slides.css'); + +.toclink { font-size: 10pt; + font-weight: normal; + } + +.toclink a { color: blue; } +.toclink a:link { color: blue; } +.toclink a:visited { color: blue; } diff --git a/src/documentation/docbook-xsl/slides/browser/slides-frames.css b/src/documentation/docbook-xsl/slides/browser/slides-frames.css new file mode 100644 index 0000000000..698b6a3e25 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/slides-frames.css @@ -0,0 +1,73 @@ +@import url('slides.css'); + +.toc-body { margin-left: 2px; + margin-right: 2px; + } + +.foil-body { margin-left: 2px; + margin-right: 2px; + } + +h1.title { margin-top: 0px; + padding-top: 0px; + } + +.navhead { visibility: visible; + } + +.navfoot { visibility: visible; + } + +/* ====================================================================== */ + +.navfoot { border-top: 1px solid black; + margin-top: 10px; + padding-top: 4px; + } +/* ====================================================================== */ + +.toc { font-weight: bold; + font-size: 10pt; + } + +.toc a { text-decoration: none; } +.toc a:link { color: blue; } +.toc a:visited { color: blue; } + +.toc .toc-foilgroup a { color: red; } +.toc .toc-foilgroup a:link { color: red; } +.toc .toc-foilgroup a:visited { color: red; } + +.toc .toc-titlefoil a { color: black; } +.toc .toc-titlefoil a:link { color: black; } +.toc .toc-titlefoil a:visited { color: black; } + +.toc .toc-foil a { color: blue; } +.toc .toc-foil a:link { color: blue; } +.toc .toc-foil a:visited { color: blue; } + +.toc-slidesinfo { font-family: sans-serif; + font-weight: bold; + text-align: center; + } + +.toc-titlefoil { font-family: sans-serif; + font-weight: bold; + text-align: center; + } + +.toc-foilgroup { font-family: sans-serif; + margin-left: 0.25in; + text-indent: -0.25in; + font-weight: bold; + color: red; + } + +.toc-foil { font-family: sans-serif; + font-size: 10pt; + margin-left: 0.25in; + text-indent: -0.4in; + font-weight: bold; + color: blue; + } + diff --git a/src/documentation/docbook-xsl/slides/browser/slides-plain.css b/src/documentation/docbook-xsl/slides/browser/slides-plain.css new file mode 100644 index 0000000000..c22f2891ca --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/slides-plain.css @@ -0,0 +1 @@ +@import url('slides.css'); diff --git a/src/documentation/docbook-xsl/slides/browser/slides-table.css b/src/documentation/docbook-xsl/slides/browser/slides-table.css new file mode 100644 index 0000000000..1c195c9e58 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/slides-table.css @@ -0,0 +1,41 @@ +@import url('slides.css'); + +.toc-body { margin-left: 2px; + margin-right: 2px; + } + +.foil-body { margin-left: 2px; + margin-right: 2px; + } + +.foilgroup-body { margin-left: 2px; + margin-right: 2px; + } + +h1.title { + margin-top: 0px; + padding-top: 0px; + } + +/* ToC Stuff */ + +.ttoc { + font-size: 10pt; + color: white; + } + +.ttoc a { text-decoration: none; } +.ttoc a:link { color: white } +.ttoc a:visited { color: white } + +.ttoc-title { + font-size: 10pt; + } + +.ttoc-foilset { + font-size: 10pt; + } + +.ttoc-foil { + font-size: 10pt; + } diff --git a/src/documentation/docbook-xsl/slides/browser/slides-w3c.css b/src/documentation/docbook-xsl/slides/browser/slides-w3c.css new file mode 100644 index 0000000000..c22f2891ca --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/slides-w3c.css @@ -0,0 +1 @@ +@import url('slides.css'); diff --git a/src/documentation/docbook-xsl/slides/browser/slides.css b/src/documentation/docbook-xsl/slides/browser/slides.css new file mode 100644 index 0000000000..1007478e85 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/slides.css @@ -0,0 +1,119 @@ +/* General formatting */ + +body { font-family: sans-serif; + font-weight: bold; + } + +.copyright { color: #7F7F7F; + } + +/* Title page formatting */ + + +.slidesinfo { text-align: center; + font-size: 16pt; + } + +.slidesinfo h1.title { color: blue; + } +.slidesinfo h2.subtitle { color: blue; + } +.slidesinfo h1.author { color: green; + } + +.slidesinfo .copyright { color: black; + } + + +/* ToC page formatting */ + +.tocpage h1.title { color: blue; + text-align: center; + } + +.tocpage a { text-decoration: none; } +.tocpage a:link { color: blue; } +.tocpage a:visited { color: blue; } + +.toc-body { margin-left: 0.5in; + margin-right: 0.5in; + } + +/* Foil page formatting */ + +.foil { font-size: 16pt; + } +.foil h1.title { text-align: center; + color: blue; + padding-top: 0pt; + margin-top: 0pt; + } +.foil h2.subtitle { text-align: center; + color: blue; + padding-top: 0pt; + margin-top: 0pt; + } + +.foil pre { font-size: 16pt; + } + +.foil-body { margin-left: 0.5in; + margin-right: 0.5in; + } + +/* Foilgroup page formatting */ + +.foilgroup { font-size: 16pt; + } +.foilgroup h1.title { text-align: center; + color: red; + padding-top: 0pt; + margin-top: 0pt; + } +.foilgroup h2.subtitle { text-align: center; + color: blue; + padding-top: 0pt; + margin-top: 0pt; + } + +.foilgroup-body { margin-left: 0.5in; + margin-right: 0.5in; + } + +/* Navigation header formatting */ + +.navhead { border-bottom: 1px solid black; + margin-bottom: 10px; + padding-bottom: 4px; + } + +.navhead hr.top-nav-sep { display: none; } + +.navhead .slidestitle { font-weight: normal; + font-size: 10pt; + font-style: italic; + } + +/* Navigation footer formatting */ + +.navfoot { border-top: 1px solid black; + margin-top: 10px; + padding-top: 4px; + } + +.navfoot hr.bottom-nav-sep { display: none; } + +/* General navigation formatting */ + +.link-text { font-weight: bold; + font-size: 10pt; + } + + +.link-text a { text-decoration: none; } +.link-text a:link { color: blue; } +.link-text a:visited { color: blue; } + +.no-link-text { color: #7F7F7F; } + +/* EOF */ diff --git a/src/documentation/docbook-xsl/slides/browser/slides.js b/src/documentation/docbook-xsl/slides/browser/slides.js new file mode 100644 index 0000000000..e7c8083976 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/slides.js @@ -0,0 +1,120 @@ +// -*- Java -*- +// +// $Id: slides.js,v 1.9 2005/06/21 15:45:53 kosek Exp $ +// +// Copyright (C) 2002 Norman Walsh +// +// You are free to use, modify and distribute this software without limitation. +// This software is provided "AS IS," without a warranty of any kind. +// +// This script assumes that the Netscape 'ua.js' module has also been loaded. + +function newPage(filename, overlay) { + divs = document.getElementsByTagName("div"); + + if (divs) { + var xdiv = divs[0]; + + if (xdiv) { + var xid = xdiv.getAttribute("id"); + + var mytoc = window.top.frames[0]; + if (mytoc.lastUnderlined) { + mytoc.lastUnderlined.style.textDecoration = "none"; + } + + var tdiv = xbGetElementById(xid, mytoc); + + if (tdiv) { + var ta = tdiv.getElementsByTagName("a").item(0); + ta.style.textDecoration = "underline"; + mytoc.lastUnderlined = ta; + } + } + } + + if (overlay != 0) { + overlaySetup('lc'); + } +} + + +function navigate (evt) { + var kc = -1; + + if (navigator.org == 'microsoft' || navigator.family == 'opera') { + kc = window.event.keyCode; + } else if (navigator.family == 'gecko') { + kc = evt.keyCode; + if(!kc) { + kc = evt.which; + } + } else { + kc = evt.which; + } + + var forward = (kc == 110) || (kc == 78) || (kc == 32) + || (kc == 10) || (kc == 13) || (kc == 34) + || (kc == 39); + /* n, N, SPACE, ENTER, RETURN, PAGE UP, RIGHT ARROW */ + var backward = (kc == 112) || (kc == 80) || (kc == 8) + || (kc == 33) || (kc == 37); + /* p, P, BACKSPACE, PAGE DOWN, LEFT ARROW */ + var up = (kc == 117) || (kc == 85) || (kc == 38); + /* u, U, UP ARROW */ + var home = (kc == 104) || (kc == 72) || (kc == 36); + /* h, H, HOME */ + var toc = (kc == 116) || (kc == 84); + /* t, T */ + /* previously included META (kc == 244) */ + + var links = document.getElementsByTagName("link"); + + var count = 0; + var target = ""; + + for (count = 0; count < links.length; count++) { + if (home && (links[count].getAttribute("rel") == 'top')) { + target = links[count].getAttribute("href"); + } + if (toc && (links[count].getAttribute("rel") == 'contents')) { + target = links[count].getAttribute("href"); + } + if (up && (links[count].getAttribute("rel") == 'up')) { + target = links[count].getAttribute("href"); + } + if (forward && (links[count].getAttribute("rel") == 'next')) { + target = links[count].getAttribute("href"); + } + if (backward && (links[count].getAttribute("rel") == 'previous')) { + target = links[count].getAttribute("href"); + } + } + + if (target != "") { + if (window.top.frames[1]) { + window.top.frames[1].location = target; + } else { + window.location = target; + } + } + + return false; +} + +function toggletoc (img, width, hidegraphic, showgraphic) { + var fsc = top.GetElementsByTagName('frameset'); + if (fsc) { + var fs = fsc[0]; + if (fs) { + if (fs.cols == "0,*") { + fs.cols = width + ",*"; + img.src = hidegraphic; + } else { + fs.cols = "0,*"; + img.src = showgraphic; + } + } + } +} + diff --git a/src/documentation/docbook-xsl/slides/browser/ua.js b/src/documentation/docbook-xsl/slides/browser/ua.js new file mode 100644 index 0000000000..8987659808 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/ua.js @@ -0,0 +1,135 @@ +/* + * ua.js + * $Revision: 1.2 $ $Date: 2003/02/07 16:04:17 $ + */ + +/* ***** BEGIN LICENSE BLOCK ***** + * Version: MPL 1.1/GPL 2.0/LGPL 2.1 + * + * The contents of this file are subject to the Mozilla Public License Version + * 1.1 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * http://www.mozilla.org/MPL/ + * + * Software distributed under the License is distributed on an "AS IS" basis, + * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License + * for the specific language governing rights and limitations under the + * License. + * + * The Original Code is Netscape code. + * + * The Initial Developer of the Original Code is + * Netscape Corporation. + * Portions created by the Initial Developer are Copyright (C) 2001 + * the Initial Developer. All Rights Reserved. + * + * Contributor(s): Bob Clary + * + * ***** END LICENSE BLOCK ***** */ + +function xbDetectBrowser() +{ + var oldOnError = window.onerror; + var element = null; + + window.onerror = null; + + // work around bug in xpcdom Mozilla 0.9.1 + window.saveNavigator = window.navigator; + + navigator.OS = ''; + navigator.version = parseFloat(navigator.appVersion); + navigator.org = ''; + navigator.family = ''; + + var platform; + if (typeof(window.navigator.platform) != 'undefined') + { + platform = window.navigator.platform.toLowerCase(); + if (platform.indexOf('win') != -1) + navigator.OS = 'win'; + else if (platform.indexOf('mac') != -1) + navigator.OS = 'mac'; + else if (platform.indexOf('unix') != -1 || platform.indexOf('linux') != -1 || platform.indexOf('sun') != -1) + navigator.OS = 'nix'; + } + + var i = 0; + var ua = window.navigator.userAgent.toLowerCase(); + + if (ua.indexOf('opera') != -1) + { + i = ua.indexOf('opera'); + navigator.family = 'opera'; + navigator.org = 'opera'; + navigator.version = parseFloat('0' + ua.substr(i+6), 10); + } + else if ((i = ua.indexOf('msie')) != -1) + { + navigator.org = 'microsoft'; + navigator.version = parseFloat('0' + ua.substr(i+5), 10); + + if (navigator.version < 4) + navigator.family = 'ie3'; + else + navigator.family = 'ie4' + } + else if (ua.indexOf('gecko') != -1) + { + navigator.family = 'gecko'; + var rvStart = ua.indexOf('rv:'); + var rvEnd = ua.indexOf(')', rvStart); + var rv = ua.substring(rvStart+3, rvEnd); + var rvParts = rv.split('.'); + var rvValue = 0; + var exp = 1; + + for (var i = 0; i < rvParts.length; i++) + { + var val = parseInt(rvParts[i]); + rvValue += val / exp; + exp *= 100; + } + navigator.version = rvValue; + + if (ua.indexOf('netscape') != -1) + navigator.org = 'netscape'; + else if (ua.indexOf('compuserve') != -1) + navigator.org = 'compuserve'; + else + navigator.org = 'mozilla'; + } + else if ((ua.indexOf('mozilla') !=-1) && (ua.indexOf('spoofer')==-1) && (ua.indexOf('compatible') == -1) && (ua.indexOf('opera')==-1)&& (ua.indexOf('webtv')==-1) && (ua.indexOf('hotjava')==-1)) + { + var is_major = parseFloat(navigator.appVersion); + + if (is_major < 4) + navigator.version = is_major; + else + { + i = ua.lastIndexOf('/') + navigator.version = parseFloat('0' + ua.substr(i+1), 10); + } + navigator.org = 'netscape'; + navigator.family = 'nn' + parseInt(navigator.appVersion); + } + else if ((i = ua.indexOf('aol')) != -1 ) + { + // aol + navigator.family = 'aol'; + navigator.org = 'aol'; + navigator.version = parseFloat('0' + ua.substr(i+4), 10); + } + else if ((i = ua.indexOf('hotjava')) != -1 ) + { + // hotjava + navigator.family = 'hotjava'; + navigator.org = 'sun'; + navigator.version = parseFloat(navigator.appVersion); + } + + window.onerror = oldOnError; +} + +xbDetectBrowser(); + diff --git a/src/documentation/docbook-xsl/slides/browser/xbCollapsibleLists.js b/src/documentation/docbook-xsl/slides/browser/xbCollapsibleLists.js new file mode 100644 index 0000000000..6a4f93c174 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/xbCollapsibleLists.js @@ -0,0 +1,537 @@ +/* +xbCollapsibleLists.js 2001-02-26 + +Contributor(s): Michael Bostock, Netscape Communications, Copyright 1997 + Bob Clary, Netscape Communications, Copyright 2001 + Seth Dillingham, Macrobyte Resources, Copyright 2001 + Mark Filanowicz, Amdahl IT Services, Copyright 2002 + +Netscape grants you a royalty free license to use, modify or +distribute this software provided that this copyright notice +appears on all copies. This software is provided "AS IS," +without a warranty of any kind. + +See xbCollapsibleLists.js.changelog.html for details of changes. +*/ + + +var xbcl__id = 0; +var xbcl_item_id = 0; +var xbcl_mLists = new Array(); +var xbcl_parentElement = null; + +document.lists = xbcl_mLists; + +function List(visible, width, height, bgColor, collapsedImageURL, expandedImageURL) +{ + this.lists = new Array(); // sublists + this.items = new Array(); // layers + this.types = new Array(); // type + this.strs = new Array(); // content + this.visible = visible; + this.id = xbcl__id; + this.width = width || 350; + this.height = height || 22; + + this.collapsedImageURL = collapsedImageURL || 'false.gif'; + this.expandedImageURL = expandedImageURL || 'true.gif'; + + if (bgColor) + this.bgColor = bgColor; + + xbcl_mLists[xbcl__id++] = this; +} + +function xbcl_SetFont(i,j) +{ + this.fontIntro = i; + this.fontOutro = j; +} + +function xbcl_GetFont() +{ + return [this.fontIntro, this.fontOutro]; +} + +function xbcl_setIndent(indent) +{ + this.i = indent; + if (this.i < 0) + { + this.i = 0; + this.space = false; + } + else + this.space = true; +} + +function xbcl_getIndent(indent) +{ + return this.i; +} + +function xbcl_writeItemDOMHTML( obj, s, flList, listObj ) +{ + var styleObj; + var outerDiv, innerLeft, innerRight; + var str; + var leftEdge = 0; + + styleObj = new xbStyle(obj); + styleObj.setVisibility('hidden'); + outerDiv = document.createElement( "DIV" ); + outerDiv.id = "DIV_" + obj.id; + styleObj = new xbStyle( outerDiv ); + styleObj.setWidth( this.width ); + + if ( flList ) + { + innerLeft = document.createElement( "DIV" ); + innerLeft.style.position = "absolute"; + innerLeft.style.valign = "middle"; + leftEdge = 15; + + styleObj = new xbStyle( innerLeft ); + styleObj.setWidth( 15 ); + styleObj.setBackgroundColor( "transparent" ); + + if ( listObj.visible ) + str = ''; + else + str = ''; + + innerLeft.innerHTML = str; + outerDiv.appendChild( innerLeft ); + } + else if ( this.space ) + leftEdge = 15; + + innerRight = document.createElement( "DIV" ); + innerRight.noWrap = true; + innerRight.style.position = "absolute"; + + styleObj = new xbStyle( innerRight ); + styleObj.setLeft( leftEdge + ( this.l * this.i ) ); + styleObj.setWidth( this.width - 15 - this.l * this.i ); + styleObj.setBackgroundColor( "transparent" ); + + // start of change by Mark Filanowicz 02-22-2002 + if ( flList ) + { + s = this.fontIntro + '' + s + this.fontOutro; + } + else + { + s = this.fontIntro + s + this.fontOutro; + } + // end of change by Mark Filanowicz 02-22-2002 + + + innerRight.innerHTML = s; + outerDiv.appendChild( innerRight ); + + obj.appendChild( outerDiv ); + + return; +} + +function xbcl_writeItem( obj, s, flList, listObj ) +{ + var cellStyle = ''; + var str = ''; + var styleObj = new xbStyle( obj ); + + styleObj.setVisibility( 'hidden' ); + + if ( document.body && document.body.style ) + cellStyle = ' style="background-color: transparent;"'; + + str += ''; + + if ( flList ) + { + str += ''; + } + else if (this.space) + str += ''; + + if (this.l>0 && this.i>0) + str += ''; + + str += '
                  '; + str += ''; + + if ( listObj.visible ) + str += ''; + else + str += ''; + + str += '  '; + + // start of change by Mark Filanowicz 02-22-2002 + if ( flList ) + { + str += this.fontIntro + '' + s + this.fontOutro; + } + else + { + str += this.fontIntro + s + this.fontOutro; + } + // end of change by Mark Filanowicz 02-22-2002 + + str += '
                  '; + + styleObj.setInnerHTML( str ); + + return; +} + +function xbcl_writeList() +{ + var item; + var i; + var flList; + + for ( i = 0; i < this.types.length; i++ ) + { + item = this.items[ i ]; + flList = ( this.types[ i ] == 'list' ); + + this._writeItem( item, this.strs[ i ], flList, this.lists[ i ] ); + + if ( flList && this.lists[ i ].visible ) + this.lists[ i ]._writeList(); + } + + this.built = true; + this.needsRewrite = false; + self.status = ''; +} + +function xbcl_showList() +{ + var item; + var styleObj; + var i; + + for (i = 0; i < this.types.length; i++) + { + item = this.items[i]; + styleObj = new xbStyle(item); + styleObj.setClipLeft(0); + styleObj.setClipRight(this.width); + styleObj.setClipTop(0); + if (item.height) + { + styleObj.setClipBottom(item.height); + styleObj.setHeight(item.height); + } + else + { + styleObj.setClipBottom(this.height); + styleObj.setHeight(this.height); + } + + if ( this.visible ) + styleObj.setVisibility( 'visible' ); + + var bg = item.oBgColor || this.bgColor; + if ((bg == null) || (bg == 'null')) + bg = ''; + + styleObj.setBackgroundColor(bg); + + if (this.types[i] == 'list' && this.lists[i].visible) + this.lists[i]._showList(); + } + this.shown = true; + this.needsUpdate = false; +} + +function xbcl_setImage(list, item, file) +{ + var id = '_img' + list.id; + var img = null; + + // for DOMHTML or IE4 use cross browser getElementById from xbStyle + // can't use it for NN4 since it only works for layers in NN4 + if (document.layers) + img = item.document.images[0]; + else + img = xbGetElementById(id); + + if (img) + img.src = file; +} + +function xbcl_getHeight() +{ + var totalHeight = 0; + var i; + + if (!this.visible) + return 0; + + for (i = 0; i < this.types.length; i++) + { + if (this.items[i].height) + totalHeight += this.items[i].height; + else + totalHeight += this.height; + + if ((this.types[i] == 'list') && this.lists[i].visible) + { + totalHeight += this.lists[i].getHeight(); + } + } + + return totalHeight; +} + +function xbcl_updateList(pVis, x, y) +{ + var currTop = y; + var item; + var styleObj; + var i; + + for (i = 0; i < this.types.length; i++) + { + item = this.items[i]; + styleObj = new xbStyle(item); + + if (this.visible && pVis) + { + styleObj.moveTo(x, currTop); + if (item.height) // allow custom heights for each item + currTop += item.height; + else + currTop += this.height; + + styleObj.setVisibility('visible'); + } + else + { + styleObj.setVisibility('hidden'); + } + + if (this.types[i] == 'list') + { + if (this.lists[i].visible) + { + if (!this.lists[i].built || this.lists[i].needsRewrite) + this.lists[i]._writeList(); + + if (!this.lists[i].shown || this.lists[i].needsUpdate) + this.lists[i]._showList(); + + xbcl_setImage(this.lists[i], item, this.expandedImageURL ); + } + else + xbcl_setImage(this.lists[i], item, this.collapsedImageURL ); + + if (this.lists[i].built) + currTop = this.lists[i]._updateList(this.visible && pVis, x, currTop); + } + } + return currTop; +} + +function xbcl_updateParent( pid, l ) +{ + var i; + + if ( !l ) + l = 0; + + this.pid = pid; + this.l = l; + + for ( i = 0; i < this.types.length; i++ ) + { + if ( this.types[ i ] == 'list' ) + { + this.lists[ i ]._updateParent( pid, l + 1 ); + } + } +} + +function xbcl_expand(i) +{ + xbcl_mLists[i].visible = !xbcl_mLists[i].visible; + + if (xbcl_mLists[i].onexpand != null) + xbcl_mLists[i].onexpand(xbcl_mLists[i].id); + + xbcl_mLists[xbcl_mLists[i].pid].rebuild(); + + if (xbcl_mLists[i].postexpand != null) + xbcl_mLists[i].postexpand(xbcl_mLists[i].id); +} + +function xbcl_build(x, y) +{ + this._updateParent(this.id); + this._writeList(); + this._showList(); + this._updateList(true, x, y); + this.x = x; + this.y = y; +} + +function xbcl_rebuild() +{ + this._updateList(true, this.x, this.y); +} + +function xbcl_getNewItem() +{ + var newItem = null; + + newItem = xbGetElementById('lItem' + xbcl_item_id); + + if (!newItem) + { + if (document.all && !document.getElementById) + { + var parentElement = this.parentElement; + if (!parentElement) + parentElement = document.body; + + parentElement.insertAdjacentHTML('beforeEnd', '
                  '); + newItem = xbGetElementById('lItem' + xbcl_item_id); + } + else if (document.layers) + { + if (this.parentElement) + newItem = new Layer(this.width, this.parentElement); + else + newItem = new Layer(this.width); + } + else if (document.createElement) + { + newItem = document.createElement('div'); + newItem.id= 'lItem' + xbcl_item_id; + newItem.style.position = 'absolute'; + + if (this.parentElement) + this.parentElement.appendChild(newItem); + else + document.body.appendChild(newItem); + } + } + + return newItem; +} + +function xbcl_addItem(str, bgColor, item) +{ + if (!item) + item = this._getNewItem(); + + if (!item) + return; + + if (bgColor) + item.oBgColor = bgColor; + + this.items[this.items.length] = item; + this.types[this.types.length] = 'item'; + this.strs[this.strs.length] = str; + ++xbcl_item_id; + + if ( this.built ) + { + this._writeItem( item, str, false ); + xbcl_mLists[this.pid].rebuild(); + if ( this.visible ) + this._showList(); + else + this.needsUpdate = true; + } + + return item; +} + +function xbcl_addList(list, str, bgColor, item) +{ + if (!item) + item = this._getNewItem(); + + if (!item) + return; + + if (bgColor) + item.oBgColor = bgColor; + + this.lists[this.items.length] = list; + this.items[this.items.length] = item; + this.types[this.types.length] = 'list'; + this.strs[this.strs.length] = str; + ++xbcl_item_id; + + list.parentList = this; + + list.pid = this.pid; + list.l = this.l + 1; + + if ( this.built ) + { + this._writeItem( item, str, true, list ); + xbcl_mLists[ this.pid ].rebuild(); + if ( this.visible ) + this._showList(); + else + this.needsUpdate = true; + } + + return item; +} + +List.prototype.setIndent = xbcl_setIndent; +List.prototype.getIndent = xbcl_getIndent; +List.prototype.addItem = xbcl_addItem; +List.prototype.addList = xbcl_addList; +List.prototype.build = xbcl_build; +List.prototype.rebuild = xbcl_rebuild; +List.prototype.setFont = xbcl_SetFont; +List.prototype.getFont = xbcl_GetFont; +List.prototype.getHeight = xbcl_getHeight; + +List.prototype._writeList = xbcl_writeList; +List.prototype._getNewItem = xbcl_getNewItem; + +if ( document.getElementById && document.createElement ) + List.prototype._writeItem = xbcl_writeItemDOMHTML; +else + List.prototype._writeItem = xbcl_writeItem; + +List.prototype._showList = xbcl_showList; +List.prototype._updateList = xbcl_updateList; +List.prototype._updateParent = xbcl_updateParent; + +List.prototype.onexpand = null; +List.prototype.postexpand = null; +List.prototype.lists = null; // sublists +List.prototype.items = null; // layers +List.prototype.types = null; // type +List.prototype.strs = null; // content +List.prototype.x = 0; +List.prototype.y = 0; +List.prototype.visible = false; +List.prototype.id = -1; +List.prototype.i = 18; +List.prototype.space = true; +List.prototype.pid = 0; +List.prototype.fontIntro = ''; +List.prototype.fontOutro = ''; +List.prototype.width = 350; +List.prototype.height = 22; +List.prototype.built = false; +List.prototype.shown = false; +List.prototype.needsUpdate = false; +List.prototype.needsRewrite = false; +List.prototype.l = 0; +List.prototype.bgColor = null; +List.prototype.parentList = null; +List.prototype.parentElement = null; diff --git a/src/documentation/docbook-xsl/slides/browser/xbDOM.js b/src/documentation/docbook-xsl/slides/browser/xbDOM.js new file mode 100644 index 0000000000..39cc8bf012 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/xbDOM.js @@ -0,0 +1,374 @@ +/* + * xbDOM.js + * $Revision: 1.2 $ $Date: 2003/02/07 16:04:18 $ + */ + +/* ***** BEGIN LICENSE BLOCK ***** + * Version: MPL 1.1/GPL 2.0/LGPL 2.1 + * + * The contents of this file are subject to the Mozilla Public License Version + * 1.1 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * http://www.mozilla.org/MPL/ + * + * Software distributed under the License is distributed on an "AS IS" basis, + * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License + * for the specific language governing rights and limitations under the + * License. + * + * The Original Code is Netscape code. + * + * The Initial Developer of the Original Code is + * Netscape Corporation. + * Portions created by the Initial Developer are Copyright (C) 2001 + * the Initial Developer. All Rights Reserved. + * + * Contributor(s): Bob Clary + * + * ***** END LICENSE BLOCK ***** */ + +function xbToInt(s) +{ + var i = parseInt(s, 10); + if (isNaN(i)) + i = 0; + + return i; +} + +function xbGetWindowWidth(windowRef) +{ + var width = 0; + + if (!windowRef) + { + windowRef = window; + } + + if (typeof(windowRef.innerWidth) == 'number') + { + width = windowRef.innerWidth; + } + else if (windowRef.document.body && typeof(windowRef.document.body.clientWidth) == 'number') + { + width = windowRef.document.body.clientWidth; + } + + return width; +} + +function xbGetWindowHeight(windowRef) +{ + var height = 0; + + if (!windowRef) + { + windowRef = window; + } + + if (typeof(windowRef.innerWidth) == 'number') + { + height = windowRef.innerHeight; + } + else if (windowRef.document.body && typeof(windowRef.document.body.clientWidth) == 'number') + { + height = windowRef.document.body.clientHeight; + } + return height; +} + +function xbGetElementsByNameAndType(name, type, windowRef) +{ + if (!windowRef) + windowRef = window; + + var elmlist = new Array(); + + xbFindElementsByNameAndType(windowRef.document, name, type, elmlist); + + return elmlist; +} + +function xbFindElementsByNameAndType(doc, name, type, elmlist) +{ + var i; + var subdoc; + + for (i = 0; i < doc[type].length; ++i) + { + if (doc[type][i].name && name == doc[type][i].name) + { + elmlist[elmlist.length] = doc[type][i]; + } + } + + if (doc.layers) + { + for (i = 0; i < doc.layers.length; ++i) + { + subdoc = doc.layers[i].document; + xbFindElementsByNameAndType(subdoc, name, type, elmlist); + } + } +} + +if (document.layers) +{ + nav4FindLayer = + function (doc, id) + { + var i; + var subdoc; + var obj; + + for (i = 0; i < doc.layers.length; ++i) + { + if (doc.layers[i].id && id == doc.layers[i].id) + return doc.layers[i]; + + subdoc = doc.layers[i].document; + obj = nav4FindLayer(subdoc, id); + if (obj != null) + return obj; + } + return null; + } + + nav4FindElementsByName = + function (doc, name, elmlist) + { + var i; + var j; + var subdoc; + + for (i = 0; i < doc.images.length; ++i) + { + if (doc.images[i].name && name == doc.images[i].name) + { + elmlist[elmlist.length] = doc.images[i]; + } + } + + for (i = 0; i < doc.forms.length; ++i) + { + for (j = 0; j < doc.forms[i].elements.length; j++) + { + if (doc.forms[i].elements[j].name && name == doc.forms[i].elements[j].name) + { + elmlist[elmlist.length] = doc.forms[i].elements[j]; + } + } + + if (doc.forms[i].name && name == doc.forms[i].name) + { + elmlist[elmlist.length] = doc.forms[i]; + } + } + + for (i = 0; i < doc.anchors.length; ++i) + { + if (doc.anchors[i].name && name == doc.anchors[i].name) + { + elmlist[elmlist.length] = doc.anchors[i]; + } + } + + for (i = 0; i < doc.links.length; ++i) + { + if (doc.links[i].name && name == doc.links[i].name) + { + elmlist[elmlist.length] = doc.links[i]; + } + } + + for (i = 0; i < doc.applets.length; ++i) + { + if (doc.applets[i].name && name == doc.applets[i].name) + { + elmlist[elmlist.length] = doc.applets[i]; + } + } + + for (i = 0; i < doc.embeds.length; ++i) + { + if (doc.embeds[i].name && name == doc.embeds[i].name) + { + elmlist[elmlist.length] = doc.embeds[i]; + } + } + + for (i = 0; i < doc.layers.length; ++i) + { + if (doc.layers[i].name && name == doc.layers[i].name) + { + elmlist[elmlist.length] = doc.layers[i]; + } + + subdoc = doc.layers[i].document; + nav4FindElementsByName(subdoc, name, elmlist); + } + } + + xbGetElementById = function (id, windowRef) + { + if (!windowRef) + windowRef = window; + + return nav4FindLayer(windowRef.document, id); + }; + + xbGetElementsByName = function (name, windowRef) + { + if (!windowRef) + windowRef = window; + + var elmlist = new Array(); + + nav4FindElementsByName(windowRef.document, name, elmlist); + + return elmlist; + }; + +} +else if (document.all) +{ + xbGetElementById = + function (id, windowRef) + { + if (!windowRef) + { + windowRef = window; + } + var elm = windowRef.document.all[id]; + if (!elm) + { + elm = null; + } + return elm; + }; + + xbGetElementsByName = function (name, windowRef) + { + if (!windowRef) + windowRef = window; + + var i; + var idnamelist = windowRef.document.all[name]; + var elmlist = new Array(); + + if (!idnamelist.length || idnamelist.name == name) + { + if (idnamelist) + elmlist[elmlist.length] = idnamelist; + } + else + { + for (i = 0; i < idnamelist.length; i++) + { + if (idnamelist[i].name == name) + elmlist[elmlist.length] = idnamelist[i]; + } + } + + return elmlist; + } + +} +else if (document.getElementById) +{ + xbGetElementById = + function (id, windowRef) + { + if (!windowRef) + { + windowRef = window; + } + return windowRef.document.getElementById(id); + }; + + xbGetElementsByName = + function (name, windowRef) + { + if (!windowRef) + { + windowRef = window; + } + return windowRef.document.getElementsByName(name); + }; +} +else +{ + xbGetElementById = + function (id, windowRef) + { + return null; + }; + + xbGetElementsByName = + function (name, windowRef) + { + return new Array(); + }; +} + +function xbGetPageScrollX(windowRef) +{ + if (!windowRef) + { + windowRef = window; + } + + if (typeof(windowRef.pageXOffset) == 'number') + { + return windowRef.pageXOffset; + } + + if (typeof(windowRef.document.body && windowRef.document.body.scrollLeft) == 'number') + { + return windowRef.document.body.scrollLeft; + } + + return 0; +} + +function xbGetPageScrollY(windowRef) +{ + if (!windowRef) + { + windowRef = window; + } + + if (typeof(windowRef.pageYOffset) == 'number') + { + return windowRef.pageYOffset; + } + + if (typeof(windowRef.document.body && windowRef.document.body.scrollTop) == 'number') + { + return windowRef.document.body.scrollTop; + } + + return 0; +} + +if (document.layers) +{ + xbSetInnerHTML = + function (element, str) + { + element.document.write(str); + element.document.close(); + }; +} +else +{ + xbSetInnerHTML = function (element, str) + { + if (typeof(element.innerHTML) != 'undefined') + { + element.innerHTML = str; + } + }; +} + +// eof: xbDOM.js diff --git a/src/documentation/docbook-xsl/slides/browser/xbDebug.js b/src/documentation/docbook-xsl/slides/browser/xbDebug.js new file mode 100644 index 0000000000..48fd010cbf --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/xbDebug.js @@ -0,0 +1,311 @@ +/* + * xbDebug.js + * $Revision: 1.2 $ $Date: 2003/02/07 16:04:19 $ + */ + +/* ***** BEGIN LICENSE BLOCK ***** + * Version: MPL 1.1/GPL 2.0/LGPL 2.1 + * + * The contents of this file are subject to the Mozilla Public License Version + * 1.1 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * http://www.mozilla.org/MPL/ + * + * Software distributed under the License is distributed on an "AS IS" basis, + * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License + * for the specific language governing rights and limitations under the + * License. + * + * The Original Code is Netscape code. + * + * The Initial Developer of the Original Code is + * Netscape Corporation. + * Portions created by the Initial Developer are Copyright (C) 2001 + * the Initial Developer. All Rights Reserved. + * + * Contributor(s): Bob Clary + * + * ***** END LICENSE BLOCK ***** */ + +/* +ChangeLog: + +2002-02-25: bclary - modified xbDebugTraceOject to make sure + that original versions of wrapped functions were not + rewrapped. This had caused an infinite loop in IE. + +2002-02-07: bclary - modified xbDebug.prototype.close to not null + the debug window reference. This can cause problems with + Internet Explorer if the page is refreshed. These issues will + be addressed at a later date. +*/ + +function xbDebug() +{ + this.on = false; + this.stack = new Array(); + this.debugwindow = null; + this.execprofile = new Object(); +} + +xbDebug.prototype.push = function () +{ + this.stack[this.stack.length] = this.on; + this.on = true; +} + +xbDebug.prototype.pop = function () +{ + this.on = this.stack[this.stack.length - 1]; + --this.stack.length; +} + +xbDebug.prototype.open = function () +{ + if (this.debugwindow && !this.debugwindow.closed) + this.close(); + + this.debugwindow = window.open('about:blank', 'DEBUGWINDOW', 'height=400,width=600,resizable=yes,scrollbars=yes'); + this.debugwindow.moveTo(0,0); + window.focus(); + + this.debugwindow.document.write('xbDebug Window

                  Javascript Debug Window

                  '); +} + +xbDebug.prototype.close = function () +{ + if (!this.debugwindow) + return; + + if (!this.debugwindow.closed) + this.debugwindow.close(); + + // bc 2002-02-07, other windows may still hold a reference to this: this.debugwindow = null; +} + +xbDebug.prototype.dump = function (msg) +{ + if (!this.on) + return; + + if (!this.debugwindow || this.debugwindow.closed) + this.open(); + + this.debugwindow.document.write(msg + '
                  '); + + return; +} + +var xbDEBUG = new xbDebug(); + +window.onunload = function () { xbDEBUG.close(); } + +function xbDebugGetFunctionName(funcref) +{ + + if (!funcref) + { + return ''; + } + + if (funcref.name) + return funcref.name; + + var name = funcref + ''; + name = name.substring(name.indexOf(' ') + 1, name.indexOf('(')); + funcref.name = name; + + if (!name) alert('name not defined'); + return name; +} + + +// emulate functionref.apply for IE mac and IE win < 5.5 +function xbDebugApplyFunction(funcname, funcref, thisref, argumentsref) +{ + var rv; + + if (!funcref) + { + alert('xbDebugApplyFunction: funcref is null'); + } + + if (typeof(funcref.apply) != 'undefined') + return funcref.apply(thisref, argumentsref); + + var applyexpr = 'thisref.xbDebug_orig_' + funcname + '('; + var i; + + for (i = 0; i < argumentsref.length; i++) + { + applyexpr += 'argumentsref[' + i + '],'; + } + + if (argumentsref.length > 0) + { + applyexpr = applyexpr.substring(0, applyexpr.length - 1); + } + + applyexpr += ')'; + + return eval(applyexpr); +} + +function xbDebugCreateFunctionWrapper(scopename, funcname, precall, postcall) +{ + var wrappedfunc; + var scopeobject = eval(scopename); + var funcref = scopeobject[funcname]; + + scopeobject['xbDebug_orig_' + funcname] = funcref; + + wrappedfunc = function () + { + var rv; + + precall(scopename, funcname, arguments); + rv = xbDebugApplyFunction(funcname, funcref, scopeobject, arguments); + postcall(scopename, funcname, arguments, rv); + return rv; + }; + + if (typeof(funcref.constructor) != 'undefined') + wrappedfunc.constructor = funcref.constuctor; + + if (typeof(funcref.prototype) != 'undefined') + wrappedfunc.prototype = funcref.prototype; + + scopeobject[funcname] = wrappedfunc; +} + +function xbDebugCreateMethodWrapper(contextname, classname, methodname, precall, postcall) +{ + var context = eval(contextname); + var methodref = context[classname].prototype[methodname]; + + context[classname].prototype['xbDebug_orig_' + methodname] = methodref; + + var wrappedmethod = function () + { + var rv; + // eval 'this' at method run time to pick up reference to the object's instance + var thisref = eval('this'); + // eval 'arguments' at method run time to pick up method's arguments + var argsref = arguments; + + precall(contextname + '.' + classname, methodname, argsref); + rv = xbDebugApplyFunction(methodname, methodref, thisref, argsref); + postcall(contextname + '.' + classname, methodname, argsref, rv); + return rv; + }; + + return wrappedmethod; +} + +function xbDebugPersistToString(obj) +{ + var s = ''; + + if (obj == null) + return 'null'; + + switch(typeof(obj)) + { + case 'number': + return obj; + case 'string': + return '"' + obj + '"'; + case 'undefined': + return 'undefined'; + case 'boolean': + return obj + ''; + } + + if (obj.constructor) + return '[' + xbDebugGetFunctionName(obj.constructor) + ']'; + + return null; +} + +function xbDebugTraceBefore(scopename, funcname, funcarguments) +{ + var i; + var s = ''; + var execprofile = xbDEBUG.execprofile[scopename + '.' + funcname]; + if (!execprofile) + execprofile = xbDEBUG.execprofile[scopename + '.' + funcname] = { started: 0, time: 0, count: 0 }; + + for (i = 0; i < funcarguments.length; i++) + { + s += xbDebugPersistToString(funcarguments[i]); + if (i < funcarguments.length - 1) + s += ', '; + } + + xbDEBUG.dump('enter ' + scopename + '.' + funcname + '(' + s + ')'); + execprofile.started = (new Date()).getTime(); +} + +function xbDebugTraceAfter(scopename, funcname, funcarguments, rv) +{ + var i; + var s = ''; + var execprofile = xbDEBUG.execprofile[scopename + '.' + funcname]; + if (!execprofile) + xbDEBUG.dump('xbDebugTraceAfter: execprofile not created for ' + scopename + '.' + funcname); + else if (execprofile.started == 0) + xbDEBUG.dump('xbDebugTraceAfter: execprofile.started == 0 for ' + scopename + '.' + funcname); + else + { + execprofile.time += (new Date()).getTime() - execprofile.started; + execprofile.count++; + execprofile.started = 0; + } + + for (i = 0; i < funcarguments.length; i++) + { + s += xbDebugPersistToString(funcarguments[i]); + if (i < funcarguments.length - 1) + s += ', '; + } + + xbDEBUG.dump('exit ' + scopename + '.' + funcname + '(' + s + ')==' + xbDebugPersistToString(rv)); +} + +function xbDebugTraceFunction(scopename, funcname) +{ + xbDebugCreateFunctionWrapper(scopename, funcname, xbDebugTraceBefore, xbDebugTraceAfter); +} + +function xbDebugTraceObject(contextname, classname) +{ + var classref = eval(contextname + '.' + classname); + var p; + var sp; + + if (!classref || !classref.prototype) + return; + + for (p in classref.prototype) + { + sp = p + ''; + if (typeof(classref.prototype[sp]) == 'function' && (sp).indexOf('xbDebug_orig') == -1) + { + classref.prototype[sp] = xbDebugCreateMethodWrapper(contextname, classname, sp, xbDebugTraceBefore, xbDebugTraceAfter); + } + } +} + +function xbDebugDumpProfile() +{ + var p; + var execprofile; + var avg; + + for (p in xbDEBUG.execprofile) + { + execprofile = xbDEBUG.execprofile[p]; + avg = Math.round ( 100 * execprofile.time/execprofile.count) /100; + xbDEBUG.dump('Execution profile ' + p + ' called ' + execprofile.count + ' times. Total time=' + execprofile.time + 'ms. Avg Time=' + avg + 'ms.'); + } +} diff --git a/src/documentation/docbook-xsl/slides/browser/xbLibrary.js b/src/documentation/docbook-xsl/slides/browser/xbLibrary.js new file mode 100644 index 0000000000..9bbfd6b141 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/browser/xbLibrary.js @@ -0,0 +1,80 @@ +/* + * xbLibrary.js + * $Revision: 1.3 $ $Date: 2003/03/17 03:44:20 $ + */ + +/* ***** BEGIN LICENSE BLOCK ***** + * Version: MPL 1.1/GPL 2.0/LGPL 2.1 + * + * The contents of this file are subject to the Mozilla Public License Version + * 1.1 (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * http://www.mozilla.org/MPL/ + * + * Software distributed under the License is distributed on an "AS IS" basis, + * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License + * for the specific language governing rights and limitations under the + * License. + * + * The Original Code is Bob Clary code. + * + * The Initial Developer of the Original Code is + * Bob Clary. + * Portions created by the Initial Developer are Copyright (C) 2000 + * the Initial Developer. All Rights Reserved. + * + * Contributor(s): Bob Clary + * + * ***** END LICENSE BLOCK ***** */ + +if (!document.getElementById || navigator.userAgent.indexOf('Opera') != -1) +{ + // assign error handler for downlevel browsers + // Note until Opera improves it's overall support + // for JavaScript and the DOM, it must be considered downlevel + + window.onerror = defaultOnError; + + function defaultOnError(msg, url, line) + { + // handle bug in NS6.1, N6.2 + // where an Event is passed to error handlers + if (typeof(msg) != 'string') + { + msg = 'unknown error'; + } + if (typeof(url) != 'string') + { + url = document.location; + } + + alert('An error has occurred at ' + url + ', line ' + line + ': ' + msg); + } +} + +function xbLibrary(path) +{ + if (path.charAt(path.length-1) == '/') + { + path = path.substr(0, path.length-1) + } + this.path = path; +} + +// dynamically loaded scripts +// +// it is an error to reference anything from the dynamically loaded file inside the +// same script block. This means that a file can not check its dependencies and +// load the files for it's own use. someone else must do this. + +xbLibrary.prototype.loadScript = +function (scriptName) +{ + document.write(' + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + overlaySetup('ll'); + + + + + + init( + + ); + + overlaySetup('ll'); + + + + + + +
                  + +
                  +                   + +
                  + + + + +
                  + logo +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + javascript:body.focus() + + + + + + + + + <body class="frameset"> + <xsl:call-template name="body.attributes"/> + <p> + <xsl:text>Your browser doesn't support frames.</xsl:text> + </p> + </body> + + + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Body + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + newPage(' + + ', + + ); + + + + + overlaySetup('lc'); + + + + + + + this.focus() + + + navigate(event) + + + +
                  + +
                  + + + + + +                   + + + + + + + + + + +
                  + + + + + + +
                  + + + + + + + + + foil + + {$text.prev} + + + + + + + + +   + + +   + + + + + + + + + + + + foil + + {$text.next} + + + + + + + + +   + + +   +
                  +
                  +
                  +                   + + + + + + + + +
                  +
                  + + + + + + +
                  + +   + + + + + + + + + + foil + + {$text.prev} + + + + + + + + +   + + +   + + + + + + + + + + foil + + {$text.next} + + + + + + + + +   + + +   +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + foilgroup + + + + + + + javascript:body.focus() + + + + + + <body class="frameset"> + <xsl:call-template name="body.attributes"/> + <p> + <xsl:text>Your browser doesn't support frames.</xsl:text> + </p> + </body> + + + + + + + foilgroup + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + foilgroup + + + + + + + + + + + Body + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + foilgroup + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + newPage(' + + ', + + ); + + + + + overlaySetup('lc'); + + + + + + + + navigate(event) + + + +
                  + + + + + + + + + +
                  + + + + + + +
                  + + +
                  + + + position:absolute;visibility:visible; + + + + + + + + +
                  +                   +
                  + + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + javascript:body.focus() + + + + + + + + + <body class="frameset"> + <xsl:call-template name="body.attributes"/> + <p> + <xsl:text>Your browser doesn't support frames.</xsl:text> + </p> + </body> + + + + + + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Body + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + newPage(' + + ', + + ); + + + + + overlaySetup('lc'); + + + + + + + navigate(event) + + + +
                  + + + + + + + + + +
                  + +
                  + + +
                  + + + position:absolute;visibility:visible; + + + + + + + + +
                  +                   +
                  + + + +                   + + + + + + + +                   + + + + + + + foilgroup + + + + +
                  + - + + + + + + + + + + + + + + + +
                  +                   + + + + + + + +
                  + - + + + + + + + + + + + + + + +
                  +                   + + + + + + + + + myList.addItem(' + + <div id=" + + " class="toc-slidesinfo"> + + <a href=" + + " target="foil"> + + + + + + + + + + + + + ' + \' + + + <\/a><\/div> + '); + + + + + + + + subList = new List(false, width, height, " + +"); + subList.setIndent(12); + + + myList.addList(subList, ' + + <div id=" + + " class="toc-foilgroup"> + + <a href=" + + " target="foil"> + + + + + + + + + + + + + ' + \' + + + <\/a><\/div> + '); + + + + + + + + subList.addItem(' + + + myList.addItem(' + + + + <div id=" + + " class="toc-foil"> + + <img alt="-" src=" + + "><\/img> + + <a href=" + + " target="foil"> + + + + + + + + + + + + + ' + \' + + + <\/a><\/div> + '); + + + + + + + + + diff --git a/src/documentation/docbook-xsl/slides/html/graphics.xsl b/src/documentation/docbook-xsl/slides/html/graphics.xsl new file mode 100644 index 0000000000..b682acdfb1 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/html/graphics.xsl @@ -0,0 +1,151 @@ + + + + + + + + + + + + + + + + + + + / + + + + / + + + http://docbook.sourceforge.net/release/slides/graphics/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/slides/html/jscript.xsl b/src/documentation/docbook-xsl/slides/html/jscript.xsl new file mode 100644 index 0000000000..ae4ef9fdf2 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/html/jscript.xsl @@ -0,0 +1,127 @@ + + + + + + + + + + + + + + + + + / + + + + / + + + http://docbook.sourceforge.net/release/slides/browser/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/slides/html/plain.xsl b/src/documentation/docbook-xsl/slides/html/plain.xsl new file mode 100644 index 0000000000..46da9c2dd0 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/html/plain.xsl @@ -0,0 +1,469 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + +
                  + + + +   + + + + + + + + + + + Home + + + + + + + + Home + + + + + + +   + + + + + ToC + + + + + + + + ToC + + + + + + +   + + + + + + + + + + + Prev + + + + + + + + Prev + + + + + + +   + + + + + + + + + + + Up + + + + + + + + Up + + + + + + +   + + + + + + + + + + + Next + + + + + + + + Next + + + + + + +   +
                  +
                  +
                  +                   + + + + + + + + + + +
                  + + + + + +
                  +   + + + + + + + + + + + Home + + + + + + + + Home + + + + + + +   + + + + + ToC + + + + + + + + ToC + + + + + + +   + + + + + + + + + + + Prev + + + + + + + + Prev + + + + + + +   + + + + + + + + + + + Up + + + + + + + + Up + + + + + + +   + + + + + + + + + + + Next + + + + + + + + Next + + + + + + +   +
                  +
                  +
                  +                   + + + + + + + + + + +
                  + + + + + +
                  +   + + + + + + + + + + + Home + + + + + + + + Home + + + + + + +   + + + + + ToC + + + + + + + + ToC + + + + + + +   + + + + + + + + + + + Prev + + + + + + + + Prev + + + + + + +   + + + + + + + + + + + Up + + + + + + + + Up + + + + + + +   + + + + + + + + + + + Next + + + + + + + + Next + + + + + + +   +
                  +
                  +
                  +                   + + + + + +                   diff --git a/src/documentation/docbook-xsl/slides/html/slides-common.xsl b/src/documentation/docbook-xsl/slides/html/slides-common.xsl new file mode 100644 index 0000000000..338fe04851 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/html/slides-common.xsl @@ -0,0 +1,1541 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + +
                  + + + + + + + + + + +   + + + + + + + + + {$text.home} + + + + + + + + + + {$text.home} + + + + + + + +   + + + + + + + + + {$text.toc} + + + + + + + + + + {$text.toc} + + + + + + + +   + + + + + + + + + {$text.prev} + + + + + + + + + + {$text.prev} + + + + + + + +   + + + + + + + + + {$text.up} + + + + + + + + + + {$text.up} + + + + + + + +   + + + + + + + + + {$text.next} + + + + + + + + + + {$text.next} + + + + + + + +   +
                  +
                  +
                  +                   + + + + + + + + +
                  +
                  + + + + + + +
                  + +   + + + + + + + + + {$text.prev} + + + + + + + + + + {$text.prev} + + + + + + + +   + + + + + + + + + {$text.next} + + + + + + + + + + {$text.next} + + + + + + + +   +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + titlepage + + - + + + + + + + + overlaySetup('lc') + + + + + navigate(event) + + + +
                  + + + + + +
                  + +
                  + +
                  + + + + + +
                  +
                  + + +                   +                   +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

                  +                   + + + + + + +

                  +                   + + +

                  +                   + + +

                  +                   + + + + + + + + + + + + + + + : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="slidesinfo/title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + overlaySetup('lc') + + + + + navigate(event) + + + +
                  + + + + + + + +
                  + +
                  + +
                  + + + + + + + +
                  +
                  + + +                   +                   +                   + + +

                  + + + +

                  + +

                  + + + TableofContents + + +

                  +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + . + + + + + + +
                  + +
                  +
                  + +
                  +
                  +                   +                   + + +
                  + + . + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + overlaySetup('lc') + + + + + navigate(event) + + + +
                  + + + + + + + +
                  + + + + + + +
                  + +
                  + + + + + + + +
                  +
                  + + + + +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

                  + +

                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + overlaySetup('lc') + + + + + navigate(event) + + + +
                  + + + + + + + + + +
                  + + + + + + +
                  + +
                  + + + + + + + +
                  +
                  + + + + +                   +                   + + +                   + + +

                  +                   + + + + + + + + + + + +
                  + +
                  +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + position: absolute; visibility: visible; + + + + padding-top: 2in; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + foil + + + + + + foilgroup + + + + + + + + + + + + </span> + + + <span + + class="green" + class="blue" + class="orange" + class="red" + class="brown" + class="violet" + class="black" + class="bold" + + > + + + + + + + + +
                  + +
                  +
                  +                   + + + + + + + + + copyright + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

                  + +

                  +                   + + +
                  + + +
                  +                   + + + + + + + + + + + + + + + + 1 + 1 + 1 + 0 + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + foil + + + + + + + + + + + foilgroup + + + + + + chunk-filename-error- + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + +   + + + + +                   diff --git a/src/documentation/docbook-xsl/slides/html/tables.xsl b/src/documentation/docbook-xsl/slides/html/tables.xsl new file mode 100644 index 0000000000..0462528547 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/html/tables.xsl @@ -0,0 +1,336 @@ + + + + + + + + +#6A719C +220 + + + + + + + + + + + + +
                  + + + + + +
                  + +
                  +                   		  + + + + + +
                  + +
                  + + +
                  + +
                  +                   +
                  +                   + + + + + + + + +
                  + + + + + +
                  + +
                  +                   		  + + + + + +
                  + +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   +                   + + + + + + + + + + + + + + + + +
                  +                   +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/slides/html/vslides.xsl b/src/documentation/docbook-xsl/slides/html/vslides.xsl new file mode 100644 index 0000000000..f4900995ee --- /dev/null +++ b/src/documentation/docbook-xsl/slides/html/vslides.xsl @@ -0,0 +1,667 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="slidesinfo/title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + navigate(event) + + + + + + + + + + + + + + + + + + +
                   
                  + + + + + + + + + + + + + + + + + + +
                  + +
                  + +
                  + +
                  +
                   
                  + + +                   +                   + + +                   + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + navigate(event) + + + + + + + + + + + + + + + + + + +
                   
                  + + + + + + + + + + + + + + + + + + +
                  + +
                  +
                   
                  + + +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + navigate(event) + + + + + + + + + + + + + + + + + + +
                   
                  + + + + + + + + + + + + + + + + + + + +
                  + +
                  +
                   
                  + + +                   +                   + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + navigate(event) + + + + + + + + + + + + + + + + + + +
                   
                  + + + + + + + + + + + + + + + + + + + +
                  + +
                  +
                   
                  + + +                   +                   +                   + + + + +
                  + +
                  +                   + + +
                  + + + + + +
                  + + + +
                  +
                  +                   + + +
                  + +
                  +                   + + +
                  + + + + +
                  + Slide + + of + +
                  +
                  +                   + + + + + + + + + + + + +
                  + + + + + + + First + + + + + + + + + + First + + + + + + + + +
                  + + + + + + + Previous + + + + + + + + + + Previous + + + + + + + + +
                  + + + + + + + Last + + + + + + + + + + Last + + + + + + + + +
                  + + + + + + + Next + + + + + + + + + + Next + + + + + + + + + +
                  +
                  + + + + + ToC + + + + + + + + + + ToC + + + + + + + + +
                  +                   + +                   diff --git a/src/documentation/docbook-xsl/slides/html/w3c.xsl b/src/documentation/docbook-xsl/slides/html/w3c.xsl new file mode 100644 index 0000000000..5a5b420250 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/html/w3c.xsl @@ -0,0 +1,376 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + {$logo.title} + + + + + + + + + + position: absolute; visibility: visible; + + + + + + + + + + + + + +
                  + + + + + +
                  + + +
                  + + + + + + + Previous + + + + + + + + Previous + + + + + + + + + + + Contents + + + + + + + + Contents + + + + + + + + + + + + + Next + + + + + + +
                  +
                  + + +
                  +
                  +                   + + + + + + + + +
                  +
                  + + + + + + + +
                  + + + + + + + + + + + + + + , + + + + + of + + + +
                  + + + + + + + Previous + + + + + + + + Prev + + + + + + + + + + + + + Next + + + + + + +
                  +
                  +
                  +                   + + + + + + + + + + +
                  + + + + + +
                  + + +
                  + + + + + + + Previous + + + + + + + + Previous + + + + + + + + + + + Contents + + + + + + + + Contents + + + + + + + + + + + + + Next + + + + + + +
                  +
                  + +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  +                   +                   + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/slides/htmlhelp/htmlhelp.xsl b/src/documentation/docbook-xsl/slides/htmlhelp/htmlhelp.xsl new file mode 100644 index 0000000000..1aa96ced7b --- /dev/null +++ b/src/documentation/docbook-xsl/slides/htmlhelp/htmlhelp.xsl @@ -0,0 +1,94 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <LI> <OBJECT type="text/sitemap"> + <param name="Name" value=" + + "> + <param name="Local" value=" + + "> + </OBJECT> + + + <UL> + + </UL> + + + + + + + + + + + + + + + + + + + + + + <LI> <OBJECT type="text/sitemap"> + <param name="Name" value=" + + "> + <param name="Local" value=" + + "> + </OBJECT> + + + + diff --git a/src/documentation/docbook-xsl/slides/keynote/default.xsl b/src/documentation/docbook-xsl/slides/keynote/default.xsl new file mode 100644 index 0000000000..87a46bca07 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/keynote/default.xsl @@ -0,0 +1,600 @@ + + + + + + + + + Keynote Slides + + + Steve + Ball + + Zveno +
                  + + zveno.com + +
                  +                   +                   + + $Id: default.xsl,v 1.1 2004/11/10 06:51:55 balls Exp $ + + + 2004 + 2003 + Steve Ball, Zveno Pty Ltd + + + + Zveno Pty Ltd makes this software and associated documentation available free of charge for any purpose. You may make copies of the software but you must include all of this notice on any copy. + Zveno Pty Ltd does not warrant that this software is error free or fit for any purpose. Zveno Pty Ltd disclaims any liability for all claims, expenses, losses, damages and costs any user may incur as a result of using, copying or modifying the software. + +                   +                   + + + + + + + + + + + + + + + + You must specify your slides document using the "slides" parameter + + + + + + + + + + + + + + + + + + + </drawables> + <transition-style type='inherited'/> + <thumbnails> + <thumbnail file='thumbs/st0.tiff' byte-size='6520' size='60 45'/> + </thumbnails> + <bullets> + <bullet marker-type='inherited' level='0'> + <content tab-stops='L 96' font-size='84' font-color='g1' font-name='GillSans' paragraph-alignment='center'> + <xsl:apply-templates select='slidesinfo/title/node()'/> + </content> + </bullet> + <xsl:choose> + <xsl:when test='slidesinfo/subtitle'> + <bullet marker-type='inherited' level='1'> + <content tab-stops='L 96' font-size='36' font-color='g1' font-name='GillSans' paragraph-alignment='center'> + <xsl:apply-templates select='slidesinfo/subtitle/node()' mode='slides'/> + </content> + </bullet> + </xsl:when> + <xsl:when test='slidesinfo/corpauthor'> + <bullet marker-type='inherited' level='1'> + <content tab-stops='L 96' font-size='36' font-color='g1' font-name='GillSans' paragraph-alignment='center'> + <xsl:apply-templates select='slidesinfo/corpauthor/node()' mode='slides'/> + </content> + </bullet> + </xsl:when> + <xsl:when test='slidesinfo/author'> + <bullet marker-type='inherited' level='1'> + <content tab-stops='L 96' font-size='36' font-color='g1' font-name='GillSans' paragraph-alignment='center'> + <xsl:apply-templates select='slidesinfo/author' mode='slides'/> + </content> + </bullet> + </xsl:when> + </xsl:choose> + </bullets> + <notes font-size='18' font-name='LucidaGrande'> + <xsl:apply-templates select='slidesinfo/*[not(self::title|self::subtitle|self::corpauthor|self::author)]' mode='slides'/> + </notes> + </slide> + + <xsl:if test='foilgroup'> + <xsl:call-template name='overview'/> + </xsl:if> + + <xsl:apply-templates select='foilgroup|foil' mode='slides'/> + </xsl:template> + + <xsl:template name='overview'> + <xsl:param name='current' select='/'/> + + <slide id='overview-{generate-id()}' master-slide-id="{$masters/apxl:master-slide[@name=$overview-master]/@id}"> + <drawables> + <body visibility='tracks-master' vertical-alignment='tracks-master'/> + <title visibility='tracks-master' vertical-alignment='tracks-master'/> + + <xsl:for-each select='ancestor-or-self::slides/foilgroup'> + <textbox id='textbox-{position()}' grow-horizontally='true' transformation='1 0 0 1 {100 + floor((position() - 1) div 10) * 400} {200 + floor((position() - 1) mod 10) * 50}' size='200 50'> + <content tab-stops='L 84' font-size='36' paragraph-alignment='left'> + <xsl:attribute name='font-color'> + <xsl:choose> + <xsl:when test='generate-id() = generate-id($current)'> + <xsl:text>1 0.5 0</xsl:text> + </xsl:when> + <xsl:otherwise>g1</xsl:otherwise> + </xsl:choose> + </xsl:attribute> + <xsl:apply-templates select='title' mode='slides'/> + </content> + </textbox> + </xsl:for-each> + + </drawables> + <transition-style type='inherited'/> + <thumbnails> + <thumbnail file='thumbs/st0.tiff' byte-size='6520' size='60 45'/> + </thumbnails> + <bullets> + <bullet marker-type='inherited' level='0'> + <content tab-stops='L 96' font-size='84' font-color='g1' font-name='GillSans' paragraph-alignment='center'>Overview</content> + </bullet> + </bullets> + </slide> + </xsl:template> + + <xsl:template match='author' mode='slides'> + <xsl:apply-templates select='firstname/node()' mode='slides'/> + <xsl:text> </xsl:text> + <xsl:apply-templates select='surname/node()' mode='slides'/> + </xsl:template> + <xsl:template match='copyright' mode='slides'> + <xsl:text>Copyright (c) </xsl:text> + <xsl:value-of select='year'/> + <xsl:text> </xsl:text> + <xsl:apply-templates select='holder' mode='slides'/> + <xsl:text>. </xsl:text> + </xsl:template> + + <xsl:template match='foilgroup' mode='slides'> + <xsl:variable name='number' select='count(preceding-sibling::foilgroup) + count(preceding::foil) + 1'/> + + <xsl:call-template name='overview'> + <xsl:with-param name='current' select='.'/> + </xsl:call-template> + + <slide id='foilgroup-{generate-id()}'> + <xsl:attribute name='master-slide-id'> + <xsl:choose> + <xsl:when test='*[not(self::foil|self::foilgroupinfo|self::speakernotes)]'> + <xsl:value-of select='$masters/apxl:master-slide[@name=$title-only-master]/@id'/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select='$masters/apxl:master-slide[@name=$foilgroup-master]/@id'/> + </xsl:otherwise> + </xsl:choose> + </xsl:attribute> + + <drawables> + <title visibility='tracks-master' vertical-alignment='tracks-master'/> + <body visibility='hidden' vertical-alignment='tracks-master'/> + <xsl:call-template name='drawables'/> + </drawables> + <transition-style type='inherited'/> + <thumbnails> + <thumbnail file='thumbs/st0.tiff' byte-size='6520' size='60 45'/> + </thumbnails> + <bullets> + <bullet marker-type='inherited' level='0'> + <content tab-stops='L 96' font-size='84' font-color='g1' font-name='GillSans' paragraph-alignment='center'> + <xsl:apply-templates select='title' mode='slides'/> + </content> + </bullet> + + <xsl:apply-templates select='itemizedlist/listitem' mode='slides'/> + </bullets> + <xsl:if test='speakernotes'> + <notes font-size='18' font-name='LucidaGrande'> + <xsl:apply-templates select='speakernotes/para[1]/node()' mode='slides'/> + <xsl:for-each select='speakernotes/para[position() != 1]'> + <xsl:text>; </xsl:text> + <xsl:apply-templates select='node()' mode='slides'/> + </xsl:for-each> + </notes> + </xsl:if> + </slide> + + <xsl:apply-templates select='foil' mode='slides'/> + + </xsl:template> + + <xsl:template match='foil' mode='slides'> + <xsl:variable name='number' select='count(preceding::foilgroup) + count(preceding::foil) + count(preceding-sibling::foil) + 1'/> + + <slide id='foil-{generate-id()}'> + <xsl:attribute name='master-slide-id'> + <xsl:choose> + <xsl:when test='imageobject'> + <xsl:value-of select='$masters/apxl:master-slide[@name=$title-only-master]/@id'/> + </xsl:when> + <xsl:when test='itemizedlist[.//imageobject]'> + <xsl:value-of select='$masters/apxl:master-slide[@name=$bullet-and-image-master]/@id'/> + </xsl:when> + <xsl:when test='itemizedlist'> + <xsl:value-of select='$masters/apxl:master-slide[@name=$bullet-master]/@id'/> + </xsl:when> + <xsl:when test='example|informalexample'> + <xsl:value-of select='$masters/apxl:master-slide[@name=$title-only-master]/@id'/> + </xsl:when> + <xsl:otherwise> + <xsl:value-of select='$masters/apxl:master-slide[@name=$bullet-master]/@id'/> + </xsl:otherwise> + </xsl:choose> + </xsl:attribute> + <drawables> + <body visibility='tracks-master' vertical-alignment='tracks-master'/> + <title visibility='tracks-master' vertical-alignment='tracks-master'/> + <xsl:call-template name='drawables'/> + </drawables> + <transition-style type='inherited'/> + <thumbnails> + <thumbnail file='thumbs/st0.tiff' byte-size='6520' size='60 45'/> + </thumbnails> + <bullets> + <bullet marker-type='inherited' level='0'> + <content tab-stops='L 96' font-size='64' font-color='g1' font-name='GillSans' paragraph-alignment='inherited'> + <!-- + <xsl:apply-templates select='../title' mode='slides'/> + <xsl:text>: </xsl:text> +--> + <xsl:apply-templates select='title' mode='slides'/> + </content> + </bullet> + <xsl:apply-templates select='itemizedlist/listitem' mode='slides'/> + </bullets> + <xsl:if test='speakernotes'> + <notes font-size='18' font-name='LucidaGrande'> + <xsl:apply-templates select='speakernotes/para[1]/node()' mode='slides'/> + <xsl:for-each select='speakernotes/para[position() != 1]'> + <xsl:text>; </xsl:text> + <xsl:apply-templates select='node()' mode='slides'/> + </xsl:for-each> + </notes> + </xsl:if> + </slide> + </xsl:template> + + <doc:template xmlns=''> + <title>drawables Template + + This template adds objects to the drawables section of a foil. These include images, as well as unadorned (non-bullet) text. + + A single image is placed centered on the foil. An image on a foil that contains other text is placed on the right-hand-side. + + + + + + + + + 1.0 + video/quicktime + + + + + + + + + + + + + + + + + + {800, 400} + + + + + + + + + + + + + + + + + + + + {0, 300} + + + + + {150, 300} + + + + + {0, 200} + + + + + {150, 200} + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ]]> + + + + ]]> + + + + + + + + + + + + + + + + + + + + <![CDATA[ + + + + + + + + + + + + + + + GillSans-Italic + GillSans + + + + + + + + + + + + + " + “ + + + + + + ]]> + ]] > + + + + + + + + + + + + + + + + < + < + + + + + + + ]]> + ]] > + + + + + + + + + + + + + + + + + + + 20 + 0 + + + + + + + + + + + + + + + + + + + + + + + + AmericanTypewriter-CondensedBoldItalic + + + GillSans-BoldItalic + + + AmericanTypewriter-CondensedItalic + + + GillSans-Italic + + + AmericanTypewriter-CondensedBold + + + GillSans-Bold + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/slides/keynote/xsltsl/cmp.xsl b/src/documentation/docbook-xsl/slides/keynote/xsltsl/cmp.xsl new file mode 100644 index 0000000000..c1ba7fa345 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/keynote/xsltsl/cmp.xsl @@ -0,0 +1,348 @@ + + + + + + + + $Id: cmp.xsl,v 1.1 2004/11/10 06:51:55 balls Exp $ + + + Hummel + Mark + + + 2003 + Mark Hummel + + + + XML Compare + + +
                  + Introduction + + This module provides a template for comparing two xml documents. + +
                  +                   + +                   + + + + Find differences + + + Compare two xml documents and display differences. Two xml documents are defined to be the same if: They have the matching elements and attributes, and that the data in the elements also match. The comparison is order sensitive. + + The element names from the documents at the current depth are compared, followed by their values, then any attribute names and values are compared. The process is applied then to the subtrees of the documents. + + Notes: If there are leaf nodes in one nodeset which don't exist in the other, the value of those 'extra' elements won't appear as a difference. + + + + + + + ns1 + ns2 + + The two nodesets which are to be compared. + + + + + + + Returns the difference between the documents. + + The format of the output is an xml document. A node is added to the result tree for every difference. The node contains the type of difference (e.g element name difference, attribute value difference, etc), the value in the first nodeset and the value in the second nodeset, and the parent node. The indentation level is the depth at which the difference was found relative to the first document. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + node[]: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Compare + + + Recursively compare two xml nodesets, stop when a difference is found and return false. Otherwise return true if the document is identical. + + The element names from the documents at the current depth are compared, followed by their values, then any attribute names and values are compared. The process is applied then to the subtrees of the documents. + + Notes: If there are leaf nodes in one nodeset which don't exist in the other, the value of those 'extra' elements won't appear as a difference. + + + + + + + ns1 + ns2 + + The two nodesets which are to be compared. + + + + + + + False when the nodesets are not identical, empty otherwise. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   + diff --git a/src/documentation/docbook-xsl/slides/keynote/xsltsl/date-time.xsl b/src/documentation/docbook-xsl/slides/keynote/xsltsl/date-time.xsl new file mode 100644 index 0000000000..421ae765d7 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/keynote/xsltsl/date-time.xsl @@ -0,0 +1,1524 @@ + + + + + + + $Id: date-time.xsl,v 1.1 2004/11/10 06:51:55 balls Exp $ + + + Diamond + Jason + + + 2004 + Steve Ball + + + 2001 + Jason Diamond + + + + Date/Time Processing + + +
                  + Introduction + + This module provides templates for formatting and parsing date/time strings. + + See http://www.tondering.dk/claus/calendar.html for more information on calendars and the calculations this library performs. + +
                  +                   + +                   + + + Returns a string with a formatted date/time. + + + The formatted date/time is determined by the format parameter. The default format is %Y-%m-%dT%H:%M:%S%z, the W3C format. + + + + + + + xsd-date-time + + The date-time value in XML Schemas (WXS) format. + If this value is specified, it takes priority over other parameters. + + + + + year + + Year, in either 2 or 4+ digit format.. + If the year is given as a two digit value, it will be converted to a four digit value using the fixed window method. Values between 00 and 49 will be prepended by "20". Values between 50 and 99 will be prepended by "19". + + + + + month + + Month (1 - 12; January = 1) + + + + + day + + Day of month (1 - 31) + + + + + hour + + Hours since midnight (0 - 23) + + + + + minute + + Minutes after hour (0 - 59) + + + + + second + + Seconds after minute (0 - 59) + + + + + time-zone + + Time zone string (e.g., 'Z' or '-08:00') + + + + + format + + The format specification. + + + + %a + + Abbreviated weekday name + + + + + %A + + Full weekday name + + + + + %b + + Abbreviated month name + + + + + %B + + Full month name + + + + + %c + + Date and time representation appropriate for locale + + + + + %d + + Day of month as decimal number (01 - 31) + + + + + %e + + Day of month as decimal number (1 - 31) + + + + + %H + + Hour in 24-hour format (00 - 23) + + + + + %I + + Hour in 12-hour format (01 - 12) + + + + + %i + + Hour in 12-hour format (1 - 12) + + + + + %j + + Day of year as decimal number (001 - 366) + + + + + %m + + Month as decimal number (01 - 12) + + + + + %n + + Month as decimal number (1 - 12) + + + + + %M + + Minute as decimal number (00 - 59) + + + + + %P + + Current locale's A.M./P.M. indicator for 12-hour clock, uppercase + + + + + %Q + + Current locale's A.M./P.M. indicator for 12-hour clock, uppercase with periods + + + + + %p + + Current locale's A.M./P.M. indicator for 12-hour clock, lowercase + + + + + %q + + Current locale's A.M./P.M. indicator for 12-hour clock, lowercase with periods + + + + + %S + + Second as decimal number (00 - 59) + + + + + %U + + Week of year as decimal number, with Sunday as first day of week (00 - 53) + + + + + %w + + Weekday as decimal number (0 - 6; Sunday is 0) + + + + + %W + + Week of year as decimal number, with Monday as first day of week (00 - 53) + + + + + %x + + Date representation for current locale + + + + + %X + + Time representation for current locale + + + + + %y + + Year without century, as decimal number (00 - 99) + + + + + %Y + + Year with century, as decimal number + + + + + %z + + Time-zone name or abbreviation; no characters if time zone is unknown + + + + + %% + + Percent sign + + + + + + + + + + + + Returns a formatted date/time string. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + % + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [not implemented] + + + + + 0 + + + + + + + + + + 0 + + + + + + + 12 + 0 + + 0 + + + + + + + 12 + + + + + + + + + + [not implemented] + + + + + 0 + + + + + + + + + + 0 + + + + + + + am + pm + + + + + + am + p.m. + + + + + + AM + PM + + + + + + AM + P.M. + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [not implemented] + + + + + [not implemented] + + + + + + invalid year value + + + 00 + + + + + + + + + + + invalid year value + + + + + + + + + invalid year value + + + + + + + + + + + % + + + + + + + + + + + + + + + + + + + + + + + Calculates the day of the week. + + + Given any Gregorian date, this calculates the day of the week. + + + + + + year + + Year + + + + month + + Month (1 - 12; January = 1) + + + + day + + Day of month (1 - 31) + + + + + + + Returns the day of the week (0 - 6; Sunday = 0). + + + + + + + + + + + + + + + + + + + Calculates the number of days for a specified month. + + + Given any Gregorian month, this calculates the last day of the month. + + + + + + year + + Year + + + + month + + Month (1 - 12; January = 1) + + + + + + + Returns the number of days in given month as a decimal number. + + + + + + + + + + + 29 + 28 + + + + + 30 + 31 + + + + + 30 + 31 + + + + + + + Gets the day of the week's full name. + + + Converts a numeric day of the week value into a string representing the day's full name. + + + + + + day-of-the-week + + Day of the week (0 - 6; Sunday = 0) + + + + + + + Returns a string. + + + + + + + + + Sunday + Monday + Tuesday + Wednesday + Thursday + Friday + Saturday + error: + + + + + + Gets the day of the week's abbreviation. + + + Converts a numeric day of the week value into a string representing the day's abbreviation. + + + + + + day-of-the-week + + Day of the week (0 - 6; Sunday = 0) + + + + + + + Returns a string. + + + + + + + + + Sun + Mon + Tue + Wed + Thu + Fri + Sat + error: + + + + + + Gets the month's full name. + + + Converts a numeric month value into a string representing the month's full name. + + + + + + month + + Month (1 - 12; Januaray = 1) + + + + + + + Returns a string. + + + + + + + + + January + February + March + April + May + June + July + August + September + October + November + December + error: + + + + + + Gets the month's abbreviation. + + + Converts a numeric month value into a string representing the month's abbreviation. + + + + + + month + + Month (1 - 12; Januaray = 1) + + + + + + + Returns a string. + + + + + + + + + Jan + Feb + Mar + Apr + May + Jun + Jul + Aug + Sep + Oct + Nov + Dec + error: + + + + + + Calculates the Julian Day for a specified date. + + + Given any Gregorian date, this calculates the Julian Day. + + + + + + year + + Year + + + + month + + Month (1 - 12; January = 1) + + + + day + + Day of month (1 - 31) + + + + + + + Returns the Julian Day as a decimal number. + + + + + + + + + + + + + + + + + + + Returns a string with a formatted date for a specified Julian Day. + + + Given any Julian Day, this returns a string according to the format specification. + + + + + + julian-day + + A Julian Day + + + + format + + The format specification. See dt:format-date-time for more details. + + + + + + + A string. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Calculates the week number for a specified date. + + + Assumes Monday is the first day of the week. + + + + + + year + + Year + + + + month + + Month (1 - 12; January = 1) + + + + day + + Day of month (1 - 31) + + + + + + + Returns the week number as a decimal number. + + + + + + + + + + + + + + + + + + + + + + + + + + + Take a month by name and return a number which can be used as input to the templates. + + + Input + + + + + + month + + Month as described either by full name or abbreviation. + + + + + + + Return a month as a decimal number. (Jan = 1) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Return year component of XSD DateTime value. + + + Extract component of XML Schemas DateTime value. + + + + + + xsd-date-time + + A value in XSD DateTime format. + + + + + + + Returns year component. + + + + + + + + + + + + + + + + + + + + + + + + + Return month component of XSD DateTime value. + + + Extract component of XML Schemas DateTime value. + + + + + + xsd-date-time + + A value in XSD DateTime format. + + + + + + + Returns month component. + + + + + + + + + + + + + + + + + + + + + + + + + Return day component of XSD DateTime value. + + + Extract component of XML Schemas DateTime value. + + + + + + xsd-date-time + + A value in XSD DateTime format. + + + + + + + Returns day component. + + + + + + + + + + + + + + + + + + + + + + + + + Return hour component of XSD DateTime value. + + + Extract component of XML Schemas DateTime value. + + + + + + xsd-date-time + + A value in XSD DateTime format. + + + + + + + Returns hour component. + + + + + + + + + + + + + + + + + + + + + + + + + + Return minute component of XSD DateTime value. + + + Extract component of XML Schemas DateTime value. + + + + + + xsd-date-time + + A value in XSD DateTime format. + + + + + + + Returns minute component. + + + + + + + + + + + + + + + + + + + + + + + + + + Return second component of XSD DateTime value. + + + Extract component of XML Schemas DateTime value. + + + + + + xsd-date-time + + A value in XSD DateTime format. + + + + + + + Returns second component. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Return timezone component of XSD DateTime value. + + + Extract component of XML Schemas DateTime value. + + + + + + xsd-date-time + + A value in XSD DateTime format. + + + + + + + Returns timezone component. + + + + + + + + Z + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + Return two digit year as four digit year value. + + + Prepend century to two digit year value. + Century value is calculated according to suggested solutions in RFC2626 (section 5). + Fixed window solution: 20 is prepended to year if the year is less than 50, otherwise 19 is prepended to year. + Sliding window solution: The year is considered in the future if the year is less than the current 2 digit year plus 'n' years (where 'n' is a param), otherwise it is considered in the past. + + + + + + year + + A year value in 2 digit format. + + + + method + + RFC2626 suggested solution ('fixed' or 'sliding'). Default is 'fixed'. + + + + n + + No. of years. Used in sliding windows solution. + + + + + + + Returns four digit year value. + + + + + + + + + invalid year value + + + 20 + 19 + + + + not yet implemented + invalid method + + + +                   diff --git a/src/documentation/docbook-xsl/slides/keynote/xsltsl/example.xsl b/src/documentation/docbook-xsl/slides/keynote/xsltsl/example.xsl new file mode 100644 index 0000000000..0150d3f1d0 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/keynote/xsltsl/example.xsl @@ -0,0 +1,90 @@ + + + + + + + + $Id: example.xsl,v 1.1 2004/11/10 06:51:55 balls Exp $ + + + Ball + Steve + + + 2001 + Steve Ball + + + + Example Stylesheet + + +
                  + Introduction + + This module provides a template for adding stylesheet modules to the XSLT Standard Library. + To add a new module to the library, follow these easy steps: + + + Copy this file and replace its contents with the new module templates and documentation. + + + Copy the corresponding test file in the test directory. Replace its contents with tests for the new module. + + + Add an include element in the stdlib.xsl stylesheet. + + + Add an entry in the test/test.xml file. + + + Add entries in the test/test.xsl stylesheet. + + + Add an entry in the doc/build.xml file. + + + + The example.xsl stylesheet provides a more extensive example. + +
                  +                   + +                   + + + Template Example + + + Provides a template for writing templates. Replace this paragraph with a description of your template + + + + + + text + + The example string + + + + + + + Returns nothing. + + + + + + + +                   + diff --git a/src/documentation/docbook-xsl/slides/keynote/xsltsl/markup.xsl b/src/documentation/docbook-xsl/slides/keynote/xsltsl/markup.xsl new file mode 100644 index 0000000000..0361368b09 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/keynote/xsltsl/markup.xsl @@ -0,0 +1,789 @@ + + + + + + $Id: markup.xsl,v 1.1 2004/11/10 06:51:55 balls Exp $ + + + Ball + Steve + + + 2003 + 2001 + Steve Ball + + + + XML Markup Templates + + +
                  + Introduction + + This stylesheet module provides functions for generating literal XML markup. + +
                  +                   + +                   + + + Create an XML Declaration + + + This template returns an XML Declaration. Although the XSLT standard provides control over the generation of the XML Declaration, this template may be useful in circumstances where the values must be computed at runtime. + + + + + + version + + Version number. + + + + standalone + + Standalone indication. Must be value "yes" or "no". + + + + encoding + + Character encoding. + + + + + + + Returns an XML Declaration as a string. + + + + + + + + + <?xml version=" + + " + + + + + standalone=" + + " + + + invalid value "" for standalone attribute + + + + + encoding=" + + " + + + ?> + + + + + Create a Document Type Declaration + + + This template returns a Document Type Declaration. Although the XSLT standard provides control over the generation of a Document Type Declaration, this template may be useful in circumstances where the values for the identifiers or the internal subset must be computed at runtime. + + + + + + docel + + The name of the document element. + + + + publicid + + The public identifier for the external DTD subset. + + + + systemid + + The system identifier for the external DTD subset. + + + + internaldtd + + The internal DTD subset. + + + + + + + Returns a Document Type Declaration as a string. + + + + + + + + + + + No document element specified + + + <!DOCTYPE + + + + + + + + + + [ + + ] + + + > + + + + + Create an Element Declaration + + + This template returns an element declaration.. + + + + + + type + + The element type. + + + + content-spec + + The content specification. + + + + + + + Returns an element declaration as a string. + + + + + + + + + element type must be specified + + + content specification must be specified + + + <!ELEMENT + + + + > + + + + Create an Attribute List Declaration + + + This template returns an attribute list declaration. + + + + + + type + + The element type. + + + + attr-defns + + Attribute definitions. + + + + + + + Returns an attribute list declaration as a string. + + + + + + + + + element type must be specified + + + <!ATTLIST + + + + > + + + + Create an Attribute Definition + + + This template returns an attribute definition. + + + + + + name + + The attribute name. + + + + type + + The attribute type. + + + + default + + The attribute default. + + + + + + + Returns an attribute definition as a string. + + + + + + + + + + attribute name must be specified + + + attribute type must be specified + + + attribute default must be specified + + + + + + + + + + + + Create an Entity Declaration + + + This template returns an entity declaration. + If the 'text' parameter is given a value, then an internal entity is created. If either the 'publicid' or 'systemid' parameters are given a value then an external entity is created. It is an error for the 'text' parameter to have value as well as the 'publicid', 'systemid' or 'notation' parameters. + + + + + + name + + The entity name. + + + + parameter + + Boolean value to determine whether a parameter entity is created. Default is 'false()'. + + + + text + + The replacement text. Must be a string. + + + + nodes + + The replacement text as a nodeset. The nodeset is formatted as XML using the as-xml template. If both text and nodes are specified then nodes takes precedence. + + + + publicid + + The public identifier for an external entity. + + + + systemid + + The system identifier for an external entity. + + + + notation + + The notation for an external entity. + + + + + + + Returns an entity declaration as a string. + + + + + + + + + + + + + + entity name must be specified + + + both replacement text and external identifier specified + + + <!ENTITY + + + + % + + + + + + + + + + + + + + + + + + + + + + + + + + + NDATA " + + " + + + > + + + + Quote an Attribute Value + + + This template returns a quoted value. + + + + + + value + + The value to quote. + + + + + + + Returns a quote value as a string. + + + + + + + + + + + + + + + + + < + + &lt; + + + + + + + + + + + + + + " + ' + + + + " + + + " + + &quot; + + + " + + + ' + + ' + + + " + + " + + + + + + Create an External Identifier + + + This template returns an external identifier. + + + + + + publicid + + The public identifier. + + + + systemid + + The system identifier. + + + + + + + Returns an external identifier as a string. + + + + + + + + + + + + + + PUBLIC " + + " + + " + + " + + + + + + + SYSTEM " + + " + + + + + + Create an Entity Reference + + + This template returns an entity reference. + + + + + + name + + The name of the entity. + + + + + + + Returns an entity reference as a string. + + + + + + + & + + ; + + + + + Create a Notation Declaration + + + This template returns a notation declaration. + + + + + + name + + The notation name. + + + + publicid + + The public identifier for the notation. + + + + systemid + + The system identifier for the notation. + + + + + + + Returns a notation declaration as a string. + + + + + + + + + + notation name must be specified + + + external identifier must be specified + + + <!NOTATION + + + + + + + + + > + + + + Create a CDATA Section + + + This template returns a CDATA Section. The XSLT specification provides a mechanism for instructing the XSL processor to output character data in a CDATA section for certain elements, but this template may be useful in those circumstances where not all instances of an element are to have their content placed in a CDATA section. + + + + + + text + + The content of the CDATA section. + + + + + + + Returns a CDATA section as a string. + + + + + + + + CDATA section contains "]]>" + + + <![CDATA[ + + ]]> + + + + Format Nodeset As XML Markup + + + This template returns XML markup. Each node in the given nodeset is converted to its equivalent XML markup. + + BUG: This version may not adequately handle XML Namespaces. + + + + + + nodes + + Nodeset to format as XML. + + + + + + + Returns XML markup. + + + + + + + + + + < + + + + + = + + + + + + + + > + + + + </ + + > + + + /> + + + + + + + + <!-- + + --> + + + <? + + + + ?> + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/slides/keynote/xsltsl/math.xsl b/src/documentation/docbook-xsl/slides/keynote/xsltsl/math.xsl new file mode 100644 index 0000000000..5067064e65 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/keynote/xsltsl/math.xsl @@ -0,0 +1,704 @@ + + + + + + + $Id: math.xsl,v 1.1 2004/11/10 06:51:55 balls Exp $ + + + Ball + Steve + + + 2004 + 2002 + Steve Ball + + + + Math Module + + +
                  + Introduction + + This module provides mathematical functions. +
                  +                   + +                   + + + Power + + + Raises a number to a power. + + + + + + base + + The base number. Must be a number. + + + + power + + The power to raise the number to. Must be an integer. + + + + + + + Returns base multiplied by itself power times. If the base or power are not numbers or if the power is fractional then an empty string is returned. + + + + + + + + + + 1 + + + 1 + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Absolute Value + + + Absolute value of a number. + + + + + + number + + The number. Must be a number. + + + + + + + Returns the absolute value of the number. + + + + + + + + + + + + + + + + + + Conversion + + + Converts a hexidecimal value to a decimal value. + + + + + + value + + The hexidecimal number. Must be a number in hexidecimal format. + + + + + + + Returns the value as a decimal string. If the value is not a number then a NaN value is returned. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 10 + 11 + 12 + 13 + 14 + 15 + + + + + Conversion + + + Converts a decimal value to a hexidecimal value. + + + + + + value + + The decimal number. + + + + + + + Returns the value as a hexidecimal string (lowercase). If the value is not a number then a NaN value is returned. + + + + + + + + 0 + NaN + + + + + + + + + + a + b + c + d + e + f + + + + + + + + Ordinal number + + + Gives the ordinal number of a given counting number. For example, 1 becomes "1st". + + + + + + number + + An integer number. + + + + + + + Returns the number with an ordinal suffix. + + + + + + + + + + + + th + st + nd + rd + th + + + + + + + + Returns an ordinal number + + + This template returns the ordinal number for a given counting number as a word. For example "first" for 1. + Only handles numbers less than 10000000 (ten million). + + + + + + number + + The counting number. + + + + conjunctive + + Whether to add the word "and" to the result, for example "one hundred and first" rather than "one hundred first". Default is "yes". + + + + + + + Returns the ordinal number as a string. + + + + + + + + + + + zeroth + + + + + and + first + + + and + second + + + and + third + + + and + fourth + + + and + fifth + + + and + sixth + + + and + seventh + + + and + eighth + + + and + ninth + + + and + tenth + + + and + eleventh + + + and + twelveth + + + and + thirteenth + + + and + fourteenth + + + and + fifteenth + + + and + sixteenth + + + and + seventeenth + + + and + eighteenth + + + and + nineteenth + + + and + twentieth + + + and + thirtieth + + + and + fortieth + + + and + fiftieth + + + and + sixtieth + + + and + seventieth + + + and + eightieth + + + and + ninetieth + + + + + + + millionth + + + and + + + + thousandth + + + and + + + + hundredth + + + + + + and + + + + + + + + + + + + + + + + + + + + + + + + + + and + + + + + + + + + + + + + + + + + + + + + + + + + + + and + + + + + + + + + + + + + + + and + + + + + + + + + + + + + + + + + Returns a number as a word + + + This template returns the word for a given integer number, for example "one" for 1. + Only handles numbers less than 10000000 (ten million). + + + + + + number + + The counting number. + + + + conjunctive + + Adds the word "and" where appropriate, for example. + + + + + + + Returns the number as a string. + + + + + + + + + + zero + + + minus + + + + + + + + + + + + million + + + + + + million + + + + + + + + + thousand + + + + + + thousand + and + + + + + + + + + hundred + + + + + + hundred + and + + + + + + one + two + three + four + five + six + seven + eight + nine + ten + eleven + twelve + thirteen + fourteen + fifteen + sixteen + seventeen + eighteen + nineteen + twenty + thirty + forty + fifty + sixty + seventy + eighty + ninety + + + + + + + + + + + + +                   + diff --git a/src/documentation/docbook-xsl/slides/keynote/xsltsl/node.xsl b/src/documentation/docbook-xsl/slides/keynote/xsltsl/node.xsl new file mode 100644 index 0000000000..aa562ad8c3 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/keynote/xsltsl/node.xsl @@ -0,0 +1,229 @@ + + + + + + + + $Id: node.xsl,v 1.1 2004/11/10 06:51:55 balls Exp $ + + + Ball + Steve + + + 2001 + Steve Ball + + + + Node Templates + + +
                  + Introduction + + This stylesheet module provides functions for reporting on or manipulating nodes and nodesets. + +
                  +                   + +                   + + + Returns an XPath location path + + + This template returns an XPath location path that uniquely identifies the given node within the document. + + + + + + node + + The node to create an XPath for. If this parameter is given as a nodeset, then the first node in the nodeset is used. + + + + + + + Returns an XPath location path as a string. + + + + + + + + + + + + / + [] + + + + + + /comment() + [] + + + + /processing-instruction() + [] + + + + /text() + [] + + + + / + + + + /namespace:: + + + + /@ + + + + + + + /.. + + + + + + + + Return node type + + + Returns the type of a node as a string. + + + + + + node + + The node to get the type for. If this parameter is given as a nodeset, then the first node in the nodeset is used. + + + + + + + Returns node type as a string. Values returned are: + + + Element + + element + + + + Text Node + + text + + + + Comment + + comment + + + + Processing Instruction + + processing instruction + + + + + + + + + + + + + element + + + text + + + comment + + + processing instruction + + + root + + + namespace + + + attribute + + + + + + Copy Nodes + + + Makes a copy of the given nodes, including attributes and descendants. + + + + + + nodes + + The nodes to copy. + + + + + + + Returns the copied nodes as a result tree fragment. + + + + + + + + + + + + + + + + + + +                   + diff --git a/src/documentation/docbook-xsl/slides/keynote/xsltsl/stdlib.xsl b/src/documentation/docbook-xsl/slides/keynote/xsltsl/stdlib.xsl new file mode 100644 index 0000000000..9ab5af456a --- /dev/null +++ b/src/documentation/docbook-xsl/slides/keynote/xsltsl/stdlib.xsl @@ -0,0 +1,340 @@ + + +]> + + + + + + + + + + + + + + + + + + + + XSLT Standard Library + Version &version; + + + + Ball + Steve + + + 2004 + 2002 + Steve Ball + + + + + The XSLT Standard Library, xsltsl, provides the XSLT developer with a set of XSLT templates for commonly used functions. These are implemented purely in XSLT, that is they do not use any extensions. + xsltsl is a SourceForge project. + + + + + + SourceForge Logo + + + Goals of the xsltsl project include: + + + Provision of a high-quality library of XSLT templates, suitable for inclusion by vendors in XSLT processor software products. + + + Demonstration of best practice in XSLT stylesheet development and documentation. + + + Provide examples of various techniques used to develop XSLT stylesheets (ie. a working FAQ). + + + + + + Using The Library + + There are two ways of using the library: + + + Use a local copy of the library. + + + Download the distribution (see below). + + + Unpack the distribution, using either gunzip/tar or unzip. + + + In your stylesheet import or include either the main stylesheet, stdlib.xsl, or the stylesheet module you wish to use, such as string.xsl. This example assumes that the distribution has been extracted into the same directory as your own stylesheet: + + +]]> + + + + + + Import or include either the main stylesheet, or the stylesheet module you wish to use, directly from the library website; http://xsltsl.sourceforge.net/modules/. The modules directory always contains the latest stable release. For example: + + +]]> + + Older versions of the library are available in subdirectories. For example, to access version 1.1 of the library use: + + +]]> + + + + Next, add XML Namespace declarations for the modules you wish to use. For example, to use templates from the string module, your stylesheet should have the following declaration: + + + + +]]> + + Finally, use a template with the call-template element. Most templates require parameters, which are passed using the with-param element. For example: + + + + + a word + another word + + +]]> + + + + + Obtaining The Library + + The XSLT Standard Library is available for download as either: + + + Gzip'd tarball: http://prdownloads.sourceforge.net/xsltsl/xsltsl-&version;.tar.gz + + + Zip file: http://prdownloads.sourceforge.net/xsltsl/xsltsl-&version;.zip + + + + + + Getting Involved + + Contributions to the project are most welcome, and may be in the form of stylesheet modules, patches, bug reports or sample code. Any contributed code must use the LGPL license to be accepted into the library. + + See the SourceForge Project Page http://sourceforge.net/projects/xsltsl/ for information on the development of the project. Bug reports may be submitted here. + + See the project Web Page http://xsltsl.sourceforge.net/ for documentation. + + There are three mailing lists for the project: + + + xsltsl-users@lists.sourceforge.net + + Discussion of the use of xsltsl. + + + + xsltsl-devel@lists.sourceforge.net + + Discussion of the development of xsltsl. + + + + xsltsl-announce@lists.sourceforge.net + + Project announcements. + + + + + + + XML Namespaces + + Apart from the XSLT XML Namespace (http://www.w3.org/1999/XSL/Transform), xsltsl employs a number of XML Namespaces to allow inclusion of the library in developer stylesheets. In addition, documentation is defined in a separate namespace. + Each module is allocated a namespace URI by appending the module name to the URI for the project, http://xsltsl.org/. For example, the string module has the namespace URI http://xsltsl.org/string. + All documentation is written using an extension of DocBook designed for embedding DocBook into XSLT stylesheets. The namespace URI for DocBook embedded in stylesheets is http://xsltsl.org/xsl/documentation/1.0 + + + + Engineering Standards + + In order to maintain a high engineering standard, all modules and contributions to the xsltsl project must adhere to the following coding and documentation standards. Submissions which do not meet (or exceed) this standard will not be accepted. + + + All stylesheets must be indented, with each level indented by two spaces. NB. a simple stylesheet could be used to enforce/fix this. + + + Templates are named using a qualified name (QName). The namespace URI for the template's containing stylesheet is assigned as above. + + + Parameters for templates should use sensible names. Where possible (or if in doubt), follow these conventions: + + + A parameter containing a single node is named node. Where more than one parameter contains a single node, the suffix Node is appended to the parameter name, eg. referenceNode + + + A parameter which potentially contains multiple nodes is named nodes. Where more than one parameter potentially contains multiple nodes, the suffix Nodes is appended to the parameter name, eg. copyNodes + + + A parameter which contains a string value is named text. + + + + + All templates in each stylesheet must be documented. A template is documented as a DocBook RefEntry. + + + Every stylesheet must include a test suite. The test system is in the test subdirectory. See test/test.html for further details. + + + + An example stylesheet has been provided, which acts as a template for new stylesheet modules. + + + + + Related Work + + The EXSLT project is creating a library to standardise extension functions. The XSLT Standard Library is complementary to the EXSLT project. + + + + + Reference Documentation + + Reference documentation is available for each module. + +
                  + String Processing + + + + string.xsl + + +
                  + +
                  + Nodes + + + + node.xsl + + +
                  + +
                  + Date/Time Processing + + + + date-time.xsl + + +
                  + +
                  + Mathematics + + + + math.xsl + + +
                  + +
                  + URI (Uniform Resource Identifier) Processing + + + + uri.xsl + + +
                  + +
                  + Comparing Nodesets + + + + cmp.xsl + + +
                  + +
                  + Generating XML Markup + + + + markup.xsl + + +
                  + +
                  + Presentation Media Support + + + + Scalable Vector Graphics: svg.xsl + + + +
                  + +
                  + Example + + + + + + example.xsl + + +
                  +                   + +                   + +                   diff --git a/src/documentation/docbook-xsl/slides/keynote/xsltsl/string.xsl b/src/documentation/docbook-xsl/slides/keynote/xsltsl/string.xsl new file mode 100644 index 0000000000..ddf3e941b1 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/keynote/xsltsl/string.xsl @@ -0,0 +1,1233 @@ + + + + + + + + $Id: string.xsl,v 1.1 2004/11/10 06:51:55 balls Exp $ + + + Ball + Steve + + + 2002 + 2001 + Steve Ball + + + + String Processing + + +
                  + Introduction + + This module provides templates for manipulating strings. + +
                  +                   + +                   + + + + + + + + + + + + + Make string uppercase + + + Converts all lowercase letters to uppercase. + + + + + + text + + The string to be converted + + + + + + + Returns string with all uppercase letters. + + + + + + + + + + + + + + ß + + + S + S + + + + + + + + + Make string lowercase + + + Converts all uppercase letters to lowercase. + + + + + + text + + The string to be converted + + + + + + + Returns string with all lowercase letters. + + + + + + + + + + + Capitalise string + + + Converts first character of string to an uppercase letter. All remaining characters are converted to lowercase. + + + + + + text + + The string to be capitalised + + + + all + + Boolean controlling whether all words in the string are capitalised. + Default is true. + + + + + + + Returns string with first character uppcase and all remaining characters lowercase. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Convert a string to one camelcase word + + + Converts a string to one lowerCamelCase or UpperCamelCase + word, depending on the setting of the "upper" + parameter. UpperCamelCase is also called MixedCase while + lowerCamelCase is also called just camelCase. The template + removes any spaces, tabs and slashes, but doesn't deal with + other punctuation. It's purpose is to convert strings like + "hollow timber flush door" to a term suitable as identifier or + XML tag like "HollowTimberFlushDoor". + + + + + + + text + + The string to be capitalised + + + + upper + + Boolean controlling whether the string becomes an + UpperCamelCase word or a lowerCamelCase word. + Default is true. + + + + + + + Returns string with first character uppcase and all remaining characters lowercase. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + String extraction + + + Extracts the portion of string 'text' which occurs before any of the characters in string 'chars'. + + + + + + text + + The string from which to extract a substring. + + + + chars + + The string containing characters to find. + + + + + + + Returns string. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + String extraction + + + Extracts the portion of string 'text' which occurs after the last of the character in string 'chars'. + + + + + + text + + The string from which to extract a substring. + + + + chars + + The string containing characters to find. + + + + + + + Returns string. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + String extraction + + + Extracts the portion of string 'text' which occurs before the first character of the last occurance of string 'chars'. + + + + + + text + + The string from which to extract a substring. + + + + chars + + The string containing characters to find. + + + + + + + Returns string. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + String substitution + + + Substitute 'replace' for 'with' in string 'text'. + + + + + + text + + The string upon which to perform substitution. + + + + replace + + The string to substitute. + + + + with + + The string to be substituted. + + + + disable-output-escaping + + A value of yes indicates that the result should have output escaping disabled. Any other value allows normal escaping of text values. The default is to enable output escaping. + + + + + + + Returns string. + + + + + + + + no + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Count Substrings + + + Counts the number of times a substring occurs in a string. This can also counts the number of times a character occurs in a string, since a character is simply a string of length 1. + + + + Counting Lines + + + + +]]> + + + + + + text + + The source string. + + + + chars + + The substring to count. + + + + + + + Returns a non-negative integer value. + + + + + + + + + + 0 + + + + + + + + + + + + 0 + + + + + + String extraction + + Extracts the portion of a 'char' delimited 'text' string "array" at a given 'position'. + + + + + text + + The string from which to extract a substring. + + + + chars + + delimiters + + + + position + + position of the elements + + + + all + + If true all of the remaining string is returned, otherwise only the element at the given position is returned. Default: false(). + + + + + + Returns string. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + String extraction + + Extracts the portion of a 'char' delimited 'text' string "array" at a given 'position' + + + + + text + + The string from which to extract a substring. + + + + chars + + delimiters + + + + position + + position of the elements + + + + + + Returns string. + + + + + + + + + + + + + + + + + + + + + + + + + + + String insertion + + Insert 'chars' into "text' at any given "position' + + + + + text + + The string upon which to perform insertion + + + + position + + the position where insertion will be performed + + + + with + + The string to be inserted + + + + + + Returns string. + + + + + + + + + + + + + + + + + String reversal + + + Reverse the content of a given string + + + + + + text + + The string to be reversed + + + + + + + Returns string. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Format a string + + + Inserts newlines and spaces into a string to format it as a block of text. + + + + + + text + + String to be formatted. + + + + max + + Maximum line length. + + + + indent + + Number of spaces to insert at the beginning of each line. + + + + justify + + Justify left, right or both. Not currently implemented (fixed at "left"). + + + + + + + Formatted block of text. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Find first occurring character in a string + + + Finds which of the given characters occurs first in a string. + + + + + + text + + The source string. + + + + chars + + The characters to search for. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Match A String To A Pattern + + + Performs globbing-style pattern matching on a string. + + + + Match Pattern + + + + +]]> + + + + + + text + + The source string. + + + + pattern + + The pattern to match against. Certain characters have special meaning: + + + * + + Matches zero or more characters. + + + + ? + + Matches a single character. + + + + \ + + Character escape. The next character is taken as a literal character. + + + + + + + + + + Returns "1" if the string matches the pattern, "0" otherwise. + + + + + + + + + + + 1 + + + 1 + + + 0 + + + + + + + + + + + + + + + + + + + + + + 0 + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + 1 + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + Create A Repeating Sequence of Characters + + + Repeats a string a given number of times. + + + + + + text + + The string to repeat. + + + + count + + The number of times to repeat the string. + + + + + + + + + + + + + + + + + + + + + + +                   + diff --git a/src/documentation/docbook-xsl/slides/keynote/xsltsl/svg.xsl b/src/documentation/docbook-xsl/slides/keynote/xsltsl/svg.xsl new file mode 100644 index 0000000000..de2c616e71 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/keynote/xsltsl/svg.xsl @@ -0,0 +1 @@ + $Id: svg.xsl,v 1.1 2004/11/10 06:51:55 balls Exp $ Ball Steve 2002 Steve Ball SVG Stylesheet
                  Introduction This module provides templates for creating SVG images.
                  Aqua-style Button Part of the mechanism to create an Aqua-style button. Include a call to this template in your SVG document's defs element. This template only needs to be included once. Use this in conjunction with svg:aqua-button. The default values for color1, color2 and color3 result in a grey button. prefix A prefix to append to the identifiers used, so that they don't clash with other identifiers. Default: "aqua-". color1 The base colour of the button. Default: "#d9d9d9". color2 A "background" colour for the button. Should be a darker colour than color1. Default: "#a9a9a9". color3 A highlight colour for the button. Should be a lighter colour than color1. Default: "#f9f9f9". Returns SVG result-tree-fragment. Aqua-style Button Part of the mechanism to create an Aqua-style button. Include a call to this template in your SVG document where you want a button to appear. This template can be used many times in a single SVG document. Use this in conjunction with svg:aqua-button-defs. prefix A prefix to append to the identifiers used, so that they don't clash with other identifiers. Default: "aqua-". Returns SVG result-tree-fragment.                   \ No newline at end of file diff --git a/src/documentation/docbook-xsl/slides/keynote/xsltsl/uri.xsl b/src/documentation/docbook-xsl/slides/keynote/xsltsl/uri.xsl new file mode 100644 index 0000000000..9950ae2578 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/keynote/xsltsl/uri.xsl @@ -0,0 +1,580 @@ + + + + + + + + $Id: uri.xsl,v 1.1 2004/11/10 06:51:55 balls Exp $ + + + Diamond + Jason + + + 2001 + Jason Diamond + + + + URI (Uniform Resource Identifier) Processing + + +
                  + Introduction + This module provides templates for processing URIs (Uniform Resource Identifers). +
                  +                   + +                   + + + Determines if a URI is absolute or relative. + + + Absolute URIs start with a scheme (like "http:" or "mailto:"). + + + + + + uri + + An absolute or relative URI. + + + + + + + Returns 'true' if the URI is absolute or '' if it's not. + + + + + + + + + + + + + + Gets the scheme part of a URI. + + + The ':' is not part of the scheme. + + + + + + uri + + An absolute or relative URI. + + + + + + + Returns the scheme (without the ':') or '' if the URI is relative. + + + + + + + + + + + + Gets the authority part of a URI. + + + The authority usually specifies the host machine for a resource. It always follows '//' in a typical URI. + + + + + + uri + + An absolute or relative URI. + + + + + + + Returns the authority (without the '//') or '' if the URI has no authority. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Gets the path part of a URI. + + + The path usually comes after the '/' in a URI. + + + + + + uri + + An absolute or relative URI. + + + + + + + Returns the path (with any leading '/') or '' if the URI has no path. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Gets the query part of a URI. + + + The query comes after the '?' in a URI. + + + + + + uri + + An absolute or relative URI. + + + + + + + Returns the query (without the '?') or '' if the URI has no query. + + + + + + + + + + + + + + + + + + + Gets the fragment part of a URI. + + + The fragment comes after the '#' in a URI. + + + + + + uri + + An absolute or relative URI. + + + + + + + Returns the fragment (without the '#') or '' if the URI has no fragment. + + + + + + + + + + + + Resolves a URI reference against a base URI. + + + This template follows the guidelines specified by RFC 2396. + + + + + + reference + + A (potentially relative) URI reference. + + + + base + + The base URI. + + + + document + + The URI of the current document. This defaults to the value of the base URI if not specified. + + + + + + + The "combined" URI. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/slides/param.xml b/src/documentation/docbook-xsl/slides/param.xml new file mode 100644 index 0000000000..76c9ebb082 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/param.xml @@ -0,0 +1,1415 @@ + + + + +Slides Parameter Reference + +$Id: param.xweb,v 1.7 2006/04/06 03:00:24 xmldoc Exp $ + + + Walsh + Norman + + + 2002 + Norman Walsh + + + +Introduction + +This is reference documentation for all user-configurable +parameters in the DocBook XSL Slides stylesheets (for generating +output from DocBook Slides documents). + +This reference describes each of the parameters. +These are the easily customizable parts of the stylesheet. +If you want to specify an alternate value for one or more of these +parameters, you can do so in a driver stylesheet. + +For example, if you want to change the keyboard.nav +parameter to 0, you might create a driver +stylesheet like this: + +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version='1.0'> + + <xsl:import href="http://docbook.sourceforge.net/release/slides/current/xsl/slides.xsl"/> + + <xsl:param name="keyboard.nav" select="0"/> + +</xsl:stylesheet> + +Naturally, you have to change the +href attribute on +<xsl:import> to point to the stylesheet +on your system. + + +Slides FO Parameters + +[none] + There currently are no Slides parameters for FO + output. + + + + +Slides HTML Parameters + +General Parameters + + + +keyboard.nav +boolean + + +keyboard.nav +Enable keyboard navigation? + + + + +<xsl:param name="keyboard.nav" select="1"></xsl:param> + + + +Description + +If non-zero, JavaScript is added to the slides to enable keyboard +navigation. Pressing 'n', space, or return moves forward; pressing 'p' moves +backward. + + + + + + +css.stylesheet +URI + + +css.stylesheet +CSS stylesheet for slides + + + + +<xsl:param name="css.stylesheet" select="'slides.css'"></xsl:param> + + + +Description + +Identifies the CSS stylesheet used by all the slides. This parameter +can be set in the source document with the <?dbhtml?> pseudo-attribute +css-stylesheet. + + + + + + +css.stylesheet.dir +URI + + +css.stylesheet.dir +Default directory for CSS stylesheets + + + + +<xsl:param name="css.stylesheet.dir" select="''"></xsl:param> + + + +Description + +Identifies the default directory for the CSS stylesheet +generated on all the slides. This parameter can be set in the source +document with the <?dbhtml?> pseudo-attribute +css-stylesheet-dir. + +If non-empty, this value is prepended to each of the stylesheets. + + + + + + + +titlefoil.html +filename + + +titlefoil.html +Name of title foil HTML file + + + + +<xsl:param name="titlefoil.html" select="concat('index', $html.ext)"></xsl:param> + + + +Description + +Sets the filename used for the slides titlepage. + + + + + + +toc.html +filename + + +toc.html +Name of ToC HTML file + + + + +<xsl:param name="toc.html" select="concat('toc', $html.ext)"></xsl:param> + + + +Description + +Sets the filename used for the table of contents page. + + + + + + +foilgroup.toc +boolean + + +foilgroup.toc +Put ToC on foilgroup pages? + + + + +<xsl:param name="foilgroup.toc" select="1"></xsl:param> + + + +Description + +If non-zero, a ToC will be placed on foilgroup pages (after any +other content). + + + + + + + +output.indent +list +no +yes + + +output.indent +Indent output? + + + + +<xsl:param name="output.indent" select="'no'"></xsl:param> + + + +Description + +Specifies the setting of the indent parameter +on the HTML slides. For more information, see the discussion of the +xsl:output element in the XSLT specification. + + + + + + +overlay +boolean + + +overlay +Overlay footer navigation? + + + + +<xsl:param name="overlay" select="0"></xsl:param> + + + +Description + +If non-zero, JavaScript is added to the slides to make the +bottom navigation appear at the bottom of each page. This option and +multiframe are mutually exclusive. + +If this parameter is zero, the bottom navigation simply appears +below the content of each slide. + + + + + + +show.foil.number +boolean + + +show.foil.number +Show foil number on each foil? + + + + +<xsl:param name="show.foil.number" select="0"></xsl:param> + + + +Description + +If non-zero, on each slide there will be its number. Currently +not supported in all output formats. + + + + + + + +Frame Parameters + + + +nav.separator +boolean + + +nav.separator +Output separator between navigation and body? + + + + +<xsl:param name="nav.separator" select="1"></xsl:param> + + + +Description + +If non-zero, a separator (<HR>) is +added between the navigation links and the content of each slide. + + + + + + +toc.row.height +length + + +toc.row.height +Height of ToC rows in dynamic ToCs + + + + +<xsl:param name="toc.row.height" select="22"></xsl:param> + + + +Description + +This parameter specifies the height of each row in the table of +contents. This is only applicable if a dynamic ToC is used. You may want to +adjust this parameter for optimal appearance with the font and image sizes +selected by your CSS stylesheet. + + + + + + + +toc.bg.color +color + + +toc.bg.color +Background color for ToC frame + + + + +<xsl:param name="toc.bg.color" select="'#FFFFFF'"></xsl:param> + + + +Description + +Specifies the background color used in the ToC frame. + + + + + + +body.bg.color +color + + +body.bg.color +Background color for body frame + + + + +<xsl:param name="body.bg.color" select="'#FFFFFF'"></xsl:param> + + + +Description + +Specifies the background color used in the body column of tabular slides. + + + + + + +toc.width +length + + +toc.width +Width of ToC frame + + + + +<xsl:param name="toc.width" select="250"></xsl:param> + + + +Description + +Specifies the width of the ToC frame. + + + + + + +toc.hide.show +boolean + + +toc.hide.show +Enable hide/show button for ToC frame + + + + +<xsl:param name="toc.hide.show" select="0"></xsl:param> + + + +Description + +If non-zero, JavaScript (and an additional icon, see +hidetoc.image and +showtoc.image) is added to each slide +to allow the ToC panel to be toggled on each panel. + +There is a bug in Mozilla 1.0 (at least as of CR3) that causes +the browser to reload the titlepage when this feature is used. + + + + + + +dynamic.toc +boolean + + +dynamic.toc +Dynamic ToCs? + + + + +<xsl:param name="dynamic.toc" select="0"></xsl:param> + + + +Description + +If non-zero, JavaScript is used to make the ToC panel dynamic. +In a dynamic ToC, each section in the ToC can be expanded and collapsed by +clicking on the appropriate image. + + + + + + +active.toc +boolean + + +active.toc +Active ToCs? + + + + +<xsl:param name="active.toc" select="0"></xsl:param> + + + +Description + +If non-zero, JavaScript is used to keep the ToC and the current slide +in sync. That is, each time the slide changes, the corresponding +ToC entry will be underlined. + + + + + + + + +multiframe +boolean + + +multiframe +Use multiple frames for slide bodies? + + + + +<xsl:param name="multiframe" select="0"></xsl:param> + + + +Description + +If non-zero, multiple frames are used for the body of each +slide. This is one way of forcing the slide navigation elements to +appear in constant locations. The other way is with overlays. The overlay and +multiframe parameters are mutually +exclusive. + + + + + + +multiframe.top.bgcolor +color + + +multiframe.top.bgcolor +Background color for top navigation frame + + + + +<xsl:param name="multiframe.top.bgcolor" select="'white'"></xsl:param> + + + +Description + +Specifies the background color of the top navigation frame when +multiframe is enabled. + + + + + + +multiframe.bottom.bgcolor +color + + +multiframe.bottom.bgcolor +Background color for bottom navigation frame + + + + +<xsl:param name="multiframe.bottom.bgcolor" select="'white'"></xsl:param> + + + +Description + +Specifies the background color of the bottom navigation frame when +multiframe is enabled. + + + + + + +multiframe.navigation.height +length + + +multiframe.navigation.height +Height of navigation frames + + + + +<xsl:param name="multiframe.navigation.height" select="40"></xsl:param> + + + +Description + +Specifies the height of the navigation frames when +multiframe is enabled. + + + + + + + +Graphics Parameters + + + +graphics.dir +URI + + +graphics.dir +Graphics directory + + + + +<xsl:param name="graphics.dir" select="''"></xsl:param> + + + +Description + +Identifies the graphics directory for the navigation components +generated on all the slides. This parameter can be set in the source +document with the <?dbhtml?> pseudo-attribute +graphics-dir. + +If non-empty, this value is prepended to each of the graphic +image paths. + + + + + + +bullet.image +filename + + +bullet.image +Bullet image + + + + +<xsl:param name="bullet.image" select="'toc/bullet.png'"></xsl:param> + + + +Description + +Specifies the filename of the bullet image used for foils in the +framed ToC. + + + + + + +next.image +filename + + +next.image +Right-arrow image + + + + +<xsl:param name="next.image" select="'active/nav-next.png'"></xsl:param> + + + +Description + +Specifies the filename of the right-pointing navigation arrow. + + + + + + +prev.image +filename + + +prev.image +Left-arrow image + + + + +<xsl:param name="prev.image" select="'active/nav-prev.png'"></xsl:param> + + + +Description + +Specifies the filename of the left-pointing navigation arrow. + + + + + + +up.image +filename + + +up.image +Up-arrow image + + + + +<xsl:param name="up.image" select="'active/nav-up.png'"></xsl:param> + + + +Description + +Specifies the filename of the upward-pointing navigation arrow. + + + + + + +home.image +filename + + +home.image +Home image + + + + +<xsl:param name="home.image" select="'active/nav-home.png'"></xsl:param> + + + +Description + +Specifies the filename of the home navigation icon. + + + + + + +toc.image +filename + + +toc.image +ToC image + + + + +<xsl:param name="toc.image" select="'active/nav-toc.png'"></xsl:param> + + + +Description + +Specifies the filename of the ToC navigation icon. + + + + + + + + +no.next.image +filename + + +no.next.image +Inactive right-arrow image + + + + +<xsl:param name="no.next.image" select="'inactive/nav-next.png'"></xsl:param> + + + +Description + +Specifies the filename of the inactive right-pointing navigation arrow. + + + + + + +no.prev.image +filename + + +no.prev.image +Inactive left-arrow image + + + + +<xsl:param name="no.prev.image" select="'inactive/nav-prev.png'"></xsl:param> + + + +Description + +Specifies the filename of the inactive left-pointing navigation arrow. + + + + + + +no.up.image +filename + + +no.up.image +Inactive up-arrow image + + + + +<xsl:param name="no.up.image" select="'inactive/nav-up.png'"></xsl:param> + + + +Description + +Specifies the filename of the inactive upward-pointing navigation arrow. + + + + + + +no.home.image +filename + + +no.home.image +Inactive home image + + + + +<xsl:param name="no.home.image" select="'inactive/nav-home.png'"></xsl:param> + + + +Description + +Specifies the filename of the inactive home navigation icon. + + + + + + +no.toc.image +filename + + +no.toc.image +Inactive ToC image + + + + +<xsl:param name="no.toc.image" select="'inactive/nav-toc.png'"></xsl:param> + + + +Description + +Specifies the filename of the inactive ToC navigation icon. + + + + + + + + +plus.image +filename + + +plus.image +Plus image + + + + +<xsl:param name="plus.image" select="'toc/closed.png'"></xsl:param> + + + +Description + +Specifies the filename of the plus image; the image used in a +dynamic ToC to indicate that a section +can be expanded. + + + + + + +minus.image +filename + + +minus.image +Minus image + + + + +<xsl:param name="minus.image" select="'toc/open.png'"></xsl:param> + + + +Description + +Specifies the filename of the minus image; the image used in a +dynamic ToC to indicate that a section +can be collapsed. + + + + + + +hidetoc.image +filename + + +hidetoc.image +Hide ToC image + + + + +<xsl:param name="hidetoc.image" select="'hidetoc.gif'"></xsl:param> + + + +Description + +Specifies the filename of the hide ToC image. This is used +when the ToC hide/show parameter is +enabled. + + + + + + +showtoc.image +filename + + +showtoc.image +Show ToC image + + + + +<xsl:param name="showtoc.image" select="'showtoc.gif'"></xsl:param> + + + +Description + +Specifies the filename of the show ToC image. This is used +when the ToC hide/show parameter is +enabled. + + + + + + + +JavaScript Parameters + + + +script.dir +URI + + +script.dir +Script directory + + + + +<xsl:param name="script.dir" select="''"></xsl:param> + + + +Description + +Identifies the JavaScript source directory for the slides. +This parameter can be set in the source +document with the <?dbhtml?> pseudo-attribute +script-dir. + +If non-empty, this value is prepended to each of the JavaScript files. + + + + + + + +ua.js +filename + + +ua.js +UA JavaScript file + + + + +<xsl:param name="ua.js" select="'ua.js'"></xsl:param> + + + +Description + +Specifies the filename of the UA JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +xbDOM.js +filename + + +xbDOM.js +xbDOM JavaScript file + + + + +<xsl:param name="xbDOM.js" select="'xbDOM.js'"></xsl:param> + + + +Description + +Specifies the filename of the xbDOM JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +xbStyle.js +filename + + +xbStyle.js +xbStyle JavaScript file + + + + +<xsl:param name="xbStyle.js" select="'xbStyle.js'"></xsl:param> + + + +Description + +Specifies the filename of the xbStyle JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +xbLibrary.js +filename + + +xbLibrary.js +xbLibrary JavaScript file + + + + +<xsl:param name="xbLibrary.js" select="'xbLibrary.js'"></xsl:param> + + + +Description + +Specifies the filename of the xbLibrary JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +xbCollapsibleLists.js +filename + + +xbCollapsibleLists.js +xbCollapsibleLists JavaScript file + + + + +<xsl:param name="xbCollapsibleLists.js" select="'xbCollapsibleLists.js'"></xsl:param> + + + +Description + +Specifies the filename of the xbCollapsibleLists JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +overlay.js +filename + + +overlay.js +Overlay JavaScript file + + + + +<xsl:param name="overlay.js" select="'overlay.js'"></xsl:param> + + + +Description + +Specifies the filename of the overlay JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +slides.js +filename + + +slides.js +Slides overlay file + + + + +<xsl:param name="slides.js" select="'slides.js'"></xsl:param> + + + +Description + +Specifies the filename of the slides JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +Localization Parameters + + + +text.home +string + + +text.home +Home + + + + +<xsl:param name="text.home" select="'Home'"></xsl:param> + + + +Description + +FIXME: + + + + + + +text.toc +string + + +text.toc +FIXME: + + + + +<xsl:param name="text.toc" select="'ToC'"></xsl:param> + + + +Description + +FIXME: + + + + + + +text.prev +string + + +text.prev +FIXME: + + + + +<xsl:param name="text.prev" select="'Prev'"></xsl:param> + + + +Description + +FIXME: + + + + + + +text.up +string + + +text.up +FIXME: + + + + +<xsl:param name="text.up" select="'Up'"></xsl:param> + + + +Description + +FIXME: + + + + + + +text.next +string + + +text.next +FIXME: + + + + +<xsl:param name="text.next" select="'Next'"></xsl:param> + + + +Description + +FIXME: + + + + + + + + + +The Stylesheet + +The param.xsl stylesheet is just a wrapper +around all these parameters. + + + +<!-- This file is generated from param.xweb; do not edit this file! --> + +<xsl:stylesheet exclude-result-prefixes="src" version="1.0"> + +<!-- ******************************************************************** + $Id: param.xweb,v 1.7 2006/04/06 03:00:24 xmldoc Exp $ + ******************************************************************** + + This file is part of the DocBook Slides Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<src:fragref linkend="active.toc.frag"></src:fragref> +<src:fragref linkend="body.bg.color.frag"></src:fragref> +<src:fragref linkend="bullet.image.frag"></src:fragref> +<src:fragref linkend="css.stylesheet.frag"></src:fragref> +<src:fragref linkend="css.stylesheet.dir.frag"></src:fragref> +<src:fragref linkend="dynamic.toc.frag"></src:fragref> +<src:fragref linkend="foilgroup.toc.frag"></src:fragref> +<src:fragref linkend="graphics.dir.frag"></src:fragref> +<src:fragref linkend="hidetoc.image.frag"></src:fragref> +<src:fragref linkend="home.image.frag"></src:fragref> +<src:fragref linkend="keyboard.nav.frag"></src:fragref> +<src:fragref linkend="minus.image.frag"></src:fragref> +<src:fragref linkend="multiframe.bottom.bgcolor.frag"></src:fragref> +<src:fragref linkend="multiframe.frag"></src:fragref> +<src:fragref linkend="multiframe.navigation.height.frag"></src:fragref> +<src:fragref linkend="multiframe.top.bgcolor.frag"></src:fragref> +<src:fragref linkend="nav.separator.frag"></src:fragref> +<src:fragref linkend="next.image.frag"></src:fragref> +<src:fragref linkend="no.home.image.frag"></src:fragref> +<src:fragref linkend="no.next.image.frag"></src:fragref> +<src:fragref linkend="no.prev.image.frag"></src:fragref> +<src:fragref linkend="no.toc.image.frag"></src:fragref> +<src:fragref linkend="no.up.image.frag"></src:fragref> +<src:fragref linkend="output.indent.frag"></src:fragref> +<src:fragref linkend="overlay.frag"></src:fragref> +<src:fragref linkend="overlay.js.frag"></src:fragref> +<src:fragref linkend="overlay.logo.frag"></src:fragref> +<src:fragref linkend="plus.image.frag"></src:fragref> +<src:fragref linkend="prev.image.frag"></src:fragref> +<src:fragref linkend="script.dir.frag"></src:fragref> +<src:fragref linkend="show.foil.number.frag"></src:fragref> +<src:fragref linkend="showtoc.image.frag"></src:fragref> +<src:fragref linkend="slides.js.frag"></src:fragref> +<src:fragref linkend="text.home.frag"></src:fragref> +<src:fragref linkend="text.next.frag"></src:fragref> +<src:fragref linkend="text.prev.frag"></src:fragref> +<src:fragref linkend="text.toc.frag"></src:fragref> +<src:fragref linkend="text.up.frag"></src:fragref> +<src:fragref linkend="titlefoil.html.frag"></src:fragref> +<src:fragref linkend="toc.bg.color.frag"></src:fragref> +<src:fragref linkend="toc.hide.show.frag"></src:fragref> +<src:fragref linkend="toc.html.frag"></src:fragref> +<src:fragref linkend="toc.image.frag"></src:fragref> +<src:fragref linkend="toc.row.height.frag"></src:fragref> +<src:fragref linkend="toc.width.frag"></src:fragref> +<src:fragref linkend="ua.js.frag"></src:fragref> +<src:fragref linkend="up.image.frag"></src:fragref> +<src:fragref linkend="xbCollapsibleLists.js.frag"></src:fragref> +<src:fragref linkend="xbDOM.js.frag"></src:fragref> +<src:fragref linkend="xbStyle.js.frag"></src:fragref> +<src:fragref linkend="xbLibrary.js.frag"></src:fragref> + +</xsl:stylesheet> + + + + + \ No newline at end of file diff --git a/src/documentation/docbook-xsl/slides/param.xsl b/src/documentation/docbook-xsl/slides/param.xsl new file mode 100644 index 0000000000..7cff036b3f --- /dev/null +++ b/src/documentation/docbook-xsl/slides/param.xsl @@ -0,0 +1,68 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/src/documentation/docbook-xsl/slides/param.xweb b/src/documentation/docbook-xsl/slides/param.xweb new file mode 100644 index 0000000000..21c0a74c7c --- /dev/null +++ b/src/documentation/docbook-xsl/slides/param.xweb @@ -0,0 +1,1442 @@ + + +Slides Parameter Reference + +$Id: param.xweb,v 1.7 2006/04/06 03:00:24 xmldoc Exp $ + + + Walsh + Norman + + + 2002 + Norman Walsh + + + +Introduction + +This is reference documentation for all user-configurable +parameters in the DocBook XSL Slides stylesheets (for generating +output from DocBook Slides documents). + +This reference describes each of the parameters. +These are the easily customizable parts of the stylesheet. +If you want to specify an alternate value for one or more of these +parameters, you can do so in a driver stylesheet. + +For example, if you want to change the keyboard.nav +parameter to 0, you might create a driver +stylesheet like this: + + + + + + + +]]> + +Naturally, you have to change the +href attribute on +<xsl:import> to point to the stylesheet +on your system. + + +Slides FO Parameters + +[none] + There currently are no Slides parameters for FO + output. + + + + +Slides HTML Parameters + +General Parameters + + + +keyboard.nav +boolean + + +keyboard.nav +Enable keyboard navigation? + + + + + + + + +Description + +If non-zero, JavaScript is added to the slides to enable keyboard +navigation. Pressing 'n', space, or return moves forward; pressing 'p' moves +backward. + + + + + + +css.stylesheet +URI + + +css.stylesheet +CSS stylesheet for slides + + + + + + + + +Description + +Identifies the CSS stylesheet used by all the slides. This parameter +can be set in the source document with the <?dbhtml?> pseudo-attribute +css-stylesheet. + + + + + + +css.stylesheet.dir +URI + + +css.stylesheet.dir +Default directory for CSS stylesheets + + + + + + + + +Description + +Identifies the default directory for the CSS stylesheet +generated on all the slides. This parameter can be set in the source +document with the <?dbhtml?> pseudo-attribute +css-stylesheet-dir. + +If non-empty, this value is prepended to each of the stylesheets. + + + + + + + +titlefoil.html +filename + + +titlefoil.html +Name of title foil HTML file + + + + + + + + +Description + +Sets the filename used for the slides titlepage. + + + + + + +toc.html +filename + + +toc.html +Name of ToC HTML file + + + + + + + + +Description + +Sets the filename used for the table of contents page. + + + + + + +foilgroup.toc +boolean + + +foilgroup.toc +Put ToC on foilgroup pages? + + + + + + + + +Description + +If non-zero, a ToC will be placed on foilgroup pages (after any +other content). + + + + + + + +output.indent +list +no +yes + + +output.indent +Indent output? + + + + + + + + +Description + +Specifies the setting of the indent parameter +on the HTML slides. For more information, see the discussion of the +xsl:output element in the XSLT specification. + + + + + + +overlay +boolean + + +overlay +Overlay footer navigation? + + + + + + + + +Description + +If non-zero, JavaScript is added to the slides to make the +bottom navigation appear at the bottom of each page. This option and +multiframe are mutually exclusive. + +If this parameter is zero, the bottom navigation simply appears +below the content of each slide. + + + + + + +show.foil.number +boolean + + +show.foil.number +Show foil number on each foil? + + + + + + + + +Description + +If non-zero, on each slide there will be its number. Currently +not supported in all output formats. + + + + + + + +Frame Parameters + + + +nav.separator +boolean + + +nav.separator +Output separator between navigation and body? + + + + + + + + +Description + +If non-zero, a separator (<HR>) is +added between the navigation links and the content of each slide. + + + + + + +toc.row.height +length + + +toc.row.height +Height of ToC rows in dynamic ToCs + + + + + + + + +Description + +This parameter specifies the height of each row in the table of +contents. This is only applicable if a dynamic ToC is used. You may want to +adjust this parameter for optimal appearance with the font and image sizes +selected by your CSS stylesheet. + + + + + + + +toc.bg.color +color + + +toc.bg.color +Background color for ToC frame + + + + + + + + +Description + +Specifies the background color used in the ToC frame. + + + + + + +body.bg.color +color + + +body.bg.color +Background color for body frame + + + + + + + + +Description + +Specifies the background color used in the body column of tabular slides. + + + + + + +toc.width +length + + +toc.width +Width of ToC frame + + + + + + + + +Description + +Specifies the width of the ToC frame. + + + + + + +toc.hide.show +boolean + + +toc.hide.show +Enable hide/show button for ToC frame + + + + + + + + +Description + +If non-zero, JavaScript (and an additional icon, see +hidetoc.image and +showtoc.image) is added to each slide +to allow the ToC panel to be toggled on each panel. + +There is a bug in Mozilla 1.0 (at least as of CR3) that causes +the browser to reload the titlepage when this feature is used. + + + + + + +dynamic.toc +boolean + + +dynamic.toc +Dynamic ToCs? + + + + + + + + +Description + +If non-zero, JavaScript is used to make the ToC panel dynamic. +In a dynamic ToC, each section in the ToC can be expanded and collapsed by +clicking on the appropriate image. + + + + + + +active.toc +boolean + + +active.toc +Active ToCs? + + + + + + + + +Description + +If non-zero, JavaScript is used to keep the ToC and the current slide +in sync. That is, each time the slide changes, the corresponding +ToC entry will be underlined. + + + + + + + + +multiframe +boolean + + +multiframe +Use multiple frames for slide bodies? + + + + + + + + +Description + +If non-zero, multiple frames are used for the body of each +slide. This is one way of forcing the slide navigation elements to +appear in constant locations. The other way is with overlays. The overlay and +multiframe parameters are mutually +exclusive. + + + + + + +multiframe.top.bgcolor +color + + +multiframe.top.bgcolor +Background color for top navigation frame + + + + + + + + +Description + +Specifies the background color of the top navigation frame when +multiframe is enabled. + + + + + + +multiframe.bottom.bgcolor +color + + +multiframe.bottom.bgcolor +Background color for bottom navigation frame + + + + + + + + +Description + +Specifies the background color of the bottom navigation frame when +multiframe is enabled. + + + + + + +multiframe.navigation.height +length + + +multiframe.navigation.height +Height of navigation frames + + + + + + + + +Description + +Specifies the height of the navigation frames when +multiframe is enabled. + + + + + + + +Graphics Parameters + + + +graphics.dir +URI + + +graphics.dir +Graphics directory + + + + + + + + +Description + +Identifies the graphics directory for the navigation components +generated on all the slides. This parameter can be set in the source +document with the <?dbhtml?> pseudo-attribute +graphics-dir. + +If non-empty, this value is prepended to each of the graphic +image paths. + + + + + + +bullet.image +filename + + +bullet.image +Bullet image + + + + + + + + +Description + +Specifies the filename of the bullet image used for foils in the +framed ToC. + + + + + + +next.image +filename + + +next.image +Right-arrow image + + + + + + + + +Description + +Specifies the filename of the right-pointing navigation arrow. + + + + + + +prev.image +filename + + +prev.image +Left-arrow image + + + + + + + + +Description + +Specifies the filename of the left-pointing navigation arrow. + + + + + + +up.image +filename + + +up.image +Up-arrow image + + + + + + + + +Description + +Specifies the filename of the upward-pointing navigation arrow. + + + + + + +home.image +filename + + +home.image +Home image + + + + + + + + +Description + +Specifies the filename of the home navigation icon. + + + + + + +toc.image +filename + + +toc.image +ToC image + + + + + + + + +Description + +Specifies the filename of the ToC navigation icon. + + + + + + + + +no.next.image +filename + + +no.next.image +Inactive right-arrow image + + + + + + + + +Description + +Specifies the filename of the inactive right-pointing navigation arrow. + + + + + + +no.prev.image +filename + + +no.prev.image +Inactive left-arrow image + + + + + + + + +Description + +Specifies the filename of the inactive left-pointing navigation arrow. + + + + + + +no.up.image +filename + + +no.up.image +Inactive up-arrow image + + + + + + + + +Description + +Specifies the filename of the inactive upward-pointing navigation arrow. + + + + + + +no.home.image +filename + + +no.home.image +Inactive home image + + + + + + + + +Description + +Specifies the filename of the inactive home navigation icon. + + + + + + +no.toc.image +filename + + +no.toc.image +Inactive ToC image + + + + + + + + +Description + +Specifies the filename of the inactive ToC navigation icon. + + + + + + + + +plus.image +filename + + +plus.image +Plus image + + + + + + + + +Description + +Specifies the filename of the plus image; the image used in a +dynamic ToC to indicate that a section +can be expanded. + + + + + + +minus.image +filename + + +minus.image +Minus image + + + + + + + + +Description + +Specifies the filename of the minus image; the image used in a +dynamic ToC to indicate that a section +can be collapsed. + + + + + + +hidetoc.image +filename + + +hidetoc.image +Hide ToC image + + + + + + + + +Description + +Specifies the filename of the hide ToC image. This is used +when the ToC hide/show parameter is +enabled. + + + + + + +showtoc.image +filename + + +showtoc.image +Show ToC image + + + + + + + + +Description + +Specifies the filename of the show ToC image. This is used +when the ToC hide/show parameter is +enabled. + + + + + + + +JavaScript Parameters + + + +script.dir +URI + + +script.dir +Script directory + + + + + + + + +Description + +Identifies the JavaScript source directory for the slides. +This parameter can be set in the source +document with the <?dbhtml?> pseudo-attribute +script-dir. + +If non-empty, this value is prepended to each of the JavaScript files. + + + + + + + +ua.js +filename + + +ua.js +UA JavaScript file + + + + + + + + +Description + +Specifies the filename of the UA JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +xbDOM.js +filename + + +xbDOM.js +xbDOM JavaScript file + + + + + + + + +Description + +Specifies the filename of the xbDOM JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +xbStyle.js +filename + + +xbStyle.js +xbStyle JavaScript file + + + + + + + + +Description + +Specifies the filename of the xbStyle JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +xbLibrary.js +filename + + +xbLibrary.js +xbLibrary JavaScript file + + + + + + + + +Description + +Specifies the filename of the xbLibrary JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +xbCollapsibleLists.js +filename + + +xbCollapsibleLists.js +xbCollapsibleLists JavaScript file + + + + + + + + +Description + +Specifies the filename of the xbCollapsibleLists JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +overlay.js +filename + + +overlay.js +Overlay JavaScript file + + + + + + + + +Description + +Specifies the filename of the overlay JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +slides.js +filename + + +slides.js +Slides overlay file + + + + + + + + +Description + +Specifies the filename of the slides JavaScript file. It's unlikely +that you will ever need to change this parameter. + + + + + + +Localization Parameters + + + +text.home +string + + +text.home +Home + + + + + + + + +Description + +FIXME: + + + + + + +text.toc +string + + +text.toc +FIXME: + + + + + + + + +Description + +FIXME: + + + + + + +text.prev +string + + +text.prev +FIXME: + + + + + + + + +Description + +FIXME: + + + + + + +text.up +string + + +text.up +FIXME: + + + + + + + + +Description + +FIXME: + + + + + + +text.next +string + + +text.next +FIXME: + + + + + + + + +Description + +FIXME: + + + + + + + + + +The Stylesheet + +The param.xsl stylesheet is just a wrapper +around all these parameters. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/slides/svg/default.xsl b/src/documentation/docbook-xsl/slides/svg/default.xsl new file mode 100644 index 0000000000..2031eda2ff --- /dev/null +++ b/src/documentation/docbook-xsl/slides/svg/default.xsl @@ -0,0 +1,686 @@ + + + + + + + SVG Slides + + + Steve + Ball + + Zveno +
                  + + zveno.com + +
                  +                   +                   + + $Id: default.xsl,v 1.1 2004/11/10 06:51:55 balls Exp $ + + + 2002 + Steve Ball, Zveno Pty Ltd + + + + Zveno Pty Ltd makes this software and associated documentation available free of charge for any purpose. You may make copies of the software but you must include all of this notice on any copy. + Zveno Pty Ltd does not warrant that this software is error free or fit for any purpose. Zveno Pty Ltd disclaims any liability for all claims, expenses, losses, damages and costs any user may incur as a result of using, copying or modifying the software. + +                   +                   + + + + + + + + + slides.css + graphics + + white + + Arial + white + black + + + + + + + + preserve + 100% + + font-family: ; font-size: 18pt; fill: ; stroke: ; background-color: + + + + font-size: 24pt; font-weight: bold + + + font-size: 18pt + + + font-size: 18pt + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + href=" + + " type="text/css" + + + + + + + + + + + + + + + + title + + + + + + + + + + + + + title.click + + + foil1-previous-button.click; + + + + + + + + + + + + + + toc + + + + + + + + + + title.click + + + + + + toc.click; toc-content.click + + + + + + + + + + + + + + 50 + + 75 + + + + + + title.click + + + + + + toc.click; toc-content.click + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + index-foilgroup- + + + + + + #ff8000 + #ff8000 + + + + + + + + + + + + + + + + + + + + + + + + + + + + toc + + + + + + + + + + + + index-foilgroup-1.click; toc.click; toc-content.click + + + index-foilgroup- + + .click; foil + + .click + + + + + + + + + + + + + + + 50 + + 75 + + + + + + + + index-foilgroup-1.click; toc.click; toc-content.click + + + index-foilgroup- + + .click; foil + + .click + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + + + + + + + + + + + + + + TOC + + + + + + + + + + + + + Previous + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + title.click + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + font-weight: bold + + + font-style: italic + + + font-style: italic + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/slides/xhtml/css.xsl b/src/documentation/docbook-xsl/slides/xhtml/css.xsl new file mode 100644 index 0000000000..e9c618ca67 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/css.xsl @@ -0,0 +1,47 @@ + + + + + + + + + + + + + + + + + + + + + / + + + + / + + + http://docbook.sourceforge.net/release/slides/browser/ + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/slides/xhtml/default.xsl b/src/documentation/docbook-xsl/slides/xhtml/default.xsl new file mode 100644 index 0000000000..b5705c9787 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/default.xsl @@ -0,0 +1,246 @@ + + + + + + + + + + + + + + + + + + +
                  + + + + + + + +
                  + + + + + + + + Prev + + + + + + +   + + + + + + + + + + + + + + + + + + Next + + + + + + +   + +
                  +
                  +
                  +                   + + + + + + + + +
                  +
                  + + + + + +
                  + + + + + + + +   +
                  +
                  +                   + + + + + + + + + + +
                  + + + + + + +
                  + + + + TableofContents + + + + +   + +   +
                  +
                  +                   + + + + + + + + +
                  + + + + + +
                  + + + + + + + + + Next + + + + + +
                  +
                  +                   + + + + + + + + +
                  + + + + +
                  +   +
                  +
                  +                   + + +
                  + + + + + +
                  + + + + + + Next + + + + + +
                  +
                  +                   + + + + + + + Hide/Show TOC + + + + + toggletoc(this, + + ,' + + ',' + + '); + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/slides/xhtml/flat.xsl b/src/documentation/docbook-xsl/slides/xhtml/flat.xsl new file mode 100644 index 0000000000..c1118d439e --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/flat.xsl @@ -0,0 +1,71 @@ + + + + + + + + + + + <xsl:value-of select="/slides/slidesinfo/title"/> + + + + + + + + + + + + +
                  +
                  + +
                  +
                  +                   + + + + + + + + + + +
                  +
                  + +
                  + +
                  +                   + + + + + + +
                  +
                  + +
                  + +
                  + + +                   + + +
                  +

                  + + +
                  +                   + +                   diff --git a/src/documentation/docbook-xsl/slides/xhtml/frames.xsl b/src/documentation/docbook-xsl/slides/xhtml/frames.xsl new file mode 100644 index 0000000000..29ad586897 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/frames.xsl @@ -0,0 +1,1982 @@ + + + + + + + + + + + + + + + + + + + + + -//W3C//DTD HTML 4.01 Frameset//EN + + + + + + + + + + -//W3C//DTD XHTML 1.0 Frameset//EN + + + -//W3C//DTD XHTML 1.0 Transitional//EN + + + + + + + + + + + + + + http://www.w3.org/TR/html4/loose.dtd + + + + + + + + + + http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd + + + http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd + + + + + + + + + + + + + + + + + + + + + + + + + Multiframe and overlay are mutually exclusive. + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="$title"/> + + + + + + <body class="frameset"> + <xsl:call-template name="body.attributes"/> + <a href="{concat('titleframe', $html.ext)}"> + <xsl:text>Your browser doesn't support frames.</xsl:text> + </a> + </body> + + + + + + + + + + + + + TOC - <xsl:value-of select="$title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + overlaySetup('ll'); + + + + + + init( + + ); + + overlaySetup('ll'); + + + + + + +
                  + +
                  +                   + +
                  + + + + +
                  + logo +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + javascript:body.focus() + + + + + + + + + <body class="frameset"> + <xsl:call-template name="body.attributes"/> + <p> + <xsl:text>Your browser doesn't support frames.</xsl:text> + </p> + </body> + + + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Body + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + newPage(' + + ', + + ); + + + + + overlaySetup('lc'); + + + + + + + this.focus() + + + navigate(event) + + + +
                  + +
                  + + + + + +                   + + + + + + + + + + +
                  + + + + + + +
                  + + + + + + + + + foil + + {$text.prev} + + + + + + + + +   + + +   + + + + + + + + + + + + foil + + {$text.next} + + + + + + + + +   + + +   +
                  +
                  +
                  +                   + + + + + + + + +
                  +
                  + + + + + + +
                  + +   + + + + + + + + + + foil + + {$text.prev} + + + + + + + + +   + + +   + + + + + + + + + + foil + + {$text.next} + + + + + + + + +   + + +   +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + foilgroup + + + + + + + javascript:body.focus() + + + + + + <body class="frameset"> + <xsl:call-template name="body.attributes"/> + <p> + <xsl:text>Your browser doesn't support frames.</xsl:text> + </p> + </body> + + + + + + + foilgroup + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + foilgroup + + + + + + + + + + + Body + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + foilgroup + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + newPage(' + + ', + + ); + + + + + overlaySetup('lc'); + + + + + + + + navigate(event) + + + +
                  + + + + + + + + + +
                  + + + + + + +
                  + + +
                  + + + position:absolute;visibility:visible; + + + + + + + + +
                  +                   +
                  + + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + javascript:body.focus() + + + + + + + + + <body class="frameset"> + <xsl:call-template name="body.attributes"/> + <p> + <xsl:text>Your browser doesn't support frames.</xsl:text> + </p> + </body> + + + + + + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Body + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Navigation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + newPage(' + + ', + + ); + + + + + overlaySetup('lc'); + + + + + + + navigate(event) + + + +
                  + + + + + + + + + +
                  + +
                  + + +
                  + + + position:absolute;visibility:visible; + + + + + + + + +
                  +                   +
                  + + + +                   + + + + + + + + + + + + + + + foilgroup + + + + +
                  + - + + + + + + + + + + + + + + + +
                  +                   + + + + + + + +
                  + - + + + + + + + + + + + + + + +
                  +                   + + + + + + + + + myList.addItem(' + + <div id=" + + " class="toc-slidesinfo"> + + <a href=" + + " target="foil"> + + + + + + + + + + + + + ' + \' + + + <\/a><\/div> + '); + + + + + + + + + subList = new List(false, width, height, " + +"); + + subList.setIndent(12); + + + + myList.addList(subList, ' + + <div id=" + + " class="toc-foilgroup"> + + <a href=" + + " target="foil"> + + + + + + + + + + + + + ' + \' + + + <\/a><\/div> + '); + + + + + + + + + subList.addItem(' + + + myList.addItem(' + + + + <div id=" + + " class="toc-foil"> + + <img alt="-" src=" + + "><\/img> + + <a href=" + + " target="foil"> + + + + + + + + + + + + + ' + \' + + + <\/a><\/div> + '); + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/slides/xhtml/graphics.xsl b/src/documentation/docbook-xsl/slides/xhtml/graphics.xsl new file mode 100644 index 0000000000..58a5260aac --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/graphics.xsl @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + + + + + + + + / + + + + / + + + http://docbook.sourceforge.net/release/slides/graphics/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/slides/xhtml/html2xhtml.xsl b/src/documentation/docbook-xsl/slides/xhtml/html2xhtml.xsl new file mode 100644 index 0000000000..18b7d54953 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/html2xhtml.xsl @@ -0,0 +1,181 @@ + + + + + + + + + + This file was created automatically by html2xhtml + + from the HTML stylesheets. Do not edit this file. + + + + + + + + + + + + + + + + + + + + + xml + UTF-8 + -//W3C//DTD XHTML 1.0 Transitional//EN + http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd + + + + + + + + + /html/ + /xhtml/ + + + + + + + + + 'xhtml' + + + + + + + 1 + + + + + + + 'xml' + + + + + + + 'xml' + + + + + + + 'UTF-8' + + + + + + + '-//W3C//DTD XHTML 1.0 Transitional//EN' + + + + + + + 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd' + + + + + + + + + id + + + + + + + + + + + + + + + + + http://www.w3.org/1999/xhtml + + + + + + + + + no apply-templates; make it empty + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/slides/xhtml/jscript.xsl b/src/documentation/docbook-xsl/slides/xhtml/jscript.xsl new file mode 100644 index 0000000000..688718b4bd --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/jscript.xsl @@ -0,0 +1,128 @@ + + + + + + + + + + + + + + + + + + + / + + + + / + + + http://docbook.sourceforge.net/release/slides/browser/ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/slides/xhtml/plain.xsl b/src/documentation/docbook-xsl/slides/xhtml/plain.xsl new file mode 100644 index 0000000000..8ae1c0a7bf --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/plain.xsl @@ -0,0 +1,467 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + +
                  + + + +   + + + + + + + + + + + Home + + + + + + + + Home + + + + + + +   + + + + + ToC + + + + + + + + ToC + + + + + + +   + + + + + + + + + + + Prev + + + + + + + + Prev + + + + + + +   + + + + + + + + + + + Up + + + + + + + + Up + + + + + + +   + + + + + + + + + + + Next + + + + + + + + Next + + + + + + +   +
                  +
                  +
                  +                   + + + + + + + + + + +
                  + + + + + +
                  +   + + + + + + + + + + + Home + + + + + + + + Home + + + + + + +   + + + + + ToC + + + + + + + + ToC + + + + + + +   + + + + + + + + + + + Prev + + + + + + + + Prev + + + + + + +   + + + + + + + + + + + Up + + + + + + + + Up + + + + + + +   + + + + + + + + + + + Next + + + + + + + + Next + + + + + + +   +
                  +
                  +
                  +                   + + + + + + + + + + +
                  + + + + + +
                  +   + + + + + + + + + + + Home + + + + + + + + Home + + + + + + +   + + + + + ToC + + + + + + + + ToC + + + + + + +   + + + + + + + + + + + Prev + + + + + + + + Prev + + + + + + +   + + + + + + + + + + + Up + + + + + + + + Up + + + + + + +   + + + + + + + + + + + Next + + + + + + + + Next + + + + + + +   +
                  +
                  +
                  +                   + + + + + +                   diff --git a/src/documentation/docbook-xsl/slides/xhtml/slides-common.xsl b/src/documentation/docbook-xsl/slides/xhtml/slides-common.xsl new file mode 100644 index 0000000000..f525fa61ed --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/slides-common.xsl @@ -0,0 +1,1534 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + +
                  + + + + + + + + + + +   + + + + + + + + + {$text.home} + + + + + + + + + + {$text.home} + + + + + + + +   + + + + + + + + + {$text.toc} + + + + + + + + + + {$text.toc} + + + + + + + +   + + + + + + + + + {$text.prev} + + + + + + + + + + {$text.prev} + + + + + + + +   + + + + + + + + + {$text.up} + + + + + + + + + + {$text.up} + + + + + + + +   + + + + + + + + + {$text.next} + + + + + + + + + + {$text.next} + + + + + + + +   +
                  +
                  +
                  +                   + + + + + + + + +
                  +
                  + + + + + + +
                  + +   + + + + + + + + + {$text.prev} + + + + + + + + + + {$text.prev} + + + + + + + +   + + + + + + + + + {$text.next} + + + + + + + + + + {$text.next} + + + + + + + +   +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + titlepage + + - + + + + + + + + overlaySetup('lc') + + + + + navigate(event) + + + +
                  + + + + + +
                  + +
                  + +
                  + + + + + +
                  +
                  + + +                   +                   +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

                  +                   + + + + + + +

                  +                   + + +

                  +                   + + +

                  +                   + + + + + + + + + + + + + + + : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="slidesinfo/title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + overlaySetup('lc') + + + + + navigate(event) + + + +
                  + + + + + + + +
                  + +
                  + +
                  + + + + + + + +
                  +
                  + + +                   +                   +                   + + +

                  + + + +

                  + +

                  + + + TableofContents + + +

                  +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + . + + + + + + +
                  + +
                  +
                  + +
                  +
                  +                   +                   + + +
                  + + . + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + overlaySetup('lc') + + + + + navigate(event) + + + +
                  + + + + + + + +
                  + + + + + + +
                  + +
                  + + + + + + + +
                  +
                  + + + + +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

                  + +

                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - + + + + + + + + overlaySetup('lc') + + + + + navigate(event) + + + +
                  + + + + + + + + + +
                  + + + + + + +
                  + +
                  + + + + + + + +
                  +
                  + + + + +                   +                   + + +                   + + +

                  +                   + + + + + + + + + + + +
                  + +
                  +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + position: absolute; visibility: visible; + + + + padding-top: 2in; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + foil + + + + + + foilgroup + + + + + + + + + + + + </span> + + + <span + + class="green" + class="blue" + class="orange" + class="red" + class="brown" + class="violet" + class="black" + class="bold" + + > + + + + + + + + +
                  + +
                  +
                  +                   + + + + + + + + + copyright + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

                  + +

                  +                   + + +
                  + + +
                  +                   + + + + + + + + + + + + + + + + 1 + 1 + 1 + 0 + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + foil + + + + + + + + + + + foilgroup + + + + + + chunk-filename-error- + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + +   + + + + +                   diff --git a/src/documentation/docbook-xsl/slides/xhtml/tables.xsl b/src/documentation/docbook-xsl/slides/xhtml/tables.xsl new file mode 100644 index 0000000000..7ae3e73332 --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/tables.xsl @@ -0,0 +1,334 @@ + + + + + + + + + + +#6A719C +220 + + + + + + + + + + + + +
                  + + + + + +
                  + +
                  +                   		  + + + + + +
                  + +
                  + + +
                  + +
                  +                   +
                  +                   + + + + + + + + +
                  + + + + + +
                  + +
                  +                   		  + + + + + +
                  + +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   +                   + + + + + + + + + + + + + + + + +
                  +                   +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/slides/xhtml/vslides.xsl b/src/documentation/docbook-xsl/slides/xhtml/vslides.xsl new file mode 100644 index 0000000000..96114658db --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/vslides.xsl @@ -0,0 +1,652 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="slidesinfo/title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + navigate(event) + + + + + + + + + + + + + + + + + + +
                   
                  + + + + + + + + + + + + + + + + + + +
                  + +
                  + +
                  + +
                  +
                   
                  + + +                   +                   + + +                   + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + navigate(event) + + + + + + + + + + + + + + + + + + +
                   
                  + + + + + + + + + + + + + + + + + + +
                  + +
                  +
                   
                  + + +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + navigate(event) + + + + + + + + + + + + + + + + + + +
                   
                  + + + + + + + + + + + + + + + + + + + +
                  + +
                  +
                   
                  + + +                   +                   + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + navigate(event) + + + + + + + + + + + + + + + + + + +
                   
                  + + + + + + + + + + + + + + + + + + + +
                  + +
                  +
                   
                  + + +                   +                   +                   + + + + +
                  + +
                  +                   + + +
                  + + + + + +
                  + + + +
                  +
                  +                   + + +
                  + +
                  +                   + + +
                  + + + + +
                  + Slide + + of + +
                  +
                  +                   + + + + + + + + + + + + +
                  + + + + + + + First + + + + + + + + + + First + + + + + + + + +
                  + + + + + + + Previous + + + + + + + + + + Previous + + + + + + + + +
                  + + + + + + + Last + + + + + + + + + + Last + + + + + + + + +
                  + + + + + + + Next + + + + + + + + + + Next + + + + + + + + + +
                  +
                  + + + + + ToC + + + + + + + + + + ToC + + + + + + + + +
                  +                   + +                   diff --git a/src/documentation/docbook-xsl/slides/xhtml/w3c.xsl b/src/documentation/docbook-xsl/slides/xhtml/w3c.xsl new file mode 100644 index 0000000000..a2eb90ac7e --- /dev/null +++ b/src/documentation/docbook-xsl/slides/xhtml/w3c.xsl @@ -0,0 +1,358 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + {$logo.title} + + + + + + + + + + position: absolute; visibility: visible; + + + + + + + + + + + + + +
                  + + + + + +
                  + + +
                  + + + + + + + Previous + + + + + + + + Previous + + + + + + + + + + + Contents + + + + + + + + Contents + + + + + + + + + + + + + Next + + + + + + +
                  +
                  + + +
                  +
                  +                   + + + + + + + + +
                  +
                  + + + + + + + +
                  + + + + + + + + + + + + + + , + + + + + of + + + +
                  + + + + + + + Previous + + + + + + + + Prev + + + + + + + + + + + + + Next + + + + + + +
                  +
                  +
                  +                   + + + + + + + + + + +
                  + + + + + +
                  + + +
                  + + + + + + + Previous + + + + + + + + Previous + + + + + + + + + + + Contents + + + + + + + + Contents + + + + + + + + + + + + + Next + + + + + + +
                  +
                  + +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  +                   +                   + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/template/README b/src/documentation/docbook-xsl/template/README new file mode 100644 index 0000000000..a84d084bf4 --- /dev/null +++ b/src/documentation/docbook-xsl/template/README @@ -0,0 +1,15 @@ +This directory contains rudimentary support for the notion of +stylesheet templates. + +The idea is that if you want to change the behavior of the +stylesheets, for example, processing different bibliography +elements, you will construct a tempate document that describes +what you want and then process that template with the "template" +stylesheet. + +The result of this processing will be a customization layer for +the DocBook XSL Stylesheets that does what you want. This +removes the stylesheet customizer from the burdon of figuring +out how the stylesheets work and modifying them. + +In theory, anyway... \ No newline at end of file diff --git a/src/documentation/docbook-xsl/template/biblioentry.xsl b/src/documentation/docbook-xsl/template/biblioentry.xsl new file mode 100644 index 0000000000..44a26dd316 --- /dev/null +++ b/src/documentation/docbook-xsl/template/biblioentry.xsl @@ -0,0 +1,72 @@ + + + + + + + biblioentry + + + id + + object.id + + + + + {$id} + {name(.)} + + + {$id} + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + bibliography.mode + + + + + + + + + + bibliography.mode + + + diff --git a/src/documentation/docbook-xsl/template/testtemplate.xml b/src/documentation/docbook-xsl/template/testtemplate.xml new file mode 100644 index 0000000000..37a4131f82 --- /dev/null +++ b/src/documentation/docbook-xsl/template/testtemplate.xml @@ -0,0 +1,38 @@ + + + + + + + <subtitle/> + <corpauthor/> + <authorgroup/> + <author/> + <othercredit/> + <releaseinfo/> + <copyright/> + <legalnotice/> + <pubdate/> + <revision/> + <revhistory/> + <abstract/> + </t:titlepage-content> + + <t:titlepage-content side="verso"> + </t:titlepage-content> + + <t:titlepage-separator> + <hr/> + </t:titlepage-separator> + + <t:titlepage-before side="recto"> + </t:titlepage-before> + + <t:titlepage-before side="verso"> + </t:titlepage-before> +</t:titlepage> + +</t:templates> diff --git a/src/documentation/docbook-xsl/template/titlepage.xsl b/src/documentation/docbook-xsl/template/titlepage.xsl new file mode 100644 index 0000000000..388f2dde3b --- /dev/null +++ b/src/documentation/docbook-xsl/template/titlepage.xsl @@ -0,0 +1,1280 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:t="http://nwalsh.com/docbook/xsl/template/1.0" + xmlns:param="http://nwalsh.com/docbook/xsl/template/1.0/param" + xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" + xmlns:fo="http://www.w3.org/1999/XSL/Format" + xmlns:exsl="http://exslt.org/common" + exclude-result-prefixes="doc t param exsl" + version='1.0'> + +<!-- ******************************************************************** + $Id: titlepage.xsl,v 1.10 2006/05/07 07:09:39 bobstayton Exp $ + ******************************************************************** + + This file is part of the XSL DocBook Stylesheet distribution. + See ../README or http://nwalsh.com/docbook/xsl/ for copyright + and other information. + + ******************************************************************** --> + +<!-- ==================================================================== --> + +<doc:reference xmlns=""> +<referenceinfo> +<releaseinfo role="meta"> +$Id: titlepage.xsl,v 1.10 2006/05/07 07:09:39 bobstayton Exp $ +</releaseinfo> +<author><surname>Walsh</surname> +<firstname>Norman</firstname></author> +<copyright><year>1999</year><year>2000</year> +<holder>Norman Walsh</holder> +</copyright> +</referenceinfo> +<title>Template Stylesheet Reference + + +
                  Introduction + +This is technical reference documentation for the DocBook XSL +Stylesheets; it documents (some of) the parameters, templates, and +other elements of the stylesheets. + +This is not intended to be user documentation. +It is provided for developers writing customization layers for the +stylesheets, and for anyone who's interested in how it +works. + +Although I am trying to be thorough, this documentation is known +to be incomplete. Don't forget to read the source, too :-) +
                  +                   + + + + + + + + + + + +Construct a stylesheet for the templates provided + + +The t:templates element is the root of a +set of templates. This template creates an appropriate +xsl:stylesheet for the templates. + +If the t:templates element has a +base-stylesheet attribute, an +xsl:import statement is constructed for it. + + + + + + + 1.0 + exsl + + + + This stylesheet was created by + template/titlepage.xsl; + do not edit it by hand. + + + + + + + + + + + + + + + + + + + + +Copy xsl: elements straight through + + +This template simply copies the xsl: elements +straight through into the result tree. + + + + + + + + + + +Create the templates necessary to construct a title page + + +The t:titlepage element creates a set of +templates for processing the titlepage for an element. The +root of this template set is the template named +wrapper.titlepage. That is the +template that should be called to generate the title page. + + +The t:titlepage element has three attributes: + + +element +The name of the source document element for which +these templates apply. In other words, to make a title page for the +article element, set the +element attribute to +article. This attribute is required. + + +wrapper +The entire title page can be wrapped with an element. +This attribute identifies that element. + + +class +If the class attribute +is set, a class attribute with this +value will be added to the wrapper element that surrounds the entire +title page. + + + + + +Any other attributes are copied through literally to the +wrapper element. + +The content of a t:titlepage is one or +more t:titlepage-content, +t:titlepage-separator, and +t:titlepage-before elements. + +Each of these elements may be provided for the recto +and verso sides of the title page. + + + + + + + + + + + + + + .titlepage + + + + + + + recto.content + + + + + .titlepage.before.recto + + + + + + + .titlepage.recto + + + + + + + recto.elements.count + + + + + function-available('exsl:node-set') + + count(exsl:node-set($recto.content)/*) + + + + + contains(system-property('xsl:vendor'), 'Apache Software Foundation') + + Xalan quirk + + count(exsl:node-set($recto.content)/*) + + + + + 1 + + + + + + + + (normalize-space($recto.content) != '') or ($recto.elements.count > 0) + + + + + $recto.content + + + + + + + verso.content + + + + + .titlepage.before.verso + + + + + + + .titlepage.verso + + + + + + + verso.elements.count + + + + + function-available('exsl:node-set') + + count(exsl:node-set($verso.content)/*) + + + + + contains(system-property('xsl:vendor'), 'Apache Software Foundation') + + Xalan quirk + + count(exsl:node-set($verso.content)/*) + + + + + 1 + + + + + + + + (normalize-space($verso.content) != '') or ($verso.elements.count > 0) + + + + + $verso.content + + + + + + + + + .titlepage.separator + + + + + + + + + + + + + + * + + + .titlepage.recto.mode + + + if an element isn't found in this mode, + + try the generic titlepage.mode + + + . + titlepage.mode + + + + + + + + * + + + .titlepage.verso.mode + + + if an element isn't found in this mode, + + try the generic titlepage.mode + + + . + titlepage.mode + + + + + + + + + + + + + + + + + + + .titlepage. + + .auto.mode + + + + + + .titlepage. + + .style + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + . + + + .titlepage. + + .mode + + + + + + + + + + + + + + +Copy t:titlepage attributes + + +This template copies all of the other attributes +from a t:titlepage element onto the specified +wrapper. + + + + + + + + + + + + + + +Create templates for the content of one side of a title page + + +The title page content, that is, the elements from the source +document that are rendered on the title page, can be controlled independently +for the recto and verso sides of the title page. + +The t:titlepage-content element has two attributes: + + +side +Identifies the side of the page to which this title +page content applies. The +side attribute is required and +must be set to either +recto or +verso. In addition, you must specify +exactly one t:titlepage-content for each side +within each t:titlepage. + + +order +Indicates how the order of the elements presented on +the title page is determined. If the +order is +document, the elements are presented +in document order. Otherwise (if the +order is +stylesheet), the elements are presented +in the order that they appear in the template (and consequently in +the stylesheet). + + + + + +The content of a t:titlepage-content element is +a list of element names. These names should be unqualified. They identify +the elements in the source document that should appear on the title page. + + +Each element may have a single attribute: +predicate. The value of this +attribute is used as a predicate for the expression that matches +the element on which it occurs. + +In other words, to put only the first three authors on the +recto-side of a title +page, you could specify: + + + + + + +]]> + + +Usually, the elements so named are empty. But it is possible to +make one level of selection within them. Suppose that you want to +process authorgroup elements on the title page, but +you want to select only proper authors, editors, or corporate authors, +not collaborators or other credited authors. + +In that case, you can put a t:or group inside +the authorgroup element: + + + + + + + + + + + + +]]> + + +This will have the effect of automatically generating a template +for processing authorgroups in the title page mode, +selecting only the specified children. If you need more complex processing, +you'll have to construct the templates by hand. + + + + + + + + + + + + + Illegal value specified for @t:side + on t:titlepage-content: + + + + + + The @t:side attribute is required on + t:titlepage-content. + + + + + + + + .titlepage. + + .auto.mode + + + + + + + .titlepage. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Create templates for the separator + + +The title page is separated from the content which follows it by +the markup specified in the t:titlepage-separator +element. + + + + + + + + + .titlepage.separator + + + + + + + + + + +Create templates for what precedes a title page + + +Each side of the title page is preceded by the markup specified +in the t:titlepage-before element for that +side. + + + + + + + + + .titlepage.before. + + + + + + + + + + + +Copy elements + + +This template simply copies the elements that it applies to +straight through into the result tree. + + + + + + + + + + + + + +Copy attributes + + +This template simply copies the attributes that it applies to +straight through into the result tree. + + + + + + + + + + + + +Create rules to process titlepage elements in document order + + +This template is called to process all of the children of the +t:titlepage-content element. It creates the hairy +select expression necessary to process each of those elements in +the title page. + +Note that this template automatically handles the case where +some DocBook elements, like title and subtitle, can occur both inside +the *info elements where metadata is usually stored and outside. + + +It also automatically calculates the name for the *info container +and handles elements that have historically had containers with different +names. + + + + + + + + info + + + + + + artheader + + + blockinfo + + + + + + + + + + docinfo + + + + + + + + + + recto + + + + + + + .titlepage. + + .auto.mode + + + + | + + + + / + + + + + + + | + + / + + + + + + + + |info + / + + + + + + + | + + + + + + + + + + +Create rules to process titlepage elements in stylesheet order + + +This template is called to process all of the children of the +t:titlepage-content element. It creates the set +of xsl:apply-templates elements necessary +process each of those elements in the title page. + +Note that this template automatically handles the case where +some DocBook elements, like title and subtitle, can occur both inside +the *info elements where metadata is usually stored and outside. + + +It also automatically calculates the name for the *info container +and handles elements that have historically had containers with different +names. + + + + + + + + info + + + + + + artheader + + + blockinfo + + + + + + + + + + docinfo + + + + + + + + + recto + + + + + + .titlepage. + + .auto.mode + + + + + + + + + + + + .titlepage. + + .style + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Force can only be used with named-templates. + + + + + + + + + + + + + + + / + + + + + + + + + + / + + + + + + + + + + + + + + + / + + + + + + + + + + / + + + + + + + + + + + + + + + + / + + + + + + + + + + / + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + + + / + + + + + + + + + + + + + + + +Create templates for special rules + + +This template is called to process all of the descendants of the +t:titlepage-content element that require special +processing. At present, that's just t:or elements. + + + + + + + + + + + recto + + + + + + .titlepage. + + .auto.mode + + + + + + + + + + + + + + + + + + + + + + + + + + + +Create template for individual special rules + + +This template is called to process the children of special +template elements. + + + + + + + + + + + recto + + + + + + .titlepage. + + .auto.mode + + + + + + + + + + + + + + + +Process the t:or special rule + + +This template processes t:or. + + + + + + + + + + recto + + + + + + .titlepage. + + .auto.mode + + + + + + + + + + + + + + + + +Process the t:or special rule in +titlepage.subrules mode + + +The titlepage.subrules mode doesn't apply to t:or, so just +reprocess this node in the normal mode. + + + + + + + + + + +Construct the "or-list" used in the select attribute for +special rules. + + +Walk through each of the children of t:or, producing the +text of the select attribute. + + + + + + + + + + + + + + + + + + + + + | + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/test.sh b/src/documentation/docbook-xsl/test.sh new file mode 100644 index 0000000000..77b8a8ee8e --- /dev/null +++ b/src/documentation/docbook-xsl/test.sh @@ -0,0 +1,3 @@ +#!/bin/bash +mydir=$(readlink -f $(dirname $0)) +$mydir/install.sh --test diff --git a/src/documentation/docbook-xsl/tools/make/Makefile.DocBook b/src/documentation/docbook-xsl/tools/make/Makefile.DocBook new file mode 100644 index 0000000000..953623ad76 --- /dev/null +++ b/src/documentation/docbook-xsl/tools/make/Makefile.DocBook @@ -0,0 +1,619 @@ +# $Source: /cvsroot/docbook/xsl/tools/make/Makefile.DocBook,v $ +# $Author: xmldoc $ +# $Date: 2006/04/25 06:31:24 $ +# $Revision: 1.4 $ +# vim: number +# +# ----------------------------------------------------------------- +# ** Makefile.DocBook -- generate output from DocBook sources ** +# ----------------------------------------------------------------- +# +# This file is part of the DocBook Project XSL Stylesheet +# distribution. +# +# See http://docbook.sourceforge.net/release/xsl/current/ +# for copyright and other information. + +# DOCBOOK_OUTPUT_FORMATS is the default set of targets (output +# formats) that get built when you type "make" without any targets +# explicitly specified. To generate a different set of output +# formats, change the value of DOCBOOK_OUTPUT_FORMATS here or set +# it in your environment; for example: +# +# set DOCBOOK_OUTPUT_FORMATS="html pdf"; export DOCBOOK_OUTPUT_FORMATS +# +# Of course by explicitly specifying particular targets when you +# invoke "make", you can always override generation of the default +# set of targets; for example: +# +# make html txt +# +# That would generate just HTML (unchunked) and plain-text output. +# +DOCBOOK_OUTPUT_FORMATS ?= man chunk txt pdf + +# ----------------------------------------------------------------- +# *** TOOLS and other DEPENDENCIES *** +# ----------------------------------------------------------------- +# we use rmdir(1) to remove dirs we create for chunked HTML output +RMDIR = rmdir +# "-p" causes empty parent dirs to be deleted as well +RMDIR_FLAGS = --ignore-fail-on-non-empty -p + +# possible values for PDF_MAKER are: +# dblatex|fop|xep|xmlroff|passivetex +PDF_MAKER = fop + +# possible values for TXT_MAKER are: +# links|lynx|w3m|w3mmee +TXT_MAKER = links +TXT_MAKER_FLAGS = -dump + +# xsl +XSLT = xsltproc +XSLT_FLAGS = --xinclude + +# http://dblatex.sourceforge.net/ +DBLATEX = dblatex +DBLATEX_FLAGS = -b pdftex + +FOP = fop +FOP_FLAGS = + +XEP = xep +XEP_FLAGS = + +# http://xmlroff.sourceforge.net/ +XMLROFF = xmlroff +XMLROFF_FLAGS = + +PDFTEX = pdftex +PDFTEX_FLAGS = + +# used by PassiveTeX +PDFXMLTEX = pdfxmltex + +# http://docbook2x.sourceforge.net/ +DB2X_XSLTPROC = db2x_xsltproc +DB2X_XSLTPROC_FLAGS = +DB2X_TEXIXML = db2x_texixml +DB2X_TEXIXML_FLAGS = + +# we call the man(1) command to generate "foo.N.pdf" and +# "foo.N.txt" output (see "man-pdf" & "man-txt" targets) +MAN = man +MAN_FLAGS = + +# The "ps2pdf" command is part of GhostSript (gs) distro. +# It is just a wrapper script around gs that does this: +# +# gs -dCompatibilityLevel=1.2 -q -dNOPAUSE -dBATCH -sDEVICE=pdfwrite \ +# "-sOutputFile=$outfile" -dCompatibilityLevel=1.2 -c .setpdfwrite -f "$infile" +# +# Where, for example: $outfile = foo.pdf and $infile = foo.1 +PS2PDF = ps2pdf +PS2PDF_FLAGS = + +# The "col" command is needed for stripping backspaces and +# underscores from man(1) output to get pure plain-text +COL = col +COL_FLAGS = + +# The "expand" command is needed for expanding tabs from files +# generated from "man foo.1 | col -b" output +# output to get pure plain-text +EXPAND = expand +EXPAND_FLAGS = + +# value of DOCBOOK_XSL should either be the canonical +# (docbook.sourceforge.net) URL for the DocBook Project XSL +# stylesheets OR it can be a local system path +DOCBOOK_XSL = http://docbook.sourceforge.net/release/xsl/current + +# ----------------------------------------------------------------- +# names of some DIRECTORIES and FILES we need +# ----------------------------------------------------------------- +# We create a tmp directory once per make invocation; it's needed +# for holding a temporary copy of the custom DBLaTeX stylesheet +# (because dblatex currently can't read a stylesheet from stdin) +TMP ?= /tmp +TMPNUM := $(shell echo $$$$) +DOCBOOK_TMP := $(TMP)/docbook-make-$(TMPNUM) + +# MAN_MANIFEST_EXT is file extension added to individual manifest +# files +MAN_MANIFEST_EXT = manifest_man + +# HTML_MANIFEST_EXT is file extension added to HTML manifest files +HTML_MANIFEST_EXT = manifest_html + +# BASEDIR_SUFFIX is a what you need to set if you want a suffix +# added to the end of each "base.dir" we create while generating +# chunked HTML output +#BASEDIR_SUFFIX = -html +#BASEDIR_SUFFIX = _html +BASEDIR_SUFFIX = + +# ----------------------------------------------------------------- +# assorted OPTIONS +# ----------------------------------------------------------------- +# HTML_STYLESHEET -> $html.stylesheet stylesheet param +# http://docbook.sourceforge.net/snapshots/xsl/doc/html/html.stylesheet.html +HTML_STYLESHEET = style.css +# HTML_IMAGES -> $admon.graphics.path +# http://docbook.sourceforge.net/snapshots/xsl/doc/html/admon.graphics.path.html +HTML_IMAGES = images/ +# HTML_IMAGES_EXT -> $admon.graphics.extension +# http://docbook.sourceforge.net/snapshots/xsl/doc/html/admon.graphics.extension.html +HTML_IMAGES_EXT = .png + +# use these to set params on the command-line +# format is, e.g., HTML_PARAMS="--stringparam variablelist.as.table 1..." +FO_PARAMS = +HTML_PARAMS = +MAN_PARAMS = + +# DBX_PARAMS is for dblatex(1); format uses "-p": +# DBX_PARAMS="-p doc.publisher.show 1 -p term.breakline 1... +DBX_PARAMS= + +# What file extension do you use for DocBook source files? +DOCBOOK_FILE_EXTENSION = .xml + +# ----------------------------------------------------------------- +# make(1) functions for building file lists +# ----------------------------------------------------------------- +# +# the values of the following are used for determing what needs +# to be built and/or cleaned up + +SOURCE_FILES_DBK = $(wildcard *$(DOCBOOK_FILE_EXTENSION)) + +FILES_FO = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).fo) +FILES_TXT = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).txt) +FILES_PDF = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).pdf) +FILES_LOG = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).log) +FILES_OUT = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).out) +FILES_AUX = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).aux) +FILES_HTML = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).html) +FILES_INFO = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).info) +DIRS_CHUNK = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base)$(BASEDIR_SUFFIX)) +LISTS_HTML = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).$(HTML_MANIFEST_EXT)) +LISTS_MAN = $(foreach base,$(basename $(SOURCE_FILES_DBK)),$(base).$(MAN_MANIFEST_EXT)) +FILES_CHNK = $(shell for manifest in $(LISTS_HTML); do if [ -f "$$manifest" ]; then cat $$manifest; fi done) +FILES_MAN = $(shell for manifest in $(LISTS_MAN); do if [ -f "$$manifest" ]; then cat $$manifest; fi done) +FILES_MANP = $(foreach base,$(FILES_MAN),$(base).pdf) +FILES_MANT = $(foreach base,$(FILES_MAN),$(base).txt) +DIRS_MAN = $(shell for file in $(FILES_MAN); do dirname $$file; done | uniq) + +# ----------------------------------------------------------------- +# ** stylesheet for testing whether a file has a refentry +# ----------------------------------------------------------------- +REFENTRY_CHECK := \ + \ + \ + \ + true \ + \ + \ + + +# ----------------------------------------------------------------- +# ** Stylesheet Customization Layers ** +# ----------------------------------------------------------------- +# +# for DBLaTeX +DBX_CUSTOM := \ + 0 \ + 1 \ + 0 \ + 1 \ + 1 \ + left \ + 1 \ + \ + docbook \ + all \ + "" \ + WIDELABEL \ + 0 \ + [htbp] \ + 0 \ + 1 \ + \ + twoside \ + , \ + 1 \ + Synopsis \ + \ + ansi \ + 1 \ + 0 \ + java \ + 0 \ + + +# for FO output +FO_CUSTOM := \ + \ + 1 \ + A4 \ + \ + false \ + left \ + 1 \ + 0 \ + 1 \ + 1 \ + 1 \ + 1 \ + 1 \ + 1 \ + \ + blue \ + \ + \ + \#E0E0E0 \ + 4pt \ + 4pt \ + 4pt \ + 4pt \ + \ + \ + \ + \ + pt \ + \ + \ + \ + \ + \ + pt \ + \ + \ + \ + \ + \ + pt \ + \ + \ + \ + \ + \ + pt \ + \ + \ + \ + \ + \ + pt \ + \ + \ + \ + \ + \ + pt \ + \ + \ + + +# for single-file HTML outpout +HTML_CUSTOM := \ + \ + local.l10n.xml \ + \ + 1 \ + 0 \ + \ + 0 \ + $(HTML_STYLESHEET) \ + 0 \ + 1 \ + + +# for chunked HTML output +CHNK_CUSTOM := \ + \ + 0 \ + 1 \ + 0 \ + $(HTML_STYLESHEET) \ + 1 \ + $(HTML_IMAGES) \ + $(HTML_IMAGES_EXT) \ + \ + 1 \ + 1 \ + yes \ + 1 \ + + +# for man-page output +MAN_CUSTOM := \ + \ + \ + \ + man/ \ + \ + + +# ----------------------------------------------------------------- +# ** TARGETS START HERE ** +# ----------------------------------------------------------------- +# prevents make from deleting, e.g. foo.1, after making foo.1.pdf +# and foo.1.txt from it. +.PRECIOUS: %.1 %.2 %.3 %.4 %.5 %.6 %.7 %.8 %.9 + +docbook: $(DOCBOOK_OUTPUT_FORMATS) + +man: $(LISTS_MAN) + +# we can generate PDFs from man pages +man-pdf: man + $(MAKE) $(FILES_MANP) + +# we can generate plain text from man pages +man-txt: man + $(MAKE) $(FILES_MANT) + +html: $(FILES_HTML) + +chunk: $(LISTS_HTML) + +txt: $(FILES_TXT) + +pdf: $(FILES_PDF) + +info: $(FILES_INFO) + +# use the "debug" target to echo variables, etc., to +# test/troubleshoot changes you make to this makefile +debug: + @echo $(DIRS_MAN) + +# ----------------------------------------------------------------- +# pattern rule for making HTML and plain-text output +# ----------------------------------------------------------------- +%.html: %.xml + @echo '$(HTML_CUSTOM)' | $(XSLT) $(XSLT_FLAGS) $(HTML_PARAMS) - $< > $@ + +%.txt: %.html + $(TXT_MAKER) $(TXT_MAKER_FLAGS) ./$< \ + | sed "s/^\(\s\+[0-9]\+\. \)file:\/\/.\+$$/\\1(local)/g" \ + | egrep -v '^ file:///.+$$' \ + > $@ +# if DOCBOOK_OUTPUT_FORMATS does not contain "html", then we need +# to remove the "intermediate" HTML files we used for generating +# plain-text output +ifeq ($(findstring html,$(DOCBOOK_OUTPUT_FORMATS)),) + $(RM) $< +endif + +# ----------------------------------------------------------------- +# pattern rule for making chunked HTML pages +# ----------------------------------------------------------------- +%.$(HTML_MANIFEST_EXT): %.xml + @echo '$(CHNK_CUSTOM)' | $(XSLT) $(XSLT_FLAGS) $(HTML_PARAMS) \ + --stringparam manifest $@ \ + --stringparam base.dir $(basename $@)$(BASEDIR_SUFFIX)/ \ + - $< + +# ----------------------------------------------------------------- +# pattern rules for making FO and PDF stuff +# ----------------------------------------------------------------- +%.fo: %.xml + @echo '$(FO_CUSTOM)' \ + | $(XSLT) $(XSLT_FLAGS) $(FO_PARAMS) - $< > $@ + +ifeq ($(PDF_MAKER),dblatex) +%.pdf: %.xml + mkdir -p $(DOCBOOK_TMP) + echo '$(DBX_CUSTOM)' > $(DOCBOOK_TMP)/dblatex.xsl + -$(DBLATEX) $(DBLATEX_FLAGS)\ + -p $(DOCBOOK_TMP)/dblatex.xsl \ + -o $@ \ + $< + $(RM) -r $(DOCBOOK_TMP) +endif + +%.pdf: %.fo +ifeq ($(PDF_MAKER),) + $(error No PDF_MAKER specified. Cannot make pdf) +else +ifeq ($(PDF_MAKER),xep) + $(XEP) $(XEP_FLAGS) $< $@ +else +ifeq ($(PDF_MAKER),fop) + $(FOP) $(FOP_FLAGS) $< $@ +else +ifeq ($(PDF_MAKER),xmlroff) + $(XMLROFF) $(XMLROFF_FLAGS) $< -o $@ +else +ifeq ($(PDF_MAKER),passivetex) + $(PDFTEX) $(PDFTEX_FLAGS) &$(PDFXMLTEX) $< + @if [ `egrep Rerun $(basename $@).log | wc -l` -gt 0 ]; then \ + $(PDFTEX) $(PDFTEX_FLAGS) &$(PDFXMLTEX) $< ; \ + fi + @if [ `egrep Rerun $(basename $@).log | wc -l` -gt 0 ]; then \ + $(PDFTEX) $(PDFTEX_FLAGS) &$(PDFXMLTEX) $< ; \ + fi + $(RM) $(basename $@).log + $(RM) $(basename $@).aux + $(RM) $(basename $@).out +else + $(error I do not know how to make a PDF using "$(PDF_MAKER)") +endif +endif +endif +endif +endif + +# ----------------------------------------------------------------- +# pattern rules for making TeXinfo stuff +# ----------------------------------------------------------------- +%.txml: %.xml + $(DB2X_XSLTPROC) $(DB2X_XSLTPROC_FLAGS) -s texi -o $@ $< + +%.texi: %.txml + $(DB2X_TEXIXML) $(DB2X_TEXIXML_FLAGS) $< + +# the following is actually a built-in rule, but it's redefined +# here just for the sake of clarity +%.info: %.texi + $(MAKEINFO) $(MAKEINFO_FLAGS) $< -o $@ + +# ----------------------------------------------------------------- +# pattern rule for making man pages +# ----------------------------------------------------------------- +%.$(MAN_MANIFEST_EXT): %.xml + @if [ "$(strip $(shell echo '$(REFENTRY_CHECK)' | $(XSLT) $(XSLT_FLAGS) - $<))" != "true" ]; then \ + touch $@; \ + else \ + echo '$(MAN_CUSTOM)' \ + | $(XSLT) $(XSLT_FLAGS) $(MAN_PARAMS) \ + --stringparam man.output.manifest.filename $@ \ + - $<; \ + fi + +# ----------------------------------------------------------------- +# pattern rule for enabling direct "make foo.1" to work +# ----------------------------------------------------------------- + +%.1 %.2 %.3 %.4 %.5 %.6 %.7: %.xml + $(MAKE) $(basename $<).$(MAN_MANIFEST_EXT) + +# ----------------------------------------------------------------- +# pattern rules for making Postscript/PDF output from man pages +# ----------------------------------------------------------------- +%.1.ps: %.1 + $(MAN) -l $(MAN_FLAGS) -Tps $< > $@ + +%.2.ps: %.2 + $(MAN) -l $(MAN_FLAGS) -Tps $< > $@ + +%.3.ps: %.3 + $(MAN) -l $(MAN_FLAGS) -Tps $< > $@ + +%.4.ps: %.4 + $(MAN) -l $(MAN_FLAGS) -Tps $< > $@ + +%.5.ps: %.5 + $(MAN) -l $(MAN_FLAGS) -Tps $< > $@ + +%.6.ps: %.6 + $(MAN) -l $(MAN_FLAGS) -Tps $< > $@ + +%.7.ps: %.7 + $(MAN) -l $(MAN_FLAGS) -Tps $< > $@ + +%.8.ps: %.8 + $(MAN) -l $(MAN_FLAGS) -Tps $< > $@ + +%.9.ps: %.9 + $(MAN) -l $(MAN_FLAGS) -Tps $< > $@ + +# ----------------------------------------------------------------- +# pattern rule for converting Postscript to PDF +# ----------------------------------------------------------------- +%.pdf: %.ps + $(PS2PDF) $(PS2PDF_FLAGS) $< + +# ----------------------------------------------------------------- +# pattern rules for making plain-text output from man pages +# ----------------------------------------------------------------- +%.1.txt: %.1 + $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@ + +%.2.txt: %.2 + $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@ + +%.3.txt: %.3 + $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@ + +%.4.txt: %.4 + $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@ + +%.5.txt: %.5 + $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@ + +%.6.txt: %.6 + $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@ + +%.7.txt: %.7 + $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@ + +%.8.txt: %.8 + $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@ + +%.9.txt: %.9 + $(MAN) -l $(MAN_FLAGS) -Tascii $< | $(COL) -b $(COL_FLAGS) | $(EXPAND) $(EXPAND_FLAGS) > $@ + +# ----------------------------------------------------------------- +# target(s) for cleaning up the mess +# ----------------------------------------------------------------- +clean: +ifneq ($(FILES_TXT),) + $(RM) $(FILES_TXT) +endif +ifneq ($(FILES_PDF),) + $(RM) $(FILES_PDF) +endif +ifneq ($(FILES_FO),) + $(RM) $(FILES_FO) +endif +ifneq ($(FILES_LOG),) + $(RM) $(FILES_LOG) +endif +ifneq ($(FILES_OUT),) + $(RM) $(FILES_OUT) +endif +ifneq ($(FILES_AUX),) + $(RM) $(FILES_AUX) +endif +ifneq ($(FILES_HTML),) + $(RM) $(FILES_HTML) +endif +ifneq ($(FILES_CHNK),) + $(RM) $(FILES_CHNK) +endif +ifneq ($(FILES_MAN),) + $(RM) $(FILES_MAN) +endif +ifneq ($(FILES_MANT),) + $(RM) $(FILES_MANT) +endif +ifneq ($(FILES_MANP),) + $(RM) $(FILES_MANP) +endif +ifneq ($(FILES_INFO),) + $(RM) $(FILES_INFO) +endif +ifneq ($(DIRS_CHUNK),) + for dir in $(DIRS_CHUNK); do \ + if [ -d "$$dir" ]; then \ + $(RMDIR) $(RMDIR_FLAGS) $$dir; \ + fi \ + done +endif +ifneq ($(DIRS_MAN),) + for dir in $(DIRS_MAN); do \ + if [ -d "$$dir" ]; then \ + $(RMDIR) $(RMDIR_FLAGS) $$dir; \ + fi \ + done +endif +ifneq ($(LISTS_MAN),) + $(RM) $(LISTS_MAN) +endif +ifneq ($(LISTS_HTML),) + $(RM) $(LISTS_HTML) +endif diff --git a/src/documentation/docbook-xsl/tools/make/Makefile.combine b/src/documentation/docbook-xsl/tools/make/Makefile.combine new file mode 100644 index 0000000000..67cc60ea1b --- /dev/null +++ b/src/documentation/docbook-xsl/tools/make/Makefile.combine @@ -0,0 +1,182 @@ +# $Source: /cvsroot/docbook/xsl/tools/make/Makefile.combine,v $ +# $Author: xmldoc $ +# $Date: 2006/04/19 06:25:42 $ +# $Revision: 1.1 $ +# vim: number +# +# ----------------------------------------------------------------- +# ** Makefile.combine -- combine source files ** +# ----------------------------------------------------------------- +# +# This file is part of the DocBook Project XSL Stylesheet +# distribution. +# +# See http://docbook.sourceforge.net/release/xsl/current/ +# for copyright and other information. +# +# This makefile creates "wrapper" files that combine sets of +# individual DocBook source files. The purpose of combining the +# files is to speed up processing time. By default it puts 20 +# files into each wrapper. Use CHUNKSIZE to configure the number +# of files per wrapper. +# +# Currently, this makefile has only a "man" target and is mainly +# intended to speed up processing of large numbers if individual +# refentry instances. + +# What file extension do you use for DocBook source files? +DOCBOOK_FILE_EXTENSION = .xml +SOURCE_FILES_DBK = $(wildcard *$(DOCBOOK_FILE_EXTENSION)) + +MAKEFILE_DOCBOOK = Makefile.DocBook + +XSLTPROC=xsltproc +XSLTPROC_FLAGS= + +SED=sed +SED_FLAGS=-i + +CHUNKSIZE ?= 20 + +WRAPPER_ELEMENT = reference +WRAPPER_TITLE=Combined contents + +COMBINE_XSL = \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + <$(WRAPPER_ELEMENT)> \ + $(WRAPPER_TITLE) \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + \ + + +all: man + +man: build/man + +build/Makefile: + if [ ! -d build ]; then mkdir build; fi + cp $(MAKEFILE_DOCBOOK) $@ + +combine.xsl: Makefile + @echo '$(COMBINE_XSL)' > $@ + $(SED) $(SED_FLAGS) "s/\^\^/'/g" $@ + +build/1.xml: combine.xsl + $(XSLTPROC) $(XSLTPROC_FLAGS) \ + --stringparam files "$(SOURCE_FILES_DBK)" \ + --stringparam chunk.size $(CHUNKSIZE) \ + $< $< + +build/man: build/Makefile build/1.xml + time $(MAKE) -C build man \ + MAN_PARAMS="--stringparam man.output.quietly 1 \ + --stringparam refentry.meta.get.quietly 1 \ + --stringparam man.charmap.enabled 0" + +debug: + +clean: + $(RM) -r build diff --git a/src/documentation/docbook-xsl/uninstall.sh b/src/documentation/docbook-xsl/uninstall.sh new file mode 100644 index 0000000000..11177853ac --- /dev/null +++ b/src/documentation/docbook-xsl/uninstall.sh @@ -0,0 +1,7 @@ +#!/bin/bash +mydir=$(readlink -f $(dirname $0)) +$mydir/install.sh \ + --uninstall \ + --catalogManager=/home/mikes/.resolver/CatalogManager.properties \ + --dotEmacs= \ + $@ diff --git a/src/documentation/docbook-xsl/website/ChangeLog b/src/documentation/docbook-xsl/website/ChangeLog new file mode 100644 index 0000000000..01291679cc --- /dev/null +++ b/src/documentation/docbook-xsl/website/ChangeLog @@ -0,0 +1,379 @@ +2006-02-08 Robert Stayton + + * xbel.xsl: Add empty templates for unsupported xbel elements so errors + are not produced. + +2005-06-28 Michael Smith + + * param.xweb: Added missing entity ref for autlayout-file param. + +2005-06-20 Michael Smith + + * .cvsignore: New file. + +2005-06-17 Michael Smith + + * Makefile, param.xsl, param.xweb: Switch to "real" params build (i.e., same as docbook-xsl params). + + * param.xweb: New file. + +2005-04-15 Norman Walsh + + * website-common.xsl: Explicitly cast summary to a string + + * website-common.xsl: Support @href on tocentry + +2005-04-08 Michael Smith + + * makefile-dep.xsl: added depends-file param, to help make distclean behave as expected + when building non-tabular version of website + +2005-04-06 Michael Smith + + * VERSION, website-common.xsl: VERSION scheme switched to same as that used by "xsl" module; + this enables auto-submitting info to Freshmeat as part of the build + + * makefile-dep.xsl: clean also now removes depends.nontabular & website.database.xml + +2005-03-30 Robert Stayton + + * toc-tabular.xsl: Fixed logic for @tocskip attribute. + +2005-03-29 Robert Stayton + + * autolayout.xsl: Updated public and system identifiers in xsl:output element. + + * toc-tabular.xsl: Fixed bug 1163939: toc-tabular depends on DTD validation. + + * website-common.xsl: Added sample gentext strings for de and fr. + + * website.xsl: Fixed bug 1019573 body tag, accessibility issue. + +2005-03-28 Robert Stayton + + * olink.xsl: Fixed olink-entity to work with new olink setup. + + * olink.xsl: Updated to work with revisions to olink in main DocBook stylesheet + starting with version 1.66. + + * website-common.xsl: Fixed bug 1120883 Irrelevant mode attribute. + + * website-common.xsl: Fixed bug 1120877 regarding duplicate match on website in title.markup mode. + +2005-01-31 Robert Stayton + + * olink.xsl: Applied patch from bug report 1072576 to fix key mismatch since + 1.66.1 update of olinks. + +2005-01-06 Jirka Kosek + + * tabular.xsl: Fixed bug #1046632. Added missing relative path in front of image. + +2004-06-04 Jirka Kosek + + * toc.xsl, website-common.xsl: Use gentext for "Home" text + +2004-06-03 Jirka Kosek + + * tabular.xsl, website.xsl: Process all types of nodes under webpage (including PIs and comments) not only elements. + +2003-11-25 Robert Stayton + + * website-common.xsl: Use normalize-space() on summary since used as an attribute value. + + * website-common.xsl: baseuri attribute in website.database.xml now adds + the $filename-prefix value. + +2003-09-18 Robert Stayton + + * tabular.xsl, website.xsl: Remove unused variable 'filename', which applies + templates in mode 'filename', but there is no such mode. + +2003-09-08 Norman Walsh + + * makefile-dep.xsl: Accept patch #787260 from vyt + +2003-07-18 Robert Stayton + + * tabular.xsl: Added normalize-space() function for summary + used as an attribute value. + +2003-07-11 Norman Walsh + + * rss.xsl: Fixed bogus references to @resource instead of @rdf:resource + + * tabular.xsl: Use table.navigation.cell.properties for the table.spacer.image in the navigation column. Use the spacer image again in the hspacer for that row. Added new param to the hspacer template so that the template can tell if its being called for the vspacer cell. + +2003-06-22 Norman Walsh + + * param.xsl, tabular.xsl: Added table.spacer.image to improve tabular style accessibility. This is a fairly intrusive change, but I think its a significant improvement in accessibility. + +2003-05-27 Robert Stayton + + * olink.xsl: Fix typo in test attribute. + +2003-04-13 Norman Walsh + + * head.xsl: Feat Req #703116: add type to script + +2003-02-26 Jirka Kosek + + * toc-tabular.xsl: Make comparsion safe even if nav.graphics is specified as string type + +2003-02-20 Robert Stayton + + * chunk-common.xsl, olink.xsl, website-common.xsl, website-targets.xsl: + Added XSL-based olink processing. + +2003-02-18 Norman Walsh + + * autolayout.xsl: Updated version numbers to 2.4.1 + +2003-02-16 Norman Walsh + + * rss.xsl: Check for localTime function before calling it + +2003-01-26 Robert Stayton + + * chunk-common.xsl: No longer terminates if exists() function not available. + Will not track dependencies, so all files built each time. + +2003-01-16 Norman Walsh + + * autolayout.xsl: Update the public and system identifers + +2003-01-11 Robert Stayton + + * makefile-dep.xsl: Add optional output-root param so dependency path + matches the output path. + +2002-11-17 Norman Walsh + + * website-common.xsl: Patch #540597: add rcsdate.format named template + +2002-10-02 Norman Walsh + + * autolayout.xsl, head.xsl: Support headlink element + + * chunk-common.xsl: Support references to external pages when using XSLT exists() function to choose build order + +2002-09-16 Norman Walsh + + * makefile-dep.xsl: Use filename-prefix instead of prefix for consistency + + * param.xsl, tabular.xsl, website-common.xsl, website.xsl: + Added allpages.banner + + * tabular.xsl, website.xsl: Remove id attribute from div; conflicts with following a + + * toc-tabular.xsl, toc.xsl: Always calculate toc-rel-path correctly in autolayout (regardless of the current context node) + + * website-common.xsl: Calculate prev/next sequential links correctly even when they cross subdir boundaries + +2002-09-15 Norman Walsh + + * rss.xsl: Support cvs: date in RSS and updated 1.0 sources + + * website-common.xsl: Handle webpage in title.markup mode + +2002-09-12 Norman Walsh + + * makefile-dep.xsl: Patch from Michael Wiedmann + +2002-09-11 Norman Walsh + + * rss.xsl: New file. + + * website-common.xsl: Include rss.xsl + +2002-05-24 Norman Walsh + + * autolayout.xsl: Output correct doctype public and system identifiers + + * xbel.xsl: Website tracker #518864: make sure lists are valid HTML + +2002-05-23 Norman Walsh + + * autolayout.xsl: Copy the revisionflag attribute + + * chunk-common.xsl, tabular.xsl: Remove dup. definition of autolayout-file + + * toc-tabular.xsl: Support revisionflag attribute + +2002-05-12 Norman Walsh + + * head.xsl, website-common.xsl: Output LINK elements in the HEAD for prev/next/up/first/last/etc. (works great in Mozilla 1.0CR1) + +2002-04-26 Norman Walsh + + * head.xsl: Call user.head.content so stylesheets can put things in page headers + +2002-03-20 Norman Walsh + + * param.xsl: Deprecated body.attributes attribute-set (in favor of body.attributes named template) + + * tabular.xsl: Use body.attributes named template; support navtocwidth and navbgcolor as a page parameters + + * toc-tabular.xsl: Support toc.expand.depth a page-configurable parameter + + * website-common.xsl: Allow footlink in config of individual pages + + * website.xsl: Use body.attributes named template instead of attribute-set + +2001-12-05 Norman Walsh + + * chunk-tabular.xsl, chunk-website.xsl: Point to the current rather than the snapshot release + +2001-12-04 Norman Walsh + + * tabular.xsl, website.xsl: Feature #456839: Add class values to body + +2001-11-12 Norman Walsh + + * tabular.xsl: Added new templates to wrap home.navhead.* + + * toc-tabular.xsl: Support toc.expand.depth to force the top N-levels of the ToC to be expanded + +2001-10-13 Norman Walsh + + * website-common.xsl: Fixed URI for xsl:import + +2001-09-26 Norman Walsh + + * makefile-dep.xsl: Handle off-site links in the dependency list + + * website-common.xsl: Attempt to support PHP PI + +2001-09-22 Norman Walsh + + * website-common.xsl, website.xsl: Remove public/system identifiers from xsl:output; it's impossible for a subsequent customization to remove them, so we shouldn't put them in + +2001-09-06 Norman Walsh + + * VERSION, autolayout.xsl, chunk-common.xsl, chunk-tabular.xsl, chunk-website-common.xsl, chunk-website.xsl, chunk.xml, chunklib.pl, chunktab.xml, head.xsl, hrefencode.pl, makefile-dep.xsl, param.xsl, tabular.xsl, toc-tabular.xsl, toc.xsl, website-common.xsl, website.xsl, xbel.xsl, xtchunk-tabular.xsl, xtchunk-website.xsl: + Merge V2-branch back onto the trunk; I'm abandoning V1-branch and V2-branch henceforth + +2001-08-07 Norman Walsh + + * autolayout.xsl, param.xsl, toc-tabular.xsl, toc.xsl, website-common.xsl, website.xsl: + Allow the TOC to contain links to external websites, parameterize the currentpage marker (@) in the text-only rendering + +2001-08-04 Norman Walsh + + * VERSION: Make VERSION a parameter so that it isn't an error that it collides with the DocBook stylesheet's VERSION + + * autolayout.xsl: Turn off indentation (don't want extra spaces around copyright holders), but introduce a few linefeeds in safe places + + * website-common.xsl: Why was this generating xhtml? Remove bogus @role hack for copyright holders + +2001-07-29 Norman Walsh + + * chunk-tabular.xsl, chunk-website.xsl, website-common.xsl: + Expand sf.net to sourceforge.net; too many DNS hickups for sf.net + + * head.xsl: Add base element to head + + * toc-tabular.xsl: Make preceding icons clickable + +2001-07-10 Norman Walsh + + * chunk-common.xsl: Support Xalan implementation of extension functions + +2001-07-09 Norman Walsh + + * website-common.xsl: Bug #435422; allow config in layout to override feedback.href + +2001-07-04 + + * autolayout.xsl: Fix doctype-system and directory calculation + + * head.xsl: Fix meta tag for http-equiv + + * tabular.xsl: Whitespace changes + + * website-common.xsl: Put commans between copyright holders + +2001-06-20 Norman Walsh + + * head.xsl: Support http-equiv on meta + + * toc.xsl: Fixed bug where initial pages with more than max.toc.width entries formatted badly + +2001-06-17 Norman Walsh + + * autolayout.xsl, head.xsl, website-common.xsl: Add support for RDDL + +2001-06-14 Norman Walsh + + * chunk-tabular.xsl, chunk-website.xsl: Change import to point to web + + * toc-tabular.xsl: Pass relpath to link.to.target so that relative paths are built correctly + + * toc.xsl: Added max.toc.width parameter to control how large the header becomes + + * website-common.xsl: Pass relpath to link.to.target so that relative paths are built correctly; resolve targetdocent with respect to the base URI of autolayout; change the import to point to the web + +2001-06-04 Norman Walsh + + * autolayout.xsl: Support tocksip attribute and default-filename config option + + * head.xsl: Support absolute CSS stylesheet filenames + + * param.xsl: Add sequential.links + + * tabular.xsl, toc-tabular.xsl, website-common.xsl, website.xsl: + Hack and slash; make it work :-) + +2001-05-21 Norman Walsh + + * param.xsl: Added body.attributes attribute set + + * tabular.xsl: Use body.attributes; make home.navhead.separator a template + +2001-04-17 Norman Walsh + + * chunk-tabular.xsl, chunk-website.xsl, website-common.xsl: + Fixed import paths + + * head.xsl: Fixed VERSION variable reference + + * tabular.xsl: Made table attributes into attribute-sets + +2001-04-15 Norman Walsh + + * VERSION, autolayout.xsl, chunk-common.xsl, chunk-tabular.xsl, chunk-website.xsl, head.xsl, makefile-dep.xsl, param.xsl, tabular.xsl, toc-tabular.xsl, toc.xsl, website-common.xsl, website.xsl, xbel.xsl: + New and very different files + + * VERSION, chunk-tabular.xsl, chunk-website-common.xsl, chunk-website.xsl, chunk.xml, chunklib.pl, chunktab.xml, head.xsl, hrefencode.pl, tabular.xsl, xbel.xsl, xtchunk-tabular.xsl, xtchunk-website.xsl: + branches: 1.1.4; + Initial checkin of V1.10 sources + + * autolayout.xsl: branches: 1.1.2; + file autolayout.xsl was initially added on branch V2-branch. + + * chunk-common.xsl: branches: 1.1.2; + file chunk-common.xsl was initially added on branch V2-branch. + + * chunk-tabular.xsl, chunk-website-common.xsl, chunk-website.xsl, chunk.xml, chunklib.pl, chunktab.xml, head.xsl, hrefencode.pl, tabular.xsl, website.xsl, xbel.xsl, xtchunk-tabular.xsl, xtchunk-website.xsl: + New file. + + * makefile-dep.xsl: branches: 1.1.2; + file makefile-dep.xsl was initially added on branch V2-branch. + + * param.xsl: branches: 1.1.2; + file param.xsl was initially added on branch V2-branch. + + * toc-tabular.xsl: branches: 1.1.2; + file toc-tabular.xsl was initially added on branch V2-branch. + + * toc.xsl: branches: 1.1.2; + file toc.xsl was initially added on branch V2-branch. + + * website-common.xsl: branches: 1.1.2; + file website-common.xsl was initially added on branch V2-branch. + + * website.xsl: branches: 1.2.4; + Support admon.graphics.extension + + * website.xsl: Initial checkin of V1.10 sources + diff --git a/src/documentation/docbook-xsl/website/autolayout.xsl b/src/documentation/docbook-xsl/website/autolayout.xsl new file mode 100644 index 0000000000..461bfcea8f --- /dev/null +++ b/src/documentation/docbook-xsl/website/autolayout.xsl @@ -0,0 +1,258 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + All toc entries must have a page attribute. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + All toc entries must have an href attribute. + + + + + + All href toc entries must have an id attribute. + + + + + off site: + + + + + + + + + + + + + + + + + + Off-site links must provide a title. + + + + + + + + + + + + + All toc entries must have a page attribute. + + + + + + + + + : missing ID. + + + + + + + + + + + + + + index.html + + + + + + + + + + + : missing filename. + + + + + + : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:apply-templates select="$page/*[1]/head/title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + / + + + + + + + + / + + + + + + + / + + + + + + diff --git a/src/documentation/docbook-xsl/website/chunk-common.xsl b/src/documentation/docbook-xsl/website/chunk-common.xsl new file mode 100644 index 0000000000..d750c058dd --- /dev/null +++ b/src/documentation/docbook-xsl/website/chunk-common.xsl @@ -0,0 +1,227 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Fail: tocentry has both page and href attributes. + + + + + + + + + index.html + + + + + + + + + + + + + + + + + + + + + does not exist. + + + + + + + + does not exist. + + + + + + + + + + + + + + + + + + / + + + + + + + + 0 + + + + 1 + + 0 + + + + + + 1 + + 0 + + + 1 + + + + + + + Update: + + : + + + + + + + + + + + + + + + + + + Up-to-date: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Must specify a $website.database.document parameter when + $collect.xref.targets is set to 'yes' or 'only'. + The xref targets were not collected. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/website/chunk-tabular.xsl b/src/documentation/docbook-xsl/website/chunk-tabular.xsl new file mode 100644 index 0000000000..3de75817e6 --- /dev/null +++ b/src/documentation/docbook-xsl/website/chunk-tabular.xsl @@ -0,0 +1,12 @@ + + + + + + + + diff --git a/src/documentation/docbook-xsl/website/chunk-website.xsl b/src/documentation/docbook-xsl/website/chunk-website.xsl new file mode 100644 index 0000000000..44721e274a --- /dev/null +++ b/src/documentation/docbook-xsl/website/chunk-website.xsl @@ -0,0 +1,12 @@ + + + + + + + + diff --git a/src/documentation/docbook-xsl/website/head.xsl b/src/documentation/docbook-xsl/website/head.xsl new file mode 100644 index 0000000000..e3ac308049 --- /dev/null +++ b/src/documentation/docbook-xsl/website/head.xsl @@ -0,0 +1,316 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + <xsl:value-of select="."/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + JavaScript + + + + + + + + + text/javascript + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Stripping NS from DocBook 5/NG document. + + + + + Processing stripped document. + + + + + + + + + ID ' + + ' not found in document. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/docbookng.xsl b/src/documentation/docbook-xsl/xhtml/docbookng.xsl new file mode 100644 index 0000000000..863fe12255 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/docbookng.xsl @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/ebnf.xsl b/src/documentation/docbook-xsl/xhtml/ebnf.xsl new file mode 100644 index 0000000000..d88bcf7806 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/ebnf.xsl @@ -0,0 +1,326 @@ + + + + + + + + + + +$Id: ebnf.xsl,v 1.9 2003/04/12 21:08:45 nwalsh Exp $ + +Walsh +Norman +19992000 +Norman Walsh + + +HTML EBNF Reference + + +
                  Introduction + +This is technical reference documentation for the DocBook XSL +Stylesheets; it documents (some of) the parameters, templates, and +other elements of the stylesheets. + +This reference describes the templates and parameters relevant +to formatting EBNF markup. + +This is not intended to be user documentation. +It is provided for developers writing customization layers for the +stylesheets, and for anyone who's interested in how it +works. + +Although I am trying to be thorough, this documentation is known +to be incomplete. Don't forget to read the source, too :-) +
                  +                   +                   + + + + + + + + + + + + 1 + + + + + + EBNF + + for + + + + + + + + + + + + +
                  + +
                  + + + + + + + + + + EBNF productions + +
                  +
                  +                   + + + + + + + + + + [ + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + Error: no ID for productionrecap linkend: + + . + + + + + + Warning: multiple "IDs" for productionrecap linkend: + + . + + + + + + + + + + + + + + + + | +
                  +                   +                   + + + + + + + + + + + + + + + production + + + + + + + + + Non-terminals with no content must point to + production elements in the current document. + + + Invalid xpointer for empty nt: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ??? + + + + + + + + + + + + + /*  + +  */ +
                  +                   + + + + + + + + + constraintdef + + + + + + + + + + + [  + + + + + : + + + + + + + : + + + + + + + + + +  ] + +
                  +                   +                   + + +
                  + + +
                  +                   + + +

                  +                   + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/footnote.xsl b/src/documentation/docbook-xsl/xhtml/footnote.xsl new file mode 100644 index 0000000000..947129ae4a --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/footnote.xsl @@ -0,0 +1,277 @@ + + + + + + + + + + + + + #ftn. + + + + + + + [ + + + + ] + + + + + [ + + + + ] + + + + + + + + + + #ftn. + + + + + + [ + + + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ftn. + + + + + + # + + + + +

                  + + + + + + + [ + + + + ] + + +

                  +                   + + + + + + ftn. + + + + + + # + + + + + + + [ + + + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +
                  +
                  + +
                  +                   + + +
                  +
                  +

                  The following annotations are from this essay. You are seeing + them here because your browser doesn’t support the user-interface + techniques used to make them appear as ‘popups’ on modern browsers.

                  +
                  + + +
                  +                   +                   + + + + + + + + +
                  + +
                  +                   + + +
                  + + +
                  +                   + + + + Warning: footnote number may not be generated + correctly; + + unexpected as first child of footnote. + +
                  + +
                  +                   +                   +                   + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/formal.xsl b/src/documentation/docbook-xsl/xhtml/formal.xsl new file mode 100644 index 0000000000..338805018d --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/formal.xsl @@ -0,0 +1,386 @@ + + + + + + + +1 + + + + + + + + +
                  + + + + + + + +
                  + +
                  + + + + + +

                  + + +

                  +

                  + + + + + + + +                   +
                  + +
                  +                   +                   + + + + + + + + + -float + + + + + + + + + +                   + + + + + + + + + +

                  + + + +

                  +                   + + + + + +
                  +

                  + + + + + + + + +

                  +

                  +                   + + + + + + + + + -float + + + + + + + + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Broken table: tr descendent of CALS Table. + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + Broken table: row descendent of HTML table. + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + float: + + ; + + + +
                  +                   + +                   diff --git a/src/documentation/docbook-xsl/xhtml/glossary.xsl b/src/documentation/docbook-xsl/xhtml/glossary.xsl new file mode 100644 index 0000000000..07f334074c --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/glossary.xsl @@ -0,0 +1,394 @@ + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  +                   +                   + + + + +
                  +                   + + + + + + + + + +
                  + + + + +
                  + +
                  +
                  +                   + + + + + + +
                  + + +
                  + +
                  +
                  +                   + + +

                  + +

                  +                   + + + + + + + + +
                  + + + + 0 + 1 + + + + + + + + ( + + ) + + + + + +
                  +                   + +
                  + + + + 0 + 1 + + + + + + + + ( + + ) + +
                  +                   + +
                  + + + + 0 + 1 + + + + + +
                  +                   +                   + + +                   + + + + , + + + + + , + + + + + , + + + + + + + + + + +
                  +

                  + + + + + + + + + + + + + + + + + + + + + + Warning: glosssee @otherterm reference not found: + + + + + + + + + + + + + + + . +

                  +
                  +                   + + +
                  + + +

                  + + + + + + + + + + + + + +

                  +                   +
                  +                   + + + + + + + + + + + + + + + + + + + + Warning: glossseealso @otherterm reference not found: + + + + + + + + + + + + . + + + , + + + + + + + + + + + + + + + + + Warning: processing automatic glossary + without a glossary.collection file. + + + + + + Warning: processing automatic glossary but unable to + open glossary.collection file ' + + ' + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + +
                  +                   +                   + + + + +
                  +                   + + + + + + + + + +
                  + + +
                  + + + + + + +
                  +
                  +                   + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/graphics.xsl b/src/documentation/docbook-xsl/xhtml/graphics.xsl new file mode 100644 index 0000000000..2ee06b8553 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/graphics.xsl @@ -0,0 +1,1365 @@ + + + + + + + + + + + + + + + + 1 + + + + + + 1 + + + + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 0 + 0 + + 1 + 0 + + + + + + 1.0 + 1.0 + + + + 1.0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + px + + + + + + + + + + + px + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + px + + + + + + + + + + + px + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + middle + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: imagemaps not supported + on scaled images + + + + 0 + + + + + + + + + + + + + + + + + + + + middle + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + height: + + px + + + + + + + + + + + +
                  + + + + + background-color: + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + +                   + + + + + + + + + + + + + calspair + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + , + + , + + , + + + + + + + Warning: only calspair supported + in imageobjectco + + + + + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + middle + + + + + + + + + + + + + + + + + +
                  + + + + + + + +
                  +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No insertfile extension available. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No insertfile extension available. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +
                  + + [ +                   D + ] + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No insertfile extension available. + + + + + + + + + + + + + +
                  + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/html-rtf.xsl b/src/documentation/docbook-xsl/xhtml/html-rtf.xsl new file mode 100644 index 0000000000..04c550ce86 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/html-rtf.xsl @@ -0,0 +1,321 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + +                   + + + + + + + + + + +                   +                   +                   +                   + + + + + + + + + + + + + + +
                  + +                   + + + + + + + + + + +                   +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/html.xsl b/src/documentation/docbook-xsl/xhtml/html.xsl new file mode 100644 index 0000000000..cd4c73e7ba --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/html.xsl @@ -0,0 +1,164 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   + + + + + + + # + + + + + + + + + # + + + + + + + + + + + + + + + + + bullet + + + + + + + + + bullet + + • + © + ™ + ™ + ® + (SM) +   + “ + ” + ‘ + ’ + — + — + – + – + + • + + + + + + + + + + + + + + + + + + + + + + + + + ID recommended on + + + : + + + + ... + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/html2xhtml.xsl b/src/documentation/docbook-xsl/xhtml/html2xhtml.xsl new file mode 100644 index 0000000000..18b7d54953 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/html2xhtml.xsl @@ -0,0 +1,181 @@ + + + + + + + + + + This file was created automatically by html2xhtml + + from the HTML stylesheets. Do not edit this file. + + + + + + + + + + + + + + + + + + + + + xml + UTF-8 + -//W3C//DTD XHTML 1.0 Transitional//EN + http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd + + + + + + + + + /html/ + /xhtml/ + + + + + + + + + 'xhtml' + + + + + + + 1 + + + + + + + 'xml' + + + + + + + 'xml' + + + + + + + 'UTF-8' + + + + + + + '-//W3C//DTD XHTML 1.0 Transitional//EN' + + + + + + + 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd' + + + + + + + + + id + + + + + + + + + + + + + + + + + http://www.w3.org/1999/xhtml + + + + + + + + + no apply-templates; make it empty + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/htmltbl.xsl b/src/documentation/docbook-xsl/xhtml/htmltbl.xsl new file mode 100644 index 0000000000..c9d6535d68 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/htmltbl.xsl @@ -0,0 +1,56 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/index.xsl b/src/documentation/docbook-xsl/xhtml/index.xsl new file mode 100644 index 0000000000..62cb6a3a96 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/index.xsl @@ -0,0 +1,218 @@ + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  +                   +                   +                   + + + + + + + + + + +
                  +                   +                   + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + +
                  +                   +                   + + + + + + + + + + +
                  + + + + + + + + +
                  + +
                  +
                  +                   + + +

                  + +

                  +                   + + + + + + + + + +                   + + + + + + + + + + + + +
                  + +
                  + + +
                  +
                  + +
                  +
                  +                   + +
                  +
                  + +
                  +
                  +                   +                   +                   + + +
                  + +
                  + + +
                  +
                  + +
                  +
                  +                   + +
                  +
                  + +
                  +
                  +                   +                   +                   + + +
                  + +
                  + +
                  +
                  + +
                  +
                  +                   +                   + + +
                  + +
                  +                   + + diff --git a/src/documentation/docbook-xsl/xhtml/info.xsl b/src/documentation/docbook-xsl/xhtml/info.xsl new file mode 100644 index 0000000000..ab9429718e --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/info.xsl @@ -0,0 +1,54 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/inline.xsl b/src/documentation/docbook-xsl/xhtml/inline.xsl new file mode 100644 index 0000000000..f3621adf74 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/inline.xsl @@ -0,0 +1,1157 @@ + + + + + + + + + + + + + + + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + XLink to nonexistent id: + + + ??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + span + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + , + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + abbr + + + + + + acronym + + + + + + + + + + + + + + + + + + + + + + + + + http://example.com/cgi-bin/man.cgi? + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + emphasis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + SM + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: glossary.collection specified, but there are + + automatic glossaries + + + + + + + + + + + + + + + + + + + + + + + + There's no entry for + + in + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Error: no glossentry for glossterm: + + . + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + element + + + + + + + + + + + + + + + + + </ + + > + + + & + + ; + + + &# + + ; + + + % + + ; + + + <? + + > + + + <? + + ?> + + + < + + > + + + < + + /> + + + <!-- + + --> + + + + + + + + + + + + < + + mailto: + + + > + + + + + + + + + + + + - + - + - + + - + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Citation to nonexistent publication abbrev: + + + [ + + ] + + + + + + + + +

                  +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/keywords.xsl b/src/documentation/docbook-xsl/xhtml/keywords.xsl new file mode 100644 index 0000000000..703ba4c9b5 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/keywords.xsl @@ -0,0 +1,36 @@ + + + + + + + + + + + + + + + + + + + + + + + , + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/lists.xsl b/src/documentation/docbook-xsl/xhtml/lists.xsl new file mode 100644 index 0000000000..45ab3998b6 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/lists.xsl @@ -0,0 +1,1024 @@ + + + + + + + + + + +
                  + + + + + + + + +
                    + + + + + + + + + + + + +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + circle + disc + square + + + + + + +
                • + + + list-style-type: + + + + + + + + + + + +
                  + +
                  +                   + + + +                   +
                  • +                   + + + + + + + + + + + + + 1 + a + i + A + I + + + + Unexpected numeration: + + + + + + + +
                  + + + + + + + + + +
                    + + + + + + + + + + + + + + + + +
                  +
                  +                   + + + + + + +
                • + + + + + + + + + + + + + +
                  + +
                  +                   + + + +                   +
                  • +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + +
                  + +
                  +                   +                   +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + +

                  + + + + + + + + +

                  +                   +                   +                   + + +
                  + + +
                  +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   +                   +                   +                   + + + + +
                  + +
                  +                   + + + +                   +                   + + + + + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + + 1 + + + +
                  +                   + + + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + 1 + 1 + + 1 + + + + + + + + +   + + + + + + + + + + + + + + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + 1 + 1 + + 1 + + + + + + + + +   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + before + + + + + + + + + +
                  + + + + 0 + 1 + + + + + + + + + + + + +
                    + +
                  +                   + +
                    + + + + +
                  +                   +                   + + + + +
                  +                   + + + + + + + + + + + + +
                    + +
                  +                   + + +
                • + + +
                  • +                   + + + +
                    + +
                  +                   + + +

                  + + + +

                  +                   + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + +
                  + + +
                  +                   + + + + + + + + +
                  + + + + : + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + +
                  +                   + +
                  + +
                  +                   +                   +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + +
                  +
                  +                   +                   +                   + + + + + + + + + +

                  + + + + + + + + +

                  +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ??? + + + + + # + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ??? + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/maketoc.xsl b/src/documentation/docbook-xsl/xhtml/maketoc.xsl new file mode 100644 index 0000000000..b16b2762db --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/maketoc.xsl @@ -0,0 +1,88 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + filename=" + + " + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/manifest.xsl b/src/documentation/docbook-xsl/xhtml/manifest.xsl new file mode 100644 index 0000000000..afdd704b47 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/manifest.xsl @@ -0,0 +1,116 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/math.xsl b/src/documentation/docbook-xsl/xhtml/math.xsl new file mode 100644 index 0000000000..9f23181335 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/math.xsl @@ -0,0 +1,284 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unsupported TeX math notation: + + + + + + + + + + + + + \nopagenumbers + + + + + \bye + + + + + + + + + + + + + + + + + + + + + + + + \special{dvi2bitmap outputfile + + } + + + $ + + + + $ + + + \vfill\eject + + + + + + + + + + + + + + + + + + + + + + + + + \special{dvi2bitmap outputfile + + } + + + $$ + + + + $$ + + + \vfill\eject + + + + + + + + + + \documentclass{article} + + \pagestyle{empty} + + \begin{document} + + + + + \end{document} + + + + + + + + + + + + + + + + + + + + + + + + \special{dvi2bitmap outputfile + + } + + + $ + + + + $ + + + \newpage + + + + + + + + + + + + + + + + + + + + + + + + + \special{dvi2bitmap outputfile + + } + + + $$ + + + + $$ + + + \newpage + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 0 + 1 + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/oldchunker.xsl b/src/documentation/docbook-xsl/xhtml/oldchunker.xsl new file mode 100644 index 0000000000..33422ac59d --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/oldchunker.xsl @@ -0,0 +1,176 @@ + + + + + + + + + + + + + + + + +Encoding used in generated HTML pages + +This encoding is used in files generated by chunking stylesheet. Currently +only Saxon is able to change output encoding. + + + + + + + + + +Saxon character representation used in generated HTML pages + +This character representation is used in files generated by chunking stylesheet. If +you want to suppress entity references for characters with direct representation +in default.encoding, set this parameter to value native. + + + + + + + + + + + + + + + + + + + + + + + + Chunking isn't supported with + + + + + + + + + + + + + + + Writing + + + for + + + ( + + ) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Can't make chunks with + + 's processor. + + + + + + + + + + + + + + + + Writing + + + for + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Can't make chunks with + + 's processor. + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/onechunk.xsl b/src/documentation/docbook-xsl/xhtml/onechunk.xsl new file mode 100644 index 0000000000..8795ee9b37 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/onechunk.xsl @@ -0,0 +1,36 @@ + + + + + + + + + + + + + + + + + +1 + + + + # + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/param.xsl b/src/documentation/docbook-xsl/xhtml/param.xsl new file mode 100644 index 0000000000..d5311b4bd6 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/param.xsl @@ -0,0 +1,7159 @@ + + + + + + + + +admon.graphics.extension +string + +admon.graphics.extension +Extension for admonition graphics + + +Description + +Sets the extension to use on admonition graphics. + + + + + + +admon.graphics.path +string + +admon.graphics.path +Path to admonition graphics + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the admonition graphics. + + + + +images/ + + +admon.graphics +boolean + +admon.graphics +Use graphics in admonitions? + + +Description + +If true (non-zero), admonitions are presented in an alternate style that uses +a graphic. Default graphics are provided in the distribution. + + + + + + + +admon.textlabel +boolean + +admon.textlabel +Use text label in admonitions? + + +Description + +If true (non-zero), admonitions are presented with a generated +text label such as Note or Warning in the appropriate language. +If zero, such labels are turned off, but any title child +of the admonition element are still output. +The default value is 1. + + + + + + + +admon.style +string + +admon.style +CSS style attributes for admonitions + + +Description + +Specifies the value of the STYLE +attribute that should be added to admonitions. + + + + + + margin-left: 0.5in; margin-right: 0.5in; + + + +callout.defaultcolumn +integer + +callout.defaultcolumn +Indicates what column callouts appear in by default + + +Description + +If a callout does not identify a column (for example, if it uses +the linerange unit), +it will appear in the default column. + + + + + + + +callout.graphics.extension +string + +callout.graphics.extension +Extension for callout graphics + + +Description + +Sets the extension to use on callout graphics. + + + + + + +callout.graphics.number.limit +integer + +callout.graphics.number.limit +Number of the largest callout graphic + + +Description + +If callout.graphics +is non-zero, graphics are used to represent +callout numbers. The value of +callout.graphics.number.limit +is +the largest number for which a graphic exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + + + + +callout.graphics.path +string + +callout.graphics.path +Path to callout graphics + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the callout graphics. + + + + + + + +callout.graphics +boolean + +callout.graphics +Use graphics for callouts? + + +Description + +If non-zero, callouts are presented with graphics (e.g., reverse-video +circled numbers instead of "(1)", "(2)", etc.). +Default graphics are provided in the distribution. + + + + + + + +callout.list.table +boolean + +callout.list.table +Present callout lists using a table? + + +Description + +The default presentation of CalloutLists uses +an HTML DL. Some browsers don't align DLs very well +if callout.graphics are used. With this option +turned on, CalloutLists are presented in an HTML +TABLE, which usually results in better alignment +of the callout number with the callout description. + + + + + + +callout.unicode.number.limit +integer + +callout.unicode.number.limit +Number of the largest callout graphic + + +Description + +If callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.number.limit +is +the largest number for which a unicode character exists. If the callout number +exceeds this limit, the default presentation "(nnn)" will always +be used. + + + + + + + +callout.unicode.start.character +integer + +callout.unicode.start.character +First Unicode character to use, decimal value. + + +Description + +If callout.graphics is zero and callout.unicode +is non-zero, unicode characters are used to represent +callout numbers. The value of +callout.unicode.start.character +is the decimal unicode value used for callout number one. Currently, +only 10102 is supported in the stylesheets for this parameter. + + + + + + + +callout.unicode +boolean + +callout.unicode +Use Unicode characters rather than images for callouts. + + +Description + +The stylesheets can use either an image of the numbers one to ten, or the single Unicode character which represents the numeral, in white on a black background. Use this to select the Unicode character option. + + + + + + + +callouts.extension +boolean + +callouts.extension +Enable the callout extension + + +Description + +The callouts extension processes areaset +elements in ProgramListingCO and other text-based +callout elements. + + + + + + + +ebnf.table.bgcolor +string + +ebnf.table.bgcolor +Background color for EBNF tables + + +Description + +Sets the background color for EBNF tables. No bgcolor +attribute is output if ebnf.table.bgcolor is set to +the null string. The default value matches the value used in recent +online versions of the W3C's XML Spec productions. + + + + + + +ebnf.table.border + + +ebnf.table.border +Selects border on EBNF tables + + +Description + +Selects the border on EBNF tables. If non-zero, the tables have +borders, otherwise they don't. + + + + + + +ebnf.assignment +rtf + +ebnf.assignment +The EBNF production assignment operator + + +Description + +The ebnf.assignment parameter determines what +text is used to show assignment in productions +in productionsets. + +While ::= is common, so are several +other operators. + + + + +::= + + + + +ebnf.statement.terminator +rtf + +ebnf.statement.terminator +Punctuation that ends an EBNF statement. + + +Description + +The ebnf.statement.terminator parameter determines what +text is used to terminate each production +in productionset. + +Some notations end each statement with a period. + + + + + + + +annotate.toc +boolean + +annotate.toc +Annotate the Table of Contents? + + +Description + +If true, TOCs will be annotated. At present, this just means +that the RefPurpose of RefEntry +TOC entries will be displayed. + + + + + + + +autotoc.label.separator +string + +autotoc.label.separator +Separator between labels and titles in the ToC + + +Description + +String to use to seperate labels and title in a table of contents. + + + + + + +autotoc.label.in.hyperlink +boolean + +autotoc.label.in.hyperlink +Include lable in hyperlinked titles in TOC? + + +Description + +If the value of +autotoc.label.in.hyperlink is non-zero, labels +are included in hyperlinked titles in the TOC. If it is instead zero, +labels are still displayed prior to the hyperlinked titles, but +are not hyperlinked along with the titles. + + + + + + +process.source.toc +boolean + +process.source.toc +Process a non-empty toc element if it occurs in a source document? + + +Description + +Specifies that the contents of a non-empty "hard-coded" +toc element in a source document are processed to +generate a TOC in output. + + This parameter has no effect on automated generation of + TOCs. An automated TOC may still be generated along with the + "hard-coded" TOC. To suppress automated TOC generation, adjust the + value of the generate.toc paramameter. + + The process.source.toc parameter also has + no effect if the toc element is empty; handling + for empty toc is controlled by the + process.empty.source.toc parameter. + + + + + + + + +process.empty.source.toc +boolean + +process.empty.source.toc +Generate automated TOC if toc element occurs in a source document? + + +Description + +Specifies that if an empty toc element is +found in a source document, an automated TOC is generated. + + Depending on what the value of the + generate.toc parameter is, setting this + parameter to 1 could result in generation of + duplicate automated TOCs. So the + process.empty.source.toc is primarily useful + as an "override": by placing an empty toc in your + document and setting this parameter to 1, you can + force a TOC to be generated even if generate.toc + says not to. + + + + + + + + +bridgehead.in.toc +boolean + +bridgehead.in.toc +Should bridgehead elements appear in the TOC? + + +Description + +If non-zero, bridgeheads appear in the TOC. Note that this option +is not fully supported and may be removed in a future version of the +stylesheets. + + + + + + + +simplesect.in.toc +boolean + +simplesect.in.toc +Should simplesect elements appear in the TOC? + + +Description + +If non-zero, simplesects appear in the TOC. + + + + + + + +manual.toc +string + +manual.toc +An explicit TOC to be used for the TOC + + +Description + +The manual.toc identifies an explicit TOC that +will be used for building the printed TOC. + + + + + + + +toc.list.type +list +dl +ul +ol + +toc.list.type +Type of HTML list element to use for Tables of Contents + + +Description + +When an automatically generated Table of Contents (or List of Titles) +is produced, this HTML element will be used to make the list. + + + + +dl + + +toc.section.depth +integer + +toc.section.depth +How deep should recursive sections appear +in the TOC? + + +Description + +Specifies the depth to which recursive sections should appear in the +TOC. + + + + +2 + + +toc.max.depth +integer + +toc.max.depth +How maximaly deep should be each TOC? + + +Description + +Specifies the maximal depth of TOC on all levels. + + + +8 + + +generate.toc +table + +generate.toc +Control generation of ToCs and LoTs + + +Description + +This parameter has a structured value. It is a table of space-delimited +path/value pairs. Each path identifies some element in the source document +using a restricted subset of XPath (only the implicit child axis, no wildcards, +no predicates). Paths can be either relative or absolute. + +When processing a particular element, the stylesheets consult this table to +determine if a ToC (or LoT(s)) should be generated. + +For example, consider the entry: + +book toc,figure + +This indicates that whenever a book is formatted, a +Table Of Contents and a List of Figures should be generated. Similarly, + +/chapter toc + +indicates that whenever a document that has a root +of chapter is formatted, a Table of +Contents should be generated. The entry chapter would match +all chapters, but /chapter matches only chapter +document elements. + +Generally, the longest match wins. So, for example, if you want to distinguish +articles in books from articles in parts, you could use these two entries: + +book/article toc,figure +part/article toc + +Note that an article in a part can never match a book/article, +so if you want nothing to be generated for articles in parts, you can simply leave +that rule out. + +If you want to leave the rule in, to make it explicit that you're turning +something off, use the value nop. For example, the following +entry disables ToCs and LoTs for articles: + +article nop + +Do not simply leave the word article in the file +without a matching value. That'd be just begging the silly little +path/value parser to get confused. + +Section ToCs are further controlled by the +generate.section.toc.level parameter. +For a given section level to have a ToC, it must have both an entry in +generate.toc and be within the range enabled by +generate.section.toc.level. + + + +appendix toc,title +article/appendix nop +article toc,title +book toc,title,figure,table,example,equation +chapter toc,title +part toc,title +preface toc,title +qandadiv toc +qandaset toc +reference toc,title +sect1 toc +sect2 toc +sect3 toc +sect4 toc +sect5 toc +section toc +set toc,title + + + + +generate.section.toc.level +integer + +generate.section.toc.level +Control depth of TOC generation in sections + + +Description + +The generate.section.toc.level parameter +controls the depth of section in which TOCs will be generated. Note +that this is related to, but not the same as +toc.section.depth, which controls the depth to +which TOC entries will be generated in a given TOC. +If, for example, generate.section.toc.level +is 3, TOCs will be generated in first, second, and third +level sections, but not in fourth level sections. + + + + + + + +generate.index +boolean + +generate.index +Do you want an index? + + +Description + +Specify if an index should be generated. + + + + + + +index.method +string + +index.method +Select method used to group index entries in an index + + +Description + +This parameter lets you select which method should be +used to sort and group index entries in an index. +Indexes in languages that have accented characters typically +sort together accented words and unaccented words. +So Á (A acute) would sort together +with A, so both would appear in the A +section of the index. + + +The default indexing method does not sort accented characters this way. +Words that start with an accented character will instead appear in the +Symbols section of the index. +As such, the default method is only suitable for +English and other unaccented languages. +The other indexing methods require extensions of one type or +another, which is why there are not used by default. + +The three choices for indexing method are: + + +english + + +(default) Sort and groups words based only on the Latin alphabet. +Accented words and words in non-Latin alphabets will be +put in the Symbols section of the index. + + + + +kosek + + +Sort and groups words based on letter groups configured in +the DocBook locale file for the given language. +For example, the French locale file is common/fr.xml. +This method requires support for EXSLT extensions in +the XSL processor. It also requires support for using +user-defined functions in xsl:key (xsltproc does not). + +This method is suitable for any language for which you can +list all the individual characters that should appear +in each letter group in an index. +It is probably not practical to use it for ideographic languages +such as Chinese that have hundreds or thousands of characters. + +To use this method, your customization must set this +parameter and import an additional stylesheet module: +<xsl:import href="[path-to-stylesheets]/common/autoidx-ng.xsl"/> +<xsl:param name="index.method">kosek</xsl:param> + + +The stylesheet module defines functions and adds an xsl:key +used by the method. + + + + +kimber + + +This method uses extensions to the Saxon processor to implement +sophisticated indexing processes. It uses its own +configuration file, which can include information for any number of +languages. Each language's configuration can group +words using either an +enumerated method similar to the kosek method, or it can +designate the first character in each group when viewed in sort order. +The latter configuration is useful for ideographic languages +such as Chinese, Japanese, and Korean. +You can also define your own collation algorithms and where you +want Latin-alphabet words sorted. + + +For a whitepaper describing the extensions, see: +. + + + +To download the extension library, see +. + + + + +To use this method, you must: + + + +Use Saxon as your XSLT processor. + + + +Install and configure the Innodata Isogen library, using +the documentation that comes with it. + + + +Set this parameter's value to kimber. + + + +Import the index extensions stylesheet module +common/autoidx-ng.xsl into your +customization. + + + + + + + + + + + + + +index.on.type +boolean + +index.on.type +Select indexterms based on type +attribute value + + +Description + + +If non-zero, +then an index element that has a +type attribute +value will contain only those indexterm +elements with a matching type attribute value. +If an index has no type +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + + +If index.on.type is zero, then the +type attribute has no effect +on selecting indexterms for an index. + + +For those using DocBook version 4.2 or earlier, +the type attribute is not available +for index terms. However, you can achieve the same +effect by using the role attribute +in the same manner on indexterm +and index, and setting the stylesheet parameter +index.on.role to a nonzero value. + + + + + + + +index.on.role +boolean + +index.on.role +Select indexterms based on role value + + +Description + + +If non-zero, +then an index element that has a +role attribute +value will contain only those indexterm +elements with a matching role value. +If an index has no role +attribute or it is blank, then the index will contain +all indexterms in the current scope. + + +If index.on.role is zero, then the +role attribute has no effect +on selecting indexterms for an index. + + +If you are using DocBook version 4.3 or later, you should +use the type attribute instead of role +on indexterm and index, +and set the index.on.type to a nonzero +value. + + + + + + + +index.prefer.titleabbrev +boolean + +index.prefer.titleabbrev +Should be abbreviated titles used as back references + + +Description + +FIXME: + + + + + + + +index.term.separator +string + +index.term.separator +Override for punctuation separating an index term +from its list of page references in an index + + +Description + +This parameter permits you to override +the text to insert between +the end of an index term and its list of page references. +Typically that might be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'term-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +fill in the content for this normally empty +override parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. +For fo output, it could be an fo:leader +element to provide space of a specific length, or a dot leader. + + + + + + + +index.number.separator +string + +index.number.separator +Override for punctuation separating page numbers in index + + +Description + +This parameter permits you to override the text to insert between +page references in a formatted index entry. Typically +that would be a comma and a space. + + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'number-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. This punctuation appears between +such section titles in an HTML index. + + + + + + + +index.range.separator +string + +index.range.separator +Override for punctuation separating the two numbers +in a page range in index + + +Description + +This parameter permits you +to override the text to insert between +the two numbers of a page range in an index. +This parameter is only used by those XSL-FO processors +that support an extension for generating such page ranges +(such as XEP). + +Because this text may be locale dependent, +this parameter's value is normally taken from a gentext +template named 'range-separator' in the +context 'index' in the stylesheet +locale file for the language +of the current document. +This parameter can be used to override the gentext string, +and would typically be used on the command line. +This parameter would apply to all languages. + + +So this text string can be customized in two ways. +You can reset the default gentext string using +the local.l10n.xml parameter, or you can +override the gentext with the content of this parameter. +The content can be a simple string, or it can be +something more complex such as a call-template. + + +In HTML index output, section title references are used instead of +page number references. So there are no page ranges +and this parameter has no effect. + + + + + + + +linenumbering.everyNth +integer + +linenumbering.everyNth +Indicate which lines should be numbered + + +Description + +If line numbering is enabled, everyNth line will be numbered. + + + + + + + +linenumbering.extension +boolean + +linenumbering.extension +Enable the line numbering extension + + +Description + +If true, verbatim environments (elements that have the +format='linespecific' notation attribute: address, literallayout, +programlisting, screen, synopsis) that specify line numbering will +have, surprise, line numbers. + + + + + + + +linenumbering.separator +string + +linenumbering.separator +Specify a separator between line numbers and lines + + +Description + +The separator is inserted between line numbers and lines in +the verbatim environment. + + + + + + + +linenumbering.width +integer + +linenumbering.width +Indicates the width of line numbers + + +Description + +If line numbering is enabled, line numbers will appear right +justified in a field "width" characters wide. + + + + + + + +tablecolumns.extension +boolean + +tablecolumns.extension +Enable the table columns extension function + + +Description + +The table columns extension function adjusts the widths of table +columns in the HTML result to more accurately reflect the specifications +in the CALS table. + + + + + + + +textinsert.extension +boolean + +textinsert.extension +Enable the textinsert extension element + + +Description + +The textinsert extension element inserts the contents of a +a file into the result tree (as text). + + + + + + + +textdata.default.encoding +string + +textdata.default.encoding +Default encoding of external text files which are included +using textdata element + + +Description + +Default encoding of external text files which are included using +textdata element. This value is used only when you do not specify +encoding by appropriate attribute directly on textdata. Default +encoding (empty string) is interpreted as system default +encoding. + + + + + + +graphicsize.extension +boolean + +graphicsize.extension +Enable the getWidth()/getDepth() extension functions + + +Description + +If non-zero (and if use.extensions is non-zero +and if you're using a processor that supports extension functions), the +getWidth and getDepth functions +will be used to extract image sizes from graphics. + + + + + + +graphicsize.use.img.src.path +boolean + +graphicsize.use.img.src.path +Prepend img.src.path before +filenames passed to extension functions + + +Description + +If non-zero img.src.path parameter will +be appended before filenames passed to extension functions for +measuring image dimensions. + + + + + + +use.extensions +boolean + +use.extensions +Enable extensions + + +Description + +If non-zero, extensions may be used. Each extension is +further controlled by its own parameter. But if +use.extensions is zero, no extensions will +be used. + + + + + + + +chapter.autolabel +boolean + +chapter.autolabel +Specifies the labeling format for Chapter titles + + +Description + +If zero, then chapters will not be numbered. +Otherwise chapters will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + + + + +appendix.autolabel +boolean + +appendix.autolabel +Specifies the labeling format for Appendix titles + + +Description + +If zero, then appendices will not be numbered. +Otherwise appendices will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperalpha). + + + + + + + +part.autolabel +boolean + +part.autolabel +Specifies the labeling format for Part titles + + +Description + +If zero, then parts will not be numbered. +Otherwise parts will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (upperroman). + + + + + + + + +preface.autolabel +boolean + +preface.autolabel +Specifices the labeling format for Preface titles + + +Description + +If zero (default), then prefaces will not be numbered. +Otherwise prefaces will be numbered, using the parameter value +as the number format if the value matches one of the following: + + + + + 1 or arabic + + Arabic numeration (1, 2, 3 ...). + + + + A or upperalpha + + Uppercase letter numeration (A, B, C ...). + + + + a or loweralpha + + Lowercase letter numeration (a, b, c ...). + + + + I or upperroman + + Uppercase roman numeration (I, II, III ...). + + + + i or lowerroman + + Lowercase roman letter numeration (i, ii, iii ...). + + + + +Any nonzero value other than the above will generate +the default number format (arabic). + + + + + + + + +qandadiv.autolabel +boolean + +qandadiv.autolabel +Are divisions in QAndASets enumerated? + + +Description + +If true (non-zero), unlabeled qandadivs will be enumerated. + + + + + + + +section.autolabel +boolean + +section.autolabel +Are sections enumerated? + + +Description + +If true (non-zero), unlabeled sections will be enumerated. + + + + + + + +section.autolabel.max.depth +integer + +section.autolabel.max.depth +The deepest level of sections that are numbered. + + +Description + +When section numbering is turned on by the +section.autolabel parameter, +then this parameter controls the depth of section nesting +that is numbered. +Sections nested to a level deeper than this value will +not be numbered. + + + + + + + +section.label.includes.component.label +boolean + +section.label.includes.component.label +Do section labels include the component label? + + +Description + +If true (non-zero), section labels are prefixed with the label of the +component that contains them. + + + + + + + +label.from.part +boolean + +label.from.part +Renumber chapters in each part? + + +Description + +If label.from.part is non-zero, components +(chapters, appendixes, etc.) +will be numbered from 1 in each part. Otherwise, +they will be numbered monotonically throughout each +book. + + + + + + + +component.label.includes.part.label +boolean + +component.label.includes.part.label +Do component labels include the part label? + + +Description + +If true (non-zero), number labels for chapters, appendices, and other component +elements are prefixed with the label of the +part element that contains them. +So you might see Chapter II.3 instead of Chapter 3. +Also, the labels for formal elements such as table and figure will +include the part label. +If there is no part element container, then no prefix is generated. + + +This feature is most useful when the +label.from.part parameter is turned on. +In that case, there would be more than one chapter +1, and the extra part label prefix will identify +each chapter unambiguously. + + + + + + + +html.base +uri + +html.base +An HTML base URI + + +Description + +If html.base is set, it is used for the BASE +element in the HEAD of the HTML documents. +This is useful for dynamically served HTML where the base URI needs +to be shifted. + + + + + + +html.stylesheet.type +string + +html.stylesheet.type +The type of the stylesheet used in the generated HTML + + +Description + +The type of the stylesheet to place in the HTML link tag. + + + + +text/css + + +html.stylesheet +string + +html.stylesheet +Name of the stylesheet(s) to use in the generated HTML + + +Description + +The html.stylesheet parameter is either empty, +indicating that no stylesheet LINK tag should be generated +in the HTML output, or it is a list of one or more stylesheets. + +Multiple stylesheets are space-delimited. If you need to +reference a stylesheet URI that includes a space, encode it with +%20. A seprate HTML LINK element will +be generated for each stylesheet in the order they are listed in the +parameter. + + + + + + +css.decoration +boolean + +css.decoration +Enable CSS decoration of elements + + +Description + + +If css.decoration is turned on, then HTML elements +produced by the +stylesheet may be decorated with STYLE attributes. For example, the +LI tags produced for list items may include a fragment of CSS in the +STYLE attribute which sets the CSS property "list-style-type". + + + + + + + +spacing.paras +boolean + +spacing.paras +Insert additional <p> elements for spacing? + + +Description + +When non-zero, additional, empty paragraphs are inserted in +several contexts (for example, around informal figures), to create a +more pleasing visual appearance in many browsers. + + + + + + + +emphasis.propagates.style +boolean + +emphasis.propagates.style +Pass emphasis role attribute through to HTML? + + +Description + +If true, the role attribute of emphasis elements +will be passed through to the HTML as a class attribute on a +span that surrounds the emphasis. + + + + + + +para.propagates.style +boolean + +para.propagates.style +Pass para role attribute through to HTML? + + +Description + +If true, the role attribute of para elements +will be passed through to the HTML as a class attribute on the +p generated for the paragraph. + + + + + + +phrase.propagates.style +boolean + +phrase.propagates.style +Pass phrase role attribute through to HTML? + + +Description + +If true, the role attribute of phrase elements +will be passed through to the HTML as a class attribute on a +span that surrounds the phrase. + + + + + + +entry.propagates.style +boolean + +entry.propagates.style +Pass entry role attribute through to HTML? + + +Description + +If true, the role attribute of entry elements +will be passed through to the HTML as a class attribute on the +td or th generated for the table +cell. + + + + + + +html.longdesc +boolean + +html.longdesc +Should longdesc URIs be created? + + +Description + +If non-zero, HTML files will be created for the +longdesc attribute. These files +are created from the textobjects in +mediaobjects and +inlinemediaobject. + + + + + + + +html.longdesc.link +boolean + +html.longdesc.link +Should a link to the longdesc be included in the HTML? + + +Description + +If non-zero, links will be created to the +HTML files created for the +longdesc attribute. It makes no +sense to turn enable this option without also enabling the +$html.longdesc parameter. + +The longdesc.link named template is called +to construct the link. + + + + + + +make.valid.html +boolean + +make.valid.html +Attempt to make sure the HTML output is valid HTML + + +Description + +If make.valid.html is true, the stylesheets take +extra effort to ensure that the resulting HTML is valid. This may mean that some +para tags are translated into HTML divs or +that other substitutions occur. + +This parameter is different from html.cleanup +because it changes the resulting markup; it does not use extension functions +to manipulate result-tree-fragments and is therefore applicable to any +XSLT processor. + + + + + + +html.cleanup +boolean + +html.cleanup +Attempt to clean up the resulting HTML? + + +Description + +If non-zero, and if the EXSLT +extensions are supported by your processor, the resulting HTML will be +cleaned up. This improves the chances that the +resulting HTML will be valid. It may also improve the formatting of +some elements. + +This parameter is different from make.valid.html +because it uses extension functions to manipulate result-tree-fragments. + + + + + + +draft.mode +list + +draft.mode +Select draft mode + + +Description + +Selects draft mode. If draft.mode is +yes, the entire document will be treated +as a draft. If it is no, the entire document +will be treated as a final copy. If it is maybe, +individual sections will be treated as draft or final independently, depending +on how their status attribute is set. + + + + + + + +draft.watermark.image +uri + +draft.watermark.image +The URI of the image to be used for draft watermarks + + +Description + +The image to be used for draft watermarks. + + + + + + +generate.id.attributes + + +generate.id.attributes + + + +Description + +If non-zero, the HTML stylesheet will generate ID attributes on +containers. For example, the markup: + +<section id="foo"><title>Some Title</title> +<para>Some para.</para> +</section> + +might produce: + +<div class="section" id="foo"> +<h2>Some Title</h2> +<p>Some para.</p> +</div> + +The alternative is to generate anchors: + +<div class="section"> +<h2><a name="foo"></a>Some Title</h2> +<p>Some para.</p> +</div> + +Because the name attribute of +the a element and the id +attribute of other tags are both of type ID, producing both +generates invalid documents. + +As of version 1.50, you can use this switch to control which type of +identifier is generated. For backwards-compatibility, generating +a anchors is preferred. + +Note: at present, this switch is incompletely implemented. +Disabling ID attributes will suppress them, but enabling ID attributes +will not suppress the anchors. + + + + + + +generate.meta.abstract +boolean + +generate.meta.abstract +Generate HTML META element from abstract? + + +Description + +If non-zero, document abstracts will be reproduced in the HTML +HEAD with meta name="description" content="...". + + + + + + +rootid +string + +rootid +Specify the root element to format + + +Description + +If rootid is specified, it must be the +value of an ID that occurs in the document being formatted. The entire +document will be loaded and parsed, but formatting will begin at the +element identified, rather than at the root. For example, this allows +you to process only chapter 4 of a book. +Because the entire document is available to the processor, automatic +numbering, cross references, and other dependencies are correctly +resolved. + + + + + + +suppress.navigation +boolean + +suppress.navigation +Disable header and footer navigation + + +Description + + +If suppress.navigation is turned on, header and +footer navigation will be suppressed. + + + +0 + + +suppress.header.navigation +boolean + +suppress.header.navigation +Disable header navigation + + +Description + + +If suppress.header.navigation is turned on, header +navigation will be suppressed. + + + +0 + + +suppress.footer.navigation +boolean + +suppress.footer.navigation +Disable footer navigation + + +Description + + +If suppress.footer.navigation is turned on, footer +navigation will be suppressed. + + + +0 + + +header.rule +boolean + +header.rule +Rule under headers? + + +Description + +If non-zero, a rule will be drawn below the page headers. + + + + + + +footer.rule +boolean + +footer.rule +Rule over footers? + + +Description + +If non-zero, a rule will be drawn above the page footers. + + + + + + +id.warnings +boolean + +id.warnings +Should warnings be generated for titled elements without IDs? + + +Description + +If non-zero, the stylesheet will issue a warning for +any element (other than the root element) which +has a title but does not have an ID. + + + + + + +inherit.keywords +boolean + +inherit.keywords +Inherit keywords from ancestor elements? + + +Description + +If inherit.keywords +is non-zero, the keyword META for each HTML +HEAD element will include all of the keywords from +ancestral elements. Otherwise, only the keywords from the current section +will be used. + + + + + + + +make.single.year.ranges +boolean + +make.single.year.ranges +Print single-year ranges (e.g., 1998-1999) + + +Description + +If non-zero, year ranges that span a single year will be printed +in range notation (1998-1999) instead of discrete notation +(1998, 1999). + + + + + + +make.year.ranges +boolean + +make.year.ranges +Collate copyright years into ranges? + + +Description + +If non-zero, copyright years will be collated into ranges. + + + + + + +author.othername.in.middle +boolean + +author.othername.in.middle +Is othername in author a +middle name? + + +Description + +If true (non-zero), the othername of an author +appears between the firstname and +surname. Otherwise, othername +is suppressed. + + + + + + + +generate.legalnotice.link +boolean + +generate.legalnotice.link +Write legalnotice to separate chunk and generate link? + + +Description + +If the value of generate.legalnotice.link +is non-zero, the stylesheet: + + + + writes the contents of legalnotice to a separate + HTML file + + + inserts a hyperlink to the legalnotice file + + + adds (in the HTML head) either a single + link or element or multiple + link elements (depending on the value of the + html.head.legalnotice.link.multiple + parameter), with the value or values derived from the + html.head.legalnotice.link.types + parameter + + + + Otherwise, if generate.legalnotice.link is + zero, legalnotice contents are rendered on the title + page. + + + + + + +generate.revhistory.link +boolean + +generate.revhistory.link +Write revhistory to separate chunk and generate link? + + +Description + +If non-zero, the contents of revhistory are written +to a separate HTML file and a link to the file is +generated. Otherwise, revhistory contents are rendered on +the title page. + + + + + + +html.head.legalnotice.link.types +string + +html.head.legalnotice.link.types +Specifies link types for legalnotice link in html head + + +Description + +The value of +html.head.legalnotice.link.types is a +space-separated list of link types, as described in Section 6.12 +of the HTML 4.01 specification. If the value of the +generate.legalnotice.link parameter is +non-zero, then the stylesheet generates (in the +head section of the HTML source) either a single +HTML link element or, if the value of the +html.head.legalnotice.link.multiple is +non-zero, one link element for each link type +specified. Each link has the following attributes: + + + + a rel attribute whose + value is derived from the value of + html.head.legalnotice.link.types + + + an href attribute whose + value is set to the URL of the file containing the + legalnotice + + + a title attribute whose + value is set to the title of the corresponding + legalnotice (or a title programatically + determined by the stylesheet) + + + +For example: + + <link rel="license" href="ln-id2524073.html" title="Legal Notice"> + + + + About the default value + In an ideal world, the default value of + html.head.legalnotice.link.types would + probably be “license”, since the content of the + DocBook legalnotice is typically license + information, not copyright information. However, the default value + is “copyright” for pragmatic reasons: because + that’s among the set of “recognized link types” listed in Section + 6.12 of the HTML 4.01 specification, and because certain + browsers and browser extensions are preconfigured to recognize that + value. + + + + +copyright + + +html.head.legalnotice.link.multiple +boolean + +html.head.legalnotice.link.multiple +Generate multiple link instances in html head for legalnotice? + + +Description + +If html.head.legalnotice.link.multiple is +non-zero and the value of +html.head.legalnotice.link.types contains +multiple link types, then the stylesheet generates (in the +head section of the HTML source) one +link element for each link type specified. For +example, if the value of +html.head.legalnotice.link.types is +“copyright license”: + + <link rel="copyright" href="ln-id2524073.html" title="Legal Notice"> + <link rel="license" href="ln-id2524073.html" title="Legal Notice"> + + Otherwise, the stylesheet generates generates a single + link instance; for example: + + <link rel="copyright license" href="ln-id2524073.html" title="Legal Notice"> + + + + + + + +funcsynopsis.decoration +boolean + +funcsynopsis.decoration +Decorate elements of a FuncSynopsis? + + +Description + +If true (non-zero), elements of the FuncSynopsis will be decorated (e.g. bold or +italic). The decoration is controlled by functions that can be redefined +in a customization layer. + + + + + + + +funcsynopsis.style +list +ansi +kr + +funcsynopsis.style +What style of 'FuncSynopsis' should be generated? + + +Description + +If funcsynopsis.style is ansi, +ANSI-style function synopses are generated for a +funcsynopsis, otherwise K&R-style +function synopses are generated. + + + + +kr + + +funcsynopsis.tabular.threshold +integer + +funcsynopsis.tabular.threshold +Width beyond which a tabular presentation will be used + + +Description + +If funcsynopsis.tabular.threshold is greater than +zero then if a funcprototype is wider than the threshold +value, it will be presented in a table. + + + + + + +function.parens +boolean + +function.parens +Generate parens after a function? + + +Description + +If not 0, the formatting of +a function element will include +generated parenthesis. + + + + +0 + + +refentry.generate.name +boolean + +refentry.generate.name +Output NAME header before 'RefName'(s)? + + +Description + +If true (non-zero), a "NAME" section title is output before the list +of 'RefName's. This parameter and +refentry.generate.title are mutually +exclusive. This means that if you change this parameter to zero, you +should set refentry.generate.title to 1 unless +you want get quite strange output. + + + + + + + +refentry.generate.title +boolean + +refentry.generate.title +Output title before 'RefName'(s)? + + +Description + +If true (non-zero), the reference page title or first name is +output before the list of 'RefName's. This parameter and +refentry.generate.name are mutually exclusive. +This means that if you change this parameter to 1, you +should set refentry.generate.name to 0 unless +you want get quite strange output. + + + + + + + +refentry.xref.manvolnum +boolean + +refentry.xref.manvolnum +Output manvolnum as part of +refentry cross-reference? + + +Description + +if true (non-zero), the manvolnum is used when cross-referencing +refentrys, either with xref +or citerefentry. + + + + + + + +citerefentry.link +boolean + +citerefentry.link +Generate URL links when cross-referencing RefEntrys? + + +Description + +If true, a web link will be generated, presumably +to an online man->HTML gateway. The text of the link is +generated by the generate.citerefentry.link template. + + + + + + + +refentry.separator +boolean + +refentry.separator +Generate a separator between consecutive RefEntry elements? + + +Description + +If true, a separator will be generated between consecutive +reference pages. + + + + + + + +refclass.suppress +boolean + +refclass.suppress +Suppress display of refclass contents? + + +Description + +If the value of refclass.suppress is +non-zero, then display of refclass contents is +suppressed in output. + + + + + + +default.table.width +length + +default.table.width +The default width of tables + + +Description + +If specified, this value will be used for the WIDTH attribute on +tables that do not specify an alternate width (with the dbhtml processing +instruction). + + + + + + +nominal.table.width +length + +nominal.table.width +The (absolute) nominal width of tables + + +Description + +In order to convert CALS column widths into HTML column widths, it +is sometimes necessary to have an absolute table width to use for conversion +of mixed absolute and relative widths. This value must be an absolute +length (not a percentag). + + + + + + +table.borders.with.css +boolean + +table.borders.with.css +Use CSS to specify table, row, and cell borders? + + +Description + +If true (non-zero), CSS will be used to draw table borders. + + + + + + + +table.cell.border.style + + +table.cell.border.style + + + +Description + +FIXME: + + + + + + +table.cell.border.thickness + + +table.cell.border.thickness + + + +Description + +FIXME: + + + + + + +table.cell.border.color + + +table.cell.border.color + + + +Description + +FIXME: + + + + + + + +table.frame.border.style + + +table.frame.border.style + + + +Description + +FIXME: + + + + + + +table.frame.border.thickness + + +table.frame.border.thickness +Specifies the thickness of the frame border + + +Description + +Specifies the thickness of the border on the table's frame. + + + + + + +table.frame.border.color + + +table.frame.border.color + + + +Description + +FIXME: + + + + + + + +default.table.frame +string + +default.table.frame +The default framing of tables + + +Description + +This value will be used when there is no frame attribute on the table. + + + + + + +html.cellspacing +integer + +html.cellspacing +Default value for cellspacing in HTML tables + + +Description + +If specified, this value will be used as the default cellspacing value +in HTML tables. + + + + + + +html.cellpadding +integer + +html.cellpadding +Default value for cellpadding in HTML tables + + +Description + +If specified, this value will be used as the default cellpadding value +in HTML tables. + + + + + + +qanda.defaultlabel +boolean + +qanda.defaultlabel +Sets the default for defaultlabel on QandASet. + + +Description + +If no defaultlabel attribute is specified on a QandASet, this +value is used. It must be one of the legal values for the defaultlabel +attribute. + + + + +number + + +qanda.inherit.numeration +boolean + +qanda.inherit.numeration +Does enumeration of QandASet components inherit the numeration of parent elements? + + +Description + +If true (non-zero), numbered QandADiv elements and Questions and Answers inherit +the numeration of the ancestors of the QandASet. + + + + + + + +target.database.document +uri + +target.database.document +Name of master database file for resolving +olinks + + +Description + +To resolve olinks between documents, the stylesheets use +a master database document that identifies the target datafiles for all the documents within the scope +of the olinks. This parameter value is the URI of +the master document to be read during processing to resolve olinks. +The default value is olinkdb.xml. +The data structure of the file is defined in the targetdatabase.dtd DTD. The database file provides the high level elements to record the identifiers, locations, and relationships of documents. The cross reference data for individual documents is generally pulled into the database using system entity references or XIncludes. See also targets.filename. + + + + + + + +targets.filename +string + +targets.filename +Name of cross reference targets data file + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter lets you change the name of the generated +file from the default name target.db. +The name must agree with that used in the target database +used to resolve olinks during processing. +See also target.database.document. + + + + + + +olink.base.uri +uri + +olink.base.uri +Base URI used in olink hrefs + + +Description +When cross reference data is collected for resolving olinks, it may be necessary to prepend a base URI to each target's href. This parameter lets you set that base URI when cross reference data is collected. This feature is needed when you want to link to a document that is processed without chunking. The output filename for such a document is not known to the XSL stylesheet; the only target information consists of fragment identifiers such as #idref. To enable the resolution of olinks between documents, you should pass the name of the HTML output file as the value of this parameter. Then the hrefs recorded in the cross reference data collection look like outfile.html#idref, which can be reached as links from other documents. + + + + + +use.local.olink.style +boolean + +use.local.olink.style +Process olinks using xref style of current +document + + +Description +When cross reference data is collected for use by olinks, the data for each potential target includes one field containing a completely assembled cross reference string, as if it were an xref generated in that document. Other fields record the separate title, number, and element name of each target. When an olink is formed to a target from another document, the olink resolves to that preassembled string by default. If the use.local.olink.style parameter is set to non-zero, then instead the cross +reference string is formed again from the target title, number, and +element name, using the stylesheet processing the targeting document. +Then olinks will match the xref style in the targeting document +rather than in the target document. If both documents are processed +with the same stylesheet, then the results will be the same. + + + + + +current.docid +string + +current.docid +targetdoc identifier for the document being +processed + + +Description +When olinks between documents are resolved for HTML output, the stylesheet can compute the relative path between the current document and the target document. The stylesheet needs to know the targetdoc identifiers for both documents, as they appear in the target.database.document database file. This parameter passes to the stylesheet +the targetdoc identifier of the current document, since that +identifier does not appear in the document itself. +This parameter can also be used for print output. If an olink's targetdoc id differs from the current.docid, then the stylesheet can append the target document's title to the generated olink text. That identifies to the reader that the link is to a different document, not the current document. See also olink.doctitle to enable that feature. + + + + + +olink.doctitle +string + +olink.doctitle +show the document title for external olinks? + + + +Description +When olinks between documents are resolved, the generated text +may not make it clear that the reference is to another document. +It is possible for the stylesheets to append the other document's +title to external olinks. For this to happen, two parameters must +be set. + + +This olink.doctitle parameter +should be set to either yes or maybe +to enable this feature. + + + +And you should also set the current.docid +parameter to the document id for the document currently +being processed for output. + + + + + +Then if an olink's targetdoc id differs from +the current.docid value, the stylesheet knows +that it is a reference to another document and can +append the target document's +title to the generated olink text. + +The text for the target document's title is copied from the +olink database from the ttl element +of the top-level div for that document. +If that ttl element is missing or empty, +no title is output. + + +The supported values for olink.doctitle are: + + + +yes + + +Always insert the title to the target document if it is not +the current document. + + + + +no + + +Never insert the title to the target document, even if requested +in an xrefstyle attribute. + + + + +maybe + + +Only insert the title to the target document, if requested +in an xrefstyle attribute. + + + + +An xrefstyle attribute +may override the global setting for individual olinks. +The following values are supported in an +xrefstyle +attribute using the select: syntax: + + + + +docname + + +Insert the target document name for this olink using the +docname gentext template, but only +if the value of olink.doctitle +is not no. + + + + +docnamelong + + +Insert the target document name for this olink using the +docnamelong gentext template, but only +if the value of olink.doctitle +is not no. + + + + +nodocname + + +Omit the target document name even if +the value of olink.doctitle +is yes. + + + + +Another way of inserting the target document name +for a single olink is to employ an +xrefstyle +attribute using the template: syntax. +The %o placeholder (the letter o, not zero) +in such a template +will be filled in with the target document's title when it is processed. +This will occur regardless of +the value of olink.doctitle. + +Note that prior to version 1.66 of the XSL stylesheets, +the allowed values for this parameter were 0 and 1. Those +values are still supported and mapped to 'no' and 'yes', respectively. + + + + + + +olink.debug +boolean + +olink.debug +Turn on debugging messages for olinks + + +Description + +If non-zero, then each olink will generate several +messages about how it is being resolved during processing. +This is useful when an olink does not resolve properly +and the standard error messages are not sufficient to +find the problem. + + +You may need to read through the olink XSL templates +to understand the context for some of the debug messages. + + + + + + + +olink.properties +Properties associated with the cross-reference +text of an olink. + + +Description + +This attribute set is used on cross reference text +from an olink. It is not applied to the +optional page number or +optional title of the external document. + + + + + + + +olink.lang.fallback.sequence +string + +olink.lang.fallback.sequence +look up translated documents if olink not found? + + + +Description + +This parameter defines a list of lang values +to search among to resolve olinks. + + +Normally an olink tries to resolve to a document in the same +language as the olink itself. The language of an olink +is determined by its nearest ancestor element with a +lang attribute, otherwise the +value of the l10n.gentext.default.lang +parameter. + + +An olink database can contain target data for the same +document in multiple languages. Each set of data has the +same value for the targetdoc attribute in +the document element in the database, but with a +different lang attribute value. + + +When an olink is being resolved, the target is first +sought in the document with the same language as the olink. +If no match is found there, then this parameter is consulted +for additional languages to try. + +The olink.lang.fallback.sequence +must be a whitespace separated list of lang values to +try. The first one with a match in the olink database is used. +The default value is empty. + +For example, a document might be written in German +and contain an olink with +targetdoc="adminguide". +When the document is processed, the processor +first looks for a target dataset in the +olink database starting with: + +<document targetdoc="adminguide" lang="de">. + + +If there is no such element, then the +olink.lang.fallback.sequence +parameter is consulted. +If its value is, for example, fr en, then the processor next +looks for targetdoc="adminguide" lang="fr", and +then for targetdoc="adminguide" lang="en". +If there is still no match, it looks for +targetdoc="adminguide" with no +lang attribute. + + +This parameter is useful when a set of documents is only +partially translated, or is in the process of being translated. +If a target of an olink has not yet been translated, then this +parameter permits the processor to look for the document in +other languages. This assumes the reader would rather have +a link to a document in a different language than to have +a broken link. + + + + + + + +insert.olink.page.number +string + +insert.olink.page.number +Turns page numbers in olinks on and off + + +Description + +The value of this parameter determines if +cross references made between documents with +olink will +include page number citations. +In most cases this is only applicable to references in printed output. + +The parameter has three possible values. + + + +no +No page number references will be generated for olinks. + + + +yes +Page number references will be generated +for all olink references. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an olink element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + +Olinks that point to targets within the same document +are treated as xrefs, and controlled by +the insert.xref.page.number parameter. + + +Page number references for olinks to +external documents can only be inserted if the +information exists in the olink database. +This means each olink target element +(div or obj) +must have a page attribute +whose value is its page number in the target document. +The XSL stylesheets are not able to extract that information +during processing because pages have not yet been created in +XSLT transformation. Only the XSL-FO processor knows what +page each element is placed on. +Therefore some postprocessing must take place to populate +page numbers in the olink database. + + + + + + +no + + +insert.olink.pdf.frag +boolean + +insert.olink.pdf.frag +Add fragment identifiers for links into PDF files + + +Description + +The value of this parameter determines whether +the cross reference URIs to PDF documents made with +olink will +include fragment identifiers. + + +When forming a URI to link to a PDF document, +a fragment identifier (typically a '#' followed by an +id value) appended to the PDF filename can be used by +the PDF viewer to open +the PDF file to a location within the document instead of +the first page. +However, not all PDF files have id +values embedded in them, and not all PDF viewers can +handle fragment identifiers. + + +If insert.olink.pdf.frag is set +to a non-zero value, then any olink targeting a +PDF file will have the fragment identifier appended to the URI. +The URI is formed by concatenating the value of the +olink.base.uri parameter, the +value of the baseuri +attribute from the document +element in the olink database with the matching +targetdoc value, +and the value of the href +attribute for the targeted element in the olink database. +The href attribute +contains the fragment identifier. + + +If insert.olink.pdf.frag is set +to zero (the default value), then +the href attribute +from the olink database +is not appended to PDF olinks, so the fragment identifier is left off. +A PDF olink is any olink for which the +baseuri attribute +from the matching document +element in the olink database ends with '.pdf'. +Any other olinks will still have the fragment identifier added. + + + + + + +prefer.internal.olink +boolean + +prefer.internal.olink +Prefer a local olink reference to an external reference + + +Description + +If you are re-using XML content modules in multiple documents, +you may want to redirect some of your olinks. This parameter +permits you to redirect an olink to the current document. + + +For example: you are writing documentation for a product, +which includes 3 manuals: a little installation +booklet (booklet.xml), a user +guide (user.xml), and a reference manual (reference.xml). +All 3 documents begin with the same introduction section (intro.xml) that +contains a reference to the customization section (custom.xml) which is +included in both user.xml and reference.xml documents. + + +How do you write the link to custom.xml in intro.xml +so that it is interpreted correctly in all 3 documents? + +If you use xref, it will fail in user.xml. + +If you use olink (pointing to reference.xml), +the reference in user.xml +will point to the customization section of the reference manual, while it is +actually available in user.xml. + + + +If you set the prefer.internal.olink +parameter to a non-zero value, then the processor will +first look in the olink database +for the olink's targetptr attribute value +in document matching the current.docid +parameter value. If it isn't found there, then +it tries the document in the database +with the targetdoc +value that matches the olink's targetdoc +attribute. + + +This feature permits an olink reference to resolve to +the current document if there is an element +with an id matching the olink's targetptr +value. The current document's olink data must be +included in the target database for this to work. + + +There is a potential for incorrect links if +the same id attribute value is used for different +content in different documents. +Some of your olinks may be redirected to the current document +when they shouldn't be. It is not possible to control +individual olink instances. + + + + + + + +link.mailto.url +string + +link.mailto.url +Mailto URL for the LINK REL=made HTML HEAD element + + +Description + +If not the empty string, this address will be used for the +REL=made LINK element in the HTML HEAD. + + + + + + + +ulink.target +string + +ulink.target +The HTML anchor target for ULinks + + +Description + +If ulink.target is set, its value will +be used for the target attribute +on anchors generated for ulinks. + + + + + + +olink.fragid +string + +olink.fragid +Names the fragment identifier portion of an OLink resolver query + + +Description + +FIXME: + + + + + + +olink.outline.ext +string + +olink.outline.ext +The extension of OLink outline files + + +Description + +FIXME: + + + + + + +olink.pubid +string + +olink.pubid +Names the public identifier portion of an OLink resolver query + + +Description + +FIXME: + + + + + + +olink.sysid +string + +olink.sysid +Names the system identifier portion of an OLink resolver query + + +Description + +FIXME: + + + + + + +olink.resolver + + +olink.resolver +The root name of the OLink resolver (usually a script) + + +Description + +FIXME: + + + + + + +collect.xref.targets +string + +collect.xref.targets +Controls whether cross reference data is +collected + + +Description + +In order to resolve olinks efficiently, the stylesheets can +generate an external data file containing information about +all potential cross reference endpoints in a document. +This parameter determines whether the collection process is run when the document is processed by the stylesheet. The default value is no, which means the data file is not generated during processing. The other choices are yes, which means the data file is created and the document is processed for output, and only, which means the data file is created but the document is not processed for output. +See also targets.filename. + + + + + + +insert.xref.page.number +string + +insert.xref.page.number +Turns page numbers in xrefs on and off + + +Description + +The value of this parameter determines if +cross references (xrefs) in +printed output will +include page number citations. +It has three possible values. + + + +no +No page number references will be generated. + + + +yes +Page number references will be generated +for all xref elements. +The style of page reference may be changed +if an xrefstyle +attribute is used. + + + +maybe +Page number references will not be generated +for an xref element unless +it has an +xrefstyle +attribute whose value specifies a page reference. + + + + + + +no + + +use.role.as.xrefstyle +boolean + +use.role.as.xrefstyle +Use role attribute for +xrefstyle on xref? + + +Description + +If non-zero, the role attribute on +xref will be used to select the cross reference style. +The DocBook +Technical Committee recently added an +xrefstyle attribute for this purpose. +If the xrefstyle attribute +is present, role will be ignored, regardless +of this setting. + +Until an official DocBook release that includes the new +attribute, this flag allows role +to serve that purpose. + +Example + +The following small stylesheet shows how to configure the stylesheets to make +use of the cross reference style: + +<?xml version="1.0"?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="1.0"> + +<xsl:import href="../xsl/html/docbook.xsl"/> + +<xsl:output method="html"/> + +<xsl:param name="local.l10n.xml" select="document('')"/> +<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"> + <l:l10n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" language="en"> + <l:context name="xref"> + <l:template name="chapter" style="title" text="Chapter %n, %t"/> + <l:template name="chapter" text="Chapter %n"/> + </l:context> + </l:l10n> +</l:i18n> + +</xsl:stylesheet> + +With this stylesheet, the cross references in the following document: + +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> +<book id="book"><title>Book</title> + +<preface> +<title>Preface</title> + +<para>Normal: <xref linkend="ch1"/>.</para> +<para>Title: <xref xrefstyle="title" linkend="ch1"/>.</para> + +</preface> + +<chapter id="ch1"> +<title>First Chapter</title> + +<para>Irrelevant.</para> + +</chapter> +</book> + +will appear as: + + +Normal: Chapter 1. +Title: Chapter 1, First Chapter. + + + + + + +xref.with.number.and.title +boolean + +xref.with.number.and.title +Use number and title in cross references + + +Description + +FIXME: + + + + + + +xref.label-page.separator +string + +xref.label-page.separator +Punctuation or space separating label from page number in xref + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and page +but no title, +then the value of this parameter is inserted between +label and page number in the output. +If a title is included, then other separators are used. + + + + + + + +xref.label-title.separator +string + +xref.label-title.separator +Punctuation or space separating label from title in xref + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both label and title, +then the value of this parameter is inserted between +label and title in the output. + + + + +: + + +xref.title-page.separator +string + +xref.title-page.separator +Punctuation or space separating title from page number in xref + + +Description + + +This parameter allows you to control the punctuation of certain +types of generated cross reference text. +When cross reference text is generated for an +xref or +olink element +using an xrefstyle attribute +that makes use of the select: feature, +and the selected components include both title and page number, +then the value of this parameter is inserted between +title and page number in the output. + + + + + + + +segmentedlist.as.table +boolean + +segmentedlist.as.table +Format segmented lists as tables? + + +Description + +If non-zero, segmentedlists will be formatted as +tables. + + + + + + +variablelist.as.table +boolean + +variablelist.as.table +Format variablelists as tables? + + +Description + +If non-zero, variablelists will be formatted as +tables. A processing instruction exists to specify a particualar width for the +column containing the terms: +dbhtml term-width=".25in" + +You can override this setting with a processing instruction as the +child of variablelist: dbhtml +list-presentation="table" or dbhtml +list-presentation="list". + +This parameter only applys to the HTML transformations. In the +FO case, proper list markup is robust enough to handle the formatting. +But see also variablelist.as.blocks. + + <variablelist> + <?dbhtml list-presentation="table"?> + <?dbhtml term-width="1.5in"?> + <?dbfo list-presentation="list"?> + <?dbfo term-width="1in"?> + <varlistentry> + <term>list</term> + <listitem> + <para> + Formatted as a table even if variablelist.as.table is set to 0. + </para> + </listitem> + </varlistentry> + </variablelist> + + + + + + +variablelist.term.separator +string + +variablelist.term.separator +Text to separate terms within a multi-term +varlistentry + + +Description + +When a varlistentry contains multiple term +elements, the string specified in the value of the +variablelist.term.separator parameter is placed +after each term except the last. + + + To generate a line break between multiple terms in + a varlistentry, set a non-zero value for the + variablelist.term.break.after parameter. If + you do so, you may also want to set the value of the + variablelist.term.separator parameter to an + empty string (to suppress rendering of the default comma and space + after each term). + + + + +, + + +variablelist.term.break.after +boolean + +variablelist.term.break.after +Generate line break after each term within a +multi-term varlistentry? + + +Description + +Set a non-zero value for the +variablelist.term.break.after parameter to +generate a line break between terms in a +multi-term varlistentry. + + +If you set a non-zero value for +variablelist.term.break.after, you may also +want to set the value of the +variablelist.term.separator parameter to an +empty string (to suppress rendering of the default comma and space +after each term). + + + + +0 + + +biblioentry.item.separator +string + +biblioentry.item.separator +Text to separate bibliography entries + + +Description + +Text to separate bibliography entries + + + + +. + + +bibliography.collection +string + +bibliography.collection +Name of the bibliography collection file + + +Description + +Maintaining bibliography entries across a set of documents is tedious, time +consuming, and error prone. It makes much more sense, usually, to store all of +the bibliography entries in a single place and simply extract +the ones you need in each document. + +That's the purpose of the +bibliography.collection parameter. To setup a global +bibliography database, follow these steps: + +First, create a stand-alone bibliography document that contains all of +the documents that you wish to reference. Make sure that each bibliography +entry (whether you use biblioentry or bibliomixed) +has an ID. + +My global bibliography, ~/bibliography.xml begins +like this: + + +<!DOCTYPE bibliography + PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<bibliography><title>References</title> + +<bibliomixed id="xml-rec"><abbrev>XML 1.0</abbrev>Tim Bray, +Jean Paoli, C. M. Sperberg-McQueen, and Eve Maler, editors. +<citetitle><ulink url="http://www.w3.org/TR/REC-xml">Extensible Markup +Language (XML) 1.0 Second Edition</ulink></citetitle>. +World Wide Web Consortium, 2000. +</bibliomixed> + +<bibliomixed id="xml-names"><abbrev>Namespaces</abbrev>Tim Bray, +Dave Hollander, +and Andrew Layman, editors. +<citetitle><ulink url="http://www.w3.org/TR/REC-xml-names/">Namespaces in +XML</ulink></citetitle>. +World Wide Web Consortium, 1999. +</bibliomixed> + +<!-- ... --> +</bibliography> + + + +When you create a bibliography in your document, simply +provide empty bibliomixed +entries for each document that you wish to cite. Make sure that these +elements have the same ID as the corresponding real +entry in your global bibliography. + +For example: + + +<bibliography><title>Bibliography</title> + +<bibliomixed id="xml-rec"/> +<bibliomixed id="xml-names"/> +<bibliomixed id="DKnuth86">Donald E. Knuth. <citetitle>Computers and +Typesetting: Volume B, TeX: The Program</citetitle>. Addison-Wesley, +1986. ISBN 0-201-13437-3. +</bibliomixed> +<bibliomixed id="relaxng"/> + +</bibliography> + + +Note that it's perfectly acceptable to mix entries from your +global bibliography with normal entries. You can use +xref or other elements to cross-reference your +bibliography entries in exactly the same way you do now. + +Finally, when you are ready to format your document, simply set the +bibliography.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global bibliography. + +The stylesheets will format the bibliography in your document as if +all of the entries referenced appeared there literally. + + + + + + +bibliography.numbered +boolean + +bibliography.numbered +Should bibliography entries be numbered? + + +Description + +If non-zero bibliography entries will be numbered + + + + + + +glossterm.auto.link +boolean + +glossterm.auto.link +Generate links from glossterm to glossentry automaticaly? + + +Description + +If true, a link will be automatically created from glossterm +to glossentry for that glossary term. This is usefull when your +glossterm names are consistent and you don't want to add links +manually. +If there is linkend on +glossterm then is used instead of autogeneration of +link. + + + + + + +firstterm.only.link +boolean + +firstterm.only.link +Does automatic glossterm linking only apply to firstterms? + + +Description + +If true, only firstterms will be automatically linked +to the glossary. If glossary linking is not enabled, this parameter +has no effect. + + + + + + +glossary.collection +string + +glossary.collection +Name of the glossary collection file + + +Description + +Glossaries maintained independently across a set of documents +are likely to become inconsistent unless considerable effort is +expended to keep them in sync. It makes much more sense, usually, to +store all of the glossary entries in a single place and simply +extract the ones you need in each document. + +That's the purpose of the +glossary.collection parameter. To setup a global +glossary database, follow these steps: + +Setting Up the Glossary Database + +First, create a stand-alone glossary document that contains all of +the entries that you wish to reference. Make sure that each glossary +entry has an ID. + +Here's an example glossary: + + + +<?xml version="1.0" encoding="utf-8"?> +<!DOCTYPE glossary + PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<glossary> +<glossaryinfo> +<editor><firstname>Eric</firstname><surname>Raymond</surname></editor> +<title>Jargon File 4.2.3 (abridged)</title> +<releaseinfo>Just some test data</releaseinfo> +</glossaryinfo> + +<glossdiv><title>0</title> + +<glossentry> +<glossterm>0</glossterm> +<glossdef> +<para>Numeric zero, as opposed to the letter `O' (the 15th letter of +the English alphabet). In their unmodified forms they look a lot +alike, and various kluges invented to make them visually distinct have +compounded the confusion. If your zero is center-dotted and letter-O +is not, or if letter-O looks almost rectangular but zero looks more +like an American football stood on end (or the reverse), you're +probably looking at a modern character display (though the dotted zero +seems to have originated as an option on IBM 3270 controllers). If +your zero is slashed but letter-O is not, you're probably looking at +an old-style ASCII graphic set descended from the default typewheel on +the venerable ASR-33 Teletype (Scandinavians, for whom /O is a letter, +curse this arrangement). (Interestingly, the slashed zero long +predates computers; Florian Cajori's monumental "A History of +Mathematical Notations" notes that it was used in the twelfth and +thirteenth centuries.) If letter-O has a slash across it and the zero +does not, your display is tuned for a very old convention used at IBM +and a few other early mainframe makers (Scandinavians curse <emphasis>this</emphasis> +arrangement even more, because it means two of their letters collide). +Some Burroughs/Unisys equipment displays a zero with a <emphasis>reversed</emphasis> +slash. Old CDC computers rendered letter O as an unbroken oval and 0 +as an oval broken at upper right and lower left. And yet another +convention common on early line printers left zero unornamented but +added a tail or hook to the letter-O so that it resembled an inverted +Q or cursive capital letter-O (this was endorsed by a draft ANSI +standard for how to draw ASCII characters, but the final standard +changed the distinguisher to a tick-mark in the upper-left corner). +Are we sufficiently confused yet?</para> +</glossdef> +</glossentry> + +<glossentry> +<glossterm>1TBS</glossterm> +<glossdef> +<para role="accidence"> +<phrase role="pronounce"></phrase> +<phrase role="partsofspeach">n</phrase> +</para> +<para>The "One True Brace Style"</para> +<glossseealso>indent style</glossseealso> +</glossdef> +</glossentry> + +<!-- ... --> + +</glossdiv> + +<!-- ... --> + +</glossary> + + + + +Marking Up Glossary Terms + +That takes care of the glossary database, now you have to get the entries +into your document. Unlike bibliography entries, which can be empty, creating +placeholder glossary entries would be very tedious. So instead, +support for glossary.collection relies on implicit linking. + +In your source document, simply use firstterm and +glossterm to identify the terms you wish to have included +in the glossary. The stylesheets assume that you will either set the +baseform attribute correctly, or that the +content of the element exactly matches a term in your glossary. + +If you're using a glossary.collection, don't +make explicit links on the terms in your document. + +So, in your document, you might write things like this: + + +<para>This is dummy text, without any real meaning. +The point is simply to reference glossary terms like <glossterm>0</glossterm> +and the <firstterm baseform="1TBS">One True Brace Style (1TBS)</firstterm>. +The <glossterm>1TBS</glossterm>, as you can probably imagine, is a nearly +religious issue.</para> + + +If you set the firstterm.only.link parameter, +only the terms marked with firstterm will be links. +Otherwise, all the terms will be linked. + + + +Marking Up the Glossary + +The glossary itself has to be identified for the stylesheets. For lack +of a better choice, the role is used. +To identify the glossary as the target for automatic processing, set +the role to auto. The title of this +glossary (and any other information from the glossaryinfo +that's rendered by your stylesheet) will be displayed, but the entries will +come from the database. + + +Unfortunately, the glossary can't be empty, so you must put in +at least one glossentry. The content of this entry +is irrelevant, it will not be rendered: + + +<glossary role="auto"> +<glossentry> +<glossterm>Irrelevant</glossterm> +<glossdef> +<para>If you can see this, the document was processed incorrectly. Use +the <parameter>glossary.collection</parameter> parameter.</para> +</glossdef> +</glossentry> +</glossary> + + +What about glossary divisions? If your glossary database has glossary +divisions and your automatic glossary contains at least +one glossdiv, the automic glossary will have divisions. +If the glossdiv is missing from either location, no divisions +will be rendered. + +Glossary entries (and divisions, if appropriate) in the glossary will +occur in precisely the order they occur in your database. + + + +Formatting the Document + +Finally, when you are ready to format your document, simply set the +glossary.collection parameter (in either a +customization layer or directly through your processor's interface) to +point to your global glossary. + +The stylesheets will format the glossary in your document as if +all of the entries implicilty referenced appeared there literally. + + +Limitations + +Glossary cross-references within the glossary are +not supported. For example, this will not work: + + +<glossentry> +<glossterm>gloss-1</glossterm> +<glossdef><para>A description that references <glossterm>gloss-2</glossterm>.</para> +<glossseealso>gloss-2</glossseealso> +</glossdef> +</glossentry> + + +If you put glossary cross-references in your glossary that way, +you'll get the cryptic error: Warning: +glossary.collection specified, but there are 0 automatic +glossaries. + +Instead, you must do two things: + + + +Markup your glossary using glossseealso: + + +<glossentry> +<glossterm>gloss-1</glossterm> +<glossdef><para>A description that references <glossterm>gloss-2</glossterm>.</para> +<glossseealso>gloss-2</glossseealso> +</glossdef> +</glossentry> + + + + +Make sure there is at least one glossterm reference to +gloss-2 in your document. The +easiest way to do that is probably within a remark in your +automatic glossary: + + +<glossary role="auto"> +<remark>Make sure there's a reference to <glossterm>gloss-2</glossterm>.</remark> +<glossentry> +<glossterm>Irrelevant</glossterm> +<glossdef> +<para>If you can see this, the document was processed incorrectly. Use +the <parameter>glossary.collection</parameter> parameter.</para> +</glossdef> +</glossentry> +</glossary> + + + + + + + + + + +glossentry.show.acronym +list + +glossentry.show.acronym +Display glossentry acronyms? + + +Description + +A setting of yes means they should be displayed; +no means they shouldn't. If primary is used, +then they are shown as the primary text for the entry. + + +This setting controls both acronym and +abbrev elements in the glossentry. + + + + + + + +formal.procedures +boolean + +formal.procedures +Selects formal or informal procedures + + +Description + +Formal procedures are numbered and always have a title. + + + + + + + +formal.title.placement + + +formal.title.placement +Specifies where formal object titles should occur + + +Description + +Specifies where formal object titles should occur. For each formal object +type (figure, +example, +equation, +table, and procedure) +you can specify either the keyword +before or +after. + + + + +figure before +example before +equation before +table before +procedure before +task before + + + +runinhead.default.title.end.punct +string + +runinhead.default.title.end.punct +Default punctuation character on a run-in-head + + +Description + +FIXME: + + + + + + + +runinhead.title.end.punct +string + +runinhead.title.end.punct +Characters that count as punctuation on a run-in-head + + +Description + +FIXME: + + + + + + + +show.comments +boolean + +show.comments +Display comment elements? + + +Description + +If true (non-zero), comments will be displayed, otherwise they are suppressed. +Comments here refers to the comment element, +which will be renamed remark in DocBook V4.0, +not XML comments (<-- like this -->) which are unavailable. + + + + +1 + + +show.revisionflag +boolean + +show.revisionflag +Enable decoration of elements that have a revisionflag + + +Description + + +If show.revisionflag is turned on, then the stylesheets +may produce additional markup designed to allow a CSS stylesheet to +highlight elements that have specific revisionflag settings. + +The markup inserted will be usually be either a <span> or <div> +with an appropriate class attribute. (The value of +the class attribute will be the same as the value of the revisionflag +attribute). In some contexts, for example tables, where extra markup +would be structurally illegal, the class attribute will be added to the +appropriate container element. + +In general, the stylesheets only test for revisionflag in contexts +where an importing stylesheet would have to redefine whole templates. +Most of the revisionflag processing is expected to be done by another +stylesheet, for example changebars.xsl. + + + +0 + + +shade.verbatim +boolean + +shade.verbatim +Should verbatim environments be shaded? + + +Description + +In the FO stylesheet, if this parameter is non-zero then the +shade.verbatim.style properties will be applied +to verbatim environments. + +In the HTML stylesheet, this parameter is now deprecated. Use +CSS instead. + + + + + + +shade.verbatim.style + + +shade.verbatim.style +Properties that specify the style of shaded verbatim listings + + +Description + +FIXME: + + + + + 0 + #E0E0E0 + + + + +punct.honorific +string + +punct.honorific +Punctuation after an honorific in a personal name. + + +Description + +This parameter specifies the punctuation that should be added after an +honorific in a personal name. + + + + + + +tex.math.in.alt +string + +tex.math.in.alt +TeX notation used for equations + + +Description + +If you want type math directly in TeX notation in equations, +this parameter specifies notation used. Currently are supported two +values -- plain and latex. Empty +value means that you are not using TeX math at all. + +Preferred way for including TeX alternative of math is inside of +textobject element. Eg.: + +<inlineequation> +<inlinemediaobject> +<imageobject> +<imagedata fileref="eq1.gif"/> +</imageobject> +<textobject><phrase>E=mc squared</phrase></textobject> +<textobject role="tex"><phrase>E=mc^2</phrase></textobject> +</inlinemediaobject> +</inlineequation> + +If you are using graphic element, you can +store TeX inside alt element: + +<inlineequation> +<alt role="tex">a^2+b^2=c^2</alt> +<graphic fileref="a2b2c2.gif"/> +</inlineequation> + +If you want use this feature, you should process your FO with +PassiveTeX, which only supports TeX math notation. When calling +stylsheet, don't forget to specify also +passivetex.extensions=1. + +If you want equations in HTML, just process generated file +tex-math-equations.tex by TeX or LaTeX. Then run +dvi2bitmap program on result DVI file. You will get images for +equations in your document. + + + + + + +tex.math.file +string + +tex.math.file +Name of temporary file for generating images from equations + + +Description + +Name of auxiliary file for TeX equations. This file can be +processed by dvi2bitmap to get bitmap versions of equations for HTML +output. + + + + + + +tex.math.delims +boolean + +tex.math.delims +Should be equations outputed for processing by TeX +automatically surrounded by math mode delimiters + + +Description + +For compatibility with DSSSL based DBTeXMath from Allin Cottrell +you should set this parameter to 0. + + + + + + +pixels.per.inch +integer + +pixels.per.inch +How many pixels are there per inch? + + +Description + +When lengths are converted to pixels, this value is used to +determine the size of a pixel. The default value is taken from the +XSL +Recommendation. + + + + + + + +points.per.em +number + +points.per.em +Specify the nominal size of an em-space in points + + +Description + +FIXME: + + + + + + +use.svg +boolean + +use.svg +Allow SVG in the result tree? + + +Description + +If non-zero, SVG will be considered an acceptable image format. SVG +is passed through to the result tree, so correct rendering of the resulting +diagram depends on the formatter (FO processor or web browser) that is used +to process the output from the stylesheet. + + + + + + +menuchoice.separator + + +menuchoice.separator +Separator between items of a menuchoice +other than guimenuitem and +guisubmenu + + +Description + +Separator used to connect items of a menuchoice other +than guimenuitem and guisubmenu. The latter +elements are linked with menuchoice.menu.separator. + + + + + + + +menuchoice.menu.separator + + +menuchoice.menu.separator +Separator between items of a menuchoice +with guimenuitem or +guisubmenu + + +Description + +Separator used to connect items of a menuchoice with +guimenuitem or guisubmenu. Other elements +are linked with menuchoice.separator. + +The default value is &#x2192;, which is the +&rarr; (right arrow) character entity. +The current FOP (0.20.5) requires setting the font-family +explicitly. + +The default value also includes spaces around the arrow, +which will allow a line to break. Replace the spaces with +&#xA0; (nonbreaking space) if you don't want those +spaces to break. + + + + + → + + +default.float.class +string + +default.float.class +Specifies the default float class + + +Description + +FIXME: + + + + + + left + before + + + + +footnote.number.format +string + +footnote.number.format +Identifies the format used for footnote numbers + + +Description + +The footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A). + + + + + + +table.footnote.number.format +string + +table.footnote.number.format +Identifies the format used for footnote numbers in tables + + +Description + +The table.footnote.number.format specifies the format +to use for footnote numeration (1, i, I, a, or A) in tables. + + + + + + +footnote.number.symbols + + +footnote.number.symbols +Special characters to use as footnote markers + + +Description + +If footnote.number.symbols is not the empty string, +footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + + + + +table.footnote.number.symbols + + +table.footnote.number.symbols +Special characters to use a footnote markers in tables + + +Description + +If table.footnote.number.symbols is not the empty string, +table footnotes will use the characters it contains as footnote symbols. For example, +*&#x2020;&#x2021;&#x25CA;&#x2720; will identify +footnotes with *, †, ‡, +◊, and ✠. If there are more footnotes +than symbols, the stylesheets will fall back to numbered footnotes using +table.footnote.number.format. + +The use of symbols for footnotes depends on the ability of your +processor (or browser) to render the symbols you select. Not all systems are +capable of displaying the full range of Unicode characters. If the quoted characters +in the preceding paragraph are not displayed properly, that's a good indicator +that you may have trouble using those symbols for footnotes. + + + + + + +annotation.support +boolean + +annotation.support +Enable annotations? + + +Description + +If non-zero, the stylesheets will attempt to support annotation +elements in HTML by including some JavaScript (see +annotation.js). + + + + + + +annotation.js +boolean + +annotation.js +Enable annotations? + + +Description + +If annotation.support is enabled and the +document contains annotations, then the URIs listed +in this parameter will be included. These JavaScript files are required +for popup annotation support. + + + + + + +annotation.css +boolean + +annotation.css +Enable annotations? + + +Description + +If annotation.support is enabled and the +document contains annotations, then the CSS in this +parameter will be included in the document. + + + + +/* ====================================================================== + Annotations +*/ + +div.annotation-list { visibility: hidden; + } + +div.annotation-nocss { position: absolute; + visibility: hidden; + } + +div.annotation-popup { position: absolute; + z-index: 4; + visibility: hidden; + padding: 0px; + margin: 2px; + border-style: solid; + border-width: 1px; + width: 200px; + background-color: white; + } + +div.annotation-title { padding: 1px; + font-weight: bold; + border-bottom-style: solid; + border-bottom-width: 1px; + color: white; + background-color: black; + } + +div.annotation-body { padding: 2px; + } + +div.annotation-body p { margin-top: 0px; + padding-top: 0px; + } + +div.annotation-close { position: absolute; + top: 2px; + right: 2px; + } + + + +annotation.graphic.open +boolean + +annotation.graphic.open +Enable annotations? + + +Description + +This image is used inline to identify the location of +annotations. + + + + + + +annotation.graphic.close +boolean + +annotation.graphic.close +Enable annotations? + + +Description + +This image is used on popup annotations as the “x” that the +user can click to dismiss the popup. + + + + + + +img.src.path +string + +img.src.path +Path to HTML image files + + +Description + +Add a path prefix to each HTML +img or FO +fo:external-graphics element's +src attribute. +This path could relative to the directory where the HTML/FO +files are created, or it could be an absolute URI. +The default value is empty. +Be sure to include a trailing slash if needed. + +This prefix is not applied to any filerefs that start +with "/" or contain "//:". + + + + + + + +keep.relative.image.uris +boolean + +keep.relative.image.uris +Should image URIs be resolved against xml:base? + + +Description + +If non-zeor, relative URIs (in, for example fileref attributes) will +be used in the generated output. Otherwise, the URIs will be made absolute +with respect to the base URI. + +Note that the stylesheets calculate (and use) the absolute form +for some purposes, this only applies to the resulting output. + + + + + + + +graphic.default.extension +string + +graphic.default.extension +Default extension for graphic filenames + + +Description + +If a graphic or mediaobject +includes a reference to a filename that does not include an extension, +and the format attribute is +unspecified, the default extension will be used. + + + + + + + +default.image.width +length + +default.image.width +The default width of images + + +Description + +If specified, this value will be used for the +width attribute on +images that do not specify any +viewport +dimensions. + + + + + + +nominal.image.width +length + +nominal.image.width +The nominal image width + + +Description + +Graphic widths expressed as a percentage are problematic. In the +following discussion, we speak of width and contentwidth, but +the same issues apply to depth and contentdepth. + +A width of 50% means "half of the available space for the image." +That's fine. But note that in HTML, this is a dynamic property and +the image size will vary if the browser window is resized. + +A contentwidth of 50% means "half of the actual image width". +But what does that mean if the stylesheets cannot assess the image's +actual size? Treating this as a width of 50% is one possibility, but +it produces behavior (dynamic scaling) that seems entirely out of +character with the meaning. + +Instead, the stylesheets define a +nominal.image.width and convert percentages to +actual values based on that nominal size. + + + + + + +nominal.image.depth +length + +nominal.image.depth +Nominal image depth + + +Description + +See nominal.image.width. + + + + + + +use.embed.for.svg +boolean + +use.embed.for.svg +Use HTML embed for SVG? + + +Description + +If non-zero, an embed element will be created for +SVG figures. An object is always created, +this parameter merely controls whether or not an additional embed +is generated inside the object. + +On the plus side, this may be more portable among browsers and plug-ins. +On the minus side, it isn't valid HTML. + + + + + + +make.graphic.viewport +boolean + +make.graphic.viewport +Use tables in HTML to make viewports for graphics + + +Description + +The HTML img element only supports the notion +of content-area scaling; it doesn't support the distinction between a +content-area and a viewport-area, so we have to make some compromises. + +If make.graphic.viewport is non-zero, a table +will be used to frame the image. This creates an effective viewport-area. + + +Tables and alignment don't work together, so this parameter is ignored +if alignment is specified on an image. + + + + + +preferred.mediaobject.role + +preferred.mediaobject.role +Select which mediaobject to use based on +this value of an object's role attribute. + + + +Description + +A mediaobject may contain several objects such as imageobjects. +If the parameter use.role.for.mediaobject +is non-zero, then the role attribute on +imageobjects and other objects within a mediaobject container will be used to select which object will be +used. If one of the objects has a role value that matches the +preferred.mediaobject.role parameter, then it has first +priority for selection. If more than one has such a +role value, the first one is used. + + +See the use.role.for.mediaobject parameter +for the sequence of selection. + + + + + +use.role.for.mediaobject +boolean + +use.role.for.mediaobject +Use role attribute +value for selecting which of several objects within a mediaobject to use. + + + +Description + +If non-zero, the role attribute on +imageobjects or other objects within a mediaobject container will be used to select which object will be +used. + + +The order of selection when then parameter is non-zero is: + + + + If the stylesheet parameter preferred.mediaobject.role has a value, then the object whose role equals that value is selected. + + +Else if an object's role attribute has a value of +html for HTML processing or +fo for FO output, then the first +of such objects is selected. + + + +Else the first suitable object is selected. + + + +If the value of +use.role.for.mediaobject +is zero, then role attributes are not considered +and the first suitable object +with or without a role value is used. + + + + + + +ignore.image.scaling +boolean + +ignore.image.scaling +Tell the stylesheets to ignore the author's image scaling attributes + + +Description + +If non-zero, the scaling attributes on graphics and media objects are +ignored. + + + + + + +chunker.output.cdata-section-elements +string + +chunker.output.cdata-section-elements +List of elements to escape with CDATA sections +<xsl:param name="chunker.output.cdata-section-elements" select="''"/> +Description + +This parameter specifies the list of elements that should be escaped +as CDATA sections by the chunking stylesheet. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.doctype-public +string + +chunker.output.doctype-public +Public identifer to use in the document type of generated pages +<xsl:param name="chunker.output.doctype-public" select="''"/> +Description + +This parameter specifies the public identifier that should be used by +the chunking stylesheet in the document type declaration of chunked pages. +Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.doctype-system +uri + +chunker.output.doctype-system +System identifier to use for the document type in generated pages +<xsl:param name="chunker.output.doctype-system" select="''"/> +Description + +This parameter specifies the system identifier that should be used by +the chunking stylesheet in the document type declaration of chunked pages. +Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.encoding +string + +chunker.output.encoding +Encoding used in generated pages +<xsl:param name="chunker.output.encoding" select="'ISO-8859-1'"/> +Description + +This parameter specifies the encoding to be used in files +generated by the chunking stylesheet. Not all processors support +specification of this parameter. + + +This parameter used to be named default.encoding. + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.indent +string + +chunker.output.indent +Specification of indentation on generated pages +<xsl:param name="chunker.output.indent" select="'no'"/> +Description + +This parameter specifies the value of the indent +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.media-type +string + +chunker.output.media-type +Media type to use in generated pages +<xsl:param name="chunker.output.media-type" select="''"/> +Description + +This parameter specifies the media type that should be used by +the chunking stylesheet. Not all processors support specification of +this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.method +list +html +xml + +chunker.output.method +Method used in generated pages +<xsl:param name="chunker.output.method" select="'html'"/> +Description + +This parameter specifies the output method to be used in files +generated by the chunking stylesheet. + + +This parameter used to be named output.method. + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.omit-xml-declaration + + +chunker.output.omit-xml-declaration +Omit-xml-declaration for generated pages +<xsl:param name="chunker.output.omit-xml-declaration" select="'no'"/> +Description + +This parameter specifies the value of the omit-xml-declaration +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +chunker.output.standalone +string + +chunker.output.standalone +Standalone declaration for generated pages +<xsl:param name="chunker.output.standalone" select="'no'"/> +Description + +This parameter specifies the value of the standalone +specification for generated pages. Not all processors support +specification of this parameter. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +saxon.character.representation +string + +saxon.character.representation +Saxon character representation used in generated HTML pages +<xsl:param name="saxon.character.representation" select="'entity;decimal'"/> +Description + +This character representation is used in files generated by chunking stylesheet. If +you want to suppress entity references for characters with direct representation +in default.encoding, set this parameter to value native. + + + +This parameter is documented here, but the declaration is actually +in the chunker.xsl stylesheet module. + + + + + + + +html.ext + + +html.ext +Identifies the extension of generated HTML files + + +Description + +The extension identified by html.ext will +be used as the filename extension for chunks created by this stylesheet. + + + + + + + +use.id.as.filename +boolean + +use.id.as.filename +Use ID value of chunk elements as the filename? + + +Description + +If use.id.as.filename +is non-zero, the filename of chunk elements that have IDs will be +derived from the ID value. + + + + + + + +html.extra.head.links +boolean + +html.extra.head.links +Toggle extra HTML head link information + + +Description + +If non-zero, extra link elements will be +generated in the head of chunked HTML files. These +extra links point to chapters, appendixes, sections, etc. as supported +by the Site Navigation Bar in Mozilla 1.0 (as of CR1, at least). + + + + + + + +root.filename + + +root.filename +Identifies the name of the root HTML file when chunking + + +Description + +The root.filename is the base filename for +the chunk created for the root of each document processed. + + + + + + + +base.dir + + +base.dir +The base directory of chunks + + +Description + +If specified, the base.dir identifies +the output directory for chunks. (If not specified, the output directory +is system dependent.) + + + + + + + generate.manifest + boolean + + generate.manifest + Generate a manifest file? + + + Description + + If non-zero, a list of HTML files generated by the + stylesheet transformation is written to the file named by + the manifest parameter. + + + + + + + manifest + string + + manifest + Name of manifest file + + + Description + + The name of the file to which a manifest is written (if the + value of the generate.manifest parameter + is non-zero). + + + + + + +manifest.in.base.dir +boolean + +manifest.in.base.dir +Should be manifest file written in $base.dir? + + +Description + +If non-zero manifest file and project files for HTML Help and +Eclipse Help are written into base.dir instead +of current directory. + + + + + + +chunk.toc +string + +chunk.toc +An explicit TOC to be used for chunking + + +Description + +The chunk.toc identifies an explicit TOC that +will be used for chunking. This parameter is only used by the +chunktoc.xsl stylesheet (and customization layers built +from it). + + + + + + +chunk.tocs.and.lots +boolean + +chunk.tocs.and.lots +Should ToC and LoTs be in separate chunks? + + +Description + +If non-zero, ToC and LoT (List of Examples, List of Figures, etc.) +will be put in a separate chunk. At the moment, this chunk is not in the +normal forward/backward navigation list. Instead, a new link is added to the +navigation footer. + +This feature is still somewhat experimental. Feedback welcome. + + + + + + +chunk.separate.lots +boolean + +chunk.separate.lots +Should each LoT be in its own separate chunk? + + +Description + +If non-zero, each of the ToC and LoTs +(List of Examples, List of Figures, etc.) +will be put in its own separate chunk. +The title page includes generated links to each of the separate files. + + +This feature depends on the +chunk.tocs.and.lots +parameter also being non-zero. + + + + + + + +chunk.tocs.and.lots.has.title +boolean + +chunk.tocs.and.lots.has.title +Should ToC and LoTs in a separate chunks have title? + + +Description + +If non-zero title of document is shown before ToC/LoT in +separate chunk. + + + + + + +chunk.section.depth +integer + +chunk.section.depth +Depth to which sections should be chunked + + +Description + +This parameter sets the depth of section chunking. + + + + + + +chunk.first.sections + + +chunk.first.sections +Chunk the first top-level section? + + +Description + +If non-zero, a chunk will be created for the first top-level +sect1 or section elements in +each component. Otherwise, that section will be part of the chunk for +its parent. + + + + + + + +chunk.quietly + + +chunk.quietly +Omit the chunked filename messages. + + +Description + +If zero (the default), the XSL processor emits a message naming +each separate chunk filename as it is being output. +If nonzero, then the messages are suppressed. + + + + + + + +navig.graphics +boolean + +navig.graphics +Use graphics in navigational headers and footers? + + +Description + +If true (non-zero), the navigational headers and footers in chunked +HTML are presented in an alternate style that uses +graphical icons for Next, Previous, Up, and Home. +Default graphics are provided in the distribution. + + + + + + + +navig.graphics.extension +string + +navig.graphics.extension +Extension for navigational graphics + + +Description + +Sets the filename extension to use on navigational graphics used +in the headers and footers of chunked HTML. + + + + + + +navig.graphics.path +string + +navig.graphics.path +Path to navigational graphics + + +Description + +Sets the path, probably relative to the directory where the HTML +files are created, to the navigational graphics used in the +headers and footers of chunked HTML. + + + + +images/ + + +navig.showtitles +boolean + +navig.showtitles +Display titles in HTML headers and footers? + + +Description + +If true (non-zero), +the headers and footers of chunked HTML +display the titles of the next and previous chunks, +along with the words 'Next' and 'Previous' (or the +equivalent graphical icons if navig.graphics is true). +If false (zero), then only the words 'Next' and 'Previous' +(or the icons) are displayed. + + + + +1 + + +profile.arch +string + +profile.arch +Target profile for arch +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.condition +string + +profile.condition +Target profile for condition +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.conformance +string + +profile.conformance +Target profile for conformance +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.lang +string + +profile.lang +Target profile for lang +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.os +string + +profile.os +Target profile for os +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.revision +string + +profile.revision +Target profile for revision +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.revisionflag +string + +profile.revisionflag +Target profile for revisionflag +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.role +string + +profile.role +Target profile for role +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + +Note that role is often +used for other purposes than profiling. For example it is commonly +used to get emphasize in bold font: + +<emphasis role="bold">very important</emphasis> + +If you are using role for +these purposes do not forget to add values like bold to +value of this parameter. If you forgot you will get document with +small pieces missing which are very hard to track. + +For this reason it is not recommended to use role attribute for profiling. You should +rather use profiling specific attributes like userlevel, os, arch, condition, etc. + + + + + + + +profile.security +string + +profile.security +Target profile for security +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.userlevel +string + +profile.userlevel +Target profile for userlevel +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.vendor +string + +profile.vendor +Target profile for vendor +attribute + + +Description + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.attribute +string + +profile.attribute +Name of user-specified profiling attribute + + +Description + +This parameter is used in conjuction with profile.value. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.value +string + +profile.value +Target profile for user-specified attribute + + +Description + +When you are using this parameter you must also specify name of +profiling attribute with parameter profile.attribute. + +Value of this parameter specifies profiles which should be +included in the output. You can specify multiple profiles by +separating them by semicolon. You can change separator character by +profile.separator +parameter. + +This parameter has effect only when you are using profiling +stylesheets (profile-docbook.xsl, +profile-chunk.xsl, …) instead of normal +ones (docbook.xsl, +chunk.xsl, …). + + + + + + +profile.separator +string + +profile.separator +Separator character for compound profile values + + +Description + +Separator character for compound profile values. + + + + + + +htmlhelp.encoding +string + +htmlhelp.encoding +Character encoding to use in files for HTML Help compiler. + + +Description + +HTML Help Compiler is not UTF-8 aware, so you should always use +apropriate single-byte encoding here. + + + + + + +htmlhelp.autolabel +boolean + +htmlhelp.autolabel +Should tree-like ToC use autonumbering feature? + + +Description + +If you want to include chapter and section numbers into ToC in +the left panel, set this parameter to 1. + + + + + + +htmlhelp.chm +string + +htmlhelp.chm +Filename of output HTML Help file. + + +Description + +Change this parameter if you want different name of result +CHM file than htmlhelp.chm. + + + + + + +htmlhelp.default.topic +string + +htmlhelp.default.topic +Name of file with default topic + + +Description + +Normally first chunk of document is displayed when you open HTML +Help file. If you want to display another topic, simply set its +filename by this parameter. + +This is useful especially if you don't generate ToC in front of +your document and you also hide root element in ToC. E.g.: + +<xsl:param name="generate.book.toc" select="0"/> +<xsl:param name="htmlhelp.hhc.show.root" select="0"/> +<xsl:param name="htmlhelp.default.topic" select="'pr01.html'"/> + + + + + + +htmlhelp.display.progress +boolean + +htmlhelp.display.progress +Display compile progress? + + +Description + +You can swith off display of compile progress by setting this +parameter to 0. + + + + + + +htmlhelp.hhp +string + +htmlhelp.hhp +Filename of project file. + + +Description + +Change this parameter if you want different name of project +file than htmlhelp.hhp. + + + + + + +htmlhelp.hhc +string + +htmlhelp.hhc +Filename of TOC file. + + +Description + +Change this parameter if you want different name of TOC file +than toc.hhc. + + + + + + +htmlhelp.hhk +string + +htmlhelp.hhk +Filename of index file. + + +Description + +Change this parameter if you want different name of index file +than index.hhk. + + + + + + +htmlhelp.hhp.tail +string + +htmlhelp.hhp.tail +Additional content for project file. + + +Description + +If you want to include some additional parameters into project file, +store appropriate part of project file into this parameter. + + + + + + +htmlhelp.hhp.window +string + +htmlhelp.hhp.window +Name of default window. + + +Description + +Name of default window. If empty no [WINDOWS] section will be +added to project file. + + + + + + +htmlhelp.hhp.windows +string + +htmlhelp.hhp.windows +Definition of additional windows + + +Description + +Content of this parameter is placed at the end of [WINDOWS] +section of project file. You can use it for defining your own +addtional windows. + + + + + + +htmlhelp.enhanced.decompilation +boolean + +htmlhelp.enhanced.decompilation +Allow enhanced decompilation of CHM? + + +Description + +When set to 1 this parameter enables enhanced decompilation of CHM. + + + + + + +htmlhelp.enumerate.images +boolean + +htmlhelp.enumerate.images +Should be paths to all used images added to project file? + + +Description + +You should turn on this flag, if you insert images into your documents +as external binary entities or if you are using absolute path in image names. + + + + + + +htmlhelp.force.map.and.alias +boolean + +htmlhelp.force.map.and.alias +Should be [MAP] and [ALIAS] section added to project file unconditionaly? + + +Description + +You should turn on this flag, if you have your own +alias.h and contex.h files +and you want include reference to them in project file. + + + + + + +htmlhelp.map.file +string + +htmlhelp.map.file +Filename of map file. + + +Description + +Change this parameter if you want different name of map file +than context.h. + + + + + + +htmlhelp.alias.file +string + +htmlhelp.alias.file +Filename of map file. + + +Description + +Change this parameter if you want different name of map file +than alias.h. + + + + + + +htmlhelp.hhc.section.depth +integer + +htmlhelp.hhc.section.depth +Depth of TOC for sections in a left pane. + + +Description + +Change this parameter if you want shallower ToC in a left pane +of HTML Help viewer. + + + + + + +htmlhelp.hhc.show.root +boolean + +htmlhelp.hhc.show.root +Should be entry for root element shown in ToC? + + +Description + +If set to 0, there will be no entry for root element in +ToC. This is useful when you want provide user with expanded ToC as +a default. + + + + + + +htmlhelp.hhc.folders.instead.books + + +htmlhelp.hhc.folders.instead.books +Use folder icons in ToC (instead of book icons)? + + +Description + +This parameter controls whether there should be folder-like +icons (1) or book-like icons (0) in ToC. If you want to use +folder-like icons you must swith off binary ToC using +htmlhelp.hhc.binary. + + + + + + +htmlhelp.hhc.binary + + +htmlhelp.hhc.binary +Generate binary ToC? + + +Description + +This parametr controls whether binary TOC will be generated. You +must create binary TOC if you want to add Prev/Next buttons to toolbar +(which is default behaviour). Files with binary TOC can't be merged. + + + + + + +htmlhelp.hhc.width +integer + +htmlhelp.hhc.width +Width of navigation (ToC) pane + + +Description + +This parameter specifies width of ToC pane in pixels. + + + + + + +htmlhelp.title +string + +htmlhelp.title +Title of HTML Help + + +Description + +Content of this parameter will be used as a title for generated +HTML Help. If empty, title will be automatically taken from document. + + + + + + +htmlhelp.show.menu +boolean + +htmlhelp.show.menu +Should be menu shown? + + +Description + +If you want application menu in your HTML Help file, turn this +parameter to 1. + + + + + + +htmlhelp.show.toolbar.text +boolean + +htmlhelp.show.toolbar.text +Show text under toolbar buttons? + + +Description + +You can switch off display of texts under toolbar buttons by +setting this parameter to 0. + + + + + + +htmlhelp.show.advanced.search +boolean + +htmlhelp.show.advanced.search +Should be advanced search available? + + +Description + +If you want advanced search features in your help, turn this +parameter to 1. + + + + + + +htmlhelp.show.favorities +boolean + +htmlhelp.show.favorities +Should be favorities tab shown? + + +Description + +If you want favorities tab shown in your help, turn this +parameter to 1. + + + + + + +htmlhelp.button.hideshow +boolean + +htmlhelp.button.hideshow +Should be Hide/Show button shown? + + +Description + +If you want Hide/Show button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.back +boolean + +htmlhelp.button.back +Should be Back button shown? + + +Description + +If you want Back button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.forward +boolean + +htmlhelp.button.forward +Should be Forward button shown? + + +Description + +If you want Forward button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.stop +boolean + +htmlhelp.button.stop +Should be Stop button shown? + + +Description + +If you want Stop button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.refresh +boolean + +htmlhelp.button.refresh +Should be Refresh button shown? + + +Description + +If you want Refresh button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.home +boolean + +htmlhelp.button.home +Should be Home button shown? + + +Description + +If you want Home button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.home.url +string + +htmlhelp.button.home.url +URL address of page accessible by Home button + + +Description + +URL address of page accessible by Home button. + + + + + + +htmlhelp.button.options +boolean + +htmlhelp.button.options +Should be Options button shown? + + +Description + +If you want Options button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.print +boolean + +htmlhelp.button.print +Should be Print button shown? + + +Description + +If you want Print button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.locate +boolean + +htmlhelp.button.locate +Should be Locate button shown? + + +Description + +If you want Locate button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.jump1 +boolean + +htmlhelp.button.jump1 +Should be Jump1 button shown? + + +Description + +If you want Jump1 button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.jump1.url +string + +htmlhelp.button.jump1.url +URL address of page accessible by Jump1 button + + +Description + +URL address of page accessible by Jump1 button. + + + + + + +htmlhelp.button.jump1.title +string + +htmlhelp.button.jump1.title +Title of Jump1 button + + +Description + +Title of Jump1 button. + + + + + + +htmlhelp.button.jump2 +boolean + +htmlhelp.button.jump2 +Should be Jump2 button shown? + + +Description + +If you want Jump2 button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.jump2.url +string + +htmlhelp.button.jump2.url +URL address of page accessible by Jump2 button + + +Description + +URL address of page accessible by Jump2 button. + + + + + + +htmlhelp.button.jump2.title +string + +htmlhelp.button.jump2.title +Title of Jump2 button + + +Description + +Title of Jump2 button. + + + + + + +htmlhelp.button.next +boolean + +htmlhelp.button.next +Should be Next button shown? + + +Description + +If you want Next button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.prev +boolean + +htmlhelp.button.prev +Should be Prev button shown? + + +Description + +If you want Prev button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.button.zoom +boolean + +htmlhelp.button.zoom +Should be Zoom button shown? + + +Description + +If you want Zoom button shown on toolbar, turn this +parameter to 1. + + + + + + +htmlhelp.remember.window.position +boolean + +htmlhelp.remember.window.position +Remember help window position? + + +Description + +To remember help window position between starts set this +parameter to 1. + + + + + + +htmlhelp.window.geometry +string + +htmlhelp.window.geometry +Set initial geometry of help window + + +Description + +This parameter specifies initial position of help +window. E.g. + +<xsl:param name="htmlhelp.window.geometry">[160,64,992,704]</xsl:param> + + + + + + +htmlhelp.use.hhk +boolean + +htmlhelp.use.hhk +Should be index built using HHK file? + + +Description + +If non-zero, index is created using HHK file. This provides some +new features. + + + + + + +htmlhelp.only +boolean + +htmlhelp.only +Should be only project files generated? + + +Description + +If you want to play with various HTML Help parameters and you +don't need to regenerate all HTML files, you can set this parameter to +1. This setting will not process whole document, only project files +(hhp, hhc, hhk,...) will be generated. + + + + + + +eclipse.autolabel +boolean + +eclipse.autolabel +Should tree-like ToC use autonumbering feature? + + +Description + +If you want to include chapter and section numbers into ToC in +the left panel, set this parameter to 1. + + + + + + +eclipse.plugin.name +string + +eclipse.plugin.name +Eclipse Help plugin name + + +Description + +Eclipse Help plugin name. + + + +DocBook Online Help Sample + + +eclipse.plugin.id +string + +eclipse.plugin.id +Eclipse Help plugin id + + +Description + +Eclipse Help plugin id. You should change this id to something +unique for each help. + + + +com.example.help + + +eclipse.plugin.provider +string + +eclipse.plugin.provider +Eclipse Help plugin provider name + + +Description + +Eclipse Help plugin provider name. + + + +Example provider + + +l10n.gentext.language +string + +l10n.gentext.language +Sets the gentext language + + +Description + +If this parameter is set to any value other than the empty string, its +value will be used as the value for the language when generating text. Setting +l10n.gentext.language overrides any settings within the +document being formatted. + +It's much more likely that you might want to set the +l10n.gentext.default.language parameter. + + + + + + +l10n.gentext.default.language +string + +l10n.gentext.default.language +Sets the default language for generated text + + +Description + +The value of the l10n.gentext.default.language +parameter is used as the language for generated text if no setting is provided +in the source document. + + + + + + +l10n.gentext.use.xref.language +boolean + +l10n.gentext.use.xref.language +Use the language of target when generating cross-reference text? + + +Description + +If non-zero, the language of the target will be used when +generating cross reference text. Usually, the current +language is used when generating text (that is, the language of the +element that contains the cross-reference element). But setting this parameter +allows the language of the element pointed to to control +the generated text. + +Consider the following example: + + +<para lang="en">See also <xref linkend="chap3"/>.</para> + + + +Suppose that Chapter 3 happens to be written in German. +If l10n.gentext.use.xref.language is non-zero, the +resulting text will be something like this: + +
                  +See also Kapital 3. +
                  + +Where the more traditional rendering would be: + +
                  +See also Chapter 3. +
                  + +                   +                   + + + +l10n.lang.value.rfc.compliant +boolean + +l10n.lang.value.rfc.compliant +Make value of lang attribute RFC compliant? + + +Description + +If non-zero, ensure that the values for all lang attributes in HTML output are RFC +compliantSection 8.1.1, Language Codes, in the HTML 4.0 Recommendation states that: + +
                  [RFC1766] defines and explains the language codes +that must be used in HTML documents. +Briefly, language codes consist of a primary code and a possibly +empty series of subcodes: + +language-code = primary-code ( "-" subcode )* + +And in RFC 1766, Tags for the Identification +of Languages, the EBNF for "language tag" is given as: + +Language-Tag = Primary-tag *( "-" Subtag ) +Primary-tag = 1*8ALPHA +Subtag = 1*8ALPHA + +
                  +                  . + +by taking any underscore characters in any lang values found in source documents, and +replacing them with hyphen characters in output HTML files. For +example, zh_CN in a source document becomes +zh-CN in the HTML output form that source. + + +This parameter does not cause any case change in lang values, because RFC 1766 +explicitly states that all "language tags" (as it calls them) "are +to be treated as case insensitive". + +                   + +                   +                   + +                   diff --git a/src/documentation/docbook-xsl/xhtml/pi.xsl b/src/documentation/docbook-xsl/xhtml/pi.xsl new file mode 100644 index 0000000000..3032d88b07 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/pi.xsl @@ -0,0 +1,252 @@ + + + + + + + + + + + + + + + + + + + filename + + + + + + + + + + + + filename + + + + + + + + + + + + + + + + + + + + + + dir + + + + + + + + + + + + + + / + + + + / + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + +
                  + + + + + +                   +                   +                   + + + + + + No cmdsynopsis elements matched dbcmdlist PI, perhaps it's nested too deep? + + + +
                  + + + +
                  +                   + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + +
                  + + + + + +                   +                   +                   + + + + + + No funcsynopsis elements matched dbfunclist PI, perhaps it's nested too deep? + + + +
                  + + + +
                  +                   + + + + + + + + + + href + + + + + + + + + + + + + + + + + + + + + ERROR: dbhtml-include processing instruction + href has no content. + + + + + + + ERROR: dbhtml-include processing instruction has + missing or empty href value. + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/profile-chunk-code.xsl b/src/documentation/docbook-xsl/xhtml/profile-chunk-code.xsl new file mode 100644 index 0000000000..695b9ffbb6 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/profile-chunk-code.xsl @@ -0,0 +1,757 @@ + + + + + + + + + + + + + + + + + + + + + + Computing chunks... + + + + + Fast chunking requires exsl:node-set(). + Using "slow" chunking. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Error + + is not a chunk! + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Stripping NS from DocBook 5/NG document.Processing stripped document. + + + + + + + + + ID ' + + ' not found in document. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -toc + + + + + + + + + + + +

                  + +

                  +                   + +                   +                   +                   + +                   +                   + + + +                   +                   +                   + + + + + + + + + + + + + -toc + + + + + + + + + + + -toc + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + 1 + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +
                  +
                  + + + + +
                  +                   + + + +
                  +
                  +

                  The following annotations are from this essay. You are seeing + them here because your browser doesn’t support the user-interface + techniques used to make them appear as ‘popups’ on modern browsers.

                  +
                  + + +
                  +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/profile-chunk.xsl b/src/documentation/docbook-xsl/xhtml/profile-chunk.xsl new file mode 100644 index 0000000000..6ec45b855b --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/profile-chunk.xsl @@ -0,0 +1,40 @@ + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/profile-docbook.xsl b/src/documentation/docbook-xsl/xhtml/profile-docbook.xsl new file mode 100644 index 0000000000..874fd6753c --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/profile-docbook.xsl @@ -0,0 +1,390 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No template matches + + + in + + + . + + + + < + + > + + </ + + > + + + + + + + + + + + + + + + + + + + <xsl:copy-of select="$title"/> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Stripping NS from DocBook 5/NG document.Processing stripped document. + + + + + + + + + ID ' + + ' not found in document. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/profile-onechunk.xsl b/src/documentation/docbook-xsl/xhtml/profile-onechunk.xsl new file mode 100644 index 0000000000..c51ff9aede --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/profile-onechunk.xsl @@ -0,0 +1,36 @@ + + + + + + + + + + + + + + + + + +1 + + + + # + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/qandaset.xsl b/src/documentation/docbook-xsl/xhtml/qandaset.xsl new file mode 100644 index 0000000000..32a2694137 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/qandaset.xsl @@ -0,0 +1,351 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1% + + + + + + +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + +
                  +                   + + +
                  +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + +
                  +                   + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/refentry.xsl b/src/documentation/docbook-xsl/xhtml/refentry.xsl new file mode 100644 index 0000000000..35aa633afc --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/refentry.xsl @@ -0,0 +1,297 @@ + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

                  + +

                  +                   + + + + +
                  + + + + + +
                  +
                  +
                  +                   + + + + + + +
                  +                   + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + +
                  + + + + + + + + + + +

                  + + + +

                  +                   + +

                  + + + + + + + + +

                  +                   +                   + +

                  + +

                  +
                  +                   + + + + + + , + + + + + + + + em-dash + + + + + + + + + + + +

                  + + + + : + + + +

                  +                   +                   + + +
                  + + + + +

                  + + + + + + + + + + +

                  + +
                  +                   + + + + + + + + + + + +
                  + + + + + + + + +
                  +                   + + + + + + 0 + 1 + + + + 6 + + + + + + + + + + + + +

                  + +

                  +                   + + + +

                  + +

                  +                   + + + +

                  + +

                  +                   + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/sections.xsl b/src/documentation/docbook-xsl/xhtml/sections.xsl new file mode 100644 index 0000000000..f3049c690b --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/sections.xsl @@ -0,0 +1,531 @@ + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + 1 + 2 + 3 + 4 + 5 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 6 + + + + + + + + + + clear: both + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + 1 + + + + + + + 2 + 3 + 4 + 5 + 6 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/synop.xsl b/src/documentation/docbook-xsl/xhtml/synop.xsl new file mode 100644 index 0000000000..89c04a61df --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/synop.xsl @@ -0,0 +1,1418 @@ + + + + + + + + + + + + + + +
                  +

                  + + +

                  +
                  +                   + + +
                  + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + + + + ( + + ) + +   + + + + + + + + + + + + +

                  + + ( + + ) + + + +

                  +                   + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

                  + + +
                  + +                   +

                  +                   + + + + + ( + + + + + + + + + + + + + + + + ) + ; + + + + ... + ) + ; + + + + + + + , + + + ) + ; + + + + + + + + + + + + + + + + + + + + +
                  + + + + ; +                   + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + + + + + + + + + +
                  + +
                   
                  + + + + padding-bottom: 1em + + +
                  +                   +                   + + + + + ( + + + + + + + + + + + + + + + + + ) + ; + +   + + + + + ... + ) + ; + +   + + + + + + + + , + + + ) + ; + + + +   + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + + + + + + + + + +   + + + + + + ; + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + ; + + + + + + +

                  + +

                  +                   + + + + + ( + + + + + + + + + + + + + + + + void) + ; + + + + ... + ) + ; + + + + + + + , + + + ) + ; + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + + + + + + padding-bottom: 1em + + + + + + + + + + + +
                  + +
                   
                  +                   + + + + + ( + + + + + + + + + + + + + + + + + void) + ; + +   + + + + + ... + ) + ; + +   + + + + + + + +   + + + + + + , + + + ) + ; + + + + + + + +   + + + + + + + , + + + ) + ; + + + + + + + + + + + + + + + + + + + + + + + + ( + + ) + + + + +java + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unrecognized language on + + : + + + + + + + + + + + +
                  +                   +                   + + + + + + 
                  +    
+    
+       extends
+      
+      
+        
                  
+	    
+                        
+                      
+    
+      implements
+      
+      
+        
                  
+	    
+                        
+                      
+    
+      throws
+      
+    
+     {
+    
                  
+    
+    }
+
                  +                   + + + + + + + + + , + + + + + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + 0 + + , +
                  + + +   + + + +                   + + + +                   + + + + + + + + + + + + + +    + + + + + + + + + + + + + + ( + + + + ) + +
                  +     throws  + +                   + + + + + ; +                   + +                   + + + + + 
                  +    
+    
+      : 
+      
+      
+        
                  
+	    
+                        
+                      
+    
+       implements
+      
+      
+        
                  
+	    
+                        
+                      
+    
+       throws
+      
+    
+     {
+    
                  
+    
+    }
+
                  +                   + + + + + + + + , + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + +    + + + + + + + + + + ( + + ) + +
                  +     throws  + +                   + + + + + ; +                   + +                   + + + + + 
                  +    interface 
+    
+    
+      : 
+      
+      
+        
                  
+	    
+                        
+                      
+    
+       implements
+      
+      
+        
                  
+	    
+                        
+                      
+    
+       throws
+      
+    
+     {
+    
                  
+    
+    }
+
                  +                   + + + + + + + + , + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + +    + + + + + + + + + + ( + + ) + +
                  +     raises( + + ) +                   + + + + + ; +                   + +                   + + + + + 
                  +    package 
+    
+    ;
+    
                  
+
+    
+      @ISA = (
+      
+      );
+      
                  
+                      
+
+    
+
                  +                   + + + + + + + + , + + + + + + + + + + +   + + + + + + + , + + + + + + + + + , + + + + + + + + + , + + + + + + + + + +    + + + ; + + + + + + + +   + + + + + + +   + + + + + + =  + + + + + + + void  + + + + + + + + + + + + , + + + + + + + + + + + + + + + + + + + sub + + + { ... }; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/table.xsl b/src/documentation/docbook-xsl/xhtml/table.xsl new file mode 100644 index 0000000000..6b4c6b50d7 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/table.xsl @@ -0,0 +1,1075 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + + + + + + + border- + + : + + + + + + ; + + + + + border- + + -width: + + ; + + + + border- + + -style: + + ; + + + + border- + + -color: + + ; + + + + + + + + + + + Error: CALS tables must specify the number of columns. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 100% + + + + + 0 + + + + border-collapse: collapse; + + + + + + + + + + + + + + + + + + + + + + + + + + + + + border-collapse: collapse; + + + + + + + + + + + + + + + + + border-collapse: collapse; + + + + + + + + + + + border-collapse: collapse; + + + + + + + + + + + border-collapse: collapse; + + + + + + + + + + + + + + + + + border-collapse: collapse; + + + + + + 0 + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + 100% + + + + + + + + + + + + + + + + + + + + + + + + No convertLength function available. + + + + + + + + + + + + + + + + + + + + + + + + + + No adjustColumnWidths function available. + + + + + + + + + + + + + + + + + + + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + th + th + td + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 0 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + : + + + + + + + + 0: + + + + + + + + + + + + + + + 0 + + : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + 1 + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/task.xsl b/src/documentation/docbook-xsl/xhtml/task.xsl new file mode 100644 index 0000000000..0b5f0df470 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/task.xsl @@ -0,0 +1,72 @@ + + + + + + + + + + + + + + + + + + before + + + + + + + + +
                  + + + + + + + + + + + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/titlepage.templates.xsl b/src/documentation/docbook-xsl/xhtml/titlepage.templates.xsl new file mode 100644 index 0000000000..5808ac832d --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/titlepage.templates.xsl @@ -0,0 +1,3622 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + + +
                  + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   + + + + + + + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + + +
                  + + + + + + + + + + + + + + + +                   + + + + + + + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                   +                   + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                   +                   + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                   +                   + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                   +                   + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                   +                   + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                   +                   + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                   +                   + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + +
                  + + +
                  + + + + + + + + + + + + + + + +                   + + + + + + + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + + +
                  + + + + + + + + + + + + + + + +                   + + + + + + + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + + +
                  + + + + + + + + + + + + + + + +                   + + + + + + + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + + +
                  + + +
                  + + + + + + + + + + + + + + + +                   + + + + + + + + + + + + + + +
                  + + + + + + + + + + 1 + + + +
                  +                   + + + + + + + + + + 1 + + + +
                  +                   + +
                  +                   + + + + + + + + + + + + + + +
                  + +
                  +                   + +                   diff --git a/src/documentation/docbook-xsl/xhtml/titlepage.xsl b/src/documentation/docbook-xsl/xhtml/titlepage.xsl new file mode 100644 index 0000000000..d395680e75 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/titlepage.xsl @@ -0,0 +1,861 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   + + +
                  + + + + + + + +
                  +                   + + + + + + + + + + + + + +
                  + + + + + + + +
                  +                   + + +
                  + + + + + + + +
                  +                   +                   +                   + + +
                  + +
                  +                   + + + + +
                  +                   +                   + + +
                  +

                  + + + +
                  +                   + + +
                  + +
                  +                   + + +
                  + +
                  +                   + + + + +
                  +                   +                   + + + + + + + + + + + + +
                  +                   +                   + + + + + + + + +
                  + +
                  +                   + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + + + + + +

                  + + + + + + copyright + + + + + + + + + +

                  +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + , + + + + +

                  + +

                  +                   + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + +

                  + + + + + +

                  +                   + + +

                  +                   + + +

                  +

                  +                   + + + + + + + + + +
                  +                   +                   + + + + + + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  + +
                  + + +                   +                   +                   + +
                  + + +
                  +                   +                   +                   + + +

                  +                   + + + + +
                  +                   +                   + + + + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + + + + + + + + : + + + + + + + + + + + + + + + + + + + + + , + + + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + +
                  + +
                  +                   + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + + + + + + + + + + + 3 + 2 + + + + + + + + RevHistory + + + + +
                  + + + + + + + +
                  + + + + + +
                  +
                  +                   + + + + + + + + + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + , + + + + + +   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
                  +                   +                   + + + + +
                  +                   +                   + + + + + +

                  + +

                  +                   + + + + +
                  +                   +                   + + + + + + + + + + + + + + + + + + +

                  + + + + + + + + + + + +

                  +                   + + + + + + + + +
                  +                   +                   + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/toc.xsl b/src/documentation/docbook-xsl/xhtml/toc.xsl new file mode 100644 index 0000000000..af68b3caea --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/toc.xsl @@ -0,0 +1,163 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + I don't know how to make a TOC in this context! + + + + + + + + + + + + + +
                  + + + +
                  +                   + + + + + +                   +                   +                   + + + + + +
                  + +
                  + +                   + +
                • + + +
                  • +                   +                   +                   + + + + +
                  + +
                  +                   + +
                • + +
                  • +                   +                   +                   + + + + + + + + + + + + + + +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/documentation/docbook-xsl/xhtml/verbatim.xsl b/src/documentation/docbook-xsl/xhtml/verbatim.xsl new file mode 100644 index 0000000000..a9b3eef8de --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/verbatim.xsl @@ -0,0 +1,346 @@ + + + + + + + + + + + + + + + + + + + + The shade.verbatim parameter is deprecated. + Use CSS instead, + + + for example: pre. + + { background-color: #E0E0E0; } + + + + + + + + + 
                  +	
+	  
+	
+
                  +                   + + 
                  +	
+
                  +                   +                   +                   + + + + + + + + + + + The shade.verbatim parameter is deprecated. + Use CSS instead, + + + for example: pre. + + { background-color: #E0E0E0; } + + + + + + + + 
                  +	    
+	      
+	    
+
                  +                   + +
                  +

                  + + + +

                  +
                  +                   +                   +                   + + + + 
                  +	    
+
                  +                   + +
                  +

                  + + + +

                  +
                  +                   +                   +                   +                   +                   + + + + + + + + + + +
                  +

                  + + + +

                  +
                  +                   + + +
                  +

                  + + + +

                  +
                  +                   +                   +                   + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Unexpected verbatim environment: + + + + + + + + + + 1 + + + + + + + + + + + + + No numberLines function available. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +                   diff --git a/src/documentation/docbook-xsl/xhtml/xref.xsl b/src/documentation/docbook-xsl/xhtml/xref.xsl new file mode 100644 index 0000000000..bdd18d25c1 --- /dev/null +++ b/src/documentation/docbook-xsl/xhtml/xref.xsl @@ -0,0 +1,1273 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + XRef to nonexistent id: + + + ??? + + + + + + + + + + + + + + + + Endterm points to nonexistent ID: + + + + ??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + XRef to nonexistent id: + + + ??? + + + + + + + + + + + + + + + + Endterm points to nonexistent ID: + + + + ??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + suppress anchor + + + + + + + + + + + removing + + + + + + + + + + + + + + + + + removing + + + + + + + + + + + + + + + + + + + + + + Don't know what gentext to create for xref to: " + + ", (" + + ") + + + ??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [ + + + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + No bibliography entry: + + found in + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [ + + + + + + + + + ] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Endterm points to nonexistent ID: + + + ??? + + + + + + + + + + Link element has no content and no Endterm. + Nothing to show in the link to + + + ??? + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Olink debug: root element of target.database ' + + ' is ' + + '. + + + + + + + + + + + + + + + Error: unresolved olink: + targetdoc/targetptr = ' + + / + + '. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Warning: olink linkmode pointer is wrong. + + + + # + + + + + + + + + + + + + ? + + + + + & + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +