This is an old revision of the document!
Configuration of Help buttons
By default every explorer created in GroIMP has a small question mark button on the upper right corner. Moreover several buttons are added to different panels. In the following it will be described how to link this buttons to the right places and how to add buttons to newly created panels.
Linking a button to a certain page
Every help button triggers the HelpExplorerFactory which then creates the help panel, during this creation the factory can receive a path to a certain page. If a path was received this path will be opened.
A path in this case is defined by the name of the tree items in the help explorer separated by a slash. e.g.: GroIMP User Manual/Using GroIMP/Common Panels
This path can be provided by the plugin.properties file on different levels, the button will first look for a 'docLink' attribute in its own description, then in the description of the panel and then in the description of the plugin. It will always pick the first one it gets.
In practice this means a plugin can have a default path defined by 'docLink' directly and addtionally individual pathes for certain plugins e.g. for the RGG toolbar:
/ui/panels/rgg/toolbar.docLink = RGG Plugin Manual/GroIMP's Relational Growth Grammars Plugin/Working with a Relational Growth Grammar
1. the path of the registry item, e.g. <de.grogra.pf.ui.registry.HelpExplorerFactory name=“help” path=“RGG Plugin Manual/GroIMP's Relational Growth Grammars Plugin”/>
. This way is not recommended since it allows no translation and can not work with linked nodes.
2. **the docLink property of the button.