R Bookdown _bookdown.yml

Bookdown 有很多配置选项，我发现很难理解如何知道一个选项是否存在，以及这些选项背后的逻辑。

具体来说，我发现很难描述什么kind选项进入_bookdown.yml鉴于至少还有其他两个地方可以说明选项：

• In _output.yml,
• 函数调用的参数，例如bookdown::render_book.

在我看来，之间不存在任何形式的一对一映射_bookdown.yml以及函数的参数，例如bookdown::render_book, so _bookdown.yml似乎不仅仅是记录函数调用选项的不同方式。

我们可以在源代码中看到`_bookdown.yml'正在控制一些配置选项 https://github.com/rstudio/bookdown/blob/7c09c9b22605686291e583ccad671ff7d84a1b35/R/html.R#L539但不是全部。

所以 - 重新表述这个问题 - 为什么是_bookdown.yml一个单独的配置文件以及它应包含的内容的定义在哪里/是什么？

举个有代表性的例子，有一个chapter_name可以使用的选项_bookdown.yml。我有以下问题：

1. 鉴于文档中没有引用它，我们如何知道这是一个选项here https://cran.r-project.org/web/packages/bookdown/bookdown.pdf甚至在例子中here https://bookdown.org/yihui/bookdown/configuration.html.
2. 一旦我们知道它存在，我如何知道它有什么影响？所有这些选项是否都会传递给其他包（例如 pandoc、rmarkdown）？我唯一能找到参考的地方chapter_name在 CRAN 源代码中bookdown https://github.com/rstudio/bookdown/blob/7c09c9b22605686291e583ccad671ff7d84a1b35/R/html.R#L539，即使在那里我也无法真正弄清楚它是如何使用的。

注意，讨论_bookdown.yml作者是here https://bookdown.org/yihui/bookdown/configuration.html，但我还是不太明白。

以下是对代码库调查的一些结果：

我们可以看到 'config' 变量bookdown::render_book填充自_bookdown.yml here https://github.com/rstudio/bookdown/blob/1254a81864c7d0e1d165eda58d9fb08fe3a9bc71/R/render.R#L63，通过一个名为load_config可以在以下位置找到：utils.R https://github.com/rstudio/bookdown/blob/master/R/utils.R#L79.

load_config似乎做了两件事 - 它存储的内容config在名为的主选项列表中opts， 其中config只是一个元素，然后返回config元素。

注意opts最初定义为here https://github.com/rstudio/bookdown/blob/master/R/utils.R#L247。它是从一个创建的knitr:::new_defaults可以找到here https://github.com/yihui/knitr/blob/f02600d24a9628c8a376df41078756dc9e63bfc2/R/defaults.R#L3.

The config然后变量出现在代码库的多个部分中。

The 以下代码 https://github.com/rstudio/bookdown/blob/1254a81864c7d0e1d165eda58d9fb08fe3a9bc71/R/render.R#L88具有代表性：

  if (is.na(new_session)) {
    new_session = FALSE
    if (is.logical(config[['new_session']])) new_session = config[['new_session']]
  }

所以我们可以看到如果new_session被直接传递到bookdown::render_book作为函数参数，它被使用。否则会尝试从_bookdown.yml file.

The config作为一个参数被广泛传递bookdown::render_book。例如，我们可以看到它被用于source_files https://github.com/rstudio/bookdown/blob/master/R/utils.R#L93函数于utils.R.

我们得出什么结论？_bookdown.yml允许您填充全局选项列表bookdown包裹。每当你看到config（这是一个列表）正在使用代码库，您可以通过填充来设置此列表的元素_bookdown.yml

我还没有找到可以在中指定的选项的完整列表_bookdown.yml但轻松找出可能性的一种方法是.