您好！作为一名资深的安企CMS(AnQiCMS)网站运营人员，我非常高兴能与您分享关于AnQiCMS模板制作的关键知识。在我的日常工作中，模板的合理规划和精准运用是确保内容高效展示、提升用户体验的基石。深入理解AnQiCMS模板的基本约定和目录结构规范，不仅能让我们更流畅地进行内容创作与发布，还能为网站的长期维护和优化打下坚实的基础。
接下来，我将详细阐述AnQiCMS模板制作所遵循的基本约定和目录结构规范，帮助您更好地掌握这一强大工具。
AnQiCMS模板制作的基本约定
在AnQiCMS中构建和定制模板，需要遵循一系列明确的约定，以确保系统能够正确解析并渲染您的设计。这些约定覆盖了从文件格式、命名规范到模板引擎语法等多个方面。
首先，所有模板文件都统一使用.html作为文件后缀名，并集中存放在网站根目录下的/template文件夹中。为了保持模板文件的纯净和易于管理，模板所依赖的样式表、JavaScript脚本以及图片等静态资源，都应该独立存放于/public/static/目录，而不是混入模板文件目录内部。
在模板的编写上，AnQiCMS采用了类似Django模板引擎的语法。这意味着您将使用双花括号来定义和输出变量，例如{{变量}}。对于更复杂的逻辑控制，比如条件判断和循环遍历，则使用单花括号和百分号包裹的标签，例如{% if 条件 %}。这些控制流标签通常需要成对出现，例如{% if ... %}需要对应的{% endif %}来结束。
变量的命名同样有其规范。在AnQiCMS模板中，变量名通常采用驼峰命名法则，并且每个单词的首字母都需要大写。例如，您会看到archive.Id、archive.Title等形式的变量，其中Id和Title都是以大写字母开头的。这样的命名约定有助于保持代码的一致性和可读性。
此外，模板文件的编码格式至关重要。AnQiCMS要求所有模板文件统一使用UTF-8编码。如果模板文件采用其他编码格式，页面在显示时可能会出现乱码，导致内容无法正常呈现。因此，如果您在Windows环境下编辑模板文件，请务必确保在保存时选择UTF-8编码格式。
AnQiCMS还支持多种模板类型，以适应不同的网站设计和访问需求。这包括了自适应模板类型、代码适配模板类型以及PC+手机端独立模板类型。当您选择代码适配模式或PC+手机端模式时，系统允许为移动端设备单独设计一套模板。这些移动端模板需要存放在主模板目录下的mobile子目录中，且其内部的目录结构和文件命名规则与PC端模板保持一致。
为了进一步提高模板的灵活性和便捷性，AnQiCMS还支持一些默认的自定义模板名称。这意味着只要您按照特定的命名格式创建了这些模板文件，系统便能自动识别并应用它们，无需在后台进行额外的配置。例如，文档的默认自定义模板可以命名为{模型table}/{文档id}.html，文档列表的默认模板是{模型table}/list-{分类id}.html，而单页面的默认模板则是page/{单页面id}.html。这种机制极大地简化了针对特定内容或分类进行个性化模板设计的流程。
AnQiCMS模板目录结构规范
理解AnQiCMS的模板目录结构是高效管理和开发模板的基础。所有的模板相关文件都以/template作为根目录，每一套独立的模板都需要在该目录下拥有自己的专属目录。
在一个模板目录内部，一个名为config.json的配置文件是必不可少的。这个文件承载着模板的关键信息，包括模板的名称、包名、版本、描述、作者、主页、创建时间、模板类型和使用状态等。虽然config.json中的字段大多是选填项，但它们对于模板的识别和管理至关重要。例如，name字段用于指定模板的显示名称，package字段代表模板的文件夹名称，而template_type则指明了模板的响应式行为（0为自适应，1为代码适配，2为PC+手机）。尤其值得注意的是，status字段（0为未启用，1为使用中）在一个AnQiCMS安装中只能有一套模板被设置为1，表示当前正在使用的模板。
AnQiCMS提供了两种主要的模板文件组织模式，以适应不同的开发习惯和项目规模：文件夹组织模式和扁平化文件组织模式。
在文件夹组织模式下，模板文件通过逻辑分组存放在不同的子目录中：
- 公共代码文件，如网站的页头和页脚，通常命名为
bash.html，供其他页面继承引用。 - 可复用的代码片段，例如侧边栏、面包屑导航等，则存放在
partial/目录中。 - 网站的首页文件通常是
index/index.html。 - 针对不同内容模型，会有一个模型首页，例如
{模型table}/index.html。 - 文档详情页可以是
{模型table}/detail.html，也可以是针对特定文档ID的{模型table}/detail-{文档ID}.html。 - 文档列表页类似，为
{模型table}/list.html，或针对特定分类的{模型table}/list-{文档分类ID}.html。 - 评论列表页通常是
comment/list.html，在线留言页为guestbook/index.html。 - 单页面详情页是
page/detail.html，或page/detail-{单页ID}.html。 - 搜索结果页、标签页和错误页也有其对应的默认位置，如
search/index.html、tag/index.html、tag/list.html、errors/404.html、errors/500.html以及errors/close.html。 - 正如之前所述，如果启用了移动端模板，其文件结构会在
mobile/目录下重复上述模式。
而扁平化文件组织模式则将文件直接放置在模板根目录下，通过文件名的前缀或后缀来区分其功能和所属模块。例如，首页是index.html，模型首页是{模型table}_index.html，文档详情页是{模型table}_detail.html，以此类推。这种模式简化了目录层级，但要求文件名更加明确和具有辨识度。
这两种组织模式都允许对部分模板文件进行自定义命名。这意味着，如果您需要为特定的文档、分类或单页面应用一个独一无二的模板，您可以在后台设置中指定一个自定义的模板文件名（例如page/about.html），只要该文件存在于您的模板设计包中，系统就能将其应用于对应的页面。这种高度的灵活性确保了AnQiCMS能够满足各种个性化的内容展示需求。
常见问题解答
1. 我可以在哪里找到AnQiCMS模板制作的详细标签使用文档？ 作为一个AnQiCMS运营人员，我深知模板标签是内容展示的核心。所有模板标签的详细使用方法和参数说明都可以在AnQiCMS官方文档的“模板制作” -> “标签和用法”以及“模板调用标签”章节中找到。这里包含了从系统设置到文档列表、分类详情等38种常用标签的全面指导，能够帮助您高效地构建动态内容页面。
2. 如果我在Windows系统上编辑模板文件，需要注意什么，以避免出现乱码？ 这是一个常见的问题。为了确保您的AnQiCMS网站在不同环境下都能正常显示，模板文件必须统一使用UTF-8编码。在Windows系统上编辑时，请务必将文件保存为UTF-8格式。大多数现代编辑器（如VS Code、Sublime Text、Notepad++）都支持在保存时选择编码格式，请确保您选择了正确的选项以避免页面乱码问题。
3. AnQiCMS支持哪些类型的模板显示模式？
AnQiCMS为满足多样化的网站需求，提供了三种主要的模板显示模式：自适应模板类型、代码适配模板类型和PC+手机端模板类型。您可以根据网站的受众和设计策略选择最合适的模式。其中，如果选择代码适配或PC+手机端模式，系统还支持为移动设备单独设计和存放模板，这些移动端模板应放置在主模板目录下的mobile子目录中。