Localization

Localization

Set a language for OSMbot

Please see the /settings - Configure OSMbot page on this wiki.

How to add a new language

1. Login in Transifex and type in box search «OSMbot», or follow this link to the page project: https://www.transifex.com/osm-catala/osmbot/ .
2. Request the language: Select option «Languages» on left menu and then click the button «Request language».
3. Select the language in the list of available languages and click on «Request» button.

Now, team managers of project in Transifex will accept your request, and send you a invitation to join to the language translators team.

• Begin the translation: Go to «Languages» on left menu, select your language, click on «osmbot.pot» and then on «Translate» button. That's all.

• IMPORTANT: You can translate words in < > like <search_term>. But it's very important don't translate commands: words that begin with /, like /search, /map, /settings, /nearest, etc.

• 

• Make a pull request with new/updated language, see how to on «Add/update language» (for developers).

Use of strings

• Strings for translate are used in the Telegram bot. You can see how they work in «templates» directory on the code. One bot message can be created with two or more strings. One example here.
• The last four strings are used on StoreBot webpage: https://storebot.me/bot/osmbot .

State of translations

Languages with icon ✔️ , now are working on @OSMbot (last update: 11/19/16). You can view languages that work now (in the code).

Germanic	Romance	Slavic	Other
🔟 English🔧 ✔️	9️⃣ Asturian ✔️	🔟 Czech ✔️	🔟 Chinese (CN) ✔️
9️⃣ Dutch ✔️	🔟 Catalan ✔️	🔟 Polish ✔️	🔟 Chinese (HK) ✔️
🔟 Swedish ✔️	🔟 Cat. (Valencian) ✔️	🔟 Russian ✔️	🔟 Chinese (TW) ✔️
9️⃣ German ✔️	🔟 Italian ✔️	🔟 Slovak ✔️	🔟 Hungarian ✔️
0️⃣ Danish	🔟 Portuguese ✔️	🔟 Ukrainian ✔️	9️⃣ Japanese ✔️
	🔟 Spanish ✔️		🔟 Persian (IR)‼️⬅️ ✔️
	9️⃣ French ✔️		9️⃣ Vietnamese ✔️
	🔟 Galician ✔️		8️⃣ Basque ✔️
	8️⃣ Portuguese (BR)		2️⃣ Kannada
	0️⃣ Spanish (LA)		2️⃣ Esperanto
			0️⃣ Arabic ⬅️
			0️⃣ Acoli
			0️⃣ Albanian
			0️⃣ Finnish
			0️⃣ Greek
			0️⃣ Indonesian
			0️⃣ Khmer
			0️⃣ Korean
			0️⃣ Malayalam
			0️⃣ Tamil
			0️⃣ Uzbek

Legend for languages table

• 🔧 : source language
• ✔️ : languages working on OSMbot
• ⬅️ : RTL languages
• ‼️ : Fixing RTL problems

Progress bars

Greater than 80% Can be added on OSMbot	40-80% In progress, need work	Less than 40% Can be removed from Transifex
- 🔟	- 7️⃣	- 3️⃣
- 9️⃣	- 6️⃣	- 2️⃣
- 8️⃣	- 5️⃣	- 1️⃣
	- 4️⃣	- 0️⃣

How we fix RTL problems in code

• List of RTL languages in this line: https://github.com/Xevib/osmbot/blob/master/bot/osmbot.py#L37
• Variable that defines if language is RTL: https://github.com/Xevib/osmbot/blob/master/bot/osmbot.py#L635
• We add {% if is_rtl -%}{{'\U0000200F'}}{% endif -%} before lines, you can see an example here.
• Some strings in RTL need to change its direction to LTR. In this case we use {% if is_rtl -%}{{'\U0000200E'}}{% endif -%}, you can see an example here: first get right-alignment and then force phone to get LTR direction.
• \U0000200F is the Right-to-left mark that refers to this Unicode character that forces RTL direction in strings. You can see more info on «How to use Unicode controls for bidi text».
• RTL languages are marked with ⬅️ on the table.