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

目录
相关文章
|
10月前
|
存储 Linux 数据安全/隐私保护
一键部署 200+ 开源Github 2k+ 星星的软件
Websoft9面板是一款基于Web的PaaS/Linux面板,支持在个人服务器上一键部署200多种热门开源应用,适用于个人开发者、中小企业、创业团队、教育机构和技术爱好者。它集成了丰富的开源软件,提供便捷的部署方式、高效的资源利用、良好的可扩展性及低技术门槛,帮助用户快速搭建和管理各类应用。
|
搜索推荐 前端开发
使用VitePress创建个人网站并部署到GitHub
该网站使用 VitePress 构建,记录了前端开发相关的笔记和教程,涵盖 Vue2 和 Vue3 等内容。网站支持暗黑模式和 Algolia 搜索服务,提供了详细的导航和侧边栏配置。通过自动化脚本进行部署,托管于 GitHub Pages。
185 2
使用VitePress创建个人网站并部署到GitHub
|
JavaScript 搜索推荐 资源调度
使用VitePress静态网站生成器创建组件库文档网站并部署到GitHub
本文详细介绍了如何使用 Vue3、TypeScript 和 Vite 开发并发布一个名为 Vue Amazing UI 的组件库至 npm。文章首先引导读者安装配置 VitePress,创建文档网站,并编写组件库文档。接着,通过一系列配置实现网站主题定制、全局样式设置以及 Algolia 搜索功能集成。最后,文章提供了自动化脚本,帮助开发者一键打包部署静态网站至 GitHub,并发布组件库到 npm。通过这些步骤,读者可以轻松搭建并维护一个美观且功能齐全的组件库文档网站。
140 2
使用VitePress静态网站生成器创建组件库文档网站并部署到GitHub
|
资源调度 搜索推荐 Shell
使用VitePress静态网站生成器创建组件库文档网站并部署到GitHub
本文介绍了如何使用 Vue3、TypeScript 和 Vite 开发组件库并将其发布到 npm。文章详细描述了安装依赖、配置项目、创建文档网站以及编写组件文档的步骤。通过使用 VitePress,可以轻松搭建组件库的文档站点,并实现 Algolia 搜索功能。此外,还提供了自动化脚本用于部署静态网站至 GitHub 以及发布组件库到 npm。最后,展示了完整的目录结构和网站效果。
462 1
使用VitePress静态网站生成器创建组件库文档网站并部署到GitHub
|
12月前
|
网络协议 开发工具 git
hexo github部署,通过域名访问你的博客
本文介绍了如何使用Hexo命令部署博客到GitHub,并详细说明了如何通过自定义域名访问GitHub上部署的博客。
hexo github部署,通过域名访问你的博客
|
Linux C++ Docker
【Azure Developer】在Github Action中使用Azure/functions-container-action@v1配置Function App并成功部署Function Image
【Azure Developer】在Github Action中使用Azure/functions-container-action@v1配置Function App并成功部署Function Image
|
存储
【Azure Developer】Github Action部署资源(ARM模板)到Azure中国区时,遇见登录问题的解决办法
【Azure Developer】Github Action部署资源(ARM模板)到Azure中国区时,遇见登录问题的解决办法
122 0
|
jenkins Java Shell
蓝易云 - Java+Github+Jenkins部署
以上步骤完成后,每当你的Github仓库有新的提交时,Jenkins就会自动构建你的Java项目,并保存构建产物。
149 4
|
开发工具 git
【看这一篇就够了】如何删除gitHub仓库中的文件
【看这一篇就够了】如何删除gitHub仓库中的文件

热门文章

最新文章