安企CMS (AnQiCMS) 作为一个高效、灵活的内容管理系统，其强大的模板功能和内容模型为我们提供了极大的自由度，可以根据网站的实际需求，精细化地控制内容在前端页面的展示布局。要实现这一目标，我们需要深入理解安企CMS的模板引擎、内容模型以及内置标签的运用。

安企CMS 布局定制的核心要素

在安企CMS中自定义内容布局，主要围绕以下几个核心要素展开：

  1. 强大的模板引擎： 安企CMS采用类似Django的模板引擎语法，这使得模板制作变得直观且易于上手。通过双花括号 {{变量}} 调用变量，使用单花括号和百分号 {% 标签 %} 控制逻辑（如条件判断、循环），我们可以灵活地将后台数据呈现在前端。
  2. 灵活的内容模型与自定义字段： 安企CMS 的内容模型功能尤为强大，它允许我们根据业务需求灵活地定义各种内容类型，例如文章、产品、新闻等。每个内容模型都可以配置专属的自定义字段（如文章的“作者”、“来源”，产品的“价格”、“库存”等），这些自定义字段是实现个性化内容展示的关键。
  3. 多样化的模板文件与命名约定： 所有的模板文件都存放在 /template 目录下，并以 .html 为后缀。安企CMS 预设了一系列模板文件命名约定，例如 article/detail.html 用于文章详情页，product/list.html 用于产品列表页，page/detail.html 用于单页面详情。此外，它还支持为特定的文档ID、分类ID或单页面ID创建自定义模板文件，例如 article/detail-10.html 专门用于ID为10的文章详情页。这些命名规则和自定义功能为我们提供了极大的灵活性。
  4. 丰富的内置标签与过滤器： 安企CMS 内置了多达数十种模板标签和过滤器，用于动态获取和处理各类数据。例如，archiveList 标签用于获取文章或产品列表，archiveDetail 标签用于获取单篇内容详情，categoryList 和 categoryDetail 用于获取分类信息，pageDetail 用于获取单页面信息，还有 system 标签获取系统配置，navList 获取导航数据等。配合 for 循环标签和 if 条件标签，以及 safe、truncatechars 等过滤器，我们能够精确控制内容的输出格式和样式。

实战指南：分层定制你的网站布局

理解了核心要素后，我们可以按照“从宏观到微观”的思路，分层定制网站布局：

第一层：全局骨架——通用模板的搭建与继承

网站通常都有一些公共的结构，比如页头（Header）、页脚（Footer）和侧边栏（Sidebar）。在安企CMS中，我们可以通过模板继承 (extends) 和包含 (include) 来构建这些全局骨架。

  • 创建基础模板 (base.html)： 在 /template/你的模板目录/ 下创建一个 base.html 文件，作为网站所有页面的母版。在这个文件中定义HTML结构、引入公共CSS/JS，并使用 {% block 区域名称 %}{% endblock %} 标签来定义可替换的内容区域，例如 block title (页面标题)、block header (页头)、block content (主体内容) 和 block footer (页脚)。
  • 包含公共片段： 对于页头导航、侧边栏等在多个页面重复出现的独立模块，可以将其拆分为独立的模板片段（例如 partial/header.html、partial/footer.html），然后在 base.html 中通过 {% include "partial/header.html" %} 的方式引入。这样做有助于代码复用和维护。

第二层：模型与分类级——批量内容的布局定义

针对特定类型的内容（如所有文章）或特定分类下的内容，我们需要定义统一的布局规则。

  • 内容模型级模板： 安企CMS 会优先查找特定内容模型下的模板文件。例如，所有文章列表页默认会使用 article/list.html，所有产品详情页默认会使用 product/detail.html。你可以根据这些约定创建或修改这些模板文件，以实现模型层面的统一布局。
  • 分类级定制模板： 如果某个分类（例如“公司新闻”分类）下的内容需要与其它分类（例如“行业动态”）有所不同，你可以在后台编辑该分类时，在其“其他参数”中指定一个“分类模板”或“文档模板”。
    • 分类模板： 当你为某个分类指定了“分类模板”（例如 news_list.html），那么该分类及其子分类的列表页将使用这个自定义模板，而不是默认的 article/list.html。
    • 文档模板： 当你为分类指定了“文档模板”（例如 news_detail.html），那么该分类及其子分类下的所有文档详情页将使用这个自定义模板，而不是默认的 article/detail.html。 通过这种方式，你可以轻松实现不同分类内容群体的差异化展示。

在这些模板中，你将大量使用 archiveList、archiveDetail、categoryDetail 等标签来动态获取内容数据。例如，在一个文章列表页 (article/list.html) 中，你可以使用 {% archiveList archives with type="page" limit="10" %} 来获取文章列表，并用 for 循环遍历展示。

第三层：内容项级——个性化展示的精雕细琢

对于个别具有特殊展示需求的内容项，安企CMS也提供了灵活的定制方式。