R：Bookdown：每个 Markdown 文件一章（Rmd）

Question

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

[...] 一章存在于一个 R Markdown 文件中 [...]。 每个 R Markdown 文件必须立即以使用第一级标题的章节标题开始，例如，# 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}

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

我建议这更像是一种样式，就像缩进代码、在逗号后加空格等的惯例一样。RMarkdown 的最大好处之一是无需了解所有文件即可轻松理解文件语法，但缺少标题可能会使潜在读者感到困惑。但是，正如您所说，特定用途可能是有意义的。