From 32b3e2607cdee7ade2fa71a9f5c7749196d96dc4 Mon Sep 17 00:00:00 2001 From: lordmulder Date: Thu, 6 Oct 2011 20:19:33 +0200 Subject: [PATCH] Updated translator's guide. --- doc/Translate.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/Translate.html b/doc/Translate.html index dfae9884..755b4c1c 100644 --- a/doc/Translate.html +++ b/doc/Translate.html @@ -24,7 +24,7 @@ a:visited { color: #0000EE; }

Editing the language file:

LameXP v4.xx translations are created as TS (translation) files, which can be edited using the Qt Linguist application. For new translations an empty TS file ("Blank.ts") is provided in the LameXP Git repository. When you open the empty TS file for the first time, Qt Linguist will ask for some basic settings. Here you must keep the "Source language" options at "English" and "Any Country". Change the "Target language" options to whatever language (region) you are going to translate to. Once you have edited all (or some) text strings, you can save your work to a TS file again. It is recommended to save your work to "LameXP_XX.ts", where XX should be replaced with the suitable upper-case ISO 3166-1 or ISO 639-1 country/language code (for example the German translation is saved as "LameXP_DE.ts"). You can re-open your TS file at any time in order to continue with your work. In case you want to improve an existing LameXP translation, simply download the corresponding TS file from the LameXP Git repository and edit it using the Qt Linguist tool.

-

The latest translation (TS) files can always be found in the LameXP Git repository at:
https://github.com/lordmulder/LameXP/tree/master/etc/Translation

(After you have chosen a file from the directory tree, you can download the file by right-clicking on "raw" an choosing "Save Link Target As...")

+

The latest translation (TS) files can always be found in the LameXP Git repository at:
https://github.com/lordmulder/LameXP/tree/master/etc/Translation

After you have chosen a file from the directory tree, you can download the file by right-clicking on "raw" an choosing "Save Link Target As...".

Important: Before you start translating, always make sure your download the latest "Blank.ts" file from the LameXP Git repository. If you want to edit an existing translation, including translations you have created yourself, make sure your download the latest TS file from the LameXP Git repository. Never ever do any translations based on an old working copy (TS file) from your local system! The translation files in the repository will be updated continuously, as the development proceeds.


Language file editing rules:

@@ -40,7 +40,7 @@ Only language files that have been edited according to the following rules can b

Testing your translation:

-

LameXP v4.xx needs to be re-built from the sources in order to integrate a new translation or to update one of the "built-in" translations. However there is an easy method to test your translation file without re-building LameXP: Open your current translation (TS) file in the Qt Linguist application and goto "File" -> "Release As...", which allows you to save your translation as a "release" (QM) file. Once saved as a QM file, you can load your translation in LameXP. Just goto "View" -> "Language" -> "From File..." and choose the desired QM file. Your translation should be in effect immediately. If you notice that your translation needs further modifications, go back to the TS file for editing. Then, for your next test run, create a new QM file from the updated TS file.

+

LameXP v4.xx needs to be re-built from the sources in order to integrate a new translation or to update one of the "built-in" translations. However there is an easy method to test your translation file without re-building LameXP: Open your current translation (TS) file in the Qt Linguist application and goto "File" ⇒ "Release As...", which allows you to save your translation as a "release" (QM) file. Once saved as a QM file, you can load your translation in LameXP. Just goto "View" ⇒ "Language" ⇒ "From File..." and choose the desired QM file. Your translation should be in effect immediately. If you notice that your translation needs further modifications, go back to the TS file for editing. Then, for your next test run, create a new QM file from the updated TS file.


Submitting your translation:

Once you are done with your translation (i.e. all items and all contexts have a green ✔ icon), you can submit it, so it can be integrated into the next LameXP release. You can contact me by e-mail:
mulder2[at]gmx[dot]de

-- 2.11.4.GIT