Eclipse help processing

DITA Open Toolkit

Eclipse help processing

The eclipsehelp transformation generates XHTML-based output and files that are needing to create an Eclipse Help system plug-in. Once the normal XHTML process has run, the dita.map.eclipse target is used to create a set of control files and navigation files.

Eclipse use multiple files to control the plug-in behavior. Some of these control files are generated by the build, while others might be created manually. The following Ant targets control the Eclipse help processing:
dita.map.eclipse.init
Sets up various default properties
dita.map.eclipse.toc
Creates the XML file that defines an Eclipse table of contents
dita.map.eclipse.index
Creates the sorted XML file that defines an Eclipse index
dita.map.eclipse.plugin
Creates the plugin.xml file that controls the behavior of an Eclipse plug-in
dita.map.eclipse.plugin.properties
Creates a Java properties file that sets properties for the plug-in, such as name and version information
dita.map.eclipse.manifest.file
Creates a MANIFEST.MF file that contains additional information used by Eclipse
copy-plugin-files
Checks for the presence of certain control files in the source directory, and copies those found to the output directory
dita.map.eclipse.fragment.language.init
Works in conjunction with the dita.map.eclipse.fragment.language.country.init and dita.map.eclipse.fragment.error targets to control Eclipse fragment files, which are used for versions of a plug-in created for a new language or locale

Several of the targets listed above have matching templates for processing content that is located outside of the scope of the map directory, such as dita.out.map.eclipse.toc.