作为一名深谙安企CMS运作之道的网站运营人员，我深知内容策略对用户体验和网站成长的核心价值。高质量的内容不仅需要精心创作，更需要智能地组织和呈现，确保读者能轻松发现更多他们感兴趣的信息。在文章详情页中，如何有效地展示与当前文档相关的列表，是提升用户黏性和页面浏览深度的重要一环。
现在，让我们深入探讨如何在 AnQiCMS 模板中实现这一功能，通过动态地展示相关内容，为您的读者提供无缝的阅读体验。
AnQiCMS 模板中的相关文档列表：提升用户体验的关键
在AnQiCMS中，为当前文档展示相关的文档列表，是优化用户阅读路径、增加网站内容曝光率的有效策略。当读者完成一篇内容的阅读后，如果能立即看到更多与之高度相关的信息，他们停留的时间会更长，页面跳出率会降低，这对于网站的整体数据表现和搜索引擎优化都大有裨益。
理解 AnQiCMS 如何定义“相关”文档
AnQiCMS 在确定“相关”文档时，提供了灵活且智能的机制，这使得我们能够根据实际运营需求，精准地呈现内容。默认情况下，系统会尝试基于当前文档的所属分类及其内容相似性来自动关联其他文档。这意味着，同一分类下的文章，或者在主题、关键词上有所重叠的文章，更容易被系统识别为相关内容。
除此之外，AnQiCMS 还允许我们更精细地控制相关文档的关联逻辑。例如，我们可以指定相关文档的匹配应主要依据关键词，或者完全依赖后台手动设置的关联关系。这种多维度的“相关性”定义，使得我们可以根据内容类型和运营目标，选择最合适的展现方式。
在模板中获取和展示相关文档
在 AnQiCMS 的模板系统中，获取并展示与当前文档相关的列表，主要依赖于强大的 archiveList 标签。这个标签是内容展示的核心工具，通过灵活的参数配置，可以满足多种内容调用需求，其中就包括了“相关文档”的调用。
值得注意的是，相关文档列表的调用通常发生在文档详情页中。这是因为“相关”的概念是相对于一个“当前文档”而言的，因此只有在具体的文档详情页面，系统才能准确地识别上下文，并调取出对应的关联内容。
要调用相关文档，我们需在 archiveList 标签中明确指定 type="related" 参数。这个参数告诉 AnQiCMS，我们所需获取的是与当前文档相关的列表。
以下是 archiveList 标签中用于控制相关文档行为的关键参数：
type="related": 这是启用相关文档列表功能的核心参数，必须设置。limit: 该参数用于控制显示相关文档的数量。例如，limit="5"将显示最多 5 篇相关文档。您也可以使用limit="offset,count"的格式，例如limit="2,5"表示从第 2 篇开始，获取 5 篇文档。like: 这个参数允许您更具体地定义相关文档的匹配规则：- 不设置
like参数（或留空）：系统将依据当前文档的分类和内容相似度，自动匹配最接近的相关文档。这是最常用的默认行为。 like="keywords": 当您希望相关文档主要依据当前文档的关键词进行匹配时使用。这要求您的文档在后台填写了准确的关键词。系统会尝试查找含有相同关键词的其他文档。like="relation": 如果您在 AnQiCMS 后台的文档编辑界面中，手动为当前文档设置了“相关文档”链接，那么使用此参数将只展示这些手动关联的文档。这提供了最高度的手动控制。
- 不设置
通过对这些参数的组合运用，您可以灵活地在前端模板中实现各种相关文档的展示逻辑。
代码实践：展示相关文档列表
现在，让我们通过一个实际的代码示例，来演示如何在 AnQiCMS 的文档详情页模板中，获取并展示相关文档列表。
假设我们正在编辑一个名为 detail.html 的文章详情页模板，我们希望在文章内容的下方，显示最多 6 篇相关文章，并优先显示缩略图和发布日期。
{# 假设这里是当前文档的内容区域结束 #}
<div class="article-content">
{# ... 当前文档的详细内容 ... #}
</div>
{# 相关文档列表区域 #}
<div class="related-articles-section">
<h2>相关推荐</h2>
<ul class="related-articles-list">
{# 使用 archiveList 标签获取相关文档。type="related" 是关键，limit="6" 控制数量 #}
{% archiveList archives with type="related" limit="6" %}
{% for item in archives %}
<li class="related-article-item">
<a href="{{ item.Link }}" title="{{ item.Title }}">
{% if item.Thumb %}
{# 如果有缩略图，则显示 #}
<img src="{{ item.Thumb }}" alt="{{ item.Title }}" class="related-article-thumb">
{% else %}
{# 没有缩略图时，可以显示一个默认占位图，或者不显示图片 #}
<img src="/static/images/default-thumb.jpg" alt="暂无图片" class="related-article-thumb">
{% endif %}
<h3 class="related-article-title">{{ item.Title }}</h3>
<p class="related-article-description">{{ item.Description|truncatechars:80 }}</p> {# 截取描述，避免过长 #}
<span class="related-article-date">发布于：{{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
</a>
</li>
{% empty %}
{# 如果没有任何相关文档，可以显示一条提示信息 #}
<li class="no-related-articles">
暂无更多相关文章推荐。
</li>
{% endfor %}
{% endarchiveList %}
</ul>
</div>
在上述代码中：
{% archiveList archives with type="related" limit="6" %}：这是核心调用，它将获取最多 6 篇与当前文档相关的文章，并将它们存储在archives变量中。{% for item in archives %}：我们遍历archives列表中的每一篇相关文章，每一篇文章的数据都可以在item变量中访问。{{ item.Link }},{{ item.Title }},{{ item.Description }},{{ item.Thumb }}：这些是item对象中可用的字段，分别代表文章的链接、标题、描述和缩略图。{% if item.Thumb %}：通过条件判断，确保只有当文章存在缩略图时才进行显示，否则可以提供一个默认图片。{{ item.Description|truncatechars:80 }}：使用过滤器截取描述内容，保持页面整洁。{{ stampToDate(item.CreatedTime, "2006-01-02") }}：利用stampToDate标签将文章创建时间戳格式化为易读的日期。{% empty %}：这是一个非常实用的循环控制结构，当archives列表为空时（即没有找到任何相关文档），它会显示empty块内的内容，避免页面出现空白。
优化相关文档的显示效果
仅仅调用出数据是不够的，作为网站运营人员，我们更应关注内容的呈现效果。
- 视觉一致性: 确保相关文档列表的样式与您网站的整体设计风格保持一致，避免突兀感。
- 信息精炼: 在列表中，标题和缩略图往往是最吸引人的元素。可以考虑截取描述文字，或者只显示简要信息，保持界面的清爽。
- 点击诱导: 使用清晰的标题和有吸引力的缩略图，鼓励用户点击查看更多内容。
- 测试与调整: 发布后，密切关注相关文档的点击率和用户行为数据。如果效果不佳，可以尝试调整
limit的数量，或改变like参数的设置，看看哪种匹配逻辑最能吸引您的读者。
通过以上步骤，您可以在 AnQiCMS 模板中灵活、高效地获取并展示与当前文档相关的列表，从而极大地提升用户在网站上的内容发现体验。
常见问题解答 (FAQ)
1. 为什么我的文档详情页中没有显示相关文档？
出现这种情况可能有几个原因。首先，请确保您在模板中正确使用了 {% archiveList archives with type="related" ... %} 标签，并且它位于一个文档详情页中，因为此标签需要当前文档的上下文信息。其次，检查是否存在真正“相关”的文档：如果当前文档所属的分类下没有其他文档，或者没有通过关键词、手动关联配置任何相关文档，列表自然会是空的。最后，确认 limit 参数没有设置得过小，导致即使有相关文档也未被显示。
2. 除了自动关联，我能否手动设置相关文档？
当然可以。AnQiCMS 提供了手动关联的功能。您可以在后台编辑每个文档时，找到“相关文档”设置项，手动选择与当前文档关联的其他文档。在模板中调用时，只需将 archiveList 标签的 like 参数设置为 like="relation"，AnQiCMS 便会优先显示这些您手动设置的关联文档。这为您提供了最大程度的控制，确保最重要或最