37.2.4.1 Creating
a macro library
To create your own macro library:
- Create
a new text file for your macro library. Give the file extension .ini, and
either place it in your project directory or specify an absolute path
to its location. It is a good idea to use the same location for macro
library files for all your DITA2Go projects.
- Add
macro definitions to the file, each in its own section, as described
in §37.1.1
Defining macros.
- Put
a non-macro dummy section at the end of the file; for example:
[End]
Otherwise, the last macro in the library
might cause an extra character to be included in output.
- Make
your library file reference d2rtf_macros.ini
or d2htm_macros.ini,
and make your project configuration file reference your library file.
For example, suppose you create a text file called MyMacros.ini,
and place it in D:\MacroLibs.
In MyMacros.ini:
[Templates]
Macros = %OMSYSHOME%\d2g\d2htm_macro.ini
In your project configuration file:
[Templates]
Macros = D:\MacroLibs\MyMacros.ini
If you omit a path, DITA2Go looks
for MyMacros.ini
in your project directory.
Because MyMacros.ini
is closer to your project configuration file in the chain of macro libraries,
your macro definitions take precedence over any definitions of the same
macros further away from your project configuration file in the chain.
Default
macro library
If you do not specify a value for Macros, and
you invoke a macro that is not defined in your project configuration
file, DITA2Go looks in %OMSYSHOME%\d2g\macros
for a file named d2htm_macros.ini
or d2rtf_macros.ini.
Previous Topic:
37.2.4 Including
macro definitions in your own macro library
Next Topic:
37.2.4.2 Creating
a file-specific macro library
Parent Topic:
37.2.4 Including
macro definitions in your own macro library
Sibling Topics:
37.2.4.2 Creating
a file-specific macro library
37.2.4.3 Creating
a chain of macro libraries
Table of Contents • Index