man db2x_xsltproc (Commandes) - XSLT processor with docbook2X extensions
NAME
db2x_xsltproc - XSLT processor with docbook2X extensions
SYNOPSIS
db2x_xsltproc [options] {xml-document}
DESCRIPTION
db2x_xsltproc is a libxslt-based XSLT processor, similar to the standard xsltproc that comes with that library. It activates the XSLT extensions needed for docbook2X's Texinfo conversion. (In the opinion of the author, this program is also a bit more user-friendly.)
The document in the file xml-document is converted, and is written to standard output (unless changed with --output).
OPTIONS
- --version
- Display libxml, libxslt and docbook2X version.
SOURCE DOCUMENT AND OUTPUT OPTIONS
- --output file, -o file
- Write output to the given file (or URI), instead of standard output.
- --xinclude, -I
- Process XInclude directives in the source document.
- --sgml, -S
- Indicate that the input document is SGML DocBook, rather than XML DocBook. You need this set this option if xml-document is actually a SGML file.
RETRIEVAL OPTIONS
- --catalogs catalog-files, -C catalog-files
- Specify additional SGML or XML catalogs to use for resolving Formal Public Identifiers or URIs.
- --network, -N
- db2x_xsltproc will normally refuse to load external resources from the network. If you do want to load from the network, set this option.
Usually you want to have installed locally the relevent DTDs and other files, and set up catalogs for them, rather than load them automatically from the network.
STYLESHEET OPTIONS
- --param name=expr, -p name=expr
- Add or modify a parameter to the stylesheet. name is a XSLT parameter name, and expr is an XPath expression that evaluates to the desired value for the parameter. (This means that strings must be quoted, in addition to the usual quoting of shell arguments; use --string-param to avoid this.)
- --string-param name=string, -g name=string
- Add or modify a string-valued parameter to the stylesheet.
The string must be in UTF-8 (or ASCII).
- --stylesheet file, -s file
- Specify the filename (or URI) of the stylesheet to use. The special values man and texi are accepted as abbreviations for the stylesheets to covert to man-pages and Texinfo, respectively. stylesheets.
DEBUGGING AND PROFILING
- --debug, -d
- Display logs of what is happening during the transformation to standard error.
- --nesting-limit n, -n n
- Change the maximum number of nested calls to XSL templates, used to detect template infinite loops. If not specified, the limit is 500 (libxslt's default).
- --profile, -P
- Display profile information: the total number of calls to each template in the stylesheet and the time taken for each. This information is output to standard error.
ENVIRONMENT
- XML_CATALOG_FILES
- Specify XML Catalogs. If not specified, the standard catalog (/etc/xml/catalog) is loaded, if available.
XML_CATALOG_FILES always takes precedence over SGML_CATALOG_FILES.
- SGML_CATALOG_FILES
- Specify OASIS TR9041 catalogs. If not specified, SGML catalogs are searched for in a few standard locations. (In the LSB standard, that is /etc/sgml/catalog.)
BUGS
- •
- --sgml uses libxml's built-in DocBook parser, which is not a real SGML parser at all, and can fail with perfectly valid SGML DocBook documents. If there is enough demand, the program can be changed to use libsp or nsgmls instead.
SEE ALSO
The docbook2X manual fully describes how to convert DocBook to man pages and Texinfo.
To know how this program works, consult the libxml2, libxslt and xsltproc documentation.