集成

Jinja2 提供了一些代码来继承到其它工具,诸如框架、 Babel 库或你偏好的编辑器 的奇特的代码高亮。这里是包含的这些的简要介绍。

帮助继承的文件在 这里 可 用。

Babel 集成

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

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

要从模板中抽取 gettext 消息,项目需要在它的 Babel 抽取方法 mapping file 中 有一个 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

在 Jinja2 项目根目录的 ext 文件夹中,有一个 TextMate 的 bundle 来提供 Jinja1 和 Jinja2 的基于文本的模板的语法高亮,同样也支持 HTML 。它也包含了一些常用的片 段。

Vim

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

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