For the translation of Haiku's user guide, an [http://i18n.haiku-os.org/userguide online tool] has been developed to keep track of the progress of every language and to ensure all pages are in sync with the original English version. The translating itself is also done with it, online. The translations of the user guide need constant attention. It's not only translations to new languages, but also keeping everything up-to-date. '''Index''' * [#help Help with translations] * [#startNew Starting a new translation] * [#onlineTool The online translation tool] * [#translatePage Translating a page] * [#translateBlock Translating a block] * [#localizeImage Localizing images] * [#quicktour Quick Tour localization] = [=#help Help with translations] = If you have a good grasp of the English language and enough knowledge of HTML to recognize what's a tag (, etc.) and what's translatable contents, here is how to get involved: Have a look at the translation rules and styles in the [http://dev.haiku-os.org/wiki/i18n wiki] of the specific language. Subscribe to the [http://www.freelists.org/list/haiku-i18n localisation mailing list] ([http://www.freelists.org/archives/haiku-i18n/ message archive]) and the language-specific [http://www.freelists.org/cgi-bin/search?search=haiku-i18n haiku-i18n-*] discussion list and introduce yourself. The respective "Language Manager" will provide you with login information for the online translation tool after your application has been discussed/voted on by the other volunteers. You may have to do a few sample block translations handed to you by your Language Manager. = [=#startNew Starting a new translation] = If you would like to start a completely new translation, follow these steps: 1. It's highly recommended to find at least one more dedicated translator. A team increases the chances of completing all pages for a language and keeping them up-to-date in the future. Being able to discuss difficult passages increases the quality and frankly, working together with others is more fun. To find other translators, try posting to the [http://www.haiku-os.org/forum web forum] and the [http://www.freelists.org/list/haiku Haiku mailing list]. 2. Subscribe to the [http://www.freelists.org/list/haiku-i18n localization mailing list] ([http://www.freelists.org/archives/haiku-i18n/ message archive]) and introduce yourselves. 3. We can set up a new haiku-i18n-?? mailing list where you can discuss: * Who will be the "Language Manager" who will monitor the mailing lists and welcomes newcomers, hands them sample blocks to test their skills, calls for votes, creates translator accounts at the translation website, and updates the [http://dev.haiku-os.org/wiki/i18n wiki] according to what's been discussed. Esp. in the beginning, the Language Manager should read through the work of newcomers and suggest improvements to guarantee a certain consistency.[[BR]] * Work on a translation guide, defining rules and style of the translation at the wiki. Rule no.1 is "Don't change the HTML formatting of the original texts". Everything else, how the reader is addressed, using active or passive etc. is language specific and therefore totally in your hands.[[BR]] * Update a list of common terminology and translations in the wiki. 4. When the above is done, announce it on the i18n mailing list and the Language Manager receives his account after providing his desired username and email address. He can then create more accounts for "his" translators on-site. Passwords are generated automatically and send via email (check your spam folder!). = [=#onlineTool The online translation tool] = == [=#statusPage The status page] == Thanks to a very nice online tool originally written by Vincent Duvert and improved upon since, the translating process is easy as can be. Starting point is the page with the [http://i18n.haiku-os.org/userguide/documents.php current translation status] of all documents. [[Image(all_languages_status.png)]] The first column holds the original English document. It's the basis of all translations: any changes, improvements or completely new pages have to start with the original English text. To edit English pages you need special authoring privileges. The other columns are for all the different languages. They show the translation status in percent. If the percentage is shown in yellow with e.g. "(2 f.)", that means that 2 blocks are marked as "fuzzy" (see "Translating a page" below). To translate a page, you have to select a language from the links above the table. Here, "Catalan" as example: [[Image(one_language_status.png)]] You can sort the columns by clicking on its heading, allowing you to quickly show all unfinished pages at the top. == [=#translatePage Translating a page] == Clicking "Translate" will open the document for translation: [[Image(translatepage.png)]] Every translatable block has a red backdrop that lights up when the mouse hovers over it. If the backdrop is yellow instead, it means that the original English text has changed, and the translation has become "'''fuzzy'''" (this is also reflected in the percentage-display on the status page). A white backdrop signals that this block has been translated and is in sync with the original English version. So:[[BR]] ||white:||translated and in sync with the English original.|| ||red:||not translated yet.|| ||yellow:||"fuzzy", review needed - either the English original has been changed or a translator has set the block as incomplete.|| == [=#translateBlock Translating a block] == If you click a block, the translation panel opens: [[Image(translationpanel.png)]] On the left side is the original text, on the right where you work on the translation. There's also a link to language specific style guide and terminology that have to be respected to get a consistent result when several people work together.[[BR]] When you're satisfied with your text, you use the button "Send {language} Translation" or "Cancel" to abort. You can activate the checkbox "Go to next block after validation" to quickly translate block after block. The document window is updated live with your newly created text. That way you can keep checking if there's a smooth transition from one block to the next. In case you are unsure of a translation, or want to save a partial translation and finish it later, check the "'''Fuzzy'''" box before clicking "Send Translation".[[BR]] This "fuzzy" flag indicates that a translation for a particular block may be imprecise or unfinished, and needs review. When a part of the original English document changes, translations associated to this part are automatically marked as fuzzy, so the translators can easily spot what needs to be updated. == [=#localizeImage Localizing images] == Images of the GUI which contain strings that are translatable and change when you switch to another language with the Locale preferences, can be "translated" by uploading a localized version. Simply click on it and a window pops open to choose the image to transfer to the online tool. NOTE: Due to a shortcoming of our online tool, images that appear in certain HTML structures, e.g. in