AnQiCMS 作为一款高效可定制的企业级内容管理系统，在模板文件的组织与使用上，遵循着一套清晰且灵活的规则。对于网站运营者和开发者而言，深入理解这些规定，不仅能确保网站前端内容的正确呈现，更能为您在内容布局和个性化定制上提供极大的便利。今天，我们就来一同揭开 AnQiCMS 模板文件的神秘面纱，看看它们究竟有着怎样的后缀和存放目录的奥秘。

首先，AnQiCMS 在模板文件后缀上的规定非常直观和友好，它统一使用 .html 作为模板文件的后缀名。这种选择不仅让熟悉前端开发的您倍感亲切，也与 Go 语言内置的模板引擎机制良好兼容，避免了学习额外特定后缀的门槛。您可以像编写普通 HTML 文件一样来构建您的页面结构和内容。当然，为了确保页面内容能正常显示，避免出现乱码，所有模板文件都必须统一采用 UTF-8 编码格式进行保存。

接下来是模板文件的存放目录。所有站点模板，无论您有多少套，都需要存放在 AnQiCMS 项目根目录下的 /template 文件夹中。这个 /template 目录，便是您所有设计作品的“家园”。为了更好地管理和区分不同的模板风格或版本，每一套独立的模板都需要拥有自己的专属子目录。例如，您可以创建 /template/default、/template/custom-theme 等子目录来分别存放不同的模板。

在每个模板的子目录内，都会有一个名为 config.json 的配置文件。这个文件就像模板的身份证，包含了模板的名称、版本、作者、创建时间以及最重要的模板类型（如自适应、代码适配、PC+手机独立站点）等元信息。系统会根据这个文件来识别和管理您的模板。

AnQiCMS 在模板目录和文件组织上提供了两种灵活的模式，您可以根据自己的偏好和项目复杂度选择其一。一种是文件夹组织模式，它将不同类型的页面模板分门别类地放入对应的子文件夹中。例如，首页模板可能位于 index/index.html，文档详情页模板位于 {模型table}/detail.html，文档列表页模板则在 {模型table}/list.html，而单页面详情页则在 page/detail.html 等。这种模式结构清晰，易于大型项目管理。另一种是扁平化文件组织模式，它将所有主要页面模板直接放在模板的根目录下，通过文件名来区分，例如 index.html、{模型table}_detail.html、guestbook.html 等。这种模式对于小型项目或偏爱简洁结构的开发者来说，可能更为便捷。无论选择哪种，只要保持内部一致性，AnQiCMS 都能良好支持。

值得一提的是，AnQiCMS 对于模板中需要用到的 CSS 样式、JavaScript 脚本、图片等静态资源，有着明确的存放规定。它们则有一个专门的归宿，那就是 /public/static/ 目录。这种将模板结构与静态资源物理分离的设计，有助于网站的组织结构清晰，便于缓存管理和维护。

AnQiCMS 的智能之处还在于它拥有一套默认的模板文件命名约定。这意味着，对于许多常见的页面类型，即使您不在后台进行额外的模板指定，系统也能自动识别并应用相应的模板。例如，文档详情页可能会默认查找 {模型table}/{文档id}.html 或 {模型table}/detail.html，文档列表页会查找 {模型table}/list-{分类id}.html 或 {模型table}/list.html，而单页面则可能对应 page/{单页面id}.html 或 page/detail.html。这种约定大大简化了模板的配置工作，提升了开发效率。当然，这种智能匹配并不是强制性的。AnQiCMS 充分理解运营者的个性化需求，您完全可以根据特定文档、特定分类或特定单页面的需求，在后台指定使用自定义名称的模板文件。例如，为“关于我们”页面创建一个 page/about.html，然后在后台页面管理中指定即可。

此外，对于需要支持移动端的模板（特别是代码适配或 PC+手机独立站点模式），AnQiCMS 还贴心地提供了 mobile/ 子目录。您只需在主模板目录下创建 mobile 文件夹，并在这个子目录下按照与主模板相同的结构重复一遍模板文件，就能轻松实现移动端内容的定制和展示。

总的来说，AnQiCMS 的模板文件命名和目录结构设计，充分考虑了易用性和灵活性。无论是统一的 .html 后缀、清晰的 /template 根目录，还是两种组织模式的选择，以及智能的默认命名约定和强大的自定义能力，都旨在让您更高效、更自由地管理和呈现您的网站内容。掌握这些核心规则，您的 AnQiCMS 网站运营之路将更加顺畅。

常见问题 (FAQ)

  1. 问：AnQiCMS 的模板文件后缀名可以修改成除了 .html 之外的其他形式吗？ 答：不可以。AnQiCMS 统一规定使用 .html 作为模板文件的后缀名。这是为了确保与 Go 语言内置模板引擎的兼容性，并维持系统内部处理的统一性。更改后缀名可能导致模板无法被系统正确识别和解析。

  2. 问：如果我有多套不同的网站模板风格，它们都应该如何存放？ 答：您所有的模板风格都应存放在 /template 这个根目录下。每套模板风格需要拥有自己的独立子目录，例如 /template/theme-a 和 /template/theme-b。每个子目录内还需要包含一个 config.json 文件，用于描述这套模板的基本信息。

  3. 问：AnQiCMS 是如何处理手机端和 PC 端模板的，我需要创建完全独立的手机模板吗？ 答：AnQiCMS 支持多种模板类型，包括自适应、代码适配和 PC+手机独立站点模式。在代码适配或 PC+手机独立站点模式下，您可以在主模板目录下创建一个名为 mobile/ 的子目录。在这个 mobile/ 目录中，您可以按照与主模板相同的目录结构和文件名来存放手机端专用的模板文件。系统会根据访问设备自动识别并加载对应的模板。