# コンテンツのバリアント

単一の docs サイトの一部として、同じドキュメントの複数バージョンを公開できます。これらのバリアントは、公開サイトの左上隅にあるスペース切り替えからエンドユーザーが利用できます。

<figure><img src="https://4217681718-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-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/site-structure/site-sections) の使用を検討してください。
{% endhint %}

翻訳版や複数言語をバリアントとして追加する場合は、ドキュメントを閲覧するユーザーに最適な体験を提供するため、バリアントの言語を設定するのがベストプラクティスです。

言語を設定した複数のバリアントを追加すると、言語ピッカーは右上に移動し、既定のバリアントピッカーよりもすっきりとした、より直接的な操作体験になります。

### docs サイトにバリアントを追加する

ドキュメントサイトのダッシュボードから **設定** タブをサイトヘッダーで開き、次に **構造**。ここでサイトのすべてのコンテンツを確認できます。

バリアントを追加するには、追加したいセクションの **バリアントを追加** ボタンをクリックし、リンクするスペースを選択します。すると、新しいバリアントが選択したセクション内のバリアント一覧に追加され、サイトのバリアントのドロップダウンから訪問者が利用できるようになります。

### バリアントを変更する

編集したいバリアントの行にある <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://4217681718-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://app.gitbook.com/s/NkEGS7hzeqa35sMXQZ4X/publishing-documentation/site-structure/multilingual-sections).

{% hint style="info" %}
リンクされたスペースのスラッグを変更すると、そのスペースの正規URLが変更されます。GitBook は古い URL から新しい URL への自動リダイレクトを作成します。また、 [リダイレクトを手動で作成することもできます](https://gitbook-v2-q67etdj25-gitbook.vercel.app/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/site-redirects).
{% endhint %}

バリアントにリンクされたスペースを別のスペースに置き換えるには、まずその **編集** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://4217681718-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://4217681718-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> をつかんで上下に移動することで並べ替えられます。順序の変更はすぐにサイトに反映されます。

スペースバーでセクションまたはバリアントを選択し、矢印キーで上下に移動することでもコンテンツを移動できます。もう一度スペースバーを押して、新しい位置を確定します。

### 既定のバリアントを設定する

1つのセクション内に複数のバリアントがある場合、そのうち1つが既定としてマークされます。訪問者がサイトにアクセスしたとき（またはセクションを訪問したとき）に、このバリアントが表示されます。その他のバリアントにはそれぞれ slug があり、サイトの URL に追加されます。

バリアントを既定に設定するには、 **アクションメニュー** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://4217681718-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://4217681718-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 %}
