-
Go to https://crowdin.com/project/androidaps or 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).
-
Click strings.xml
-
Translate sentences on left side by adding new translated text or use & edit suggestion
-
Proofreaders have to switch to Proofreading mode
and approve translated texts
When a proofreader approves a translation it will be added to the next version of AndroidAPS. In the beginning it would be good to also go over the existing translations that are not yet approved and check for mistakes or approve them if they are correct.
-
Click the name of the docs page you want to translate
-
Translate sentences by sentence
1 Untranslated text is shown with red background on the left side.
2 You can copy a proposal to the edit field by clicking on the proposal.
3 Edit the proposal or write the translation yourself.
4 Click save
-
A translated page will not be published in docs before the translation is proofread.
-
When an internal link leads only to a certain page (i.e. ../Usage/Profiles.html) no translation is necessary.
-
Internal links to a certain headline (i.e. ..//Usage/Profiles.html#percentage) must be translated as the headline in the other language is different from the English original.
-
If you translate a headline you can transform this into the anchor link (part after # - i.e. #percentage) by turning all letters to lower case, transforming special characters to standard characters, replacing spaces by - (minus sign) and skipping punctuation marks.
Here are some examples:
- Was ist ein Closed Loop System mit AndroidAPS? ---> #was-ist-ein-closed-loop-system-mit-androidaps
- Docs Updates & Änderungen ---> #docs-updates-anderungen
- AAPS-.apk Datei ---> #aaps-apk-datei
-
Check your link if it is working as intended. If it is linking to a new translated headline you may have to wait until next build to be able to check correct link syntax. In this case do not forget to make a reminder in your calendar / todo app.
At the moment two markup languages are used in docs. Whereas files written in reStructuredText syntax (.rst) always show link address in Crowdin, for files in Markdown syntax (.md) you might have to activate HTML tag displaying in order to translate the link address.
Make sure not to use space character at within HTML tags at the beginning or the end!
If links are displayed like this in Crowdin
click on the cogwheel to open settings, select "Show" and click "Save".
Links will then be shown in standard HTML format and can be translated considering the rules mentioned above.