Version 4 (modified by Claude Paroz, 11 years ago) ( diff )

Add symbolic link step in point 6

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

  1. A modification is done in the /docs dir of Django's repo.
  1. 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.
  1. Transifex downloads new pot files once or twice a day.
  1. Translators translate strings on Transifex.
  1. At defined times, translations are fetched from Transifex and pushed to django-docs-translations/translations/<locale>/*.po.
  1. Translated docs build:
    • make translations in django-docs-translations generates .mo files
    • create a symbolic link django/docs/locale pointing to django-docs-translations/translations
    • make html LANGUAGE=<locale> in django/docs`
    • Built HTML files are pushed online

Issues

Note: See TracWiki for help on using the wiki.
Back to Top