Как использовать пользовательский HTML-шаблон Pandoc в bookdown::gitbook

Question

Я хотел бы написать собственный шаблон для проекта уценки. Из документации пакета bookdown я прочитал, что можно заменить шаблон по умолчанию на пользовательский, скажем, my_custom_template.html, в том числе template: "my_custom_template.html" в заголовке YAML вроде

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

Мне кажется, что шаблон по умолчанию жестко закодирован и поэтому не может быть переопределен так просто.

Есть ли другой способ включить пользовательский шаблон?

Answer 1

Это невозможно, и это задокументировано следующим образом: в документации по используемой функции (?bookdown::gitbook) template исключен из списка доступных параметров для передачи rmarkdown::html_document(), вместе с toc а также theme, Это также упоминается на странице, на которую вы ссылаетесь:

Есть несколько аргументов html_document(), которые были жестко запрограммированы в gitbook(), и вы не можете их изменить: toc = TRUE (должно быть оглавление), theme = NULL (без использования тем Bootstrap) и шаблон (существует внутренний шаблон GitBook).