+xsltproc

Name

xsltproc — command line xslt processor

Synopsis

+Introduction

+ xsltproc is a command line tool for applying + XSLT stylesheets to XML + documents. It is part of libxslt, the XSLT C + library for GNOME. While it was developed as part of the GNOME project, it + can operate independently of the GNOME desktop. +

+ xsltproc is invoked from the command line with + the name of the stylesheet to be used followed by the name of the file or + files to which the stylesheet is to be applied. +

+ If a stylesheet is included in an XML document with a + Stylesheet Processing Instruction, no stylesheet need be named at the + command line. xsltproc will automatically + detect the included stylesheet and use it. +

+ By default, output is to stdout. You can specify a file for output using + the -o option. +

+Options

+ -V or --version - Show the version of + libxml and libxslt used. +

+ -v or --verbose - Output each step taken + by xsltproc in processing the stylesheet and the document. +

+ -o or --output + file - Direct output to the file named + file. For multiple outputs, also known as + "chunking", -o directory/ directs the + output files to a specified directory. The directory must already exist. +

+ --timing - Display the time used for parsing the + stylesheet, parsing the document and applying the stylesheet and saving + the result. Displayed in milliseconds. +

+ --repeat - Run the transformation 20 times. Used for + timing tests. +

+ --debug - Output an XML tree of the + transformed document for debugging purposes. +

+ --novalid - Skip loading the document's DTD. +

+ --noout - Do not output the result. +

+ --maxdepth value - Adjust the + maximum depth of the template stack before + libxslt concludes it is in an infinite + loop. The default is 500. +

+ --html - The input document is an HTML + file. +

+ --docbook - The input document is DocBook + SGML. +

+ --param name + value - Pass a parameter of name + name and value + value to the stylesheet. You may pass multiple + name/value pairs up to a maximum of 8. + +

+Note

+ If the value being passed is a string rather than a node identifier, + it must be escaped in quotes, as follows: +

+ xsltproc --param rootid '"introduction"' + stylesheet file + +

+ --nonet - Do not use the Internet to fetch DTD's or + entities. +

+ --warnnet - Output notification when DTD's or entities + are fetched over the Internet. +

+ --catalogs - Use catalogs to resolve the location of + external entities. This speeds DTD resolution. By having a + catalog file point to a local version of the DTD, + xsltproc does not have to use the + Internet to fetch the DTD. xsltproc + uses the catalog identified by the environmental variable + SGML_CATALOG_FILES. +

+ --xinclude - Process the input document using the + Xinclude specification. More details on this can be found in the Xinclude + specification: http://www.w3.org/TR/xinclude/ +

+ --profile or --norman - Output profiling + information detailing the amount of time spent in each part of the + stylesheet. This is useful in optimizing stylesheet performance. +

+More Information

+libxml web page: http://www.xmlsoft.org/ +
+W3C XSLT page: http://www.w3.org/TR/xslt +