To map paragraph formats in your document to DocBook elements, assign the element name to the format name:
[DocBookParaTags] ; paragraph format (wildcards OK) = DocBook element, can be ; overridden by a DocBookTag marker; or format = No. ParaFmtName = elementname
The default element for a paragraph format that is not mapped in [DocBookParaTags] is one of the following:
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 §26.5.2 Designating DocBook ancestor elements. Definition lists can be derived from paragraph pairs, possibly with run-in headings for the term.
To specify that a particular paragraph format should not be mapped to any element:
[DocBookParaTags] ParaFmtName = No
The value No means that the tags for the format should be omitted, leaving the text inside the enclosing element. Use this mapping for code examples (which can run on for pages), to avoid having each line of code mapped to a separate <codeblock> element. For example:
[DITAParaTags] PgmCode* = No
[DITAParents] PgmCode* = codeblock
Specifying ancestry guarantees that DITA2Go will retain the original line breaks, instead of normalizing them as for HTML or XML.