你好，作为一名安企CMS的资深运营人员，我非常高兴能为你详细阐述如何自定义AnQiCMS模板的目录结构和文件命名规则。理解这些基础是高效管理和优化网站内容的关键。
AnQiCMS模板自定义概述
AnQiCMS作为一个以Go语言为基础的企业级内容管理系统，在模板定制方面提供了高度的灵活性。它采用类似Django模板引擎的语法，使得前端开发者可以轻松上手。为了确保网站内容的有效展示和管理，一套清晰、规范的模板目录结构和文件命名规则至关重要。这不仅有助于团队协作和后期维护，也能更好地支持SEO优化和多语言部署。所有自定义模板文件都将存放在系统的/template根目录下。
模板根目录与配置文件的建立
每一套定制模板都需要在/template目录下拥有一个独立的文件夹，这个文件夹的名称通常代表你的模板包名。在这个模板文件夹内部，必须包含一个config.json配置文件。这个文件是AnQiCMS识别和管理你的模板的关键，它包含了模板的基本元数据和类型设置。
config.json文件允许你定义一系列字段，尽管它们大多是可选的，但合理配置能提供更好的模板管理体验。例如，"name"字段用于指定模板的显示名称，"package"字段应与你的模板文件夹名称保持一致，仅支持英文字母和数字。"version"和"description"字段分别用于记录模板的版本信息和功能简介。"author"和"homepage"则标明了模板的作者及其网站。"created"记录了模板的创建时间。"template_type"字段是定义模板响应模式的关键，它有三个可选值：0代表自适应模板，1代表代码适配模板，2则表示PC端和手机端独立模板。"status"字段用于指示模板的启用状态，0为未启用，1为使用中，需要注意的是，在所有已安装的模板中，只能有一套模板的status值为1。
模板文件结构与命名规则
AnQiCMS的模板文件统一使用.html作为后缀，并且要求文件内容采用UTF8编码，以避免乱码问题。在组织模板文件时，AnQiCMS提供了两种主要的模式：文件夹组织模式和扁平化文件组织模式，你可以根据项目复杂度和个人偏好选择其中一种。
文件夹组织模式
这种模式下，模板文件通过创建子文件夹来分类组织，使得结构更加清晰。
- 公共代码片段： 通常将页头、页脚等公共继承部分命名为
bash.html。其他如侧边栏、面包屑等可复用的代码片段则存放在partial/目录中，例如partial/sidebar.html。 - 首页： 网站的首页模板通常命名为
index/index.html。 - 模型相关页面： AnQiCMS支持灵活的内容模型。针对不同的内容模型（如文章、产品），你可以创建以模型表名命名的文件夹，并在其中定义模型相关的页面：
- 模型首页：
{模型table}/index.html - 文档详情页：
{模型table}/detail.html。对于需要特别定制的文档，也可以使用{模型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。
- 标签首页：
- 错误页面和站点状态页：
- 404错误页：
errors/404.html。 - 500错误页：
errors/500.html。 - 站点关闭提示页：
errors/close.html。
- 404错误页：
- 手机端模板： 如果
config.json中template_type设置为代码适配或PC+手机端模式，你需要在模板根目录下创建一个mobile/子目录，并在其中按照与PC端模板相同的结构和命名规则创建手机端模板文件。
扁平化文件组织模式
对于结构相对简单或偏好文件集中管理的模板，可以采用扁平化文件组织模式，将所有模板文件直接放在模板根目录下，通过文件名前缀来区分页面类型。
- 公共代码片段： 与文件夹模式相同，
bash.html和partial/目录保持不变。 - 首页：
index.html。 - 模型相关页面：
- 模型首页：
{模型table}_index.html。 - 文档详情页：
{模型table}_detail.html。 - 文档列表页：
{模型table}_list.html。
- 模型首页：
- 评论列表页：
comment_list.html。 - 在线留言页：
guestbook.html。 - 单页面详情页：
page.html。对于特定单页面，可使用page-{单页ID}.html。 - 搜索页：
search.html。 - 标签相关页面：
- 标签首页：
tag_index.html。 - 标签文档列表页：
tag_list.html。
- 标签首页：
- 错误页面和站点状态页：
- 404错误页：
errors_404.html。 - 500错误页：
errors_500.html。 - 站点关闭提示页：
errors_close.html。
- 404错误页：
- 手机端模板：
mobile/目录的结构和文件命名规则与PC端保持一致。
自定义模板文件命名
除了上述默认和模型相关的命名规则外，AnQiCMS还支持更精细的自定义模板命名。这意味着你可以为单个文档、分类或页面创建完全独立的模板文件。例如，如果“关于我们”单页面需要一个独特的展示模板，你可以在page/目录下创建一个about.html文件，然后在后台设置该单页面调用about.html作为其专属模板。这种方式极大地提升了内容展示的灵活性。
模板中的语法与变量调用
AnQiCMS的模板引擎支持类似Django的标签标记方式。变量的输出使用双花括号{{变量}}，例如{{archive.Title}}来显示文章标题。控制结构（如条件判断和循环）则使用单花括号和百分号{% 标签 %}，并且需要明确的结束标签，例如{% if 条件 %} ... {% endif %}。变量名通常遵循驼峰命名法则，便于识别和调用。
静态资源文件的管理
模板中使用的样式文件（CSS）、JavaScript脚本和图片等静态资源，应独立存放在/public/static/目录。这样可以与模板文件分离，方便管理，并且可以配合CDN等服务进行优化，提升网站加载速度。
通过遵循这些目录结构和文件命名规则，你将能够构建出结构清晰、易于维护且功能强大的AnQiCMS网站模板，从而为你的读者提供卓越的内容体验。
常见问题 (FAQ)
问：我按照文档创建了模板文件，但网站前台却没有显示，我该如何排查问题？
答：首先，请确认你的模板文件夹内是否包含正确的config.json文件，并且其中的"status"字段是否设置为1，表示模板已启用。接着，检查模板文件本身是否采用UTF8编码，文件名和路径是否严格遵循了上述的命名规则。一个常见的错误是文件名拼写错误或大小写不匹配。此外，如果涉及模型、分类或单页面的特定模板，需要确认后台设置中是否已将对应的页面、分类或文档指定为使用你创建的自定义模板。最后，别忘了清除AnQiCMS的系统缓存和浏览器缓存。
问：为什么我的自定义模板没有自动应用，比如我创建了article/detail-10.html，但文档ID为10的文章仍然使用了article/detail.html？
答：AnQiCMS在解析模板时会有一个查找顺序。虽然{模型table}/detail-{文档ID}.html这种特定ID的模板优先级通常较高，但仍需确保该模板文件是存在的且内容正确。如果它没有被自动应用，请检查该文件是否存在语法错误导致解析失败，或者在后台该文档的编辑界面，是否手动指定了其他模板。在某些情况下，手动指定模板会覆盖自动匹配的默认规则。同时，再次确认config.json中的"template_type"是否与你的网站模式匹配，以及是否清除了相关缓存。
问：如果我在模板文件中使用了外部的JavaScript库或CSS框架，应该把它们放在哪里？
答：任何外部的或自定义的JavaScript脚本、CSS样式表以及图片等静态资源，都应该统一存放在AnQiCMS的/public/static/目录下。例如，你可以创建/public/static/css/存放CSS文件，`/public/static/js