用 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 个章节,欢迎订阅。

前文

P1:技术写作,工具篇

P2:本地运行“小型”大模型,配合笔记应用王者 Obsidian 做知识管理

P3:世界上最好的 Markdown 编辑器,Typora 完全配置指南,Markdown 极简入门

P4:搭建完美写作环境之:Typora+PicGo 快速上传图片

P5:互联网活菩萨 Cloudflare 的“免费”图床

P6:知识管理王者,我的第二大脑,Obsidian 配置指南

P7:用 mdnice 做 Markdown 主题美化

P8:用 GitHub 备份 Markdown 文档,Git 简介

P9:Jekyll + Vercel 搭建个人博客,完整教程

本文目录


  • Bookdown 的优势

  • 如何使用 Bookdown

  • 部署到 vercel


unsetunsetBookdown 的优势unsetunset

Bookdown 是著名 R 包作者谢益辉开发的,主要服务于数据科学家和统计学家,但它的灵活性和易用性也使得其他领域的作者能够利用它来撰写、编译和发布不同格式的文档。

Bookdown 支持采用 Rmarkdown (R 代码可以运行) 或普通 markdown 编写文档,然后编译成 HTML, WORD, PDF, Epub 等格式。

Bookdown 是个素颜版的 LaTeX,满足了 99% 的需求,而使用难度大概只有 LaTeX 的 1%,性价比极高。

优势:

  • 完全开源,向收费说不

  • 完全自定义,想干啥就干啥

  • 静态网站,很容易部署到 Internet

  • 支持 LaTeX,可以直接导出 tex 文档

  • 导出排版好的 PDF 文档和 kindle 文档

  • 写完后直接排序组合,一键 build 成书

unsetunset如何使用 Bookdownunsetunset

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 本质上都是标记语言

  1. 语言:Markdown 是一种轻量级的标记语言,用于编写格式化文本。而 RMarkdown 是建立在 Markdown 基础之上的一种语言,旨在方便将文本和代码混合在同一个文件中。
  1. 用途:Markdown 主要用于编写格式化文本,如网页、文章、文档等。而 RMarkdown 则专门设计用于数据分析与报告,允许在同一个文件中交织代码 (通常是 R 代码) 和文字说明。
  1. 代码执行:Markdown 无法直接执行代码,只能将代码块展示为格式化文本。而 RMarkdown 可以执行嵌入的代码块,将结果动态渲染到文档中。这对于分析报告和可重复研究非常有用。
  1. 输出格式:Markdown 通常会被渲染为 HTML、PDF 等格式。而 RMarkdown 不仅支持这些格式,还可以输出报告、幻灯片、网页、Word 文档等多种格式。
  1. 工具支持:Markdown 有许多编辑器支持。而 RMarkdown 主要由 R 生态圈中的工具支持,如 RStudio IDE。

其实语法区别不大,对 markdown 一无所知的同学可以重温一下第三章:P3:世界上最好的 Markdown 编辑器,Typora 完全配置指南,Markdown 极简入门

5、编辑完成的章节在 Rstudio 面板 Build--Build Book 编译成书

6、编译完成之后会自动生成一个_book 文件夹,里面包含了静态 html 文件

浏览 49
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报