如何为RMarkdown文件添加仿指定样式的侧边页面导航

Hey there! 想要给你的RMarkdown文档加一个和指定页面风格一致的侧边导航栏，我来给你几个实用方案，一步步帮你实现：

1. 先启用原生浮动侧边导航 #

RMarkdown的html_document自带了toc_float参数，开启后就能把目录放到侧边栏，这是最基础的实现方式。你只需要修改YAML配置：

---
title: "My Title"
author: "My Name"
date: "`r format(Sys.time(), '%d %B, %Y')`"
output:
  html_document:
    theme: united
    highlight: tango
    code_folding: hide
    df_print: paged
    toc: true
    toc_depth: 2
    toc_float:
      collapsed: false  # 设为true的话默认折叠目录，false则展开
      smooth_scroll: true  # 点击导航时平滑滚动到对应章节
---

2. 自定义CSS匹配目标页面样式 #

如果原生样式和你指定的页面不一致，就需要用自定义CSS来调整。你可以先通过浏览器开发者工具（按F12）查看目标侧边栏的样式属性（比如背景色、字体、边框、间距等），然后把这些属性复制到下面的CSS块里：

在你的RMarkdown文档开头（或者任意位置）添加这个代码块：

/* 自定义侧边导航栏样式，根据目标页面调整以下参数 */
#TOC {
  position: fixed;
  left: 0;
  top: 0;
  width: 280px; /* 侧边栏宽度，和目标页面一致 */
  height: 100%;
  overflow-y: auto;
  background-color: #f8f9fa; /* 背景色 */
  padding: 20px 15px; /* 内边距 */
  border-right: 1px solid #dee2e6; /* 右边框 */
  font-family: "Roboto", sans-serif; /* 字体 */
}

/* 调整主内容区域，避免被侧边栏遮挡 */
.main-container {
  margin-left: 300px; /* 要比侧边栏宽度大一点 */
  padding: 20px;
}

/* 导航栏标题样式 */
#TOC h2 {
  color: #2c3e50; /* 标题颜色 */
  font-size: 1.2em;
  margin-bottom: 15px;
  border-bottom: 1px solid #eee;
  padding-bottom: 8px;
}

/* 一级导航链接 */
#TOC a.toc-section-1 {
  color: #34495e;
  text-decoration: none;
  font-weight: 500;
  padding: 6px 0;
  display: block;
}

/* 二级导航链接缩进 */
#TOC a.toc-section-2 {
  color: #555;
  padding-left: 18px;
  font-size: 0.95em;
}

/* 鼠标悬停效果 */
#TOC a:hover {
  color: #2980b9;
  background-color: #e9ecef;
  padding-left: 5px;
  border-radius: 4px;
  transition: all 0.3s ease;
}

3. 用bslib灵活定制Bootstrap主题 #

如果你的目标页面用的是Bootstrap框架，可以用bslib包来更精准地匹配主题风格，还能动态调整：

首先安装包：

install.packages("bslib")

然后修改YAML配置，把主题换成bslib，设置和目标页面一致的主色调、字体等：

---
title: "My Title"
author: "My Name"
date: "`r format(Sys.time(), '%d %B, %Y')`"
output:
  html_document:
    theme:
      bslib:
        primary: "#2980b9"  # 主色调，和目标页面一致
        secondary: "#f8f9fa"  # 次要颜色
        base_font: {google: "Roboto"}  # 字体
        code_font: {google: "Fira Code"}
    highlight: tango
    code_folding: hide
    df_print: paged
    toc: true
    toc_depth: 2
    toc_float: true
---

这样调整后，侧边导航栏的风格就能和你指定的页面高度匹配啦！如果还有细节需要微调，再结合自定义CSS就行。

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