Eclipse help processing

The eclipsehelp transformation generates XHTML-based output and files that are needed 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 uses 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.