Installing the minimal or standard package on Linux or Mac OSX Package File name Minimal DITA-OT_minimal_bin.tar.gz Standard DITA-OT_standard_bin.tar.gz For production use, we recommend that you use the latest stable release. Extract the contents of the package into an installation directory. You can extract the files either to your private home directory for your exclusive use or to the /usr/local/share/ directory, if you want to share the DITA-OT with other users. Verify that the JAVA_HOME environment variable is set. export JAVA_HOME=<JRE_dir> Verify that the ANT_HOME environment variable is been set. export ANT_HOME=<Ant_dir> Verify that the PATH environment variable includes the Java and Ant executable files. export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$PATH Set the DITA_HOME environment variable to point to the DITA-OT installation directory. export DITA_HOME=<DITA-OT_dir> Set up the CLASSPATH environment variable. export CLASSPATH=$DITA_HOME/lib/dost.jar:$CLASSPATH export CLASSPATH=$DITA_HOME/lib:$CLASSPATH export CLASSPATH=$DITA_HOME/lib/resolver.jar:$CLASSPATH export CLASSPATH=$DITA_HOME/lib/commons-codec-.jar:$CLASSPATH If you use Ant, version 1.8 or later, set up the CLASSPATH environment variable to include Apache Xerces. export CLASSPATH=<xerces_dir>/xercesImpl.jar:<xerces_dir>/xml-apis.jar:$CLASSPATH Set up the XSLT processor: Processor Action Saxon

Set up the CLASSPATH environment variable to include the Saxon JAR files, for example:export CLASSPATH=<saxon_dir>/saxon9.jar:<saxon_dir>/saxon9-dom.jar:$CLASSPATH

Set up the ANT_OPTS environment variable, for example: export ANT_OPTS=$ANT_OPTS -Djavax.xml.transform.TransformerFactory=net.sf.saxon.TransformerFactoryImpl

 Xalan Set up the CLASSPATH environment variable to include the Xalan JAR files, for example: export CLASSPATH=<xalan_dir>/xalan.jar:$CLASSPATH For index processing, set up ICU for Java. export CLASSPATH=<icu4j_dir>/icu4j.jar:$CLASSPATH For JavaHelp, set the JHHOME environment variable. export JHHOME=<javahelp_dir> For PDF output, set up the XSL-FO processor: Processor Action FOP

Add the FOP installation directory to the local.properties file as the property, for example:fop.home=/usr/share/java/fop

 RenderX Add the RenderX installation directory to the local.properties file as the property, for example:xep.dir=/usr/share/java/xep Antenna House Add the AH Formatter installation directory to the local.properties file as the property, for example:axf.path=/usr/share/java/AHFormatterV6 Test the DITA-OT installation by transforming the sample files. The samples\ant_sample directory contains Ant scripts designed to build various output formats. /usr/local/share/DITA-OT$ ant -f samples/ant_sample/sample_all.xml The generated output is written to the DITA-dir\out\samples directory. The following output formats are generated:
  • Docbook
  • Eclipse help
  • HTML Help
  • ODT
  • JavaHelp
  • PDF
  • TocJS
  • TROFF
  • XHTML