Difference between revisions of "ODFXSLTRunner"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Building ODFXSLTRunner)
Line 41: Line 41:
 
== Building ODFXSLTRunner ==
 
== Building ODFXSLTRunner ==
  
'''odfxsltrunner''' is build by a NetBeans project. After you have checked out the [http://odftoolkit.openoffice.org/source/browse/odftoolkit/tools/odfxsltrunner/ sources], you can open the project in NetBeans and build '''odfxsltrunner'''.
+
'''odfxsltrunner''' is build by a NetBeans project. After you have checked out the [http://odftoolkit.openoffice.org/source/browse/odftoolkit/tools/odfxsltrunner/ sources], you can open the project in [http://www.netbeans.info/downloads/index.php NetBeans] and build '''odfxsltrunner'''.

Revision as of 11:10, 5 June 2008

ODFXSLTRunner is a small Java application that allows you to apply XSLT stylesheets to XML streams included in ODF packages without extracting them from the package.

Command Line Options

ODFXSLTRunner is called by one of the below command lines:

java -jar odfxsltrunner.jar <style sheet> [-v] [-p <path in package>] [-l log file]  <input package> [<output package> [name=value ...]]
java -jar odfxsltrunner.jar <style sheet> [-v] [-p <path in package>] [-l log file] -t <input package> <output package> [name=value ...]
java -jar odfxsltrunner.jar <style sheet> [-v] [-p <path in package>] [-l log file] -r <package> [name=value ...]
java -jar odfxsltrunner.jar <style sheet> [-v] [-p <path in package>] [-l log file] -o <input package> <output file> [name=value ...]
java -jar odfxsltrunner.jar <style sheet> [-v] [-p <path in package>] [-l log file] -i <input file> <output package> [name=value ...]

The default is to apply the XSLT stylesheet <style-sheet> to the stream content.xml of the ODF file <input package>. If no <output package> parameter is specified, then the result of the transformation will be printed to the standard output. If an <output package> is specified, the <input package> is copied to the <output package>, and the steam content.xml of the <output package> is replaced with the result of the transformation.

The -p option allows to specify another stream in the package as source of the transformation than content.xml.

The -t options allows to specify a template for the output package. If it is used, the result of the transformation is stored in the content.xml stream (or the stream specified by the -p option) of the <output package>, but other streams of <output package> than that are not modified. This option can be used together with the -i option to create an ODF file from a plain XML file.

The -i option allows to specify a plain XML file <input file> as source of the transformation.

If the -o option is specified, the result of the transformation is stored in the plain <output file> rather than in a ODF package. This is for instance of interest if the result of the transformation is HTML.

The -r option allows to modify the content.xml stream (or the stream specified by the -p option) in place. If it is specified, the result of the transformation just replaces the stream that was the source of the transformation. This option should be used with care, because it modifies the original input ODF file.

The -v option enables a verbose mode.

The -l option can be used to redirect diagnostic messages into a log file. By default they are printed on standard error.

XSLT Parameters can be passed to the transformation by specifying them as name=value pairs. They must appear behind all other command line parameters.


Requirements

odfxsltrunner requires J2RE 5, or a later version of Java. It further requires ODFDOM v0.6.1 or a later version. The ODFDOM jar file must be either located in folder called lib next to the odfxsltrunner.jar file, or it must be in the classpath.

Note: ODFDOM v0.6.1 requires Apache's xerces. The jar file xercesImpl.jar also must exist in a folder lib next to odfxsltrunner.jar file, or it must be in the classpath.


Building ODFXSLTRunner

odfxsltrunner is build by a NetBeans project. After you have checked out the sources, you can open the project in NetBeans and build odfxsltrunner.

Personal tools