26.4.2.3 Omitting invalid tags for default DocBook block elements

Some DocBook block elements allow only #PCDATA, not paragraph tags. When a “normal” paragraph must be placed inside one of these blocks, the paragraph tag should be omitted.

If some paragraph formats in your document are left unmapped, or are explicitly mapped to the default block element (usually <para>), the presence of such paragraphs in contexts where the default block element would not be valid could trigger unwanted interpolation of an arbitrary parent element. For enclosing block elements that allow mixed content, you can avoid this problem by directing DITA2Go to omit the default paragraph tags.

To omit invalid default paragraph tags where mixed content is allowed:

[DocBookOptions]
; DropInvalidParaTag = No (default) or Yes (if the para tag is the
;  default DefParaElem <para> and is invalid, but #PCDATA is valid,
;  drop the tag)
DropInvalidParaTag = Yes

See also:

§26.5.3 Fixing up interpolated ancestries

Previous Topic:  26.4.2.2 Specifying a default element for unmapped paragraph formats

Next Topic:  26.4.2.4 Overriding element mapping for paragraph formats

Parent Topic:  26.4.2 Mapping paragraph formats to DocBook elements

Sibling Topics:

26.4.2.1 Assigning DocBook elements to paragraph formats

26.4.2.2 Specifying a default element for unmapped paragraph formats

26.4.2.4 Overriding element mapping for paragraph formats

26.4.2.5 Providing aliases for paragraph formats