在网站内容运营中，保持页面风格统一，提升用户体验和维护效率至关重要。想象一下，如果您的网站有成百上千个页面，每个页面的页头、页脚或侧边栏都需要手动修改，这将是多么浩大的工程。幸运的是，AnQiCMS 提供了一套强大而灵活的模板机制，能够帮助您轻松引用和管理公共代码片段，确保网站显示的一致性。

AnQiCMS 的模板系统借鉴了 Django 模板引擎的语法，这让它既易于上手又功能强大。它通过 .html 后缀的模板文件组织页面结构，并将样式、脚本、图片等静态资源统一存放在 /public/static/ 目录下，使管理变得井井有条。在实际操作中，您会发现 AnQiCMS 主要通过两种核心方式来实现公共代码片段的引用和统一显示：include 标签和 extends 标签（模板继承）。

通过 include 标签嵌入可复用的代码片段

include 标签是 AnQiCMS 模板系统中一个非常实用的功能，它允许您将独立的、小的代码片段（比如页头、页脚、导航菜单、侧边栏、广告位或版权信息）抽离成单独的文件，然后在需要它们的任何页面中轻松引入。这样做的好处是显而易见的：当您需要修改这些公共元素时，只需编辑一次对应的片段文件，所有引用了它的页面都会同步更新，极大地提升了维护效率。

例如，您可以创建一个名为 partial/header.html 的文件来存放所有页面的统一页头，再创建一个 partial/footer.html 来存放页脚。在您网站的各个页面模板（如 index.html、{模型table}/detail.html 等）中，只需简单地使用 {% include "partial/header.html" %} 和 {% include "partial/footer.html" %} 即可将其引入。

为了进一步增强灵活性和健壮性，include 标签还提供了几个有用的参数：

  • if_exists： 这是一个非常贴心的功能。如果您不确定某个被引用的模板文件是否一定存在，可以在 include 标签后添加 if_exists。这样，即使该文件不存在，系统也不会报错，而是静默地忽略它。这在开发过程中，或者当您引用一些可选的、非核心的片段时特别有用。
  • with 和 only： 有时候，您可能希望向被引入的片段传递一些特定的变量。with 参数允许您在引入时定义新的变量并传递给片段。例如，{% include "partial/header.html" with title="我的网站标题" %} 会将 title 变量传递给 header.html。如果您只想让被引入的片段使用 with 传递的变量，而不继承当前模板的所有变量，可以在 with 之后加上 only 参数，如 {% include "partial/header.html" with title="我的网站标题" only %}。

AnQiCMS 的模板约定中，明确提到了 partial/ 目录就是用于存放这类代码片段的，而像 bash.html 这样的文件则被推荐用于存放页头、页脚等每个页面都继承的部分。

通过 extends 标签构建统一的页面骨架（模板继承）

除了嵌入独立的代码片段，AnQiCMS 还支持更宏观的模板复用机制——模板继承，这主要通过 extends 和 block 标签配合实现。模板继承就像为您的网站设计一个“母版页”或“骨架”，您可以定义一个基础模板（例如 base.html），其中包含网站的整体布局结构（如 <head> 部分、页头、页脚、侧边栏等），并使用 block 标签定义可被子模板覆盖的区域。

例如，您可以在 base.html 中定义一个名为 content 的 block 区域：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>{% block title %}默认标题{% endblock %}</title>
    <!-- 这里引入公共CSS和JS -->
    {% include "partial/head_css.html" %}
</head>
<body>
    {% include "partial/header.html" %} {# 引入公共页头 #}
    <main>
        <aside>{% include "partial/sidebar.html" %}</aside> {# 引入公共侧边栏 #}
        <section>{% block content %}{% endblock %}</section> {# 定义内容区域 #}
    </main>
    {% include "partial/footer.html" %} {# 引入公共页脚 #}
    {% include "partial/foot_js.html" %}
</body>
</html>

然后，在您的具体页面模板（如 article/detail.html）中，只需使用 {% extends 'base.html' %} 继承这个骨架，并使用 block 标签覆盖父模板中定义的同名区域即可。

{% extends 'base.html' %}

{% block title %}文章详情 - {{archive.Title}}{% endblock %}

{% block content %}
    <h1>{{archive.Title}}</h1>
    <p>{{archive.Content|safe}}</p>
    <!-- 更多文章内容 -->
{% endblock %}

这样一来，所有继承 base.html 的页面都会拥有相同的页头、页脚和侧边栏，而页面的核心内容则由各自的模板独立填充。需要注意的是，{% extends %} 标签必须是您模板文件中的第一个标签，并且每个 block 标签都需要成对出现。

灵活的辅助标签

除了 include 和 extends，AnQiCMS 还提供了 macro 标签，它允许您创建可参数化的小型代码逻辑片段，类似于编程语言中的函数。这对于复用带有特定输入参数的复杂 HTML 结构非常有用，进一步提高了模板的可维护性和复用性。

总而言之，AnQiCMS 通过 include 标签和 extends 标签提供了完善的模板复用机制。无论是嵌入小的公共片段，还是构建网站的整体布局，这些功能都能帮助您实现页面的高度统一显示，提升网站的整体专业度和运营效率。灵活运用这些工具，您的网站内容将更加一致、易于管理，也更容易为访客提供流畅的浏览体验。

常见问题 (FAQ)

Q1: 我能否让某个特定页面不使用网站统一的页头或页脚？

当然可以。如果您使用了 extends 标签进行模板继承，子模板可以通过重新定义父模板中页头或页脚所在的 block 区域来覆盖它，使其显示不同的内容，甚至留空不显示。如果页头或页脚是通过 include 标签引入的，您可以为该特定页面制作一个不同的模板，或者修改该页面的模板，将 include 标签替换为所需内容。

Q2: include 和 extends 这两种模板复用方式有什么具体区别，我应该如何选择？

简单来说，include 适用于“插入”或“嵌入”相对独立的、功能性强的代码片段，例如侧边栏、广告位、版权信息等，这些片段通常是页面的一部分。而 extends 则用于“继承”一个页面的整体结构和布局，它定义了页面的大骨架，并通过 block 标签留出可填充内容的区域。当您希望所有页面拥有统一的整体结构时，选择 extends；当您希望在不同页面中复用小的、独立的 UI 组件时，选择 include。两者常常结合使用，例如在 extends 继承的 base.html 中，通过 include 引入公共的页头和页脚。

Q3: 如果我引用的公共代码片段文件不小心被删除了，网站会报错吗？如何避免这种情况？

如果您在使用 include 标签时，简单地写成 {% include "path/to/fragment.html" %}，那么当 fragment.html 文件不存在时，系统会抛出错误，导致页面无法正常显示。为了避免这种情况，您可以使用 {% include "path/to/fragment.html" if_exists %}。加上 if_exists 参数后，即使该文件不存在，系统也会静默地忽略这个引入，页面会继续渲染而不会报错，这对于一些非核心的、可选的片段引入非常有用。