This section summarizes DITA-specific default values and recommended options for configuration settings in the following areas:
Assembling files for distribution
Mif2Go 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:
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:
HTMLDocType="-//OASIS//DTD DITA Composite//EN"
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 §32.7.2 Overriding settings in a DITA content model.
The following XML settings cannot be overridden:
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:
; The following are the DITA-specific defaults for each setting:
RemoveEmptyTableParagraphs = Yes
If your document uses run-in headings only for presentational purposes, you might want to set RunInHeads=Runin; see §21.3.2 Converting sidehead and run-in paragraph formats.
See §13 Converting to HTML/XHTML.
Keep empty paragraphs empty (if not removed):
See §21.3.10 Providing content for empty paragraphs.
Footnotes are DITA-specific, but you can remove them:
A footnote that appears in a <title> element will be wrapped in a <ph> element. If you are using the DITA Open Toolkit, see §15.10.5 Omitting <xref> elements from footnotes.
By default, Mif2Go suppresses FrameMaker autonumbers for DITA:
Autonumbers violate DITA architecture. However, if you use FrameMaker numbering properties for purposes that have nothing to do with numbering, you can override the suppression for selected paragraph formats:
By default, Mif2Go converts forced returns (FrameMaker Shift+Enter) to spaces for DITA. To simply close and reopen the paragraph tag (without attributes) instead:
To do so selectively by paragraph format:
See §14.4.5 Configuring forced returns for XML.
To preserve line or page breaks in DITA, see §15.4.8 Including PIs for line, column, or page breaks.
Do not assign the [HTMLStyles] Split property to any FrameMaker format. For DITA, Mif2Go splits files according to topic starts; see §15.8.2 Splitting FrameMaker files into DITA topic files.
By default, for DITA XML output Mif2Go adds a px suffix to width and height attribute values for images sized in pixels. To omit the suffix:
See §23.9.5 Specifying px units for graphics sized in pixels, and §15.7.7 Understanding why images might look incorrectly scaled.
For DITA version 1.1 Mif2Go uses FrameMaker sort strings to produce index-sort-as elements, so you might want to set the following Help option:
See §7.5.9.4 Choosing whether to use FrameMaker index sort strings, and §15.4.10 Converting index markers to <indexterm> elements.
The CSS file Mif2Go 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:
which results in [DITAOptions]UseOutputClass=No.
To include CSS class names, specify [DITAOptions]UseOutputClass=Yes, then convert @outputclass to class attributes in the HTML; see §15.4.6.6 Providing outputclass attributes for all elements. Setting [CSS]UseCSS=Yes also sets [DITAOptions]UseOutputClass=Yes; see §22.4.2 Specifying CSS options in a Mif2Go configuration file.
Note: To include CSS class names as outputclass attributes, make sure your configuration file does not specify [CSS]WriteClassAttributes=No.
By default, Mif2Go uses FrameMaker cross-reference format names and link character format names to set the @outputclass for cross references and hypertext links:
See §22.7.8 Using link format names as CSS class names.
Assembling files for distribution
These settings provide DITA-specific default values for gathering converted files for further processing; you do not have to include these settings in your configuration file if the following default values are satisfactory:
; The following are the DITA-specific defaults for each setting:
WrapCopyFiles = *.dita *.ditamap *.bookmap *.dtd *.mod *.ent *.xsd
GraphCopyFiles = *.gif *.jpg *.png *.svg
EmptyOutputFiles = *.dita *.ditamap *.bookmap *.ref *.grx
See §35 Producing deliverable results.