Package org.eclipse.help.search
Class HelpIndexBuilder
java.lang.Object
org.eclipse.help.search.HelpIndexBuilder
Builds a help search index for a plug-in by looking for the
org.eclipse.help.toc
extensions in the provided manifest file.
Search index is only created if index path is specified in the extension.
Index will contain data for all the topics listed in all the TOCs declared in
the plug-in.
If the index is created for a fragment, the manifest must point at the referenced fragment plug-in, while the destination should be the fragment itself.
Starting from the provided destination directory, index for each locale will be placed in a directory with the following path:
destination/nl/country/ or destination/nl/country/language/
The relative directory specified in the index
element of the
org.eclipse.help.toc
extention will be created in each of the
locale-specific paths (one per locale).
HelpIndexBuilder
can be cached and used multiple
times for different manifest and destination values.- Since:
- 3.1
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
execute
(IProgressMonitor monitor) Creates the plug-in search index by parsing the provided plugin.xml file, looking for TOC extensions.Returns the destination directory where index should be created.Returns the manifest file for this builder.void
setDestination
(File destination) Sets the destination directory where index should be created.void
setManifest
(File manifest) Sets the new manifest file (plugin.xml) to be used by this builder.
-
Constructor Details
-
HelpIndexBuilder
public HelpIndexBuilder()Creates a new instance of the help index builder.
-
-
Method Details
-
getManifest
Returns the manifest file for this builder. If the target is a plug-in, it is the absolute path ofplugin.xml
file. If the target is a fragment, it is the absolute path ofplugin.xml
of the fragment plug-in.- Returns:
- the file that contains TOC extensions
-
setManifest
Sets the new manifest file (plugin.xml) to be used by this builder. If the target is a plug-in, it is the absolute path ofplugin.xml
file. If the target is a fragment, it is the absolute path ofplugin.xml
of the fragment plug-in.- Parameters:
manifest
- the file that contains TOC extensions
-
getDestination
Returns the destination directory where index should be created.- Returns:
- the destination index directory
-
setDestination
Sets the destination directory where index should be created. Locale-specific directories will be created starting from this directory.- Parameters:
destination
- the directory where index should be created
-
execute
Creates the plug-in search index by parsing the provided plugin.xml file, looking for TOC extensions. If at least one of them hasindex
element, all topics listed in all the TOCs in the plug-in will be indexed and stored in the path specified by theindex
element.- Parameters:
monitor
- the monitor to track index creation progress- Throws:
CoreException
- if there are problems during index creation.
-