入门指南
完成引导式入门流程,创建项目、连接 GitHub、配置 docs.json 并触发首次构建,搭建您的首个文档站点。
5 个步骤
1
开始试用首次登录时,Jamdesk 会自动为您启动 Pro 方案的 14 天免费试用。
- 完整访问所有功能
- 试用期从激活之日起持续 14 天
2
创建项目为您的文档项目命名:
- 使用清晰且具有描述性的名称(例如“API 文档”“用户指南”)
- 该名称会成为文档站点 URL 的一部分
- 您可以稍后在项目设置中更改显示名称
3
连接 GitHub 并创建入门文档Jamdesk 会根据 入门模板 创建新的 GitHub 仓库:
- 包含真实内容和组件的示例页面
- 预配置的
docs.json,包含导航和品牌设置 - 用于 API 参考文档的 OpenAPI 规范示例
- 可立即编辑并推送
4
安装 CLIJamdesk CLI 支持本地开发:
npm install -g jamdesk您可以在入门过程中跳过此步骤,随时安装 CLI。即使跳过,您仍然可以直接在 GitHub 上编辑文档。
5
开始编辑现在可以开始构建了!编辑您的文档:
- 通过 CLI:使用
jamdesk dev在本地编辑文件 - 通过 GitHub:直接在仓库中编辑
.mdx文件 - 在 Jamdesk 上:部分仪表板功能可用(具体取决于方案)
推送到 GitHub 后,更改会自动触发文档重新构建。
入门完成后
完成入门流程后,您可以:
故障排除
我跳过了一步,如何返回?
您可以随时从项目仪表板完成入门流程。找到入门卡片,即可从上次中断的位置继续。
我选错了 GitHub 仓库
使用正确的仓库创建新项目。您可以随时删除旧项目。
入门过程中需要帮助
您可以随时联系支持团队。
