web.py模版系统
介绍：
调用的web.py模版语言Templetor旨在将python的强大功能带入模版。它不是为模板创建新语法，而是重用python语法。
Templetor故意限制模版中的变量访问。用户可以访问传递给模版的变量和一些内置的python函数，这允许不受信任的用户编写模版，而不用担心他们会对正在运行的系统造成损害，当然，可以增加可用的全局变量。
简单的模版：
$def with (name) Hello $name!
第一行表示定义了一个名为name的参数，$name在渲染模版时，第二行中的名称将替换为name的值。
使用模版系统：
渲染模版的常用方法是：
render = web.template.render('templates') return render.hello('world')
该render函数将模版root作为参数。使用给定的参数render.hello(..)调用模版hello.html。实际上，它会hello.* 在模版根目录中查找匹配的文件并选择第一个匹配文件。
也可以使用文件从文件创建模版render.
hello = web.template.frender('templates/hello.html') print hello('world')
如果将模版作为字符串：
template = "$def with (name)\nHello $name" hello = web.template.Template(template) print hello('world')
表达替换：
特殊字符$用于指定python表达式。表达式可以包含在显示分组中()或{}用于显示分组。
Look, a $string. Hark, an ${arbitrary + expression}. Gawk, a $dictionary[key].function('argument'). Cool, a $(limit)ing.
分配：
定义变量并重新分配一些变量。
$ bug = get_bug(id) <h1>$bug.title</h1> <div> $bug.description <div>
注意$分配后的空格，需要区分赋值和表达式替换。、、
过滤：
默认情况下，Templetor使用web.websafe过滤器进行HTML编码。
>>> render.hello("1 < 2") "Hello 1 < 2"
要使用：后关闭过滤器$:
The following will not be html escaped. $:form.render()
换行抑制：
可以通过 \ 在行尾添加字符来抑制换行符。
If you put a backslash \
at the end of a line \
(like these) \
then there will be no newline.
使用$$得到$的输出。
Can you lend me $$50?
$#用作评论指标，任何一$#开头直至行尾的内容都会被忽略。
控制结构：
模版系统支持for, while, if, elif 和 else，和在python中一样，语句的主题是缩进的。
$for i in range(10): I like $i $for i in range(10): I like $i $while a: hello $a.pop() $if times > max: Stop! In the name of love. $else: Keep on, you can do it.
for 循环中可用的许多变量：
loop.index: the iteration of the loop (1-indexed) loop.index0: the iteration of the loop (0-indexed) loop.first: True if first iteration loop.last: True if last iteration loop.odd: True if an odd iteration loop.even: True if an even iteration loop.parity: "odd" or "even" depending on which is true loop.parent: the loop above this in nested loops
<table> $for c in ["a", "b", "c", "d"]: <tr class="$loop.parity"> <td>$loop.index</td> <td>$c</td> </tr> </table>
定义新的模版函数$def .支持关键字参数。
$def say_hello(name='world'): Hello $name! $say_hello('web.py') $say_hello()
例子：
$def tr(values): <tr> $for v in values: <td>$v</td> </tr> $def table(rows): <table> $for row in rows: $:row </table> $ data = [['a', 'b', 'c'], [1, 2, 3], [2, 4, 6], [3, 6, 9] ] $:table([tr(d) for d in data])
可以使用code块写入任意python代码。
$code: x = "you can write any python code here" y = x.title() z = len(x + y) def limit(s, width=10): """limits a string to the given width""" if len(s) >= width: return s[:width] + "..." else: return s And we are back to template. The variables defined in the code block can be used here. For example, $limit(x)
VAR:
该var块，可用于在模版结果中定义其他属性。
$def with (title, body) $var title: $title $var content_type: text/html <div id="body"> $body </div>
上述模版的结果可以使用如下：
out = render.page('hello', 'hello world') out.title u'hello' out.content_type u'text/html' str(out) '\n\n<div>\nhello world\n</div>\n'
内置和全局：
就像任何python函数一样，模版也可以访问内置函数及其参数和局部变量。像一些常见的内置函数，range， min，max等，以及布尔值True和False被提供给所有的模版，除了内置函数之外，还可以指定特定于应用程序的全局变量，以使他们可以在所有的模版中访问。
可以将Globals指定为参数web.template.render.
import web import markdown globals = {'markdown': markdown.markdown} render = web.template.render('templates', globals=globals)
也可以控制在模版中公开的内置组件。
# disable all builtins render = web.template.render('templates', builtins={})
安全：
Templetor的设计目标之一是允许不受信任的用户编写模版。
要是模版执行安全，模版中不允许以下内容：
- 不安全之类的语句import , exec 等等
- 访问以 。开头的属性_
- 不安全内建想open，getattr，setattr等等。
SecurityException 如果您的模板使用其中任何一个，则会引发
从web.py 0.2模版升级：
新实现大多与早期实现兼容。但是，由于以下原因，某些情况可能无效。
- 模板输出始终像
TemplateResult对象一样存储，但是将其转换为unicode或者str将结果作为unicode / string。 -
重新分配全球价值将无效。如果x是全局的，则以下内容不起作用。
$ x = x + 1
以下仍然受支持，但不是首选。
- 使用
\$转义美元。请$$改用。 - 修改
web.template.Template.globals。将全局变量web.template.render作为参数传递。
