启用 GitLab 同步

为 GitBook 设置并授权 GitLab 集成

入门指南

在你想要与 GitLab 仓库同步的空间中，前往右上角的空间菜单，并选择 与 Git 同步并选择 GitLab Sync，然后点击 配置.

GitLab 同步配置选项。

生成并输入你的 API 访问令牌

你可以在 GitLab 用户设置中生成 API 访问令牌。

GitLab 中有两种访问令牌：项目令牌和个人令牌。请注意，为了使集成正常工作，你需要使用个人令牌，你可以从 GitLab 用户偏好设置菜单中生成它。

请确保为你的令牌启用以下访问权限：

• api

• read_repository

• write_repository

如果你创建的令牌还附带了特定角色，也请确保它具有 维护者 或 管理员 角色。

然后，在配置 GitLab 集成时，你可以将该令牌粘贴到 API 访问令牌字段中。

选择一个仓库和分支

选择你想要与 GitBook 内容保持同步的仓库。

找不到你的仓库？ 创建 API 令牌时，请确保你已设置正确的权限。

选择正确的仓库后，选择你希望提交推送到并同步自哪个分支。

对于许多 GitLab 仓库， main 分支可能会自动设置为受保护分支。如果是这样，我们建议添加一个特定分支来同步你的内容。然后，你可以将其合并到 main 中，并保持保护设置不变。

执行初始同步

首次同步时，你可以选择两个方向之一进行同步：

1. GitBook -> GitLab 将同步你空间的内容 所选分支。 如果你是从一个空仓库开始，并希望快速将 GitBook 内容导入，这会非常适合。

2. GitLab -> GitBook 将同步你空间的内容 自 所选分支。这非常适合你在仓库中已有 markdown 内容，并希望将其导入 GitBook 的情况。

编写并提交

你已经可以开始了。你会注意到，如果你的空间处于 实时编辑 模式下，实时编辑现在已被锁定。这使 GitBook 能够在你团队中的某人合并一个 更改请求 到 GitBook 时，我们就能可靠地将内容同步到你的仓库。

当你在 GitBook 中编辑时，每次变更请求合并都会在你选定的 GitLab 分支中生成一次提交。

当你提交到 GitLab 时，每次提交都会作为历史提交同步到你的 GitBook 空间。