温馨提示：若页面不能正常显示数学公式和代码，请阅读原文获得更好的阅读体验。

作者：郝亮 (北京工业大学)
邮箱：haoliangcfa@126.com

 

• Title: Quarto 助力论文和讲义撰写
• Keywords: Quarto, R, 论文排版, 讲义排版

 

在学术论文写作和教学讲义制作中，良好的排版和格式至关重要。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 模板的一般流程如下：

1. 打开 RStudio 并新建项目：建议为每个新论文/讲义创建一个单独的文件夹。您可以在 RStudio 中选择 File -> New Project... 创建一个新项目，或直接在现有项目/文件夹中操作。
2. 打开 RStudio Terminal：在 RStudio 中，点击菜单 Tools -> Terminal -> New Terminal 打开终端窗口。我们将在这里输入 Quarto 命令来获取模板。
3. 运行获取模板命令：Quarto 使用命令行来下载和应用模板。基本命令格式为：quarto use template 用户名/仓库名。例如，我们稍后将演示获取 Elsevier 期刊模板的命令是：quarto use template quarto-journals/elsevier。(读到这里，您可以直接跳转模版示例部分，这样会更直观！)
4. 信任模板来源：首次运行模板命令时，终端可能会提示是否信任该模板的作者？(Do you trust the authors of this template? (Y/n))。这是因为模板通常来自 GitHub 开源仓库。输入 Y 并回车表示信任。
5. 指定项目文件夹名称：接着，终端会询问要将模板复制到哪个文件夹。您可以输入一个新文件夹名，例如 elsevier-paper (不要使用中文路径) 并回车。Quarto 将在当前目录下创建该文件夹，并将模板文件复制进去。
6. 打开模板示例文件：当命令执行完成后，您会看到一个新文件夹。其中通常包含一个示例 .qmd 文件 (例如 elsevier-paper.qmd*)、参考文献文件 (*.bib) 以及 Quarto 配置文件等。在 RStudio 文件窗格中点击打开 .qmd 文件，就可以看到模板自带的示例内容。
7. 渲染查看效果：点击 RStudio 顶部的绿色小按钮 Render。RStudio 将调用 Quarto 将 .qmd 文件渲染成目标格式。渲染完成后，RStudio 的 Viewer 窗格会显示输出结果预览。如果是 PDF，可在项目文件夹中找到生成的 PDF 文件，用 PDF 阅读器打开查看效果。

按照以上步骤，我们就成功套用了一个 Quarto 模板的示例。下面，我们通过三个具体模板案例，来进一步讲解模板的获取和使用方法，并展示每种模板最终生成的效果截图。

温馨提示：若页面不能正常显示数学公式和代码，请阅读原文获得更好的阅读体验。