how to use bookdown

模板下载 {#moban}

谢益辉

通用模板：https://github.com/rstudio/bookdown-demo

李东风中文模板：

http://www.math.pku.edu.cn/teachers/lidf/docs/Rbook/html/_Rbook/bookdown.html#bookdown-intro

下载到本地解压

Rstudio即相关包安装

• 推荐使用Rstudio，因为是自带pandoc

安装bookdown

install.packages("bookdown")

安装tinytex

install.packages("tinytex")

若不是Rstudio 需要安装pandoc

这个直接查看版本就可

写书

• 可以直接修改模板的rmd文档，修改成自己的每一章节的内容
• 需要重新设置一下_outout.yml和_bookdown.yml,设置为需要的格式
  
  主要是设置一下作者，日期，书名等信息，其他的随意
• bib文件需要设置为自己用到的参考文献，有一次编辑，终身使用的效果贼好使

预览

knit

编译书

右侧按钮build

使用命令

bookdown::render_book("index.Rmd",
  output_format="bookdown::gitbook", encoding="UTF-8")

上传至github生成静态网站

开源

• 新建一个项目
• 设置项目的settings
  
  github pages-source-master branch
• 将生成的书，也就是output_dir输出的位置文件夹上传至项目
• 然后访问http://用户名.github.io/项目名/书名/index.html

发布

bookdown::publish_book(render = "local")

knitr::opts_chunk$set(echo = TRUE)
library(tidyverse) # Wickham的数据整理的整套工具
pdf.options(height=10/2.54, width=10/2.54, family="GB1") # 注意：此设置要放在最后

生成的样本

https://gaowenxin95.github.io/first-bookdown-demo/use-bookdown/index.html