在安企CMS中管理和展示大量内容，特别是需要按特定分类组织并进行分页显示时，了解其模板标签和结构是至关重要的。安企CMS凭借其灵活的模板引擎，让内容运营者能够轻松实现这些需求，为用户提供清晰、高效的浏览体验。
为何需要按分类筛选并分页显示？
想象一下一个拥有数百篇甚至数千篇文档的网站，如果所有内容都堆积在一个页面上，用户会感到无从下手，网站加载速度也会受到影响。通过按分类筛选，我们可以帮助用户快速定位到他们感兴趣的内容领域；而分页显示则能有效控制单个页面的内容量，提升加载速度，同时引导用户逐步浏览更多内容。这不仅优化了用户体验，对于搜索引擎优化（SEO）也大有裨益，有助于提高网站的抓取效率和权重分配。
安企CMS的核心标签与机制
安企CMS的模板系统借鉴了Django模板引擎的语法，使用{{变量}}输出数据，{% 标签 %}进行逻辑控制。对于文档列表的筛选和分页，主要会用到以下几个核心标签：
archiveList标签：这是获取文档列表的核心标签。它允许我们根据多种条件（如分类ID、模型ID、推荐属性等）来筛选文档，并设置返回列表的类型（是普通列表还是为分页准备的列表）。pagination标签：专门用于生成分页导航的标签。它会基于archiveList标签生成的分页数据，构建出“上一页”、“下一页”、“首页”、“尾页”以及页码数字等导航链接。categoryDetail标签：在需要显示分类名称、链接等详细信息时，此标签能帮助我们获取指定或当前分类的各项属性。
了解这些标签的功能和用法，是构建灵活文档列表页的基础。
实战：根据指定分类ID筛选并分页显示文档列表
接下来，我们将通过具体步骤和代码示例，展示如何实现根据指定分类ID筛选并分页显示文档列表。
第一步：确定模板文件位置
首先，你需要明确你的文档列表页将使用哪个模板文件。根据安企CMS的模板约定（参考 design-director.md），通常文档列表页的模板文件位于：
{模型table}/list.html：这是该模型下所有分类的通用列表页。{模型table}/list-{文档分类ID}.html：这是针对特定分类的定制化列表页。
例如，如果你要为文章模型（假设模型table为 article）下ID为 10 的分类创建一个专属列表页，你可以在 template/default/article/ 目录下创建一个名为 list-10.html 的文件。如果只是想为所有文章分类创建一个通用列表页，则使用 list.html。为了示例的通用性，我们假设是在 article/list.html 中进行操作。
第二步：使用 archiveList 标签获取文档列表
在你的列表模板文件中，使用archiveList标签来获取需要展示的文档。这里有几个关键参数：
type="page"：这是实现分页显示的关键指令。 它告诉安企CMS不仅返回文档数据，还要准备好分页所需的所有信息。categoryId="X"：用于指定你想要筛选的分类ID。例如，categoryId="10"将只显示ID为10的分类下的文档。如果你想在当前分类页面（例如通过点击导航进入的分类列表页）动态获取当前分类ID，通常不需要显式设置categoryId，archiveList会尝试自动读取当前页面的分类ID。如果你需要手动指定或从其他地方获取，例如在循环分类时，可以将其设置为categoryId=item.Id。moduleId="Y"：确保我们获取的是正确内容模型下的文档。例如，文章模型的moduleId通常是1，产品模型可能是2。你可以通过后台“内容模型”管理界面查看具体的ID。limit="10"：指定每页显示多少条文档。
{% archiveList archives with type="page" categoryId="10" moduleId="1" limit="10" %}
{# 文档列表内容将在这里循环展示 #}
{% endarchiveList %}
上述代码中，archives 是一个变量，它包含了根据指定条件筛选出的文档数组。
第三步：循环展示文档内容
获取到archives数组后，你需要使用for循环来遍历并展示每篇文档的详细信息。
在循环体内，item变量代表当前文档对象，你可以通过item.Title、item.Link、item.Description等属性来获取文档的各项数据。
{% archiveList archives with type="page" categoryId="10" moduleId="1" limit="10" %}
{% for item in archives %}
<div class="document-item">
<a href="{{item.Link}}">
<h3 class="document-title">{{item.Title}}</h3>
{% if item.Thumb %}<img src="{{item.Thumb}}" alt="{{item.Title}}" class="document-thumb">{% endif %}
<p class="document-description">{{item.Description}}</p>
</a>
<div class="document-meta">
{# 获取文档所属分类的名称和链接 #}
<span>分类：<a href="{% categoryDetail with name='Link' id=item.CategoryId %}">{% categoryDetail with name='Title' id=item.CategoryId %}</a></span>
<span>发布时间：{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
<span>浏览量：{{item.Views}}</span>
</div>
</div>
{% empty %}
<p class="no-content-message">当前分类下暂无文档。</p>
{% endfor %}
{% endarchiveList %}
请注意{% empty %}区块，当archives列表为空时，它会显示自定义的无内容消息，而不是空白。stampToDate过滤器用于将时间戳格式化为可读日期。
第四步：集成页面导航（分页）
在archiveList标签的endarchiveList之后，使用pagination标签来生成分页导航。pagination标签会自动关联最近的type="page"的archiveList生成的分页数据。
pagination标签常用的参数是show，它决定了在页码导航中最多显示多少个页码数字。
”`twig {% archiveList archives with type=“page” categoryId=“10” moduleId=“1” limit=“10” %}
{# 文档列表内容如上所示 #}
{% for item in archives %}
<div class="document-item">
{# ... 文档内容 ... #}
</div>
{% empty %}
<p class="no-content-message">当前分类下暂无文档。</p>
{% endfor %}
{% endarchiveList %}
{% pagination pages with show="5" %}
<ul class="pagination-list">
{# 首页链接 #}
<li class="page-item {% if pages.FirstPage.IsCurrent %}active{% endif %}">
<a href="{{pages.FirstPage.Link}}">{{pages.FirstPage.Name}}</a>
</li>
{# 上一页链接 #}
{% if pages.PrevPage %}
<li class="page-item">
<a href="{{pages.PrevPage.Link}}">{{pages.PrevPage.Name}}</a>
</li>
{% endif %}
{# 中间页码链接 #}
{% for page_item in pages.Pages %}
<li class="page-item {% if page_item.IsCurrent %}active{% endif %}">
<a href="{{page_item.Link}}">{{page_item.Name}}</a>
</li>
{% endfor %}
{# 下