PDF 导出

从仪表板将文档站点导出为单个 PDF。Jamdesk 会将每个已发布页面渲染到一个文件中，准备就绪后通过电子邮件发送下载链接，并在下一次文档构建前保留 PDF 供重新下载。

PDF 导出适用于：

• 与无法访问仪表板的评审人员共享文档
• 在飞机上、安全设施或客户现场离线阅读
• 保存特定提交的合规与审计快照
• 准备客户交接材料

谁可以使用

每个付费计划均免费包含 PDF 导出，无需购买附加功能。每个项目每天最多可生成 3 个 PDF，计数器在 UTC 午夜重置。

生成 PDF

多语言项目

如果你的 docs.json 配置了多种语言，Generate PDF 按钮旁边会出现语言下拉菜单。

{
  "navigation": {
    "languages": [
      { "language": "en", "default": true },
      { "language": "es" },
      { "language": "fr" }
    ]
  }
}

每次导出仅涵盖一种语言。若要将三种语言的 PDF 全部提供给评审人员，请选择 en 并导出，然后选择 es 并导出，最后选择 fr 并导出。

缓存与重新生成

Settings 页面仅记住每个项目最近一次完成的导出。当你点击 Regenerate 时，Jamdesk 会检查上一次导出是否同时匹配当前构建和所请求的语言环境：

• 构建和语言环境相同 → 立即返回缓存的 PDF。你会看到一条通知，说明自上次导出后没有任何变化。
• 构建更新或语言环境不同 → 开始全新渲染。点击 Rebuild 会被视为新构建，即使提交没有变化。

由于缓存只有一个位置，导出第二种语言或新构建会替换之前的内容。之前的 PDF 不会被删除，但不会再显示在 Settings 页面上。

更新文档后，如需获取新的 PDF：

可以放心地多次点击 Regenerate。如果没有完成新的构建，系统不会重新渲染或再次发送电子邮件。

速率限制

每个项目有两项限制：

• **每天完成 3 次导出。**计数器在 UTC 午夜重置。仪表板会显示已使用的次数。
• **两次导出之间间隔 5 分钟。**在该时间窗口内发出的请求会返回 Try again in a few minutes。

缓存命中（与上一次导出使用相同构建和语言环境）不受这两项限制影响，因此重复下载未更改的 PDF 不会触发限制。

生成超过二十分钟的 PDF 会被视为过期任务。你可以再次点击 Generate PDF 重新加入队列。

导出内容

PDF 包含所选语言的 docs.json 导航中列出的每个页面，并按照声明顺序排列。导航中的外部链接会被跳过。孤立页面（仓库中存在但未接入导航的文件）不会被包含。

每个页面都会通过读者访问的相同 URL（https://<slug>.jamdesk.app/<path>）进行渲染，因此浏览器中显示的内容也会显示在 PDF 中。

受密码保护的站点

如果你的站点受密码保护，则不会生成 PDF。请先禁用密码保护以运行导出，完成后再重新启用。

电子邮件发送

PDF 准备就绪后，点击 Generate PDF 的用户会收到一封电子邮件，其中包含返回 Settings → PDF Exports 部分的链接，以及页数、时间戳和语言环境（适用于多语言项目）。仪表板本身也会实时切换到就绪状态；无需依赖电子邮件即可下载。

只有请求者会收到电子邮件。其他协作者下次打开 Settings 页面时即可看到新的 PDF。

下载链接有效期

电子邮件下载链接自 PDF 完成之时起 72 小时内有效。每次打开 Settings 页面时，仪表板都会生成新的 URL，因此从仪表板下载不会过期。如果电子邮件链接返回 403，请前往仪表板并在那里点击 Download PDF。

故障排除

下一步