django2-babel 0.6.3

提取方法映射

所以 django-babel 自带了一个提取方法插件，可以从 Django 模板文件中提取可本地化的消息。Babel 开箱即用地支持 Python。要使用此提取功能，请在项目目录（项目包上方的目录）中创建一个名为 babel.cfg的文件，其内容为：

[django: templates/**.*]
[django: mypkg/*/templates/**.*]
[python: mypkg/**.py]

这指示 Babel 查找顶级模板 目录中的任何文件，或应用程序模板目录中的任何文件，并使用名为“django”的提取方法从这些模板文件中提取消息。您需要将这些 glob 模式调整到您存储模板的任何位置。

此外，包目录中任何扩展名为.py的文件（将“mypkg”替换为 Django 项目包的实际名称）都由“python”提取方法处理。

如果你不使用 setuptools，或者由于某种原因没有使用 setuptools/pip 安装 django-babel，你需要定义提取方法“django”映射到的函数。这是在配置文件顶部的额外部分中完成的：

[extractors]
django = <s>django_babel.extract:extract_django</s>

模板的编码假定为 UTF-8。如果您使用不同的编码，则需要在配置中指定它。例如：

[django: templates/**.*]
encoding = <s>iso-8859-1</s>

运行提取过程

一旦你设置了配置文件，实际的提取是通过执行与 Babel 包一起安装的命令行程序pybabel来执行的：

$ cd projectdir
$ pybabel extract -F babel.cfg -o mypkg/locale/django.pot .

这会在mypkg/locale/django.pot中创建 PO 文件模板。

创建和更新翻译目录

如果您还没有翻译目录，则需要创建它们。这是使用pybabel init命令完成的：

$ pybabel init -D django -i mypkg/locale/django.pot -d mypkg/locale -l en_US
$ pybabel init -D django -i mypkg/locale/django.pot -d mypkg/locale -l de_DE

这应该创建两个文件：mypkg/locale/en_US/django.po和 mypkg/locale/de_DE/django.po。这些文件是您放置实际翻译的地方。

当您修改 Python 源文件或模板时，通常需要同步翻译目录。为此，您首先按照上一节所述执行全新提取，以便更新django.pot文件。

然后，运行pybabel update命令将更改合并到翻译目录中：

`bash $ pybabel update -D django -i mypkg/locale/django.pot -d mypkg/locale `

这将更新在mypkg/locale目录中找到的所有.po文件。

编译翻译目录

最后，您需要将这些.po文件编译为二进制.mo文件。为此使用 pybabel 编译命令：

$ pybabel compile -D django -d mypkg/locale

添加--statistics选项以获取有关翻译完整性的信息：

$ pybabel compile -D django -d mypkg/locale --statistics

使用setup.py

如果您将setup.py脚本添加到您的项目并使用 Babel 附带的 distutils/setuptools 命令，上述大部分过程都可以自动化。这在Distutils/Setuptools 集成中有所描述。

日期文件

呈现日期的字符串表示形式。

• 输入： datetime.date、datetime.datetime或 float/int 时间戳

• 参数：格式名称或模式（可选）

假设book.pubdate返回一个datetime.date或 datetime.datetime对象：

{{ book.pubdate|datefmt:"short" }}

将呈现：4/1/07和

{{ book.pubdate|datefmt:"E, MMM dd yyyy GGG" }}

将呈现：太阳，2007 年 4 月 1 日 AD

日期时间文件

呈现日期和时间的字符串表示形式。

• 输入： datetime.datetime或浮点/整数时间戳

• 参数：格式名称或模式（可选）

例子：

{{ book.pubdate|datetimefmt:"short" }}

将呈现：4/1/07 3:30 PM和

{{ book.pubdate|datetimefmt:"E, MMM dd yyyy GGG' - 'HH:mm:ss'" }}

将呈现：太阳，2007 年 4 月 1 日 AD - 15:30:00

时限

呈现时间的字符串表示形式。

• 输入： datetime.datetime、datetime.time或浮点/整数时间戳

• 参数：格式名称或模式（可选）

例子：

{{ book.pubdate|timefmt:"short" }}

将呈现：3:30 PM和

{{ book.pubdate|timefmt:"h 'o''clock' a'" }}

将呈现：下午 3 点

十进制

呈现十进制数的字符串表示形式。

• 输入：一个Decimal对象，或一个 float/int/long 值

• 参数：格式名称或模式（可选）

例子：

{{ book.pagecount|decimalfmt }}

将呈现：1,234和

{{ book.pagecount|decimalfmt:"#,##0.00" }}

将呈现：1,234.00

货币fmt

呈现格式化为货币值的数字。

• 输入：一个Decimal对象，或一个 float/int/long 值

• 参数：货币代码

例子：

{{ book.price|currencyfmt:"USD" }}

将呈现：49.90 美元

百分比

将数字的字符串表示形式呈现为百分比。

• 输入：一个Decimal对象，或一个 float/int/long 值

• 参数：格式名称或模式（可选）

例子：

假设book.rebate将返回0.15，

{{ book.rebate|percentfmt }}

将呈现15%，并且

{{ book.rebate|percentfmt:"#,##0.00%" }}

将呈现15.00%。

科学术语

使用科学计数法呈现数字的字符串表示形式。

• 输入：一个Decimal对象，或一个 float/int/long 值

• 参数：无

例子：

假设book.numsold将返回 1.000.000，

{{ book.numsold|scientificfmt }}

将呈现10E5。