# 内容变体

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

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F2cQxJ5sTMVUkXOcuDEU8%2FAdding%20a%20section%402x.png?alt=media&#x26;token=2bd96c5f-0945-4d86-a835-a94102e627d9" alt="A GitBook screenshot showing a docs site&#x27;s structure"><figcaption></figcaption></figure>

### 添加多种语言或版本

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

{% hint style="info" %}
您链接的空间可以包含任何内容，但建议将变体用作 *相同内容的不同版本*。如果您链接的空间在语义上彼此不同，请考虑将它们添加为 [网站部分](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/docs-site/site-structure/site-sections) 。
{% endhint %}

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

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

### 向您的文档站点添加变体

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

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

### 更改变体

您可以通过单击您想编辑的变体所在表格行中的 <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FA3OfGjPkE5GnOQvN36jN%2Fedit.svg?alt=media&#x26;token=6f70239f-d889-4e64-9ec6-4801df47a48d" alt="The Edit icon in GitBook"></picture> **编辑** 按钮来更改每个变体的名称和 slug。这将打开一个弹窗。编辑您想更改的字段，然后单击 **保存** 按钮保存。您也可以通过单击 **删除变体** 按钮来删除该变体。

如果您的站点支持多种语言，您还可以翻译变体标题，以便选择器显示本地化标签。请参见 [多语言分区](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/docs-site/site-structure/multilingual-sections).

{% hint style="info" %}
更改已链接空间的别名（slug）将更改该空间的规范 URL。GitBook 会自动将旧 URL 重定向到新 URL。您还可以 [手动创建重定向](https://gitbook-v2-5hpihs24d-gitbook.vercel.app/url/gitbook.com/docs/documentation/zh/docs-site/site-redirects).
{% endhint %}

要用另一个空间替换变体链接的空间，请先单击其 **编辑** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FA3OfGjPkE5GnOQvN36jN%2Fedit.svg?alt=media&#x26;token=6f70239f-d889-4e64-9ec6-4801df47a48d" alt="The Edit icon in GitBook"></picture> 按钮将其删除，然后点击弹窗左下角的 **删除** 按钮（位于弹窗左下角）将其删除。删除变体后，单击 **添加变体** 按钮添加新空间。

### 重新排序变体

您的站点会按照变体在您的 **网站结构** 表格中的显示顺序进行展示。可以通过拖动 **拖动手柄** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FaS1QvPIBVYwhpFTGcPBN%2Foptions-menu.svg?alt=media&#x26;token=3ee40bbf-f4fb-41fa-aa30-306b559cbe88" alt="The Options menu icon in GitBook"></picture> 并将其上下移动来重新排序。更改后的顺序会立即反映在您的网站上。

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

### 设置默认变体

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

要将某个变体设为默认，请单击 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 在该变体表格行中的，然后单击 **设为默认**.

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

### 从站点中移除变体

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

打开 **操作菜单** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 该变体，然后选择 **移除**.

{% hint style="success" %}
从站点中移除变体会将其从已发布站点中移除，但是 **不会删除该空间或其中的内容**.
{% endhint %}
