如何在bookdown的gitbook中按小节级别拆分HTML页面

问题背景 #

使用bookdown/rmarkdown构建gitbook，每个章节对应独立Rmd文件，包含多小节/子小节，希望实现浏览器仅加载当前小节的效果，但之前添加split_by: section配置未生效。

解决方法 #

核心问题是配置项的层级位置错误：split_by: section必须直接置于bookdown::gitbook:节点下，不能嵌套在config:子节点中。

正确的_output.yml配置示例

bookdown::gitbook:
  split_by: section
  # 其他gitbook配置项（如目录、样式等）可放在同一层级
  toc:
    collapse: section
    scroll_highlight: true
  config:
    toolbar:
      position: fixed

额外说明 #

• 确保每个Rmd文件内的小节用二级标题（##）、子小节用三级标题（###）划分，bookdown会自动按这些层级拆分生成独立的HTML文件
• 配置生效后，浏览器会仅加载当前点击的小节内容，而非整章内容，达到目标效果

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