Jinja 提供了用 [Babel](http://babel.edgewall.org/) 抽取器从模板中抽取 gettext 消息的支持,抽取器的接入点 名为jinja2.ext.babel_extract 。 Babel 支持的被作为 [*i18n 扩展*](http://docs.jinkan.org/docs/jinja2/extensions.html#i18n-extension) 的 一部分实现。
Gettext 消息从 trans 标签和代码表达式中抽取。
要从模板中抽取 gettext 消息,项目需要在它的 Babel 抽取方法 [mapping file](http://babel.edgewall.org/wiki/Documentation/messages.html#extraction-method-mapping-and-configuration) 中 有一个 Jinja2 节:
~~~
[jinja2: **/templates/**.html]
encoding = utf-8
~~~
Environment 的语法相关选项也可作为 mapping file 的配置值。例如告知 抽取器模板使用 %作为 line_statement_prefix 你可以这样写:
~~~
[jinja2: **/templates/**.html]
encoding = utf-8
line_statement_prefix = %
~~~
[*扩展*](http://docs.jinkan.org/docs/jinja2/extensions.html#jinja-extensions) 可能也被定义为传递一个逗号分割的导入路径列表作为 extensions 值。 i18n 扩展会被自动添加。
Changed in version 2.7: 直到 2.7 模板语法错误始终被忽略。因为许多人在模板文件夹中放置非模板的 html 文件,而这会随机报错,所以如此设定。假定是无论如何测试套件会捕获 模板中的语法错误。如果你不想要这个行为,你可以在设置中添加 slient=flase ,异常会被传播。
- 介绍
- 预备知识
- 安装
- 基本 API 使用
- 实验性的 Python 3 支持
- API
- 基础
- Unicode
- 高层 API
- 自动转义
- 标识符的说明
- 未定义类型
- 上下文
- 加载器
- 字节码缓存
- 实用工具
- 异常
- 自定义过滤器
- 求值上下文
- 自定义测试
- 全局命名空间
- 低层 API
- 元 API
- 沙箱
- API
- 运算符拦截
- 模板设计者文档
- 概要
- 变量
- 过滤器
- 测试
- 注释
- 空白控制
- 转义
- 行语句
- 模板继承
- HTML 转义
- 控制结构清单
- 导入上下文行为
- 表达式
- 内置过滤器清单
- 内置测试清单
- 全局函数清单
- 扩展
- 自动转义扩展
- 扩展
- 添加扩展
- i18n 扩展
- 表达式语句
- 循环控制
- With 语句
- 自动转义扩展
- 编写扩展
- 集成
- Babel 集成
- Pylons
- TextMate
- Vim
- 从其它的模板引擎切换
- Jinja1
- Django
- Mako
- 提示和技巧
- Null-Master 退回
- 交替的行
- 高亮活动菜单项
- 访问父级循环