快速入门

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 的拉取请求中查看你已发布文档站点上的预览。

在你的拉取请求中，你会看到一个带有唯一预览 URL 的状态。点击 详情 即可打开该预览 URL，并查看当拉取请求被合并、站点更新后，你的网站会是什么样子。

4. 合并你的更改

你已经可以继续了。合并你的拉取请求后，你的内容会同时在 GitBook 应用和你的文档站点中更新——如果该站点是在线的。

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

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

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

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

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

你可以自定义站点的 Logo、颜色和字体，使用 网站部分 并 变体将其添加到站点导航栏，并更新你的 站点可见性 设置等等。

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

点击侧边栏中的站点名称，打开站点控制台。然后点击 发布 右上角按钮即可让其上线。

站点上线后，控制台会更新，并提供一个指向在线站点的链接。

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

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

这对某些团队来说可能已经足够，但很多团队会选择将 URL 更改为 自定义域名 或 自定义子目录.

要执行此操作，请点击侧边栏中的站点名称以打开站点控制台，然后打开 设置 标签页并选择 域名和 URL.

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