WinANT Help |
|
The DITA Open Toolkit features a plug-in architecture. This means the core, or base, functionality of the toolkit can be extended by third parties, separately from the base Toolkit development.
A plug-in is delivered as a ZIP file; the plug-in is installed by unzipping the files to a plug-ins directory, and then running the Integrator Ant task. The Ant task typically looks something like this:
ant -f integrator.xml
The instructions in the integrator.xml build file tell Ant how to incorporate any new plug-ins in the plug-ins directory into the base Open Toolkit build.xml file (the nerve centre of the publishing parts of the Open Tookit). The integrator Ant task modifies the [Open Toolkit folder]/build.xml file. Whenever the Open Tookit is used to publish an output, the build.xml file is referenced.
The htmlhelp2 plug-in is first unzipped into c:/dita-ot/plugins. The integrator task is then run. This adds references to the htmlhelp2 plug-in files (mainly XSL-T files) in c:/dita-ot/build.xml. The htmlhelp2 transtype can now be specified in an Ant build file, provided the build.xml file is listed in an <import> element at the top of the build file. (Older version of the toolkit imported conductor.xml, which in turn imports build.xml.)