Quarto 助力论文和讲义撰写

正文

请到「今天看啥」查看全文

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 模板的示例。下面，我们通过三个具体模板案例，来进一步讲解模板的获取和使用方法，并展示每种模板最终生成的效果截图。

3. 模板示例

3.1 模版示例1：官方期刊论文模板 (Elsevier)

学术期刊通常有严格的格式要求，Quarto 官方提供了期刊模板库，涵盖常见出版社和学协会的格式，例如 ACM、ACS、APA、IEEE、Elsevier 等。这些模板由 Posit 官方或社区提供，免费开源，非常适合撰写学术论文。

模板介绍 ：以 Elsevier 模板为例。Elsevier 是著名的学术出版社，其期刊具有统一的格式风格。Quarto 的 Elsevier 模板可以帮助我们直接生成符合 Elsevier 期刊要求的论文初稿，包括页面大小、字体、标题格式、参考文献样式等都已设置好。

获取方法 ：在 RStudio 的 Terminal 中运行以下命令：

quarto use template quarto-journals/elsevier

根据终端提示，输入 Y 信任作者，并输入目录名称 (例如 elsevier-paper-test)。Quarto 会从 GitHub 上的 quarto-journals/elsevier 仓库下载模板。随后它会新建  elsevier-paper-test 文件夹，里面包含一个示例文件 elsevier-paper-test.qmd 以及必要的资源文件。

在 RStudio 中打开和使用 ：展开新建的文件夹，双击打开 elsevier-paper-test.qmd。您会看到文档开头有一段 YAML 配置，包含题目、作者等占位符。下面是正文示例，包括章节、公式、图表引用等格式。此时您可以先尝试点击 Render 按钮进行渲染。RStudio 将生成 Elsevier 风格的 PDF 文件并在 Viewer 中预览。如果一切正常，您将看到 PDF 文档的版式与期刊模板一致：题目作者居中显示、两栏正文、参考文献格式符合理工科学术期刊规范。

最终效果 ：Elsevier 模板生成的论文外观专业，适合准备投稿国际期刊。渲染后可以看到论文题目、作者、摘要、关键词、正文、参考文献等都已经按照 Elsevier 期刊的标准排版，非常省心。(具体论文内容导入见第四部分)

3.2 模版示例2：Hikmah 学术论文模板

除了官方期刊格式，Quarto 也为很多科研工作者也提供了 美观通用的学术论文模板 。这里介绍由 Andrew Heiss 提供的 Hikmah Academic Quarto 模板。该模板注重清晰雅致的版式，非常适合一般学术论文写作和毕业论文等。

模板介绍 ：Hikmah (一词源自阿拉伯语“智慧”之意) 模板包含了一系列自定义格式。它提供了优雅的细致排版，包括：

• 精美 PDF 格式：版式美观的单栏论文 PDF，适合期刊初稿、自用论文。
• 稿件双倍行距 PDF：符合投稿要求的双倍行距版本，便于同行评审批注。
• 稿件双倍行距 Word：导出为 Word 格式，便于在微软 Word 中打开编辑。
• 稿件双倍行距 ODT：OpenDocument 格式，与 LibreOffice 兼容。
• 审稿意见回复：用于撰写回复审稿人意见的信函模板。

可以看出，Hikmah 模板几乎涵盖了论文写作的各个阶段需求，从初稿到投稿格式，再到审稿回复，非常贴心。

获取方法 ：在 RStudio Terminal 中输入以下命令：

quarto use template andrewheiss/hikmah-academic-quarto

首次使用请按提示信任作者，并输入目录名 (例如 hikmah-paper)。命令将从 GitHub 上

请到「今天看啥」查看全文