web.py项目模板系统Templetor深度解析-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00775/article/details/148488598

web.py项目模板系统Templetor深度解析

webpy web.py is a web framework for python that is as simple as it is powerful. 项目地址: https://gitcode.com/gh_mirrors/we/webpy

引言

在Python Web开发领域，模板系统是连接业务逻辑与展示层的重要桥梁。web.py框架内置的Templetor模板引擎以其简洁优雅的设计哲学脱颖而出。本文将全面剖析Templetor的核心特性、语法规则以及最佳实践，帮助开发者高效构建动态Web内容。

Templetor设计理念

Templetor的设计遵循以下核心原则：

语法优雅性：摒弃了传统模板系统中常见的丑陋分隔符（如<%#foo#%>），采用更自然的标记方式
Python友好：最大程度复用Python语法和语义，降低学习成本
计算能力：提供足够的表达能力支持复杂逻辑处理
通用性：不仅限于HTML/XML，可应用于任意文本格式
安全性：支持沙箱环境，允许非信任用户编写模板
高效性：实现简单且执行高效

基础语法详解

变量插值

Templetor使用$符号作为变量标识，支持多种插值方式：

简单变量: $username
表达式插值: ${user.first_name + ' ' + user.last_name}
字典访问: $config['site_name']
方法调用: $user.get_profile().avatar_url
限制字符: $(description)[:100]...
原义输出: \$price  # 输出$price而非变量值

换行控制

通过在行尾添加反斜杠实现行连接：

这是一行很长的\
内容，实际渲染时\
会合并为一行显示

流程控制

支持完整的Python控制结构，语法与Python高度一致：

$if score >= 90:
    优秀！
$elif score >= 60:
    及格
$else:
    不及格

$for item in items:
    - $item.name ($item.price)
    
$while condition:
    循环内容...

注意：

控制语句必须以$开头
代码块必须缩进4个空格
自动去除行首空白，保持输出整洁

注释语法

Templetor提供两种注释方式：

$# 这是单行注释

多行注释使用 $#
这种语法可以跨越多行 #$

高级特性

模板定义与参数

模板通过$def with声明参数：

$def with (name, age=18, title="")

注意事项：

参数间必须有空格分隔
支持默认参数
模板编译后成为可调用的Python函数

变量声明

使用$var定义模板级变量：

$var stylesheet: /static/css/main.css
$var footer: Copyright © 2023

原始输出

默认情况下内容会被HTML转义，使用$:可禁用转义：

$:html_content  # 直接输出原始HTML
$:json_data     # 输出原始JSON

模板组合

通过嵌套render调用实现模板组合：

# Python代码
render.layout(render.content(post))

# content.html
$def with (post)
<div class="content">$post.body</div>

# layout.html  
$def with (content)
<html>
  <body>$:content</body>
</html>