Differences

This shows you the differences between two versions of the page.

--- translation [2009/10/20 21:22] – added more instructions in howto and new screenshots glaubitz
+++ translation [2011/01/15 02:44] – glaubitz
@@ Line 12: / Line 12: @@
 Linux (and *BSD users) install it with the package manager of their distribution. Usually, installing the latest version of the Qt4 SDK together with Qt Creator will install the necessary files and "Qt Linguist 4" will show up in the program menu.
+A detailed manual for the software can be found at: [[http://doc.trolltech.com/4.5/linguist-manual.html]]
 ===== How to use Qt Linguist =====
@@ Line 30: / Line 32: @@
 ==== Accelerators ====
+Accelerators refer to the keyboard shortcuts you invoke with the "Alt"-key together with any alphabetical key on your keyboard. If you look at the menu of your current browser window, for example, you'll recognize that the "F" of the menu "File" got underlined, i.e. it looks like this: "__F__ile". This means, by holding down "Alt" and pressing "f" at the same time, you can invoke the file menu in your browser.
+Now, //qhimdtransfer// has the same style menus and when you start translating those menus into your language, you'll have to take care of these shortcuts as well. Due to it's nature, an accelerator cannot be transfered as is into another language. When translating "File" into the German "Datei", there is no "F" which is supposed to be the accelerator. Thus, a new letter has to be chosen. To define an accelerator, just precede the letter that is supposed to be the accelerator with an ampersand, thus:
+<code>
+&Datei
+</code>
+or
+<code>
+&Bearbeiten
+</code>
+The accelerator can precede any letter in a word, it doesn't have to be the first one.
+Accelerators have to be unique, Qt Linguist will prompt you for any duplicate assigned accelerators. Please check the warnings at the bottom all the time.
+One note on East Asian languages (or any other language with non-latin alphabets): Since most people in asia use standard alphanumeric keyboards but the menus still appear in their specific language, accelerators have to be defined through an extra character. Naturally, mose people just use the accelarators from the English version. Thus, if you translate "&File" from English to Japanese, it will become ファイル (__F__).
+This means in code:
+<code>
+&File
+</code>
+translates to:
+<code>
+ファイル (&F)
+</code>
 ==== Place holders ====
+Place holders are used to reserve parts of a text for information that is inserted on runtime by the program code. That is, while the program is actually running. This is necessary to provide the user with dynamically generated information, like how many tracks were deleted or on how many tracks errors were detected.
+A very simple example is:
+<code>
+Track %1
+</code>
+which is used to caption a track in the user interface. "%1" here is the place holder which is replaced by a numeric on runtime.
+For translations, it is important that all place holders are also present in the translated text.
+Thus, the above one translates to in Norwegian:
+<code>
+Spor %1
+</code>
+It doesn't matter, at what position in the translated sentence, the place holder is shown but only the fact that it actually exists. The position solely depends on your translation. So, in German, it might also be something like:
+<code>
+%1 er Track
+</code>
 ==== HTML formatting ====
+Some of the interface text might be formatted with HTML. HTML formatting is useful to display certain text with larger fonts, bold or italic and so on. For example, the text in the about dialog looks like this:
+<code>
+<h3>QHiMDTransfer, Version 0.0.1</h3>
+<p><p>
+<p>A free music transfer software for MiniDisc walkman.</p>
+<p><p>
+<p>Brought to you by the linux-minidisc project:</p>
+<p><p>
+<p>https://wiki.physik.fu-berlin.de/linux-minidisc</p>
+<p><p>
+<p>This software is covered by the GNU GPL v2 license. See the
+file LICENSE in the program folder for more information.</p>
+</code>
+For translation of such formatted texts, the best practice is just to copy the whole formatted text (including the HTML tags) and just edit and translate the normal, user-visible text. Changing the formatting should not be necessary in most cases. Thus, for example, the German translation looks very similar:
+<code>
+<h3>QHiMDTransfer, Version 0.0.1</h3>
+<p><p>
+<p>Eine freie Transfersoftware für MiniDisc Walkman.</p>
+<p><p>
+<p>Diese Software entstand im linux-minidisc Projekt:</p>
+<p><p>
+<p>https://wiki.physik.fu-berlin.de/linux-minidisc</p>
+<p><p>
+<p>Diese Software unterliegt der GNU GPL v2 Lizenz. Lesen sie die
+Datei LICENSE im Programmverzeichnis für mehr Infos.</p>
+</code>
 ===== .ts Files =====
+All currently existing translations can be found on our FTP server at: [[http://users.physik.fu-berlin.de/~glaubitz/linux-minidisc/translations/]]. This directory also contains a generic template file called "//00-qhimdtransfer_template.ts//" for new language files.