Jamdesk Documentation logo

你的首次构建

连接代码仓库后会发生什么:构建阶段、部署标签页,以及构建失败时需要检查的内容。

自动构建

连接代码仓库后,Jamdesk 会立即开始首次构建。之后每次推送到已连接分支,都会触发一次新的构建。

构建进度

在仪表板中跟踪构建进度:

1
排队中

你的构建正在等待开始。高峰时段可能会有短暂排队。

2
克隆中

Jamdesk 从 GitHub 拉取你的代码仓库内容。

3
验证中

Jamdesk 检查你的 docs.json 和 MDX 文件是否存在错误。

4
构建中

Jamdesk 将 MDX 编译为带语法高亮和搜索索引的 HTML。

5
部署中

构建生成的文件上传到全球 CDN。

6
已上线

你的文档可通过项目 URL 访问。

查看已上线的文档

在仪表板中点击 View Site,或访问 https://your-project.jamdesk.app。

如果你配置了自定义域名,文档也会显示在该域名上。

手动重新构建

在不推送更改的情况下重新构建:

  1. 在 仪表板 中进入你的项目
  2. 打开 Settings
  3. 点击 Rebuild

在更改环境变量后,或需要强制进行全新构建时,可以使用此方法。

构建失败时

仪表板会为失败的构建显示错误信息。常见原因包括:

  • docs.json 语法无效
  • MDX 语法错误
  • 导航中引用的页面缺失
构建错误参考

查看常见错误代码及修复方法

相关文章

触发构建

了解自动和手动构建触发方式

监控构建

跟踪构建进度并查看日志