Updated the translator's guide.
This commit is contained in:
parent
729b386056
commit
51f1fbbca1
@ -13,20 +13,34 @@ a:visited { color: #0000EE; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<!-- ============================= -->
|
||||
<h1>Howto: Translate LameXP</h1>
|
||||
<p><b>If you are willing to contribute a new LameXP v4.xx translation or update/fix an existing translation, then this guide will help you to do so :-)</b></p>
|
||||
<p><b>If you are willing to contribute a new LameXP v4.xx translation or improve an existing translation, then this guide will help you to do so :-)</b></p>
|
||||
<br>
|
||||
<img src="http://lamexp.sourceforge.net/lamexp.png" alt="Screenshot"><br>
|
||||
<br>
|
||||
<h3>Prerequisites:</h3>
|
||||
<p>LameXP v4.xx is a complete re-write of LameXP. This time LameXP is developed in C++ and it is based on the <a href="http://qt.nokia.com/products/" target="_blank">Qt</a> cross-platform application framework. The good news for translators is that Qt provides <i>full Unicode support</i>, which was also one of the main reasons for the re-write. Consequently there will be no more headache with different Codepages! Furthermore the Qt framework provides a sophisticated translation system, which allows for easy internationalization and localization. There even is an easy-to-use graphical tool for translating Qt application, the <a href="http://doc.qt.nokia.com/latest/linguist-manual.html" target="_blank">Qt Linguist</a>. So before you start translating, you should make yourself familiar with the <i>Qt Linguist</i> application. As a translator, having a quick look at the <a href="http://doc.qt.nokia.com/latest/linguist-translators.html" target="_blank">guide for translators</a> is sufficient.</p>
|
||||
<p>You can download <i>Qt Linguist</i> as a part of the "Qt SDK" or the "Qt libraries", which are available as a free download from the <a href="http://qt-project.org/downloads" target="_blank">Qt download site</a>. We recommend picking the "Qt SDK" and download the "Online installer" (∼15 MB), but you do <b>not</b> need to worry about a "commercial" license. In the Qt SDK Setup wizard, make sure you select the "Custom" install type. Then un-check all components, except for "Qt SDK" ⇒ "Development Tools" ⇒ "Qt Liguist". Alternatively, if you don't want to install the Qt SDK on your computer, you can find Qt Linguist for Windows as a <i>stand-alone</i> download at <a href="http://sourceforge.net/projects/lamexp/files/Miscellaneous/Qt%20Linguist/" target="_blank"><b>this</b></a> location (only ∼4 MB). This stand-alone version of Linguist has been built using <i>static</i> Qt libraries and thus should work "out of the box" <i>without</i> any dependencies - just unzip the ZIP file and run the "linguist.exe" file.</p>
|
||||
<!-- ============================= -->
|
||||
<h3>Introduction:</h3>
|
||||
<p>LameXP v4.xx is a complete re-write of LameXP. This time LameXP is developed in C++ and it is based on the <a href="http://qt-project.org/" target="_blank"><b>Qt</b></a> cross-platform application framework. The good news for translators is that Qt provides <i>full Unicode support</i>, which was also one of the main reasons for the re-write. Consequently there will be <b>no</b> more headache with different Codepages! Furthermore the Qt framework provides a sophisticated <i>translation system</i>, which allows for easy internationalization and localization. There even is an easy-to-use <i>graphical tool</i> for translating Qt application, which is called <b>Qt Linguist</b>. Consequently, before you start translating, you should make yourself familiar with the <i>Qt Linguist</i> application. As a translator, having a quick look at the <a href="http://qt-project.org/doc/qt-4.8/linguist-translators.html" target="_blank"><i>Qt Linguist manual for translators</i></a> should be sufficient.</p>
|
||||
<br>
|
||||
<!-- ============================= -->
|
||||
<h3>Prerequisites:</h3>
|
||||
<p>You can obtain the <i>Qt Linguist</i> application as a part of the <b>Qt</b> cross-platform application framework, which is available as a <i>free</i> download from the <a href="cross-platform application framework" target="_blank">Qt Project web-site</a>. We recommend choosing the "Qt libraries 4.8.6 for Windows (VS 2010)" download. Note that, in order to find the desired download link, you may need to click on the "Show Downloads" button first and then scroll down. In any case, the <i>free</i> "OpenSource" edition of Qt is perfectly sufficient, i.e. you do <b>not</b> need to buy the <i>commercial</i> edition of Qt offered by Digia Inc.</p>
|
||||
<p>Alternatively, if you do <b>not</b> want to download and install the <i>complete</i> Qt framework, you can download Qt Linguist (and some other Qt-related tools) as a <i>stand-alone</i> package at <a href="http://sourceforge.net/projects/lamexp/files/Miscellaneous/Qt%20Linguist/" target="_blank"><b>this</b></a> location. This stand-alone version will work "out of the box" <i>without</i> installation.</p>
|
||||
<br>
|
||||
<!-- ============================= -->
|
||||
<h3>Editing the language file:</h3>
|
||||
<p>LameXP v4.xx translations are created as TS (translation) files, which can be edited using the <i>Qt Linguist</i> 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 <i>XX</i> should be replaced with the suitable upper-case <a href="http://www.loc.gov/standards/iso639-2/php/code_list.php" target="_blank">ISO 639-1</a> Code for the representation of names of languages (for example the German translation is saved as "LameXP_DE.ts", because the corresponding ISO 639-1 code is DE). 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.</p>
|
||||
<p>The latest translation (TS) files can always be found in the LameXP Git repository at:<br>• <a href="https://github.com/lordmulder/LameXP/tree/master/etc/Translation" target="_blank">https://github.com/lordmulder/LameXP/tree/master/etc/Translation</a><br>• <a href="https://bitbucket.org/lord_mulder/lamexp/src/master/etc/Translation" target="_blank">https://bitbucket.org/lord_mulder/lamexp/src/master/etc/Translation</a><span style="font-size:0.42em"><br><br></span>After you have chosen a file from the directory tree (by left-click!), you can download the file by right-clicking on <b>"raw"</b> button/link (in the upper right corner) an choosing "Save Link As...".<br><img src="http://img192.imageshack.us/img192/803/rawy.png" alt="Raw"><br>(As people seem to have problems here: Please be sure to download the actual file content, by using the "raw" button/link. Do <i>not</i> save the page as shown in the browser, as that would only save the HTML preview of the file rather than the file itself! Also, in the directory tree view, do <i>not</i> right-click + "Save Link As..." on one of the TS files, as that would only save the HTML preview. Instead, left-click on the link to open/preview the TS file in the browser, <i>then</i> use the "raw" button/link!)</p>
|
||||
<p style="border-width:2px;border-style:solid;border-color:darkred;margin-top:2em"><font color="darkred"><b>IMPORTANT:</b> Before you start to create a new translation, always make sure you downloaded the <i>latest</i> "Blank.ts" file from the LameXP Git repository. Also before you start editing or updating an <i>existing</i> translation, including translations you have created yourself, make sure you downloaded the <i>latest</i> TS file from the LameXP Git repository. <i>Never</i> do any translations based on an old working copy (TS file) from your local system! The translation files (TS) in the Git repository will be updated/extended continuously, as the development proceeds. We cannot accept translations based on an <i>outdated</i> TS file!</font></p>
|
||||
<p>The latest translation (TS) files can always be found in the LameXP Git repository at:</p>
|
||||
<ul>
|
||||
<li><a href="https://github.com/lordmulder/LameXP/tree/master/etc/Translation" target="_blank">https://github.com/lordmulder/LameXP/tree/master/etc/Translation</a>
|
||||
<li><a href="https://bitbucket.org/lord_mulder/lamexp/src/master/etc/Translation" target="_blank">https://bitbucket.org/lord_mulder/lamexp/src/master/etc/Translation</a>
|
||||
</ul>
|
||||
<p>After you have chosen a file from the directory tree, by <i>left</i>-click, you can download the file by <i>right</i>-clicking on <b>Raw</b> button/link (in the upper right corner) an then choosing "Save Link As..." from the context menu.<br><img style="margin-top:0.25em" src="http://i.imgur.com/FYeggvn.png" alt="Raw Button"></p>
|
||||
<p>(As many people seem to have problems here: Please be sure to download the <i>actual file content</i>, by using the "Raw" button. Please do <i>not</i> save the page as shown in the browser, as that would only save the HTML preview of the file rather than the file itself! Also, in the directory tree view, do <i>not</i> right-click + "Save Link As..." on one of the TS files, as that would only save the HTML preview. Instead, <i>left</i>-click on the link to open the TS file in the browser. <i>Then</i> use the "Raw" button as described above!)</p>
|
||||
<p style="border-width:2px;border-style:solid;border-color:darkred;margin-top:2em"><font color="darkred"><b>IMPORTANT:</b> Before you start to create a new translation, <i>always</i> make sure you downloaded the <u>latest</u> "Blank.ts" file from the LameXP Git repository. Also, before you start editing or updating an <i>existing</i> translation, make sure you downloaded the <u>latest</u> TS file from the LameXP Git repository. <u>Never</u> do any translations based on some working copies that you kept on your local system! The translation files (TS) in the Git repository will be updated <i>continuously</i>, as the development proceeds. We can <b>not</b> accept translations based on an <i>outdated</i> TS file!</font></p>
|
||||
<br>
|
||||
<!-- ============================= -->
|
||||
<h3>Language file editing rules:</h3>
|
||||
Only language files that have been edited according to the following rules can be accepted:
|
||||
<ul>
|
||||
@ -40,6 +54,7 @@ Only language files that have been edited according to the following rules can b
|
||||
<li>Note that the red <font style="color:darkred;font-weight:bold">!</font> icon and the yellow <font style="color:#AA8B0F">✔</font> icon indicate that there is some problem with your translation, which needs to be resolved!
|
||||
</ul>
|
||||
<br>
|
||||
<!-- ============================= -->
|
||||
<h3>Examples:</h3>
|
||||
Here are a few examples of properly translated strings:
|
||||
<ul>
|
||||
@ -48,20 +63,24 @@ Here are a few examples of properly translated strings:
|
||||
<li><b>Example #3</b><table><tr><td>• Original:</td><td> </td><td><tt><font style="color:darkred">%n</font> minute(s)</tt></td></tr><tr><td>• Translated (Singular):</td><td> </td><td><tt><font style="color:darkred">%n</font> Minute</tt></td></tr><tr><td>• Translated (Plural):</td><td> </td><td><tt><font style="color:darkred">%n</font> Minuten</tt></td></tr></table>
|
||||
</ul>
|
||||
<br>
|
||||
<!-- ============================= -->
|
||||
<h3>Testing your translation:</h3>
|
||||
<p>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 <i>without</i> re-building LameXP: Open your current translation (TS) file in the <i>Qt Linguist</i> application and go to "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. This is <i>not</i> possible with the TS file. In LameXP, just goto "View" ⇒ "Language" ⇒ "From File..." and choose the QM file that you have saved in Linguist before. Your translation should be in effect immediately. If you notice that your translation needs further modifications, please go back to the TS file for editing (don't try to edit the QM file!), in the <i>Qt Linguist</i> application. Then, for your next test run, create a <i>new</i> QM file from the updated TS file. Also note that, in newer versions of LameXP, you can press <tt>CTRL+F5</tt> to re-load your current QM file (works only in the "Main" window!).</p>
|
||||
<p>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 <i>without</i> re-building LameXP: Open your current translation (TS) file in the <i>Qt Linguist</i> application and go to "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. This is <i>not</i> possible with the TS file. In LameXP, just goto "View" ⇒ "Language" ⇒ "From File..." and choose the QM file that you have saved in Linguist before. Your translation should be in effect immediately. If you notice that your translation needs further modifications, please go back to the TS file for editing (don't try to edit the QM file!), in the <i>Qt Linguist</i> application. Then, for your next test run, create a <i>new</i> QM file from the updated TS file. Also note that, in newer versions of LameXP, you can press <tt>CTRL+F5</tt> to re-load your current QM file (works only in the "Main" window!).</p>
|
||||
<br>
|
||||
<!-- ============================= -->
|
||||
<h3>Submitting your translation:</h3>
|
||||
<p>Once you are done with your translation (i.e. all items and all contexts have a green <font style="color:darkgreen">✔</font> icon), you can submit it, so it can be integrated into the next LameXP release. You can contact me by e-mail:<br><b><a href="mailto:mulder2%20[at]%20gmx%20[dot]%20de">mulder2<font color="dimgray">[at]</font>gmx<font color="dimgray">[dot]</font>de</a></b></p>
|
||||
<p>Please do <i>not</i> submit translations that have any items/context with <font style="color:#AA8B0F">✔</font>, <font style="color:#AA8B0F;font-weight:bold">?</font>, <font style="color:#427D7E;font-weight:bold">?</font> or even <font style="color:darkred;font-weight:bold">!</font> icon left. Also do <i>not</i> submit QM files, do <i>not</i> compress the submitted file (ZIP, RAR, etc) and do <i>not</i> attach a flag icon file. It is perfectly sufficient to submit <i>only</i> the translation (TS) file.</p>
|
||||
<p><b><u>Legal notice:</u></b> By submitting LameXP translations, all translators agree that their work will be incorporated into the LameXP software and, from then on, will be published and redistributed under the terms of the GNU General Public License. If you do <i>not</i> agree, please do <i>not</i> submit!
|
||||
<p><b><i>Legal notice:</i></b><br>By submitting LameXP translations, all translators agree that their work will be incorporated into the LameXP software. All translations will be published and redistributed under the terms of the <i>GNU General Public License</i>. If you do <b>not</b> agree, please do <b>not</b> submit!
|
||||
<p>(Advanced translators can get write-access to the Git repository, so they can keep their translations up-to-date easily. If you need Git access, just drop me a note!)</p>
|
||||
<p style="border-width:2px;border-style:solid;border-color:darkred;margin-top:2em"><font color="darkred"><b>IMPORTANT:</b> Before you start to create a new translation, always make sure you downloaded the <i>latest</i> "Blank.ts" file from the LameXP Git repository. Also before you start editing or updating an <i>existing</i> translation, including translations you have created yourself, make sure you downloaded the <i>latest</i> TS file from the LameXP Git repository. <i>Never</i> do any translations based on an old working copy (TS file) from your local system! The translation files (TS) in the Git repository will be updated/extended continuously, as the development proceeds. We cannot accept translations based on an <i>outdated</i> TS file!</font></p>
|
||||
<p style="border-width:2px;border-style:solid;border-color:darkred;margin-top:2em"><font color="darkred"><b>IMPORTANT:</b> Before you start to create a new translation, <i>always</i> make sure you downloaded the <u>latest</u> "Blank.ts" file from the LameXP Git repository. Also, before you start editing or updating an <i>existing</i> translation, make sure you downloaded the <u>latest</u> TS file from the LameXP Git repository. <u>Never</u> do any translations based on some working copies that you kept on your local system! The translation files (TS) in the Git repository will be updated <i>continuously</i>, as the development proceeds. We can <b>not</b> accept translations based on an <i>outdated</i> TS file!</font></p>
|
||||
<br>
|
||||
<!-- ============================= -->
|
||||
<h3>Personalization:</h3>
|
||||
<p>Usually all translators will be mentioned in the "About..." dialogue of LameXP. If you don't want your (nick)name and/or e-mail address to appear there, please tell us that you whish to stay anonymous!</p>
|
||||
<p>Usually all translators will be mentioned in the "About..." dialogue of LameXP. If you don't want your (nick)name and/or e-mail address to appear there, please tell us that you wish to stay anonymous!</p>
|
||||
<br>
|
||||
<br>
|
||||
Thanks in advance !!!<br><br><img src="http://forum.doom9.org/images/smilies/thanks-t.gif" alt="emoticon">
|
||||
<!-- ============================= -->
|
||||
</body>
|
||||
</html>
|
||||
|
||||
@ -35,7 +35,7 @@
|
||||
#define VER_LAMEXP_MINOR_LO 0
|
||||
#define VER_LAMEXP_TYPE Beta
|
||||
#define VER_LAMEXP_PATCH 1
|
||||
#define VER_LAMEXP_BUILD 1540
|
||||
#define VER_LAMEXP_BUILD 1541
|
||||
#define VER_LAMEXP_CONFG 1528
|
||||
|
||||
///////////////////////////////////////////////////////////////////////////////
|
||||
|
||||
Loading…
Reference in New Issue
Block a user