How do I create a new translation of the forum?

Hi, I just made a fresh install of misago

Did you use docker for dev setup? Thats entry point for localizing work.

Also please start new threads with your questions instead of piggybacking existing ones ;)

I think this deserves follow up post. ;)

Few years back I have produced this guide for people interested in translating Misago to other languages. This guide was created in early days of Misago, when Misago 0.2 or 0.3 was around, before tools existed that could've made this easy.

So, if you want to translate Misago to your language, first, thank you for your interest! Secondly, make sure that you have GitHub account. Now, go to Transifex and use your GitHub account to log in. Next use "Help Translate" option make the request to be added as translator for your language to Misago. It takes me few hours to approve those requests, but you can always poke me on this forums or on our Discord dev chat. After being approved, you should be good to go and translate messages using Transifex interface.

Obviously, you will also want to test the translation and run Misago with it. To do this, you should use our Docker for local development setup. You will also need the Transifex Client installed in your Python - you can install it system-vide with pip install transifex-client, it's dependencies are limited enough to don't pollute your system setup.

If you have Misago up running on your machine, and typing the tx in your console shows "This is the Transifex command line...", you are good to go. Open the settings.py file located in the devproject directory in your favorite code editor and find the LANGUAGE_CODE = 'en-us' part. You have to replace the en-us with language code. I'm pole and this language codes table says that I should use "pl", so in my case that setting will have to be edited to LANGUAGE_CODE = 'pl'. Now download translation files for your language by running the tx pull -f -l pl in project's directory that I have cloned from GitHub. This will download the raw translation files for your language from Transifex. But raw files are slow to load into the app, so you need to compile them into fast .mo files before Misago will be able to load them. You can do this with docker-compose run --rm misago django-admin.py compilemessages.

Now you should be able to start your development instance of Misago and see how your translation works out.

Superlate edit: And ofcourse tx pull -f doesn't ignore the minimum_perc setting that I am using to only pull translations completed above 40%. I'll try to come up with some utility scripts or improvements for translation authors, maybe in Misago 0.19 as this feels small change.