在网站内容的海洋里，用户往往希望能够流畅地浏览相关信息，不希望在看完一篇精彩文章后，还需要返回列表重新寻找下一篇。这不仅影响用户体验，对网站的内部链接结构和搜索引擎优化（SEO）也大有裨益。AnQiCMS 充分考虑到了这一点，为内容详情页提供了方便快捷的导航功能，让用户能够轻松地在不同文档之间跳转。
AnQiCMS 的模板系统非常灵活，它借鉴了 Django 模板引擎的语法，让开发者和运营人员都能比较容易上手。我们所有的页面展示都离不开对模板标签的使用。为了在文档详情页实现“上一篇”和“下一篇”的链接，我们将主要用到 prevArchive 和 nextArchive 这两个专门为文档导航设计的标签。
当用户访问一篇文档的详情页时，这两个标签能够智能地识别当前文档在所属分类中的位置，并自动找到前一篇和后一篇文档的信息，包括它们的标题和链接。这样，我们就可以在页面的适当位置，比如文章底部，直接生成可点击的导航链接，引导用户继续阅读。
如何在文档详情页中添加上一篇和下一篇链接？
要实现这个功能，我们首先需要找到负责渲染文档详情的模板文件。通常，根据您网站的配置，这会在 /template/您的模板目录/{模型table}/detail.html 文件中。例如，如果是文章模型，可能就是 /template/default/article/detail.html。
打开这个 detail.html 文件后，您可以在文档内容的下方，或者任何您认为合适的位置，插入 prevArchive 和 nextArchive 标签。
这两个标签的使用方式非常直观。您只需要像下面这样将它们放置在模板中：
<nav class="document-pagination">
<div class="prev-document">
{% prevArchive prev %}
{% if prev %}
<a href="{{ prev.Link }}" title="{{ prev.Title }}">« 上一篇：{{ prev.Title }}</a>
{% else %}
<span>« 没有上一篇了</span>
{% endif %}
{% endprevArchive %}
</div>
<div class="next-document">
{% nextArchive next %}
{% if next %}
<a href="{{ next.Link }}" title="{{ next.Title }}">下一篇：{{ next.Title }} »</a>
{% else %}
<span>没有下一篇了 »</span>
{% endif %}
{% endnextArchive %}
</div>
</nav>
让我们来详细解释一下这段代码：
{% prevArchive prev %}和{% nextArchive next %}: 这是 AnQiCMS 提供的两个核心标签。它们会尝试获取当前文档的上一篇和下一篇文档的数据。我们将获取到的数据分别赋值给prev和next这两个变量。{% if prev %}和{% if next %}: 这是一个非常重要的判断。并不是所有的文档都有上一篇或下一篇，例如第一篇文档就没有上一篇，最后一篇文档就没有下一篇。为了避免出现空的链接或者不必要的显示，我们使用if标签来检查prev或next变量是否存在。如果存在，就显示对应的链接；如果不存在，我们就可以显示“没有上一篇了”或“没有下一篇了”这样的提示信息，从而提升用户体验。{{ prev.Link }}和{{ prev.Title }}: 当prev或next变量存在时，我们可以通过.语法轻松访问它们的属性，比如Link（文档的URL）和Title（文档的标题）。这些属性将直接用于构建<a>标签的href和文本内容。
通过这样简单的几行代码，您的 AnQiCMS 网站就拥有了专业且用户友好的文章导航功能。不仅让用户在浏览内容时更加顺畅，也能帮助搜索引擎更好地抓取和理解您网站的内容结构，对 SEO 产生积极影响。您可以根据自己网站的样式需求，为 nav 和 div 标签添加相应的 CSS 样式，让“上一篇”和“下一篇”链接在页面中更加美观和突出。
常见问题 (FAQ)
1. 为什么“上一篇”或“下一篇”链接有时候会显示“没有上一篇了”？
这通常意味着当前您正在查看的文档已经是该分类下的第一篇或最后一篇文档了。例如，如果一篇文档是您网站中发布的第一篇文章，那么它自然就没有“上一篇”文档可供跳转。AnQiCMS 模板中的 {% if prev %} 或 {% if next %} 判断会捕获这种情况，并显示预设的提示信息，以确保页面不会出现错误或空白链接，提供更好的用户体验。
2. 我能否自定义“上一篇”和“下一篇”链接的显示文本？比如显示“上一篇文章”而不是“上一篇”？
当然可以。在上面的代码示例中，您可以看到我们直接在 <a> 标签内部编写了文本，例如 « 上一篇：{{ prev.Title }}。您可以根据自己的喜好和网站的语言风格，自由地修改这些文本内容，比如改成 « 上一篇文章：{{ prev.Title }} 或者 Previous Post: {{ prev.Title }}，只需要调整模板文件中的文字即可。
3. 这些链接的排序逻辑是怎样的？它们会根据什么来判断哪篇是“上一篇”或“下一篇”？
prevArchive 和 nextArchive 标签默认是根据文档的发布时间（CreatedTime）和文档 ID 在其所属分类中的顺序来判断“上一篇”和“下一篇”的。通常，ID 越大代表文档发布越晚。所以，“上一篇”指的是在当前文档之前发布的（ID 更小或发布时间更早）的文档，而“下一篇”则是指在当前文档之后发布的（ID 更大或发布时间更晚）的文档。这种排序逻辑确保了用户能够按照内容的发布顺序进行浏览。