基础

Jinja2 使用一个名为 Environment 的中心对象。这个类的实例用于存储配置、全局对象,并用于从文件系统或其它位置加载模板。即使你通过:class:Template类的构造函数用字符串创建模板,也会为你自动创建一个环境,尽管是共享的。

大多数应用在应用初始化时创建一个 Environment 对象,并用它加载模板。在某些情况下,如果使用多份配置,使用并列的多个环境无论如何是有用的。

配置 Jinja2 为你的应用加载文档的最简单方式看起来大概是这样:

  1. from jinja2 import Environment, PackageLoader
  2. env = Environment(loader=PackageLoader('yourapplication', 'templates'))

这会创建一个默认设定下的模板环境和一个在 yourapplication python 包中的templates 文件夹中寻找模板的加载器。多个加载器是可用的,如果你需要从数据库或其它资源加载模板,你也可以自己写一个。

你只需要调用 get_template() 方法从这个环境中加载模板,并会返回已加载的Template:

  1. template = env.get_template('mytemplate.html')

用若干变量来渲染它,调用 render() 方法:

  1. print template.render(the='variables', go='here')

使用一个模板加载器,而不是向 TemplateEnvironment.from_string() 传递字符串,有许多好处。除了使用上便利,也使得模板继承成为可能。