如何在 AnQiCMS 模板中显示文档的 Tag 列表或指定 Tag 的文档列表？

作为一名资深的安企CMS网站运营人员，我非常理解内容标签在网站内容管理和用户导航中的核心价值。高质量的标签策略不仅能帮助读者快速找到所需信息，更能有效提升网站内容的组织性和SEO表现。接下来，我将详细阐述如何在AnQiCMS模板中灵活运用标签，以展示标签列表或指定标签下的文档列表。

理解AnQiCMS中的内容标签

在AnQiCMS中，内容标签（Tags）是一种强大的内容关联工具，它独立于分类体系，允许您将不同模型或分类下的文档通过共同的关键词进行聚合。这种灵活性使得内容标签成为提升网站内容发现、构建相关内容网络以及优化用户体验的关键要素。安企CMS提供了专用的模板标签，让您能够轻松地在网站前端展示和管理这些标签及它们所关联的文档。

如何在模板中显示文档的Tag列表

当您希望在网站的某个区域，例如侧边栏、页脚或文档详情页，展示一个标签列表时，可以使用tagList标签。这个标签能够获取当前文档关联的标签，或者在指定itemId="0"参数时，获取整个站点（或指定分类下）的所有标签。

如果您想在文档详情页显示当前文档所关联的标签列表，代码会非常简洁：

<div class="document-tags">
    <strong>本文标签：</strong>
    {% tagList tags %} {# 默认读取当前文档ID的标签 #}
    {% for item in tags %}
        <a href="{{item.Link}}" title="查看所有与“{{item.Title}}”相关的文档" class="tag-item">{{item.Title}}</a>
    {% endfor %}
    {% endtagList %}
</div>

这段代码会遍历当前文档的所有关联标签，并为每个标签生成一个包含其标题和链接的<a>元素。

如果您希望在网站的非文档详情页面（例如首页、分类列表页或侧边栏）展示一个全局性的标签列表，例如“热门标签”或“标签云”，您可以通过itemId="0"参数来指定获取所有标签。同时，您还可以通过limit参数控制显示的标签数量：

<div class="global-tags-cloud">
    <h3>探索热门标签</h3>
    {% tagList tags with limit="30" itemId="0" %} {# 获取全站最多30个标签 #}
    {% for item in tags %}
        <a href="{{item.Link}}" title="探索更多关于“{{item.Title}}”的内容" class="tag-cloud-item">{{item.Title}}</a>
    {% endfor %}
    {% endtagList %}
</div>

在这里，limit="30"将最多显示30个标签，而