16.5.8.1 Listing characters to ignore in index sort order

To specify which characters DITA2Go should ignore when ordering index entries for HTML Help or OmniHelp, use one or both of the following settings:

[Index]
; IgnoreCharsIX = characters to exclude when sorting index entries
;  (en dash, em dash, and nonbreaking hyphen are all converted to
;  hyphens first)
IgnoreCharsIX=-[]()<>
; IgnoreLeadingCharsIX = characters to exclude if at the beginning of
;  the entry when sorting index entries; multiples like $$ or .. are
;  all excluded
IgnoreLeadingCharsIX=.$<

By default, when sorting index entries DITA2Go ignores the following characters:

If you do not include any settings for IgnoreCharsIX or IgnoreLeadingCharsIX, DITA2Go uses these defaults. Characters specified for IgnoreCharsIX affect the sorting of sublevels; those specified for IgnoreLeadingCharsIX do not.

Suppose you provide no setting at all for IgnoreCharsIX, and just specify this setting:

[Index]
IgnoreLeadingCharsIX=?

In this case all of the following characters would be ignored for index sorting:

To have only leading question marks ignored, you would specify:

[Index]
IgnoreCharsIX=
IgnoreLeadingCharsIX=?

To exclude all characters from the “ignore” sets, so all index entries that start with punctuation appear at the beginning of the Help index:

[Index]
IgnoreCharsIX=
IgnoreLeadingCharsIX=

Previous Topic:  16.5.8 Customizing index sort order

Next Topic:  16.5.8.2 Choosing case sensitivity of indexed terms

Parent Topic:  16.5.8 Customizing index sort order

Sibling Topics:

16.5.8.2 Choosing case sensitivity of indexed terms

16.5.8.3 Specifying index sort type and locale