# コンテンツバリアント
単一のドキュメントサイトの一部として、同じドキュメントの複数のバージョンを公開できます。これらのバリアントは、公開サイトの左上隅にあるスペース切り替えからエンドユーザーが利用できます。
### 複数の言語またはバージョンを追加する
複数のバリアントを持つサイトは、スペースのコンテンツをまとめる必要がある場合に便利です。たとえば、API の複数のバージョン（v1、v2、v3 など）をドキュメント化している場合や、コンテンツを異なる言語でドキュメント化している場合です。
{% hint style="info" %}
リンクするスペースにはどのようなコンテンツでも含められますが、バリアントは次のようなものとして使うことが推奨されます *同じコンテンツのバリエーション*。リンクするスペースが意味的に互いに異なる場合は、次のように追加することを検討してください [サイトセクション](/docs/documentation/ja-gitbook-documentation/docs-site/site-structure/site-sections.md) の代わりに行うことをおすすめします。
{% endhint %}
翻訳や複数の言語をバリアントとして追加する場合は、ドキュメントを移動する際にユーザーに最適な体験を提供できるよう、バリアントの言語を設定するのがベストプラクティスです。
言語を設定した複数のバリアントを追加すると、言語ピッカーが右上に移動し、既定のバリアントピッカーよりもすっきりとした、より直接的な操作体験になります。
### ドキュメントサイトにバリアントを追加する
ドキュメントサイトのダッシュボードから、 **設定** サイトヘッダー内のタブを開き、次に **構造**。ここでサイトのすべてのコンテンツを確認できます。
バリアントを追加するには、追加したいセクションの **バリアントを追加** ボタンをクリックし、リンクするスペースを選択します。すると新しいバリアントが選択したセクション内のバリアント一覧に追加され、サイト上のバリアントのドロップダウンで訪問者が利用できるようになります。
### バリアントを変更する
編集したいバリアントの行にある **編集** ボタンをクリックすると、各バリアントの名前とスラッグを変更できます。これによりモーダルが開きます。変更したいフィールドを編集し、次に **保存** ボタンをクリックして保存します。また、 **バリアントを削除** ボタンを左下でクリックしてバリアントを削除することもできます。
サイトが複数の言語をサポートしている場合は、ピッカーにローカライズされたラベルが表示されるように、バリアントのタイトルを翻訳することもできます。参照してください [多言語セクション](/docs/documentation/ja-gitbook-documentation/docs-site/site-structure/multilingual-sections.md).
{% hint style="info" %}
リンクされたスペースのスラッグを変更すると、そのスペースの正規 URL が変更されます。GitBook は古い URL から新しい URL への自動リダイレクトを作成します。さらに、 [手動でリダイレクトを作成する](/docs/documentation/ja-gitbook-documentation/docs-site/site-redirects.md).
{% endhint %}
バリアントにリンクされたスペースを別のスペースに置き換えるには、まずその **編集** ボタンをクリックして削除し、次にモーダル左下の **削除** ボタンをモーダルの左下でクリックして削除します。バリアントが削除されたら、 **バリアントを追加** ボタンをクリックして新しいスペースを追加します。
### バリアントの並べ替え
サイトでは、バリアントが **サイト構造** テーブルに表示される順序で表示されます。バリアントは、 **ドラッグハンドル** をつかんで上下に移動することで並べ替えできます。変更された順序はすぐにサイトに反映されます。
スペースバーを使ってコンテンツを選択して移動することもできます。セクションまたはバリアントをスペースバーで選択し、矢印キーで上下に移動します。もう一度スペースバーを押すと、新しい位置が確定します。
### 既定のバリアントを設定する
1つのセクション内に複数のバリアントがある場合、そのうち1つが既定としてマークされます。このバリアントは、訪問者がサイトにアクセスしたとき（またはセクションを開いたとき）に表示されます。ほかのバリアントにはそれぞれスラッグがあり、サイトのURLに付加されます。
バリアントを既定に設定するには、 **アクションメニュー** バリアントのテーブル行にあるそれをクリックしてから、 **デフォルトとして設定**.
{% hint style="info" %}
をクリックします。バリアントを既定に設定すると、配信はセクションのルートから行われるため、そのスラッグフィールドは削除されます。GitBook は、訪問者が引き続きコンテンツを見られるように、バリアントのスラッグを適切なパスにリダイレクトします。
{% endhint %}
### サイトからバリアントを削除する
サイトからバリアントを削除するには、 **設定** タブを開き、次に **構造** をクリックして削除したいコンテンツを見つけます。
開く **アクションメニュー** 削除したいバリアントのそれを開き、 **削除**.
{% hint style="success" %}
を選択します。サイトからバリアントを削除すると、公開サイトからは削除されますが **スペースやその中のコンテンツ自体は削除されません**.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/docs-site/site-structure/variants.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.