常见问题解答

如果你是 R Markdown 用户，想知道 Quarto 和 R Markdown 之间的关系，请参阅我们的 R Markdown 用户常见问题解答。

我可以使用 Quarto 做什么？

Quarto® 是一个基于 Pandoc 的开源科学和技术出版系统。你可以将叙述性文本和代码编织在一起，生成优雅格式的输出，如文档、网页、博客文章、书籍等。

如何安装 Quarto？

访问 Quarto.org - 入门页面，该页面提供了适用于 Windows、Mac OS 和 Linux 的安装说明。

Quarto 是免费使用的吗？

是的！Quarto 是开源的。Quarto 1.3 版本（及更早版本）根据 GNU GPL v2 授权。Quarto 1.4 版本根据 MIT 许可证 授权。

Quarto 可以创建哪些输出格式？

Quarto 提供了多种输出格式。这包括所有内置的 Pandoc 格式（如 HTML、PDF、MS Word、Revealjs、ePub 等）以及多种发布多文档的方式（网站、博客和书籍）。了解更多信息请访问 Quarto 格式。

我可以使用哪些编辑工具与 Quarto 配合？

你可以使用多种工具与 Quarto 配合。我们提供了在 VSCode、JupyterLab、RStudio IDE 或任何文本编辑器中编写和编辑 Quarto 文档的文档。访问 Quarto 入门页面 进行安装，然后选择你的工具以获取简短的入门指南。

我可以将 Jupyter 笔记本与 Quarto 一起使用吗？

可以！Quarto 可以渲染 Jupyter 笔记本，你可以使用 Jupyter、JupyterLab 或任何其他 .ipynb 笔记本编辑器与 Quarto 配合。你可以使用 Quarto 直接渲染现有的 .ipynb 笔记本，但添加 Quarto 特定的输出选项或 YAML 头部可以增强输出效果。访问 JupyterLab 页面 获取更多信息。

Quarto 支持哪些编程语言？

Quarto 主要支持的编程语言是 Python、R、Julia 和 Observable JavaScript。通过与 Jupyter 的集成，还可以使用许多其他语言。

每个 Quarto 文档可以选择性地由计算引擎处理（引擎可以手动指定或根据代码块自动检测）。当前的引擎包括 Knitr（也由 R Markdown 使用，支持多种语言，如 R、Python 和 Julia 等）和 Jupyter（支持许多语言，包括 Python、Julia 和 R）。有关更多详细信息，请参阅引擎绑定的文档。

Quarto 支持哪些人类语言？

你可以使用你选择的人类语言编写 Quarto 文档。lang 文档选项用于使用 IETF 语言标签（遵循 BCP 47 标准）标识文档的主要语言，如 en 或 en-GB。

我可以使用 Quarto 开发专有内容吗？

可以！Quarto 的版权不涵盖你使用 Quarto 生成的原始内容。使用 Quarto 创建原始内容在法律上不会对你选择的原始内容许可证施加任何限制，也不会“延伸”影响到你可能使用 Quarto 编写文档的软件。

但当导出的 HTML 文档包含 Quarto 的样式或功能时，GPL 不涵盖这些文档吗？

它涵盖样式或功能本身。它不涵盖你的原始内容，因为你的原始内容不是 Quarto 样式或功能的衍生作品。

如何分享文档并让人们评论它们？

你可以将 Quarto 内容发布到多个位置。有关使用 Quarto Pub、GitHub Pages、Netlify、Posit Connect 和其他服务与 Quarto 配合的详细信息，请参阅发布的用户指南。一旦文档发布，你可以使用 hypothes.is、Utterances 或 Giscus 进行评论。在评论的文档中了解更多信息。

我可以与 Quarto 进行协作编辑吗？

Quarto 目前还没有专门用于协作编辑的功能。你可以像当前处理任何文本或代码文件一样协作编辑 .qmd 文件。

Posit Workbench 允许进行项目共享，以便在同一文档上进行交互式编辑和协作。 ### 我可以在哪里发布 Quarto 网站？

有多种方式可以发布 Quarto 网站。网站内容默认会写入 \_site 子目录（你可以使用 output-dir 选项自定义此目录）。发布只需将输出目录复制到网络服务器或网络托管服务即可。

发布文档 描述了几种方便的 Quarto 网站部署选项，包括 Posit Connect、Netlify、GitHub Pages、Firebase、Site44 和 Amazon S3。我们主要参考这些服务的文档，但会指出任何 Quarto 网站特定的配置要求。

Posit Connect 支持 Quarto 吗？

是的！你可以将 Quarto 内容发布到 Posit Connect v2021.08.0 或更高版本。Quarto 需要按照 Posit Connect 管理员指南 中的说明启用。Connect 的用户 文档 引用了 Quarto.org 文档 中关于如何从 RStudio IDE 发布的说明。要发布基于 Python 的 Quarto 内容，你可以从各种位置使用 rsconnect-python CLI，包括 VSCode、JupyterLab 或终端。

Quarto 的开发者是谁？

Quarto 的开发由 Posit, PBC 赞助。Quarto 和 R Markdown 的核心团队是同一组人：

这里是 完整的贡献者列表。Quarto 是开源的，我们欢迎在 GitHub 仓库中贡献！https://github.com/quarto-dev/quarto-cli。

为什么叫 Quarto？

我们希望使用一个在出版历史中有意义的名字，最终选择了 Quarto，这是一种书籍或小册子的格式，由全张纸印刷，每张纸上有八页文本，每面四页，然后折叠两次，产生四张叶子。已知最早的欧洲印刷书籍是 Quarto 格式的，即 Sibyllenbuch，据信由 Johannes Gutenberg 在 1452-53 年印刷。

我可以在哪里报告错误或请求功能？

感谢你发现并分享给我们！你可以在 Quarto 仓库中提交问题 https://github.com/quarto-dev/quarto-cli/issues。

我可以在哪里提问并与他人讨论使用 Quarto？

提问和查看其他人问题的最佳地点是在 Quarto 讨论区 (https://github.com/quarto-dev/quarto-cli/discussions)。