= Summary = This page is a proposal for a workflow to be able to translate Django documentation through po files (and [[http://www.transifex.com|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 = 1. A modification is done in the /docs dir of Django's repo. 2. A `make gettext` in the 'docs' directory generates pot files in `_build/locale` (works already). Those pot files are copied to `django-docs-translations/pots` and modifications pushed. 3. Transifex downloads new pot files once or twice a day. 4. Translators translate strings on Transifex. 5. At defined times, translations are fetched from Transifex and pushed to `django-docs-translations/translations//*.po`. 6. Translated docs build: * `make translations` in `django-docs-translations` generates .mo files. * `make html LANGUAGE= TRANSDIR=/django-docs-translations/translations//` in `django/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#L128 * Search should probably be limited in the current language (one search index per language)