Installing the minimal or standard package on Linux or Mac OS X
If you already have locally-installed copies of Ant and the other required tools, install either the minimal or standard package.
Before you begin
- Ant, version 1.7.1 or later
- Java runtime environment or development kit, version 7 or later
- XSLT 2.0 processor. You can use Saxon, version 22.214.171.124 or later.
In addition, determine the specific DITA-OT transformations that you intend to support and ensure that you have the prerequisite software installed for them.
Download the minimal or standard package from the project website at
Package File name Minimal DITA-OT2.0.1_minimal_bin.tar.gz Standard DITA-OT2.0.1_standard_bin.tar.gzFor production use, we recommend that you use the latest stable release.
Extract the contents of the package into an installation directory.
Note: 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.
Verify that the ANT_HOME environment variable is been set.
Verify that the PATH environment variable includes the Java
and Ant executable files.
Set the DITA_HOME environment variable to point to the
DITA-OT installation directory.
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-1.9.jar:$CLASSPATH
If you use Ant, version 1.8 or later, set up the CLASSPATH
environment variable to include Apache Xerces.
Set up the XSLT processor:
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:$CLASSPATHSet up the ANT_OPTS environment variable, for example:
export ANT_OPTS=$ANT_OPTS -Djavax.xml.transform.TransformerFactory=net.sf.saxon.TransformerFactoryImpl
For index processing, set up ICU for Java.
For JavaHelp, set the JHHOME environment variable.
For PDF output, set up the XSL-FO processor:
Processor Action FOPAdd the FOP installation directory to the local.properties file as the fop.home property, for example:
RenderX Add the RenderX installation directory to the local.properties file as the xep.dir property, for example:
Antenna House Add the AH Formatter installation directory to the local.properties file as the axf.path property, for example:
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-OT2.0.1$ ant -f samples/ant_sample/sample_all.xmlThe generated output is written to the DITA-dir\out\samples directory. The following output formats are generated:
- Eclipse help
- HTML Help