前言

说明

作者在构建、学习和使用过程中,参阅了大量的书籍、文献和网上资源.因此,本笔记中部分内容、程序和表述取自这些资料,由于数量惊人,出处不一,无法记录、跟踪并一一引用,如有侵权,请告之笔记者.

限于学识水平,错漏之处在所难免,恳请读者指正为谢!

— hbsun

关于 BookDown和 BlogDown：

  • 前者专注于报告、文章和书籍的写作,后者用于创建个人网站
  • 作为 R 语言的扩展包,二者都集成于 Rstudio 环境下,极大地提高工作效率和质量
  • 比Word更美观、更专业，比LaTeX更易用，比Markdown格式更丰富
  • 可以方便地构建和插入目录、图表、脚注、索引、参考文献及交叉引用
  • 可以方便地插入数学公式，插入R、Python等流行编程语言代码，并实现动态运行及结果自动插入
  • 可以生成漂亮的pdf和网页文件，一箭双雕
  • 用 bookdown 写作,用 blogdown 创建、维护个人网站,高雅又高效
  • 在统计学、数据科学领域,越来越多的人员使用

考虑到大多数人使用习惯,这里给出的软件链接,是针对 Microsoft Windows系统的,至于使用 Apple macOS和各种发行版的Linux大神,请自行Bing并下载,感觉微软的搜索引擎 Bing,比百度纯净.

至于软件环境配置,由于R 语言和Rstudio软件的跨平台特点,不同操作系统中配置环境基本相同或类似,可以直接采用或略加修改即可.

在 Rstudio 集成环境下, 主要使用了4个 R 包，分别是knitr (Xie 2022b)、rmarkdown (Allaire et al. 2022) 、bookdown (Xie 2022a)、blogdown(Xie, Dervieux, and Presmanes Hill 2022)。

软件Logo软件Logo软件Logo软件Logo

图 0.1: 软件Logo

当然,还需要安装相应的依赖包;如果需要 bookdown生成 PDF 文件,还需要安装 tinytex 包,并使用 tinytex 安装TEX系统.以下是本资料写作、编译时 R的相关信息

## R version 4.2.1 (2022-06-23)
## Platform: aarch64-apple-darwin20 (64-bit)
## Running under: macOS Monterey 12.5
## 
## Matrix products: default
## BLAS:   /Library/Frameworks/R.framework/Versions/4.2-arm64/Resources/lib/libRblas.0.dylib
## LAPACK: /Library/Frameworks/R.framework/Versions/4.2-arm64/Resources/lib/libRlapack.dylib
## 
## locale:
## [1] en_US.UTF-8/en_US.UTF-8/en_US.UTF-8/C/en_US.UTF-8/en_US.UTF-8
## 
## attached base packages:
## [1] stats     graphics  grDevices utils     datasets 
## [6] methods   base     
## 
## loaded via a namespace (and not attached):
##  [1] bookdown_0.27   digest_0.6.29   R6_2.5.1       
##  [4] jsonlite_1.8.0  magrittr_2.0.3  evaluate_0.15  
##  [7] highr_0.9       stringi_1.7.8   cachem_1.0.6   
## [10] rlang_1.0.4     cli_3.3.0       rstudioapi_0.13
## [13] jquerylib_0.1.4 bslib_0.4.0     rmarkdown_2.14 
## [16] tools_4.2.1     stringr_1.4.0   xfun_0.31      
## [19] yaml_2.3.5      fastmap_1.1.0   compiler_4.2.1 
## [22] htmltools_0.5.3 knitr_1.39      sass_0.4.2
最后,特别需要指出的是,本资料是本人使用 bookdown 和 blogdown过程中,实践经验的主要记录和总结,可以帮助到刚刚接触,想快速上手的新手,但缺乏系统和细节的介绍,在实践过程中,一定要参看如下两本最权威的指南:
软件Logo软件Logo

图 0.2: 软件Logo

这两本书的电子版请点击这里(你会对这里很感兴趣).

致谢

感谢这些优秀的开源软件的开发者,特别是谢益辉的贡献!感谢这个互联网开源时代,可以站在巨人的肩膀上,使用和享受到这样高效、强大的工具!

孙洪波
北京理工大学珠海学院大数据研究中心

参考文献

Allaire, JJ, Yihui Xie, Jonathan McPherson, Javier Luraschi, Kevin Ushey, Aron Atkins, Hadley Wickham, Joe Cheng, Winston Chang, and Richard Iannone. 2022. Rmarkdown: Dynamic Documents for r. https://CRAN.R-project.org/package=rmarkdown.
Xie, Yihui. 2022a. Bookdown: Authoring Books and Technical Documents with r Markdown. https://CRAN.R-project.org/package=bookdown.
———. 2022b. Knitr: A General-Purpose Package for Dynamic Report Generation in r. https://yihui.org/knitr/.
Xie, Yihui, Christophe Dervieux, and Alison Presmanes Hill. 2022. Blogdown: Create Blogs and Websites with r Markdown. https://CRAN.R-project.org/package=blogdown.