在AnQiCMS中构建和管理网站模板，首先要理解其独特的目录结构与文件组织方式。这不仅关乎网站的视觉呈现，更是影响网站性能、可维护性与未来扩展性的重要基石。一个清晰、合理的模板组织策略，能让内容运营和前端开发工作都事半功倍。

AnQiCMS模板体系概览

AnQiCMS采用类似Django模板引擎的语法，以.html作为模板文件后缀，这使得熟悉此类模板语言的开发者能够快速上手。它的设计理念是将前端模板文件与静态资源（如CSS、JavaScript、图片等）严格分离。所有模板文件都集中存放在根目录下的/template文件夹中，而模板所依赖的静态资源则统一放置在/public/static/目录，这种分离有助于优化资源加载，便于浏览器缓存，也利于集成CDN服务。

AnQiCMS的模板系统还具备高度的灵活性，支持多种网站模式，包括自适应、代码适配以及PC端与手机端独立站点模式。尤其值得注意的是，针对移动端的特殊需求，系统提供了专门的模板存放机制，确保了多设备下的良好用户体验。

核心目录结构解析：/template

/template是AnQiCMS模板的根目录，所有的模板主题都必须在此目录下创建独立的文件夹。每个模板主题文件夹内部都应包含一个config.json配置文件，用于描述该模板的基本信息和特性。

config.json文件是模板主题的“身份证”，其中包含以下关键信息：

  • name: 模板的显示名称，方便在后台识别。
  • package: 模板文件夹的名称，通常与目录名保持一致，仅支持英文字母和数字。
  • version: 模板的版本号，便于管理更新。
  • description: 模板的简要介绍。
  • author, homepage, created: 作者信息、主页和创建时间。
  • template_type: 定义模板的适配类型，例如0为自适应，1为代码适配，2为PC+手机。这决定了系统如何渲染页面。
  • status: 模板的启用状态，1表示正在使用，0表示未启用。

在每个模板主题目录下，AnQiCMS提供了两种主要的模板组织模式，以适应不同的项目需求和开发习惯。

1. 文件夹组织模式

这种模式强调模块化和结构化，通过创建子文件夹来分类管理不同功能的模板文件。

  • 公共代码文件： bash.html通常用于存放网站的公共头部、底部等每个页面都会继承的部分。
  • 代码片段目录： partial/目录用于存放可重用的代码片段，如侧边栏、面包屑导航、广告位等，便于在不同页面通过include标签复用。
  • 核心页面模板：
    • index/index.html: 网站的首页模板。
    • {模型table}/index.html: 特定内容模型（如文章、产品）的列表首页。
    • {模型table}/detail.html: 特定内容模型详情页的默认模板。
    • {模型table}/list.html: 特定内容模型分类列表页的默认模板。
    • comment/list.html: 评论列表页模板。
    • guestbook/index.html: 在线留言页模板。
    • page/detail.html: 单页面详情页的默认模板。
    • search/index.html: 搜索结果页模板。
    • tag/index.html: 标签首页模板。
    • tag/list.html: 标签下文档列表页模板。
  • 错误页面： errors/404.html, errors/500.html, errors/close.html分别用于展示404错误、500错误和网站关闭时的提示信息。
  • 移动端模板目录： mobile/目录，其内部结构与PC端模板目录类似，用于存放移动端独立模板文件，当网站设置为“代码适配”或“PC+手机端”模式时发挥作用。

此模式下，AnQiCMS还支持更细致的自定义模板命名，例如：

  • 文档默认自定义模板：{模型table}/{文档id}.html，允许为特定文档ID定制模板。
  • 文档列表默认自定义模板：{模型table}/list-{分类id}.html，允许为特定分类ID定制列表模板。
  • 单页面默认自定义模板：page/{单页面id}.html，允许为特定单页ID定制模板。 例如，如果需要为ID为“about-us”的“关于我们”单页定制模板，可以创建page/about-us.html。

2. 扁平化文件组织模式

这种模式将所有主要模板文件直接放置在模板主题根目录下，通过特定的命名约定来区分页面类型。文件命名通常采用{类型}_页面名.html的形式。

  • index.html: 网站首页。
  • {模型table}_index.html: 模型首页。
  • {模型table}_detail.html: 模型详情页。
  • {模型table}_list.html: 模型列表页。
  • guestbook.html: 留言页。
  • page.html, page-{单页ID}.html: 单页面及其定制模板。
  • errors_404.html, errors_500.html, errors_close.html: 错误页面。
  • 同样有mobile/目录用于移动端模板，其内部结构与扁平化PC端模式一致。

扁平化模式适用于项目结构较为简单，或者开发者偏好直接查看所有模板文件的情况。

高效显示的关键策略：模板组织与利用

