内容变体

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

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

添加多种语言或版本

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

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

向文档站点添加变体

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

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

更改变体

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

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

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

重新排序变体

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

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

设置默认变体

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

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

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

从站点移除变体

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

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

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