This topic explains how to install the DITA Open Toolkit processing environment.
The software that DITA-OT depend on are redistributed. The Full Easy Install package of DITA-OT after 1.3 includes the software, so the configuration process is streamlined.
Before installing DITA Open Toolkit full distribution, you need to complete the following steps:
Then, you need to complete the following steps:
The software that DITA-OT depend on are redistributed. The Full Easy Install package of DITA OT after 1.3 includes the software, so the configuration process is streamlined.
Before installing DITA Open Toolkit full distribution, you need to complete the following steps:
Then, you need to complete the following steps:
You can download and install the Java Runtime Environment (JRE) 1.5 (or greater) (available onhttp://www.oracle.com/technetwork/java/javase/overview/index.html) into a directory of your choice.
You can download and extract Saxon (available at http://saxon.sourceforge.net/) or the Xalan-J (available at http://xml.apache.org/xalan-j/downloads.html) into a directory of your choice.
The following steps guide you to set up the DITA Open Toolkit processing environment.
For example C:\pkg\DITA-OT1.5.4
set JAVA_HOME=<JRE_dir>
set ANT_HOME=<Ant_dir>
set PATH=%JAVA_HOME%\bin;%ANT_HOME%\bin;%PATH%
set DITA_HOME=<DITA-OT_dir>
set CLASSPATH=%DITA_HOME%\lib\dost.jar;%CLASSPATH%
set CLASSPATH=%DITA_HOME%\lib;%CLASSPATH%
set CLASSPATH=%DITA_HOME%\lib\resolver.jar;%CLASSPATH%
set CLASSPATH=%DITA_HOME%\lib\commons-codec-1.4.jar;%CLASSPATH%
If you use the Saxon, set up CLASSPATH to include Saxon JAR files.
set CLASSPATH=<saxon_dir>\saxon9.jar;<saxon_dir>\saxon9-dom.jar;%CLASSPATH%
Set up ANT_OPTS.
set ANT_OPTS=%ANT_OPTS% -Djavax.xml.transform.TransformerFactory=net.sf.saxon.TransformerFactoryImpl
If you use the Xalan, set up CLASSPATH to include Xalan JAR files.
set CLASSPATH=<xalan_dir>\xalan.jar;%CLASSPATH%
set JHHOME=<javahelp_dir>
hhc.dir=C:\\Program Files (x86)\\HTML Help Workshop
fop.home=C:\\Program Files\\fop
xep.dir=C:\\Program Files\\xep
axf.path=C:\\Program Files\\AHFormatterV6
Run all demos in the DITA Open Toolkit directory.
C:\pkg\DITA-OT1.5.4>ant -f samples\ant_sample\sample_all.xml
The following steps guide you to set up the DITA Open Toolkit processing environment in Linux or OS X.
You can download and install the Java Runtime Environment (JRE) 1.5 (or greater) (available onhttp://www.oracle.com/technetwork/java/javase/overview/index.html) into a directory of your choice.
You can download and extract Saxon (available at http://saxon.sourceforge.net/) or the Xalan-J (available at http://xml.apache.org/xalan-j/downloads.html) into a directory of your choice.
export JAVA_HOME=<JRE_dir>
export ANT_HOME=<Ant_dir>
export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$PATH
export DITA_HOME=<DITA-OT_dir>
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.4.jar:$CLASSPATH
If you use the Saxon, set up CLASSPATH to include Saxon JAR files.
export CLASSPATH=<saxon_dir>/saxon9.jar:<saxon_dir>/saxon9-dom.jar:$CLASSPATH
Set up ANT_OPTS.
export ANT_OPTS=$ANT_OPTS -Djavax.xml.transform.TransformerFactory=net.sf.saxon.TransformerFactoryImpl
If you use the Xalan, set up CLASSPATH to include Xalan JAR files.
export CLASSPATH=<xalan_dir>/xalan.jar:$CLASSPATH
export JHHOME=<javahelp_dir>
fop.home=/usr/share/java/fop
xep.dir=/usr/share/java/xep
axf.path=/usr/share/java/AHFormatterV6
Run all demos in the DITA Open Toolkit directory.
/usr/local/share/DITA-OT1.5.4$ ant -f samples/ant_sample/sample_all.xml