模板(Template)¶
Uliweb目前内置的模板系统采用web2py的，所以语法与web2py的模板系统完全一样。在原基础上进 行了必要的修改。
特点¶
- 简单，易学
- 可以嵌入Python代码
- 不用过分关心Python代码的缩近，只要注意块结束时加pass，模板会自动对缩近进行重排
- Python代码与HTML可以交叉使用
- 支持模板的继承
- 支持类django的block的功能(此功能由Uliweb扩展)
- 提供一些方便的内置方法
- 支持环境的扩展(可以扩展可以直接在模板中使用的对象和方法)
- 先编译成Python代码，然后再执行
基本语法¶
Uliweb的模板的语法很简单，只有四种类型的标记：
{{= result}}这是用来输出的标记。其中result可以是变量也可以是一个函数调用，它会自动 对输出的内容进行转义{{<< result}}这是用来输出非转义的内容，与上面相反。{{ }}只使用{{}}的话表示里面为Python代码，可以是任何的Python代码，如：import之类的。 如果是块语句，需要在块结束时使用pass。{{extend template}}其中template可以是字符串，如"layout.html"或变量。它表示从 父模板继承。{{include template}}包括其它的模板。如果template省略，表示是子模板插入的位置。一个 父模板只能定义一个插入点。{{block blockname}}{{end}}用于定义一个块。在子模板中，对于要覆盖的block需要进行定义， 则生成的结果将用子模板中的block定义替换父模板的。
模板环境¶
Uliweb的模板在运行时也象view一样会运行在一个环境中，在这个环境中，有一些对象和方法是在内置环境中定义的，也有一些是在Uliweb的框架环境中定义的对象或方法。内置的环境你无法扩展，但是框架环境允许你扩展，方法很象view的扩展方式，如在任何一个有效的app的settings.py中可以定义:
from uliweb.core.dispatch import bind
@bind('prepare_view_env')
def prepare_template_env(sender, env):
from uliweb.utils.textconvert import text2html
env['text2html'] = text2html
经过上面的处理，你就可以直接在模板中使用text2html这个方法了。
目前已经有一些缺省的对象和方法可以直接用在模板中，它们目前与view是一样的，因此你可以参考 视图 文档进行了解。
out 对象¶
out 对象是模板中内置的用来输出文本的对象。你可以在模板中直接使用它，但一般是不需要的。它有以下的方法：
- write(text, escape=True) 输出文本。escape表示是否要进行转义。
- noescape(text) 输出不转义的文本。
编码¶
模板缺省是使用utf-8编码进行处理。如果你传入unicode字符串，将自动转为utf-8编码。如果不 是unicode，则不做处理。建议全部使用utf-8编码。
基本用法¶
- 简单地变量输出
{{= "hello"}}
{{= title}}
如果使用了变量，则要么由view进行传入，要么在模板的其它地方进行定义，如：
{{title="hello"}}
{{= title}}
- HTML代码直接输出
{{<< html}}
- Python代码示例
{{import os
out.write("<h1>Hello</h1>")
}}
- 模板继承
父模板 (layout.html)
<html>
<head>
<title>Title</title>
</head>
<body>
{{block main}}{{end}}
</body>
</html>
子模板 (index.html)
{{extend "layout.html"}}
{{block main}}
<p>This is child template.</p>
{{end}}
同时 extend 支持后面的模板文件名是一个变量，如:
{{extend layout}}
这样，你可以在渲染模板时，传入一个layout的变量。
另外，在复杂的情况下，可以是多级的模板继承关系，如:
/ extend C1
A extend B - extend C2
\ extend C3
也就是说，C1, C2, C3作为父模板，可能有一些相同的block的定义可以扩展，如果它们可重定义的block一样，并且在你的应用中希望统一进行预处理，然后其它的模板再使用这个预处理后的模板。那么可以采用一个新的方法，首先B模板定义为:
{{extend layout}}
即，它要继承的模板名是一个变量。然后在A中根据需要传入layout的值，如:
{{extend "B", layout="C1"}}
这样，在扩展B模板时，动态传入了layout变量的值，因此B中的layout将使用C1模板。
下面的include也有类似的功能 。
- 包括其它的模板
<html>
<head>
<title>Title</title>
</head>
<body>
{{include "child.html"}}
</body>
</html>
uliweb.contrib.template App¶
Uliweb为了方便使用，同时还提供了 uliweb.contrib.template 这个app，具体的功能描述见 uliweb.contrib.template 。