Small update to translator's guide.

This commit is contained in:
LoRd_MuldeR 2011-05-01 03:03:02 +02:00
parent e59cfba291
commit 34adddbad6
2 changed files with 9 additions and 6 deletions

View File

@ -26,6 +26,7 @@ a:visited { color: #0000EE; }
<li>Updated mpg123 decoder to v1.13.3 (2011-04-21), compiled with GCC 4.6.0
<li>Updated MediaInfo to v0.7.44 (2011-04-19), compiled with ICL 12.0.3 and MSVC 10.0
<li>Updated language files (big thank-you to all contributors !!!)
<li>Fixed placement of the Dropbox when the Taskbar is located on the top or on the left side
</ul><br>
<a name="4.01"></a>Changes between v4.00 and v4.01:<br><ul>

View File

@ -20,12 +20,12 @@ a:visited { color: #0000EE; }
<br>
<h3>Prerequisites:</h3>
<p>LameXP v4.00 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 first. 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> should be sufficient.</p>
<p>You can download <i>Qt Linguist</i> as a part of the Qt Framework, which is available as a free download from the <a href="http://qt.nokia.com/downloads/downloads" target="_blank">Qt download site</a>. You should pick the "LGPL" version and the "Qt: Framework Only" download. If you are using Microsoft Windows, then the "VS 2008" version should be preferred. Moreover people who don't like to download the complete framework (approx. 230 MB) can find Qt Linguist for Windows as a stand-alone download at <a href="http://code.google.com/p/mulder/downloads/detail?name=qt-linguist-473-win32.rar&q=" target="_blank">this</a> location (only 5 MB).</p>
<p>You can download <i>Qt Linguist</i> as a part of the Qt Framework, which is available as a free download from the <a href="http://qt.nokia.com/downloads/downloads" target="_blank">Qt download site</a>. You should pick the "LGPL" version and the "Qt: Framework Only" download. If you are using Microsoft Windows, then the "VS 2008" version should be preferred. Moreover people who don't like to download the complete framework (approx. 230 MB) can find Qt Linguist for Windows as a stand-alone download at <a href="http://code.google.com/p/mulder/downloads/detail?name=qt-linguist-473-win32.rar&amp;q=" target="_blank">this</a> location (only 5 MB).</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.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm" target="_blank">ISO 3166-1</a> or <a href="http://www.loc.gov/standards/iso639-2/php/code_list.php" target="_blank">ISO 639-1</a> 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.</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><br style="line-height:4px">(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...")</p>
<p style="border-width:1px;border-style:solid;border-color:darkred"><font color="darkred"><b>Important:</b> Before you start translating, always make sure your download the <i>latest</i> "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 <i>latest</i> 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.</font></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><br style="line-height:10px">(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...")</p>
<p style="border-width:1px;border-style:solid;border-color:darkred;margin-top:2em"><font color="darkred"><b>Important:</b> Before you start translating, always make sure your download the <i>latest</i> "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 <i>latest</i> 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.</font></p>
<br>
<h3>Language file editing rules:</h3>
Only language files that have been edited according to the following rules can be accepted:
@ -35,18 +35,20 @@ Only language files that have been edited according to the following rules can b
<li>Do <i>not</i> use any HTML-style tags, like <tt>&lt;b&gt;&hellip;&lt;/b&gt;</tt>, <tt>&lt;i&gt;&hellip;&lt;/i&gt;</tt> or <tt>&lt;u&gt;&hellip;&lt;/u&gt;</tt> in your translated text, except when present in the original string.
<li>Take care of the <a href="http://en.wikipedia.org/wiki/Printf" target="_blank">C printf</a> syntax: All the <tt>%s</tt> and <tt>%d</tt> placeholders <i>must</i> remain in the translated strings, at the appropriate position.
<li>All Qt-style placeholders, like <tt>%1</tt>, <tt>%2</tt> and so on, <i>must</i> remain in the translated strings, at the appropriate position.
<li>Once the translation for a string is finished, please click the 'mark item as done' button, so the item (string) gets a green <font style="color:darkgreen">&#10004;</font> icon.
<li>Note that the red <font style="color:darkred;font-weight:bold">!</font> icon and the yellow <font style="color:#AA8B0F">&#10004;</font> icon indicate that there is some problem with your translation, which needs to be resolved!
</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 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.</p>
<br>
<h3>Submitting your translation:</h3>
<p>Once you are done with your translation, 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>It is sufficient to submit the translation (TS) file. Please do <i>not</i> submit QM files. You don't need to compress the submitted file (ZIP, RAR, etc) and you don't need to attach a flag icon file.</p>
<p>Once you are done with your translation (i.e. all items and all contexts have a green <font style="color:darkgreen">&#10004;</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">&#10004;</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 sufficient to submit the translation (TS) file.</p>
<p>(Note: Advanced translators can get write-access to the Git repository on request, so they can keep their translations up-to-date easily)</p>
<br>
<h3>Personalization:</h3>
<p>Usually all translators will be mentioned in the "About..." dialogue. If you don't want your name and/or e-mail address to appear there, please tell us how you want to be credited!</p>
<p>Usually all translators will be mentioned in the "About..." dialogue. If you don't want your (nick)name and/or e-mail address to appear there, please tell us how you want to be credited!</p>
<br>
<br>
Thanks in advance !!!