Jinja2简明手册.doc

介绍?Jinja是基于python的模板引擎，功能比较类似于于PHP的smarty，J2ee的Freemarker和velocity。?运行需求?Jinja2需要Python2.4以上的版本。?安装?按照Jinja有多种方式，你可以根据需要选择不同的按照方式。?使用easy_install安装?使用easy_install 或pip:?#sudo easy_install Jinja2?#sudo pip install Jinja2?这两个工具可以自动从网站上下载Jinja,并安装到python目录的site-packages目录中。?从tar包安装?# 下载Jinja的安装包?# 解压缩?# sudo python setup.py install?基本API用法?用Jinja创建模板最简单的方式是通过 Template. 但在实际应用中并不推荐此用法:??pre?? from Jinja2 import Template?? template = Template(Hello {{ name }}!)?? template.render(name=World)?? uHello World!?/pre?这个例子使用字符串作为模板内容创建了一个Template实例，然后用name=World作为参数调用render方法，将内容中的name替换为World，最终返回渲染过的字符串--uHello World!。?API?Environment?Environment是Jinja2中的一个核心类，它的实例用来保存配置、全局对象，以及从本地文件系统或其它位置加载模板。?多数应用会在初始化时创建Environment实例，然后用它来加载模板。当然，如果系统有必要使用不同的配置，也可以创建多个Environment实例一起使用。?配置Jinja2为你的应用加载模板的最简单的方式可以像下面这样：?? from Jinja2 import Environment, PackageLoader?? env = Environment(loader=script type=text/javascript src=/javascripts/tinymce/themes/advanced/langs/zh.js/scriptscript type=text/javascript src=/javascripts/tinymce/plugins/javaeye/langs/zh.js/scriptPackageLoader(yourapplication, templates))?上述代码使用缺省配置创建了一个Environment实例，并指定PackageLoader作为模板加载器。PackageLoader可以从你的python应用程序的包中读取并加载模板。在之后的文档中会逐一介绍Jinja2的加载器。?创建了Environment实例，我们就可以加载模板了：?? template = env.get_template(mytemplate.html)?之后就可以跟上文中的例子一样用render方法来渲染模板了。?? print template.render(the=variables, go=here)?高级API?Environment类:?? class Environment(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=class Jinja2.runtime.Undefined, finalize=None, autoescape=False,?? loader=None)?Environment是Jinja2的核心组件，它包含了重要的共享变量，例如：配置，过滤器，测试器，全局变量等等。Environment的实例如果没有被共享或者没有加载过模板则可以进行修改，如果在加载过模板之后修改Environment实例会遇到不可知的结果。?参数介绍：?loader 模板加载器.?block_start_string 块开始标记符，缺省是 {%.?block_end_string 块结束标记符，缺省是