17.11.2 Eliminating duplicate
keywords
When a first-level index entry has second-level entries
under it, to avoid repeats of the same topic, set DisambiguateIndex=Topic:
[HelpOptions]
; DisambiguateIndex = Yes (default, always write first-level keys),
; Strip (no first-level keys), Topic (only write first instance of
; a first-level key in each topic), No (only write first in doc)
DisambiguateIndex=Topic
The DisambiguateIndex options work as follows:
Topic
|
Prevents duplication by suppressing repeated index
markers within a topic. When you have the same index marker in two or
more places, and pick that item in the WinHelp index, you get a dialog
with a list of all the places the item is referenced. If the same marker
occurs twice in the same topic, you get two identical entries for that
topic in the dialog list.
|
Yes
|
Prevents duplication by eliminating repeated first-level
headings in the file (not just in the topic). When you have second-level
topics under the same first-level topic, and you click the first-level
heading, you get duplication. You need only one of the first-level
headings in the file to make the index work right (avoiding a WinHelp
defect).
|
No
|
Generates a first-level heading only for the first
of its second-level topics.
|
Strip
|
Eliminates generated first-level headings, so that
only explicit headings remain.
|
Previous Topic: 17.11.1 Designating
index level separators
Next Topic: 17.11.3 Keeping
or discarding “See also” entries
Parent Topic: 17.11 Configuring
index entries for WinHelp
Sibling Topics:
17.11.1 Designating
index level separators
17.11.3 Keeping
or discarding “See also” entries