灵活定制网站：AnQiCMS 的模板继承如何让母版页和子页面各显神通？

在网站内容管理中，保持页面风格一致性同时又能灵活修改局部内容，是许多运营者追求的目标。AnQiCMS 采用类似 Django 模板引擎的语法，为我们提供了一个优雅的解决方案，那就是强大的模板继承功能。通过这个功能，我们可以巧妙地设计母版页和子页面，让网站结构既统一又高度可定制。

想象一下，您的网站如同一个品牌系列产品，每个产品都有共同的设计元素（比如 Logo、导航、页脚），但又各有特色。模板继承正是实现这种“标准化与个性化”并存的关键。它允许我们定义一个全局的“骨架”——也就是母版页，其中包含了所有页面共有的布局和元素。而每个具体的页面，例如文章详情页、产品展示页或是联系我们页面，则作为“子页面”，在不改动整体骨架的前提下，对特定内容区域进行填充或覆盖。

实现这种灵活定制的核心在于两个关键标签：extends 和 block。

首先，extends 标签是我们声明页面继承关系的基础。在任何一个子页面模板文件的最开始，您需要明确地告诉 AnQiCMS，这个页面是基于哪个母版页构建的。例如，如果您的通用骨架模板名为 base.html，那么在子页面 index.html 的第一行，您就会写上 {% extends 'base.html' %}。这一点至关重要，extends 标签必须是模板文件中的第一个标签，否则模板继承将无法正常工作。

接下来，block 标签则扮演了“内容区块占位符”的角色。在母版页 base.html 中，您会用 block 标签包裹那些您希望子页面可以定制的区域。例如，页面的 <title> 标签内容、主体内容区或者侧边栏等。一个典型的 block 定义看起来会像这样：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    {% block title %}
        <title>我的网站 - 默认标题</title>  {# 这是母版页的默认标题 #}
    {% endblock %}
    <link rel="stylesheet" href="/public/static/css/style.css">
</head>
<body>
    <header>
        {% include 'partial/header.html' %} {# 头部可能是一个独立引入的公共片段 #}
    </header>

    <main class="container">
        <aside>
            {% block sidebar %}
                {# 侧边栏的默认内容或留空 #}
                <p>这是通用侧边栏内容。</p>
            {% endblock %}
        </aside>
        <section class="content">
            {% block main_content %}
                {# 主体内容区的默认内容或留空 #}
                <h2>欢迎来到我们的网站！</h2>
                <p>这里是默认的主体内容。</p>
            {% endblock %}
        </section>
    </main>

    <footer>
        {% block footer %}
            {# 页脚的默认内容或留空 #}
            <p>&copy; {% now "2006" %} 版权所有</p>
        {% endblock %}
    </footer>
</body>
</html>

当您在子页面 index.html 中继承了 base.html 后，您就可以选择性地对这些 block 进行“扩写”或“覆盖”。如果您不重写某个 block，那么子页面就会沿用母版页中该 block 内定义的默认内容。而如果您决定重写，只需在子页面中也使用同名的 block 标签，并在其中填入您想要显示的内容即可：

{% extends 'base.html' %}

{% block title %}
    <title>首页 - 安企CMS</title> {# 覆盖了母版页的标题 #}
{% endblock %}

{% block sidebar %}
    {# 首页不需要侧边栏，这里选择留空，或者放入首页特有的侧边栏内容 #}
    <nav>
        <ul>
            <li><a href="/about">关于我们</a></li>
            <li><a href="/contact">联系我们</a></li>
        </ul>
    </nav>
{% endblock %}

{% block main_content %}
    <div class="hero-section">
        <h1>AnQiCMS 助您轻松建站</h1>
        <p>高效、可定制、易扩展的企业级内容管理系统。</p>
        <a href="/products" class="btn btn-primary">了解更多产品</a>
    </div>
    {# 这里可以继续引入一些文章列表、产品展示等动态内容 #}
    {% archiveList latest_articles with type="list" limit="5" %}
        <h3>最新文章</h3>
        <ul>
            {% for article in latest_articles %}
                <li><a href="{{ article.Link }}">{{ article.Title }}</a></li>
            {% endfor %}
        </ul>
    {% endarchiveList %}
{% endblock %}

{# 这里没有重写 footer block，所以会沿用母版页的默认页脚内容 #}

通过这种方式，AnQiCMS 的模板继承功能让网站的开发和维护变得极为高效。您可以在母版页中统一管理网站的整体布局、CSS 和 JavaScript 引用，确保所有页面都具备一致的品牌形象和基本功能。而对于每个独立的内容页面，您只需关注其独特的内容区块，大幅减少了重复代码的编写。当网站需要进行整体风格调整时，通常只需修改母版页，所有继承它的子页面便会自动更新，极大地提高了运营效率和维护的便捷性。这不仅使得网站结构清晰，也为未来的功能扩展留下了充足的空间。

常见问题 (FAQ)

1. extends 和 include 标签有什么区别？我该如何选择？

extends 标签用于定义一个模板继承另一个模板的“骨架”结构，通常用于母版页和子页面之间，子页面通过 block 标签来覆盖或填充母版页的特定区域。它关注的是整体布局和可定制的内容区块。

而 include 标签则更像是“插入”一个独立的、可重用的代码片段到当前模板的任何位置。例如，一个新闻列表中的每个新闻条目（news_item.html）、一个通用的广告位或者一个面包屑导航，这些都是可以在不同页面中独立插入且无需改变页面整体结构的组件。它们不涉及覆盖母版页的结构，只负责提供内容。

简单来说，当您需要定义页面整体结构并允许局部内容覆盖时，使用 extends；当您需要将小型、独立的组件插入到页面特定位置时，使用 include。

2. 我可以在一个子模板中再次使用 extends 标签，形成多层继承吗？

理论上，您可以构建多层继承链，例如 page.html 继承 article_base.html，而 article_base.html 又继承 base.html。AnQiCMS 模板引擎是支持这种嵌套继承的。这样做的好处是可以在不同的层级定义更细粒度的结构。不过，在实际操作中，过多的继承层级可能会增加模板的复杂性和理解成本，因此建议在保持代码清晰和可维护性的前提下，合理规划继承结构。

3. 如果子页面没有重写母版页中的某个 block，会发生什么？

如果子页面没有明确地通过同名 block 标签来重写母版页中定义的某个 block，那么 AnQiCMS 会默认使用母版页中该 block 内部定义的所有内容。这意味着母版页可以为所有可定制的区域提供默认的内容或布局，确保即使子页面不进行任何特殊设置，网站也能正常显示并具备基本的结构。