集成¶
Jinja2提供了一些代码,用于集成到其他工具,如框架,Babel库或您最喜欢的编辑器的花式代码突出显示。 这里是包含的这些的简要介绍。
帮助集成的文件可在这里。
Babel集成¶
Jinja通过jinja2.ext.babel_extract的Babel提取器入口点提供了从模板中提取gettext消息的支持。 Babel 支持的被作为 i18n 扩展 的 一部分实现。
Gettext 消息从 trans 标签和代码表达式中抽取。
要从模板中提取gettext消息,项目在其Babel提取方法映射文件中需要一个Jinja2部分:
[jinja2: **/templates/**.html]
encoding = utf-8
Environment
的语法相关选项也可作为 mapping file 的配置值。 例如告知 抽取器模板使用 %
作为 line_statement_prefix 你可以这样写:
[jinja2: **/templates/**.html]
encoding = utf-8
line_statement_prefix = %
Extensions也可以通过将逗号分隔的导入路径列表作为扩展值来定义。 i18n 扩展会被自动添加。
Changed in version 2.7: 直到 2.7 模板语法错误始终被忽略。 因为许多人在模板文件夹中放置非模板的 html 文件,而这会随机报错,所以如此设定。 假定是无论如何测试套件会捕获 模板中的语法错误。 如果你不想要这个行为,你可以在设置中添加 slient=flase
,异常会被传播。
Pylons ¶
从 Pylons 0.9.7 开始,集成 Jinja 到 Pylons 驱动的应用令人难以置信的简单。
模板引擎在 config/environment.py 中配置。 为 Jinja2 的配置看起来是这样:
from jinja2 import Environment, PackageLoader
config['pylons.app_globals'].jinja_env = Environment(
loader=PackageLoader('yourapplication', 'templates')
)
之后,你可以用 pylons.templating 模块中的 render_jinja 函数渲染 Jinja 模板。
此外,设置 Pylons 的 c 对象为严格模式是个好主意。 按照默认,访问任何 c 对象 上不存在的属性会返回一个空字符串而不是一个未定义对象。 更改这个,只需要使用这个 片段并添加到你的 config/environment.py 中:
config['pylons.strict_c'] = True
TextMate¶
对于TextMate有一个包,它支持基于文本的模板和HTML的Jinja1和Jinja2的语法高亮显示。 它也包含了一些常用的片 段。