AnQiCMS作为一个基于Go语言开发的高效内容管理系统，其模板系统采用了类似Django的模板引擎语法，这对于熟悉Web开发的朋友来说，无疑是一个快速上手和实现强大内容展示逻辑的优势。它使得我们可以在不编写复杂后端代码的情况下，直接在模板层面灵活地控制内容的呈现方式。
要理解如何在AnQiCMS模板中使用这种GoLang实现的Django模板引擎语法来控制内容显示逻辑，我们可以将其拆解为几个核心部分：变量的显示、逻辑判断、数据遍历、代码复用以及数据的格式化和处理。
变量的显示：内容的直接呈现
最基础的模板操作就是显示数据。在AnQiCMS模板中，我们使用双花括号{{ 变量名 }}来输出变量的值。这些变量通常是从后端传递到模板的数据，例如文章标题、分类名称、系统配置等。
例如，如果我们想显示当前页面的文章标题，可以这样写：
<h1>{{ archive.Title }}</h1>
这里的archive.Title就是后端传递过来的文章对象中的标题属性。这种直观的语法让我们可以轻松地将数据嵌入到HTML结构中。
控制流：实现逻辑判断
网站内容的显示往往需要根据特定条件进行判断。比如，只有当文章有缩略图时才显示图片，或者根据用户的登录状态显示不同的内容。AnQiCMS模板提供了if、elif（else if）和else标签来处理这类逻辑。
基本结构如下：
{% if 条件 %}
<!-- 条件为真时显示的内容 -->
{% elif 其他条件 %}
<!-- 第一个条件为假，此条件为真时显示的内容 -->
{% else %}
<!-- 所有条件都为假时显示的内容 -->
{% endif %}
例如，我们想在文章详情页判断是否有缩略图并显示：
{% if archive.Thumb %}
<img src="{{ archive.Thumb }}" alt="{{ archive.Title }}">
{% else %}
<p>暂无缩略图</p>
{% endif %}
这种结构使得我们可以根据数据的存在与否、数值大小、布尔状态等进行灵活的判断，从而呈现差异化的内容。
遍历数据：展示列表内容
网站上大量的列表内容，如文章列表、产品列表、导航菜单等，都需要模板系统能够遍历数据集合。AnQiCMS模板使用for循环标签来处理这类需求。
for循环的基本语法是{% for item in 集合 %} ... {% endfor %}。在循环内部，item变量会依次代表集合中的每一个元素，我们可以通过item.属性来访问其数据。
一个常见的应用场景是展示最新文章列表：
{% archiveList articles with type="list" limit="5" %}
<ul>
{% for article in articles %}
<li><a href="{{ article.Link }}">{{ article.Title }}</a></li>
{% empty %}
<li>暂无文章</li>
{% endfor %}
</ul>
{% endarchiveList %}
这里，{% archiveList ... %}是AnQiCMS提供的用于获取文章列表的专用标签。{% empty %}标签在for循环的数据集合为空时执行，非常适合处理无数据时的用户提示。此外，for循环还提供了forloop.Counter（当前循环次数）和forloop.Revcounter（剩余循环次数）等变量，方便我们进行更精细的控制，比如给第一篇文章添加特殊样式。
模板复用：提高开发效率
在构建网站时，很多页面元素是通用的，例如页眉、页脚、侧边栏等。AnQiCMS模板提供了include和extends两种机制来实现模板的复用，极大地提高了开发效率和后期维护的便捷性。
include标签： 用于将一个模板文件嵌入到另一个模板文件中。这适用于页面中的可重用组件，如头部导航、侧边栏广告、版权信息等。 例如，在主模板文件中引入页眉和页脚：{% include "partial/header.html" %} <div class="main-content"> <!-- 页面主体内容 --> </div> {% include "partial/footer.html" %}include还可以通过with传递额外变量，并使用only限制变量范围，增加灵活性。extends标签： 用于实现模板的继承。我们可以定义一个基础布局（base.html），包含网站的整体结构、公共样式和脚本，并用block标签定义可被子模板重写（覆盖）的区域。 例如，在base.html中定义一个内容块：<!DOCTYPE html> <html lang="zh-CN"> <head> <title>{% block title %}默认标题{% endblock %}</title> <!-- 其他公共head内容 --> </head> <body> <header><!-- 页眉内容 --></header> <main>{% block content %}{% endblock %}</main> <footer><!-- 页脚内容 --></footer> </body> </html>子模板只需声明
{% extends "base.html" %}，然后通过{% block block_name %}重写对应的区域即可：{% extends "base.html" %} {% block title %}我的文章 - AnQiCMS{% endblock %} {% block content %} <h1>欢迎阅读我的文章</h1> <!-- 具体文章内容 --> {% endblock %}这种方式确保了网站整体风格的一致性，同时允许各个页面拥有自己独特的内容。
过滤器：格式化和处理数据
过滤器是模板语言中处理变量输出的重要工具。它们允许我们在显示数据之前对其进行修改、格式化或转换。过滤器使用管道符号|连接到变量之后，可以链式使用多个过滤器。
例如，{{ 变量名|过滤器名称:参数 }}。
一些常用过滤器包括：
safe： 用于输出未经转义的HTML内容。在显示文章正文（通常包含HTML格式）时非常关键，防止HTML标签被当做纯文本显示。<div>{{ archive.Content|safe }}</div>stampToDate： 将时间戳转换为可读的日期格式。这是AnQiCMS特有的一个实用功能，因为它直接处理时间戳。<span>发布日期：{{ stampToDate(archive.CreatedTime, "2006-01-02 15:04") }}</span>这里的"2006-01-02 15:04"是Go语言特有的日期时间格式化参考值。truncatechars:N： 将字符串截断为N个字符长度，并在末尾添加省略号。常用于显示文章摘要。{{ article.Description|truncatechars:100 }}add： 对数字或字符串进行加法操作或拼接。{{ item.Views|add:" 次浏览" }}lower/upper： 将字符串转换为小写/大写。
过滤器极大地增强了模板处理数据的能力，使得前端展示更加灵活和精确。
AnQiCMS专用标签：深度集成内容数据
除了GoLang实现的Django模板引擎通用语法外，AnQiCMS还提供了许多专用的内容标签，这些标签是与CMS后端数据紧密结合的，用于直接获取各种类型的内容数据，进一步简化了模板开发。
archiveList/archiveDetail： 用于获取文章列表或单篇文章的详情。可以根据分类ID、模块ID、推荐属性、排序方式等多种条件进行筛选。{% archiveList latestArticles with categoryId="1" limit="10" order="CreatedTime desc" %}categoryList/categoryDetail： 用于获取分类列表或单个分类的详情，同样支持按模块ID和父级ID进行筛选。{% categoryList subCategories with parentId=currentCategory.Id %}pageList/pageDetail： 用于获取单页面列表或单页面详情。navList： 用于获取网站导航菜单。system/contact/tdk： 用于获取系统配置、联系方式和页面的SEO（TDK）信息。
这些内置标签使得我们无需深入了解数据库结构，只需通过简单的参数配置，就能在模板中调用所需的数据，极大提升了内容运营的效率。
总结来说，AnQiCMS模板系统通过GoLang实现的Django模板引擎语法，为我们网站运营者提供了强大而灵活的内容显示逻辑控制能力。从基本的变量输出，到复杂的条件判断和数据循环，再到高效的代码复用机制，以及实用的数据格式化过滤器和与CMS深度整合的专用标签，都使得前端内容的呈现