内容变体

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

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

添加多种语言或版本

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

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

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

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

向文档站点添加变体

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

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

更改变体

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

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

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

重新排序变体

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

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

设置默认变体

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

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

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

从站点中移除变体

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

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

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