快速入门

GitBook 的所见即所得 (WYSIWYG) 编辑器让您可以可视化地编辑内容，拖动内容块重新组织，并在编辑时查看内容的最终呈现效果。

这种可视化编辑工作流非常适合不想在代码编辑器中工作的用户，或有使用 Notion 或 Google 文档等工具经验的用户。

1. 在变更请求中编辑您的文档

首先，在侧边栏找到您的文档站点并点击其下方的项目。这会带您到内容所在的空间。

点击 编辑 位于右上角。此操作会打开一个变更请求，您可以在其中编辑该空间的内容。

点击 添加新内容… 在左侧的目录中添加页面，并为其命名标题。

2. 预览您的更改

在网页版应用的顶部，您会看到以下选项卡： 编辑器, 更改 和 预览。这些用于在不同的内容视图之间切换。

点击 预览 以查看包含变更请求中所有更改后的文档站点在桌面和移动端的实时预览。

3. 合并您的更改

当您对更改满意后，点击右上角的 合并 按钮。

这将使用变更请求中的所有编辑来更新内容的主要版本。如果该内容是某个实时文档站点的一部分，站点将立即更新。

将您的文档与 GitHub 或 GitLab 仓库同步以启用基于代码的编辑。同步后，您可以在现有的开发环境中编辑文档。

此工作流非常适合不想切换工具并偏好将文档与其他代码一起管理的技术用户。

1. 设置 Git 同步

如果创建站点时尚未设置 Git 同步，首先在侧边栏找到您的文档站点并点击其下方的内容名称。这会带您到内容所在的空间。

点击 设置 Git 同步 位于右上角的按钮，并按照说明将您的空间同步到所选的 Git 仓库。

前往 Git 同步页面 以了解更多信息。

2. 在开发环境中编辑您的文档

将空间与 Git 仓库同步后，您可以在开发环境中从该仓库更新文档内容。

打开仓库，创建一个拉取请求并进行您想要的更改。

3. 预览您的更改

您可以 从 GitHub 或 GitLab 的拉取请求在已发布的文档站点上预览更改 。

在您的拉取请求中，您会看到带有唯一预览 URL 的状态。点击该状态上的 详细信息 以打开预览 URL，查看拉取请求合并并更新站点后站点的呈现效果。

4. 合并您的更改

一切就绪后，合并您的拉取请求，您的内容将在 GitBook 应用和（如果站点已上线）您的文档站点上更新。

在 GitBook 应用中，每次提交和合并的拉取请求都会作为版本历史中的更新同步到您的空间。

您可以随时向站点添加更多内容，例如 API 参考、帮助中心或更新日志。添加内容时，您可以组织站点的导航栏，帮助用户更轻松地找到所需内容。

前往 概念页面 以了解有关站点导航的更多信息。

前往 站点结构页面 以了解有关向站点添加内容的更多信息。

您的文档站点开箱即用就会有良好展示，但您也可以自定义许多设置来更改已发布站点的外观和风格。

您可以自定义站点的 徽标、颜色和字体，使用 站点部分 和 变体向站点导航栏添加内容，更新您的 站点可见性 设置等更多内容。

您可以随时点击一次即可发布站点。

通过在侧边栏点击站点名称打开站点仪表板。然后点击 发布 右上角的按钮使其上线。

站点上线后，仪表板会更新并显示指向实时站点的链接。

默认情况下，您的站点将使用以下格式的唯一 URL 发布：

https://[organization-name].gitbook.io/[site-title]

尽管这对一些团队而言可能适用，但许多团队选择将其 URL 更改为 自定义域名 或 自定义子目录.

为此，通过在侧边栏点击站点名称打开站点仪表板，然后打开 设置 选项卡并选择 域名和 URL.

使用屏幕上的按钮选择所需选项，并按照说明向您的域名提供商配置 DNS 设置。