快速开始

GitBook 的所见即所得（WYSIWYG）编辑器允许你以可视化方式编辑内容，拖拽内容块进行重排，并在工作时查看内容的呈现效果。

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

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

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

点击 编辑 （右上角）。这会打开一个变更请求，你可以在其中编辑该空间的内容。

点击 新增… 在左侧目录中添加页面，并为其命名。

2. 预览你的更改

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

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

3. 合并你的更改

当你对更改感到满意时，点击 合并 按钮（右上角）。

这将用变更请求中的所有编辑更新你的主要内容版本。如果该内容属于一个已上线的文档站点，该站点会立即更新。

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

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

1. 设置 Git 同步

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

点击 设置 Git 同步 按钮（右上角），并按照指引将你的空间同步到所选的 Git 仓库。

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

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

将空间同步到 Git 仓库后，你可以在开发环境中通过该仓库更新文档内容。

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

3. 预览你的更改

你可以 预览你的更改 通过 GitHub 或 GitLab 中的拉取请求，在已发布的文档站点上进行。

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

4. 合并你的更改

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

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

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

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

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

你的文档站点开箱即用就很出色，但你也可以自定义许多设置来改变已发布站点的外观与风格。

你可以自定义站点的 徽标、颜色和字体，并通过以下方式为导航栏添加内容 站点分区 和 变体，更新你的 站点可见性 设置，以及更多内容。

你可以随时一键发布站点。

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

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

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

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

虽然这对一些团队来说已经合适，许多人会选择将 URL 更改为 自定义域名 或 自定义子目录.

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

使用屏幕上的按钮选择你想要的选项，并按照说明在域名服务商处配置 DNS 设置。