第 1 章 简介

这本书是使用 R Markdown (Allaire, Xie, Dervieux, McPherson, et al. 2023) 和 R 软件包 bookdown (Xie 2023a) 创作书籍和技术文档的指南。它侧重于创作书籍、长篇文章或报告所需要使用的功能,例如:

  • 公式、定理、图表的排版和交叉引用;
  • 如何为一本书生成多种输出格式,例如 HTML、PDF 和电子书;
  • 怎样自定义书本模板并为书中不同元素设置样式;
  • 编辑器支持(尤其是 RStudio IDE);
  • 怎样发布书籍;

这不是对 R Markdown 或 knitr 软件包(Xie 2023b)的全面介绍,尽管 bookdown 就是在这个软件包的基础上构建的。要了解有关 R Markdown 的更多信息,请查看联机文档 http://rmarkdown.rstudio.com。关于 knitr,请参阅 Xie (2015)。你不必是 R 语言(R Core Team 2023)的专家就可以阅读这本书,但是你应该对 R Markdown 和 knitr 有一些基本的了解。对于初学者,你可以从 https://www.rstudio.com/resources/cheatsheets/ 上的备忘单开始学习。本书的附录包含对这些软件包的简要介绍。为了能够自定义书籍模板和主题,你应该熟悉 LaTeX、HTML 和 CSS。

参考文献

Allaire, JJ, Yihui Xie, Christophe Dervieux, Jonathan McPherson, Javier Luraschi, Kevin Ushey, Aron Atkins, et al. 2023. Rmarkdown: Dynamic Documents for r. https://github.com/rstudio/rmarkdown.
R Core Team. 2023. R: A Language and Environment for Statistical Computing. Vienna, Austria: R Foundation for Statistical Computing. https://www.R-project.org/.
Xie, Yihui. 2015. Dynamic Documents with R and Knitr. 2nd ed. Boca Raton, Florida: Chapman; Hall/CRC. http://yihui.org/knitr/.
———. 2023a. Bookdown: Authoring Books and Technical Documents with r Markdown. https://github.com/rstudio/bookdown.
———. 2023b. Knitr: A General-Purpose Package for Dynamic Report Generation in r. https://yihui.org/knitr/.