17.4.1 Creating help context markers

DITA2Go can convert cross references to help context markers; this is the default for WinHelp:

[HelpOptions]
; Xrefs = Help (make context markers) or None (plain text)
Xrefs=Help

You can specify whether to use the cross-reference ID (the default), or the full text of the cross reference:

[HelpOptions]
; XrefType = = Numeric (default) or Full (use only to eliminate dupes)
XrefType=Numeric

If you specify XrefType=Full, you get the complete referenced text in the WinHelp context marker. Such text can easily exceed the 63-character size limit for cross-reference IDs in WinHelp, and might contain characters that are not valid in WinHelp IDs.

If you specify XrefType=Numeric (or if you omit the setting entirely) DITA2Go uses internally generated object IDs instead of the full cross-reference text.

Previous Topic:  17.4 Converting cross references

Next Topic:  17.4.2 Specifying cross-reference destination files

Parent Topic:  17.4 Converting cross references

Sibling Topics:

17.4.2 Specifying cross-reference destination files

17.4.3 Specifying cross-reference jump destinations

17.4.4 Specifying WinHelp options for cross-reference formats

17.4.5 Limiting cross-reference text

Table of ContentsIndex