tutorials:other:translation
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
tutorials:other:translation [2014/10/09 09:43] – [How translation works] tw | tutorials:other:translation [2019/07/09 16:18] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 14: | Line 14: | ||
====== Preparing the translation ====== | ====== Preparing the translation ====== | ||
+ | |||
+ | ===== Locate translation template ===== | ||
+ | |||
+ | Before we can start the translation, | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ===== Create language folder ===== | ||
+ | |||
+ | Inside the '' | ||
+ | |||
+ | To start a new translation, | ||
+ | |||
+ | If you're creating a translation for a special variant of a language for a particular country, you can also add the two-digit country code, separated by an underscore sign, to the language code, e.g. '' | ||
+ | |||
+ | **Important**: | ||
+ | |||
+ | In the end it should look like this: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ===== Copy and rename translation template ===== | ||
+ | |||
+ | Finally we have to copy the translation template '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Now we're almost ready to start the translation. | ||
+ | |||
+ | ===== Download and install poEdit ===== | ||
+ | |||
+ | While '' | ||
+ | |||
+ | When you're editing the '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | (Sorry, no English screenshot available.) | ||
====== Do the actual work ====== | ====== Do the actual work ====== | ||
+ | Having installed poEdit, you can double-click the '' | ||
+ | |||
+ | ===== Set project name ===== | ||
+ | |||
+ | The first time open the '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Enter // | ||
+ | |||
+ | ===== Enter translations ===== | ||
+ | |||
+ | Now you're ready to enter the translation strings. In the poEdit main window, there is a table that displays the English strings on the left, and the translations on the right (initially empty): | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Click a line, and enter the translation into the text field at the bottom. You can now also use the arrow keys to move to the next string. Untranslated strings are in bold and at the top of the list, finished translations are in normal text and move down to the bottom when you save the file. | ||
+ | |||
+ | |||
+ | <WRAP tip> | ||
+ | **Remember to click //Save// once in a while to save your work!** | ||
+ | |||
+ | However, mAirList must not be running at the time you save the translation in poEdit, because otherwise the '' | ||
+ | </ | ||
+ | |||
+ | When you save the '' | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | So everything is in place now, and if the language is the same as your Windows language, mAirList should automatically detect and use the file. Otherwise run mAirList Configuration, | ||
+ | |||
+ | {{ : | ||
+ | ===== Important hints ===== | ||
+ | |||
+ | There are a couple of things that you have to take special care of when doing the translation. | ||
+ | |||
+ | ==== Variables ==== | ||
+ | |||
+ | You will notice that some of the English texts contain special placeholders starting with a '' | ||
+ | |||
+ | Importing file %d of %d (%d errors). Estimated time remaining: %s | ||
+ | | ||
+ | These are variables which will be filled with the actual text or data by mAirList. In particular, you will come accross the following placeholders: | ||
+ | |||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | **It is important that the translated text uses the exact same variables, in the exact same order!** Otherwise software will crash later. For example. the above text would be translated to German like this: | ||
+ | |||
+ | Importiere Datei %d von %d (%d Fehler). Verbleibende Zeit: %s | ||
+ | | ||
+ | Note that the variables '' | ||
+ | ==== Quotation marks ==== | ||
+ | |||
+ | Inside the '' | ||
+ | |||
+ | \" | ||
+ | | ||
+ | Again it is very important that you also use a backslash sign before any double quote in the translated text: | ||
+ | | ||
+ | \" | ||
====== New program versions ====== | ====== New program versions ====== | ||
+ | When you install a new version of mAirList, it may happen that there are new strings that must be translated. The installer will put a new '' | ||
+ | |||
+ | In order to do so, open your '' | ||
+ | |||
+ | poEdit will read the new template and add any new strings to your translation (and remove obsolete ones). | ||
+ | |||
+ | Sometimes poEdit will also make a **suggestion** based on your existing translations; | ||
+ | |||
+ | ====== Make your translation available to the public ====== | ||
+ | |||
+ | When you have finished a translation for a language that is not yet supported out of the box by mAirList, we will be happy to receive your translation files and included in the official distribution from now on. | ||
+ | |||
+ | For details please contact us at [[mailto: |
tutorials/other/translation.1412847808.txt.gz · Last modified: 2019/07/09 16:19 (external edit)