39.5.1 Creating a template from a project configuration file

To create a general configuration template:

  1. Copy one of your configuration files (one that has the most commonly used settings) to another directory, and give it a different name with extension .ini; for example MyTemplate.ini.
  2. Delete from MyTemplate.ini any settings that apply only to the particular project from which you copied the configuration file. Also delete all macro definitions.
  3. Delete from all your project configuration files any unused sections that have settings in MyTemplate.ini.
  4. Delete from all your project configuration files any settings that occur in MyTemplate.ini, unless a setting has a different value. Settings in a project configuration file override those in a configuration template.
  5. In your project configuration file, specify the following to reference the template:

    [Templates]
    ; Configs = path to configuration template file
    Configs=path\to\MyTemplate.ini

Because you originally copied MyTemplate.ini from your project configuration file, MyTemplate.ini still has a setting referencing the next configuration template in the chain supplied by DITA2Go; so the template chain remains unbroken.

The idea is to have as little as possible in individual project configuration files, and keep most common settings in the template. However, there are a few settings that can appear only in the project configuration file; see §39.5.2 Deciding what to include in a general configuration template.

Previous Topic:  39.5 Creating your own configuration templates

Next Topic:  39.5.2 Deciding what to include in a general configuration template

Parent Topic:  39.5 Creating your own configuration templates

Sibling Topics:

39.5.2 Deciding what to include in a general configuration template

39.5.3 Chaining configuration templates

Table of ContentsIndex