¶ Summary
A translation dictionary can be created for a specific config. A variable can be created, and given different language strings, one for each language.
The user will then be displayed the text appropriate for their language.
¶ Variables
Any text can be used as a variable. A variable can be understood as a placeholder - this variable can be used in elements, for instance for the caption of a button.
The application will then attempt to look up a valid translation of that text, and display it instead of the placeholder.
Example
A good variable name might beHOME_BUTTON_SETTINGS. It is written in a unique-enough way that other users of the config are not likely to randomly type this text for their elements. It also describes what it does - it is the caption of a button on the home page that will lead to the settings menu.
Now, when creating a button, the element title can be set toHOME_BUTTON_SETTINGS, and it will use this variable.
¶ Language store
Different options for a variable are saved in a language store. This store is config-specific, and contains full texts for a variable in different languages.
Example
Given the previous example, the language store could contain an entry for the english dictionary
HOME_BUTTON_SETTINGS:Settings, and the german dictionary might contain
HOME_BUTTON_SETTINGS:Einstellungen.
When the home page is not presented to a user who set his app to english, they will see the captionSettings. A german user would seeEinstellungenhere instead.
To access this language store, navigate to the overview of a config (where the individual pages of config are listed), and click the icon with the speech bubbles.
On the next page, a new language can be added by clicking the +-icon in the upper left corner. A dropdown menu will appear, and languages may be searched in here. Click confirm to confirm your selection.
Click on Edit to start adding variables to this language.
On the next page, variables can be added by clicking the +-icon in the upper left corner. After confirming this, the variable will now appear as a row in the table below. It can then be assigned a value.
Changes on this page need to be confirmed by clicking the Save-icon.
¶ Using auto-translation
While on the page that displays the language added to a config, instead of editing a language, it can also be translated. To do this, first create a second language you want to translate to, and then click on Translate on the first language.
The resulting table will display three columns
- Variable name
- Text for language 1
- Text for language 2
The languages can be selected in the fields above the table.
Afterwards, the arrows (->, <-) can be used to translate a singular text into the other language.
By clicking the arrows next to the languages at the very top, all texts are translated. Use with caution.
Changes here, too, need to be saved manually.