Translate Vuze

From VuzeWiki

Contents 1 Translation Process 2 Install the latest Vuze beta (optional) 3 Install the i18nAZ Plugin 4 Do the Translation 4.1 Open the Translation interface: Tools⇒Plugins⇒i18nAZ 4.2 Add a Language 4.3 Select the Options 4.4 Translate the Strings 4.5 Saving the Translation 4.6 Translation Tricks 4.7 Continuing the translation 5 Submit the translation

[edit] Translation Process

The translation process is the same whether you want to :

• add a new language
• improve an existing translation

In any case, please check the internationalisation forum to be up to date on the latest translations.

[edit] Install the latest Vuze beta (optional)

To make sure you are translating the most recent version of Vuze:

• download our latest developer version
• follow the guide to install it

Alternatively, to stay up to date all the time, you can install the Vuze Beta Updater plugin:

• Tools⇒Plugins⇒Installation Wizard⇒By List From SF⇒Select AZCVSUpdater ⇒Next⇒Install the plugin for all users⇒Finish⇒Close.

[edit] Install the i18nAZ Plugin

i18nAZ plugin is a handy tool for modifying the language files. Install it:

• Tools⇒Plugins⇒Installation Wizard⇒By List From SF⇒Select i18nAZ ⇒Next⇒Install the plugin for all users⇒Finish⇒Close.

[edit] Do the Translation

[edit] Open the Translation interface: Tools⇒Plugins⇒i18nAZ

• The translation interface is a table with columns, rows and cells, similar to a worksheet.

[edit] Add a Language

• If there is already a translation => Click the "Add Language" button > Select the language from the list
• If there is no translation at the moment => Click the "New Language" button > Select the language from the list
• The translator can also add other languages that he knows (french, spanish, german, etc.) just to see how some strings were translated in those languages.

[edit] Select the Options

• Check "Flat (No Tree)" and "Fancier Editor"

[edit] Translate the Strings

• The language editor has three columns "Key", "Reference" and "Language Name (Country)"
• The column "Key" contains the section of the resource file where the string is present (can be useful for better understanding of the context in which the string is used => in the Options, in the Toolbar, etc.)
• The column "Reference" contains the text of the original string (in english).
• The column "Language Name (Country)" contains the text of the translated string.

• In order to translate a string one must select a cell under the "Language Name (Country)" column by clicking on it, then open the translation dialog by double-clicking on that cell. The dialog consists of a little window that has in its upper part a field with the reference string (in english) and in the lower part a field where the translated string must be typed. After typing the translated string and clicking OK, the translation of that particular string is done and will appear under the column "Language Name (Country)".

[edit] Saving the Translation

• The translation is automatically saved, but clicking from time to time on the "Save" button assures that the last modifications are not lost in the case of a power failure or a system crash.
• The translation is saved as a file with the extension .properties. It can be saved anywhere on the harddisk, but saving it in the Vuze installation folder is recommended, because it will be used by the program next time it is launched, if the appropiate language is selected in the options section.

[edit] Translation Tricks

• To see only the untranslated strings, the case "Show only missing/extra" must be checked. Unchecking the case will display all the strings again.
• To search for some particular strings, a keyword must be typed in the "Filter" field, then the "Enter" key must be pressed. For example to display only the strings that have the word "seed" in them, that word must be typed, then Enter should be pressed. Of course, multiple keywords can be used, for example one could search the expression "seeding a torrent". To display all the strings (not only those with the keyword), one must clear the "Filter" field by deleting the keyword and then pressing "Enter", or just click on the "Clear" button.

[edit] Continuing the translation

• Upon reopening of Vuze, the i18nAZ plugin is present as a tab, but it has no languages. To add the translation that was saved as a file:
• Click the "Add Language" button>Browse>Select the folder where the .properties file is located>OK

[edit] Submit the translation

Please post your translation in the internationalisation forum

Creating a patch of the updated language module will help others understanding how extensive your changes are. You might use a file comparison tool like WinMerge to create the patch between the original language module (e.g. exctrated from azureus2.jar, or downloaded from CVS repository) and the edited module.

Note: Some times the DOS/Unix line endings can cause patch to erroneously include all lines, so watch for that. For Windows users, one way to get a Unix line-endings (like the plugin produces) is to extract the correct original messagesbundle from azureus2.jar with WinRAR or other JAR compatible archiver tool.

Thanks a lot!