24.9.3 Linking to elements below topic level

Normally, DITA2Go can use a HyperJump PI marker to create a link for an element ID. However, to provide a destination for a link to a target element that is below topic level, in some cases you might have to insert a DITALinkElemID PI marker in text just before the link, and a DITAElemID PI marker (or DITAParentID PI marker) in the target text.

The content of the DITALinkElemID PI marker must match the content of the DITAElemID PI marker or DITAParentID PI marker (see §24.4.6.1 Specifying a value for the id attribute). This is to ensure the correct link target in cases where the built-in rules to determine the target element ID provide the wrong choice or none at all. DITA2Go places the DITALinkElemID PI marker content after the target topic ID in the href attribute of the <xref> element.

Previous Topic:  24.9.2 Specifying an outputclass for cross-reference wrappers

Next Topic:  24.9.4 Omitting <xref> elements from footnotes

Parent Topic:  24.9 Configuring cross references and links for DITA

Sibling Topics:

24.9.1 Understanding how DITA2Go converts cross references

24.9.2 Specifying an outputclass for cross-reference wrappers

24.9.4 Omitting <xref> elements from footnotes

24.9.5 Overriding <xref> attribute values

Table of ContentsIndex