简介
Quarto[1] 是一个建立在 Pandoc 上的开源科技出版系统。
- 可以基于 Python、R、Julia 和 Observable 创建动态内容。
- 以纯文本 markdown 或 Jupyter 笔记本的形式编写文档。
- 以 HTML、PDF、MS Word、ePub 等格式发布高质量的文章、报告、简报、网站、博客和书籍。
- 用科学的 markdown 进行创作,包括方程、引文、交叉引用、图板、呼号、高级布局等等。
基于四种不同语言构建的文档,案例如下(左边为源码,右边为输出结果):
基于 Python 创建文档
基于 R 创建文档
基于 Julia 创建文档
基于 Observable 创建文档
类型与 R Markdwon 比较类似。第一部分是 YAML,后面是正文内容(包含:文字,代码等)。
小编认为如果你会了 R Markdown 制作各类文档,你再来看这些内容,难度应该都不大。两者其实非常相似。如果你有这样的担心:是否需要转战 Quarto 构建文档?,或许你可以看看谢益辉写的博客[2]。
它是如何工作的?
在渲染 Quarto 文档时,首先执行所有代码块,并创建一个新的 markdown (.md) 文档,内部包括代码及其输出。然后由 pandoc 处理创建最终的格式(PDF、Word 等)。而这整个步骤都封装到了 Render 按钮中,读者只需要点击 Render 按钮即可编译得到对应的输出文档(各类文档,下一节讲给出)。
工作流程
RStudio 中的 Render 按钮
可创建的文档类型
官网给出了很多很创建的文档类型,并开源了对应的代码。读者可以尝试下载,并读懂,并将其为己所用。这里小编将其简单罗列了下:
文章和报告
具体模板可见:https://quarto.org/docs/gallery/#articles-reports
文章和报告
幻灯片
具体模板可见:https://quarto.org/docs/gallery/#presentations
幻灯片
交互式文档
具体模板可见:https://quarto.org/docs/gallery/#interactive-docs
交互式文档
网站
具体模板可见:https://quarto.org/docs/gallery/#websites
网站
书籍
具体模板可见:https://quarto.org/docs/gallery/#books
书籍
资源分享
本文主要分享基于 R 语言创建 Quarto 文档。
- 官网的基于 R 语言的 Quarto 文档教程[3]
- RStudio 举办的 R 会议等给出了一些视频教程。小编将一些最新的教程搬运到了 B 站,供大家学习:
哔哩哔哩,,,
基于 Quarto 创建文档
小程序
- 其他相关的博客1[4],2[5] 等。
小编有话说
小编有打算制作一个简短的教程(或者是免费的直播),简单介绍下 Quarto 的使用方式。现在这挖个坑,准备好了再通知大家。
参考资料
[1]
Quarto: https://quarto.org/
[2]
博客: https://yihui.org/en/2022/04/quarto-r-markdown/
[3]
基于 R 语言的 Quarto 文档教程: https://quarto.org/docs/get-started/hello/rstudio.html
[4]
1: https://www.rstudio.com/blog/announcing-quarto-a-new-scientific-and-technical-publishing-system/
[5]