如何为特定的文章、分类或单页面设置独立的自定义模板，实现个性化内容展示？
在内容运营中，为网站的不同部分创建独特的视觉和功能体验，对于提升品牌形象、优化用户体验以及精准传达信息至关重要。安企CMS（AnQiCMS）深知这一点，提供了灵活的模板定制能力，让我们可以为特定的文章、分类乃至独立的单页面设置个性化的展示模板，从而实现内容的差异化呈现。
这项功能的核心在于，它允许我们摆脱网站全局模板的限制，针对性地设计和应用特定布局或样式，以更好地匹配内容主题或运营目标。例如，一篇重要的推广文章可能需要一个醒目的全屏排版，一个产品分类页可能需要特定的产品展示卡片布局，而一个“关于我们”的单页面则可能需要简洁专业的介绍模板。
安企CMS模板机制概述
安企CMS的模板系统基于类似Django的模板引擎语法，采用.html文件作为模板载体，并统一存放在网站根目录下的/template文件夹中。每个网站主题都有其独立的模板目录，例如/template/default/。这种结构清晰、易于管理，为我们后续的个性化模板设置奠定了基础。
要实现个性化内容展示，主要有两种方式：一是利用安企CMS内置的模板命名规则，让系统自动识别并应用；二是手动在后台为内容指定模板文件。
第一种方式：利用内置的模板命名规则（自动应用）
安企CMS具备一套智能的模板查找机制。如果我们按照特定的命名约定创建模板文件，系统将会在不进行任何额外设置的情况下，自动将其应用于对应的内容。这为一些常规的个性化需求提供了极大的便利。
以下是安企CMS支持的默认自定义模板命名格式：
- 文档（文章/产品）详情页：
{模型table}/{文档id}.html例如，如果你的文章模型表名为article，有一篇文章的ID是123，那么你可以创建一个名为article/123.html的模板文件。当访问这篇文章时，系统将自动使用这个模板。 - 文档列表页（分类页）：
{模型table}/list-{分类id}.html同样，对于ID为5的文章分类，你可以创建一个article/list-5.html的模板，系统便会用它来渲染该分类的文章列表页。 - 单页面详情页：
page/{单页面id}.html如果有一个单页面ID是10，那么创建page/10.html即可实现自动应用。
更进一步，我们还可以使用自定义的URL别名来命名模板文件，使模板名称更具可读性。例如，如果“关于我们”这个单页的自定义URL别名是about-us，那么可以创建一个page/about-us.html的模板，系统也会自动应用。
第二种方式：通过后台手动指定模板（灵活定制）
当我们的个性化需求无法通过命名规则满足，或者希望更精确地控制模板应用时，安企CMS允许我们直接在后台为文章、分类或单页面指定模板文件。
在进行任何后台设置之前，我们需要先在当前使用的模板主题目录下，创建好我们定制的.html模板文件。例如，如果你正在使用default主题，你可以在/template/default/目录下创建一个special-article.html或product-promo.html等文件。
接下来，我们将分内容类型介绍如何进行手动指定：
针对单篇文章或产品：
- 登录安企CMS后台，导航至“内容管理”模块，选择“文档管理”。
- 找到你希望应用自定义模板的文章或产品，点击其右侧的“编辑”按钮。
- 在编辑页面的底部，通常会有一个名为“文档模板”的字段。
- 在此字段中，输入你创建的自定义模板文件名，例如
special-article.html。请注意，这里只需要填写文件名，无需包含路径或文件后缀。 - 保存更改后，该文章或产品在前端访问时，就会使用你指定的
special-article.html模板进行展示。
针对特定分类及其下文档： 安企CMS在分类模板设置上提供了两层粒度的控制：
- 分类列表页模板：
- 在后台导航至“内容管理”模块，选择“文档分类”。
- 找到你希望应用自定义模板的分类，点击其右侧的“编辑”按钮。
- 在编辑页面中，有一个名为“分类模板”的字段。这个模板通常用于渲染该分类的列表页面，例如
list-with-sidebar.html。 - 这里还可以勾选“是否应用到子分类”选项。如果勾选，该分类下的所有子分类将继承此模板设置。
- 分类下文章/产品详情页模板：
- 在同一个分类编辑页面中，还有一个“文档模板”字段。
- 这个字段允许你为该分类下的所有文章或产品详情页统一指定一个模板。例如，如果你希望某个产品分类的所有产品都使用
product-detail-v2.html进行展示，可以在这里填写。 - 这个设置同样受到“是否应用到子分类”选项的影响，如果勾选，子分类下的文档也将继承此模板。
通过这两种模板设置，我们可以实现对分类页和其下文档详情页的双重个性化控制。
- 分类列表页模板：
针对单页面：
- 登录安企CMS后台，导航至“页面资源”模块，选择“页面管理”。
- 找到你希望应用自定义模板的单页面，点击其右侧的“编辑”按钮。
- 在编辑页面的底部，会有一个名为“单页面模板”的字段。
- 在此字段中，输入你创建的自定义模板文件名，例如
about-us-style.html。 - 保存更改后，该单页面在前端访问时，将使用你指定的
about-us-style.html模板进行展示。
模板文件放置与结构
所有自定义模板文件都应放置在你当前使用的主题目录下。例如，如果你的主题文件夹是default，那么你的模板文件路径应为/template/default/。你可以在这个目录下直接放置special-article.html，也可以根据内容模型或其他逻辑创建子目录，如/template/default/article/special-article.html。
安企CMS鼓励模块化设计，你可以创建partial/目录存放可复用的代码片段（如侧边栏、面包屑导航），或创建bash.html作为公共头部和尾部，通过{% include "partial/header.html" %}或{% extends "base.html" %}等标签来复用代码，保持模板的整洁和高效。
设计自定义模板时的注意事项
- 从现有模板开始： 最简单的方式是复制一份现有（例如
article/detail.html）的模板文件，然后在此基础上进行修改。这样可以确保你拥有一个功能完整且结构正确的起点。 - 熟悉模板标签： 安企CMS提供了丰富的模板标签（如
archiveDetail、categoryDetail、system等），用于获取各种数据。在自定义模板中，你需要灵活运用这些标签来展示所需的内容。例如，使用{{archive.Title}}来显示文章标题，或者{% archiveList ... %}来调用相关文章列表。 - 确保文件存在且命名正确： 无论是自动应用还是手动指定，都必须确保模板文件实际存在于正确路径下，并且文件名和大小写与设置或命名规则完全匹配。
- 测试与调试： 每次修改模板后，务必在前端访问对应的页面进行测试，确认显示效果符合预期。如果遇到错误，可以检查后台日志或前端页面的报错信息进行排查。
通过以上方法，你可以充分利用安企CMS的模板定制能力，为网站的每一个内容模块