#### 39.3.1 Referencing a document-specific configuration file

To reference a document-specific configuration file:

    [Templates]
    ; Document = path to document-specific configuration file
    Document = %OMSYSHOME%\d2g\documents\mydocname_doc.ini

Or:

    [Templates]
    ; Document = path to local document-specific configuration file
    Document = mydocsource\_config\outputtype_doc.ini

It is a matter of preference whether you keep document-specific configuration files for all documents in one central location (for example, the %OMSYSHOME%\d2g\documents directory included in your DITA2Go distribution for this purpose) or in a _config subdirectory under your DITA source directory; see §39.3.2 Deciding where to keep document-specific configuration files.

DITA2Go processes the entire Document chain before continuing with the Configs chain. The Document chain is interpolated between your starting project configuration file and the Configs chain that your project configuration file references. Settings in the Document chain override settings in the Configs chain.

Although it cannot reference general configuration files, a document-specific configuration file can reference other types of configuration files via the following [Templates] settings:

Document | Other document-specific configurations
Macros | Macro libraries
Formats | Output formats
Lang | Text of headings and labels

Settings in files referenced by a document-specific configuration file override settings in other types of files referenced by your project configuration file. Settings in your project configuration file override settings in the Document chain.

Table 39-2 Configuration options determined at run time

Configuration section | Option | Ref.
    Setup
    FileSuffix
| 4.1.6
    HelpOptions
    MakeCombinedCnt
| 17.2.6

Previous Topic: 39.3 Including document-specific configuration files

Next Topic: 39.3.2 Deciding where to keep document-specific configuration files

Parent Topic: 39.3 Including document-specific configuration files

Sibling Topics:

39.3.2 Deciding where to keep document-specific configuration files

39.3.3 Indicating the intended scope of a configuration file