在AnQiCMS中，为了实现网站页面或分类的个性化展示，我们不必总是从头编写复杂的逻辑，系统提供了一套非常灵活且直观的模板文件命名约定。这些约定允许我们通过创建特定名称的模板文件，让系统自动识别并应用，从而定制不同内容类型的显示方式。

首先，了解模板文件的基本结构是关键。所有的模板文件都存放在 /template 目录下，并统一使用 .html 作为文件后缀。例如，一套名为 “default” 的模板，其文件会位于 /template/default/ 之下。模板中用到的样式、JavaScript脚本和图片等静态资源，则建议单独存放在 /public/static/ 目录，以保持整洁和高效。

AnQiCMS的强大之处在于其支持的多种默认自定义模板名称约定。当系统在渲染页面时，会智能地查找是否存在符合这些特定命名规则的模板文件。如果找到了，就会优先使用它们，而无需我们在后台进行额外配置。

具体来说，这些命名约定包括：

  • 文档详情页的自定义模板：如果你希望为某一特定文档提供独一无二的展示效果，可以按照 {模型table}/{文档ID}.html 的格式来命名模板文件。例如，如果你的网站有一个 article（文章）模型，其中ID为 100 的文章需要特殊布局，那么你可以创建一个名为 article/100.html 的模板文件。当用户访问这篇ID为100的文章时，系统就会自动加载这个定制模板。对于产品模型，命名方式同样适用，如 product/201.html。
  • 分类列表页的自定义模板：为了让某个特定分类下的文章或产品列表拥有独特的风格，可以遵循 {模型table}/list-{分类ID}.html 的命名格式。假设你的 product（产品）模型中有一个ID为 5 的分类，你可以创建 product/list-5.html 来定制该分类的列表展示。这样，当用户浏览ID为5的产品分类页面时，就会看到这个专属的列表布局。
  • 单页面详情页的自定义模板：对于“关于我们”、“联系我们”这类常见的单页面，也可以进行个性化定制。其命名格式为 page/{单页面ID}.html。比如，ID为 1 的单页面（通常可能是“关于我们”），你可以创建 page/1.html 来定义其显示样式。

除了这些系统自动识别的命名约定之外，AnQiCMS还赋予了网站管理者更高级的自定义模板指定能力。这意味着，即使没有遵循上述命名规则，网站管理者仍然可以根据内容运营的需要，为特定的文档、分类甚至单个页面手动分配一个完全自定义的模板文件。

例如，你可能希望“关于我们”这个单页面采用一个特别设计的 about-us.html 模板，而不是默认的 page/{单页面ID}.html。你只需在 /template/你的模板目录/page/ 下创建 about-us.html，然后在后台编辑“关于我们”这个单页面时，将其“单页面模板”字段直接填写为 about-us.html。AnQiCMS在渲染该单页面时，就会优先使用你在后台指定的这个模板。同样的方法也适用于文档和分类的自定义模板设置。这种方式提供了极大的灵活性，能够处理各种个性化显示需求，例如为特定的营销活动页面、下载页面或合作伙伴介绍页定制专属模板。

在模板文件的组织方式上，AnQiCMS支持“文件夹组织模式”和“扁平化文件组织模式”两种，无论选择哪种，上述的命名约定都是通用的。此外，为了更好地适应移动设备访问，AnQiCMS允许我们在模板目录下创建 mobile/ 子目录。在这个 mobile/ 目录下，你可以按照与PC端相同的命名约定，为移动端设计独立的模板文件，从而在PC和移动设备上提供差异化的优质用户体验。

通过这些灵活的命名约定和后台指定机制，AnQiCMS极大地简化了模板定制的复杂性。它让网站运营者能够高效地为网站的不同内容类型、功能模块或特定页面实现高度定制化的显示，从而更好地吸引用户、优化用户体验，并服务于具体的业务目标。

常见问题（FAQ）

  1. 问：AnQiCMS中，我应该优先使用模板命名约定还是后台手动指定模板？ 答：这取决于你的定制需求。如果你只是想为某个ID固定的文档、分类或单页面提供专属模板，且不想在后台频繁操作，那么遵循命名约定（如 article/100.html）会更高效，系统会自动识别。但如果你的定制需求更灵活，比如一个分类下的部分文档需要一种模板，另一部分需要另一种，或者你想为某个页面指定一个通用但有别于默认命名的模板（如 promo-page.html），那么在后台手动指定模板文件会提供更大的控制力。通常，后台手动指定的优先级会高于默认的命名约定。

  2. 问：如果我创建了命名约定模板（例如 article/100.html），但又在后台编辑文章时，手动为ID为100的文章指定了另一个模板（例如 special-article.html），哪个模板会最终生效？ 答：在这种情况下，后台手动指定的模板 special-article.html 会覆盖命名约定模板 article/100.html。系统会优先处理你在后台内容编辑界面明确配置的模板文件路径。命名约定更多地作为一种便捷的默认机制，而后台配置则提供了更细粒度的控制和优先级。

  3. 问：AnQiCMS支持为移动端页面定制独立的模板吗？如何实现？ 答：是的，AnQiCMS完全支持为移动端页面定制独立模板。你只需要在你的当前模板目录下创建一个名为 mobile/ 的子目录，然后在 mobile/ 目录中按照与PC端相同的命名约定（例如 article/100.html 或 page/1.html）创建对应的移动端模板文件即可。当网站在“代码适配”或“PC+手机独立站”模式下运行时，系统会根据用户设备自动加载 mobile/ 目录下的相应模板。