Ticket #1157: t1157_r8061.diff

File t1157_r8061.diff, 2.2 KB (added by ramiro, 7 years ago)

i18n documentation patch updated (to r8061) and tweaked

  • docs/i18n.txt

    diff -r 6a18d7db65e5 docs/i18n.txt
    a b  
    433433    case, either install the ``gettext`` utilities or just copy the English
    434434    message file (``conf/locale/en/LC_MESSAGES/django.po``) and use it as a
    435435    starting point; it's just an empty translation file.
     436
     437.. admonition:: Working on Windows?
     438
     439   If you're using Windows and need to install the GNU gettext utilites so
     440   ``django-admin makemessages`` works see `gettext on Windows`_ for more
     441   information.
    436442
    437443The format of ``.po`` files is straightforward. Each ``.po`` file contains a
    438444small bit of metadata, such as the translation maintainer's contact
     
    512518    the steps to take.
    513519
    514520    .. _Submitting and maintaining translations: ../contributing/
     521
     522.. admonition:: Working on Windows?
     523
     524   If you're using Windows and need to install the GNU gettext utilites so
     525   ``django-admin compilemessages`` works see `gettext on Windows`_ for more
     526   information.
    515527
    5165283. How Django discovers language preference
    517529===========================================
     
    895907    * Django doesn't use ``xgettext`` alone. It uses Python wrappers around
    896908      ``xgettext`` and ``msgfmt``. This is mostly for convenience.
    897909
     910gettext on Windows
     911==================
     912
     913This is only needed for people who either want to extract message IDs or compile
     914.po files. Translation work itself just involves editing existing .po files, but
     915if you want to create your own .po files, or want to test or compile a changed
     916.po file, you will need the ``gettext`` utilities:
     917
     918    * Download the following zip files from http://sourceforge.net/projects/gettext
     919
     920      * ``gettext-runtime-X.bin.woe32.zip``
     921      * ``gettext-tools-X.bin.woe32.zip``
     922      * ``libiconv-X.bin.woe32.zip``
     923
     924    * Extract the 3 files in the same folder (i.e. ``C:\Program Files\gettext-utils``)
     925
     926    * Update the system PATH:
     927
     928      * ``Control Panel > System > Advanced > Environment Variables``
     929      * In the ``System variables`` list, click ``Path``, click ``Edit``
     930      * Add ``;C:\Program Files\gettext-utils\bin`` at the end of the ``Variable value``
Back to Top