如何在 bookdown::gitbook 中使用自定义 pandoc HTML 模板答案

【问题标题】：How to use a custom pandoc HTML template in bookdown::gitbook如何在 bookdown::gitbook 中使用自定义 pandoc HTML 模板
【发布时间】：2018-09-13 15:19:23
【问题描述】：

我想为一个 bookdown 项目编写一个自定义模板。从 bookdown 包的documentation 中，我读到可以用自定义模板替换默认模板，比如my_custom_template.html，方法是在 YAML 标头中包含template: "my_custom_template.html"，如

bookdown::gitbook:
  template: my_custom_template.html

这样做会产生以下错误：

Error in rmarkdown::html_document(..., extra_dependencies = c(extra_dependencies,  : 
  formal argument "template" matched by multiple actual arguments
Calls: <Anonymous> ... do.call -> <Anonymous> -> html_document2 -> <Anonymous>
Execution halted
Error in eval(expr, envir, enclos) : 
  Failed to compile the book to bookdown::gitbook

在我看来，默认模板是硬编码的，因此不能那么容易地覆盖。

还有其他方法可以包含自定义模板吗？

【问题讨论】：

标签： r r-markdown pandoc bookdown

【解决方案1】：

更新：自 bookdown v0.8 以来，这已成为可能（感谢 PR #570）。

这是不可能的，它是这样记录的：在所用函数的文档中 (?bookdown::gitbook) template 与@987654326 一起被排除在传递给rmarkdown::html_document() 的可用参数列表之外@ 和 theme。您链接到的页面中也提到了这一点：

html_document() 的一些参数是硬编码的在 gitbook() 中，您无法更改它们： toc = TRUE （必须有目录），theme = NULL（不使用任何 Bootstrap 主题），以及模板（存在内部 GitBook 模板）。

【讨论】：

感谢您指出这一点。我完全忽略了这段话。