Django 学习笔记 － i18n 支持

最近再用 Django 做东西，顺便写点笔记做下记录。

今天折腾这个 Django 的 i18n 支持着实费了点功夫，主要是一开始没理解 Python 做 i18n 的原理导致。废话不多说了，使用 Django 的 i18n 支持还是相当的方便的。Django 的官方文档上讲的很详细了，但是篇幅过长，我也是硬着头皮看了几遍才搞明白，下面我就简单介绍一下最快捷的方法。

首先，从配置入手，settings.py 里面有一个 LANGUAGE_CODE属性，这里设置了网站默认的语言。由于settings.py里面的属性支持重写，所以从官方文档上可以得知，默认情况下已经启用i18n支持了，我们需要加入一些middleware来支持动态切换语言。

MIDDLEWARE_CLASSES = (
 'django.contrib.sessions.middleware.SessionMiddleware',
 'django.middleware.locale.LocaleMiddleware',
 'django.middleware.common.CommonMiddleware',
)

注意顺序，LocaleMiddleware必须在SessionMiddleware下面，因为需要从Session里面获取一个语言类型，这些Django都有现成的了，很方便。

在urls.py里面配置一个i18n的辅助应用

(r'^i18n/', include('django.conf.urls.i18n')),

有了这个就可以自由的切换语言了，使用/i18n/setlang/?language=en这样的形式。

配置完成之后在项目目录底下建立一个locale目录，locale下子目录的样式有固定格式，如:
locale/<language>/LC_MESSAGES/
如果是中文，对应的目录就是
locale/zh_CN/LC_MESSAGES/
如果是英文，则应该是
locale/en/LC_MESSAGES/
以此类推。

为了在django里面使用i18n，po文件名必须为djang.po，编译过后必须为django.mo，那么翻译的内容就固定在po文件里了。一个典型的po文件类似一下样式：

# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR , YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2006-12-21 14:00+0800\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME \n"
"Language-Team: LANGUAGE \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

msgid "Home"
msgstr "Home"

msgid "News"
msgstr "News"

格式相对比较简单，也是键值对的形式。如果是多行的话，需要使用msgstr ""的形式，首行不写东西，在后续的几行写文本，翻译出来的结果会由程序自动把文字组合到一起。

编写完的po文件需要编辑成二进制的mo文件才可以被django使用，django使用了gettext来实现翻译，所以mo格式也是gettext要求的。

在linux下使用msgfmt -o django.mo django.po即可完成转换过程，相当方便，windows下需要下载poEdit这个软件。

翻译工作都准备就绪了，接下来就是体现到模板上去了，首先加载i18n，在模板文件的头部加入{% load i18n %}，下来对于需要i18n支持的字段使用{% trans 'Key' %}，这里的Key就是msgid，很简单吧。

这里仅仅介绍了Django i18n的一个快速上手配置，更详细的内容请参考
http://www.djangoproject.com/documentation/i18n/