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.