[[PageOutline]]

== Offers of translation ==

(please add yourself if you wish to translate parts of Django to other languages, please keep the list in English alphabetical order)

 * '''Arabic''' (ar): Ahmad Alhashemi <ahmad dot alhashemi at gmail dot com>, Ossama Khayat <okhayat at yahoo dot com>
 * '''Basque''' (eu): Ibon Solana <ibonso@gmail.com>
 * '''Bengali''' (bn): Baishampayan Ghose <b.ghose at gnu dot org dot in> 
 * '''Bosnian''' (bs): Filip Dupanović <kron@kron.ba>
 * '''Bulgarian''' (bg): Jordan Dimov <s3x3y1@gmail.com>
 * '''Catalan''' (ca): Marc Fargas <telenieko@telenieko.com>, Marc Garcia <marc.garcia@accopensys.com>, Marc Barranco <mbarranco@salle.url.edu>
 * '''Chinese, Simplified''' (zh_CN): alang.yl@gmail.com, limodou@gmail.com,stan8688@gmail.com, nick.nickcheng@gmail.com
 * '''Chinese, Traditional''' (zh_TW): Yung-Yu Chen <yyc@seety.org>, dwight <dwight_at_ccns.ncku.edu.tw>
 * '''Croatian''' (hr): Aljosa Mohorovic <aljosa.mohorovic@gmail.com>
 * '''Czech''' (cs_CZ): Vláďa Macek <macek@sandbox.cz>, Tomáš Ehrlich <tomas.ehrlich@gmail.com>
 * '''Danish''' (da): Finn Gruwier Larsen <finn@gruwier.dk>
 * '''Dutch''' (nl): Johan C. Stöver <johan at nilling dot nl>, Rudolph Froger <rudolph at froger dot eu>
 * '''Estonian''' (et): Erik Allik <eallik at gmail>, Ideelabor team <removethis-ideelabor at ideelabor-dot-ee>
 * '''Finnish''' (fi): Antti Kaihola <antti dot kaihola at linux dash aktivaattori dot org>, Ville Säävuori <ville at  syneus dot fi>
 * '''French''' (fr_FR): yeiazel <yeiazel@yeiazel.net>, asrenzo <laurent.rahuel@club-internet.fr>, pablo <pablo.pernot@gmail.com>, mikael <mikael.barbero_at_NOSPAM_free.fr>, gaël <gael.dev_AT_NOSPAM_4now.net>, Stéphane Raimbault <stephane DOT raimbault_AT_NOSPAM_gmail.com>
 * '''Galician''' (gl): Afonso Fernández Nogueira <fonzzo.django@gmail.com>
 * '''Georgian''' (ka): David Avsajanishvili <avsd05@gmail.com>
 * '''German''' (de_DE): hugo <gb@bofh.ms>, Paulus <krabbe@gmx.net>, patrick <patrick@vonautomatisch.at>, Dirk Eschler <dirk.eschler@gmx.net>, Jannis Leidel <jannis@leidel.info>, Florian Sening <florian.sening@web.de>
 * '''Greek'''  (el): panos <panos.laganakos at gmail dot com>, orestis <orestis at orestis dot gr>, Dimitris Glezos <dimitris at glezos dot com>
 * '''Hebrew''' (he): Meir Kriheli <meir at mksoft dot co dot il>, Alex Gaynor <alex.gaynor@gmail.com>
 * '''Hungarian''' (hu): Károly Nagy <charlie at rendszergazda dot com>, Szilveszter Farkas <szilveszter dot farkas at gmail dot com>
 * '''Icelandic''' (is): Dagur Páll Ammendrup <dagurp at gmail dot com> 
 * '''Indonesian''' (id): Ben Miller <ben.miller@isotoma.com>, Romi Hardiyanto <romihardiyanto at gmail _dot_ com>
 * '''Italian''' (it_IT): Nicola Larosa <nico at tekNico dot net>, Carlo C8E Miron <carlo.miron AT gmail.com>, Paolo Dina <paolo@php3.it>, Ludovico Magnocavallo <ludo@asiatica.org>, Antonio Cavedoni <antonio@cavedoni.org>, Marco Del Tongo <info@marcodeltongo.com>, Daniele Spinosa <picioslug@gmail.com>
 * '''Japanese''' (ja): makoto tsuyuki <mtsuyuki at gmail dot com>, Takashi Matsuo <matsuo.takashi at gmail dot com>
 * '''Kannada''' (kn): Pradeep Kishore Gowda <pradeep.gowda at gmail dot com>
 * '''Korean''' (ko): Hyun Mi Ae <happyhyun at gmail dot com>, Sung Jin Hong <serialx.net at gmail dot com>, Spike!^ekipS <spikeekips at gmail dot com>, Sangho <0x8606 AT gmail DOT com>
 * '''Latvian''' (lv): Edgars Jēkabsons <edgars@way.lv>, Gatis Tomsons <gatis.tomsons@gmail.com>
 * '''Lithuanian''' (lt): Rapolas Kaselis <rapolas at google-oogle mail com>
 * '''Macedonian''' (mk): Georgi Stanojevski <glisha gmail com>
 * '''Malay''' (ms): Ben Miller <ben.miller@isotoma.com>
 * '''Mongolian''' (mn): Natsagdorj Shagdar <natsag2000 at yahoo dot com>
 * '''Norwegian''' (no): Jon Lønne <jon at funkbit dot no>
 *  '''Norwegian Nynorsk''' (nn): Håvard Grimelid <havard at grimelid dot com>
 * '''Persian''' (fa): Reza Mohammadi <reza@zeerak.ir>, Mahmoud Sahebi Afzal <cmorgh at gmail dot com>
 * '''Polish''' (pl): Marcin Kaszynski <marcink@elksoft.pl>
 * '''Portuguese''' (pt_BR): Mario Caseiro <mario.caseiro at gmail.com>, Gabriel Sales de Oliveira <gabriel.sales  at gmail dot com>, Kao Cardoso Félix <kcfelix [at] gmail [dot] com> Andre A Duarte <andre_sie at terra.com.br >, Guilherme Mesquita Gondim <semente at taurinus dot org>, Django Localization Portuguese Group <django-l10n-portuguese at googlegroups.com>
 * '''Romanian''' (ro): Tiberiu Micu <tibimicu at gmx dot net>, Mihai Damian <yang_damian at yahoo dot com>
 * '''Russian''' (ru): Grigory Fateyev <greg at dial dot com dot ru>, Dmitry Sorokin <dimas at dial dot com dot ru>
 * '''Serbian''' (sr - cyrillic, sr_Latn - latin): Nebojša Đorđević <nesh@studioquattro.co.yu>, Petar Marić <petar.maric@gmail.com>, Janoš Guljaš <janos@janos.in.rs>
 * '''Slovak''' (sk): František Malina <vizualbod@vizualbod.com>, Vladimir Labath <vlado at labath dot org>
 * '''Slovenian''' (sl): Jure Čuhalev <gandalf@owca.info>, Gašper Žejn <zejn@owca.info>
 * '''Spanish (Argentina)''' (es_AR): Ramiro Morales <cramm0 at gmail dot com>
 * '''Spanish (Spain)''' (es_ES): Marc Fargas <telenieko@telenieko.com>, Marc Garcia <marc dot garcia at accopensys dot com>
 * '''Swedish''' (sv): Mikko Hellsing <mikko aino se>, Ludvig Ericson <ludvig.ericson|gmail com> (maintainer)
 * '''Tagalog''' (tl): Ben Miller <ben.miller@isotoma.com>
 * '''Tamil''' (ta): R Hariram Aatreya <rha at au-kbc dot org>, Parthan SR <parth dot technofreak at gmail dot com>
 * '''Telugu'''(te): U.Chinna Obula Reddy <ucoreddy@au-kbc.org> 
 * '''Urdu''' (ur) : ''Ahmed Sboor'' <ahmed.19@gmail.com>, Ben Miller <ben.miller@isotoma.com>
 * '''Vietnamese''' (vi): Ben Miller <ben.miller@isotoma.com>
 * '''Welsh''' (cy): Jason Davies <jason at jasondavies dot com>
 

