The Eclipse help system can be configured and branded to suit your
product by
specifying custom defaults for number of help preferences.
The Help system itself is divided up into a number of separate
plug-ins.
These tables shows available preferences, and which plug-in
defines them. Consult Customizing
a product on how to override some of these preferences.
Preference key | Usage |
Default |
baseTOCS | Toc ordering. Ordered list of help TOC's (books) as they would appear on the bookshelf. All the other TOCS will be follow these books. Non-present TOC's on this list will be ignored. Use the location of each TOC as /pluginId/path/to/toc.xml. | /org.eclipse.platform.doc.user/toc.xml, /org.eclipse.jdt.doc.user/toc.xml, /org.eclipse.platform.doc.isv/toc.xml, /org.eclipse.jdt.doc.isv/toc.xml, /org.eclipse.pde.doc.user/toc.xml |
Preference key | Usage |
Default |
banner | Location of the banner page to display in the top frame Example: banner=/org.eclipse.help.webapp/advanced/banner.html |
|
banner_height | Height of the banner frame Example: banner_height=60 |
|
help_home | The page to show in the content area when opening help. Specify your html page as /pluginId/path/to/home.html. | /org.eclipse.help.base/doc/help_home.html |
linksView | Set to true or false to control the visibility
of the
related links view. Note: this option has no effect in the infocenter. |
true |
bookmarksView | Set to true or false to control the visibility
of the
bookmarks view. Note: this option has no effect in the infocenter. |
true |
windowTitlePrefix | Set to true or false to control the title of the browser window. If true, the title will have a form "Help - <PRODUCT_NAME>", otherwise the title will be "<PRODUCT_NAME>", where <PRODUCT_NAME> is the name of Eclipse product set in the primary feature. | true |
loadBookAtOnceLimit | The maximum number of topics a book can have, for the navigation to be loaded by the browser as one document. Navigation for larger books is loaded dynamically, few levels at a time. More topics are downloaded as necessary, when branches are expanded. | 1000 |
dynamicLoadDepthsHint | Suggested number of
levels in topic navigation downloaded to the browser for large books.
The value needs to be greater than 0. The actual number of levels
can
differ for wide tree if suggested number of levels contains large
number of topics. |
3 |
imagesDirectory | Directory containing images used in the help view. Images must have the same name as those in the org.eclipse.help.webapp plug-in. Use the /pluginID/directory format. | images |
advanced.toolbarBackground | CSS background for toolbars. Value is used in browsers that display advanced help UI. | ButtonFace |
advanced.viewBackground | CSS background for navigation views. Value is used in browsers that display advanced help UI. | Window |
advanced.toolbarFont | CSS font for toolbars. Value is used in browsers that display advanced help UI. | icon |
advanced.viewFont | CSS font for navigation views. Value is used in browsers that display advanced help UI. | icon |
basic.toolbarBackground | Background color for toolbars. Value is used in browsers displaying basic help UI. | #D4D0C8 |
basic.viewBackground | Background color for navigation views. Value is used in browsers displaying basic help UI. | #FFFFFF |
locales | List of locales that infocenter will recognize and
provide a customized content for; if locales (or languages) accepted by
client browser are not matched with any locales in this list, the
browser will be served content for default locale - the server locale,
or locale specified by eclipse -nl
command line option; if list is not
specified, the browser will be served contents for its preferred
locale; note: not providing this option may result in a large
memory and disk space requirements as navigations and indexes will be
created for each distinct preferred locale among browsers accessing the
infocenter. Example: locales=en ja zh_CN zh_TW |
|
productIndex | If pre-built documentation index is provided with the product, the ID of the plug-in delivering the index must be specified to the help system here. | |
always_external_browser |
Use embedded when possible (on
Windows or Linux), or always external. Setting to true will force
use of external browser. Option has no effect if embedded browser
is not available on a given platform. |
false |
default_browser | Default external browser. ID of one of the external web browsers contributed to org.eclipse.help.base.browser extension point that help system will use. The browser's adapter available() method must return true on the current system. | default dynamically set based on the browser available on a
given system |
custom_browser_path | Executable path for custom browser | C:\Program
Files\Internet Explorer\IEXPLORE.EXE" %1 - on
Windows, "mozilla %1" - on other platforms |
showDisabledActivityTopics | Help system filters topics from disabled
capabilities. This option controls this behavior and existence
of Show All Topics button. Accepted values: never, off, on, always never - topic from disabled capabilities are not shown off - user can choose to show all topics, disabled topics initially hidden on - user can choose to show all topics, all topics initially shown always - topic from disabled capabilities are shown (filtering disabled) |
off |
activeHelp | Allows enabling and disabling execution of active help.
The option has no effect in the infocenter setup, where active help is
disabled. Accepted values: true - default active help actions enabled false - active help framework disabled |
true |
Preference key | Usage |
Default |
port | The port number on which the sever listens for http requests. If the port is 0 and arbitrary port is picked by the system. | 0 |
host |
The host address or name to use
for connecting to the server. The default is nothing, and eclipse will
pick up an available local address. |
Preference key | Usage |
Default |
acceptCount | The maximum queue length for incoming connection requests when all possible request processing threads are in use. Any requests received when the queue is full will be refused. | 100 |
maxProcessors |
The maximum number of request
processing threads to be created by this Connector, which therefore
determines the maximum number of simultaneous requests that can be
handled. |
75 |
minProcessors |
The number of request processing
threads that will be created when this Connector is first started. This
attribute should be set to a value smaller than that set for
maxProcessors. |
5 |