如何在`bookdown::gitbook`中添加自定义htmlDependency答案

【问题标题】：how to add a custom htmlDependency in `bookdown::gitbook`如何在`bookdown::gitbook`中添加自定义htmlDependency
【发布时间】：2018-06-02 13:13:03
【问题描述】：

bookdown::gitbook() 将https://github.com/rstudio/bookdown/tree/master/inst/resources/gitbook 的内容添加为htmltools::htmlDependency。如何将这样的自定义依赖项添加到 gitbook？

目标是提供一种简单的方法来添加企业 CSS（包括图像）。 htmlDependency() 的定义和所有必需的文件将驻留在 R 包中。

【问题讨论】：

这个问题可能是相关的：stackoverflow.com/questions/50320325/…。这不是完全相同的问题，但看起来你不能使用htmlDependency 来简单地添加一个 CSS 文件。
看看像 tufte 或 tint 这样的 R 包是如何运送他们的 CSS 文件的。
tufte 和 tint 都定义了自己的渲染函数。走这条路会让我复制并稍微修改bookdown::gitbook 以及bookdown::gitbook 使用的所有非导出函数。应该有更好的方法来做到这一点。

标签： r r-markdown knitr bookdown

【解决方案1】：

bookdown::gitbook() 的 ... 参数最终会传递给 rmarkdown::html_document()，而 rmarkdown::html_document() 会进一步传递给具有 extra_dependencies 参数的 rmarkdown::html_document_base()。您可以使用 htmltools::htmlDependency() 创建依赖项列表，并通过 extra_dependencies 参数将它们传递给 bookdown::gitbook()。

【讨论】：