作为一位深谙AnQiCMS模板机制的网站运营人员，我深知模板语言是网站内容高效呈现和管理的基石。在AnQiCMS中，模板系统采用了类似Django模板引擎的语法，其核心在于两种主要的语法结构：用于输出变量的双花括号 {{ ... }} 和用于控制逻辑及执行特定操作的单花括号百分号 {% ... %}。理解并熟练运用这两种结构，是构建高效、动态网站模板的关键。
双花括号 {{ ... }}：数据的呈现之道
在AnQiCMS模板中，双花括号 {{ ... }} 的主要作用是输出变量的值。当你在模板中需要显示动态数据，例如文章标题、分类名称、网站设置信息或者数据库中存储的任何字段时，都会用到这种语法。系统会将花括号内的变量解析为其对应的数据值，并将其直接呈现在网页上。
变量的命名通常遵循驼峰命名法则，例如 {{archive.Title}} 用于显示文章的标题，{{system.SiteName}} 用于显示网站名称。这些变量可以是简单的数据类型，如字符串、数字，也可以是包含多个属性的对象。当变量是一个对象时，你可以通过点操作符（.）来访问其内部属性，例如 {{item.Id}} 会输出循环中当前项的ID。
除了直接输出变量，双花括号还承载了其他一些重要的功能。例如，AnQiCMS内置了 stampToDate 这样的函数，用于格式化时间戳。它的调用形式也使用双花括号，如 {{stampToDate(item.CreatedTime, "2006-01-02")}}，这使得数据处理逻辑能够直接融入到输出语句中。此外，过滤器（filters）也是通过管道符（|）与双花括号内的变量结合使用的，例如 {{obj|filter__name:param}}，它允许你在输出变量之前对其进行进一步的处理或格式化，如截断字符串、大小写转换等。
单花括号百分号 {% ... %}：逻辑与操作的控制中心
与专注于数据呈现的双花括号不同，单花括号百分号 {% ... %} 则用于定义模板中的逻辑结构、执行控制流操作或调用特定的功能标签。这些标签不直接输出内容，而是控制模板的渲染过程，或者获取并组织数据以供双花括号输出。
单花括号百分号标签通常需要成对出现，拥有开始标签和结束标签，例如条件判断的 {% if ... %}{% endif %} 或循环遍历的 {% for ... %}{% endfor %}。这种结构确保了逻辑块的完整性和清晰性。AnQiCMS提供了丰富的内置标签，涵盖了网站运营的各种需求：
- 控制流标签：
{% if condition %}用于条件判断，{% for item in list %}用于遍历数组或列表，{% with ... %}{% endwith %}和{% set ... %}用于在模板中定义和赋值变量，以在局部范围内使用。 - 功能性标签：这些标签用于从AnQiCMS系统中获取特定类型的数据或执行特定操作。例如，
{% archiveList archives with type="page" %}{% endarchiveList %}用于获取并组织文章列表数据；{% categoryDetail with name="Title" id="1" %}用于获取指定分类的详细信息；{% include "partial/header.html" %}用于引入其他模板文件，实现模板的模块化；{% extends 'base.html' %}则用于模板继承，构建可复用的页面骨架。
通过这些标签，模板开发者可以灵活地控制页面内容的显示条件、数据迭代方式以及页面布局的组织结构，从而构建出高度动态和可维护的网站页面。
变量与标签的协同工作
在AnQiCMS模板的实际开发中，双花括号 {{ ... }} 和单花括号百分号 {% ... %} 并非独立存在，而是紧密协作，共同完成页面内容的渲染。{% ... %} 标签负责从后台获取数据、定义循环和条件、引入文件等“幕后”工作，而 {{ ... }} 则将这些由标签处理或组织好的数据“搬到”前台，直观地呈现在用户眼前。
例如，一个典型的文章列表页面会首先使用 {% archiveList %} 标签来获取文章数据，然后通过 {% for %} 标签遍历这些数据，并在循环内部使用 {{ item.Title }}、{{ item.Link }} 等双花括号来输出每篇文章的标题和链接。这种分工明确的协作方式，使得AnQiCMS模板既强大又易于理解和维护，能够有效支撑网站的内容创作、发布和优化需求。
常见问题 (FAQ)
1. 为什么我使用 {{ myVariable }} 输出的变量内容是空的？
有几种可能的原因。首先，请检查 myVariable 的拼写是否正确，包括大小写，因为AnQiCMS模板变量名通常是区分大小写的。其次，确认该变量在被调用之前是否已经正确地定义或从后台数据中获取。例如，如果你在一个非文章详情页尝试输出 {{archive.Title}}，而当前页面上下文没有 archive 对象，那么它将是空的。最后，某些变量可能需要特定的标签来获取，比如 {% archiveList %} 这样的标签会创建一个 archives 列表，然后你才能在其中遍历 item 并访问 {{item.Title}}。
2. {{ stampToDate(...) }} 和 {% system with name="SiteName" %} 都用于输出，它们有什么区别？
尽管两者都能在模板中生成输出，但它们的工作机制和用途有所不同。{{ stampToDate(...) }} 是一个内置函数调用。它接收参数（如时间戳和格式字符串），执行内部的逻辑计算，然后将计算结果直接作为变量值输出。它的核心是执行一个函数并返回结果。而 {% system with name="SiteName" %} 是一个功能性标签。它的主要作用是控制或从系统中获取特定类型的数据。在这个例子中，system 标签用于获取网站系统设置，with name="SiteName" 则是该标签的一个参数，指示它获取名为 “SiteName” 的系统设置项。当标签执行完毕后，它会“提供”一个值供输出，如果你没有指定变量名，它会直接输出，或者你可以指定一个变量来接收它提供的值。简而言之，前者是执行一个函数然后输出结果，后者是调用一个标签来获取或处理数据，然后输出该数据。
3. {% with ... %}{% endwith %} 和 {% set ... %} 都能在模板中定义变量，我应该使用哪一个？
这两种标签都用于在模板中创建或赋值变量，但它们在作用域和语法上略有不同。
{% with ... %}{% endwith %}标签定义了一个变量块，其内部定义的变量只在该with块内部有效。它通常用于为include标签传递局部变量，或者在一段特定的模板代码中临时定义一些变量。{% set new_var = "value" %}标签则可以在当前模板的任何位置定义变量，且其作用域通常是从定义点到模板文件的末尾。
在选择使用时，如果你的变量只需要在一个较小的、有明确边界的代码块中使用，或者你需要将变量传递给 include 模板，{% with %} 是更合适的选择。如果你的变量需要在当前模板的多个地方使用，且作用域更广，那么 {% set %} 会更方便。