<?xml version="1.0" encoding="UTF-8"?>
<!--Arbortext, Inc., 1988-2010, v.4002-->
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN"
 "task.dtd">
<?Pub Sty _display FontColor="red"?>
<task id="setupant" xml:lang="en-us">
<title>Setting up Ant</title>
<shortdesc>This topic describes how to set up an Ant environment.</shortdesc>
<taskbody>
<prereq>The <xref href="DITA-installation.xml#installation/jdk">Java
Development Kit (JDK)</xref> and <xref
href="DITA-installation.xml#installation/xslt">XSLT processor</xref> should
be installed before setting up Ant. </prereq>
<context><note>The "Full Easy Install" version of the DITA-OT comes
with the latest tested versions of Ant, Saxon (a common XSLT processor),
and other tools like FOP. If you are using the "Full Easy Install"
package, you may run the "startcmd" batch file to set up an environment
for all required libraries. When using this method, Java is the only
tool that must be installed separately (it cannot be included in the
DITA-OT due to licensing restrictions). For a full list of the tools
that come in each DITA-OT package, see <xref format="html"
href="http://dita.xml.org/wiki/dita-ot-packages" scope="external">DITA-OT
Packages</xref> at dita.xml.org.</note><?Pub Caret -1?></context>
<steps>
<step><cmd>Download and extract the Ant package file (available on <xref
format="html" href="http://ant.apache.org/bindownload.cgi"
scope="external"></xref>) into a directory of your choice.</cmd></step>
<step><cmd>Set up environment variable.</cmd>
<choices>
<choice>On a Windows platform, follow these steps: <ul>
<li>Set the JAVA_HOME environment variable, if it is not already defined: <codeph>set
               JAVA_HOME=&lt;jdk_dir></codeph></li>
<li>Set the ANT_HOME environment variable: <codeph>set ANT_HOME=&lt;ant_dir></codeph></li>
<li>Add the Ant binary directory to the PATH environment variable: <codeph>set
PATH=%PATH%;&lt;ant_dir>\bin</codeph></li>
</ul></choice>
<choice>On Linux, follow these steps: <ul>
<li>Set JAVA_HOME as follows: <codeph>export JAVA_HOME=&lt;jdk_dir></codeph></li>
<li>Set the ANT_HOME as follows: <codeph>export ANT_HOME=&lt;ant_dir></codeph></li>
<li>Add Ant to the PATH as follows: <codeph>export PATH=$PATH:&lt;ant_dir>\bin</codeph></li>
</ul></choice>
</choices>
</step>
<step importance="optional"><cmd>If you have installed FOP to generate
PDF output, see <xref href="DITA-installation.xml">DITA          
 installation</xref> for additional information on setting it up. </cmd>
</step>
</steps>
</taskbody>
</task>
<?Pub *0000002549?>
