Changes between Version 8 and Version 9 of TranslatingDocumentation
- Timestamp:
- Nov 4, 2016, 1:46:44 PM (8 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TranslatingDocumentation
v8 v9 3 3 4 4 = Translation storage = 5 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.5 Proposal is to store pot files and po translation files in a separate repository (e.g. [[https://github.com/django/django-docs-translations|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. 6 6 7 7 = Workflow = 8 1. A modification is done in the /docs dirof Django's repo.8 1. A modification is done in the [[https://github.com/django/django/tree/master/docs|/docs dir]] of Django's repo. 9 9 10 10 2. New pots are automatically built for stable documentation during each documentation build (`update_docs` command of djangoproject.com) and made available at the URL `https://docs.djangoproject.com/pots/<domain>.pot`. … … 12 12 3. Transifex downloads new pot files once or twice a day. 13 13 14 4. Translators translate stringson Transifex.14 4. Translators [[https://www.transifex.com/django/django-docs/|translate strings]] on Transifex. 15 15 16 5. At defined times, translations are fetched from Transifex and pushed to `django-docs-translations/translations/<locale>/LC_MESSAGES/*.po` .16 5. At defined times, translations are fetched from Transifex and pushed to `django-docs-translations/translations/<locale>/LC_MESSAGES/*.po` (e.g. with [[http://docs.transifex.com/client/|Transifex Client]]). 17 17 18 18 6. Translated docs build: … … 20 20 * create a symbolic link `django/docs/locale` pointing to `django-docs-translations/translations` 21 21 * `make html LANGUAGE=<locale>` in `django/docs` 22 * Built HTML files are pushed online22 * Built HTML files are pushed [[https://docs.djangoproject.com/|online]] 23 23 24 24 = Issues =