Home

Here, you will learn how to use i18nDotPropertiesGUI as a end user, a translator.
Voir le wiki en version française.

First step: download the app

You can download i18nDotPropertiesGUI here. At the bottom of the page, under "Assets", you can download the file matching with you operating system.

Warning: There is special instructions for Mac OSX installation

How to use the app ?

Load .properties translation files

On this pane, you can select all the translations files you want to use:

• Source translation: this is the source translation file, an already translated file, that you will use as an example to translate a new language.
• Alternative translation: almost the same of the source translation, you can use it as another known translation to help you.
• Target translation: this is the translation you will create. You can just create a new file xx_xx.properties and open it in the app.

Starting translating

After having choosed at least a source and target translations file, you will see a list of translations. You can select one of them, and on the second panel, you will be able to type the target translation. You will have some informations like the key of the translation, the source translation value, maybe an alternative translation value, and maybe some comments (preceded by #) that could be define in the source translation file.

You can also edit source and alternative translations by clicking on the source/alternative text.

Don't forget to save frequently (Ctrl/Cmd + S).

Argument system

Some translations can use arguments. Arguments are just some informations (file name, number...) that can be dynamically changed by the software that use this translation. For example, the final sentance This event ends in 10 minutes, would be written as This event ends in {0} minutes in the translation file, therefore, the number of minute can be edited dynamically by the software.

Arguments are marked as {0}, {1}, {2}, etc...

Shortcuts

In the target translation field, you can use some shortcuts to work faster:

• Ctrl + Space : Add the next argument into the target translation text field (ex: {0}, {1}...)
• Ctrl/Cmd + Shift + C : Copy the source translation into the target translation text field
• TAB or Shift + Enter : Skip to the next translation

Also, you can search for a translation with Ctrl/Cmd + F, and sort translations by clicking on the columns title.

Good luck !