Differences

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

--- en:entwickler:uebersetzen [2013/02/23 19:48] – [First steps] fasse
+++ en:entwickler:uebersetzen [2023/07/16 10:51] (current) – fasse
@@ Line 1: / Line 1: @@
 ====== Translation ======
-With version 2.2 we have separated all language texts of the code and added in a separate XML file. Thus a translation become relatively easy and we look forward to any other language in which we can offer Admidio.
+Admidio use separated language texts within the code that are added in separate XML files. Thus a translation become relatively easy and we look forward to any other language in which we can offer Admidio. Within the translation files we use the xml format of **Android String Resource**. Our translation files are available at [[https://www.transifex.com|Transifex]] and you can use that platform to perform the translation. After you are done, we import the translated files from Transifex to the Admidio source code.
+===== Add new language =====
 ==== First steps ====
-If you want to add a new language to Admidio please [[m.fassbender@admidio.org|contact]] us first. We can thus avoid that multiple people simultaneously translate a language and discuss problems or other things directly.
+If you want to add a new language to Admidio please [[m.fassbender@admidio.org|contact]] us first. We can thus avoid that multiple people simultaneously translate a language and discuss problems or other things directly. At the same time you can register yourself at [[http://www.transifex.com|Transifex]] and join the [[https://www.transifex.com/admidio/admidio/dashboard/|Admidio Project]].
+==== Translate ====
+If you got an //ok// from us to translate Admidio in your favorite language you can do so within [[http://www.transifex.com|Transifex]]. Please check if your language is accepted for Admidio otherwise ask for activation of the language and that we add you as a translator.
-==== Register new language ====
+After that you can start to translate. Please start with the //resource// called **main program strings**. These are the strings Admidio needs. The other resources are plugins and countries that you may translate later.
-First you must introduce the new language to Admidio so that it will be shown in the language select box. Therefore you musst add the ISO code and the name of the language to the XML file **languages.xml** in the folder **adm_program/languages**. The name of the language should not be translated, it should be the native name.
-The following XML snippet must be adapted and another **<language>** tag should be appended to the file.
+If you have problems to select **english** as your source language then please have a look at {{:en:developers:documents:change_source_lang.pdf|this short how-to}}. This how-to starts at the [[https://www.transifex.com/admidio/program/dashboard/|Admidio Dashboard]] of Transifex.
-<code xml><language>
-    <isocode>en</isocode>
-    <name>english</name>
-</language></code>
-==== Create language file ====
+Now you can start the translation of your favorite language.
-As a next step the language file should be created. Therefore an existing file could be copied. It is best to copy the English language file **en.xml** and take the ISO code of the new language as name for the file. The file extension should also be **xml**.
+==== Use your language within Admidio ====
-Already now the new language can be choosen in the installation dialog and can be set in the organization settings. However all text will be displayed in the copied language because no text has been translated into the new language.
+If you want to see your work in Admidio you must download your translated strings from [[http://www.transifex.com|Transifex]] and copy this file to the Admidio folder **adm_program/languages**.
+Now you must introduce the new language to Admidio so that it will be shown in the language select box.
-==== Translate language file ====
+Therefore you must add the ISO code and the name of the language to the php file **languages.php** in the folder **adm_program/languages**. The name of the language should be a combination of the english word and the name of the language in the language itself.
-Now there are about 1400 texts that should be translated. Open the new language file //isocode.xml// with an editor. Here you find all Admidio texts grouped by the tag **<version>** which represents the Admidio version in which the text was added. All language files should have the same sorting, so please do not re-sort the lines. Each individual text is diplayed with the tag **<text>** and will be identified with the attribut **id**.
-Additionally, there are 2 other attibute **development** and **translation**, which should help you with the translation.
+The following PHP snippet must be adapted and should be add to the beginning of the array list in the file just after **$gSupportedLanguages = array(**
+<code php>    'de'    => array(
+        'name'    => 'German - Deutsch (du)',
+        'isocode' => 'de',
+        'libs'    => 'de'
+    ),</code>
-The attribut **development** can have the values //new//, //changed// and //deleted//, which are distributed by the developers.
+:!: Please note that the ISO code must be the same as the name of your xml file. E.g. if your downloaded XML file has the name //xy.xml// than your ISO code is //xy//.
-  * **new**: This text has been added to the version, in which **<version>** tag it is filed.
-  * **changed**: This text has been changed in the version, in which **<version>** tag it is filed. Originally it was added in another version.
-  * **deleted** This text has been removed from Admidio in the version, in which **<version>** tag it is filed. This value would only be found in the reference languages English or German. In your language you should removed all texts from your xml file that are affected from the **id**.
-Das Attribut **translation** ist für den Übersetzer gedacht und kann von ihm vergeben werden. Hier kannst du selber den Status deiner Übersetzung für den Text angeben. In der Referenzsprache **deutsch** erstellen wir alle Texte mit dem Status //todo//. Weitere mögliche Werte wären //edited// oder //revised//.
+Now restart your browser and go to your Admidio installation. You can now select your new language within the **Regional settings** of the **preferences**
-  * **todo** dieser Text muss noch in der aktuellen Sprachdatei übersetzt werden
-  * **edited** dieser Text ist bereits übersetzt, könnte aber noch verbessert werden
-  * **revised** dieser Text ist fertig übersetzt
-==== Sprachdatei aktualisieren ====
+==== Last step ====
-Wurde eine Übersetzung für die gewünschte Sprache schon begonnen und nur noch nicht für die aktuelle Admidio-Version angepasst, so ist folgendes zu tun.
+Now translate all necessary texts and then [[m.fassbender@admidio.org|send us]] an email that the language is ready for delivery. We integrate the file in our source code and your translation will then be included in the next Admidio release.
-Öffne die Sprachdatei der Sprache, die du übersetzen willst. Schau dort unter dem Attribut **id** des neusten Tags **version**, welches die letzte Admidio-Version war für die die Sprachtexte aktualisiert wurden. <code xml><version id="2.2.0"></code>
+===== Improve existing language =====
-Öffne nun die Sprachdatei der Referenzsprachen **Deutsch** (//de.xml//) oder **Englisch** (//en.xml//) und kopiere von dort nun alle neueren Versionstags mit den dazugehörigen Texten. Nun kannst du diese Texte in der Sprachdatei der zu übersetzenden Sprache übersetzen. Achte dabei auf das Tag **development**, welches dir den Status des jeweiligen Textes mitteilt.
-  * **new** dieser Text wurde unter der Version, in der der Text eingeordnet ist, neu hinzugefügt. Hier brauchst du nur den Text übersetzen.
-  * **changed** dieser Text wurde unter der Version, in der der Text eingeordnet ist, verändert. Ursprünglich wurde er aber in einer anderen Version hinzugefügt. Lösche den ursprünglichen Tag **<text>** mit derselben **id** aus der alten Version und übersetze den neuen Text.
-  * **deleted** dieser Text wurde unter der Version, in der der Text eingeordnet ist, aus Admidio entfernt. Diesen Wert wird es i.d.R. nur in der Referenzsprachen deutsch oder  englisch geben. In anderen Sprachen sollte der Text mit der betroffenen **id** direkt aus der xml-Datei entfernt werden. Sowohl in der zu übersetzenden Version, als auch in alten Versionen
-Übersetze nun alle noch nicht übersetzten Texte und danach kannst du diese neue Datei an uns schicken. Wir binden sie dann in die aktuelle Entwicklung von Admidio ein und beim nächsten Versionsupdate sind die neuen Übersetzungen dann enthalten.
+If you want to improve an existing language of Admidio please [[m.fassbender@admidio.org|contact]] us first. At the same time you can register yourself at [[http://www.transifex.com|Transifex]] and join the [[https://www.transifex.com/admidio/admidio/dashboard/|Admidio Project]]. We will than give you the necessary rights to edit translations in your favorite language at Transifex. After that you are ready to start with the improvements to your language.