> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/publish/site-redirects.md).

# サイトのリダイレクト

サイト内のあらゆる場所のコンテンツへトラフィックを振り向けるために、サイトリダイレクトを設定します

リダイレクトは、ドキュメントをある提供元から別の提供元へ移行するときによく使われます。たとえば、ドキュメントを GitBook に移したばかりのときです。リンク切れは SEO に影響するため、必要な箇所ではリダイレクトの設定をおすすめします。

さらに、 [GitBook によって自動作成されるリダイレクト](#about-automatic-redirects)に加えて、サイトのドメイン内の任意のパスからリダイレクトを作成できます。また、訪問者がアクセスしたものの 404 を返すサイト上の URL について、GitBook がリダイレクトを提案することもできます。詳しくは [リンク切れ](https://gitbook.com/docs/documentation/ja-gitbook-documentation/analytics/broken-links.md).

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

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-0b5f1f472dbf1a51f65ba2fd752290a1aae1b7fe%2F26_01_06_redirects%402x.png?alt=media" alt="A GitBook screenshot showing site redirects"><figcaption><p>サイトリダイレクトは、ドキュメントの移行やコンテンツの再構成時に、SEO に影響しうるリンク切れを避けるのに役立ちます。</p></figcaption></figure>

## サイトでリダイレクトを管理する

まず、サイトのサイドバーで **設定** を開き、 **リダイレクト**.

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

をクリックします。 **リダイレクトを追加** をクリックし、 **手動** を選択します。

リダイレクト元の **パス** （リダイレクトする URL スラッグ）と、訪問者の転送先となる **コンテンツ** を入力します。サイト上の任意のセクション、バリアント、ページを選択できます。

ページを選択すると、宛先はページ参照として保存され、サイト構造内でそのページを移動しても引き続きそのページに解決されます。代わりに URL パスを入力すると、そのパスに完全一致するため、ページが移動してパスが変わるとリダイレクトは機能しなくなります。可能であればページを選択してください。

### リダイレクトのステータスを選択する

リダイレクトを作成または編集するときに、HTTP ステータスを選択します:

* **一時的（307）** は、転送先が変更される可能性があることをブラウザーや検索エンジンに伝えます。一時的な移転に使用します。
* **恒久的（308）** は、リダイレクト元の URL が恒久的に移動したことをブラウザーや検索エンジンに伝えます、古い URL に戻す予定がない場合に使用します。

どちらのステータスコードも、リダイレクト時にリクエストメソッドと本文を保持します。

GitBook は、公開中のコンテンツの未認証ビューに対してのみ、恒久的リダイレクトとして 308 を返します。これには検索エンジンや匿名訪問者が含まれるため、このリダイレクトは SEO に反映されます。GitBook アプリ、プレビュー、および訪問者認証済みセッションからのリクエストには代わりに 307 が返され、意図しないローカルキャッシュを回避できます。

リダイレクトをすぐに有効にするには、 **リダイレクトを有効にする** をクリックします。

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

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

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

リダイレクト元のパスにワイルドカード（\*）が含まれている場合は、 **ワイルドカードを一致したテキストに置き換える**.

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

同じページへのリダイレクトをもう1つ追加するには、 **リダイレクトをもう1つ追加** をオンにしてから、 **リダイレクトを有効にする** または **下書きとして保存**.

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

{% hint style="warning" %}
**をクリックします。注意：** GitBookは公開URLを大文字と小文字を区別せずに解決するため、大文字・小文字だけが異なる2つのリダイレクトは同じパスとして扱われます。大文字と小文字を区別するURLを使用するプラットフォームから移行する場合は、インポート前にリダイレクトを統合する必要があることがあります。
{% endhint %}

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

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

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

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

をクリックして直接公開することもできます。下書きのリダイレクトは、リダイレクトテーブルの **下書き** タブに表示されます。

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

* リダイレクトを開き、編集モーダルで **リダイレクトを有効化** をクリックします。
* テーブルの **切り替えスイッチ** を使うと、リダイレクトを直接有効にできます。

有効にすると、リダイレクトは **公開中** タブに移動し、訪問者の転送が直ちに開始されます。

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

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

を選択します。次の列を含むCSVをアップロードしてください。 `source`, `destination`、および任意の `intent`.

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

<div data-with-frame="true"><figure><img src="https://1050631731-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-1811bdc6a92d7e88fd724f3249aaae4a9350f1c0%2Fimage.png?alt=media" alt=""><figcaption><p>このメニューで、ページの GitBook アプリ URL を確認できます</p></figcaption></figure></div>

アプリのURLでは、固定パスを使う場合の利点について [リダイレクトの作成](#creating-redirects).

1 回のインポートでサポートされるのは最大 500 行です。

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

いずれかの行が失敗した場合、エラー CSV は右下のトースト通知から入手できます。そこには source、destination、および各エラーの簡単な説明が含まれているため、その行を修正し、errors 列を削除して、再インポートできます。

#### CSV の例

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

で説明されているのと同じ利点を持つページ参照として、転送先が保存されます。 [HTTP 307](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/307) リダイレクトが、古いURLから新しいURLへ自動的に作成されます。

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

1. サイトのコンテンツは、自動生成されたリダイレクトのいずれかをたどることで、正規 URL に解決されます。
2. URLを解決できない場合、URLはリポジトリ内で定義されているセクションレベルのリダイレクトと照合されます。 `.gitbook.yaml` ファイル。
3. 最後に、URLは [上記の手順で作成されたサイトレベルのリダイレクトと照合されます。](#creating-redirects).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/publish/site-redirects.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
