Installing the DITA Tookit full package distribution

Installing the full package distribution

You cannot run a DITA Toolkit build until you have installed the Java JDK.

To install the full package:

  1. Download the full package from http://sourceforge.net/projects/dita-ot.
  2. On Windows, unzip the package into the C:\ directory. DITA-OT is extracted into C:\DITA-OT1.5.3 directory
  3. On Linux unzip the package into a $HOME directory.
  4. On Windows, add system variable DITA_HOME with value C:\DITA-OT1.5.3.
  5. On Linux, define variable DITA_HOME with value $HOME/1.5.3.
  6. On Windows, create a new shortcut for C:\DITA-OT1.5.3\startcmd.bat to be used to run DITA builds.
  7. On Linux execute the shell script startcmd.sh to set environment variables before running a DITA build.
Note: You may want to install other optional tools to complete your build environment.

Verifying the installation on Windows

  1. From the toolbar, click Start > Run.
  2. In the Open field, type cmd.
  3. Change the command prompt according to the following table.
    If this prompt displays, type the following command
    D:\
    C:
    H:\
    C:
    C:\My Documents\...
    cd \
  4. At the prompt, type cd DITA-OT1.5.3 The command prompt changes to C:\DITA-OT1.5.3
  5. Type ant -f build_demo.xml all and press Enter to process the DITA files in the demo, doc, docbook, and samples directories. This procedure also verifies the Toolkit installation. The testing process completes in 3-10 minutes depending on the speed of your machine. When testing completes, the confirmation message BUILD SUCCESSFUL displays.
Be sure the directories and files in your DITA-OT1.5.3 are as described in Directories and files in the DITA-OT1.5.3 root directory.

Verifying the installation on Linux

  1. In the console, type cd $DITA_HOME
  2. Type ant -f build.demo.xml all and press Enter to begin to process the DITA files in the demo, doc, docbook, and samples directories. This procedure also verifies the Toolkit installation. The testing process completes in 3-10 minutes depending on the speed of your machine. When testing completes, the confirmation message BUILD SUCCESSFUL displays.
Be sure the directories and files in your DITA-OT1.5.3 are as described in Directories and files in the DITA-OT1.5.3 root directory.