15.9.3 Specifying the ID for a DITA topic
To give a topic an ID, do one of the following:
• Place a DITATopicID marker in the topic; the content of the DITATopicID marker is the topic ID.
• Place a FileName marker in the topic; the marker content specifies both the topic ID and the base file name of the split file that contains the topic (see §34.8.3 Using custom markers to name output files).
In the absence of either marker, the default topic ID is the base split-file name, adjusted as for CSS class names; see §15.9.4 Adjusting DITA topic IDs generated from file names.
If you do not split files (see §15.8.2 Splitting FrameMaker files into DITA topic files), nor insert markers for topic IDs, Mif2Go makes up an ID for each embedded topic after the first (which uses the base file name). These generated IDs are of the form topic2, topic3, and so forth. This is not recommended practice.
To specify a default ID other than the base split-file name (but only for the first topic in a FrameMaker file), include the following option in a chapter-specific configuration file (see §33.1.1 Providing configuration files for individual chapters) located in the project directory:
; TopicID = id for topic, default is base file name
You can override the default ID with a DITATopicID marker, or with a FileName marker.
> 15 Converting to DITA XML > 15.9 Configuring DITA topics > 15.9.3 Specifying the ID for a DITA topic