| -rw-r--r-- | docs/usermanual/i18n.sgm | 5 |
1 files changed, 2 insertions, 3 deletions
diff --git a/docs/usermanual/i18n.sgm b/docs/usermanual/i18n.sgm index 6ec151f..3c81d6c 100644 --- a/docs/usermanual/i18n.sgm +++ b/docs/usermanual/i18n.sgm @@ -1,36 +1,33 @@ <chapter> <title>Translations</title> -<section> - <para> The &opie;-Project tries to offer the support for as many languages as possible. In this chapter the process of translating &opie; and its documentation is explained. </para> <para> To ensure that &opie; can be used by as many people as possible the &opie;-project aims to be translated in as many languages as possible. Of course, as there are so many different languages, there is always a lot work to do. Furthermore, &opie; evolves and thus most likely there are translations for applications which should be updated. In this tutorial you will learn how to help &opie; to be available in as many languages as possible and see how easy it is to give something very much respected to the open-source community. </para> -</section> <section> <title>Preferences</title> <para> In order to translate for &opie; you need an editor to edit the translationfile and preferably access to cvs. The preferred editor is Linguist. That is an application which comes with &qt;. It has a intuitive GUI and is very easy to use. A tutorial can be found <ulink url="http://doc.trolltech.com/3.1/linguist-manual-3.html">here</ulink>. </para> <para> However, you can use every editor which works with UTF8, for example VIM or EMACS. The advantage of Linguist is that its GUI is optimized for &opie;s translationfiles and can help you by proposing a translation and notice you if there is an error within the translation. @@ -137,32 +134,33 @@ <programlisting> ../../../i18n/de/today.ts \ </programlisting> Usually the translationcoordinator takes care of these entries so you should not need to edit them. <filename class='extension'>qm</filename> These are binary files used by &opie; to display the translated strings. They are automatically generated by calling the command <command>make lrelease</command>. Of course, you need to have the binary of <application>lrelease</application> which comes with &qt;. </para> </section> <section> <title>Do's and don'ts</title> + <para> There are certain things that should only be done be the translationcoordinator or one of the core developers. <itemizedlist mark='opencircle'> <listitem> <para> The translationfiles should never be updated by the translators. Only the translationcoordinator updates the repository. This is to avoid merging conflicts. </para> </listitem> <listitem> <para> The binary .qm-files are created by either the translationcoordinator or by the feed-manager. Of course, the translators can created them as described above for testingpurposes but the official files will be provided. </para> </listitem> @@ -173,19 +171,20 @@ </para> </listitem> <listitem> <para> If you find a string like "Form1" contact the translationcoordinator. These strings should not be in the translationfiles. You don't need to translate them. </para> </listitem> <listitem> <para> If you check you translation and see a not translated string even though you translationfile is 100% translated use the bugtrackingsystem and/or contact the author of that application directly so that this bug is fixed. </para> </listitem> </itemizedlist> + </para> </section> </chapter> |