Eclipse help output (transform type "eclipsehelp")

Eclipse help is an XHTML based output format intended to create a plug-in for the Eclipse Help system. Once the normal XHTML process has run, the dita.map.eclipse target is used to create a set of several control files and navigation files for Eclipse.

Eclipse relies on several different files to control the plug-in. Some of these are generated by the build, while others may be created by hand. The Ant targets used to control this process are:

  • dita.map.eclipse.init sets up various default properties for processing Eclipse output.
  • 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 with additional information used by Eclipse.
  • copy-plugin-files checks for the presence of several control files in the source directory, and copies those found to the output directory.
  • dita.map.eclipse.fragment.language.init, dita.map.eclipse.fragment.language.country.init, and dita.map.eclipse.fragment.error all work together to control Eclipse fragment files (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).