For the complete documentation index, see llms.txt. This page is also available as Markdown.

サイトのリダイレクト

サイト全体のあらゆる場所のコンテンツへトラフィックを誘導するよう、サイトリダイレクトを設定します

A GitBook screenshot showing site redirects
サイトのリダイレクトは、ドキュメントの移行やコンテンツの再構成を行う際に、リンク切れを防ぎ、SEOに影響を与えないようにするのに役立ちます。

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

に加えて GitBookによって作成される自動リダイレクト、サイトのドメイン内の任意のパスからリダイレクトを作成できます。

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

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

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

リダイレクトの作成

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

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

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

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

  • 一時的(307) は、転送先が変更される可能性があることをブラウザと検索エンジンに伝えます。一時的な移動に使用します。

  • 恒久的(308) は、ソースURLが恒久的に移動したことをブラウザと検索エンジンに伝えます。元のURLに戻す予定がない場合に使用します。

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

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

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

次のものも作成できます ワイルドカードリダイレクト ソースパスの末尾に * を追加して、たとえば次のようにします:

  • /docs/* で /docs/ 配下のすべてに一致させる

  • /changelog* で /changelog で始まるパスに一致させる

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

  • オン: * に一致した部分が転送先パスの末尾に追加されます。

    • 例: ソース /docs/* → 転送先 /help /docs/install は /help/install にリダイレクトされます

  • オフ: 一致したすべてのURLは同じ固定の転送先にリダイレクトされます。

    • 例: ソース /docs/* → 転送先 /help /docs/install は /help にリダイレクトされます

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

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

リダイレクトの編集

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

リダイレクトが現在 下書きの場合は、編集モーダルから直接公開することもできます。 リダイレクトを有効にする.

下書きのリダイレクトを有効にする

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

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

• リダイレクトを開いて、 リダイレクトを有効にする を編集モーダルでクリックします。 • 次のものを使います 表のトグル を使って、リダイレクトを直接有効にします。

有効にすると、リダイレクトは 公開 タブに移動し、すぐに訪問者の転送を開始します。

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

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

次の列を含むCSVをアップロードします: ソース, 転送先、および任意の 意図.

  • ソース は、リダイレクトしたいパスです。たとえば /docs/site-redirects

  • 転送先 は次のいずれかです:

    • 特定のページ。下のスクリーンショットに示すページの管理URLを使用します

    • 外部URL

    • 空欄。意図によって異なります

  • 意図 は次のいずれかです:

    • live、空欄、または完全に省略して、公開リダイレクトを作成、更新、または削除します

    • draftで下書きのリダイレクトを作成、更新、または削除します

    • publishで既存の下書きリダイレクトを公開にする 転送先 空欄である必要があります。

このメニューでページのGitBook管理URLを確認できます

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

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

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

CSVの例

ソース
転送先
意図
結果

/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

公開

既存の下書きリダイレクトを公開する

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

ページが移動または名前変更されると、正規URLもそれに伴って変わります。コンテンツへのアクセスを維持するために、GitBookは自動的に HTTP 307 古いURLから新しいURLへのリダイレクトを作成します。

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

  1. 自動作成されたリダイレクトをたどって、サイトコンテンツを正規URLに解決します。

  2. URLを解決できない場合、URLは次の内容と照合されます セクションレベルのリダイレクト。これはリポジトリの .gitbook.yaml ファイルで定義されます。

  3. 最後に、URLはサイトレベルのリダイレクトと照合されます。これは次の方法で作成されます 上記の手順.

最終更新

役に立ちましたか?