39.4.4 Editing an output-specific configuration file

For settings that are specific to an output type or a group of output types, but that apply to all or most of your DITA source documents, DITA2Go maintains user-modifiable output-specific general configuration files in directory %OMSYSHOME%\d2g\local\config. You can customize these files with settings that are appropriate for your particular environment. Table 39-6 lists the output-specific general configuration files you can edit.

Table 39-6 Editable local output-specific configuration files

Category

Output type

Editable configuration file

Ref.

HTML-based Help

All HTML-based Help outputs

local_d2help_config.ini

16

Eclipse Help

local_d2eclipse31_config.ini
local_d2eclipse33_config.ini

21

Microsoft HTML Help

local_d2htmlhelp_config.ini

18

JavaHelp

local_d2javahelp_config.ini

20

OmniHelp

local_d2omnihelp_config.ini

19

Oracle Help for Java

local_d2oraclehelp_config.ini

20

HTML

All HTML-based outputs

local_d2html_config.ini

22

XHTML 1.0

local_d2xhtml_config.ini

22

XML

DITA XML

local_d2dita_config.ini

24

Docbook XML

local_d2docbook_config.ini

26

Generic XML

local_d2xml_config.ini

23

RTF

WinHelp

local_d2winhelp_config.ini

17

All RTF-based outputs

local_d2rtf_config.ini

15

Near the top of each configuration file you will find a setting that links that file to an eponymous configuration template in \d2g\system\config 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 configuration files.

For example, in local_d2xhtml_config.ini:

[Templates]
; Where the rest of the configuration settings are:
Configs=%omsyshome%\d2g\system\config\d2xhtml_config.ini

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

Previous Topic:  39.4.3 Editing a document-specific configuration file

Next Topic:  39.4.5 Editing a format 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.5 Editing a format configuration file

39.4.6 Editing a language configuration file

39.4.7 Editing a macro configuration file

39.4.8 Indicating the intended scope of a configuration file