24.4.2 Treating format names as DITA element names

If most formats are named for DITA elements, you can lessen the chore of mapping formats to elements by directing DITA2Go to use the format name as the DITA element name wherever possible (that is, where the content model includes an element of that name). This works only if the named element is of an appropriate type: block allowing text for a paragraph format, or inline allowing text for a character format; see §41.6 Inspecting and correcting element types.

However, leaving any paragraph format unmapped is risky; some formats might match the names of DITA elements that do not do what you want.

To map format names to DITA elements of the same name where possible:

[DITAOptions]
; UseFormatAsTag = No (default, if tag unmapped use default elem),
;  or Yes (if unmapped, use format name if valid in content
;  model).
UseFormatAsTag = Yes

When UseFormatAsTag=Yes, any format with a name that is the same as a DITA element name in the current content model is mapped to that element.

When UseFormatAsTag=No, unmapped format names that do not correspond to appropriate DITA element names are mapped to the default element; see:

§24.4.3.3 Specifying a default element for unmapped paragraph formats

§24.4.4.3 Specifying a default element for unmapped character formats.

Previous Topic:  24.4.1 Understanding how DITA2Go delimits DITA elements

Next Topic:  24.4.3 Mapping paragraph formats to DITA block elements

Parent Topic:  24.4 Configuring DITA elements

Sibling Topics:

24.4.1 Understanding how DITA2Go delimits DITA elements

24.4.3 Mapping paragraph formats to DITA block elements

24.4.4 Mapping character formats to DITA inline elements

24.4.5 Assigning multiple typographic elements to a format

24.4.6 Assigning attributes to DITA elements

24.4.7 Preserving whitespace in block elements

Table of ContentsIndex