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. For XMetaL, for example:
[HTMLOptions] HTMLDocType="-//OASIS//DTD DITA Composite//EN" HTMLDTD="ditabase.dtd"
This change applies to all topic types; however, the root elements will be correct for each type, and all would be valid against the composite DTD. To make this change only for one topic type, see §41.7.2 Overriding settings in a DITA content model.
The following XML settings cannot be overridden:
[HTMLOptions] AllowOverrides = No AlignAttributes = No NoFonts = Yes
[Tables] TableAttributes = No CellAlignAttributes = No CellColorAttributes = 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.