8.10 Localizing output headings, labels, and names

Your DITA2Go distribution includes several configuration templates with names of the form d2g_lang_LL.ini. These language configuration templates contain settings that specify the content of text items such as headings, labels, and file names that will appear in output. Collecting these settings in separate configuration templates gives you a convenient place to localize all such values for your project. However, you can override a language setting in your project configuration file or anywhere in the chain of general configuration files.

To specify which language configuration template to use for your DITA2Go project:

[Templates]
; Languages = path to language-specific .ini file 
Languages = %OMSYSHOME%\d2g\local\lang\local_d2g_lang_en.ini

DITA2Go checks the referenced language template whenever a text setting does not appear in your project configuration file or in any general configuration file. The default language is English, and the default language template is d2g_lang_en.ini. To use a different language, reference one of the other language configuration files in \d2g\local\lang. See §39.1.6 Understanding how language templates are organized.

Several sections in the language configuration files provide text for the <name/> building blocks of subformat form properties. For example:

[RuninHeadText]
NoteHead = Note:
AttentionHead = Attention: 
CautionHead = Caution:

See §8.6 Configuring run-in headings for text formats.

One language configuration section contains typographic and other miscellaneous text assignments:

[ElementText]
; Quotes = left double, right double, left single, and right single,
; in a space-delimited list, for <q> element, nested alternately.
Quotes = “ ” ‘ ’
; CascadeSeparator = text to use beteen items in <menucascade>
CascadeSeparator = \~|\~
; BorderType = key to identify border formats in outputclass lists
; of formats, used to set border format for that element.
BorderType = border
; ShadeType = key to identify shade formats in outputclass lists
; of formats, used to set shade format for that element.
ShadeType = shade

Quotes specifies the delimiters to be used around text converted from <q> elements; see §8.1.5 Including typographic tags and character formats.

CascadeSeparator specifies the separator character(s) to be inserted between items converted from <uicontrol> elements; the default is “ | ”, a vertical bar with a space on either side. The separator does not appear if the <uicontrol> elements are not in a <menucascade>. However, it does appear for any elements derived from those two.

BorderType and ShadeType specify the text strings DITA2Go checks for, in the following places:

If you change these values in a language configuration file, you must be sure to substitute the same values in all border and shading subformat names, and in element outputclass attributes in your document, if you have used these keys there. See §8.2 Defining border subformats and §8.3 Defining shading subformats.

Text settings depend on subformat names

Many of the settings in language configuration files assign text to an output subformat name. If you use subformat names that are different from those specified in the language configuration templates, you must assign each of your preferred subformat names to the corresponding DITA2Go subformat name; see §8.1.3 Assigning additional names to subformats.

Previous Topic:  8.9 Configuring trademark formats

Next Topic:  9. Specifying conditional processing

Parent Topic:  8. Configuring format components

Sibling Topics:

8.1 Managing format components

8.2 Defining border subformats

8.3 Defining shading subformats

8.4 Overriding border and shading properties

8.5 Configuring output numbering properties

8.6 Configuring run-in headings for text formats

8.7 Defining cross-reference output formats

8.8 Configuring index see and see-also entries

8.9 Configuring trademark formats