The <Translations> option is used to translate all Gigatrees5 system text, that is all output text that is controlled by the application. It cannot translate user GEDCOM data. If you need to translate user GEDCOM data, see the <Placeholders> option. By default, the build file loads the default language translation file ( lang.xml ) which translates the default English text into alternate English text. In most cases, the two are identical, but as can be seen in the example below (text from the default language translation file), there are some differences. English speakers can use this feature to manually modify displayed text. International users can use it to translate the default text into their native language. Text can be translated manually by editing the file directly (or a copy thereof) or by using the auto translation service.

Gigatrees5 supports the free Yandex translation service. The service is easy to use and automatic, but does require an API Key (https://translate.yandex.com/developers/keys) to be entered into the configuration. The configuration also allows you to save the translated text into a new configuration file which can then be used to replace the default language translation file in the the build file.

<AutoTranslate> [ false ] Setting to true enables the auto translation feature.
<AutoTranslateLangCode> [ ] The language code for the language being translated into. The following languages (codes) are supported: Afrikaans (af), Amharic (am), Arabic (ar), Basque (eu), Belarusian (be), Bengali (bn), Bosnian (bs), Bulgarian (bg), Catalan (ca), Chinese (zh), Croatian (hr), Czech (cs), Danish (da), Dutch (nl), Estonian (et), Finnish (fi), French (fr), German (de), Greek (el), Gujarati (gu), Hebrew (he), Hindi (hi), Hungarian (hu), Icelandic (is), Indonesian (id), Irish (ga), Italian (it), Japanese (ja), Javanese (jv), Kannada (kn), Korean (ko), Latvian (lv), Lithuanian (lt), Malay (ms), Norwegian (no), Persian (fa), Polish (pl), Portuguese (pt), Punjabi (pa), Romanian (ro), Russian (ru), Scottish (gd), Serbian (sr), Slovakian (sk), Slovenian (sl), Spanish (es), Swahili (sw), Swedish (sv), Tamil (ta), Telugu (te), Thai (th), Turkish (tr), Ukrainian (uk), Vietnamese (vi), Welsh (cy).
<AutoTranslateOutputFile> [ ] Specify a configuration file into which to save the translated text strings.
<AutoTranslateQueryDelay> 0 Gigatrees5 queries the translation servers without any delay between requests. If you are getting errors from the service for accessing it too quickly, you can throttle your requests my adding a delay between queries. The units of this setting is in milliseconds, so that a value of 1000 is equivalent to a 1 second delay.
<YandexAutoTranslateKey> [ ] Your free Yandex API key
<Translate> This tag indicates the start of a new translation string.
<English> [ ] The default English text to be displayed by default.
<Display> [ ] The translated text to be display instead of the English text.

<AutoTranslate> true </AutoTranslate>
<AutoTranslateLangCode> fr </AutoTranslateLangCode>
<AutoTranslateOutputFile> french.xml </AutoTranslateOutputFile>
<AutoTranslateQueryDelay> 0 </AutoTranslateQueryDelay>
<YandexAutoTranslateKey> [YOUR_API_KEY] </YandexAutoTranslateKey>

<Translate> <English> Arrival </English> <Display> Arrival </Display> </Translate>
<Translate> <English> Article References </English> <Display> Blog Posts </Display> </Translate>
<Translate> <English> Articles </English> <Display> Blog </Display> </Translate>
<Translate> <English> Associated Father </English> <Display> Father </Display> </Translate>
<Translate> <English> Associated Mother </English> <Display> Mother </Display> </Translate>