yaml - R Markdown 文档中 YAML 列表的处理不一致(与加载 LaTeX 包有关)

Question

我想使用 R Markdown 生成一个利用某些 LaTeX 包的文档。有时，我想将 Rmd 文档呈现为 PDF。在其他时候，我想将其呈现为 HTML。

我想通过 extra_dependencies 选项加载包，而不是通过 includes 或 header-includes 选项。一些 LaTeX 包应该加载选项。其他人不应该。

当我将 Rmd 文档渲染为 PDF 时，没有问题。但是，当我尝试将同一文档呈现为 HTML 时，rmarkdown::render 会因 extra_dependencies 参数的处理而窒息。 (我使用的是 rmarkdown 2.1。)这是一个最小的例子，遵循 R Markdown Cookbook 的风格:

---
title: "Test Processing of YAML Header in R Markdown Document"
output: 
  html_document:
    extra_dependencies:
      array: null
      numprint: ["autolanguage"]
---

Hello.

使用 rmarkdown::render 呈现该文档会生成 dependency_resolver -> <Anonymous> -> sapply -> lapply 错误。如果我在 array 和 numprint 之前添加破折号，则错误是 Error: invalid version specification 'NULL' 。但是如果我只是将 html_document 更改为 pdf_document ，则没有问题。

如何在通过 extra_dependencies 选项加载包时生成 HTML 文档？为什么这个例子在我生成 PDF 文档时有效，但在我生成 HTML 文档时无效？

Answer 1

请注意，extra_dependencies 参数可用于多种不同的输出格式(PDF、HTML)，但这些设置是特定于输出格式的。

如果您想分配 LaTeX 包 ，这些将仅用作 PDF 输出 的 extra_dependency 。这会导致错误，因为它无法识别额外依赖项的语法。为了让您的代码工作，您需要为 HTML 和 PDF 提供单独的选项:

---
title: "Test Processing of YAML Header in R Markdown Document"
output: 
  html_document: default
  pdf_document:
    extra_dependencies:
      array: null
      numprint: ["autolanguage"]
---

Hello.

您可以为 HTML 文档 指定额外的依赖项，但这些必须是 HTML 依赖项 ，而不是 LaTeX 包。似乎没有很多很好的例子来展示这一点，因为这个功能主要由模板使用，很少暴露给最终用户，但它允许你加载额外的 JavaScript 依赖项。此处给出了此示例: https://github.com/rstudio/rmarkdown/issues/1654