39.4.2 Editing a project configuration file

DITA2Go maintains a set of annotated templates for starting project configuration files, in directory %OMSYSHOME%\d2g\system\starts, to accommodate settings intended to apply only or primarily to individual conversion projects. Do not modify these templates; they will be overwritten each time you update DITA2Go. Instead, if you want to customize a starting project configuration file for your particular operating environment, copy the appropriate file to %OMSYSHOME%\d2g\local\starts and edit it there.

To modify settings for an individual conversion project, edit the project configuration file located in the project directory.

When you set up a new conversion project, the DITA2Go Project Manager copies a starting project configuration file, named for the output type you specified, into your project directory. This new file is copied from:

The output type you want to produce determines which starting project configuration file the DITA2Go Project Manager copies to the project directory. Table 39-5 lists the names of these files.

Table 39-5 Output types and starting project configuration files

Category

Output type

Project configuration file

Ref.

HTML-based Help

Eclipse Help

_d2eclipse.ini

21

Microsoft HTML Help

_d2htmlhelp.ini

18

JavaHelp

_d2javahelp.ini

20

OmniHelp

_d2omnihelp.ini

19

Oracle Help for Java

_d2oraclehelp.ini

20

HTML

Standard HTML 4.0

_d2html.ini

22

XHTML 1.0

_d2xhtml.ini

22

XML

DITA XML

_d2dita.ini

24

Docbook XML

_d2docbook.ini

26

Generic XML

_d2xml.ini

23

RTF

WinHelp

_d2winhelp.ini

17

Print RTF

_d2rtf.ini

15

Near the top of each starting project configuration file you will find a setting that links that file to an output-specific configuration file. For example, for Word output:

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

Avoid disturbing this setting, or you might break the chain that leads to all the other configuration settings that apply to your conversion project. If you are using a source-specific configuration file, your starting project configuration file will also include a setting that links to that file; for example:

[Templates]
Document = g:\omnisys\ug\_config\m2gug_htm_document.ini

See §39.4.3 Editing a document-specific configuration file and §39.4.4 Editing an output-specific configuration file.

The DITA2Go Project Manager helps you specify additional settings for both starting and source-specific configurations.

Previous Topic:  39.4.1 Understanding what configuration files are available

Next Topic:  39.4.3 Editing a document-specific 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.3 Editing a document-specific configuration file

39.4.4 Editing an output-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