## Drago translation

### Current status

Drago is currently translated into 13 languages: Chinese (simplified, traditional and Martian), Czech, English, French, German, Hungarian, Japanese, Korean, Polish, Russian, Slovak, Spanish, Turkish and Vietnamese. The available translation files may be found in the install directory.

### Translation files

The translation files are text files with ini-like format:

... File=Fichier Navigation=Navigation ... 

The left side is in English, the right side is the translation. The file is organized by windows, dialog boxes, messages, etc. To start a translation, choose the available language closest to your own language or use the English translation file.

As Drago is Unicode enable, the translation files are encoded using UTF-8 format which enables to store any character from any language. As long as you correctly see the translation in your editor and in Drago, you should not worry about encoding.

### To translate

Two solutions:

1/ Use NotePad, or any text editor UTF-8 enable.

2/ Use LangPad. I have written this tool to help translators of Drago. It handles directly UTF-8 and has some features which I hope may be useful.

LangPad is very simple and very close to NotePad in what concerns standard editing. The only things worthy to mention are:

• it opens and saves files directly in UTF-8.
• You can display only the lines to be completed by selecting the Filter>To be completed menu. When pushing again the Filter button, the file is shown without filtering, the cursor being on the current line when leaving the filter mode.
• You can display only the lines containing a given string by selecting the Filter>Filter on search menu. The same applies when pressing again the Filter button. Note that the search is case sensitive and applies to the whole line.

Hope this help!

### Some notes about the translation files

#### "BOM" (Byte Order Mark)

You may see three weird characters at the start of the translation files. These three characters are "ï»¿" and have a special meaning. They tag the files as being UTF-8 and enable for instance NotePad to open these files directly as UTF-8 without specifying it. Depending on the editor you use, they may appear or disappear. As long as you see your translation correctly in Drago, all is ok.

Strings starting with a semicolon ";" are comments, giving some explanations or the name of the dialog where come from the strings to translate. These comments do not appear in Drago and can be ignored when translating.

#### Translation credit

The string \$TranslationCredit stores a message appearing in the About dialog box with url and mail address active links. It can be initialized with some message, your name, mail or website (at most 3 lines separated by \n). Take a look at the current translations to get the idea.

#### Translations dependant on context

Some few strings in English must be translated in other languages with different words. For instance, "game" is translated into French with "partie" or "jeu" depending on the context. The different meanings are named by the English string followed by a number in the lng file, for instance Game and Game2.

If you must disambiguate some string, please tell me. I will update the program to take this into account.

The same remarks applies for character case. The functions accessing to the language files are not case sensitive. So, some strings have different keys to cope with different cases. Refer to context or another translation file.

Format specification

Some strings include the character % followed by a letter (%s, %d, %f) possibly with some value between % and the letter (%2.2f). This is a notation used in a lot of programming languages and is replaced at run time by a string or a numerical value.

It is important to keep unchanged this notation.

Some strings may include several % and if ever your translation needs to reverse the order of the values, you can used the notation used in this example from Turkish:

 Page %d of %d=%1:d sayfanÄ±n %0:d.si

Printing formats

Some strings appear in the print section and are related to the formats of headers, footers and titles. Some keywords, starting with a slash character (e.g. \game or \left), enable to specify the format and are not to be translated.

Shortened strings

Some strings to be translated are shortened (two currently). They are related to the longuest messages and end with "etc.". Please refer to the English translation file to get the complete message.

### To conclude

Remember that:

• You can see your translation at work without quitting and starting again Drago. Just open the option dialog and press Ok. This will update the translation.
• New versions add some strings to translate, usually very few compared to the current file.
• I will be always very glad to help you if you have any question or problem.