#### 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:

- local\starts if a configuration file with the correct name is present; any files here are starting project configuration files you have customized to suit your operating environment.
- system\starts if there is no file with the correct name in the local\starts directory.

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

Table of Contents • Index