发布 HTML

概览

本文涵盖了多种发布 Quarto HTML 文档的方式，包括发布到托管服务或通过电子邮件、Dropbox 等分享独立的 HTML 文件。

请注意，也可以将一系列 Quarto 文档作为网站发布。有关更多详细信息，请参阅发布基础的文章。

发布命令

quarto publish 命令提供了一种直接的方式，可以将文档发布到 Quarto Pub、GitHub Pages、Netlify 和 Posit Connect。

例如，以下是将 document.qmd 发布到这些服务的命令：

终端

quarto publish quarto-pub document.qmd
quarto publish gh-pages document.qmd
quarto publish netlify document.qmd
quarto publish connect document.qmd

对于单个文档的简单发布，quarto publish 之外不需要学习太多。

以下是对各种支持的服务及其适用场景的简要概述：

目的地	描述
Quarto Pub	Quarto 文档、网站和书籍的发布服务。当你想要一个免费且易于使用的服务来发布公开内容时，使用 Quarto Pub。
GitHub Pages	基于托管在 GitHub 仓库中的源代码发布内容。当你的文档或站点的源代码托管在 GitHub 上时，使用 GitHub Pages。
Posit Connect	用于在组织内部安全共享数据产品的发布平台。当你希望在组织内部而非公共互联网上发布内容时，使用 Posit Connect。
Posit Cloud	从网页浏览器创建数据项目并发布结果。当你希望将所有静态文档和交互式应用程序组织在一个地方时，使用 Posit Cloud。
Netlify	专业的网页发布平台。当你需要支持自定义域名、身份验证、预览分支及其他更高级功能时，使用 Netlify。
其他服务	使用 Quarto 渲染的内容采用标准格式（HTML、PDF、MS Word 等），可以在任何地方发布。如果上述方法不符合你的需求，可以使用此选项。

请注意，上述文档通常涉及发布整个项目（网站或书籍），但如果如上所示发布单个文档或演示文稿，所有命令的工作方式完全相同。

独立 HTML

你可以选择将 Quarto 文档渲染成自包含的 HTML，其中所有渲染文章所需的资源（由绘图生成的图像、所需的 CSS 和 JavaScript 等）都被打包到一个 HTML 文件中。使用 embed-resources 选项来实现这一点：

format:
  html:
    embed-resources: true

然后，你可以通过你用来分享其他文档类型（如电子表格、演示文稿和 PDF）的方式来分享这个 HTML 文件（例如，通过上传到 Dropbox 或其他文件共享服务）。

请注意，当使用 embed-resources: true 时，默认情况下不会嵌入像 MathJax 和 KaTeX 这样的数学库，因为它们体积较大且下载耗时。如果你确实希望嵌入数学库，请添加 self-contained-math: true 选项：

format:
  html:
    embed-resources: true
    self-contained-math: true