用 R Bookdown 做本书,上线
共 2628字,需浏览 6分钟
·
2024-04-26 07:11
我的写作基础设施:
1、Typora
2、Cloudflare R2
3、Picgo
4、Obsidian
5、GitHub
6、mdnice
本合集会一一介绍上述工具的安装、配置、使用等等
还会介绍:
-
服务器配置 -
GitHub Pages、Cloudflare Pages、Vercel 的使用 -
用 Jekyll、Bookdown、Jupyter Book、Astro 搭建个人博客
预计更新 12 个章节,欢迎订阅。
前文
P2:本地运行“小型”大模型,配合笔记应用王者 Obsidian 做知识管理
P3:世界上最好的 Markdown 编辑器,Typora 完全配置指南,Markdown 极简入门
P4:搭建完美写作环境之:Typora+PicGo 快速上传图片
P6:知识管理王者,我的第二大脑,Obsidian 配置指南
P8:用 GitHub 备份 Markdown 文档,Git 简介
P9:Jekyll + Vercel 搭建个人博客,完整教程
本文目录
Bookdown 的优势
如何使用 Bookdown
部署到 vercel
Bookdown 的优势
Bookdown 是著名 R 包作者谢益辉开发的,主要服务于数据科学家和统计学家,但它的灵活性和易用性也使得其他领域的作者能够利用它来撰写、编译和发布不同格式的文档。
Bookdown 支持采用 Rmarkdown (R 代码可以运行) 或普通 markdown 编写文档,然后编译成 HTML, WORD, PDF, Epub 等格式。
Bookdown 是个素颜版的 LaTeX,满足了 99% 的需求,而使用难度大概只有 LaTeX 的 1%,性价比极高。
优势:
-
完全开源,向收费说不
-
完全自定义,想干啥就干啥
-
静态网站,很容易部署到 Internet
-
支持 LaTeX,可以直接导出 tex 文档
-
导出排版好的 PDF 文档和 kindle 文档
-
写完后直接排序组合,一键 build 成书
如何使用 Bookdown
1、安装 R 和 Rstudio
R 下载,推荐清华的镜像:https://mirrors.tuna.tsinghua.edu.cn/CRAN/ Rstudio 下载:https://posit.co/download/rstudio-desktop/
安装都是一路下一步
2、安装 Bookdown 包
install.packages("Bookdown")
3、克隆 demo 到本地,解压后用 Rstudio 打开.Rproj 文件
git clone https://github.com/rstudio/Bookdown-demo
或者直接下载压缩包
4、打开工程中章节对应的.Rmd 文件进行编辑
按章节命名好 Rmd 即可
Rmd 也即 R Markdown 和 Markdown 本质上都是标记语言
语言:Markdown 是一种轻量级的标记语言,用于编写格式化文本。而 RMarkdown 是建立在 Markdown 基础之上的一种语言,旨在方便将文本和代码混合在同一个文件中。
用途:Markdown 主要用于编写格式化文本,如网页、文章、文档等。而 RMarkdown 则专门设计用于数据分析与报告,允许在同一个文件中交织代码 (通常是 R 代码) 和文字说明。
代码执行:Markdown 无法直接执行代码,只能将代码块展示为格式化文本。而 RMarkdown 可以执行嵌入的代码块,将结果动态渲染到文档中。这对于分析报告和可重复研究非常有用。
输出格式:Markdown 通常会被渲染为 HTML、PDF 等格式。而 RMarkdown 不仅支持这些格式,还可以输出报告、幻灯片、网页、Word 文档等多种格式。
工具支持:Markdown 有许多编辑器支持。而 RMarkdown 主要由 R 生态圈中的工具支持,如 RStudio IDE。
其实语法区别不大,对 markdown 一无所知的同学可以重温一下第三章:P3:世界上最好的 Markdown 编辑器,Typora 完全配置指南,Markdown 极简入门
5、编辑完成的章节在 Rstudio 面板 Build--Build Book 编译成书
6、编译完成之后会自动生成一个_book 文件夹,里面包含了静态 html 文件