在构建网站时，我们往往需要为不同的页面类型赋予独特的外观和功能，例如首页的宏大布局、文章详情页的沉浸式阅读体验，或是商品列表页的筛选与展示。AnQiCMS 提供了一套灵活的机制，让用户能够轻松地为网站的各个页面指定和管理显示模板。这不仅提升了网站的定制化程度，也极大地优化了用户体验和内容呈现效率。

AnQiCMS 网站的模板文件统一存放在 /template 目录下。通常，每一套独立的网站主题都会在这个目录下拥有一个专属的文件夹，例如 default 或 my_custom_theme。在这个主题文件夹内，静态资源如样式表（CSS）、JavaScript 脚本和图片则会单独存放在 /public/static/ 目录中。模板文件本身通常以 .html 作为后缀。

AnQiCMS 提供了两种主要的模板文件组织方式：文件夹组织模式和扁平化文件组织模式。无论采用哪种模式，系统都支持一套默认的模板命名约定，只要您按照这些约定创建了模板文件，AnQiCMS 就能自动识别并应用它们，无需额外的后台配置。例如：

  • 首页模板：通常命名为 index/index.html（文件夹模式）或 index.html（扁平化模式）。
  • 文档详情页（如文章、产品）：默认可以命名为 {模型table}/detail.html。例如，如果是文章模型，可以是 article/detail.html。
  • 文档列表页（按分类）：默认可以命名为 {模型table}/list.html。例如，article/list.html 用于文章列表。
  • 单页面详情页：默认可以命名为 page/detail.html。

此外，AnQiCMS 还允许为特定内容指定更细致的默认模板名称，例如：

  • 特定文档详情页：{模型table}/{文档id}.html，这允许您为某个具体 ID 的文档设计专属模板。
  • 特定分类列表页：{模型table}/list-{分类id}.html，可以为某个特定分类下的列表页提供定制布局。
  • 特定单页面：page/{单页面id}.html，用于为某个具体 ID 的单页面（如“关于我们”页面）提供独特模板。

这些默认命名规则极大地简化了模板管理，对于多数场景而言，按照这些约定创建模板即可。

然而，当您需要更精细地控制某个特定内容（比如一篇特殊的文章、一个特定的产品分类或一个独特的单页面）的显示模板时，AnQiCMS 也提供了在后台管理界面进行手动指定的选项。

为单篇文档（文章/产品）指定显示模板：

当您在后台创建或编辑一篇文档时，可以在文档的“其他参数”设置区域找到一个名为“文档模板”的字段。在这里，您可以输入您希望该文档使用的自定义模板文件名，例如 download.html。请务必确保这个文件存在于您的主题模板目录中，否则该文档可能无法正常访问。这种方式非常适合为一些具有特殊展示需求的内容（如软件下载页、特殊活动页）提供独立的布局。

为文档分类指定显示模板：

在后台的“内容管理”模块下，进入“文档分类”管理界面。当您添加或编辑某个分类时，在“其他参数”区域有两项重要的模板设置：

  1. 分类模板：这是指该分类下的列表页所使用的模板。默认情况下，它可能是 {分类模型}/list.html。如果您想为某个特定分类的列表页设计独特的布局，可以在这里填入自定义的模板文件名，例如 special_products_list.html。
  2. 文档模板：此设置允许您为该分类下的所有文档详情页指定一个统一的模板。例如，如果您希望某个产品分类下的所有产品都使用一个名为 product_detail_v2.html 的模板来显示，您可以在这里进行设置。同时，这里还有一个“是否应用到子分类”的选项，勾选后，该设置会继承给所有下级子分类。

为单页面指定显示模板：

在“页面资源”模块的“页面管理”中，当您添加或编辑一个单页面时，会看到一个“单页面模板”的选项。与文档类似，您可以在这里指定该单页面使用的自定义模板文件，例如 about_us.html。

理解模板类型与移动端适配：

AnQiCMS 支持多种网站模式，包括自适应、代码适配以及PC+手机独立站点模式。如果您的网站模板选择了“代码适配”或“PC+手机独立站点”模式，那么您还需要在主题文件夹内创建一个 mobile 目录。移动端模板的目录结构和文件命名规则与PC端保持一致，只是它们存在于 mobile 子目录下，用于适配移动设备访问。

通过以上这些方法，无论是通过默认命名约定，还是在后台进行手动指定，AnQiCMS 都赋予了您高度的灵活性，来精细控制网站各个页面的显示模板，从而打造出真正符合业务需求和品牌形象的网站。

常见问题 (FAQ)

  1. Q: 我在后台指定了自定义模板文件名，但页面访问时出现错误，提示模板文件不存在，是什么原因？

    • A: 这通常是由于您指定的模板文件名与实际文件路径不匹配造成的。请检查：
      • 模板文件是否确实存在于当前主题的 /template/你的主题文件夹/ 目录下。
      • 文件名是否拼写正确（包括大小写）。
      • 如果您的模板文件在某个子目录（例如 page/about.html），请确保在后台填写时包含了子目录路径 page/about.html。
      • 请确认您当前使用的网站主题是您期望的那套，并且该主题被正确启用。

  2. Q: AnQiCMS 如何区分PC端和移动端使用不同的模板？

    • A: AnQiCMS 支持“代码适配”和“PC+手机独立站点”两种模式来实现移动端适配。在这两种模式下，您需要在您的主题文件夹内创建一个名为 mobile 的子目录。当系统检测到用户通过移动设备访问时，会优先尝试在 mobile 目录中查找对应的模板文件。例如，如果PC端详情页模板是 article/detail.html，那么移动端对应的模板就应该放在 mobile/article/detail.html。

  3. Q: 我可以在一个模板文件中引用另一个模板文件吗？例如，所有页面都使用同一个页头和页脚。

    • A: 当然可以。AnQiCMS 的模板引擎支持 {% include "partial/header.html" %} 和 {% extends "base.html" %} 等标签。include 标签用于嵌入其他模板片段（如页头、页脚、侧边栏），而 extends 标签则用于实现模板继承，您可以创建一个基础骨架模板（如 base.html），然后让其他页面模板继承它并重写其中的特定区块。这样可以大大提高模板的可维护性和复用性。