Hi, I just made a fresh install of misago - how do I create a new translation of the forum? I would like to translate it into danish.
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.