基本 API 使用

本节简要介绍 Jinja2 模板的 Python API 。

最基本的方式就是通过 Template 创建一个模板并渲染它。如果你的模板不是从字符串加载，而是文件系统或别的数据源，无论如何这都不是推荐的方式:

>>> from jinja2 import Template
>>> template = Template('Hello {{ name }}!')
>>> template.render(name='John Doe')
u'Hello John Doe!'

通过创建一个 Template 的实例，你会得到一个新的模板对象，提供一个名为 render() 的方法，该方法在有字典或关键字参数时调用扩充模板。字典或关键字参数会被传递到模板，即模板“上下文”。

如你所见， Jinja2 内部使用 unicode 并且返回值也是 unicode 字符串。所以确保你的应用里也确实使用 unicode 。