Differences

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

--- en:entwickler:uebersetzen [2016/01/17 21:56] – [Translate] 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. Since version 3.1 we have changed the format of the translation files to **Android String Resource** and use the service of [[http://www.transifex.com|Transifex]] to perform the translations.
+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 ====
@@ Line 6: / Line 8: @@
 ==== 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 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.
+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.
-The following steps will describe how you can translate from english to your favorite language:
-  * Go to [[https://www.transifex.com/admidio/admidio/dashboard/|Admidio Dashboard]]
+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.
-  * Select the language you want to translate
-  * Now select the source e.g. **main program strings** you want to translate
+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.
-  * On the next page you will see the source language and your destination language.
-  * Now change the source language from German to English. Therefore click on the green button on the top right and select **Show source string in German (de)**
+Now you can start the translation of your favorite language.
-  * Now choose **English (en)** as your favorite source language.
-Now start your translation.
 ==== Use your language within Admidio ====
 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. Therefore you must 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.
+Now you must introduce the new language to Admidio so that it will be shown in the language select box.
-The following XML snippet must be adapted and another **<language>** tag should be appended to the 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.
-<code xml><language>
-    <isocode>en</isocode>
+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(**
-    <name>english</name>
+<code php>    'de'    => array(
-</language></code>
+        'name'    => 'German - Deutsch (du)',
+        'isocode' => 'de',
+        'libs'    => 'de'
+    ),</code>
 :!: 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//.
@@ Line 30: / Line 34: @@
 ==== Last step ====
-Now translate all neccessary 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.
+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.
+===== Improve existing language =====
+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.