在AnQiCMS中构建网站模板，高效的代码复用是提升开发速度和维护效率的关键。想象一下，网站的页头（Header）和页脚（Footer）几乎在每个页面都会出现，如果每个页面都重复编写相同的代码，不仅耗时，而且一旦需要修改，就得逐个页面查找并更新，这无疑是巨大的工作量。幸运的是，AnQiCMS提供了一个强大且直观的工具来解决这个问题——那就是模板中的include标签。
AnQiCMS的模板引擎类似Django语法，它旨在让模板制作变得简单易懂。通过include标签，您可以轻松地将页头、页脚、侧边栏等公共代码片段抽离成独立的文件，然后在需要的地方进行引用，极大地简化了模板的结构和管理。
为什么选择代码复用？
高效的代码复用能带来多方面的好处。首先是提高开发效率，您无需在每个页面重新编写相同的HTML结构、CSS链接或JavaScript引用。只需创建一次，便可在全站多次使用。其次，它确保了网站的一致性，无论您的网站有多少页面，公共部分的样式和功能都能保持统一。最重要的是简化维护工作，当网站的Logo、导航菜单或版权信息需要更新时，您只需修改一个公共文件，所有引用了该文件的页面都会同步更新，大大降低了出错的风险和维护成本。
include标签的基础用法
在AnQiCMS中，模板文件通常以.html作为后缀，并存放在/template目录下的特定主题文件夹内。为了更好地组织代码片段，您可以创建一个partial/子目录，用于存放那些被include引用的公共片段，比如header.html、footer.html等。
include标签的基本语法非常直接：
{% include "文件路径" %}
这里的文件路径是相对于您的模板根目录（例如/template/您的主题名/）的。
例如，如果您想在index.html中引入一个位于partial/header.html的页头和一个位于partial/footer.html的页脚，您的代码可能会是这样：
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>我的网站首页</title>
<!-- 其他头部元信息和样式表 -->
</head>
<body>
{# 引入页头公共代码 #}
{% include "partial/header.html" %}
<main class="content">
<h1>欢迎来到我的AnQiCMS网站！</h1>
<p>这里是网站的主要内容区域。</p>
<!-- 更多页面特有内容 -->
</main>
{# 引入页脚公共代码 #}
{% include "partial/footer.html" %}
</body>
</html>
而在partial/header.html文件中，您可能定义了导航条、Logo等元素：
<header class="site-header">
<div class="logo">
<a href="{% system with name="BaseUrl" %}">
<img src="{% system with name="SiteLogo" %}" alt="{% system with name="SiteName" %}">
</a>
</div>
<nav class="main-nav">
<ul>
{% navList navs %}
{%- for item in navs %}
<li class="{% if item.IsCurrent %}active{% endif %}">
<a href="{{ item.Link }}">{{item.Title}}</a>
</li>
{% endfor %}
{% endnavList %}
</ul>
</nav>
</header>
partial/footer.html文件则可能包含版权信息、备案号等：
<footer class="site-footer">
<p>{% system with name="SiteCopyright" %}</p>
<p><a href="https://beian.miit.gov.cn/" rel="nofollow" target="_blank">{% system with name="SiteIcp" %}</a></p>
</footer>
通过这样的方式，您的主要页面文件（如index.html）将变得非常简洁，专注于页面独有的内容，而公共部分则由各自的文件负责。
向被引入的模板传递数据
有时候，您可能希望被include引入的模板能接收一些特定的数据，以便更灵活地展示内容。AnQiCMS的include标签支持使用with关键字来传递变量。
例如，您可能希望页头根据当前页面显示不同的标题，但页头文件本身不具备获取页面标题的能力。这时，您可以在include时传递：
{% include "partial/header.html" with page_title="关于我们" %}
在partial/header.html中，您就可以使用这个page_title变量：
<header class="site-header">
<h1>{{ page_title }}</h1> {# 这里会显示“关于我们” #}
<!-- ... 其他页头内容 ... -->
</header>
您还可以传递多个变量，只需用空格分隔它们：
{% include "partial/header.html" with page_title="关于我们" show_search="true" %}
默认情况下，被include的模板会继承当前模板的所有可用变量。如果您只想让被引入的模板使用通过with传递的变量，而忽略其他所有继承的变量，可以使用only关键字：
{% include "partial/header.html" with page_title="关于我们" only %}
处理可能不存在的模板
为了避免因被include的模板文件不存在而导致页面报错，您可以使用if_exists关键字。当被引入的模板文件不存在时，if_exists会告诉系统忽略这个include操作，而不是抛出错误。这在一些可选的、非核心的模块引用中非常有用。
{# 如果存在这个文件则引入，不存在则忽略 #}
{% include "partial/sidebar.html" if_exists %}
通过灵活运用include标签及其各种参数，您可以构建出结构清晰、易于管理且高效的AnQiCMS网站模板。
常见问题 (FAQ)
1. include标签和extends标签有什么区别，它们应该如何配合使用？
include标签主要用于将小的、可重用的代码片段（如页头、页脚、侧边栏）插入到当前模板中，它关注的是“局部组件的插入”。而extends标签则用于实现模板继承，它定义了一个基础布局骨架（base template），其他模板可以继承这个骨架，并只修改其中特定的“区块”（block）。在实际开发中，这两者常常结合使用：您可以使用extends来定义一个包含页头、页脚和主内容区域的base.html骨架，然后在base.html内部，再用include标签将独立的页头和页脚文件引入进来，这样既能保持整体布局的统一性，又能实现局部组件的灵活复用和管理。
2. 我可以在include的文件中使用AnQiCMS的内置标签（如{% system %}或{% navList %}）吗？
当然可以。被include的文件本质上仍然是AnQiCMS的模板文件。因此，您可以在这些文件中自由使用AnQiCMS提供的所有内置标签、变量输出（{{变量名}}）以及条件判断（{% if %}）等模板语法。这使得您可以在公共代码片段中动态地获取系统配置、导航列表等信息，实现高度的灵活性。
3. 如果我的include文件路径写错了，或者文件不存在，页面会报错吗？如何避免？
是的，如果include标签中指定的文件路径有误或文件不存在，AnQiCMS在渲染页面时会抛出错误，导致页面无法正常显示。为了避免这种情况，您可以使用if_exists关键字。例如：{% include "partial/non_existent_file.html" if_exists %}。这样，如果non_existent_file.html文件不存在，系统将跳过此include操作而不会报错，页面仍能正常加载，但相应的内容将不会显示。这对于一些可选的、非必需的模板片段尤其有用。