API

基础

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

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

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

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

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

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

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

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

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

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