专栏名称: 连享会
连玉君老师团队分享,主页:lianxh.cn。白话计量,代码实操;学术路上,与君同行。
目录
相关文章推荐
鲁中晨报  ·  北大回应韦东奕健康问题 ·  昨天  
微观三农  ·  黄土高原区集雨补灌水肥一体化技术模式 ·  3 天前  
51好读  ›  专栏  ›  连享会

Quarto 助力论文和讲义撰写

连享会  · 公众号  ·  · 2025-06-06 22:00

正文

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


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 上







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