R语言rmdformats包readthedown模板self_contained参数失效求助

可能原因及修复方案 #

1. rmdformats 1.0.4模板配置覆盖 #

rmdformats 1.0.4版本对readthedown模板的默认配置做了调整，可能直接覆盖了YAML中的self_contained设置。可以在YAML输出配置中显式指定模板的self_contained参数，同时关闭冗余文件生成选项：

output:
  rmdformats::readthedown:
    self_contained: true
    highlight: tango
    code_folding: show
    keep_md: false  # 禁止保留中间md文件，减少冗余

2. R 4.2.1的knitr行为变更 #

R 4.2.1附带的knitr版本对图片嵌入逻辑有调整，需手动强制图片嵌入HTML。在脚本开头添加knitr全局配置：

knitr::opts_chunk$set(
  fig.path = "",  # 取消图片路径前缀，避免生成独立文件夹
  fig.retina = 1,
  self.contained = TRUE
)

3. 模板资源引用的强制拆分 #

readthedown模板可能默认将CSS、JS等资源独立存放，即便设置self_contained也会生成_files文件夹。可以通过指定空的资源目录强制合并资源：

output:
  rmdformats::readthedown:
    self_contained: true
    lib_dir: ""  # 取消独立资源文件夹

4. 缓存干扰编译结果 #

旧脚本的缓存文件可能导致参数不生效，清理缓存后重新编译：

• 删除脚本目录下的_cache文件夹
• 在R控制台运行knitr::clean_cache()
• 重新执行编译操作

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