Installing the Idiom FO plug-in

Before installing the Idiom FO plug-in, you need to acquire and install several other software packages it depends on.
SAXON XSLT parser
See Installing SAXON on Windows or Installing SAXON on Linux for installation instructions.
IBM icu4j.jar package
This package includes various forms of globalization support. You can download the ICU4J 3.4.4 package at http://www-306.ibm.com/software/globalization/icu/downloads.jsp.
RenderX XEP Engine
You can use either the free XEP 4 Personal Edition or the XEP Engine product. For information on XEP, see http://www.renderx.com.
Follow these steps to install the Idiom FO plug-in.
  1. Download the plug-in from the web.
  2. Unzip the plug-in files to the Toolkit demo/fo directory. Your directory structure should then look like this:

  3. Copy icu4j_3_3_4.jar to the demo/fo/lib directory and then rename icu4j_3_3_4.jar to icu4j.jar.
  4. Edit the file demo/fo/build.xml and set the path information for saxon.jar and XEP.

    That section of the file will look similar to the following:

    				
<path id="project.class.path">
<pathelement location="C:/saxon6_5_3/saxon.jar"/>
<pathelement location="${fo.lib.dir}/xml-apis.jar"/>
<pathelement location="${fo.lib.dir}/xercesImpl.jar"/>
<pathelement location="${fo.lib.dir}/resolver.jar"/>
<pathelement location="${fo.lib.dir}/icu4j.jar"/>        
<pathelement location="${fo.lib.dir}/fo.jar"/>
</path>

<path id="xep.class.path">
<fileset dir="C:/xep/lib" includes="**/*.jar"/>
<pathelement location="${fo.lib.dir}/fo.jar"/>
</path>
  5. Move to the root directory of DITA Open Toolkit and issue the following command to install the plug-in: ant -f integrator.xml
At this point, the plug-in is integrated into the Toolkit processing pipeline and can be used by specifying the pdf2 transtype. For information about transtypes in Ant scripts, see About Ant scripts. For processing instructions for the pdf2 transtype, see Processing to PDF2 targets.