Quarto
是由 Posit 开发的一种通用文档工具,可以看作升级版的 R Markdown。借助 Quarto,我们可以使用简洁的 Markdown 语法撰写内容,并插入 R 或 Python 代码,随后一键导出精美的论文、报告或幻灯片。更强的是,社区和官方提供了丰富的模板,帮我们快速套用论文期刊格式或幻灯片样式,大大节省排版时间。本文将基于 RStudio 平台,用通俗易懂的语言手把手介绍如何安装 RStudio 和 Quarto、下载并使用 Quarto 模板来撰写论文和讲义。
1. 准备工作:安装 RStudio 和 Quarto
在开始之前,我们需要准备好工具。
RStudio
是常用的开发工具;
Quarto
则是具体执行渲染的引擎。下面是具体步骤:
1.1 安装 R 和 RStudio
请从 R 官方网站下载安装 R 语言。具体安装步骤请详见连享会推文:R/RStudio下载安装指南,这里不再赘述。安装完成后,启动 RStudio。
1.2 安装 Quarto
Quarto 是一个独立程序,需要单独安装。访问 Quarto 官方网站下载适用于您操作系统的 Quarto 安装包并完成安装。安装成功后,可在命令提示符中运行
quarto --version
检查版本。确保 RStudio 能找到 Quarto (在 RStudio 顶部菜单栏中,应该能看到 Render 按钮,如果没有,重启 RStudio 或检查 Quarto 是否正确安装)。
完成以上步骤后,环境就配置好了!接下来,我们将在 RStudio 中使用 Quarto 模板来创建论文或讲义示例。
2. 使用 Quarto 模板的一般步骤
Quarto 模板是预先设计好的文档样式和结构包。通过它,我们可以快速生成符合某种期刊或风格要求的初始文档,然后只需专注于撰写内容。使用 Quarto 模板的一般流程如下:
打开 RStudio Terminal
:在 RStudio 中,点击菜单
Tools -> Terminal -> New Terminal
打开终端窗口。我们将在这里输入 Quarto 命令来获取模板。
运行获取模板命令
:Quarto 使用命令行来下载和应用模板。基本命令格式为:
quarto use template 用户名/仓库名
。例如,我们稍后将演示获取 Elsevier 期刊模板的命令是:
quarto use template quarto-journals/elsevier
。(读到这里,您可以直接跳转模版示例部分,这样会更直观!)
信任模板来源
:首次运行模板命令时,终端可能会提示是否信任该模板的作者?(Do you trust the authors of this template? (Y/n))。这是因为模板通常来自 GitHub 开源仓库。输入
Y
并回车表示信任。