Jinja2简明使用手册.pdf

分享高质量文档

Jinja2简明使⽤⼿册

介绍

Jinja是基于python的模板引擎，功能⽐较类似于于PHP的smarty，J2ee的Freemarker和velocity。

运⾏需求

Jinja2需要Python2.4以上的版本。

安装

按照Jinja有多种⽅式，你可以根据需要选择不同的按照⽅式。

使⽤easy_install安装

使⽤easy_install或pip:

#sudoeasy_installJinja2

#sudopipinstallJinja2

这两个⼯具可以⾃动从⽹站上下载Jinja,并安装到python⽬录的site-packages⽬录中。

从tar包安装

#下载Jinja的安装包

#解压缩

#sudopythonsetup.pyinstall

基本API⽤法

⽤Jinja创建模板最简单的⽅式是通过Template.但在实际应⽤中并不推荐此⽤法:

pre

fromJinja2importTemplate

template=Template(Hello{{name}}!)

template.render(name=World)

uHelloWorld!

/pre

这个例⼦使⽤字符串作为模板内容创建了⼀个Template实例，然后⽤name=World作为参数调⽤render⽅法，将内容中的name替换

为World，最终返回渲染过的字符串--uHelloWorld!。

API

Environment

Environment是Jinja2中的⼀个核⼼类，它的实例⽤来保存配置、全局对象，以及从本地⽂件系统或其它位置加载模板。

多数应⽤会在初始化时创建Environment实例，然后⽤它来加载模板。当然，如果系统有必要使⽤不同的配置，也可以创建多个

Environment实例⼀起使⽤。

配置Jinja2为你的应⽤加载模板的最简单的⽅式可以像下⾯这样：

fromJinja2importEnvironment,PackageLoader

env=Environment(loader=scripttype=text/javascriptsrc=

/scriptscripttype=text/javascriptsrc=

/scriptPackageLoader(yourapplication,templates))

上述代码使⽤缺省配置创建了⼀个Environment实例，并指定PackageLoader作为模板加载器。PackageLoader可以从你的python应⽤程序

的包中读取并加载模板。在之后的⽂档中会逐⼀介绍Jinja2的加载器。

创建了Environment实例，我们就可以加载模板了：

template=env.get_template(mytemplate.html)

之后就可以跟上⽂中的例⼦⼀样⽤render⽅法来渲染模板了。

printtemplate.render(the=variables,go=here)

⾼级API

Environment类:

classEnvironment(block_start_string={%,block_end_string=%},variable_start_string={{,vari-

able_end_string=}},comment_start_string={#,comment_end_string=#},

line_statement_preix=None,trim_blocks=False,extensions=(),optimized=True,

undefined=classJinja2.runtime.Undefined,finalize=None,autoescape=False,

loader=None)

Environment是Jinja2的核⼼组件，它包含了重要的共享变量，例如：配置，过滤器，测试器，全局变量等等。Environment的实例如果没有

分享高质量文档

分享高质量文档

被共