1.2 开始
对于初学者来说,使用 R Markdown 和 bookdown 开始创作书籍的最简单的方法是 GitHub 上的示例 bookdown-demo
:
下载 GitHub 存储库 https://github.com/rstudio/bookdown-demo 作为 Zip文件,然后在本地解压该文件。
安装 RStudio IDE。注意,你需要版本号高于 1.0.0 的 RStudio。如果你的 RStudio 版本低于 1.0.0,请下载最新版本。
安装 R 软件包 bookdown:
在 RStudio 中点击
bookdown-demo.Rproj
打开你下载的bookdown-demo
储存库。打开 R Markdown 文件
index.Rmd
,然后点击 RStudio 里位于Build
选项卡中的按钮Build Book
。
如果你打算把你的书打印成 PDF 格式,你将需要一个 LaTeX 发行版。我们建议你安装 TinyTeX(包含 XeLaTeX):https://yihui.org/tinytex/。
现在你应该可以在 RStudio viewer 中看到本书样例的索引页。你可以添加或更改 R Markdown 文件,然后再次点击 Knit
按钮预览书籍。如果你不想使用 RStudio,也可以通过命令行编译书籍。详见下一节。
尽管你在 bookdown-demo
示例中看到了不少文件,但大多数文件对于一本书来说并不是必需的。如果你对巨大的文件数量感到不知所措,可以使用这个最小的示例,它实际上是一个文件 index.Rmd
:https://github.com/yihui/bookdown-minimal。bookdown-demo
示例包含一些你之后可能需要学习的高级设置,例如如何自定义 LaTeX 序言 (preamble)、调整 CSS 以及在 GitHub 上构建图书等。