简介
前段时间写了如何使用 bookdown 包进行写作,笔记,写书等内容:R沟通|用bookdown制作图书。并且也分享过汤银才教授编写的《Bookdown 中文书稿写作手册》内容:R沟通|Bookdown中文书稿写作手册(上),R沟通|Bookdown中文书稿写作手册(中),R沟通|Bookdown中文书稿写作手册(下)。以及使用 bookdownplus 制作毕业论文(上)。
但是,一直没有介绍如何将自己的笔记/手册部署到网上呢?这个问题在书籍《bookdown: Authoring Books and Technical Documents with R Markdown》[1]中给出了三种方法:
1. 利用 RStudio Connect,见教程 1[2]。
2. 利用 Netlify Drop,见教程 2[3]。
3. 利用 GitHub,见教程 3[4]。
本文主要介绍第 3 点:部署 HTML 文件于 GitHub 上。原理类似于这篇推文:R沟通|Rmarkdown构建简历并部署到个人网站。
注意:《bookdown: Authoring Books and Technical Documents with R Markdown》给出的教程对新手可能不太友好,这里小编采用较简单的方法进行部署,以面向更多的读者们。
构建个人图书
这里以庄小编最近整理的一个可视化笔记本为例。首先根据这篇推文,构建你的笔记/手册,具体见这篇教程:R沟通|用bookdown制作图书(1)。编译成功后,得到 RStudio 界面截图如下:
RStudio 界面截图
此时,本地的笔记本已经创建完毕,预览结果如下:
部署个人图书
接下来,将其部署到 GitHub 上。只需将该笔记文件夹(plot-tutorial-bookdown)下的 _book
文件夹链接到 GitHub 上即可。这里的思路于该推文:R沟通|Rmarkdown构建简历并部署到个人网站 一致。
注意:由于该文件夹已经部署过,所以不想重新折腾。这里,小编将
_book
文件夹内部文件复制到 xxx 文件夹中作为例子。读者不需要跟我这么做,只需将_book
文件夹链接到 GitHub 中即可。
详细教程
- 使用本地 Github 创建新的仓库:
- 选择
_book
文件夹路径,修改仓库文件名,创建仓库。
- 将本地仓库 push 到线上
注意:不要设置成私人仓库,不然后期不好生成页面。
- 这时打开线上仓库,得到以下界面
- 选择 settings -> Pages -> Branch 修改并保存
即可得到以下界面:
如果未能显示,可能需要等一段时间,或者刷新几次。
最后,当你看到以下界面:
那么,恭喜你~部署成功!之后就该链接在线上就可以被其他人看到了~
题外话:我的可视化手册还在整理之中,如果感兴趣阅读,可通过文末原文直达。
参考资料
[1]
《bookdown: Authoring Books and Technical Documents with R Markdown》: https://bookdown.org/yihui/bookdown/publishing.html
[2]
教程 1: https://bookdown.org/yihui/bookdown/rstudio-connect.html
[3]
教程 2: https://bookdown.org/yihui/bookdown/netlify-drop.html#netlify-drop
[4]