快速入门

GitBook 的所见即所得 (WYSIWYG) 编辑器让你以可视化方式编辑内容，拖动内容块以重新组织，并在编辑时查看内容的显示效果。

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

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

首先，在侧边栏中找到你的文档站点并点击其下方的项目。此操作会将你带到存放内容的空间。

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

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

2. 预览你的更改

在 Web 应用的顶部，你会看到用于以下内容的标签页： 编辑器, 更改 和 预览。这些用于在内容的不同视图之间切换。

点击 预览 以查看变更请求中所有更改在桌面和移动端的实时预览，查看你的文档站点将如何展示。

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 设置。