====== Übersetzung ======                                                                                            
Admidio verwendet getrennte Sprachtexte innerhalb des Codes, die in separaten XML-Dateien eingefügt werden. Dadurch wird eine Übersetzung relativ einfach und wir freuen uns auf jede weitere Sprache, in der wir Admidio anbieten können. Innerhalb der Übersetzungsdateien verwenden wir das xml-Format von **Android String Resource**. Unsere Übersetzungsdateien sind verfügbar unter [[https://www.transifex.com|Transifex]] und du kannst diese Plattform verwenden, um die Übersetzung durchzuführen. Wenn Sie fertig sind, importieren wir die übersetzten Dateien aus Transifex in den Admidio-Quellcode.

===== Neue Sprache hinzufügen =====

==== Erster Schritt ====
Wenn du eine neue Sprache zu Admidio hinzufügen möchtest, dann [[m.fassbender@admidio.org|kontaktiere]] uns zuerst. So können wir vermeiden, dass mehrere Personen gleichzeitig eine Sprache übersetzen und Probleme oder andere Dinge direkt besprechen. Gleichzeitig kannst du dich registrieren lassen unter [[http://www.transifex.com|Transifex]] und dem [[https://www.transifex.com/admidio/admidio/dashboard/|Admidio Projekt]] beitreten.

==== Übersetze ====
Wenn du ein //ok// von uns bekommen hast, um Admidio in deiner bevorzugten Sprache zu übersetzen, kannst du dies innerhalb von [[http://www.transifex.com|Transifex]] machen. Bitte prüfe, ob deine Sprache für Admidio akzeptiert wird, andernfalls bitte um die Aktivierung der Sprache und dass wir dich als Übersetzer hinzufügen. 

Danach kannst du mit der Übersetzung beginnen. Beginne bitte mit der //Ressource// namens **Hauptprogramm Strings**. Dies sind die Strings, die Admidio benötigt. Die anderen Ressourcen sind Plugins und Länder, die du später übersetzen kannst.

Wenn du Probleme hast, **Englisch** als Ausgangssprache zu wählen, schaue bitte unter {{:en:developers:documents:change_source_lang.pdf|this short how-to}}. Diese Anleitung beginnt auf dem [[https://www.transifex.com/admidio/program/dashboard/|Admidio Dashboard]] von Transifex.

Jetzt kannst du mit der Übersetzung in deiner bevorzugten Sprache beginnen.

==== Verwende deine Sprache in Admidio ====
Wenn du deine Arbeit in Admidio sehen willst, musst du deine übersetzten Strings von [[http://www.transifex.com|Transifex]] herunterladen und diese Datei in den Admidio-Ordner **adm_program/languages** kopieren.
Nun musst du die neue Sprache in Admidio einführen, damit sie in der Sprachauswahlbox angezeigt wird. 

Dazu musst du den ISO-Code und den Namen der Sprache in die php-Datei **languages.php** im Ordner **adm_program/languages** einfügen. Der Name der Sprache sollte eine Kombination aus dem englischen Wort und dem Namen der Sprache in der Sprache selbst sein.

Das folgende PHP-Schnipsel muss angepasst werden und sollte am Anfang der Array-Liste in der Datei direkt nach **$gSupportedLanguages = array(**
<code php>    'de'    => array(
        'name'    => 'German - Deutsch (du)',
        'isocode' => 'de',
        'libs'    => 'de'
    ),</code>

:!: Bitte beachte, dass der ISO-Code mit dem Namen deiner XML-Datei übereinstimmen muss. Wenn deine heruntergeladene XML-Datei z. B. den Namen //xy.xml// hat, lautet Ihr ISO-Code //xy//.

Starte nun deinen Browser neu und gehe zu deiner Admidio-Installation. Du kannst nun deine neue Sprache in den **Regionalen Einstellungen** der **Voreinstellungen** auswählen.

==== Letzter Schritt ====
Übersetze nun alle notwendigen Texte und [[m.fassbender@admidio.org|schicke uns]] anschließend eine E-Mail, dass die Sprache zur Auslieferung bereit ist. Wir integrieren die Datei in unseren Quellcode und deine Übersetzung wird dann in der nächsten Admidio-Version enthalten sein.

===== Verbesserung bestehender Sprache =====

Wenn du eine bestehende Sprache von Admidio verbessern willst, kontaktiere uns bitte zuerst [[m.fassbender@admidio.org|Kontakt]]. Gleichzeitig kannst du dich bei [[http://www.transifex.com|Transifex]] registrieren und dem [[https://www.transifex.com/admidio/admidio/dashboard/|Admidio Projekt]] beitreten. Wir geben dir dann die nötigen Rechte, um Übersetzungen in deiner bevorzugten Sprache bei Transifex zu bearbeiten. Danach kannst du mit den Verbesserungen in der bestehenden Sprache beginnen.