如何让 R Bookdown 中代码块内的超链接在新标签页中打开-html教程-PHP中文网

如何让 R Bookdown 中代码块内的超链接在新标签页中打开

本文介绍一种轻量、可靠的方法，通过引入外部 JavaScript 脚本，自动为 Bookdown 生成的 HTML 中所有代码块（）内的超链接添加 target="_blank" 属性，确保用户点击时在新标签页中打开，提升阅读与跳转体验。

本文介绍一种轻量、可靠的方法，通过引入外部 javascript 脚本，自动为 bookdown 生成的 html 中所有代码块（``）内的超链接添加 `target="_blank"` 属性，确保用户点击时在新标签页中打开，提升阅读与跳转体验。

在使用 bookdown::bs4_book 构建 R 文档（如技术手册或教学书籍）时，R 包名、函数名等常被自动渲染为指向 CRAN、rdrr.io 或 GitHub 的可点击超链接——但默认均在当前窗口跳转，易打断读者阅读流程。遗憾的是，Bookdown 和 knitr 并未提供原生选项来控制代码块内链接的 target 属性。

所幸，这一需求可通过前端脚本优雅解决。推荐使用 Yihui Xie 维护的轻量工具库 @xiee/utils 中的 external-link.min.js：它专为 R Markdown/Bookdown 场景设计，仅作用于 <code> 元素内部的 <a></a> 标签（避免误改正文链接），并自动添加 target="_blank" 与 rel="noopener noreferrer"（符合安全最佳实践）。

✅ 实施步骤

创建注入脚本文件
在项目根目录下新建 includes/after_body.html（路径可自定义，需与配置一致），内容如下：
```
<script src="https://cdn.jsdelivr.net/npm/@xiee/utils/js/external-link.min.js" defer></script>
```
配置 Bookdown 输出格式
修改 _output.yml（或 _bookdown.yml 中的 output: 部分），启用 includes.after_body：
```
output:
  bookdown::bs4_book:
    includes:
      after_body: "includes/after_body.html"
```
重新渲染书籍
运行 bookdown::render_book() 或点击 RStudio 中的 “Knit” 按钮即可生效。

? 效果验证

渲染后的 HTML 中，原代码块：

<code class="sourceCode R">
  <span class="kw"><a href="https://rdrr.io/r/base/library.html">library</a></span>
  <span class="op">(</span>
  <span class="va"><a href="https://github.com/duncanplee/CARBayes">CARBayes</a></span>
  <span class="op">)</span>
</code>

将自动变为：

<code class="sourceCode R">
  <span class="kw"><a href="https://rdrr.io/r/base/library.html" target="_blank" rel="noopener noreferrer">library</a></span>
  <span class="op">(</span>
  <span class="va"><a href="https://github.com/duncanplee/CARBayes" target="_blank" rel="noopener noreferrer">CARBayes</a></span>
  <span class="op">)</span>
</code>