21.4.3.3 Enabling mid-topic jumps from the TOC

The presence of anchors in TOC entries (such as href="topic.htm#anchor") breaks Eclipse Help native breadcrumbs (Eclipse bug 184787), and possibly more. Therefore, by default DITA2Go omits these anchors. However, omitting the anchors also prevents mid-topic jumps from the TOC.

To enable mid-topic jumps by including anchors in Eclipse Help TOC entries:

[EclipseHelpOptions]
; TocNamesFileOnly = Yes (default, workaround for Eclipse bug 184787,
; and others, where use of #aname breaks Eclipse native breadcrumbs),
; or No (allows direct midtopic jumps to points within files).
TocNamesFileOnly = No

When TocNamesFileOnly=Yes (the default), DITA2Go omits anchors from TOC entries, enabling Eclipse Help native breadcrumbs but disabling mid-topic jumps from the TOC.

When TocNamesFileOnly=No, DITA2Go includes anchors in TOC entries, enabling mid-topic jumps from the TOC, but disabling Eclipse Help native breadcrumbs.

See also:

§21.2.5 Disabling breadcrumb trails in Eclipse Help

Previous Topic:  21.4.3.2 Specifying a starting topic

Next Topic:  21.4.3.4 Directing TOC links to top of topic page

Parent Topic:  21.4.3 Configuring contents properties for Eclipse Help

Sibling Topics:

21.4.3.1 Providing a title for the TOC

21.4.3.2 Specifying a starting topic

21.4.3.4 Directing TOC links to top of topic page