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.