R: Bookdown: 每个 Markdown 文件一章 (Rmd)

Question

在“bookdown: Authoring Books and Technical Documents with R Markdown”中，谢一辉（2017）写道：

[...] one chapter lives in one R Markdown file [...]. Each R Markdown file must start immediately with the chapter title using the first-level heading, e.g., # Chapter Title

出于实际原因，我不想遵循此约定。但除了警告消息（见下文）之外，我没有发现任何因我的不服从而导致的问题。可以忽略 Xie (2017) 和相应的警告吗？如果是这样，为什么首先要有规则和警告？

Warning message:
In split_chapters(output, gitbook_page, number_sections, split_by,  :
  You have n Rmd input file(s) but only n first-level heading(s). Did you forget first-level headings in certain Rmd files?

Answer 1

当你构建这本书时，bookdown 将单独的 .Rmd 文件合并到一个 Rmd 文件中，然后 knitr 在这个主文件上运行。它在加入文件的地方插入注释以显示下一个文件的开头，例如：

Content from chapter 1.

<!--chapter:end:index.Rmd-->

# Introduction {#intro}

由于这些评论只是评论，没有技术原因下一章必须按要求以#开头。

我认为这更像是一种样式设计，就像缩进代码、在逗号后放置空格等的常规做法一样。RMarkdown 的最大好处之一是无需手动操作即可轻松理解文件知道所有语法，但缺少标题可能会使潜在的 reader 感到困惑。但是，正如您所说，特定用途可能有意义。

R: Bookdown: 每个 Markdown 文件一章 (Rmd)

R: Bookdown: One chapter per Markdown File (Rmd)

r

r-markdown

bookdown