在AnQiCMS中，模板文件的组织方式和命名约定对网站内容的最终呈现起着决定性的作用。理解这些约定，能让我们更高效、灵活地控制网站的视觉和功能表现。

模板文件的“家”：/template 目录与 .html 后缀

当我们着手AnQiCMS的模板设计时，首先会接触到根目录下的 /template 文件夹。这里是所有网站模板的统一存放之地。这意味着无论我们创建多少套主题，它们都将在此目录下拥有各自独立的子目录，保持了清晰的组织结构。每一个模板主题内部，通常还会包含一个 config.json 文件，用于定义该主题的名称、版本、作者以及最重要的——模板类型（template_type）。这个类型设定，如“自适应”、“代码适配”或“PC+手机”，直接影响了AnQiCMS如何根据用户设备来选择和加载模板，为多终端访问提供了基础。

虽然模板文件都统一以 .html 作为后缀，但这并不意味着它们是简单的静态HTML页面。AnQiCMS的模板引擎采用了类似于Django的语法，它允许我们在HTML结构中嵌入动态内容和复杂的逻辑。这意味着我们可以在 <div> 标签中插入 {{变量}} 来显示数据，或者使用 {% if 条件 %} 和 {% for 循环 %} 这样的标签来控制内容的显示与排版。这种设计将静态结构与动态数据完美结合，极大地提升了模板的复用性和灵活性。在编写这些动态模板时，统一使用UTF8编码是确保内容正常显示，避免乱码的关键。

精准控制内容展示的约定

AnQiCMS通过一套智能的命名约定，让模板文件能够自动匹配并渲染对应的内容。这极大地简化了后台设置的复杂性，同时也提供了精细化的控制能力。

默认模板文件的自动匹配是其核心特性之一。例如，系统会默认寻找 index/index.html 作为网站首页，{模型table}/detail.html 作为模型详情页，{模型table}/list.html 作为列表页。这些约定让内容在没有特殊指定的情况下，也能按照预设的风格显示。错误页面如 errors/404.html 和 errors/500.html 也遵循着类似的约定，确保在异常情况下网站依然能友好地提示用户。

更进一步，AnQiCMS还支持针对特定内容ID或分类ID进行模板自定义。例如，如果我们希望某个特定的文档（比如ID为10的文档）拥有一个独一无二的详情页布局，AnQiCMS会优先寻找 {模型table}/{文档id}.html（例如 article/10.html）。同理，对于某个特定分类的列表页，系统会尝试加载 {模型table}/list-{分类id}.html。这种粒度极高的定制能力，使得我们可以为重要内容或特殊专题提供专属的展示效果，而无需修改通用模板。对于单页面（如“关于我们”），我们也可以创建 page/{单页面id}.html 或更具描述性的 page/about.html，并在后台将其关联，实现高度个性化的页面布局。

对于移动端的适配，如果 config.json 中配置了“代码适配”或“PC+手机”模式，AnQiCMS会根据访问设备自动识别，并尝试从 /template/mobile 子目录中寻找与PC端模板结构和命名相同的模板文件。这使得开发者可以为移动用户提供完全不同的用户体验，无论是布局、交互还是加载速度，都能进行针对性优化。

在模板文件的组织上，AnQiCMS提供了“文件夹组织模式”和“扁平化文件组织模式”两种选择。前者通过 /partial 目录存放可复用的代码片段（如侧边栏、页头页脚），并通过 include 标签引用，增强了代码的模块化和复用性。后者则将所有模板文件放在同一层级，通过特定的命名来区分不同页面。这两种模式各有侧重，可以根据项目规模和团队习惯进行选择，但无论哪种，其核心都在于通过约定来实现内容的有序展示。

总结与展望

AnQiCMS模板的 .html 后缀和 /template 目录结构，以及围绕其建立的命名和组织约定，共同构成了网站内容显示的基础。它不仅为我们提供了强大的灵活性，能够根据需求定制从全局到单点的显示样式，还通过智能匹配机制简化了模板管理。这种结构对于网站的长期维护、团队协作以及未来的功能扩展都大有裨益。清晰的模板约定有助于我们在内容运营中更加游刃有余，无论是进行品牌宣传、产品展示还是内容营销，都能确保信息以**状态呈现给目标用户。

常见问题 (FAQ)

  1. 问：如何在AnQiCMS后台指定某个文档或分类使用特定的模板文件？ 答： 在编辑文档或分类页面时，通常会有一个“文档模板”或“分类模板”的选项。你只需在这个输入框中填写你创建的模板文件名称（例如 download.html），或者基于命名约定创建的路径（例如 article/special-detail.html），并确保该文件存在于你当前使用的模板主题目录下，AnQiCMS便会在访问该内容时，优先加载你指定的模板。

  2. 问：如果我为PC端和移动端设计了不同的模板，AnQiCMS是如何判断并加载正确的模板的？ 答： 当你为PC和移动端设计了不同的模板时，你需要在当前模板主题目录下的 config.json 文件中，将 template_type 设置为“代码适配”（1）或“PC+手机”（2）。然后，将移动端模板文件存放在当前模板主题目录下的 mobile/ 子目录中，并保持与PC端模板文件相同的命名结构。AnQiCMS会根据用户访问设备的类型（通过User-Agent等方式判断），自动优先从 mobile/ 目录中寻找并加载对应的模板文件。

  3. 问：为什么模板文件使用.html后缀，但它看起来不像普通的HTML文件？ 答： 虽然模板文件后缀是.html，但它们并非纯静态HTML。AnQiCMS采用了Go语言的Django-like模板引擎，这意味着这些.html文件内部可以包含特殊的模板标签和变量。例如 {{变量名}} 用于显示数据，{% if 条件 %} 用于逻辑判断，{% for 循环 %} 用于数据遍历。在网站运行时，AnQiCMS服务器会先解析这些标签，将动态数据填充进去，最终再生成并输出为用户浏览器能识别的纯HTML内容。