> 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/gong-kai/site-redirects.md).

# サイトリダイレクト

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

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

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

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

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

始めるには、サイトの **設定**の下の **一般** をサイトのサイドバーで開き、次に **リダイレクト**.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

リダイレクトが現在 **draft**ドラフトである場合、編集モーダルから直接公開することもできます。クリックして **リダイレクトを有効化**.

### ドラフトのリダイレクトの有効化

ドラフトのリダイレクトは、リダイレクトテーブルの **ドラフト** タブに表示されます。

ドラフトのリダイレクトは2つの方法で公開できます：

• リダイレクトを開いて、 **リダイレクトを有効化** 編集モーダルでクリックします。\
• テーブル内の **トグル** を使って、リダイレクトを直接有効化します。

有効化されると、リダイレクトは **公開中** タブに移動し、すぐに訪問者の振り分けを開始します。

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

クリックして **リダイレクトを追加** を開いて **CSVをアップロード**.

列を含むCSVをアップロードし、 `source`, `遷移先`、さらに任意の `意図`.

* `source` は、リダイレクトしたいパスです。例：/docs/site-redirects
* `遷移先` には次のものがあります：
  * 下のスクリーンショットに示すようなページの管理URLを使った特定のページ
  * 外部URL
  * 空欄、意図に応じて
* `意図` には次のものがあります：
  * live、空欄のまま、または完全に省略して、ライブのリダイレクトを作成、更新、または削除する
  * draftでドラフトのリダイレクトを作成、更新、または削除する
  * publishで既存のドラフトリダイレクトをライブに公開する、 `遷移先` は空欄でなければなりません。

<div data-with-frame="true"><figure><img src="/files/1106b85c3fe6bdaf982b5c5c73e33c4cd54650a2" alt=""><figcaption><p>このメニューでページのGitBook管理URLを見つけることができます</p></figcaption></figure></div>

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

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

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

#### CSVの例

<table data-search="false"><thead><tr><th>source</th><th>遷移先</th><th>意図</th><th>結果</th></tr></thead><tbody><tr><td>/docs/site-redirects</td><td>https://example.com/page</td><td>空欄</td><td>ライブのリダイレクトを作成または更新</td></tr><tr><td>/docs/site-redirects</td><td>https://example.com/page</td><td>ライブ</td><td>ライブのリダイレクトを作成または更新</td></tr><tr><td>/docs/site-redirects</td><td>https://example.com/page</td><td>draft</td><td>ドラフトのリダイレクトを作成または更新</td></tr><tr><td>/docs/site-redirects</td><td>空欄</td><td>空欄</td><td>ライブのリダイレクトを削除</td></tr><tr><td>/docs/site-redirects</td><td>空欄</td><td>ライブ</td><td>ライブのリダイレクトを削除</td></tr><tr><td>/docs/site-redirects</td><td>空欄</td><td>draft</td><td>ドラフトのリダイレクトを削除</td></tr><tr><td>/docs/site-redirects</td><td>空欄</td><td>公開</td><td>既存のドラフトリダイレクトをライブに公開する</td></tr></tbody></table>

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

ページが移動または名前変更されると、それに伴って正規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/docs-as-code/git-sync/content-configuration.md#redirects)、リポジトリの `.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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
