模型首页、文档详情页、文档列表页的模板文件默认命名规则是什么？

作为一名资深的安企CMS网站运营人员，我深知一套清晰、高效的模板命名规则对于网站内容的管理和用户体验至关重要。安企CMS在模板设计上提供了极大的灵活性，同时也制定了一套默认的命名约定，这对于我们快速构建和迭代网站页面非常有帮助。

在安企CMS中，所有的模板文件都以.html作为后缀名，并统一存放在系统根目录下的/template文件夹中。每个独立的模板集都会有自己的目录，并且需要包含一个config.json文件来定义模板的基本信息。模板所依赖的CSS、JavaScript、图片等静态资源，则建议集中管理在/public/static/目录，以确保清晰的结构和便捷的维护。

AnQiCMS为模板的组织提供了两种主要模式：文件夹组织模式和扁平化文件组织模式。这两种模式在命名上略有不同，但都旨在提供一致且易于理解的约定。

针对内容模型首页，这通常是展示某个内容模型下所有文档的概览页面。在文件夹组织模式下，其默认命名规则是{模型table}/index.html。例如，如果您的内容模型表名为article，那么文章模型的首页模板文件就是article/index.html。而在扁平化文件组织模式中，对应的命名规则则是{模型table}_index.html，即article_index.html。通过这种方式，系统能够清晰地识别并加载相应模型的主页。

对于文档详情页，这是展示单个文档完整内容的页面。在文件夹组织模式下，默认的通用模板文件是{模型table}/detail.html。此外，AnQiCMS还支持为特定文档ID定制模板，其命名规则是{模型table}/detail-{文档ID}.html，或者更普遍的{模型table}/{文档ID}.html。这意味着您可以为某个特殊文档提供一个完全独特的展示布局。在扁平化文件组织模式中，文档详情页的默认模板文件名为{模型table}_detail.html。虽然扁平化模式下未明确列出ID特定模板，但通常会遵循简洁的_detail.html作为通用详情页。

最后，是文档列表页，它用于展示某个分类下的文档列表。在文件夹组织模式中，默认的通用模板文件是{模型table}/list.html。如果需要为某个特定分类定制列表页，系统会查找{模型table}/list-{文档分类ID}.html。例如，分类ID为10的文章列表页可能是article/list-10.html。在扁平化文件组织模式中，文档列表页的默认模板文件名为{模型table}_list.html。这种约定使得我们可以轻松地为不同模型和分类定制列表页的展示方式。

理解并遵循这些默认命名规则，能够帮助我们更高效地进行模板开发和内容管理。同时，安企CMS也提供了灵活的自定义机制，允许我们在后台为特定内容（如单页面）指定独特的模板文件路径，进一步满足个性化的需求。这种结合了约定与灵活性的设计，正是AnQiCMS在内容运营中提供强大支持的体现。

常见问题 (FAQ)

1. 如果我为某个特定文档或分类创建了 ID 特定的模板文件，但该文件不存在，系统会如何处理？

AnQiCMS 会首先尝试查找 ID 特定的模板文件，如果该文件不存在，系统将自动回退到查找更通用的模板文件。例如，对于文档详情页，如果 {模型table}/detail-{文档ID}.html 不存在，系统会尝试使用 {模型table}/detail.html。对于文档列表页，如果 {模型table}/list-{文档分类ID}.html 不存在，系统会回退到使用 {模型table}/list.html。这种回退机制确保了即使没有为每个内容创建特定模板，网站也能正常显示，避免了页面错误。

2. {模型table}、{文档ID} 和 {文档分类ID} 等占位符具体指代的是什么？我如何获取这些信息？

{模型table} 指的是您的内容模型在 AnQiCMS 数据库中的表名，例如 article（文章模型）或 product（产品模型）。您可以在 AnQiCMS 后台的“内容管理”->“内容模型”中查看或设置每个模型的“模型表名”字段。 {文档ID} 指的是您在 AnQiCMS 后台发布的具体文档的唯一标识符 ID，在文档列表和编辑页面都可以看到。 {文档分类ID} 指的是您的文档所属的分类的唯一标识符 ID，在文档分类管理页面中可以查看到。 这些信息都是后台管理界面中可直接获取的。

3. 模板文件除了.html后缀，还需要注意哪些编码或存储要求？

所有模板文件统一编码为UTF-8格式。如果使用其他编码，可能会导致页面出现乱码，无法正常显示。特别是Windows用户在编辑模板文件时，请务必将其保存为UTF-8编码。同时，模板用到的样式、JS脚本、图片等静态资源，应独立存放在/public/static/目录，不应与模板文件混淆，以保持项目结构的清晰和维护的便利性。