扩展

Jinja2 支持扩展来添加过滤器、测试、全局变量或者甚至是处理器。扩展的主要动力是把诸如添加国际化支持的常用代码迁移到一个可重用的类。

添加扩展

扩展在 Jinja2 环境创建时被添加。一旦环境被创建，就不能添加额外的扩展。要添加一个扩展，传递一个扩展类或导入路径的列表到 Environment 构造函数的 environment 参数。下面的例子创建了一个加载了 i18n 扩展的 Jinja2 环境:

jinja_env = Environment(extensions=['jinja2.ext.i18n'])

Import name: jinja2.ext.i18n

Jinja2 当前只附带一个扩展，就是 i18n 扩展。它可以与 gettext 或 babel 联合使用。如果启用了 i18n 扩展， Jinja2 提供了 trans 语句来标记被其包裹的字符串为可翻译的，并调用 gettext 。

在启用虚拟的 _ 函数后，之后的 gettext 调用会被添加到环境的全局变量。那么一个国际化的应用应该不仅在全局，以及在每次渲染中在命名空间中提供至少一个 gettext 或可选的 ngettext 函数。

在启用这个扩展后，环境提供下面的额外方法:

jinja2.Environment.install_gettext_translations(translations, newstyle=False): 在该环境中全局安装翻译。提供的翻译对象要至少实现 uggettext 和 ungettext 。 gettext.NullTranslations 和 gettext.GNUTranslations 类和 Babel‘s 的 Translations 类也被支持。
Changed in version 2.5: 添加了新样式的 gettext

jinja2.Environment.install_null_translations(newstyle=False): 安装虚拟的 gettext 函数。这在你想使应用为国际化做准备但还不想实现完整的国际化系统时很有用。
Changed in version 2.5: 添加了新样式的 gettext

jinja2.Environment.install_gettext_callables(gettext, ngettext, newstyle=False)

在环境中把给出的 gettext 和 ngettext 可调用量安装为全局变量。它们应该表现得几乎与标准库中的 gettext.ugettext() 和 gettext.ungettext() 函数相同。

如果激活了新样式，可调用量被包装为新样式的可调用量一样工作。更多信息见新样式 Gettext 。

New in version 2.5.

jinja2.Environment.extract_translations(source)

从给定的模板或源中提取本地化字符串。

对找到的每一个字符串，这个函数生产一个 (lineno, function, message ) 元组，在这里:

如果安装了 Babel ， Babel 集成可以用来为 babel 抽取字符串。

对于一个对多种语言可用而对所有用户给出同一种的语言的 web 应用（例如一个法国社区安全了一个多种语言的论坛软件）可能会一次性加载翻译并且在环境生成时把翻译方法添加到环境上:

translations = get_gettext_translations()
env = Environment(extensions=['jinja2.ext.i18n'])
env.install_gettext_translations(translations)

get_get_translations 函数会返回当前配置的翻译器。（比如使用 gettext.find ）

模板设计者的 i18n 扩展使用在模板文档中有描述。

Jinja2中文手册

		自动登录	找回密码
密码			立即注册