24.4.4.1 Assigning DITA elements to character formats

To map character formats in your document to DITA inline elements, assign the element name to the format name:

[DITACharTags]
; character format (wildcards OK) = DITA element, cannot be 
;  overridden by a DITATag marker; or format = No.
CharFmtName = elementname

For example:

[DITACharTags]
Strong=b
Emphasis=i
BoldItalic=b
Subscript=sub
Superscript=sup
Mono=tt
Link=No

To specify that a particular character format should not be mapped to an element:

[DITACharTags]
CharFmtName = No

The value No means that the tags for the format should be omitted, leaving the text inside the enclosing element. For example, map the character formats you use for links and cross references to No. DITA2Go automatically generates <xref> tags from the cross references in your document, based on the format, but you do not need to map the format itself to any element. See §24.9 Configuring cross references and links for DITA.

The default element for a character format that is not mapped in [DITACharTags] is the element designated by DefCharElem; see §24.4.4.3 Specifying a default element for unmapped character formats. It is best to map each character format to the most specific element possible, which is not often the default element.

Previous Topic:  24.4.4 Mapping character formats to DITA inline elements

Next Topic:  24.4.4.2 Including typographic elements in addition to mapped formats

Parent Topic:  24.4.4 Mapping character formats to DITA inline elements

Sibling Topics:

24.4.4.2 Including typographic elements in addition to mapped formats

24.4.4.3 Specifying a default element for unmapped character formats

24.4.4.4 Overriding element mapping for character formats

24.4.4.5 Using alternate character formats for menu cascades