R Quarto YAML中调用CSS文件路径报错的技术求助

问题原因 #

Quarto的YAML解析逻辑不支持在theme字段中直接使用!expr或R函数（比如here::here()），因为这个字段期望接收字符串路径，而非R表达式对象，因此会抛出类型错误。

可行解决方案 #

方案1：使用项目相对路径（推荐） #

既然主题文件在项目根目录，直接用相对路径即可，Quarto会自动基于项目根目录解析路径，团队成员只要保持项目结构一致，就能正确加载：

format:
  html:
    theme:
      - cosmo
      - my_custom_theme.scss

方案2：通过Quarto配置文件统一管理 #

在项目根目录创建_quarto.yml配置文件，集中定义主题路径，所有子文档都会继承这个配置，避免重复设置：

# _quarto.yml
format:
  html:
    theme:
      - cosmo
      - my_custom_theme.scss

团队成员只需确保各自的Quarto项目根目录结构与配置文件一致即可。

方案3：使用环境变量指定路径 #

如果主题文件不在项目根目录，可通过设置环境变量动态指定路径，在YAML中直接引用环境变量：

format:
  html:
    theme:
      - cosmo
      - ${QUARTO_THEME_PATH}/my_custom_theme.scss

然后在R的.Renviron文件中添加QUARTO_THEME_PATH="path/to/theme/dir"，或者在系统环境中配置该变量。

方案4：预处理YAML（进阶） #

如果必须用R动态生成路径，可以在渲染前用R脚本修改YAML内容：

# render_with_custom_theme.R
library(quarto)
library(yaml)
library(here)

# 读取原配置文件
config <- yaml::read_yaml("_quarto.yml")
# 替换为动态生成的主题路径
config$format$html$theme <- c("cosmo", here("my_custom_theme.scss"))
# 写入临时配置文件
yaml::write_yaml(config, "_quarto_temp.yml")
# 用临时配置渲染文档
quarto_render(config_file = "_quarto_temp.yml")
# 清理临时文件
file.remove("_quarto_temp.yml")

团队成员运行这个R脚本即可完成渲染，无需手动修改YAML。

关键注意点 #

• Quarto的theme字段仅支持字符串路径或预定义主题名，不支持R表达式，因此!expr here::here()这类写法无效。
• 若团队成员项目结构一致，优先用相对路径方案；结构有差异时，选择环境变量或预处理脚本更灵活。

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