内容变体

在单个站点中为多个产品版本或语言发布文档

您可以在单个文档站点中发布同一文档的多个版本。这些变体将在已发布站点的左上角通过空间切换器提供给最终用户。

添加多种语言或版本

具有多个变体的站点在您需要将空间内容分组时很有用——例如记录多个版本的 API（v1、v2、v3 等）或以不同语言记录内容时。

您链接的空间可以包含任何内容，但建议将变体用作 相同内容的变体。如果您链接的空间在语义上彼此不同，考虑将它们作为 站点章节 来添加。

在将翻译或多种语言作为变体添加时，最佳做法是为变体设置语言，以便用户在浏览文档时获得最佳体验。

为变体设置语言后，语言选择器将移至右上角，这比默认的变体选择器提供更简洁、更直接的体验。

向文档站点添加变体

在文档站点的仪表板中，打开 设置 选项卡（位于站点头部），然后点击 结构。在此处您可以看到站点的所有内容。

要添加变体，请点击 添加变体 按钮（位于您希望添加的章节中），然后选择要链接的空间。新变体将添加到所选章节的变体列表中，并将在站点的变体下拉菜单中对访问者可用。

更改变体

您可以通过点击要编辑的变体所在表格行中的 编辑 按钮来更改每个变体的名称和别名（slug）。这将打开一个模态窗口。编辑您想更改的字段，然后点击 保存 按钮以保存。您也可以通过点击 删除变体 按钮（位于左下角）来删除该变体。

更改已链接空间的别名（slug）将更改该空间的规范 URL。GitBook 会自动从旧 URL 创建到新 URL 的重定向。您也可以 手动创建重定向.

要用不同的空间替换变体所链接的空间，首先点击其 编辑 按钮将其删除，然后在模态窗口左下角点击 删除 按钮。一旦变体被删除，点击 添加变体 按钮以添加新空间。

重新排序变体

站点按它们在您的 站点结构 表中出现的顺序显示变体。可以通过抓住 拖动手柄 并将其向上或向下移动来重新排序变体。更改后的顺序将立即在您的站点上反映。

您也可以使用键盘选择并移动内容：用空格键选择一个章节或变体，然后使用方向键将其向上或向下移动。再次按空格键以确认新位置。

设置默认变体

如果某个章节中有多个变体，其中一个变体将被标记为默认。当访客到达您的站点（或访问某个章节）时，会显示该默认变体。其他变体各有一个附加到站点 URL 的别名（slug）。

要将某个变体设为默认，请在变体的表格行中点击 操作菜单 ，然后点击 设为默认.

将变体设为默认会移除其别名字段，因为它将从章节根路径提供。GitBook 会将该变体的别名重定向到相应路径，以确保访客继续看到您的内容。

从站点中移除变体

要从站点中移除变体，请在文档站点仪表板中打开 设置 选项卡，然后点击 结构 以查找您要移除的内容。

打开 操作菜单 您要移除的变体的 并选择.

从站点中移除变体将把它从已发布站点中移除，但 不会删除该空间或其中的内容.