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

Table of ContentsIndex