General¶

• About
• Downloads
• Incubator page
• License
• Privacy Policy

Components¶

• ODFDOM
• Simple API
• ODF Validator
• XSLT Runner

Community¶

• Get Involved
• Mailing Lists
• People
• Community FAQs

Development¶

• Source Code
• Bug Tracker
• Maven Reports
• Website
• Developer FAQs

PPMC¶

• PPMC FAQs
• Release Guide

ASF¶

• Apache Software Foundation
• Thanks
• Become a Sponsor

ODF XSLT Runner and ODF XSLT Runner Task Examples

XHTML¶

The XHTML transformation contained in OpenOffice.org can be used to transform ODF documents into XHTML. Using ODFXSLTRunner it is not even required to extract the ODF package.

The XHTML style sheet runs only with the SAXON XSLT Processor. Using version 9.1 is recommended.

The following command converts an ODF text document <ODT> into an XHTML document <XHTML>:

java -cp odfxsltrunner.jar:<saxon.jar> org.odftoolkit.odfxsltrunner.Main
   -f net.sf.saxon.TransformerFactoryImpl  -x Pictures/ 
  <ooo-xslt>/export/xhtml/opendoc2xhtml.xsl <ODT> -o <XHTML>

<saxon.jar> is the jar of the SAXON XSLT Processor. <ooo-xslt> is the location of the OpenOffice.org XSLT stylesheets within an OpenOffice.org installation. In a typical OpenOffice.org installation, this is openoffice.org/basis3.3/share/xslt (Linux) or Basis/share/xslt (Windows).

Note: A few changes are necessary to use OpenOffice.org's XHTML transformation with ODFXSLTRunner. These are available as patch in the OpenOffice.org issue i115881.

XHTML with referenced images only¶

The XHTML transformation in the above example extracts all images from the ODF document, regardless whether these are referenced in the XHTML document. To extract only the images that are referenced a list of referenced images may be created by the create-html-img-list.xsl style sheet that is contained in the sample-xslt folder of ODFXSLTRunner. It is applied to the XHTML file, and the target is a text file that contains the references images. Although the input file is an XHTML rather than a ODF file, ODFXSLTRunner may be used to apply the style sheet.

java -jar odfxsltrunner.jar create-html-img-list.xsl -i <XHTML> -o <img-list> 
 unzip <ODT> `<img-list>`

Replace embedded objects with bitmap images¶

Unlike OpenOffice.org's HTML filter, the XSLT-based XHTML filter does not convert embedded objects into bitmap images. It is however possible to replace the embedded objects of ODF document with the images that the HTML filter has exported by applying the replace-object.xsl style sheet that is contained in the sample-xslt folder of ODFXSLTRunner to the ODF document.

The following steps are required:

• Load the ODT document into OpenOffice.org and save it with the HTML filter. The file may have an arbitrary name. <ooo-html-file> is used as a placeholder here.
• Convert the HTML file into an XHTML file. You may use xmllint for this purpose, which is part of libxml2, or any other tools that converts HTML into XHTML. The command line for xmllint is: xmllint --html --xmlout --dropdtd -o <ooo-xhtml-file> <ooo-html-file>
• Apply the replace-object.xsl style sheet to the ODF document. The style sheet requires the name of the XHTML file converted in the previous step as '''hrml-ref''' parameter. java -jar odfxsltrunner.jar replace-objects.xsl <input odf> <output odf> ref-html=<ooo-xhtml-file>
• Zip the images that OpenOffice.org has saved next to the HTML document into the output ODF file. The new ODF file now can be transformed to XHTML with OpenOffice.org's XHTML transformation.