R沟通|部署 bookdown 文件到 GitHub 上

简介: R沟通|部署 bookdown 文件到 GitHub 上

简介

前段时间写了如何使用 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 中即可。

详细教程

  1. 使用本地 Github 创建新的仓库:



  1. 选择 _book 文件夹路径,修改仓库文件名,创建仓库。





  1. 将本地仓库 push 到线上



注意:不要设置成私人仓库,不然后期不好生成页面。



  1. 这时打开线上仓库,得到以下界面


  1. 选择 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]

教程 3: https://bookdown.org/yihui/bookdown/github.html

目录
相关文章
|
1月前
|
网络协议 Linux Android开发
解决GitHub无法访问的问题:手动修改hosts文件与使用SwitchHosts工具
解决GitHub无法访问的问题:手动修改hosts文件与使用SwitchHosts工具
115 1
|
3月前
|
开发工具 git
把文件移动到在github上新建的文件
把文件移动到在github上新建的文件
|
3月前
|
弹性计算 Java API
阿里云OpenAPI的依赖文件通常在阿里云官方文档或者SDK的GitHub仓库中可以找到
【1月更文挑战第5天】【1月更文挑战第21篇】 阿里云OpenAPI的依赖文件通常在阿里云官方文档或者SDK的GitHub仓库中可以找到
99 1
|
4月前
|
域名解析 网络协议 测试技术
[插件使用] SwitchHosts自动更新Github Hosts文件
[插件使用] SwitchHosts自动更新Github Hosts文件
370 0
|
3月前
|
存储
github pages 部署单页面
github pages 部署单页面
53 0
|
3月前
|
JavaScript Ubuntu 网络安全
使用github actions,将私有仓库的构建文件发布到另一个公开仓库,并同步到gitee
使用github actions,将私有仓库的构建文件发布到另一个公开仓库,并同步到gitee
92 0
|
3月前
|
程序员 开发工具 git
【实测】gitlab/github 如何过滤项目内的文件
【实测】gitlab/github 如何过滤项目内的文件
|
4月前
|
Shell 开发工具 git
Git - 与GitHub整合时删除仓库和文件
Git - 与GitHub整合时删除仓库和文件
15 0
|
7月前
|
存储 数据采集 安全
从 GitHub 上获取文件内容
从 GitHub 上获取文件内容
88 0
|
8月前
|
JavaScript 开发工具 git
vscode关于vue项目无法将文件push到github的错误命令
vscode关于vue项目无法将文件push到github的错误命令
72 0