How to translate strings for the AAPS app or the documentation

  • Für die Zeichenketten, die in der App verwendet werden, gehe zu https://crowdin.com/project/androidaps und melden Dich mit Deinem GitHub Konto an

  • Für die Dokumentation besuche bitte https://crowdin.com/project/androidapsdocs und melde Dich mit Deinem GitHub Account an

  • Sende Deinen Beitrittswunsch an das Docs-Team. Klicke dazu auf die Fahne der gewünschten Sprache und dann auf der nächsten Seite rechts oben auf den Button „Join“. Please specify language, give some information about you and your AAPS experience and if you want to be a translator or proofreader (only people skilled in translating + advanced AAPS users).

Zeit für die Freigabe :class: note

Die Genehmigung ist ein manueller Schritt. Als gemeinnützige Organisation stellen wir keine SLAs zur Verfügung, aber im Allgemeinen erfolgt die Genehmigung in < 1 Tag. Falls nicht, kontaktiere bitte das Doc Team über Facebook oder Discord.

<br />* When we approve you, click the flag
   ![When we approve you, click the flag](./images/translation_flags.png)

## Translation of the app

(translations-translate-strings-for-AAPS-app)=
### Translate strings for AAPS app

* If you have no preference for strings you translate just select the "Translate All" button to start. Es zeigt Dir direkt die Zeichenketten, die übersetzt werden müssen.

   ![Click translate all](./images/translations-click-translate-all.png)

* Wenn Du eine einzelne Datei übersetzen möchtest, suche bitte die Datei über den Suchdialog oder die Baumstruktur und klicke auf den Dateinamen, um die Übersetzungsarbeit an Zeichenketten in dieser Datei zu starten.

   ![Click strings.xml](./images/translations-click-strings.png)

* Translate sentences on left side by adding new translated text or use & edit suggestion 

   ![Translation app](./images/translations-translate.png)


### Proofread strings for AAPS app

* Proofreaders start by selecting "Proofread" when starting from the language home screen.

   ![Proofreading mode app](./images/translations-proofreading-mode.png) 


  and approve translated texts 

   ![approve text](./images/translations-proofreading.png)

When a proofreader approves a translation it will be added to the next version of AAPS.

(translations-translation-of-the-documentation)=
## Übersetzung der Dokumentation

* Klicke zum Start der Übersetzung auf den Namen der Seite der Dokumentation, die Du übersetzen willst

![Click docs page](./images/translation_WikiPage.png)


* Übersetze Satz bei Satz

    1. Der gelbe Text ist der Text, an dem Du gerade arbeitest.

    1. Der grüne Text ist bereits übersetzt. Du musst dies nicht nochmals tun.

    1. Der rote Text ist der verbleibende Text, der übersetzt werden muss.

    1. Dies ist der Quelltext, an dem Du gerade arbeitest. Dies ist die Übersetzung, die Du gerade vorbereitest. Du kannst den Text von oben kopieren oder einen der folgenden Vorschläge auswählen.

    1. Dies sind die Vorschläge für eine Übersetzung. Vor allem kannst Du sehen, wie sehr Crowdin dies als passend bewertet, oder ob es schon als Übersetzung für diesen Text verwendet in der Vergangenheit verwendet wurde und die neue Übersetzung nur durch Textverschiebungen hervorgerufen wurde, aber nicht durch Änderungen der Inhalte.
    1. Drücke die Schaltfläche "Speichern", um einen Vorschlag für die Übersetzung zu speichern. Er wird dann zu einem Proofreader zur abschließenden Freigabe gegeben.

![Translation docs](./images/translation_WikiTranslate.png)

* Eine übersetzte Seite wird nicht veröffentlicht, bevor 

    1. für die Übersetzung ein Proofread (Korrekturlesen) durchgeführt wurde

    1. die Synchronisierung zwischen Crowdin und Github durchgeführt wurde (einmal pro Stunde), wodurch ein PR für Github erstellt wird.

    1. der PR in Github genehmigt wurde.

In der Regel erfolgt die Freigabe innerhalb von 1 - 3 Tage, kann aber in Urlaubszeiten auch einmal etwas länger dauern.

### Übersetzen von Links

```{admonition} Links werden nicht mehr übersetzt
:class: note

Links werden nicht mehr übersetzt. In der Vergangenheit hatten wir hier ein Thema, aber mit der Migraton nach Markdown und den myst_parser erzeugen wir im englischen Text  explizite Labels , die nicht übersetzt werden.

Wenn Du einen Text mit einem Link übersetzt, bitte sei vorsichtig nicht den Link zu entfernen, der durch ein Paar <0><> Tags repräsentiert wird oder mit einer anderen Zahl, falls mehrere Links in einem Absatz enthalten sind.

Es ist die Aufgabe des Proofreaders, einen besonderen Blick darauf zu haben!

Korrekturlesen

  • Proofreader müssen zum Proofreading-Modus wechseln

    Proofreading mode docs

    und geben übersetzte Texte frei.

    Übersetzung freigeben

  • Wenn ein Korrekturleser eine Übersetzung annimmt, wird sie in die nächste Dokumentations-Version hinzugefügt, die in keinem festen Zeitplan erstellt, sondern bei Bedarf etwa einmal pro Woche außer während der Feiertage. Um den Prozess zu beschleunigen, kannst Du das Docs-Team über neue Übersetzungen informieren.