Translating Time to Leave to other Languages

[thamara]

Time to Leave now supports multiple languages.
You can help to translate it into new languages, or enhance the supported languages by translating missing strings.
Please refer to this comment to get the list of missing strings translations. Please check if there's any open item for the translation, and if it's not assigned to anyone.

⚠️ Please, only translate into language you are fluent on.

How to contribute

• Demonstrate your interest in translating to a new language in this issue
• Open a new issue in the project (see Translate Time to Leave to fr-fr #460 for reference) and we'll assign that to you
• Follow the guide below to do the translation

Adding new languages

• Add the language locale in src/configs/app.config.js, on the array languages with the name for the language not translated, but instead in the native name for the language. Make sure it is sorted by the language locale.
• Create a new directory under locales, with the locale of the language
• Copy the json files from locales/en/ to the new created directory
• Translate the strings in the new locales/{LANG}/translation.json
  • You'll see strings for "Time to Leave". This is the app name, and you don't need to translate it.
• Translate README, by creating a new docs/README-{LANG}.md, with a copy of the main README.md, but translating into the specific language
• Include a reference to newly created docs/README-{LANG}.md in README.md, close to the top, following the template:
  • <a href="docs/README-{LANG}.md"><img src="https://img.shields.io/badge/{LANG}-{Name for the language in original language}-purple" alt="This document is also available in {Language name}"></a>
• Add coverage for the new locale on the getLanguageName test on https://github.com/thamara/time-to-leave/blob/d7f49f1565b70a81fdd60faba823d2da0cb4f30d/__tests__/__main__/user-preferences.js ,

The translations can be done incrementally, so don't feel like you need to do take all this work alone.

Including missing translations

• Refer to this comment to get the list of missing strings translations.
• Check if there's any open item, if not, feel free to open one
• Check if someone is already working on it, if not, please comment saying you are interested in working on that
• Translate the strings and submit a PR

Ongoing translations

Fully supported languages

⚠️ Check for the updated list in the comment: #475 (comment)
The list below is mainly to track maintainers.

• Bengali (bn)
• Brazilian Portuguese (pt-BR) (@thamara, @tupaschoal, @araujoarthur0)
• Catalán (ca-CA) (@servatj)
• Dutch (nl) (@Semvrij)
• English (en) (@thamara, @tupaschoal, @araujoarthur0)
• French (fr-FR) (@QuentinPhilipp)
• German (de-DE)
• Greek (el)
• Gujarati (gu) (@nikkhil31)
• Hebrew (he) (@TomerPacific)
• Hindi (hi)
• Indonesian (id) (@aqmalio)
• Italian (it) (@giovannipessiva, @cinziaborello)
• Japonese (ja) (@suke6mix)
• Korean (ko) (@Esot3riA)
• Marathi (mr) (@RuteshRathod)
• Persian (fa-IR): (@R3z4Pr0gramm3r)
• Polish (pl)
• Portuguese (pt-PT) (@drcor)
• Russian (ru-RU)
• Spanish (es)
• Swedish (sv-SE) (@wonkyung)
• Tamil (ta) (@code-reaper08)
• Thai (th-TH)
• Simplified Chinese (zh-CN)
• Traditional Chinese (zh-TW) (@jswildcards)
• Turkish (tr-TR) (@omerisildak)
• Ukrainian (uk-UA) (@timagixe)

Let us know if you have any questions.

[thamara]

Summary - 29 languages supported (186 strings)

Locale	Translation progress	Missing strings
bn		0
ca		0
de-DE		0
el		2 (Open issue)
es		0
fa-IR		0
fr-FR		0
gu		0
he		0
hi		0
id		0
it		0
ja		0
ko		0
mr		0
nl		0
pl		0
pt-BR		0
pt-MI		0
pt-PT		4 (Open issue)
ru-RU		0
sv-SE		0
ta		0
th-TH		0
tr-TR		0
uk-UA		0
zh-CN		1 (Open issue)
zh-TW		0

Missing Translations:

el

2/186 - 1.08% missing:

{
 "$Menu": {
 "ok": "OK"
 },
 "$Preferences": {
 "cadentStar": "Cadent Star"
 }
}

pt-PT

4/186 - 2.15% missing:

{
 "$FlexibleMonthCalendar": {
 "total": "Total"
 },
 "$Menu": {
 "menu": "Menu",
 "ok": "OK"
 },
 "$Preferences": {
 "hours-per-day": "HH:mm"
 }
}

zh-CN

1/186 - 0.54% missing:

{
 "$Preferences": {
 "hours-per-day": "HH:mm"
 }
}

[TomerPacific]

Hi @thamara , just made a PR to translate TTL to Hebrew. Can you check it out?

[tanyaleepr]

Hi. I am interested to translate into Spanish the entire content. I see there are some grammar errors in Spanish. Can I work on it? Thanks.

[araujoarthur0]

Hi @tanyaleepr! Please open an issue and then we can assign it to you.

[thamara]

@tanyaleepr , TTL is already translated to 'es'. But I know that Spanish can be quite different around the world. So please, check if by any chance the 'es' supported is already in line with your Spanish, and if not, feel free to open an issue and translate it to the specific locale (for example, es-ar for Argentina, es-es for Spain, etc).

[drcor]

Hello I want to help translating to pt-PT (Portuguese from Portugal)
I have opened an issue for it #907

[Kostioan]

Hello, I want to help translating to el-GR (Greek).
I have opened an issue for it #943

[ibrahimesseddyq]

i would like to add arabic translation @thamara