内容变体

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

您可以将同一文档的多个版本作为单个文档站点的一部分发布。这些变体将可供最终用户通过已发布站点左上角的空间切换器访问。

添加多种语言或版本

如果您需要将各个空间的内容整合在一起，例如记录 API 的多个版本（v1、v2、v3 等），或以不同语言记录您的内容，那么拥有多个变体的站点会很有用。

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

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

添加多个已设置语言的变体后，语言选择器将移至右上角，相比默认的变体选择器，体验会更简洁、更直接。

向您的文档站点添加变体

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

要添加变体，请单击您要添加到的部分中的 添加变体 按钮，然后选择要链接的空间。新变体随后会添加到所选部分的变体列表中，并可在您站点的变体下拉菜单中供访客使用。

更改变体

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

如果您的站点支持多种语言，您还可以翻译变体标题，以便选择器显示本地化标签。请参见 多语言分区.

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

要用另一个空间替换变体链接的空间，请先单击其 编辑 按钮将其删除，然后点击弹窗左下角的 删除 按钮（位于弹窗左下角）将其删除。删除变体后，单击 添加变体 按钮添加新空间。

重新排序变体

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

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

设置默认变体

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

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

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

从站点中移除变体

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

打开 操作菜单 该变体，然后选择 移除.

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