如何在 AnQiCMS 文档详情页显示文章所属的分类名称和分类链接？
在 AnQiCMS 中管理内容，我们常常希望访问者在浏览文档详情时，能清晰地看到这篇文章所属的分类名称，并且能够方便地点击分类链接，进一步探索同一分类下的更多内容。这不仅能优化用户体验，让网站结构更直观，也有助于搜索引擎更好地理解网站内容层级，提升SEO效果。
要在 AnQiCMS 的文档详情页实现这一功能，我们需要对模板文件进行一些简单的修改。AnQiCMS 采用类似 Django 的模板引擎语法，这使得内容调用和展示变得非常灵活。
定位模板文件
首先，您需要找到对应的文档详情页模板文件。通常情况下，AnQiCMS 的文档详情页模板会位于您当前使用的模板主题文件夹内的对应模型目录下。例如，如果是文章模型，您可能会在 /template/{您的模板名称}/article/detail.html 找到它。
核心思路：利用内置变量获取分类信息
在文档详情页中，AnQiCMS 会自动提供当前文档的详细信息，这些信息通常可以通过一个名为 archive 的全局变量直接访问。这个 archive 变量不仅包含文档标题、内容、发布时间等，也包含了其所属分类的相关数据。
要显示分类名称和分类链接，我们可以直接从 archive 变量中提取其 Category 属性。这个 Category 属性本身就是一个对象，包含了分类的 Title（分类名称）和 Link（分类链接）。
以下是具体的操作步骤和代码示例：
打开文档详情模板文件 使用您常用的代码编辑器，打开您网站对应的文档详情页模板，例如
detail.html。添加分类名称和链接的代码 在您希望显示分类名称和链接的位置，插入以下代码片段：
{%- if archive.Category %} <div class="article-category"> 所属分类：<a href="{{ archive.Category.Link }}" title="查看更多关于 {{ archive.Category.Title }} 的文章"> {{ archive.Category.Title }} </a> </div> {%- endif %}让我们来解读一下这段代码：
{%- if archive.Category %}：这是一个条件判断，用于检查当前文档是否成功关联到了一个分类。如果archive.Category存在，即文档有分类，则执行if块内的代码。这里的-符号是为了去除标签行产生的多余空行，使生成的HTML更简洁。<div class="article-category">...</div>：这是一个HTML结构，您可以根据自己的网站样式调整类名或标签。所属分类：：这部分是静态文本，您可以根据需要修改。<a href="{{ archive.Category.Link }}" title="...">...</a>：这是生成分类链接的核心。{{ archive.Category.Link }}：会输出该分类的URL地址，确保用户点击后能跳转到该分类的列表页。title="查看更多关于 {{ archive.Category.Title }} 的文章"：为链接添加了提示文字，提升用户体验和SEO友好性。{{ archive.Category.Title }}：会输出该分类的名称，这是用户在页面上看到的分类文字。
保存并刷新页面 保存模板文件后，刷新您的文档详情页。如果一切设置正确，您应该就能看到文章所属的分类名称，并且它是一个可以点击跳转的链接了。
拓展用法：使用 categoryDetail 标签
虽然直接通过 archive.Category 对象获取分类信息是最简洁的方式，但在某些特定场景下，比如您只知道分类ID，或者需要获取更多分类的自定义字段时，也可以使用 categoryDetail 标签。
例如，如果您想通过文档的 CategoryId 来独立获取分类详情，可以这样操作：
{% archiveDetail currentCategoryId with name="CategoryId" %} {# 获取当前文档的分类ID #}
{% if currentCategoryId %}
{% categoryDetail currentCategory with id=currentCategoryId %} {# 通过分类ID获取分类详情对象 #}
{% if currentCategory %}
<div class="article-category">
所属分类（另一种方式）：<a href="{{ currentCategory.Link }}" title="更多 {{ currentCategory.Title }}">
{{ currentCategory.Title }}
</a>
</div>
{% endif %}
{% endif %}
这段代码首先使用 archiveDetail 标签获取当前文章的 CategoryId，然后用这个ID作为参数传递给 categoryDetail 标签，从而获取完整的分类对象，进而取出其 Link 和 Title。
总结
在 AnQiCMS 中，显示文章所属的分类名称和链接是一个非常直接的过程。通过利用文档详情页中自动提供的 archive 变量，您可以轻松地访问其 Category 属性，并从中提取所需的分类名称和链接，快速实现这一功能，从而提升网站的可用性和内容组织的清晰度。
常见问题 (FAQ)
Q1: 为什么我在文档详情页添加了代码，但是分类名称或链接没有显示？
A1: 可能有几个原因。首先，请确保您的文档确实已经关联了一个分类。您可以在后台编辑文档时检查“所属分类”选项。其次，检查您是否正确地将代码添加到了正确的模板文件（例如 detail.html）中。另外，确保模板文件保存后，如果AnQiCMS开启了缓存，可能需要清除网站缓存（通常在后台有“更新缓存”功能）才能看到修改效果。
Q2: 我可以直接在文章列表中显示每篇文章所属的分类名称和链接吗？
A2: 当然可以。在文章列表模板（例如 article/list.html）中，您会使用 archiveList 标签循环遍历每篇文章。在循环体内，每篇文章的数据通常会绑定到一个变量（例如 item）。您可以像在详情页一样，通过 {{ item.Category.Title }} 和 {{ item.Category.Link }} 来获取并显示每篇文章的分类名称和链接。
Q3: 如何让分类名称显示为面包屑导航的一部分？
A3: AnQiCMS 内置了专门的 breadcrumb 标签来生成面包屑导航。您只需在模板的头部（通常是 bash.html 或 header.html，然后通过 extends 或 include 引入）使用 {% breadcrumb crumbs %} 标签，并遍历 crumbs 变量即可。AnQiCMS 会根据当前页面的URL结构，自动判断并生成包含分类名称在内的完整面包屑路径，无需您手动从 archive.Category 中提取。