Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Fixed #1157 -- Added some text to i18n.txt to explain how to install the

necessary gettext tools on Windows (relevant to translators only). Thanks,
Ramiro Morales.


git-svn-id: http://code.djangoproject.com/svn/django/trunk@8134 bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
commit b6fe483bf5783a72fdfbe55463b9490496da1fa3 1 parent 548ac72
Malcolm Tredinnick authored

Showing 1 changed file with 33 additions and 0 deletions. Show diff stats Hide diff stats

  1. 33  docs/i18n.txt
33  docs/i18n.txt
@@ -434,6 +434,12 @@ do the same, but the location of the locale directory is ``locale/LANG/LC_MESSAG
434 434
     message file (``conf/locale/en/LC_MESSAGES/django.po``) and use it as a
435 435
     starting point; it's just an empty translation file.
436 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.
  442
+
437 443
 The format of ``.po`` files is straightforward. Each ``.po`` file contains a
438 444
 small bit of metadata, such as the translation maintainer's contact
439 445
 information, but the bulk of the file is a list of **messages** -- simple
@@ -513,6 +519,12 @@ That's it. Your translations are ready for use.
513 519
 
514 520
     .. _Submitting and maintaining translations: ../contributing/
515 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.
  527
+
516 528
 3. How Django discovers language preference
517 529
 ===========================================
518 530
 
@@ -895,3 +907,24 @@ does translation:
895 907
     * Django doesn't use ``xgettext`` alone. It uses Python wrappers around
896 908
       ``xgettext`` and ``msgfmt``. This is mostly for convenience.
897 909
 
  910
+``gettext`` on Windows
  911
+======================
  912
+
  913
+This is only needed for people who either want to extract message IDs or
  914
+compile ``.po`` files. Translation work itself just involves editing existing
  915
+``.po`` files, but if you want to create your own .po files, or want to test
  916
+or compile a changed ``.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``

0 notes on commit b6fe483

Please sign in to comment.
Something went wrong with that request. Please try again.