39.4.5 Editing a format configuration file

For settings that define output formats, DITA2Go maintains user-modifiable format configuration files in directory %OMSYSHOME%\d2g\local\formats. You can customize these files with settings that are appropriate to your particular needs. Table 39-7 lists the format configuration files you can modify.

Table 39-7 Output types and format configuration files

Output type

Editable format configuration file

HTML

local_d2htm_formats.ini
local_d2htm_subformats.ini
local_d2htm_tables.ini
local_d2oraclehelp_tables.ini

RTF

local_d2rtf_formats.ini
local_d2rtf_subformats.ini
local_d2rtf_tables.ini
local_d2rtf_pages.ini
local_d2winhelp_formats.ini
local_d2winhelp_tables.ini

The main format configuration files (those with _formats in their names) are referenced from output-specific general configuration files. The main format files reference subformat and table configuration files, and for Word output, a page-layout configuration file.

Near the top of each editable format configuration file you will find a setting that links that file to an eponymous configuration template in a \d2g\system\formats that contains settings commonly needed for the output type you selected. Do not edit the referenced templates; they will be overwritten each time you update DITA2Go. Instead, override settings as needed in the editable format configuration files in \d2g\local\formats.

Each format configuration file contains settings commonly needed for the output type indicated by the name of the file. Near the top of each format configuration file you will find a setting that links that file to other format configuration files. For example, in local_d2rtf_formats.ini:

[Templates]
; Where the rest of the format configuration settings are:
Formats=%omsyshome%\d2g\system\formats\d2rtf_formats.ini

Avoid disturbing this setting, or you might break the chain that connects to all the other format settings for your conversion project.

Before you add settings to the editable format configuration files, see:

§7. Configuring output formats

§8. Configuring format components.

Previous Topic:  39.4.4 Editing an output-specific configuration file

Next Topic:  39.4.6 Editing a language configuration file

Parent Topic:  39.4 Deciding which configuration file to edit

Sibling Topics:

39.4.1 Understanding what configuration files are available

39.4.2 Editing a project configuration file

39.4.3 Editing a document-specific configuration file

39.4.4 Editing an output-specific configuration file

39.4.6 Editing a language configuration file

39.4.7 Editing a macro configuration file