R：预订：每个Markdown文件一个章节（Rmd）

Question

在＆＃34; bookdown: Authoring Books and Technical Documents with R Markdown ＆＃34;谢毅辉（2017）写道：

  

[...]一章存在于一个R Markdown文件中[...]。   每个R Markdown文件必须使用第一级标题立即开始章节标题，例如＃Chapter Title

出于实际原因，我不想遵循这个惯例。但除了警告信息（见下文）之外，由于我的不服从，我没有观察到任何问题。可以忽略谢（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的最大好处之一就是在不必了解所有文件的情况下理解文件是多么容易语法，但缺乏标题可能会混淆潜在的读者。但是，正如您所说，特定用途可能有意义。