RStudio中Quarto项目如何将.qmd文件存放至指定子目录

按照以下步骤配置即可实现所有.qmd源文件统一存放至指定子目录，无需在项目根目录保留index.qmd：

• 项目根目录仅保留_quarto.yml配置文件，所有.qmd源文件全部移动到目标子目录（例如示例中的scripts/qmd/路径）
• 修改根目录下的_quarto.yml，在project字段下明确声明渲染路径、输出目录，同时将book.chapters下的所有章节路径改为对应子目录的相对路径，参考配置如下：

project:
  type: book
  render:
    - scripts/qmd/*.qmd
  output-dir: docs

book:
  title: "你的书籍标题"
  author: "作者名"
  date: "2024/1/1"
  chapters:
    - scripts/qmd/index.qmd
    - scripts/qmd/intro.qmd
    - scripts/qmd/chapter1.qmd
    - scripts/qmd/summary.qmd

format:
  html:
    theme: cosmo

• 打开子目录下作为首页的index.qmd，在文件头部的YAML配置块中新增output-file: index.html参数，强制指定首页渲染后的输出文件名，解决Quarto无法识别子目录首页的报错问题，参考配置如下：

---
title: "书籍首页"
output-file: index.html
---

完成以上配置后直接点击Render按钮即可正常渲染，不会再抛出「Book contents must include a home page」错误。

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