Bookdown构建书籍时TOC顶部添加logo未生效问题

• 核心问题是logo图片相对路径配置错误：_output.yml中TOC自定义区域填写的图片路径为docs/images/logos/logo-transparent.png，但bookdown构建gitbook站点时，最终生成的站点根目录就是预设的输出文件夹（默认是docs/），页面内的相对路径会以站点根目录为起点解析，额外加docs/前缀会导致浏览器实际查找docs/docs/images/logos/路径下的资源，无法找到对应logo文件，最终加载失败。你在index.Rmd中配置封面图用的images/logos/logo-transparent.png才是符合规则的正确相对路径写法。
• 可能存在构建缓存干扰：如果之前多次执行构建，输出目录留存了旧的静态文件，增量构建时可能不会全量替换配置，导致新修改的内容不生效。
• 你怀疑的index.Rmd中title: "Book"配置覆盖_output.yml设置的情况不存在：title字段仅控制书籍标题文本，和TOC自定义区块的渲染逻辑完全无关；只要index.Rmd的output字段没有编写和_output.yml冲突的TOC配置，两个文件的配置会自动合并，不会出现覆盖问题。
• 你提供的style.css样式规则没有问题，不需要调整。

• 修正_output.yml中的logo路径，删除多余的docs/前缀，修改后的TOC配置段如下：

bookdown::gitbook:
  css: style.css
  config:
    toc:
      before: |
        <li class="toc-logo"><a href="./"><img src="images/logos/logo-transparent.png"></a></li>
      after: |
        <li><a href="https://github.com/rstudio/bookdown" target="blank">Published with bookdown</a></li>

• 确认文件存放位置符合路径规则：
  • style.css需放在项目根目录，与_output.yml、index.Rmd处于同一层级
  • logo原文件需放在项目根目录下的images/logos/路径中，不要提前放入输出目录的子文件夹，构建过程bookdown会自动将根目录下的静态资源拷贝到输出目录的对应位置
• 清理缓存后全量构建：先手动删除输出目录（默认是docs/或_book/文件夹）内的所有旧文件，再执行Build Book命令完成全量构建，不要使用增量构建。
• 构建完成后可做简单校验：打开生成的站点页面，通过浏览器开发者工具检查侧边栏logo对应的img标签，确认src属性值为images/logos/logo-transparent.png，且输出目录对应路径下存在logo文件，即可正常显示。

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