解锁AnQiCMS：个性化内容布局的秘密武器
在数字化时代，网站不仅仅是信息的载体，更是品牌形象和用户体验的核心。一个能够灵活定制内容显示布局的系统，对于中小企业、自媒体运营者乃至多站点管理者来说，无疑是提升运营效率和用户吸引力的关键。AnQiCMS以其强大的内容模型和灵活的模板机制，为我们提供了实现这一目标的所有工具。
今天，我们就来深入探讨如何在AnQiCMS中自定义不同类型内容的显示布局，让您的网站内容焕发独特的魅力。
理解AnQiCMS的内容架构：定制的基础
想要自定义布局，首先要理解AnQiCMS如何组织内容。它引入了“内容模型”的概念，这就像是为不同类型的内容（比如文章、产品、活动等）量身定制的骨架。每个内容模型都可以拥有自己独特的字段，例如，产品模型除了标题和内容外，还可以有“价格”、“库存”等字段，而文章模型可能只需要“作者”、“来源”。
当您在后台创建或编辑内容时，系统会根据您选择的内容模型，展示相应的可填写字段。这些字段就是您在前端模板中调用并展示数据的来源。这种灵活的内容模型设计，是实现个性化布局的第一步，它确保了您可以根据业务需求，为每种内容类型定义最合适的结构。
掌握模板文件与目录结构：布局的画布
AnQiCMS的模板文件统一使用.html后缀，存放在网站根目录下的/template文件夹中。每一套独立的模板都会在这个目录下拥有自己的专属文件夹，其中包含一个config.json文件，定义了模板的名称、类型（自适应、代码适配、PC+手机）等基本信息。
在模板文件夹内部，您可以采用两种组织模式：文件夹模式或扁平化文件模式。无论哪种模式，AnQiCMS都提供了一些默认的模板命名约定，例如：
- 首页：
index/index.html或index.html - 模型首页：
{模型table}/index.html或{模型table}_index.html(例如：article/index.html用于文章列表页，product/index.html用于产品列表页) - 文档详情页：
{模型table}/detail.html或{模型table}_detail.html(例如：article/detail.html用于文章详情，product/detail.html用于产品详情) - 文档列表页：
{模型table}/list.html或{模型table}_list.html(用于展示某个分类下的文档列表) - 单页面详情页：
page/detail.html或page.html - 标签页：
tag/index.html或tag_index.html(标签聚合页),tag/list.html或tag_list.html(标签下的文档列表) - 此外，还有
mobile/目录专门用于存放手机端模板。
理解这些默认命名规则至关重要，因为它们决定了系统在没有特殊指定时，会加载哪个模板来显示您的内容。
精细化控制：为特定内容指定专属模板
AnQiCMS的强大之处在于，它不仅支持默认的模板规则，还允许您为特定的分类、文档甚至单个页面指定独一无二的显示模板。这就像给您的内容穿上专属定制的服装，让它们在网站上独具一格。
当您在后台编辑文档分类时，在“其他参数”中可以找到“分类模板”和“文档模板”这两个选项。
- 分类模板： 如果您希望某个分类（例如“新闻中心”）的列表页与众不同，可以在这里填写一个自定义模板文件名（比如
article/news-list.html）。这样，当用户访问“新闻中心”分类时，系统就会加载这个特定的模板。您甚至可以选择“是否应用到子分类”，让该分类下的所有子分类也沿用这个模板样式。 - 文档模板： 同样，如果您希望某个分类下的所有文档都采用统一的详情页布局，可以在这里指定一个文档模板（例如
article/news-detail.html）。
对于单页面（如“关于我们”、“联系我们”），在页面编辑界面同样提供了“单页面模板”选项。如果您想让“关于我们”页面拥有一个特别的设计，可以创建一个如page/about.html的模板文件，并在这里指定它。
而对于单篇文档，在发布或编辑时，您可以在“其他参数”中找到“文档模板”，为这篇特定的文章或产品指定一个独立的模板，例如article/download.html，用于展示一个下载页面的独特布局。
通过这些后台设置，您可以轻松实现从全局到局部的布局定制，满足各种复杂的内容展示需求。
动态数据渲染：解锁模板标签的强大能力
自定义模板文件只是第一步，真正让内容动起来、实现千变万化布局的关键在于AnQiCMS提供的丰富模板标签。这些标签让您能够以编程的方式获取和展示网站的各项数据，并进行逻辑判断和循环操作。
AnQiCMS的模板标签语法类似Django模板引擎，变量使用双花括号 {{变量}}，逻辑控制标签使用单花括号和百分号 {% 标签 %}。
以下是一些核心标签及其应用场景：
全局信息获取：
system标签：获取网站名称、LOGO、备案号等全局配置，常用于页眉和页脚。contact标签：动态展示联系人、电话、地址、邮箱等联系方式，便于客户随时找到您。tdk标签：灵活设置页面的Title、Keywords、Description，是SEO优化的基石。
内容列表与详情：
archiveList标签：这是获取文章、产品列表的“万能标签”，您可以根据模型ID、分类ID、推荐属性、排序方式等多种条件，获取所需的文档列表。例如，在首页展示最新文章，或在分类页展示特定产品。archiveDetail标签：用于获取单篇文档（文章或产品）的详细信息，包括标题、内容、图片、自定义字段等。categoryList标签：获取分类列表，可以用来构建多级导航菜单或在侧边栏显示分类树。categoryDetail标签：获取单个分类的详情，如分类名称、描述、Banner图等，常用于分类页的顶部展示。pageList和pageDetail标签：分别用于获取单页面列表和单个单页面的详细信息，常用于构建“关于我们”、“联系我们”等独立页面。tagList和tagDetail标签：用于获取标签列表和单个标签的详情，方便您构建标签云或标签聚合页。
导航与关联：
navList标签：根据后台设置的导航类别，动态生成网站导航菜单，支持多级下拉。breadcrumb标签：自动生成面包屑导航，提升用户体验和网站结构清晰度。prevArchive和nextArchive标签：在文档详情页展示上一篇和下一篇文档，引导用户深入浏览。archiveList with type="related"：获取相关文档列表，提升内容之间的关联性。
逻辑控制与模块化：
if else endif标签：实现条件判断，根据不同条件显示不同的内容或样式。例如，判断是否有缩略图，决定是否展示图片。for empty endfor标签：循环遍历数组或列表，常用于展示文章列表、产品列表、图片组等。include标签：将页眉、页脚、侧边栏等公共代码片段引入到不同模板中，实现代码复用，提高维护效率。extends标签：实现模板继承，您可以创建一个基础骨架模板（如base.html），定义好公共结构，然后在其他页面模板