Omni Systems, Inc.

  

Mif2Go User's Guide, Version 55

  

Valid HTML 4.01!

 

Made with Mif2Go

15 Converting to DITA XML > 15.4 Configuring DITA elements > 15.4.6 Assigning attributes to DITA elements > 15.4.6.1 Specifying a value for the id attribute


15.4.6.1 Specifying a value for the id attribute

To specify an ID for a block element, place a DITAElemID marker in the FrameMaker paragraph. The content of the marker is the value of the id attribute. When you place a DITAElemID marker at the start of a topic, the content of the marker becomes the id attribute of the <title> element for that topic.

Note:  For an embedded topic (as opposed to a block element), you must use a DITATopicID marker instead; see §15.9.3 Specifying the ID for a DITA topic.

If a paragraph does not contain a DITAElemID marker, Mif2Go uses the content of the first newlink marker in the paragraph as the ID for the element. If there is no newlink marker, Mif2Go uses for the ID a combination of the Mif2Go FileID of the FrameMaker file and the FrameMaker ObjectID of the paragraph; see §5.3.1 Understanding how Mif2Go creates identifiers. You can override the Mif2Go-assigned ID with a DITAElemID marker.

Note:  The id attribute value must start with a letter. All Mif2Go-assigned FileIDs conform to this requirement. If you want your DITA XML output to validate, avoid changing any FileID values in mif2go.ini to start with a digit. 

Mif2Go provides a default id attribute for each of the following block elements:

<table> (all types)

<fig> (but not <image>)

<section>

<example>

<refsyn>

<fn>

<li>

<p> (when the paragraph contains index markers or starts a FrameMaker page).

Links to any of these elements automatically pick up the id attribute, and also the correct type attribute of the element. For links to other elements, you have to insert either a newlink marker or a DITAElemID marker in the target paragraph in FrameMaker, and specify the link type attribute with a DITALinkType marker; see §15.10.6.3 Specifying the <xref> type attribute.

Interpolated parent id attribute

When the parent of the current block element is interpolated by Mif2Go (see §15.4.1 Understanding how Mif2Go delimits DITA elements), you cannot use a DITAElemID marker to specify an ID for that parent.

To specify an ID for the parent of the current block element, place a DITAParentID marker in the element, with content as follows:

parentname=parentid

Do not include spaces around the equals sign.



15 Converting to DITA XML > 15.4 Configuring DITA elements > 15.4.6 Assigning attributes to DITA elements > 15.4.6.1 Specifying a value for the id attribute