Most of the supplied DITA2Go configuration files available for editing are located in subdirectories of %OMSYSHOME%\d2g\local, with the following exceptions:
Table 39-3 lists the types of configuration files, shows where the files are located, and indicates the intended scope of settings for each type.
Each configuration file in a \d2g\local subdirectory references an eponymous configuration template in a \d2g\system subdirectory that contains default settings. Do not edit those referenced templates, because they will be overwritten whenever you update DITA2Go. Instead, override settings in the corresponding \local configuration file.
Table 39-4 shows a sample hierarchy of configuration files for an HTML Help project, with the most widely applicable configuration at the top of the chain, and the most narrowly applicable (the project configuration file) at the bottom. With the exception of the document-specific configuration file (shown in green), each file in Table 39-4 references the file above it. The project configuration file at the bottom references both the document-specific file and the next configuration file above that.
Each configuration file in the chain can override settings in all those above it in Table 39-4. This is true even for a document-specific configuration file that does not reference any of the other configuration files, because it is treated as though it were right above the project configuration file. If a document-specific configuration file does reference other configuration files, DITA2Go treats all their settings as overruling any files above the project configuration file in the main chain.
Note: Edit only the files shaded in blue or green; the others are system files.
General configuration settings
If you have just one DITA document to convert to a single output type, most general configuration settings can go in the project configuration file; see §39.4.2 Editing a project configuration file.
If you think you might want to produce other types of output from the same source document, settings that are the same for all output types (but that would be different for other source documents) can go in a document-specific configuration file; that way you avoid duplicating the settings in every project configuration file. See §39.4.3 Editing a document-specific configuration file.
If you have many DITA documents to convert to a single output type, settings that are specific to that output type and the same for every document (but that would be different for other output types) can go in the appropriate output-specific configuration file; see §39.4.4 Editing an output-specific configuration file.
To override DITA2Go default format configuration settings, redefine output formats by adding the definitions you prefer to the appropriate output-oriented format configuration files in d2g\local\formats. See §39.4.5 Editing a format configuration file.
To override DITA2Go default text values for the output language you wish to use, specify settings for alternate text in the appropriate language configuration file in d2g\local\lang. See §39.4.6 Editing a language configuration file.
You can add macros to editable source-specific, output-specific, or project configuration files, as needed. Or you can add them to a macro library configuration file in d2g\local\macros. See §39.4.7 Editing a macro configuration file.