Quarto 不完全指北 · 第一节 下载

Quarto 是 R 语言开发团队 Posit 开发的新一代开源出版工具，用于替换 Rmarkdown,并且在一定程度上具有学术写作的能力，甚至可以它创建一个网站，基于 Pandoc 和 Deno （你可以在 Quarto 的安装目录里找到这两个工具）。不仅对于 R 的支持良好，而且对于 Python, Julia, Obeserve 都有良好支持。

由于是一个新的工具，官方的文档没有对于中文的支持，因此这篇博客记录了 Quarto 的基本使用方法。

环境配置

Quarto 可以使用以下方式下载。注意，无论是哪一种，都需要良好的网络支持。

• 使用winget命令

  winget install --id Posit.Quarto
  

• 在官网上选择合适的版本进行下载

在 cmd 中输入

quarto --version

出现一段数字即下载成功。

附加组件的下载

Quarto 有两个附加组件：

• TinyTex
• Chromium

可以使用

quarto list tools

查看附加组件的下载情况，正常情况应该出现类似下面的提示

[✓] Inspecting tools

Tool         Status            Installed     Latest
chromium     Not installed     ---           869685
tinytex      Up to date        v2022.10      v2022.10

TinyTex

TinyTex 是 Texlive 的一个发行版，Quarto-Pandoc 依赖它编译 qmd 文件为 pdf 格式。不过如果系统的环境变量中已经有了 Tex Live，则 Quarto 会自动使用，不用下载 TinyTex。

另外，Quarto 只对 Tex Live 进行了适配，如果使用外部 Tex 系统，只推荐使用 Tex Live。

下载 TinyTex

quarto install tinytex

升级 TinyTex

quarto update tinytex

使用 Quarto 下载的 TinyTex 默认是不会添加到环境变量的，也就是说，如果没有其它 Tex 发行版，在 cmd 中输入latex或xelatex会得到“'xxx' 不是内部或外部命令，也不是可运行的程序或批处理文件。”这样的提示。如果想独立使用 TinyTex，需要使用

quarto install tinytex --update-path

Chromium

Quarto 使用 Chromium 对 HTML 文件进行预览，如果系统中已经有了 Chromium 系浏览器如 Chrome, Edge, 360 极速浏览器, VSCode等则不用下载。

下载 Chromium

quarto install Chromium

升级 Chromium

quarto update Chromium