要实现模板的高效显示和管理，不仅仅是按照规定放置文件，更要善用AnQiCMS提供的特性：

  1. 模块化与重用为先：

    • 将网站的通用元素（如导航、页脚、侧边栏）抽象为bash.html或partial/目录下的片段。通过{% include "partial/sidebar.html" %}这样的标签，可以在多个页面中复用这些代码，大幅减少重复开发量，提高维护效率。
    • 利用{% extends 'base.html' %}和{% block content %}实现模板继承，构建网站的整体布局“骨架”，然后针对不同页面填充或重写特定区域。这种方式确保了网站风格的一致性，同时也保持了局部内容的独立性。

  2. 定制化与灵活应用：

    • AnQiCMS允许在后台为文档、分类和单页面指定独立的模板文件。这意味着你可以根据特定内容的需求，设计独一无二的展示页面。例如，一个特殊的促销活动页面或一个产品落地页，可以通过在后台的相应内容编辑界面中填写自定义模板名称，来实现完全定制化的布局和功能。
    • 充分利用前面提到的自定义模板命名规则（如page/{单页面id}.html），可以直接在文件系统层面为关键页面预设定制模板，无需额外的后台配置。

  3. 响应式与多端适配：

    • 当选择“代码适配”或“PC+手机端”模板类型时，务必在模板主题目录下创建mobile/文件夹，并在其中按照PC端相同的组织模式放置移动端专用模板。AnQiCMS会根据访问设备自动选择加载相应的模板，实现优雅的多端适配。

  4. 静态资源优化管理：

    • 静态资源与模板文件的分离，使得前端开发者可以专注于优化CSS、JS和图片，例如进行压缩、合并、雪碧图处理等。通过将静态资源部署到CDN，可以显著提升网站的加载速度和用户体验。在模板中引用静态资源时，可以使用{% system with name="TemplateUrl" %}动态获取当前模板主题的静态资源路径，确保路径正确。

AnQiCMS模板引擎与标签的运用

AnQiCMS模板引擎提供了丰富的标签和过滤器来处理数据和控制逻辑。例如：

  • 变量输出： 使用{{ 变量名 }}来显示数据，如{{archive.Title}}显示文章标题。
  • 条件判断： {% if 条件 %}...{% endif %}用于根据条件显示不同内容。
  • 循环遍历： {% for item in 列表 %}...{% endfor %}用于遍历列表数据，如文章列表、导航菜单等。
  • 系统级标签： {% system %}、{% contact %}等用于获取网站名称、联系方式等全局配置。
  • 内容相关标签： {% archiveList %}、{% categoryDetail %}等用于获取文章列表、分类详情等内容数据。
  • 过滤器： |safe用于输出HTML而不被转义，|stampToDate用于格式化时间戳，|truncatechars用于截断字符串等，这些都极大地增强了模板的数据处理能力。

清晰的模板目录结构和合理的组织方式，是AnQiCMS网站高效运行、易于维护和灵活扩展的基础。通过充分理解并利用AnQiCMS提供的模板机制，内容运营者和前端开发者都能更高效地协同工作，共同打造出高质量的网站。

常见问题（FAQ）

Q1: 如何在AnQiCMS中创建一个全新的模板主题？ A1: 要创建一个全新的模板主题，您需要在AnQiCMS的/template目录下新建一个文件夹，例如命名为mytheme。然后，在这个新文件夹中创建一个config.json文件，并填写模板的基本信息（如名称、版本、作者等）。接着，根据您的设计需求，按照文件夹组织模式或扁平化模式，在mytheme文件夹内创建相应的模板文件（如index/index.html、partial/header.html等）。完成后，您可以在AnQiCMS后台的“模板设计”或“系统设置”中选择并启用您的新模板主题。

Q2: 如果我的网站需要PC端和移动端使用完全不同的设计，应该如何组织模板？ A2: 当您需要PC端和移动端采用完全不同的设计时，应在模板主题的config.json文件中将template_type设置为1（代码适配）或2（PC+手机）。在此基础上，您需要在您的模板主题目录下创建一个名为mobile/的子目录。所有用于移动端显示的模板文件，都应放置在这个mobile/目录下，并保持与PC端模板目录（或扁平化文件）相同的结构和命名约定。AnQiCMS会智能地根据用户设备的类型加载对应的模板，确保不同设备的用户都能体验到**的界面。

Q3: 我能否为某个特定的文章（例如“关于我们”）设置一个完全独立的模板文件，而不是使用默认的详情页模板？ A3: 当然可以。AnQiCMS提供了高度定制化的功能来满足这类需求。您可以在模板主题目录下为该文章创建一个特定的模板文件，例如，如果“关于我们”是单页面内容，您可以创建page/about-us.html。然后，在AnQiCMS后台编辑“关于我们”这个单页面时，找到“单页面模板”字段，填入您创建的模板文件名称（如about-us.html）。保存后，访问该单页面时，系统就会加载您指定的独立模板文件，而不是默认的page/detail.html。对于文章或产品详情页，也可以在对应的内容编辑页面通过“文档模板”字段进行类似设置。