python/lib/django_1_4/docs/internals/contributing/localizing.txt

   1 =================
   2 Localizing Django
   3 =================
   4
   5 Various parts of Django, such as the admin site and validation error messages,
   6 are internationalized. This means they display differently depending on each
   7 user's language or country. For this, Django uses the same internationalization
   8 and localization infrastructure available to Django applications, described in
   9 the :doc:`i18n documentation </topics/i18n/index>`.
  10
  11 Translations
  12 ------------
  13
  14 Translations are contributed by Django users worldwide. The translation work is
  15 coordinated at `Transifex`_.
  16
  17 If you find an incorrect translation or want to discuss specific translations,
  18 go to the `Django project page`_. If you would like to help out with
  19 translating or add a language that isn't yet translated, here's what to do:
  20
  21 * Join the `Django i18n mailing list`_ and introduce yourself.
  22
  23 * Make sure you read the notes about :ref:`specialties-of-django-i18n`.
  24
  25 * Signup at `Transifex`_ and visit the `Django project page`_.
  26
  27 * On the `Django project page`_, choose the language you want to work on,
  28   **or** -- in case the language doesn't exist yet --
  29   request a new language team by clicking on the "Request language" link
  30   and selecting the appropriate language.
  31
  32 * Then, click the "Join this Team" button to become a member of this team.
  33   Every team has at least one coordinator who is responsible to review
  34   your membership request. You can of course also contact the team
  35   coordinator to clarify procedural problems and handle the actual
  36   translation process.
  37
  38 * Once you are a member of a team choose the translation resource you
  39   want to update on the team page. For example the "core" resource refers
  40   to the translation catalogue that contains all non-contrib translations.
  41   Each of the contrib apps also have a resource (prefixed with "contrib").
  42
  43   .. note::
  44      For more information about how to use Transifex, read the
  45      `Transifex User Guide`_.
  46
  47 Formats
  48 -------
  49
  50 You can also review ``conf/locale/<locale>/formats.py``. This file describes
  51 the date, time and numbers formatting particularities of your locale. See
  52 :ref:`format-localization` for details.
  53
  54 The format files aren't managed by the use of Transifex. To change them, you
  55 must :doc:`create a patch<writing-code/submitting-patches>` against the
  56 Django source tree, as for any code change:
  57
  58 * Create a diff against the current Subversion trunk.
  59
  60 * Open a ticket in Django's ticket system, set its ``Component`` field to
  61   ``Translations``, and attach the patch to it.
  62
  63 .. _Transifex: https://www.transifex.com/
  64 .. _Django i18n mailing list: http://groups.google.com/group/django-i18n/
  65 .. _Django project page: https://www.transifex.com/projects/p/django/
  66 .. _Transifex User Guide: http://help.transifex.com/