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