#### 37.2.1 Understanding DITA2Go-supplied macro libraries

Your DITA2Go distribution includes several macro library files in the form of macro configuration templates, listed in Table 39-9. These macro libraries are located in directory %OMSYSHOME%\d2g\macros. The templates are chained together by references.

Table 37-3 Dita2Go macro libraries

Macro library | Scope of macro settings | Referenced template
    d2g_macros.ini
| All DITA2Go projects |
    (None)
    d2htm_macros.ini
| DITA2Go HTML/XML projects |
    d2g_macros.ini
    d2rtf_macros.ini
| DITA2Go RTF projects |
    d2g_macros.ini

To access a macro library (for example):

    [Templates]
    ; Macros = path to macro library file
    Macros = %OMSYSHOME%\d2g\d2htm_macro.ini

DITA2Go checks the referenced chain of macro libraries whenever a macro you invoke is not defined in your project configuration file.

A macro library file can include another [Templates]Macros setting, to make a chain of macro libraries to be searched; the chain can be any length. However, all files in the chain must have distinct names; the chain stops if DITA2Go finds a repeat.

Your DITA2Go project configuration file should reference d2htm_macros.ini or d2rtf_macros.ini, either directly or indirectly through your own macro library file.

See also:

§39.2 Referencing configuration files and templates

§37.2.4.3 Creating a chain of macro libraries

Previous Topic: 37.2 Accessing DITA2Go macro libraries

Next Topic: 37.2.2 Modifying DITA2Go-supplied macro definitions

Parent Topic: 37.2 Accessing DITA2Go macro libraries

Sibling Topics:

37.2.2 Modifying DITA2Go-supplied macro definitions

37.2.3 Storing a macro definition in a separate file

37.2.4 Including macro definitions in your own macro library