Jamdesk Documentation logo

Onboarding Walkthrough

完成引导式入门流程,搭建首个文档站点:创建项目、连接 GitHub、配置 docs.json 并触发首次构建。

5 个步骤

1
开始试用

Jamdesk 会在您首次登录时开启 Pro 方案的 14 天免费试用。

  • 所有功能均已开启
  • 试用期于激活后 14 天结束
2
创建项目

为您的文档项目命名:

  • 使用清晰、具有描述性的名称(例如 "API Documentation"、"User Guide")
  • 该名称将成为文档站点 URL 的一部分
  • 之后可在项目设置中更改显示名称
3
连接 GitHub 并创建入门文档

Jamdesk 会基于 Starter Template 创建一个新的 GitHub 仓库:

  • 包含带有真实内容和组件的示例页面
  • 预先配置了包含导航和品牌设置的 docs.json
  • 提供用于 API 参考文档的 OpenAPI 规范示例
  • 可直接编辑并推送
4
安装 CLI

安装 Jamdesk CLI 以进行本地开发:

npm install -g jamdesk

此步骤为可选。您可以随时安装 CLI,或直接在 GitHub 上编辑文档。

5
开始编辑

编辑您的文档:

  • 通过 CLI:使用 jamdesk dev 在本地编辑文件
  • 通过 GitHub:直接在仓库中编辑 .mdx 文件
  • 在 Jamdesk 上:部分仪表板功能可用(取决于方案)

每次推送到 GitHub 都会触发一次重新构建。

入门完成后

接下来,您可以:

故障排除

我跳过了一步,如何返回?

可以。您可以随时从项目仪表板上的入门卡片完成入门设置。

我选错了 GitHub 仓库

请使用正确的仓库创建新项目。您可以随时删除旧项目。

入门过程中需要帮助

请联系支持团队。

相关文章

首次构建

触发并验证您的首次构建

仪表板导览

了解 Jamdesk 仪表板