快速入门

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