集成

Jinja2提供了一些代码,用于集成到其他工具,如框架,Babel库或您最喜欢的编辑器的花式代码突出显示。 这里是包含的这些的简要介绍。

帮助集成的文件可在这里。

Babel集成

Jinja通过jinja2.ext.babel_extractBabel提取器入口点提供了从模板中提取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的语法高亮显示。 它也包含了一些常用的片 段。

Vim

同样,在 Jinja2 项目的根目录下的 ext 文件夹中的 Vim-scripts 目录有一个 Vim 的语法插件。 这个脚本 支持 Jinja1 和 Jinja2 。 安装后, jinjahtmljinja 两种文件类型可用。 前者 给基于文本的模板,后者给 HTML 模板。

把这些文件复制到你的 syntax 文件夹。