Examples of use

The following chapter demonstrates how to translate a project specific panel (via Export - Dictionary functions - Import).

Example 1

This example shows you how to translate a project specific panel which you create first from English to German. The example includes the following steps:

  1. Creation of a project-specific panel in English.

  2. Creation of the dictionary containing the entries of the panel in the reference language English - US via the Export feature.

  3. Translation of the reference language entries into the "target" language German - Austria via the Dictionary Functions.

  4. Update of the panel with the translations saved in the dictionary.

Create a project specific panel

  1. Create a multilingual project (languages English - US and German - Austria).

  2. Start the project.

  3. Open the GEDI.

  4. Select the language English from the combo box in GEDI.

  5. Create a new panel Panel -> New panel

  6. Add the following graphics objects to the panel: Buttons: Save, Cancel and OK, Texts: Translator test, Description for the Translator, Cascade Button: Engine (containing the items On and Off) and Tabs General and Values. Add also the name Trans_Test for your panel. Your panel should contain the graphics objects, displayed in the figure below:

Figure 1. Trans_Test panel

  1. Save your panel Trans_Test.pnl in your project.

Create a dictionary

  1. Open the translator panel in the GEDI via "Tools" > "Translator". The Export tab is displayed.

  2. Choose the reference language English - US from the Reference language menu.

  3. Choose the language German - Austria from the Language(s) to export menu.

  4. Select the trans_test file via "Select panels ..." button.

  5. Choose the Log progress (file level) option.

  6. Select the UTF-8 format from the drop-down menu.

  7. Press the Start button to start the export process.

Translate a project specific panel

  1. Open the Dictionary functions panel. The following table (containing the entries in English) is displayed:

Figure 2. Translator panel - Dictionary functions tab

  1. Define your translations in German (like in the following table) by clicking on the right cells (German-Austria) and by typing your translations in the Dictionary functions panel:

English German
-*-MS Shell Dlg-*-r-normal-*-11-*-100-100-*-*-iso8859-1|-11,0,0,0,505,0,0,0,0,0,0,0,0,MS Shell Dlg -*-MS Shell Dlg-*-r-normal-*-11-*-100-100-*-*-iso8859-1|-11,0,0,0,505,0,0,0,0,0,0,0,0,MS Shell Dlg
Cancel Abbrechen
Description for the translator Beschreibung für den Translator
General Allgemein
OK OK
Save Speichern
Translator test Translator Test
Values Werte
On Ein
Off Aus

  1. Press the Save button to save your dictionary.

  2. Press the Load button to load the changes you made from the dictionary.

  3. Check the same translations and empty entries. The following same translations are shown:

Figure 3. Dictionary functions - Same translations

Since the reference and export (target) language have the same translation "OK", same translations are shown.

  1. Open the dictionary.txt from <proj_path>/data/trans. The dictionary has the following structure:

Figure 4. Translated file dictionary.txt

Import the dictionary

  1. Open the Import tab.

  2. Choose the reference language English - US from the Reference language menu.

  3. Choose the language German - Austria from languages to import menu.

  4. Choose the Trans_Test.pnl from your project.

  5. Choose the Log progress (file level) option.

  6. Choose then Open log fileafter import option.

  7. Select the "dictionary.txt"´from the drop-down menu.

  8. Press the Start button to start the import process.

The log file is opened after the import process where you can see the work steps, the number of lines read from the dictionary :

The project specific panel was easily translated into German. Open the panel in VISION with the language option "de_AT.utf8"----> -extend -lang "de_AT.utf8" -p Trans_Test.pnl The translated panel (shown in the figure below) is displayed.

Figure 5. Trans_Test panel