| -rw-r--r-- | docs/usermanual/i18n.sgm | 7 |
1 files changed, 3 insertions, 4 deletions
diff --git a/docs/usermanual/i18n.sgm b/docs/usermanual/i18n.sgm index b1ac33a..577e733 100644 --- a/docs/usermanual/i18n.sgm +++ b/docs/usermanual/i18n.sgm @@ -69,49 +69,48 @@ </listitem> <listitem> <para> Don't put a space in front of a punctuation mark. So write eg "this is a demonstation!" insteadt of "this is a demonstation !". </para> </listitem> </itemizedlist> </section> <section> <title>Examplecode</title> <para> In the next paragraph you see an example of how the XML looks like. </para> - +<!-- <programlisting> <message> <source>New</source> <translation>Neu</translation> </message> <message> <source>Today</source> <translation>Heute</translation> </message> <message> <source>Day</source> <translation type="unfinished"></translation> </message> </programlisting> - - </para> +--> <para> As you can see the markup is very simple. The part between two source-tags is the english text which appears if there is no translation yet. In the first case this is <quote>New</quote>. The next row is where the translated string would be. The first two messages are already translated, the third is not. This is marked by the <programlisting>type="unfinished"</programlisting>. </para> <para> If you choose to use an editor like VIM instead of the prefered tool -Linguist- you have to remove that mark and add the translated string between the two <programlisting>translation</programlisting>-tags. </para> <para> It might happen that you see <programlisting>type="obsolete"</programlisting> in a .ts-file. You should not translate these stings as they do no longer appear in the application. The translationcoordinator removes those strings from time to time. In @@ -139,33 +138,33 @@ ../../../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> There are certain things that should only be done be the - translationcoordinator or one of the core developers. + 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> <listitem> <para> |