Changes between Version 8 and Version 9 of TranslatingDocumentation


Ignore:
Timestamp:
Nov 4, 2016, 1:46:44 PM (7 years ago)
Author:
Maciej Olko
Comment:

hyperlinks added

Legend:

Unmodified
Added
Removed
Modified
  • TranslatingDocumentation

    v8 v9  
    33
    44= 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.
     5Proposal 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.
    66
    77= Workflow =
    8 1. A modification is done in the /docs dir of Django's repo.
     81. A modification is done in the [[https://github.com/django/django/tree/master/docs|/docs dir]] of Django's repo.
    99
    10102. 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`.
     
    12123. Transifex downloads new pot files once or twice a day.
    1313
    14 4. Translators translate strings on Transifex.
     144. Translators [[https://www.transifex.com/django/django-docs/|translate strings]] on Transifex.
    1515
    16 5. At defined times, translations are fetched from Transifex and pushed to `django-docs-translations/translations/<locale>/LC_MESSAGES/*.po`.
     165. 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]]).
    1717
    18186. Translated docs build:
     
    2020  * create a symbolic link `django/docs/locale` pointing to `django-docs-translations/translations`
    2121  * `make html LANGUAGE=<locale>` in `django/docs`
    22   * Built HTML files are pushed online
     22  * Built HTML files are pushed [[https://docs.djangoproject.com/|online]]
    2323
    2424= Issues =
Back to Top