在使用AnQiCMS搭建网站时，模板文件的组织与命名是实现灵活内容展示，提高网站维护效率和可扩展性的关键环节。一个结构良好、命名清晰的模板体系，不仅能让您轻松驾驭各种内容类型，还能为未来的功能扩展打下坚实的基础。
模板文件的存放与基础约定
AnQiCMS的模板系统采用类似Django的模板引擎语法，这让熟悉前端开发的您会感到十分亲切。所有模板文件都统一使用.html作为文件后缀，并集中存放在网站根目录下的/template文件夹中。而模板中涉及到的图片、JavaScript脚本和CSS样式等静态资源，则有专门的/public/static/目录来管理。这种分离式管理有助于保持模板代码的纯净，也方便静态资源的部署和优化。
在模板内容的书写上，AnQiCMS遵循一套直观的语法规则。变量的输出使用双大括号，例如{{变量名}}。而条件判断、循环控制等逻辑标签则使用单大括号和百分号包裹，如{% if 条件 %}，并且这些标签都需要成对出现，以{% endif %}或{% endfor %}结束。为了避免乱码，所有的模板文件都建议采用UTF-8编码格式。
模板目录的两种组织模式
AnQiCMS提供了两种主要的模板文件组织模式，您可以根据项目规模和个人偏好进行选择：
文件夹组织模式： 这种模式下，模板文件会按照其功能或内容类型，被分门别类地放置在不同的文件夹中。例如，首页模板可能在
index/index.html，文章详情页在article/detail.html，产品列表页在product/list.html。这种方式的优点是结构清晰，易于管理大型项目。- 公共代码： 像页头（header）、页脚（footer）这些几乎每个页面都会引用的部分，可以抽离出来放在一个公共文件，如
bash.html，或更具体的partial/header.html。 - 代码片段： 侧边栏、面包屑等可复用的UI组件可以存放在
partial/目录，方便通过{% include "partial/sidebar.html" %}这样的方式引入。 - 内容页面：
- 首页：
index/index.html - 模型首页（例如所有文章的首页）：
{模型table}/index.html(如article/index.html) - 文档详情页：
{模型table}/detail.html(如article/detail.html) - 文档列表页：
{模型table}/list.html(如article/list.html) - 单页面详情页：
page/detail.html(如“关于我们”页面)
- 首页：
- 特殊功能页： 评论列表页（
comment/list.html）、在线留言页（guestbook/index.html）、搜索页（search/index.html）、标签相关页面（tag/index.html,tag/list.html）、错误页（errors/404.html,errors/500.html）等。 - 移动端模板： 如果您选择“代码适配”或“PC+手机端”模式，可以在主模板目录旁创建一个
mobile/子目录，其内部结构与主模板目录保持一致，用于存放移动端专属的模板文件。
- 公共代码： 像页头（header）、页脚（footer）这些几乎每个页面都会引用的部分，可以抽离出来放在一个公共文件，如
扁平化文件组织模式： 这种模式将大部分模板文件直接放置在主模板目录的根层级，通过文件名来区分功能。它更适合内容结构相对简单、页面数量不多的中小网站。
- 公共代码和代码片段： 与文件夹组织模式相同，仍然建议使用
bash.html和partial/目录。 - 内容页面：
- 首页：
index.html - 模型首页：
{模型table}_index.html(如article_index.html) - 文档详情页：
{模型table}_detail.html(如article_detail.html) - 文档列表页：
{模型table}_list.html(如article_list.html) - 单页面详情页：
page.html
- 首页：
- 特殊功能页：
comment_list.html,guestbook.html,search.html,tag_index.html,tag_list.html,errors_404.html等。 - 移动端模板： 同样在
mobile/子目录中以扁平化方式存放。
- 公共代码和代码片段： 与文件夹组织模式相同，仍然建议使用
实现更精细的自定义内容展示
AnQiCMS的强大之处在于其支持高度定制化的模板应用。除了上述通用命名规则外，它还允许您针对特定的内容项（如某一篇文章、某个分类或某个单页面）使用完全独立的模板。
- 文档详情页的定制： 您可以为某一篇特定的文章或产品创建专属的详情模板。命名格式为
{模型table}/{文档id}.html。例如，如果您有一个文章模型（article），其中ID为10的文章需要一个独特布局，您可以创建article/10.html。系统在访问ID为10的文章时，将自动使用此模板。 - 分类列表页的定制： 同样，某个特定分类的列表页也可以拥有自己的模板。命名格式为
{模型table}/list-{分类id}.html。例如，product/list-5.html将应用于ID为5的产品分类列表页。 - 单页面详情页的定制： 对于“关于我们”、“联系方式”等单页面，您可以创建
page/{单页面id}.html或更具语义的page/about.html。在后台编辑单页面时，选择“文档模板”字段填写about.html即可。
这种灵活的命名机制，意味着您可以根据业务需求，为网站的任何一个细分内容单元提供定制化的用户体验，而无需修改核心逻辑，大大提升了内容展示的自由度。
将模板文件与后台内容关联
当您在文件系统创建了这些自定义模板后，下一步就是在AnQiCMS后台将它们与具体的内容关联起来。在后台编辑文章、分类或单页面时，您会看到一个“文档模板”或“分类模板”的选项，这里填写的正是您自定义的模板文件名（不包含路径，只填写如about.html这样的文件名）。系统会智能地根据您填写的名称，去您的模板设计包中查找并应用对应的模板。
总结
AnQiCMS的模板组织与命名策略旨在提供高度的灵活性和便捷性。通过理解文件夹组织模式和扁平化模式，并善用特定内容项的自定义命名规则，您可以根据网站的复杂程度和个性化需求，构建出既高效又富有创意的网站内容展示体系。合理规划模板结构，不仅能让您更快地实现设计意图，也能为网站的长远发展和后期维护带来极大的便利。
常见问题 (FAQ)
Q1: 我想为“关于我们”这个单页面设计一个完全独立的布局，应该怎么操作？
A1: 您可以在您当前使用的模板目录下，创建一个名为page/about.html的文件，设计好您“关于我们”页面的独特布局。然后在AnQiCMS后台，找到“页面资源”下的“页面管理”，编辑“关于我们”页面，在“单页面模板”字段中填写about.html并保存即可。系统会自动应用您自定义的模板。
Q2: 文件夹组织模式和扁平化文件组织模式各有什么优缺点，我该如何选择？ A2: 文件夹组织模式优点是结构层次清晰，适合内容多、功能复杂的网站，便于团队协作和模块化管理，但路径可能会稍长。扁平化模式优点是结构简单，文件查找直观，适合小型网站或个人博客，但随着文件增多可能显得杂乱。选择哪种模式主要取决于您的项目规模、内容复杂度以及您对文件管理的偏好。通常，建议从文件夹模式开始，因为它在项目扩展时更具优势。
Q3: 我创建了一个新的文章详情模板article/special-detail.html，并在后台文章编辑页面选择了它，但前台访问时仍然显示默认模板，这是怎么回事？
A3: 请检查以下几点：
- 文件路径是否正确： 确保
special-detail.html文件确实位于您当前使用模板目录下的article/子目录中。 - 文件名是否准确： 后台填写的模板名是否与文件名完全一致（包括大小写，如果系统区分大小写）。
- 模板是否已缓存： 尝试清除AnQiCMS的系统缓存，或刷新浏览器缓存，有时旧的模板信息会被缓存。 4