How to translate strings for the AndroidAPS app or the documentation

  • For the the strings used in the app go to https://crowdin.com/project/androidaps and login using your GitHub account

  • For the documentation please visit https://crowdin.com/project/androidapsdocs and login using your GitHub account

  • Send a join request to the docs team. To do so click on the flag of the desired language and then the button « Join » on the top right corner of the next page. 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 AndroidAPS users).

Time for Approval :class: note

The approval is a manual step. As non profit organization we don’t provide SLAs but in general the approval will be done in < 1 day. If not please contact the Doc team via Facebook or Discord. :::

  • When we approve you, click the flag When we approve you, click the flag

Translation of the app

Translate strings for AndroidAPS app

  • If you have no preference for strings you translate just select the « Translate All » button to start. It will show you the strings which need translation.

    Click translate all

  • If you want to translate an individual file please search for the file via search dialog or tree structure and click on the filename to start the translation work on strings in that file.

    Click strings.xml

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

    Translation app

Proofread strings for AndroidAPS app

  • Proofreaders start by selecting « Proofread » when starting from the language home screen.

    Proofreading mode app

    and approve translated texts

    approve text

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

Translation of the documentation

  • Click the name of the docs page you want to translate

Click docs page

  • Translate sentences by sentence

    1. The yellow text is the text you are working at the moment.

    2. The green text is already translated. You don’t need to do this again.

    3. The red text is the remaining text which have to be translated.

    4. This is the source text you are working on at the moment

    5. This is the translation you are preparing. You can copy the text from above or select one of the suggestions below.

    6. These are the suggestion for a translation. Especially you can see how much Crowdin rates this as a fit or if it was already just in the past and come up through text rearrangements but not content change.

    7. Press the « save » button to save a proposal for the translation. It will then promoted to a proofreader for final check.

Translation docs

  • A translated page will not be published in docs before

    1. the translation is proofread

    2. the sync run between Crowdin and Github finished (once an hour) which creates an PR for Github.

    3. the PR in Github was approved.

In general this needs 1 - 3 days but might during holiday take a little bit longer.

Translating links

You are translating the text which represents the link. Please you have to be carefull not to remove the link which is represented by a pair of <0></0> tags or if their are more in one paragraph other numbers.

It’s the proofreaders job to have a special look on this!

Proofreading

  • Proofreaders have to switch to Proofreading mode

    Proofreading mode docs

    and approve translated texts

    approve text

  • When a proofreader approves a translation it will be added to the next docs build which happens in no fixed schedule on demand but around once a week except during hollidays. To speed up the process you can inform docs team about new translations.