Babel 集成

Jinja 提供了用 Babel 抽取器从模板中抽取 gettext 消息的支持,抽取器的接入点名为 jinja2.ext.babel_extract 。 Babel 支持的被作为 i18n 扩展 的一部分实现。

Gettext 消息从 trans 标签和代码表达式中抽取。

要从模板中抽取 gettext 消息,项目需要在它的 Babel 抽取方法 mapping file 中有一个 Jinja2 节:

  1. [jinja2: **/templates/**.html]
  2. encoding = utf-8

Environment 的语法相关选项也可作为 mapping file 的配置值。例如告知抽取器模板使用 % 作为 line_statement_prefix 你可以这样写:

  1. [jinja2: **/templates/**.html]
  2. encoding = utf-8
  3. line_statement_prefix = %

扩展 可能也被定义为传递一个逗号分割的导入路径列表作为extensions 值。 i18n 扩展会被自动添加。

Changed in version 2.7: 直到 2.7 模板语法错误始终被忽略。因为许多人在模板文件夹中放置非模板的html 文件,而这会随机报错,所以如此设定。假定是无论如何测试套件会捕获模板中的语法错误。如果你不想要这个行为,你可以在设置中添加slient=flase ,异常会被传播。