39.1.1 Understanding how templates are organized

Your DITA2Go distribution includes templates that are linked together by references that extend through the chains, from your project configuration file through templates in %OMSYSHOME%\d2g subdirectories, to the very end of the configuration chain at %OMSYSHOME%\common\system\config\omsys.ini. See §39.1.3 Understanding how templates are chained together

Configuration templates include the following groups:

General configuration settings, located in config directories

Macro definitions, located in macros directories

Output format definitions, located in formats directories

Output text settings by language, located in lang directories.

Each template in a system subdirectory is paired with an editable configuration file in the corresponding local subdirectory. The system member of each pair contains default settings. The local member of each pair starts out empty; you add settings to override the default settings referenced in the system member. Your configuration files always reference the local member. The local member references its system counterpart, which in turn references the local member of the next template up the chain.

General configuration settings

The settings in general configuration templates establish default values for features that are not likely to differ from one project to the next, or from one output type to the next. General configuration templates are located in the following directories:

%OMSYSHOME%\d2g\system\config: default general configuration settings

%OMSYSHOME%\d2g\local\config: your overrides to the system settings

Macro definitions

General-purpose macros are defined in macro library templates. Each configuration section in these templates is the name of the macro being defined. Macro library templates are located in the following directories:

%OMSYSHOME%\d2g\system\macros: definitions of general-purpose macros

%OMSYSHOME%\d2g\local\macros: definitions of your own macros

Output format definitions

The presentation styles of paragraphs, characters, tables, and page layouts are governed by format configuration templates. These templates provide an easy way to define how you want the output to look. Format configuration templates are located in the following directory:

%OMSYSHOME%\d2g\system\formats: default format definitions and page layouts

%OMSYSHOME%\d2g\local\formats: your format definitions and page layouts

Output text settings by language

DITA2Go generates several headings and labels that appear as text in your output. Each language configuration template includes text for these headings and labels in one language. Language configuration templates are located in the following directories:

%OMSYSHOME%\d2g\system\lang: text for generated headings and labels

%OMSYSHOME%\d2g\local\lang: your overrides to headings and labels

Previous Topic:  39.1 Working with configuration templates

Next Topic:  39.1.2 Understanding how templates are named

Parent Topic:  39.1 Working with configuration templates

Sibling Topics:

39.1.2 Understanding how templates are named

39.1.3 Understanding how templates are chained together

39.1.4 Understanding how macro libraries are organized

39.1.5 Understanding how format templates are organized

39.1.6 Understanding how language templates are organized

Table of ContentsIndex