如何在Quarto网站的多页博客文章中添加前后页导航

问题描述 #

我想把一篇包含8个步骤的教程拆分成多页博客，并且添加Quarto官方文档那样的页面底部“上一页/下一页”导航按钮。请问能不能通过.qmd文件的YAML配置实现？我自己尝试了下面的配置，但不确定是否正确：

---
title: "Tutorial as blog post"
page-navigation: true          <-???
---

回答 #

可以实现，但你用的page-navigation配置项写法不对。要在Quarto博客中添加页面前后导航，分两种场景配置：

• 全站启用导航按钮：修改站点根目录的_quarto.yml文件，在website节点下添加配置：

  website:
    page-navigation: true
  

• 仅特定教程页面启用：直接在对应.qmd文件的YAML头部嵌套配置：

  ---
  title: "教程步骤1：XXX"
  website:
    page-navigation: true
  ---
  

另外要注意页面顺序的组织，Quarto会根据以下规则生成前后导航的关联：

• 默认按文件名的字母/数字排序关联页面
• 也可以在_quarto.yml的website/sidebar/contents里手动指定页面顺序，确保教程步骤的连贯性：

  website:
    sidebar:
      contents:
        - tutorial-step-1.qmd
        - tutorial-step-2.qmd
        - tutorial-step-3.qmd
        # ... 依次添加剩余步骤页面
  

配置完成后，页面底部就会出现和官方文档一致的“上一页”“下一页”导航按钮了。

内容的提问来源于stack exchange，提问作者DanY