Tag Label and Role Translation

Overview

Second Site has a tag label translation feature which is used to modify the tag labels from the TMG project before they are included on an output page. The facility was initially intoduced because old versions of TMG do not support non-English labels for some standard tag types. The feature was also useful because some tag labels are not optimal for web page output. For example, people browsing a site should see "Father" rather than "Father-Bio".

Second Site also has a role label translation feature which is used to modify role labels. Role label translation is useful when the role labels you use within TMG are not optimal for use in published output.

Second Site includes pre-built translation files and most users will not need to create or modify them. The files includes with Second Site include tag label translation values. They do not include any role translation entries.

The following information is intended for advanced users.

INI Files

Second Site's translation values are specified in INI files. The INI files are stored in the Defaults folder. The INI filenames vary by language, so English (U.S.).ini is used when Language.Site Language is set to "English (U.S.)", Dutch.ini is used when Language.Site Language is set to "Dutch", etc.

You may supply your own translation file by placing the file in the Defaults folder under your User Data Folder. Your file should only contain the sections and values you want to add or change: the entries you specify are added to the entries supplied by the file included with Second Site.

A translation INI file may include TagNames and RoleNames sections. Both are optional.

[TagNames]
...
[RoleNames]
...

Tag Label Translation

At the start of the Make Site process, Second Site reads tag labels from the TMG project. Second Site uses the TMG tag label in the current language (as defined by Language.Site Language) as a lookup value for its tag label translation facility.

For example, if the TMG tag label is "Father-Bio", and Language.Site Language is set to "English (U.S.)", then the following entry in the English (U.S.).ini file determines the value displayed by Second Site:

[TagNames]
Father-Bio= Father

Similarly, the entry below is from the Dutch.ini file:

[TagNames]
Vader-Bio= Vader

Role Label Translation

At the start of the Make Site process, Second Site reads role labels from the TMG project. Second Site uses the TMG role label in the current language (as defined by Language.Site Language) as a lookup value for its role label translation facility.

For example, if a Census tag has a role "ChildNoAge", and Language.Site Language is set to "English (U.S.)", then the following entry in the English (U.S.).ini file determines the value displayed by Second Site:

[RoleNames]
Census.ChildNoAge= Child

The translation value above will only apply to the ChildNoAge role of the Census tag type. If you want a role label translation to apply to all tag types, omit the tag type portion of the entry:

[RoleNames]
ChildNoAge= Child