6.11 Specifying options for draft comments

By default, DITA2Go includes the content of <draft-comment> elements in output.

To exclude <draft-comment> content from output:

[ElementOptions]
; KeepDraftComments = Yes (default, include draft-comment content 
; in output) or No (exclude draft-comment from output)
KeepDraftComments = No

When KeepDraftComments=Yes (the default), DITA2Go treats <draft-comment> as an inline element; however, it is one of those elements that can contain “pernicious mixed content”: both block and inline elements, and also text.

By default, DITA2Go maps <draft-comment> content to a format that makes it easy to spot in the output:

[InlineFormatMaps]
draft-comment/* = DraftComment

And in system format configuration files, DITA2Go defines this format as follows:

[DraftComment]
display = inline
color = red

You can override this definition in a local format configuration file.

However, if there are any other block or inline formats within <draft-comment>, they will override its format, unless you assign a format for each; for example:

[BlockFormatMaps]
p/draft-comment/* = DraftPara

and:

[DraftPara]
based = Body
color = red

See §7. Configuring output formats.

Previous Topic:  6.10 Specifying options for special lists

Next Topic:  6.12 Specifying options for maps

Parent Topic:  6. Mapping elements to output formats

Sibling Topics:

6.1 Understanding how to assign formats

6.2 Specifying options for naming formats

6.3 Mapping outputclass attribute values to formats

6.4 Mapping element paths to output formats

6.5 Mapping element attributes to output formats

6.6 Specifying formats for cross references

6.7 Specifying formats for footnotes

6.8 Specifying options for figures

6.9 Specifying formats and options for tables

6.10 Specifying options for special lists

6.12 Specifying options for maps

6.13 Deciding where to display title and shortdesc