| [platform-help-dev] Changing default path of help_home.html in preferences.ini |
Hi,
Has anyone had a similar experience and come up with a solution? Ultimately, I would like to point to a custom help_home.html page that lives outside the root Eclipse plugin directory. This task seems easy enough but when I started to do some initial tests to see if I could change the preferences.ini path to point to and display my custome help_home file WITHIN the root Eclipse plugin directory, I ran into problems.
All of the paths below should work, but display fails as soon as I climb out of org.eclipse.help.base and into other plugins in C:\...\Eclipse\plugins. As you may know, the preferences.ini file says: "Specify your html page as /pluginId/path/to/home.html", so I should see it display in all cases. Right?
from C:\...\Eclipse\plugins\org.eclipse.help.base_3.0.1\preferences.ini:
#####################
# Layout of help view
#####################
...
# The page to show in the content area when opening help.
# Specify your html page as /pluginId/path/to/home.html.
# Currently, the default home is /org.eclipse.help/doc/help_home.html.
# Following path does display home help (default)
#help_home=/org.eclipse.help.base/doc/help_home.html
# Following path does display home help
#help_home=/org.eclipse.help.base/help_home.html
# Following path does display home help
#help_home=/org.eclipse.help.base/doc/test/help_home.html
# Following path does *not* display home help
#help_home=/org.apache.ant_1.6.2/help_home.html
# Following path does *not* display home help
help_home=/org.apache.ant_1.6.2/org.eclipse.help.webapp_3.0.1/help_home.html
...
If the .ini does not recognize the association at the root level, then it won't when extending to the custom help_home file outside root.
Thanks in advance for your help.
shealy
...