如何为AnQiCMS的首页、详情页、列表页等配置特定的模板文件以控制显示？
AnQiCMS，以其Go语言开发的高效能和灵活定制特性，为网站内容的展示提供了强大的控制力。无论您是运营中小企业官网、个人博客，还是需要管理多个站点，理解如何为不同的页面配置专属模板，都是提升网站个性化和用户体验的关键。
在AnQiCMS中，内容展示的核心在于模板文件。这些文件决定了网站的视觉布局、内容排版以及互动元素。AnQiCMS采用了类似Django模板引擎的语法，这让熟悉常见模板语言的用户能够快速上手，即使是初次接触，其自然直观的标签和变量用法也易于理解。
模板文件的基本结构与存放位置
所有与模板相关的.html文件都集中存放在/template根目录下。通常，每个独立的模板主题都会拥有一个专属的子目录，例如一个名为default的模板，其所有文件将位于/template/default。在这个模板主题目录下，您会找到一个config.json文件，它记录了模板的名称、版本、作者等基本信息，更重要的是，它定义了template_type，这决定了您的网站是采用自适应、代码适配还是PC+手机独立站点模式。
除了.html模板文件，与模板相关的CSS样式、JavaScript脚本和图片等静态资源，则会统一存放在/public/static/目录中，这样可以保持项目结构的清晰和整洁。编辑模板文件时，务必确保文件编码为UTF-8，以避免页面出现乱码。
AnQiCMS如何自动识别与匹配模板
AnQiCMS的设计理念之一是“约定优于配置”，这意味着在很多情况下，系统会根据一套预设的命名规则自动匹配模板文件，省去了您手动指定的麻烦。
举例来说，对于网站的首页，AnQiCMS会尝试加载index/index.html（在文件夹组织模式下）或直接是模板根目录下的index.html（在扁平化模式下）。
对于列表页和详情页，AnQiCMS的智能匹配机制则更加灵活：
- 列表页（分类页）：如果您有一个“文章”模型，系统会首先寻找
article/list.html作为通用的文章列表模板。如果您希望某个特定分类（例如ID为10的“新闻资讯”分类）有独特的布局，AnQiCMS会尝试寻找article/list-10.html这样的文件。 - 详情页（文档页）：同样，对于文章详情页，系统会尝试加载
article/detail.html。如果您需要某个特定文章（例如ID为25的“产品发布”文章）展示不同的样式，可以创建article/detail-25.html。 - 单页面：对于“关于我们”这类独立页面，默认模板可能是
page/detail.html，而针对ID为5的特定单页，系统则会寻找page/5.html。
这种自动匹配机制大大简化了模板管理，您只需按照特定规则命名文件，AnQiCMS就能心领神会。
精细化控制：手动指定特定页面模板
尽管AnQiCMS的自动匹配功能十分便捷，但在某些复杂场景下，我们可能需要对单个页面进行更精细的模板控制。AnQiCMS提供了在后台手动为特定页面指定模板路径的选项，这使得个性化定制变得触手可及。
全局共享模板片段： 在您的模板目录下，通常会有一个
bash.html文件，用于存放网站的通用头部、底部等公共区域代码。此外，partial/目录则常用于存放侧边栏、面包屑导航等可复用的代码片段。通过{% include "partial/header.html" %}这样的标签，您可以在任何页面中轻松引入这些共享内容。为单个分类设置独立模板： 在AnQiCMS后台的“内容管理” -> “文档分类”中，编辑某个分类时，您会看到一个“分类模板”字段。在这里，您可以填写一个完全自定义的模板文件路径，例如为您的“行业资讯”分类指定一个名为
article/industry-news-list.html的模板。更进一步，您还可以选择“是否应用到子分类”，让该分类下的所有子分类都继承此模板，实现统一风格。此外，分类设置中还有“文档模板”选项，这允许您为该分类下的所有文档统一指定一个详情页模板，例如article/news-detail.html。为单个文档指定专属模板： 在AnQiCMS后台的“内容管理” -> “发布文档”或编辑文档时，在“其他参数”中有一个“文档模板”字段。假设您有一篇关于“最新产品白皮书下载”的文章，希望它拥有一个独特的、带有下载按钮和客户案例的详情页布局，您可以创建一个
article/whitepaper-download.html模板，并在此字段中填入该路径。这样，这篇特定的文章就会加载您指定的模板，而不是通用的文档详情模板。为单个独立页面设置独特模板： 在AnQiCMS后台的“页面资源” -> “页面管理”中，编辑一个单页面时，同样有一个“单页面模板”字段。如果您想为“联系我们”页面设计一个包含地图、表单和多部门联系方式的特殊布局，您可以创建一个
page/contact-us.html的模板，并在后台为其指定。
通过这些灵活的配置方式，AnQiCMS确保了您对网站每一寸内容的展示都拥有绝对的掌控权。无论是遵循系统约定，还是手动精细定制，都能让您的网站在视觉和功能上脱颖而出。
模板内容的填充与动态展示
一旦模板文件配置完成，接下来就是如何在这些模板中展示动态内容。AnQiCMS的模板引擎支持各种标签和过滤器，让您能够轻松地从数据库中获取数据并呈现在页面上。