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) or TOC categories as they would appear on the bookshelf. All the other TOCS and categories will follow these. Non-present TOCs or categories on this list will be ignored. For TOCs, use the location of the TOC as /pluginId/path/to/toc.xml. For categories, use the category id. | /org.eclipse.platform.doc.user/toc.xml, |
ignoredTOCS |
Disabling TOCs. List of help TOCs (books) or TOC categories that will be ignored by the help system. The disabled TOCs/categories will not appear in the list of books, cannot be linked. Topics defined by disabled TOCs will not be available from search. Non-present TOCs or categories in this list will be ignored. For TOCs, use the location of the TOC as /pluginId/path/to/toc.xml. For categories, use the category id. |
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 per-product, 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 This preference controls external browsers in stand-alone help mode. In the workbench mode, help uses browsers provided by workbench browser support. |
default dynamically set based on the browser available on a
given system |
custom_browser_path |
Executable path for custom browser This preference controls external browsers in stand-alone help mode. In the workbench mode, help uses browsers provided by workbench browser support. |
C:\Program Files\Internet Explorer\IEXPLORE.EXE" %1 - on
Windows,"konqueror %1" - on
Linux"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 shownoff - user can
choose to show all topics, disabled topics
initially hiddenon - user can choose
to show all topics, all topics initially
shownalways - 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 enabledfalse - active help
framework disabled |
true |
window_infopop |
Allows enabling the old-style infopops when help key is pressed in workbench windows. If false, the new dynamic help view will open instead. | false |
dialog_infopop |
Allows enabling the old-style infopops
when help key is pressed in dialogs. If false, the new dynamic help
window will open instead. |
false |
Preference key | Usage |
Default |
port |
The port number on which the sever listens for http requests. If port is not given, an arbitrary port is picked by the system. | |
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. Products using help in local mode (workbench or stand-alone, not infocenter),
can set this preference to " |
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 |