模板标签系统

墨迹语 CMS 使用自定义模板引擎，提供简洁易用的模板语法。本文档详细介绍模板标签系统的使用方法。

模板引擎特点

• 简洁直观 - 基本语法易学易用
• 安全可靠 - 默认转义防止 XSS
• 逻辑分离 - 模板与业务逻辑分开
• 性能优先 - 轻量级解析，无复杂依赖
• 功能完善 - 支持多级路径访问、复合逻辑运算、深度嵌套等工业级特性

核心功能

1. 变量输出

• {$var} - 转义输出（推荐用于文本）
• {!$var} - 不转义输出（用于 HTML 内容）
• {$a.b.c.d} - 支持无限层级的路径访问

2. 条件判断

• {if $condition}...{/if} - 基本条件
• {if $condition}...{else}...{/if} - 带 else 分支
• {if !$var} - 取反条件
• 支持复合逻辑：&& (与)、|| (或)
• 支持比较运算符：==、!=、<、>、<=、>=

3. 循环遍历

• {loop $array $item}...{/loop} - 基本循环
• 支持无限层级嵌套循环
• 支持循环内嵌套复杂的条件判断

5. 模板包含

• {include file="路径"} - 包含其他模板
• 继承当前数据上下文

使用场景

首页模板

用于网站首页，显示最新文章、热门内容等。详细标签请查看 首页标签。

列表页模板

用于栏目列表页，显示该栏目下的文章列表。详细标签请查看 列表页标签。

内容页模板

用于文章详情页，显示文章完整内容。详细标签请查看 内容页标签。

最佳实践

数据准备原则

• 将复杂的逻辑处理放在控制器中
• 模板仅负责展示
• 在控制器中预处理数据格式

安全性建议

• 默认使用转义变量 {$var}
• 仅在必要时使用不转义变量 {!$var}
• 在控制器中验证和清理数据

模板组织建议

• 使用包含文件复用公共部分
• 使用清晰的变量命名
• 分离静态样式和动态内容

相关文档

• 基础语法 - 详细的语法说明
• 首页标签 - 首页可用标签
• 列表页标签 - 列表页可用标签
• 内容页标签 - 内容页可用标签