内容变体

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

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

添加多种语言或版本

包含多个变体的站点适用于需要将空间内容分组的情况——例如记录多个版本的 API（v1、v2、v3 等），或以不同语言记录内容。

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

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

为变体设置语言后再添加多个变体会将语言选择器移动到右上角，从默认的变体选择器获得更简洁、更直接的体验。

向文档站点添加变体

在您的文档站点仪表盘中，打开 设置 选项卡位于站点页眉中，然后点击 结构。在这里您可以看到站点的所有内容。

要添加变体，请单击您想添加到的部分中的 添加变体 按钮，然后选择要链接的空间。新变体将被添加到所选部分的变体列表中，并将在您站点的变体下拉菜单中对访问者可用。

更改变体

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

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

来删除该变体。要将变体链接的空间替换为另一个空间，首先通过单击模态窗口左下方的 编辑 按钮将其删除，然后在模态窗口左下角点击 删除 按钮将其删除。删除变体后，单击 添加变体 按钮以添加新空间。

重新排序变体

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

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

设置默认变体

如果一个部分中有多个变体，其中一个变体将被标记为默认。访问者进入您的站点（或访问某个部分）时会显示此变体。其他变体各自有一个附加到站点 URL 的 slug。

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

将变体设置为默认会删除其 slug 字段，因为它将从部分根路径提供。GitBook 会将该变体的 slug 重定向到相应路径，以确保访问者继续看到您的内容。

从站点中移除变体

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

打开 操作菜单 并选择 移除.

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