如何在Quarto Book侧边栏或导航栏添加数据文件下载按钮？

问题背景 #

在bookdown中，我们可以通过以下配置为gitbook添加包含PDF、HTML、CSV等多种格式的下载按钮：

---
bookdown::gitbook:
   download:
      - ["test.pdf", "PDF File"]
      - ["test.html", "HTML File"]
      - ["test.csv", "Data test.csv"]
---

但Quarto Book默认仅支持pdf、epub、docx格式的下载，需要在侧边栏添加.csv或.qs等数据文件的下载按钮。尝试通过sidebar的tools选项实现时，不清楚如何生成可直接触发下载的URL。

解决方案 #

直接在侧边栏tools配置中填写数据文件的相对路径即可，无需使用R代码生成URL，Quarto会自动将其解析为有效的下载链接。

修改后的完整配置示例 #

---
project:
  type: book
  
book:
  title: "Quarto Book"
  chapters:
    - index.qmd
    - intro.qmd
       
  sidebar:
    pinned: true
    tools:
      - icon: save
        menu:
          - text: Data XLSX
            url: data/mtcars.xlsx
          - text: Data CSV
            url: data/mtcars.csv
    
  repo-url: https://www.rstudio.com/   
  search: 
    location: sidebar
    type: textbox
  downloads: [pdf, epub]
    
format:
  html:
    theme: cosmo
---

注意事项 #

• 确保数据文件（如mtcars.xlsx、mtcars.csv）放置在项目的data目录下，路径需与配置中的url值完全匹配
• icon字段可使用Quarto支持的任意图标名称（示例中save对应保存图标）
• 如需添加更多格式（如.qs），只需在menu节点下新增条目，格式与CSV/XLSX一致即可

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