快速入门

GitBook 的所见即所得（WYSIWYG）编辑器让你可以直观地编辑内容、拖动内容块重新排列，并在工作时实时查看内容外观。

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

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

首先，在侧边栏中找到你的文档站点，然后点击其下方的项目。这会带你进入内容所在的空间。

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

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

2. 预览你的更改

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

点击 预览 查看在变更请求中的所有更改应用后，你的文档站点在桌面端和移动端上的实时预览效果。

3. 合并你的更改

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

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

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

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

1. 设置 Git Sync

如果你在创建站点时还没有设置 Git Sync，请先在侧边栏中找到你的文档站点，然后点击其下方内容的名称。这会带你进入内容所在的空间。

点击 设置 Git Sync 右上角的按钮，并按照说明将你的空间同步到你选择的 Git 仓库。

前往 Git Sync 页面 了解更多。

2. 从你的开发环境编辑文档

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

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

3. 预览你的更改

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

在你的拉取请求中，你会看到一个带有唯一预览网址的状态。点击该状态上的 详情 以打开预览网址，查看拉取请求合并并更新站点后，你的网站将呈现的效果。

4. 合并你的更改

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

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

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

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

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

你的文档站点开箱即用就已经很不错，但你也可以自定义许多会改变已发布站点外观和风格的设置。

你可以自定义站点的 标志、颜色和字体，并使用 站点分区 和 变体将其添加到站点导航栏，还可以更新 站点可见性 设置等更多内容。

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

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

站点上线后，仪表板将更新并显示在线站点的链接。

默认情况下，你的站点将通过以下格式的唯一网址发布：

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

虽然这对某些团队来说已经足够合适，但很多团队会选择将网址改为 自定义域名 或 自定义子目录.

为此，请通过点击侧边栏中的站点名称打开站点仪表板，然后打开 设置 标签页并选择 域名和 URL.

使用屏幕上的按钮选择你想要的选项，并按照说明通过你的域名提供商配置 DNS 设置。