Quarto基础

Quarto是一个支持多种编程语言的新一代R Markdown,拥有多个新的特性和功能,同时能够兼容和渲染大多数现有的.rmd文件,而无需额外修改。Quarto可通过多种IDEs编辑,包括VS Code和RStudio。文档的后缀为.qmd。

目前,Quarto还处于起步和不断发展的阶段,针对其的学习资源还十分有限,尤其是中文资源更加匮乏,因此有了汇总和编写本章的动机。本章内容主要参考了Quarto的官方指南,并提取了其中我认为在将来的编写中会经常使用的技巧并加以汇总。这本学习笔记即全程采用Quarto编写。

本章的逻辑结构:

  1. 首先介绍Quarto文档的全局设置,即YAML语法(YAML设置);

  2. 图片的设置,包括插入的图片和代码块运行后产生的图片;

  3. 如何实现对图、表等的交叉引用

  4. 其他几种内容的插入

  5. 创建和编辑Quarto Books的方法(Quarto Books);

  6. 如何在Quarto文档中嵌入Shiny交互式应用程序

  7. 最后,介绍如何将Quarto项目的源代码通过Git上传到GitHub以及如何将编译好的Quarto Book通过GitHub Pages进行发布发布到GitHub Pages)。

有关Quarto的详细信息,参考:https://quarto.org.

Tip

快捷键:

  • 插入代码块:Option+Command+I(macOS);Ctrl+Alt+I(Windows)。

  • 插入各类对象:Command+/;或者当光标位于新的一行开头时,直接输入/