== How to Send Translations ==

The best way to send in translations - after registering oneself as translator above - is to create a ticket and to attach the new .po file to that ticket (please don't attach .po files to this page, use the ticket system!). Use "Translations" as the component when you file the ticket, so that it shows up in {13}.

Additionally it would be great if you join the [http://groups.google.com/group/Django-I18N Django I18N mailing list].

== How to Update Translations ==

Assuming you have done a checkout of django in a folder called '''django_src''' and that's where the django, docs, examples, extras and other files are.

 1. Ensure that you are running the latest subversion checkout of the code - run "svn update" in your local django subversion copy.
 1. Change dir to django_src/django
 1. Run {{{PYTHONPATH=../ bin/django-admin.py makemessages -l <locale>}}} and you get updated .po files
 1. Update any untranslated and fuzzy messages with your favorite translation tool. Anything that looks like "%s" or "%(something)s" has to be copied precisely and the 's' may be a 'd' or 'x' or 'i', possibly.
 1. Run {{{django-admin.py compilemessages -l <locale>}}} and ensure there are no errors.
 1. Change dir to django_src
 1. Do a {{{svn diff django/conf/locale/ > django-i18n-<locale>.patch}}} to create the diff file
 1. Upload the diff of .po files to Trac. (The complete new .po files are ok, but diff file would be better.)

It is best practice to just check every few weeks (once a month or so if you're really enthusiastic; less often if you're
not) to see if there's been any big changes.

Prior to any release, Django maintainers will make an announcement. Prior to 1.0, we'll have a couple of weeks of string freeze in order to give people time to be 100% translated. 

== Tools ==

This should be a list of useful (and needed) software for translators to work on .po files.

=== Linux and other Unix Systems ===

 * required for {{{makemessages}}} and {{{compilemessages}}} commands: the gettext utilities. These should be available with your distribution. With Debian based distributions it is the {{{gettext}}} package.

 * translating: [http://gtranslator.sourceforge.net/ gtranslator] for GNOME, [http://kde.org/applications/development/lokalize/ lokalize] for KDE, [http://www.poedit.net/ poEdit]

=== Windows ===

 * required for {{{makemessages}}} and {{{compilemessages}}}: the gettext utilities. The [http://www.cygwin.com/ cygwin installation] looks most promising. Another place would be [http://sourceforge.net/project/showfiles.php?group_id=25167 the gettext Download on SourceForge].

 * translating: [http://www.poedit.net/ poEdit] (supports fuzzy, plural, translation memory, UTF-8, compiles to .mo files - it includes native win32 GNU gettext binaries)

=== Mac OS X ===

 * translating: [http://www.poedit.net/ poEdit], [http://www.triplespin.com/en/products/locfactoryeditor.html LocFactory Editor]

=== Multi-platform ===

 * [http://www.gnu.org/software/emacs/ GNU Emacs] with {{{po-mode}}};

 * [http://www.vim.org VIM] can work with .po files without trouble, there's a special plugin with helpers: [http://vim.sourceforge.net/scripts/script.php?script_id=695 po.vim] which updates dates, and searches for strings.

== Translations of the Django documentation ==

If for some reason you are not interested to translate Django interface, but instead you feel the desire to point your translation weapons against Django documentation (the content of '/docs'), you are invited to use the TranslateDocumentation wiki page to better organize your translation works together with other translators.