`prevArchive`和`nextArchive`标签如何在文档详情页显示上一篇/下一篇文档的链接和标题？
当我们在AnQiCMS搭建的网站上浏览内容时，一篇篇精心制作的文档为读者带来了价值。为了让读者的阅读体验更加流畅，并鼓励他们探索更多相关内容，在每篇文章的末尾提供“上一篇”和“下一篇”的导航链接显得尤为重要。这不仅能够有效引导用户在网站内进行深度浏览，提升页面访问量和用户粘性，对于网站的内部链接结构和SEO优化也大有裨益。
AnQiCMS作为一款注重用户体验和SEO友好的内容管理系统，自然为这种常见需求提供了简洁高效的解决方案。通过prevArchive和nextArchive这两个内置的模板标签，我们可以轻松地在文档详情页实现上一篇和下一篇文档的链接和标题展示。
了解prevArchive和nextArchive标签
这两个标签是AnQiCMS模板引擎中的特殊成员，它们被设计用于文档详情页面。它们的强大之处在于，无需复杂的参数配置，系统就能智能地根据当前文档在内容列表中的位置，自动识别并获取到相邻的上一篇或下一篇文档的数据。这意味着，无论你的内容分类如何组织，或者内容发布顺序如何，这两个标签都能准确地找到“前后”的文档。
prevArchive 标签用于获取当前文档的上一篇文档数据。
nextArchive 标签用于获取当前文档的下一篇文档数据。
它们的使用方式非常直观，通常以这样的结构出现：
{% prevArchive prev %}
{# 在这里使用prev变量来展示上一篇文档的信息 #}
{% endprevArchive %}
{% nextArchive next %}
{# 在这里使用next变量来展示下一篇文档的信息 #}
{% endnextArchive %}
在上面的代码片段中，prev和next是用户定义的变量名称，它们将分别承载上一篇和下一篇文档的完整信息，如ID、标题、链接、缩略图等。
在文档详情页实战应用
现在，我们来一步步看看如何在你的AnQiCMS文档详情页模板中添加这些导航链接。通常，文档详情页的模板文件会是{模型table}/detail.html，比如文章模型的article/detail.html。
首先，确保你正在编辑文档详情页的模板文件。
1. 基本的链接和标题展示
最常见的需求是显示上一篇/下一篇文档的标题及其链接。
<div class="archive-navigation">
<div class="prev-archive">
{% prevArchive prev %}
{% if prev %}
<a href="{{ prev.Link }}" title="{{ prev.Title }}">上一篇：{{ prev.Title }}</a>
{% else %}
<span>没有上一篇文章了</span>
{% endif %}
{% endprevArchive %}
</div>
<div class="next-archive">
{% nextArchive next %}
{% if next %}
<a href="{{ next.Link }}" title="{{ next.Title }}">下一篇：{{ next.Title }}</a>
{% else %}
<span>没有下一篇文章了</span>
{% endif %}
{% endnextArchive %}
</div>
</div>
在这个示例中：
- 我们用
{% prevArchive prev %}和{% nextArchive next %}定义了两个区域，分别获取上一篇和下一篇文档的数据，并赋值给prev和next变量。 {% if prev %}（或{% if next %}）是一个重要的逻辑判断。由于当前文档可能是所在分类的第一篇或最后一篇，这时可能就没有“上一篇”或“下一篇”文档。通过这个判断，我们可以优雅地处理这种情况，显示“没有上一篇文章了”或“没有下一篇文章了”，避免页面出现空链接或错误。{{ prev.Link }}和{{ prev.Title }}（以及next变量对应的字段）可以直接访问到文档的链接和标题。AnQiCMS会将文档对象的常用字段直接暴露给这些变量，方便你按需调用。
2. 进阶应用：添加缩略图
如果你的网站设计风格需要，你还可以在链接旁或链接内部显示上一篇/下一篇文档的缩略图，让导航更具视觉吸引力。
<div class="archive-navigation visual-navigation">
<div class="prev-archive">
{% prevArchive prev %}
{% if prev %}
<a href="{{ prev.Link }}" title="{{ prev.Title }}" class="flex-item">
{% if prev.Thumb %}
<img src="{{ prev.Thumb }}" alt="{{ prev.Title }}" class="nav-thumb">
{% endif %}
<span>上一篇：{{ prev.Title }}</span>
</a>
{% else %}
<span class="no-entry">没有上一篇文章了</span>
{% endif %}
{% endprevArchive %}
</div>
<div class="next-archive">
{% nextArchive next %}
{% if next %}
<a href="{{ next.Link }}" title="{{ next.Title }}" class="flex-item">
<span>下一篇：{{ next.Title }}</span>
{% if next.Thumb %}
<img src="{{ next.Thumb }}" alt="{{ next.Title }}" class="nav-thumb">
{% endif %}
</a>
{% else %}
<span class="no-entry">没有下一篇文章了</span>
{% endif %}
{% endnextArchive %}
</div>
</div>
在这个示例中，我们增加了{% if prev.Thumb %}（或{% if next.Thumb %}）的判断，确保只有当文档存在缩略图时才显示图片。{{ prev.Thumb }}会输出文档缩略图的URL地址。你可以根据实际情况选择Thumb（缩略图）或Logo（首图）。
优化与小贴士
- 样式定制： 上述代码仅提供了HTML结构，你可以通过CSS样式来美化这些导航链接，例如设置背景、边框、字体大小、图标等，使其与网站整体风格保持一致。
- 文案优化： 除了“上一篇/下一篇”，你还可以根据内容属性调整文案，例如“探索更多：[文章标题]”、“继续阅读：[文章标题]”等，增加吸引力。
- 显示位置： 最常见的放置位置是文档内容的下方。也可以考虑在侧边栏或者浮动按钮中加入这些导航，方便用户随时切换。
- 页面加载： 这两个标签在解析时对页面性能影响微乎其微，因为它们只查询相邻的两篇文章，不会造成大量数据加载。
通过灵活运用prevArchive和nextArchive标签，你的AnQiCMS网站将为读者提供更加无缝、便捷的阅读体验，同时提升内容的内部连接深度，为网站带来长期的运营价值。
常见问题 (FAQ)
1. 为什么我的“上一篇/下一篇”链接有时会显示“没有了”？
这是正常情况。prevArchive和nextArchive标签是根据当前文档在所属分类中的发布顺序来判断的。如果当前文档是该分类的第一篇文章，那么它就没有“上一篇”；如果它是最后一篇文章，那么就没有“下一篇”。在模板中，我们通常会使用{% if prev %}或{% if next %}这样的条件判断来处理这种情况，当没有相邻文档时，可以显示“没有了”或者其他自定义提示，避免出现空链接。
2. 我能自定义“上一篇/下一篇”显示的内容吗？比如除了标题还显示发布日期？
当然可以。prev和next变量实际上是完整的文档对象，它们包含了该文档的所有公开字段。除了Link和Title，你还可以访问CreatedTime（发布时间）、Description（简介）、Thumb（缩略图）等字段。例如，要显示发布日期，你可以使用{{ stampToDate(prev.CreatedTime, "2006-01-02") }}来格式化时间戳并展示。只需根据文档详情标签（archiveDetail）中列出的可用字段来调用即可。
3. 这些标签可以在非文档详情页使用吗？
prevArchive和nextArchive标签是专门为文档详情页设计的，它们的工作机制依赖于“当前文档”的上下文。如果在非文档详情页（例如首页、分类列表页或单页面）使用这些标签，它们将无法正确识别“当前文档”，从而可能无法获取到预期的上一篇或下一篇内容，甚至可能导致模板解析错误。因此，请确保仅在文档模型下的详情页模板（如article/detail.html或product/detail.html）中使用它们。