24.10 Including CSH targets in DITA XML

If your source document includes context-sensitive help targets that you want to include in DITA output for use in further transformations, make sure those targets are in the form of TopicAlias PI markers. DITA2Go includes the content of TopicAlias PI markers in DITA output by default. To exclude that content from DITA output:

[DITAOptions]
; UseTopicAlias = Yes (default, include in DITA output) or No
UseTopicAlias = No

When UseTopicAlias=Yes, DITA2Go processes the content of each TopicAlias PI marker into the following:

<data name="topicalias" value="IDH_about" />

Each such <data /> element is on a line of its own in the output, placed at the beginning of the next paragraph text (typically the <title>).

This format is similar to the DITA-FMx format, but omits the FrameMaker-specific @datatype. For example, in DITA-FMx the same CSH target looks like this:

<data datatype="fm:marker" name="TopicAlias" value="IDH_about" />

See §16.10.2 Specifying CSH mappings.

Previous Topic:  24.9.5.3 Specifying the <xref> type attribute

Next Topic:  24.11 Overriding DITA settings with markers

Parent Topic:  24. Converting to DITA XML

Sibling Topics:

24.1 Generating DITA XML output from DITA input

24.2 Setting up a DITA XML project

24.3 Specifying general options for DITA

24.4 Configuring DITA elements

24.5 Nesting DITA block elements

24.6 Specifying options for tables in DITA XML

24.7 Specifying options for images in DITA XML

24.8 Configuring DITA topics

24.9 Configuring cross references and links for DITA

24.11 Overriding DITA settings with markers

Table of ContentsIndex