如何编写Rmarkdown代码生成仅显示TOC选中项的HTML

要实现点击目录（TOC）仅展示对应章节内容、隐藏其他章节的效果，最简便的方式是使用bookdown的gitbook输出格式，而非普通Rmarkdown的HTML输出——bookdown原生支持这种单章节交互模式，无需额外复杂的自定义脚本。

具体实现步骤： #

1. 调整项目结构
   保持每个章节对应一个.Rmd文件的结构，同时新增两个配置文件：

   • _bookdown.yml：用于定义书籍的整体配置
   • index.Rmd：作为书籍的入口文件（可包含前言、目录说明等内容）

2. 配置_bookdown.yml
   示例配置如下，可根据需求调整参数：

   # 生成的书籍文件名
   book_filename: "my_custom_book"
   # 输出文件存放目录
   output_dir: "_book"
   # 指定章节文件顺序
   rmd_files: ["index.Rmd", "chapter1.Rmd", "chapter2.Rmd", "chapter3.Rmd"]
   # gitbook格式的TOC交互设置
   gitbook:
     toc_depth: 3          # TOC显示的层级深度
     toc_float: true       # TOC固定在页面左侧
     collapse_section: true # 点击章节时自动折叠子章节
   

3. 配置入口文件index.Rmd的YAML头
   在index.Rmd的顶部YAML区域，指定使用bookdown的gitbook输出：

   ---
   title: "我的文档标题"
   author: "你的名字"
   date: "`r Sys.Date()`"
   # 指定使用bookdown站点模板
   site: bookdown::bookdown_site
   output:
     bookdown::gitbook:
       config:
         toc:
           collapse: section # 仅展开当前选中的章节
           scroll_highlight: true # 滚动时高亮对应TOC项
         toolbar:
           position: static # 工具栏固定在顶部
   ---
   

4. 生成文档
   在R控制台运行以下命令生成最终的HTML书籍：

   bookdown::render_book("index.Rmd", "bookdown::gitbook")
   

   也可以在RStudio中点击右上角的「Build」按钮（需先将项目识别为bookdown项目）。

替代方案（纯Rmarkdown自定义JS） #

如果不想依赖bookdown，可通过自定义JavaScript实现该效果，但需要手动处理DOM交互：

1. 在Rmarkdown的YAML头中添加includes: in_header: custom.js
2. 创建custom.js文件，编写监听TOC点击、隐藏/显示章节的逻辑：

   // 监听TOC链接点击事件
   document.querySelectorAll('.toc a').forEach(link => {
     link.addEventListener('click', function(e) {
       e.preventDefault();
       // 获取目标章节的ID
       const targetId = this.getAttribute('href').slice(1);
       // 隐藏所有章节
       document.querySelectorAll('.section').forEach(section => {
         section.style.display = 'none';
       });
       // 显示目标章节
       document.getElementById(targetId).style.display = 'block';
       // 滚动到章节顶部
       window.scrollTo(0, document.getElementById(targetId).offsetTop);
     });
   });
   

   注意：这种方法需要确保章节的HTML结构与选择器匹配，且兼容性不如bookdown原生方案。

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