15.3.1 Mapping paragraph formats to RTF styles

You can remap formats to have other names in the output file. One reason for doing this might be to enable the use of Word’s paragraph autonumbering facility, which requires use of the predefined Heading 1 through Heading 9 styles:

[Styles]
; Document para format name = RTF style name (affects name only)
; Always use the remapped (RTF) name in the HelpStyles sections
; the RTF name must be unique; some examples are shown below
; the Heading N styles support Word outline and autonumber features
ChapTitle=Title
Heading1=Heading 1
Heading2=Heading 2
Heading3=Heading 3
Heading4=Heading 4
Heading5=Heading 5
HeadingRunin=Heading 6
Numbered1=Heading 7
Numbered=Heading 8
Heading9=Heading 9

You cannot use [Styles] to merge formats

Each style name used for the RTF file must be unique; you cannot use the [Styles] section to merge styles. If you try to do so, Word unmerges them for you, by adding a digit after the repeating name. For example, if you specify both Numbered1=Heading 7 and Numbered=Heading 7, Word renames the second style Heading 71. Use the [StyleReplacements] section to map multiple formats to a single style; see §15.3.2 Merging paragraph formats.

You cannot map to Normal style

For the same reason, avoid mapping any format to Normal, which Word uses for its first style. Word renames such mapped styles Normal1, Normal2, and so on.

Null mappings are ignored

DITA2Go ignores any assignment in the [Styles] section that has no entry to the right of the equals sign.

Previous Topic:  15.3 Converting paragraph and character formats

Next Topic:  15.3.2 Merging paragraph formats

Parent Topic:  15.3 Converting paragraph and character formats

Sibling Topics:

15.3.2 Merging paragraph formats

15.3.3 Converting autonumbered formats

15.3.4 Converting bulleted formats

15.3.5 Converting character formats

Table of ContentsIndex