Summary
This page is a proposal for a workflow to be able to translate Django documentation through po files (and Transifex platform). See also #18108.
Translation storage
Proposal is to store pot files and po translation files in a separate repository (e.g. django-docs-translations). Pot files only take up 4Mb, so considering that for each language, you add ~7Mb, this is too much for the Django main repository.
Workflow
- A modification is done in the /docs dir of Django's repo.
- New pots are automatically built for stable documentation during each documentation build (
update_docs
command of djangoproject.com) and made available at the URLhttps://docs.djangoproject.com/pots/<domain>.pot
.
- Transifex downloads new pot files once or twice a day.
- Translators translate strings on Transifex.
- At defined times, translations are fetched from Transifex and pushed to
django-docs-translations/translations/<locale>/LC_MESSAGES/*.po
(e.g. with Transifex Client).
- Translated docs build:
make translations
indjango-docs-translations
generates .mo files- create a symbolic link
django/docs/locale
pointing todjango-docs-translations/translations
make html LANGUAGE=<locale>
indjango/docs
- Built HTML files are pushed online
Issues
- Some strings are not translatable through po files currently. See https://github.com/django/django/blob/master/docs/_ext/djangodocs.py#L259
- Search should probably be limited in the current language (one search index per language)
Last modified
8 years ago
Last modified on Nov 4, 2016, 1:46:44 PM
Note:
See TracWiki
for help on using the wiki.