AnQiCMS作为一个灵活高效的内容管理系统，在内容展示上提供了强大的模板定制能力。要充分利用AnQiCMS的这一优势，了解其模板文件的后缀和存储位置至关重要。这不仅能帮助您更高效地进行网站设计，也能在遇到问题时更快地定位和解决。

首先，AnQiCMS的模板文件统一使用.html作为后缀。这意味着您创建或编辑的所有模板文件都应该保存为HTML格式。这些.html文件集中存放在网站根目录下的/template文件夹中。/template就是AnQiCMS识别和加载模板的“大本营”。

为了更好地管理不同主题或样式的模板，AnQiCMS允许您创建独立的模板套件。每个模板套件都在/template目录下拥有自己的专属子文件夹，比如/template/default（系统默认模板）或您自定义的/template/my_custom_theme。每个套件文件夹内部，还需要包含一个config.json文件，用来描述这个模板套件的基本信息，例如模板名称、版本、作者以及它所支持的网站类型（自适应、代码适配或PC+手机独立站）。

值得注意的是，模板文件本身只包含结构和逻辑。而模板中会用到的样式表（CSS）、JavaScript脚本、图片等静态资源，则不直接放在模板套件文件夹内。它们被统一管理在网站根目录下的/public/static/目录中。这种分离有助于保持模板文件的整洁，并优化静态资源的加载。

AnQiCMS在模板文件的组织上提供了两种模式，以适应不同开发者的习惯：

一种是文件夹组织模式。在这种模式下，模板文件会按照功能或内容类型进一步细分到子文件夹中。例如，首页模板可能位于index/index.html，文章详情页模板可能在archive/detail.html。这种方式结构清晰，便于大型网站管理。

另一种是扁平化文件组织模式。顾名思义，这种模式下，大部分常用模板文件会直接放在模板套件的根目录下，通过文件名来区分其用途，例如首页模板是index.html，文章详情页是archive_detail.html。这种方式对于小型网站或个人博客可能更简洁。

不论采用哪种模式，AnQiCMS都支持一套标准的文件命名约定，以便系统自动识别并应用。例如，bash.html常用于定义公共头部和底部，partial/目录则存放侧边栏、面包屑等可复用代码片段。对于特定的内容，AnQiCMS还支持更精细的模板指定：

  • 模型与分类页面：您可以为文档详情页、列表页定义默认模板，例如{模型table}/detail.html或{模型table}_detail.html。AnQiCMS甚至支持为某个特定ID的文档或分类指定模板，格式如{模型table}/{文档id}.html（针对文档）或{模型table}/list-{分类id}.html（针对列表）。
  • 单页面：对于“关于我们”、“联系我们”这类单页面，可以有page/detail.html作为默认模板，也可以为特定单页（如ID为10的页面）创建page/{单页面id}.html的专属模板。
  • 错误页面：常见的errors/404.html和errors/500.html分别用于显示404和500错误页面，errors/close.html则用于网站关闭时的提示页面。
  • 手机端模板：如果您的网站需要支持独立手机站或代码适配，只需在模板套件目录下创建一个mobile子文件夹，并在其中按照上述两种模式之一，重复PC端模板的目录结构和文件命名即可。AnQiCMS会根据访问设备自动加载相应的手机端模板。

除了这些约定，您还可以在后台内容管理中，为特定的分类、文档或单页面手动指定模板文件。例如，如果您为某个文档创建了一个特殊的download.html模板，只需在后台编辑该文档时，将其模板字段设置为download.html，AnQiCMS便会加载该文件进行渲染。

这种灵活的文件后缀和存储策略，结合清晰的命名约定，让AnQiCMS的模板系统既强大又易于管理。它确保了网站性能，同时赋予开发者极大的自由度来定制界面，满足多样化的展示需求。

常见问题（FAQ）

  • Q1: 模板文件除了.html后缀，是否支持.tpl或.twig等其他后缀？ AnQiCMS的模板系统设计上是统一使用.html作为模板文件后缀的。虽然其语法类似Django模板引擎，但为了保持系统的一致性和易用性，建议您遵循这一约定，所有模板文件都以.html结尾。

  • Q2: 如果我希望为同一个页面（例如文章详情页）根据不同的条件（比如用户角色或文章类型）加载不同的模板，AnQiCMS支持吗？ 是的，AnQiCMS支持这种定制需求。除了系统默认的命名约定外，您还可以在后台为特定的内容（如分类、文档或单页面）手动指定模板文件名。例如，您可以为VIP用户内容创建archive/vip_detail.html模板，并在后台将相关VIP文章的“文档模板”字段设置为vip_detail.html。

  • Q3: 模板中使用的CSS、JavaScript和图片等静态资源，放在/public/static/目录后，如何在模板中正确引用它们？ 在模板中引用这些静态资源时，您可以使用相对路径或者结合系统标签来构建正确的URL。通常情况下，您可以直接使用{% system with name="TemplateUrl" %}这个标签来获取当前模板套件下的静态资源根路径，然后在其后加上您的资源路径，例如<link href="{% system with name="TemplateUrl" %}/css/style.css" rel="stylesheet">，或者使用类似于/static/img/logo.png这样的相对根路径来引用。