你的首次构建
连接代码仓库后会发生什么:构建阶段、部署标签页,以及构建失败时需要检查的内容。
自动构建
连接代码仓库后,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。
如果你配置了自定义域名,文档也会显示在该域名上。
手动重新构建
在不推送更改的情况下重新构建:
- 在 仪表板 中进入你的项目
- 打开 Settings
- 点击 Rebuild
在更改环境变量后,或需要强制进行全新构建时,可以使用此方法。
构建失败时
仪表板会为失败的构建显示错误信息。常见原因包括:
docs.json语法无效- MDX 语法错误
- 导航中引用的页面缺失
