<?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 <filepath>startcmd.bat</filepath> 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>.</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 platform="windows">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%;%ANT_HOME%\bin</codeph></li>
</ul></choice>
<choice platform="linux osx">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:$ANT_HOME/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?>
