在安企CMS中，内容的组织和展示方式多种多样，其中文章的Tag标签功能，为用户提供了灵活的关键词关联和内容发现路径。无论您是想在文章详情页展示相关标签，还是希望创建一个聚合特定标签内容的页面，安企CMS都提供了直观且强大的模板标签来实现这些需求。
接下来，我们将一起探讨如何在AnQiCMS模板中有效地显示文章的Tag标签列表及其对应的文档。
一、文章Tag标签列表的展示
首先，我们来看看如何在模板中显示文章的Tag标签。这通常有两种主要场景：一是在单篇文章页面展示其所属的标签；二是在网站的侧边栏、底部或专门的标签索引页，展示全站或热门的标签列表。
1. 在文章详情页显示当前文章的标签
当用户阅读一篇具体文章时，您可能希望在文章底部或侧边栏显示与该文章相关联的标签。这有助于读者了解文章主题，并快速跳转到其他具有相同标签的文章。
安企CMS提供了 tagList 标签来获取文章的标签列表。在文章详情页的模板（通常是{模型table}/detail.html）中，tagList 标签会自动识别当前文章的ID。
您可以这样使用它：
<div class="article-tags">
<strong>标签：</strong>
{% tagList tags %}
{% for item in tags %}
<a href="{{ item.Link }}" title="{{ item.Title }}">{{ item.Title }}</a>
{% endfor %}
{% endtagList %}
</div>
在这段代码中：
- 我们使用
{% tagList tags %}来获取当前文章的所有标签，并将结果赋值给tags变量。 - 接着，通过
{% for item in tags %}遍历每个标签。 item.Link会自动生成指向该标签详情页的URL。item.Title则显示标签的名称。
这样，您的文章详情页就会优雅地展示出所有相关的标签，每个标签都可点击，方便用户探索更多内容。
2. 在网站侧边栏或专门页面显示热门/所有标签
如果您想在网站的非文章详情页面，比如首页侧边栏、博客列表页或一个独立的“标签云”页面，展示一定数量的标签，您可以再次使用 tagList 标签，并利用其 limit 参数来控制显示数量。
例如，显示最新的10个标签：
<div class="hot-tags-widget">
<h3>热门标签</h3>
<ul>
{% tagList tags with limit="10" %}
{% for item in tags %}
<li><a href="{{ item.Link }}" title="{{ item.Title }}">{{ item.Title }}</a></li>
{% endfor %}
{% endtagList %}
</ul>
</div>
这里，limit="10" 会确保只显示最新的10个标签。如果您希望展示所有标签，可以省略 limit 参数，或者将其设置为一个足够大的数字。需要注意的是，如果不是在文章详情页调用，且您想展示全站标签而非特定文章的标签，务必确保 itemId 参数没有被显式设置或被设置为 itemId="0"，以避免标签列表受当前页面内容ID的影响。
二、Tag标签下对应文档列表的展示
当用户点击一个标签后，通常会跳转到一个标签详情页，该页面会聚合所有与此标签关联的文章列表。这个页面在安企CMS中通常对应模板目录下的 tag/list.html 或 tag/index.html。
要在这个页面显示特定标签下的文档列表，我们需要使用 tagDataList 标签。这个标签专门用于获取指定标签下的文章数据。在标签详情页中，tagDataList 标签会自动识别当前页面的标签ID (tagId)。
以下是一个展示标签下文档列表并包含分页功能的示例：
{# 假设这是 tag/list.html 或 tag/index.html 模板 #}
<h1>标签：{% tagDetail with name="Title" %}</h1>
<p>{% tagDetail with name="Description" %}</p>
<div class="tag-documents">
{% tagDataList archives with type="page" limit="10" %}
{% for item in archives %}
<div class="document-item">
<a href="{{ item.Link }}" title="{{ item.Title }}">
{% if item.Thumb %}
<img src="{{ item.Thumb }}" alt="{{ item.Title }}" class="document-thumb">
{% endif %}
<h2>{{ item.Title }}</h2>
</a>
<p class="document-description">{{ item.Description }}</p>
<div class="document-meta">
<span>发布日期：{{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
<span>阅读量：{{ item.Views }}</span>
{% if item.CategoryId %}
<span>分类：{% categoryDetail with name="Title" id=item.CategoryId %}</span>
{% endif %}
</div>
</div>
{% empty %}
<p>该标签下暂时没有任何文章。</p>
{% endfor %}
{% endtagDataList %}
{# 分页导航 #}
<div class="pagination-container">
{% pagination pages with show="5" %}
<ul>
{% if pages.FirstPage %}
<li class="{% if pages.FirstPage.IsCurrent %}active{% endif %}"><a href="{{ pages.FirstPage.Link }}">{{ pages.FirstPage.Name }}</a></li>
{% endif %}
{% if pages.PrevPage %}
<li><a href="{{ pages.PrevPage.Link }}">{{ pages.PrevPage.Name }}</a></li>
{% endif %}
{% for pageItem in pages.Pages %}
<li class="{% if pageItem.IsCurrent %}active{% endif %}"><a href="{{ pageItem.Link }}">{{ pageItem.Name }}</a></li>
{% endfor %}
{% if pages.NextPage %}
<li><a href="{{ pages.NextPage.Link }}">{{ pages.NextPage.Name }}</a></li>
{% endif %}
{% if pages.LastPage %}
<li class="{% if pages.LastPage.IsCurrent %}active{% endif %}"><a href="{{ pages.LastPage.Link }}">{{ pages.LastPage.Name }}</a></li>
{% endif %}
</ul>
{% endpagination %}
</div>
</div>
在这段代码中：
<h1>标签：{% tagDetail with name="Title" %}</h1>用于显示当前标签的名称，tagDetail标签会自动获取当前页面的Tag ID。{% tagDataList archives with type="page" limit="10" %}获取与当前标签关联的文章列表。type="page"表示启用分页，limit="10"则设置每页显示10篇文章。{% for item in archives %}遍历每一篇文章。item.Link、item.Title、item.Description、item.Thumb分别对应文章的链接、标题、简介和缩略图。stampToDate(item.CreatedTime, "2006-01-02")是一个实用的函数，用于将时间戳格式化为可读的日期。{% categoryDetail with name="Title" id=item.CategoryId %}用于在文章列表中显示文章所属的分类名称。{% pagination pages with show="5" %}标签则用于生成分页导航，show="5"控制最多显示5个页码按钮。
通过这种方式，用户在点击任意标签后，便能清晰地看到所有相关联的文章，并能方便地进行分页浏览。
小结
安企CMS的标签系统为内容管理和用户体验提供了极大的灵活性。通过 tagList 和 tagDataList 两个核心标签，您可以轻松地在网站的各个位置展示文章标签，并构建功能完善的标签聚合页面。这种标签化的内容组织方式不仅有助于网站的SEO，更能提升用户在您网站上探索内容的乐趣和效率。
常见问题 (FAQ)
1. 如何在安企CMS后台创建和管理Tag标签？
您可以在安企CMS后台的左侧菜单中找到“内容管理”，然后点击“文档标签”。在这里，您可以新增标签，为每个标签设置名称、索引字母、自定义URL、SEO标题、关键词和简介。标签的创建非常灵活，不依赖于特定的分类或模型，可以跨内容模型进行关联，这使得它们在内容组织上比分类更加灵活。
2. Tag标签与文章分类有什么区别？我该如何选择使用？
文章分类（Category）通常用于内容的层级结构组织，具有明确的父子关系，每一篇文章必须归属于一个分类。它帮助用户和搜索引擎理解网站的整体结构。例如，一个“新闻”分类下可以有“国内新闻”和“国际新闻”的子分类。
Tag标签则更侧重于关键词关联和主题聚合，它没有严格的层级关系，一篇文章可以拥有多个标签。标签可以看作是文章的“横向”关联。例如，一篇关于“安企CMS教程”的文章，除了归属到“教程”分类，还可以打上“CMS”、“建站”、“Go语言”等标签。
选择使用时，如果您的内容需要清晰的结构和层级，请使用分类；如果您的内容需要灵活的关键词关联和多维度聚合，以方便用户发现相关主题，那么标签是更好的选择。两者通常结合使用，以达到**的内容组织效果。
3. 如何自定义Tag标签页面的URL结构以优化SEO？
安企CMS支持伪静态规则，允许您自定义