# サイトリダイレクト

<figure><img src="/files/90e395f07439db6395306a511ae152cd6a9458a1" alt="A GitBook screenshot showing site redirects"><figcaption><p>サイトのリダイレクトは、ドキュメントの移行やコンテンツの再構成を行う際に、SEOに影響する可能性のあるリンク切れを避けるのに役立ちます。</p></figcaption></figure>

リダイレクトは、ドキュメントをあるプロバイダーから別のプロバイダーへ移行する際によく使われます。たとえば、ドキュメントをGitBookに移したばかりのときなどです。リンク切れはSEOに影響するため、必要に応じてリダイレクトを設定することをおすすめします。

に加えて [GitBookによって作成された自動リダイレクト](#about-automatic-redirects)、サイトのドメイン内の任意のパスからリダイレクトを作成できます。

リダイレクトは次のいずれかとして作成できます **公開中** または **下書き**。下書きのリダイレクトを使うと、公開前にリダイレクトルールを準備して確認できます。下書きは有効化されるまで公開サイトには影響しません。

## サイトでのリダイレクトの管理

始めるには、GitBookでサイトのダッシュボードを表示し、 **設定** タブを開いてから、 **ドメインとリダイレクト**.

### リダイレクトの作成

クリック **リダイレクトを追加** をクリックして **手動** オプションを選択します。

を入力します **ソースパス** — リダイレクトしたいURLスラッグ — と **宛先** 訪問者を送る先のコンテンツを入力します。サイト内の任意のセクション、バリアント、またはページを選択できます。

クリック **リダイレクトを有効化** すると、すぐにリダイレクトが有効になります。

まだ公開せずにリダイレクトを作成したい場合は、代わりに **下書きとして保存** をクリックしてください。下書きのリダイレクトは **下書き** タブに表示され、後で有効化できます。

また、 **ワイルドカードリダイレクト** をソースパスの末尾に \* を追加して作成することもできます。例:

* /docs/\* は /docs/ 配下のすべてに一致
* /changelog\* は /changelog で始まるパスに一致

ソースパスにワイルドカード（\*）が含まれている場合、次を有効にできます **ワイルドカードを一致したテキストで置換**.

* **オン:** \* に一致した部分が宛先パスに追加されます。
  * 例: ソース /docs/\* → 宛先 /help\
    /docs/install は /help/install にリダイレクトされます
* **オフ:** 一致したURLはすべて同じ固定の宛先にリダイレクトされます。
  * 例: ソース /docs/\* → 宛先 /help\
    /docs/install は /help にリダイレクトされます

同じページに別のリダイレクトを追加したい場合は、 **別のリダイレクトを追加** をクリックする前に切り替えてください **リダイレクトを有効化** または **下書きとして保存**.

リダイレクトを追加すると、モーダルは開いたままになり、宛先コンテンツは前回の選択が設定されるので、すぐに別のソースパスを追加できます。

### リダイレクトの編集

リダイレクトを編集するには、一覧でその横にある **編集** アイコンをクリックします。リダイレクトを更新し、 **リダイレクトを有効化** をクリックして変更を公開します。

現在のリダイレクトが **下書き**の場合は、編集モーダルから直接 **リダイレクトを有効化**.

### 下書きリダイレクトの有効化

下書きのリダイレクトは、リダイレクト表の **下書き** タブに表示されます。

下書きのリダイレクトは次の2つの方法で公開できます。

• リダイレクトを開き、 **リダイレクトを有効化** を編集モーダルでクリックする。\
• 表の **トグルを使用して** リダイレクトを直接有効化する。

有効化されると、リダイレクトは **公開中** タブに移動し、すぐに訪問者のルーティングを開始します。

### CSVからリダイレクトをインポート

クリック **リダイレクトを追加** を選択し、 **CSVをアップロード**.

次の列を含むCSVをアップロードします `source`, `宛先`、および任意の `intent`.

* `source` は、リダイレクトしたいパスです。例: /docs/site-redirects
* `宛先` は次のいずれかです:
  * 特定のページ。下のスクリーンショットに示されているページの管理URLを使用します
  * 外部URL
  * 空。intentに応じて
* `intent` は次のいずれかです:
  * live: 公開中のリダイレクトを作成、更新、または削除する場合、空欄または省略
  * draft: 下書きのリダイレクトを作成、更新、または削除する場合
  * publish: 既存の下書きリダイレクトを公開にする場合 `宛先` は空である必要があります。

<div data-with-frame="true"><figure><img src="/files/0ffc6c46f4821586503b8b3c856f38d311941a7f" alt=""><figcaption><p>ページのGitBook管理URLはこのメニューで確認できます</p></figcaption></figure></div>

1回のインポートで最大500行まで対応しています。

CSVに重複するソース値が含まれている場合は、最初の行のみが処理されます。インポートはアップサートとして実行され、同じソースを持つ既存のリダイレクトは更新され、新しいリダイレクトはまだ存在しないソースに対して作成されます。

一部の行が失敗した場合、エラーファイルを右下のトーストから入手できます。ソース、宛先、各エラーの簡単な説明が含まれているので、エラー列を修正・削除して再インポートできます。

#### CSVの例

| source               | 宛先                         | intent  | 結果                   |
| -------------------- | -------------------------- | ------- | -------------------- |
| /docs/site-redirects | <https://example.com/page> | 空欄      | 公開中のリダイレクトを作成または更新する |
| /docs/site-redirects | <https://example.com/page> | 公開中     | 公開中のリダイレクトを作成または更新する |
| /docs/site-redirects | <https://example.com/page> | 下書き     | 下書きリダイレクトを作成または更新する  |
| /docs/site-redirects | 空                          | 空欄      | 公開中のリダイレクトを削除する      |
| /docs/site-redirects | 空                          | 公開中     | 公開中のリダイレクトを削除する      |
| /docs/site-redirects | 空                          | 下書き     | 下書きリダイレクトを削除する       |
| /docs/site-redirects | 空                          | publish | 既存の下書きリダイレクトを公開にする   |

## 自動リダイレクトについて

ページが移動または名前変更されると、その正規URLもそれに合わせて変更されます。コンテンツを引き続き利用できるようにするため、GitBookは自動的に [HTTP 307](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/307) リダイレクトを古いURLから新しいURLへ作成します。

URLが読み込まれるたびに、GitBookは次の手順で解決します。

1. サイトコンテンツは、自動作成されたリダイレクトをたどることで正規URLに解決されます。
2. URLを解決できない場合は、そのURLを [スペースレベルのリダイレクト](/docs/documentation/ja-gitbook-documentation/getting-started/git-sync/content-configuration.md#redirects)、リポジトリの `.gitbook.yaml` ファイルを含むサブディレクトリを指すように設定してください。
3. 最後に、そのURLはサイトレベルのリダイレクトと照合されます。これは以下で作成されたものです [上記の手順](#creating-redirects).


---

# 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-redirects.md?ask=<question>
```

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.
