Chapter 2. Installing the Toolkit Plugins

How to install the DITA for Publishers Toolkit plugins to the Open Toolkit.

1. Unzip the plugin's Zip file into your Toolkit's plugins directory.

   You should get one or more directories under plugins named like net.sourceforge.dita4publishers.doctypes.

2. Run the integrator.xml script from the Toolkit's root directory.
   The trick here is knowing how to access the "ant" command. If you open a command window, type "ant" and get something like

   Buildfile: build.xml does not exist! 
   Build failed 

   Then you are good to go.

   Otherwise, you have to either find where Ant is on your system or download Ant from ant.apache.org.

   If you are using the full install of the DITA Open Toolkit then ant is in tools/ant/bin below the Toolkit's root directory.

   If you have the OxygenXML editor installed then ant is in tools/ant/bin below Oxygen's installation directory (e.g., c:\Program Files\Oxygen XML\tools\ant\bin on Windows).

   Assuming you have ant in your Toolkit, you can run it like so:

   1. Open a command window and navigate to the root of your Toolkit (for this example, installed in c:\programs\DITA-OT:

      c:\> cd c:\programs\DITA-OT
      c:\Programs\DITA-OT>_

   2. Run this command

      c:\Programs\DITA-OT> tools\ant\bin\ant -f integrator.xml

   You should see output something like this:

   Buildfile: integrator.xml
   
   integrate:
   [integrate] Using XERCES.
   
   BUILD SUCCESSFUL
   Total time: 0 seconds

   You may see messages about missing dependencies but as long as you get BUILD SUCCESSFUL then all the plugins that could be loaded have been.