7.5.6 Combining index levels for HTML-based Help

Suppose you have a two-level index entry, with only one instance of a second level for the first-level text. In printed books, the usual practice is to combine the first- and second-level text into one first-level entry. By default, Mif2Go follows this practice for HTML-based Help indexes. If you expect to merge indexes from two or more Help projects, you might not want the levels combined.

To keep Mif2Go from combining levels for such index entries:

[Index]

; CombineIndexLevels = Yes (default) or No (always break at colon)

CombineIndexLevels=No

When CombineIndexLevels=Yes, if there is only one item at the last level of a series of multi-level index entries, Mif2Go removes the colon before the last item and replaces it with one of the following, depending on what character immediately precedes (or follows) the level-break colon:

• nothing, if a space precedes or follows the colon

• a space, if punctuation (such as an escaped colon or a comma) precedes the colon

• a comma followed by a space, if an alphanumeric character precedes the colon.

For example, suppose an index marker contains:

tomatoes:Cherokee Purple

and there are no other first-level index entries for “tomatoes”. This entry would become:

tomatoes, Cherokee Purple

in the Help index.

When CombineIndexLevels=No, Mif2Go breaks index entries at all unescaped colons.

---

> 7 Producing on-line Help > 7.5 Configuring index entries for Help systems > 7.5.6 Combining index levels for HTML-based Help