在 AnQiCMS 中，为特定的文档、分类或单页面设置独立的模板，是实现网站内容个性化展示和提升用户体验的关键功能。这不仅能让网站设计更具灵活性，也能针对不同类型的内容进行精准的样式控制，从而更好地满足品牌定位和内容运营策略。

理解 AnQiCMS 的模板机制

AnQiCMS 提供了两种主要方式来应用自定义模板：一种是系统根据文件命名规则自动识别并加载模板，另一种是在后台管理界面手动指定某个内容使用的模板。这两种方式都赋予了内容极大的展示自由度，您可以根据需求选择最适合的方式。

AnQiCMS 的模板文件通常以 .html 为后缀，并统一存放在 /template 目录下您所使用的模板主题文件夹中。模板制作遵循类似 Django 模板引擎的语法，易于上手，方便开发者或运营人员进行自定义。

为不同类型的内容配置独立模板

1. 为单页面设置独立模板

单页面（如“关于我们”、“联系我们”等）常需要独特的布局和样式。AnQiCMS 为此提供了灵活的模板配置。

  • 自动识别： AnQiCMS 拥有一套智能的模板识别机制。如果您在当前使用的模板主题目录下，创建了名为 page/{单页面ID}.html 或 page/{单页面别名}.html 的文件（例如，如果您的单页面 ID 是 10，则文件名为 page/10.html；如果您的单页面别名设置为 about-us，则文件名为 page/about-us.html），系统便会在访问该单页面时自动加载此模板。这意味着只要模板文件存在且命名符合规则，无需额外设置即可生效。
  • 手动指定： 当您希望对某个单页面进行更精细的控制，或者文件命名不符合自动识别规则时，可以通过后台手动指定。您可以在 页面资源 -> 页面管理 中编辑相应的单页面。在编辑界面的“其他参数”区域，找到“单页面模板”字段。在这里，您可以填写您希望使用的模板文件名，例如 custom-about.html。请注意，这个文件必须存在于您当前使用的模板主题的根目录下，或者在指定子目录中，例如 page/custom-about.html。填写后，该单页面将优先使用您指定的模板进行显示。

2. 为分类设置独立模板

分类页面（如文章列表页、产品列表页）的样式统一性对于用户体验至关重要，但有时也需要个别分类展现出不同的风貌。

  • 自动识别（分类列表页）： 类似于单页面，AnQiCMS 可以根据分类 ID 自动加载模板。如果您的模板主题目录下存在名为 {模型table}/list-{分类ID}.html 的文件（例如，文章模型下 ID 为 1 的分类列表页，可以命名为 article/list-1.html），系统将自动应用此模板。
  • 手动指定（分类列表页）： 您可以在 内容管理 -> 文档分类 中编辑相应的分类。在编辑分类页面的“其他参数”区域，找到“分类模板”字段。在此处填写您自定义的模板文件名，例如 special-category-list.html。这个模板文件通常用于控制该分类下的列表页布局。
    • 值得一提的是，该设置下方还有一个“是否应用到子分类”的选项。如果您勾选此项，则该分类下所有的子分类（如果它们没有单独设置自己的分类模板）都将沿用此模板，这对于保持层级内容的统一性非常方便。
  • 为分类下的文档指定模板： 除了分类列表页，您还可以在分类级别为该分类下的所有文档设置一个默认的文档模板。在编辑分类页面的“其他参数”区域，找到“文档模板”字段。在此处填写的模板文件名，例如 special-article-detail.html，将作为该分类下所有文档的默认展示模板。这意味着当用户访问该分类下的任何一篇文档时，如果文档本身没有独立指定模板，则会使用此分类级别的文档模板。

3. 为文档设置独立模板

对于某些特殊的文章、产品详情页，您可能需要其具有完全独特的展示风格，以突出其重要性或特点。

  • 自动识别： 系统同样支持文档详情页的自动识别。如果您在当前模板主题目录下创建了名为 {模型table}/{文档ID}.html 的文件（例如，文章模型下 ID 为 100 的文档，可以命名为 article/100.html），系统将自动加载此模板。
  • 手动指定： 这是优先级最高的模板设置方式。您可以在 内容管理 -> 发布/编辑文档 中操作。在文档编辑界面的“其他参数”区域，找到“文档模板”字段。在这里填写您希望使用的模板文件名，例如 featured-product.html。一旦为某篇文档指定了独立模板，它将覆盖掉分类级别设置的文档模板，确保该文档以最独特的方式呈现。

模板文件存放位置与命名规则回顾

为了更好地利用这些功能，请记住以下关键点：

  • 根目录： 所有自定义模板文件都应放在您当前使用的模板主题文件夹（例如 /template/default）内。
  • 子目录： 推荐将不同类型内容的模板文件放置在相应的子目录中，如 page/ 用于单页面，article/ 或 {模型table}/ 用于文档和分类列表。
  • 自动识别命名格式：
    • 单页面：page/{单页面ID}.html 或 page/{单页面别名}.html
    • 分类列表页：{模型table}/list-{分类ID}.html
    • 文档详情页：{模型table}/{文档ID}.html
  • 手动指定命名： 您可以自由命名模板文件（例如 custom-template.html），然后在后台相应内容的模板字段中填入此文件名。如果模板文件在子目录中，则需要包含子目录路径，例如 page/custom-template.html。

通过灵活运用 AnQiCMS 提供的这些独立模板设置功能，您将能够为网站的每一部分内容打造独特的视觉体验，不仅让您的网站更具吸引力，也能更好地传递信息，实现更精细化的内容运营目标。

常见问题 (FAQ)

Q1: 如果某个文档同时符合自动识别的模板命名规则，又在后台手动指定了模板，AnQiCMS 会优先使用哪一个？ A1: AnQiCMS 会优先使用您在后台管理界面为该文档、分类或单页面手动指定的模板。手动设置的优先级最高，它会覆盖掉自动识别的模板，以及从上级分类继承的文档模板。

Q2: 我能否为某个分类下的所有文档设置一个统一的模板，而不需要逐一去设置每篇文档？ A2: 可以的。您可以在编辑分类时，在“其他参数”区域找到“文档模板”字段。在此处填写一个模板文件名，该分类下的所有文档（除非文档本身单独指定了模板）都将默认使用此模板进行显示。这对于维护某个特定主题或系列的文档风格非常有效。

Q3: 如果我指定了一个不存在的自定义模板文件，网站会报错吗？或者会如何显示？ A3: 如果您在后台指定了一个不存在的模板文件，AnQiCMS 在尝试加载该模板时会失败，通常会导致页面显示错误或回退到系统默认的模板（如果存在且逻辑允许）。因此，在指定自定义模板时，请务必确保模板文件已正确上传并命名。