如何让pkgdown网站显示符合预期的kableExtra主题表格？

问题根源 #

pkgdown自带的Bootstrap主题会直接覆盖kableExtra的原生样式，导致kable_classic()想要实现的booktabs效果被打乱——多余线条、居中失效都是这个原因。

修复步骤 #

1. 写自定义CSS干掉Bootstrap的表格默认样式
   先在你的vignette的RMD开头yaml里加个css引用：

   output:
     html_document:
       css: "custom_table.css"
   

   然后在vignette目录下新建custom_table.css，贴入以下代码：

   /* 清除Bootstrap给表格加的边框和背景 */
   .table {
     border-collapse: separate !important;
     border-spacing: 0;
     border: none !important;
     background-color: transparent !important;
   }
   /* 删掉所有单元格的边框 */
   .table td, .table th {
     border: none !important;
   }
   /* 只保留booktabs需要的线条：表头下粗线、表尾上粗线 */
   .table thead th {
     border-bottom: 2px solid #000 !important;
   }
   .table tfoot tr:last-child td {
     border-top: 2px solid #000 !important;
   }
   /* 强制表格容器居中 */
   .kable_wrapper {
     margin: 0 auto;
   }
   

2. 调整kableExtra代码确保booktabs生效
   生成表格时明确开booktabs = TRUE，同时关掉full_width避免表格被拉满：

   your_table %>%
     kable(booktabs = TRUE) %>%
     kable_classic(full_width = FALSE, html_font = "serif")
   

   要是需要加脚注之类的，直接链add_footnote()就行，不影响样式。

3. fig.align没用？直接用HTML容器硬居中
   要是RMD里的fig.align = "center"不管用，直接用HTML标签把表格包起来：

   cat("<div style='text-align: center;'>")
   your_table %>%
     kable(booktabs = TRUE) %>%
     kable_classic(full_width = FALSE)
   cat("</div>")
   

验证 #

重新跑pkgdown::build_site()，看目标vignette里的表格：

• 多余线条没了
• 表格居中了
• 样式和LaTeX booktabs一致

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