如何实现针对特定分类或页面的模板自定义，例如`page/about.html`？

作为一名资深的安企CMS网站运营人员，我深知内容呈现方式对于用户体验和搜索引擎优化（SEO）的重要性。AnQiCMS 提供了一套强大且灵活的模板定制机制，让我们可以根据不同内容类型或特定页面的需求，打造专属的视觉和功能布局。今天，我将详细为您解析如何在 AnQiCMS 中实现针对特定分类或页面的模板自定义，例如我们常遇到的 page/about.html 这样的需求。

AnQiCMS 模板自定义的价值

在内容运营中，并非所有页面都适用于统一的模板。例如，一个“关于我们”页面可能需要更简洁的布局和企业文化展示，而一个“产品详情”页面则需要突出产品图片、参数和购买信息。通过自定义模板，我们可以精准控制每个页面的结构、样式和数据调用，从而优化用户体验，提高页面转化率，并向搜索引擎传递更清晰的页面主题信息，有助于提升相关内容的排名。AnQiCMS 凭借其基于 Go 语言的高性能架构和 Django 模板引擎语法，为这种灵活定制提供了坚实基础。

了解 AnQiCMS 的模板文件结构

AnQiCMS 的所有模板文件都统一存放在 /template 目录下。每个主题（或称模板包）都会有自己的独立文件夹，例如 /template/default 或 /template/your_theme_name。在这些主题文件夹内部，我们可以根据不同的页面类型和功能，组织我们的 .html 模板文件。模板中用到的样式（CSS）、JavaScript 脚本和图片等静态资源，则存放在 /public/static/ 目录中，并通过 {% system with name="TemplateUrl" %} 标签来引用。

模板文件采用类似 Django 模板引擎的语法，变量使用双花括号 {{变量}}，条件判断和循环控制使用单花括号和百分号 {% 标签 %}，并且需要成对出现结束标签，例如 {% if ... %} ... {% endif %}。

实现模板自定义的核心机制

AnQiCMS 提供了两种主要方式来实现针对特定分类或页面的模板自定义：通过自动识别的命名约定和后台手动指定模板文件。

首先，系统本身就支持一些默认的自定义命名约定。只要您的模板文件符合这些约定，AnQiCMS 就会自动应用它们，无需额外的后台设置。例如：

  • 文档（文章/产品）详情页：{模型table}/{文档ID}.html。这意味着如果您有一个模型表名为 article，且某篇文章 ID 为 123，那么 article/123.html 将会是该文章的专属模板。
  • 文档列表页：{模型table}/list-{分类ID}.html。例如，article/list-45.html 可以作为 ID 为 45 的文章分类的列表模板。
  • 单页面详情页：page/{单页面ID}.html。如果您的“关于我们”单页面在 AnQiCMS 后台的 ID 或自定义 URL 别名为 about，那么 page/about.html 文件将会自动成为该页面的模板。

其次，对于那些不完全符合命名约定，或者您希望更精细控制的页面，AnQiCMS 允许您在后台管理界面中手动指定模板文件。这种方式提供了极大的灵活性，确保每个页面都能获得其独特的外观和功能。您可以在创建或编辑文档、分类或单页面时，在相应的“模板”字段中填入您自定义的模板文件名。例如，对于一个名为“下载中心”的分类，您可以在其编辑页面中指定使用 download_list.html 作为分类列表模板。

以 page/about.html 为例的实战指南

让我们以请求中的 page/about.html 为例，详细说明如何为“关于我们”单页面创建一个自定义模板。

第一步：规划模板文件路径

在您的 AnQiCMS 模板主题文件夹内（例如 /template/default/），创建一个名为 page 的子目录。然后，在该子目录中创建您的自定义模板文件，命名为 about.html。最终路径可能为 /template/default/page/about.html。请确保该文件的编码为 UTF-8，以避免乱码问题。

第二步：编写 page/about.html 模板内容

在 about.html 文件中，您可以根据“关于我们”页面的内容需求，编写 HTML 结构，并使用 AnQiCMS 的模板标签来动态获取数据。通常，这类页面会继承一个基础模板（如 base.html）以保持网站的整体一致性，并使用 pageDetail 标签来获取单页面的具体内容。

{% extends "base.html" %} {# 继承您的基础模板，通常包含头部、尾部等通用元素 #}

{% block title %}
    {# 调用页面 TDK 标签来设置页面标题，并附加网站名称 #}
    <title>{% tdk with name="Title" siteName=true sep=" - " %}</title>
{% endblock %}

{% block keywords %}
    {# 调用页面 TDK 标签来设置页面关键词 #}
    <meta name="keywords" content="{% tdk with name="Keywords" %}">
{% endblock %}

{% block description %}
    {# 调用页面 TDK 标签来设置页面描述 #}
    <meta name="description" content="{% tdk with name="Description" %}">
{% endblock %}

{% block content %}
    <div class="container about-page">
        {# 使用 pageDetail 标签获取当前单页面的详细信息 #}
        {# 假设当前页面就是 'about' 页面，或者ID为'about' #}
        {% pageDetail aboutPage with name="All" %} 
        
        <h1 class="page-title">{{ aboutPage.Title }}</h1>
        
        {% if aboutPage.Images %}
            <div class="page-banner">
                {# 如果设置了Banner图，显示第一张 #}
                <img src="{{ aboutPage.Images[0] }}" alt="{{ aboutPage.Title }}" />
            </div>
        {% endif %}

        <div class="page-content">
            {# 单页面内容，通常包含HTML，需要使用 safe 过滤器防止转义 #}
            {{ aboutPage.Content|safe }}
        </div>

        <div class="contact-info">
            <h2>联系我们</h2>
            <ul>
                <li>联系人：{% contact with name="UserName" %}</li>
                <li>电话：{% contact with name="Cellphone" %}</li>
                <li>邮箱：{% contact with name="Email" %}</li>
                <li>地址：{% contact with name="Address" %}</li>
            </ul>
        </div>
        {% else %}
            <p>很抱歉，关于我们页面内容暂未发布。</p>
        {% endpageDetail %}
    </div>
{% endblock %}

第三步：在 AnQiCMS 后台关联自定义模板

登录 AnQiCMS 后台，导航至 **页面资源 ->