サイトのリダイレクト
サイト内のあらゆる場所のコンテンツへトラフィックを振り向けるために、サイトリダイレクトを設定します
GitBook は、公開コンテンツの未認証ビューに対してのみ、恒久的リダイレクトに 308 を送信します。GitBook アプリ、プレビュー、訪問者認証済みセッションからのリクエストには 307 が返されます。これにより、意図しないローカルキャッシュを回避できます。
検索エンジンと匿名訪問者には、恒久的リダイレクトで常に 308 が返されます。このステータスは SEO をサポートします。
/docs/site-redirects
https://example.com/page
空欄
公開リダイレクトを作成または更新
/docs/site-redirects
https://example.com/page
公開
公開リダイレクトを作成または更新
/docs/site-redirects
https://example.com/page
draft
下書きリダイレクトを作成または更新
/docs/site-redirects
リスト
空欄
公開リダイレクトを削除
/docs/site-redirects
リスト
公開
公開リダイレクトを削除
/docs/site-redirects
リスト
draft
下書きリダイレクトを削除
/docs/site-redirects
リスト
公開
既存の下書きリダイレクトを公開にします
リダイレクトは、ドキュメントをある提供元から別の提供元へ移行するときによく使われます。たとえば、ドキュメントを GitBook に移したばかりのときです。リンク切れは SEO に影響するため、必要な箇所ではリダイレクトの設定をおすすめします。
〜に加えて GitBook によって作成される自動リダイレクト、サイトのドメイン内の任意のパスからリダイレクトを作成できます。GitBook は、訪問者がアクセスしたものの 404 を返すサイト上の URL に対して、リダイレクトを提案することもできます。参照 リンク切れ.
リダイレクトは次のいずれかとして作成できます: 公開 または 下書き。下書きリダイレクトでは、公開前にリダイレクトルールを準備して確認できます。下書きは有効化されるまで公開サイトに影響しません。
サイトでリダイレクトを管理する
始めるには、サイトの 設定 をサイトのサイドバーで開き、次に リダイレクト.
リダイレクトの作成
クリック リダイレクトを追加 を選択し、 手動 オプションを選択します。
次の項目を入力します: ソースパス — リダイレクトしたい URL スラッグ — と 転送先 訪問者を送信したいコンテンツです。サイト内の任意のセクション、バリアント、ページを選択できます。
ページを選択すると、宛先はページ参照として保存され、サイト構造内でそのページを移動しても引き続きそのページに解決されます。代わりに URL パスを入力すると、そのパスに完全一致するため、ページが移動してパスが変わるとリダイレクトは機能しなくなります。可能であればページを選択してください。
リダイレクトのステータスを選択する
リダイレクトを作成または編集するときに、HTTP ステータスを選択します:
一時的（307） は、宛先が変更される可能性があることをブラウザと検索エンジンに伝えます。一時的な移動に使用します。
恒久的（308） は、ソース URL が恒久的に移動したことをブラウザと検索エンジンに伝えます。古い URL を戻す予定がない場合に使用します。
どちらのステータスコードも、リダイレクト時にリクエストメソッドと本文を保持します。
GitBook は、公開コンテンツの未認証ビューに対してのみ、恒久的リダイレクトに 308 を送信します。GitBook アプリ、プレビュー、訪問者認証済みセッションからのリクエストには 307 が返されます。これにより、意図しないローカルキャッシュを回避できます。
検索エンジンと匿名訪問者には、恒久的リダイレクトで常に 308 が返されます。このステータスは SEO をサポートします。
クリック リダイレクトを有効化 して、リダイレクトをすぐに有効化します。
まだ公開せずにリダイレクトを作成したい場合は、 下書きとして保存 をクリックします。下書きリダイレクトは 下書き タブに表示され、後で有効化できます。
次のものも作成できます: ワイルドカードリダイレクト ソースパスの末尾に * を追加することで、たとえば次のように作成できます:
/docs/* で /docs/ 配下のすべてに一致
/changelog* で /changelog で始まるパスに一致
ソースパスにワイルドカード（*）が含まれる場合は、 ワイルドカードを一致したテキストに置き換える.
オン: * に一致した部分が転送先パスに追加されます。
例: ソース /docs/* → 転送先 /help /docs/install は /help/install にリダイレクトされます
オフ: 一致した URL はすべて同じ固定の転送先にリダイレクトされます。
例: ソース /docs/* → 転送先 /help /docs/install は /help にリダイレクトされます
同じページに別のリダイレクトを追加したい場合は、 別のリダイレクトを追加 をクリックする前に切り替えます リダイレクトを有効化 または 下書きとして保存.
リダイレクトを追加すると、モーダルは開いたままになり、転送先コンテンツは前回の選択に設定されるため、別のソースパスをすばやく追加できます。
注： GitBook は公開済み URL を大文字小文字を区別せずに解決するため、大文字小文字だけが異なる 2 つのリダイレクトは同じパスとして扱われます。大文字小文字を区別する URL を使用するプラットフォームから移行する場合は、インポート前にリダイレクトをまとめる必要があるかもしれません。
リダイレクトの編集
リダイレクトを編集するには、 編集 一覧内のその横にあるアイコンをクリックします。リダイレクトを更新して、 リダイレクトを有効化 変更を公開します。
リダイレクトが現在 draft、編集モーダルから直接公開することもできます。 リダイレクトを有効化.
下書きリダイレクトの有効化
下書きリダイレクトは 下書き リダイレクト表のタブに表示されます。
下書きリダイレクトは 2 つの方法で公開できます:
• リダイレクトを開いて、 リダイレクトを有効化 を編集モーダルでクリックします。 • 次を使用します: 表内のトグル を使って、リダイレクトを直接有効化します。
有効化すると、リダイレクトは 公開 タブに移動し、すぐに訪問者のルーティングを開始します。
CSV からリダイレクトをインポート
クリック リダイレクトを追加 を選択し、 CSV をアップロード.
次の列を含む CSV をアップロードします: source, 転送先、および任意の 意図.
sourceは、リダイレクトしたいパスです。たとえば /docs/site-redirects転送先で、次のいずれかです:特定のページ。以下のスクリーンショットに表示されているページのアプリ URL を使用して
外部 URL
intent に応じて空欄
意図で、次のいずれかです:live、空欄のまま、または完全に省略して、公開リダイレクトを作成、更新、または削除します
draft で下書きリダイレクトを作成、更新、または削除します
publish で既存の下書きリダイレクトを公開にします。
転送先空欄である必要があります。
アプリ URL は宛先をページ参照として保存し、固定パスに対する同じ利点を、で説明したように リダイレクトの作成.
1 回のインポートでサポートされるのは最大 500 行です。
CSV に重複したソース値が含まれている場合、最初の行のみが処理されます。インポートはアップサートとして実行され、同じソースを持つ既存のリダイレクトは更新され、まだ存在しないソースには新しいリダイレクトが作成されます。
いずれかの行が失敗した場合、右下のトースト通知からエラー CSV を利用できます。そこにはソース、転送先、および各エラーの簡単な説明が含まれているため、修正し、errors 列を削除して再インポートできます。
CSV の例
/docs/site-redirects
https://example.com/page
空欄
公開リダイレクトを作成または更新
/docs/site-redirects
https://example.com/page
公開
公開リダイレクトを作成または更新
/docs/site-redirects
https://example.com/page
draft
下書きリダイレクトを作成または更新
/docs/site-redirects
リスト
空欄
公開リダイレクトを削除
/docs/site-redirects
リスト
公開
公開リダイレクトを削除
/docs/site-redirects
リスト
draft
下書きリダイレクトを削除
/docs/site-redirects
リスト
公開
既存の下書きリダイレクトを公開にします
自動リダイレクトについて
ページが移動または改名されるたびに、正規 URL もそれに合わせて変更されます。コンテンツへのアクセスを維持するため、GitBook は自動的に HTTP 307 古い URL から新しい URL へのリダイレクトを作成します。
URL が読み込まれるたびに、GitBook は次の手順で解決します:
サイトのコンテンツは、自動生成されたリダイレクトのいずれかをたどることで、正規 URL に解決されます。
URL を解決できない場合、その URL はセクションレベルのリダイレクトと照合されます。これは、リポジトリの
.gitbook.yamlファイルで定義されます。最後に、その URL はサイトレベルのリダイレクトと照合されます。これは 上記の手順で作成されます.
最終更新
役に立ちましたか？