24.4.3.1 Assigning DITA elements to paragraph formats

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

[DITAParaTags]
; paragraph format (wildcards OK) = DITA element, can be 
;  overridden by a DITATag marker; or format = No.
ParaFmtName = elementname

For example:

[DITAParaTags]
Heading* = title
Meta = keyword
Body = p
Example = p
List = sli
Numbered1 = p
Numbered = p
Bulleted = p
DefTerm = dt
DefDescription = dd
ParamTerm = pt
ParamDescription = pd
TableTitle = title
CellHeading = p
CellBody = p
Figure Title = title
Step = cmd
Syntax = p
CellContent = No
GlossItem = glossterm

Default element

The default element for a paragraph format that is not mapped in [DITAParaTags] depends on the value of [DITAOptions]UseFormatAsTag; see §24.4.2 Treating format names as DITA element names.

Do not map to footnote or table elements

DITA2Go processes footnotes and table components separately; do not map any paragraph formats to footnote elements, or to any table component (table, title, row, or cell) elements. If you are using the DITA Open Toolkit, see §24.9.4 Omitting <xref> elements from footnotes.

Do not map to element sets

You can assign element sets in [DITAParents] and in [DITAFirst], but you cannot use them for tags in [DITAParaTags]. See §24.5.5 Specifying alternate ancestries for the same element.

Specify ancestry for list formats

For list formats, if mapping the format to an element is not sufficient to identify the list type, you must also specify the parent of the element; see §24.5.2 Designating DITA ancestor elements. Definition lists can be derived from paragraph pairs.

Add typographic elements

To add typographic elements (b, i, u, tt, sup, or sub) in addition to the element to which a format is mapped, see §24.4.5 Assigning multiple typographic elements to a format.

Previous Topic:  24.4.3 Mapping paragraph formats to DITA block elements

Next Topic:  24.4.3.2 Omitting element tags for selected paragraph formats

Parent Topic:  24.4.3 Mapping paragraph formats to DITA block elements

Sibling Topics:

24.4.3.2 Omitting element tags for selected paragraph formats

24.4.3.3 Specifying a default element for unmapped paragraph formats

24.4.3.4 Omitting invalid tags for default DITA block elements

24.4.3.5 Overriding element mapping for paragraph formats

24.4.3.6 Providing aliases for paragraph formats

24.4.3.7 Mapping paragraph format aliases to different elements

24.4.3.8 Mapping paragraph format aliases algorithmically

24.4.3.9 Mapping several paragraphs formats to the same element