准备

在开始前，需要安装 R, RStudio, bookdown，和其他依赖的软件和包(例如 Pandoc, \(\LaTeX\), rmarkdown, rticle, knitr等)，作为准备。详见 bookdown 官方手册。

安装

准备完毕后，就可以安装 bookdownplus 了。可以安装稳定版：

install.packages("bookdownplus")

或开发版：

devtools::install_github("pzhaonet/bookdownplus")

生成模板文件

接着，在 R 中运行下面的代码：

bookdownplus::bookdownplus()

这时，在你的工作目录（getwd()），会得到一些模板文件（如 index.Rmd，body.Rmd， bookdownplus.Rproj） 和文件夹。

编译成书

用 RStudio 打开 bookdownplus.Rproj文件，然后按 ctrl+shift+b，Duang！你就得到模板书 *.pdf了！保存在 _book/ 文件夹里。

你的文字

在 index.Rmd 和 body.Rmd 里写你自己的文字，享受写书的快乐吧！自古皆死，不朽者文。

更多输出格式

模板默认生成的书是pdf格式。‘bookdownplus’ 从 1.0.3 开始，可以很方便地输出更多格式，包括国内最常见的 ’word’格式，网页’html’格式和电子书’epub’格式，只需运行：

bookdownplus::bookdownplus(template = 'article', more_output = c('html', 'word', 'epub'))

就可以在 _book/ 文件夹里看到这些文件了。

网页格式可以极其方便地免费发布到 bookdown.org，只需运行：

bookdown::publish_book()

这里是 bookdown 书籍的大本营。截至 2017 年 6 月，我有三本书被放置在这个网站的首页。

更多建议

我开发的另外两个 R 包可以配合 ‘bookdown’ 使用：

• mindr (Zhao 2017b)，可以从 markdown 或 R markdown 格式的书稿中提取纲要，并且生成思维导图。

• pinyin (Zhao 2017c)，可以为书稿的章节标题自动生成‘{#ID}’。如果标题里含有汉字，就会自动转换成拼音。

具体用法见他们的帮助信息。这两个包已经在 CRAN正式发布，安装命令是：

install.packages('mindr')
install.packages('pinyin')

更改模板

上述快速入门得到的模板文档是默认的论文文档。只需在上述步骤里为 bookdownplus() 函数指定模板名称，就可以用类似的操作得到其他模板的示范文档，如：

bookdownplus::bookdownplus(template = 'poem')

下面展示一些模板。

• article

• article_mdpi1

• article_zh

• calendar

• chemistry

• guitar

• journal

• mail

• poem

• thesis_classic

• thesis_ubt

• thesis_zju

• yihui_demo

• yihui_mini

• yihui_zh

• poster

更新记录

• 2017-06-21. Released on CRAN!
• 2017-06-21. Version 1.0.2. Resubmitted to CRAN!
• 2017-06-21. Version 1.0.2. Resubmitted to CRAN!
• 2017-06-21. Version 1.0.1. Submitted to CRAN!
• 2017-06-14. Version 0.0.1. A bug fixed.
• 2017-05-15. Version 0.0.0. A very preliminary version.