This section summarizes DITA-specific default values and recommended options for configuration settings in the following areas:
DITA2Go sets the following default values for the PUBLIC declaration, depending on the DITA version and on the topic type. For example, for DITA version 1.1 and topic type concept:
[HTMLOptions] HTMLDocType="-//OASIS//DTD DITA 1.1 Concept//EN" HTMLDTD="docs.oasis-open.org/dita/v1.1/CS01/dtd/concept.dtd"
If you need the declaration to comply with the requirements of third-party tools, you can override the default values. See §41.7.2 Overriding settings in a DITA content model and §41.7.4 Overriding declarations in a DITA map content model.
The following XML settings cannot be overridden:
[HTMLOptions] AlignAttributes = No NoFonts = Yes
[Tables] TableAttributes = No
These settings provide DITA-specific default values for assorted options; you do not have to include the following settings in your configuration file unless you change their values:
[HTMLOptions] ; The following are the DITA-specific defaults for each setting: FileSuffix = .dita RemoveANames = Yes ATagElement = xref XMLEncoding = UTF-8 NumericCharRefs = No FootInlineTag = fn HardRetPara = No RemoveEmptyParagraphs = Yes RemoveEmptyTableParagraphs = Yes
See §22. Converting to HTML/XHTML.
Keep empty paragraphs empty (if not removed):
[HTMLOptions] EmptyParaContent =
See §30.2.5 Providing content for empty paragraphs.
The CSS file DITA2Go generates for DITA specifies classes only, no tags, so that it can be used for HTML outputs generated from the DITA files. These options are in effect by default:
[CSS] WriteClassAttributes = No ClassIsTag = No
which results in [DITAOptions]UseOutputClass=No.
To include CSS class names, specify [DITAOptions]UseOutputClass=Yes, then convert @outputclass to class attributes in the HTML. Setting [CSS]UseCSS=Yes also sets [DITAOptions]UseOutputClass=Yes; see §31.4.1 Specifying CSS options in a DITA2Go configuration file.
Note: To include CSS class names as outputclass attributes, make sure your configuration file does not specify [CSS]WriteClassAttributes=No.
By default, DITA output includes all context-sensitive help targets provided in your source document via TopicAlias PI markers, in the following form:
<data name="topicalias" value="IDH_about" />
To exclude these targets from DITA output:
[DITAOptions] ; UseTopicAlias = Yes (default, include CSH targets in DITA output) ; or No UseTopicAlias=No