サイトセクション

複数の製品をサイトセクションとして追加し、すべてのコンテンツにアクセスできるタブ付きコンテンツハブを作成します

サイトセクションを備えた GitBook サイトの例

サイトセクションを使うと、すべてのドキュメントを一元化し、ユーザーにシームレスな体験を提供できます。

サイトセクションは、ドキュメントの整理に最適です。たとえば、個別の製品を管理している場合でも、エンドユーザーと開発者の両方に向けて、それぞれに合わせたコンテンツを提供している場合でも活用できます。

また、 サイトセクションをまとめてグループ化することもできます。そうすると、ナビゲーションバーにドロップダウンメニューが作成され、サイトセクションに階層を追加するのに最適です。

セクションそれともバリアント？

各サイトセクションは GitBook 内のスペースです。どのスペースからでもサイトセクションを作成できますが、ドキュメント内の意味的に異なる部分としてセクションを使うことをおすすめします。

同じコンテンツのバリエーションを追加したい場合、たとえばローカライズ版や同じ製品の過去版などは、代わりに コンテンツバリアント を使うことを検討してください。

ドキュメントサイトにセクションを追加する

ドキュメントサイトのダッシュボードで、サイトヘッダーの 設定 タブを開き、次に 構成をクリックします。ここでサイトのすべてのコンテンツを確認できます。

サイトセクションを追加するには、表の下にある 新しいセクション ボタンをクリックし、セクションとしてリンクするスペースを選択します。新しいセクションは表に追加され、サイト上部のタブとして訪問者に表示されるようになります。

サイトセクションでドキュメントに構造を追加しましょう。

サイトセクショングループを作成する

サイトセクションは、1つの見出しの下にまとめてグループ化できます。サイトセクショングループは、サイトのナビゲーションでドロップダウンとして表示されます。グループ内のサイトセクションには任意で説明を追加でき、ドロップダウンメニュー内ではセクションタイトルの下に表示されます。

グループを作成するには、 新しいセクション ボタンの横にある矢印をクリックして 新しいセクショングループを選択します。新しいグループに名前を付け、モーダルで セクションを追加 をクリックしてグループにセクションを追加します。既存のサイトセクションを新しいグループに追加することも、メニューを使って追加したい別のスペースを選択することもできます。

サイトが複数の言語に対応している場合、セクショングループのタイトル、セクションのタイトル、説明も翻訳できます。詳しくは 多言語セクション.

セクションを編集する

編集したい各セクションの名前、アイコン、スラッグは、そのセクションの表の行にある 編集 ボタンをタップして変更できます。モーダルが開きます。変更したいフィールドを編集し、次に 保存 ボタンをクリックします。また、左下の バリアントを削除 ボタンをクリックしてバリアントを削除することもできます。

セクションのスラッグを変更すると、正規URLも変更されます。GitBook は古い URL から新しい URL への自動リダイレクトを作成します。また、 リダイレクトを手動で作成する.

こともできます。グループ内のサイトセクションには任意で説明を表示でき、セクショングループにカーソルを合わせるとサイトのナビゲーションバーのドロップダウンメニューに表示されます。このページ上部の画像で、公開済みドキュメントでどのように表示されるかの例をご覧ください。

サイトが複数の言語に対応している場合は、読者が選択した言語に合わせてセクションのタイトルや説明を翻訳できます。詳しくは 多言語セクション.

セクションの並べ替え

サイトには、Site structure テーブルに表示される順序でセクションが表示されます。セクションは、 ドラッグハンドル をつかんで上下に移動することで並べ替えられます。そのセクション内のすべてのスペースも一緒に移動します。変更後の順序は、すぐにサイトに反映されます。

キーボードを使ってコンテンツを選択して移動することもできます。スペースバーでセクションを選択し、矢印キーで上下に移動します。もう一度スペースバーを押すと、新しい位置が確定します。

デフォルトセクションを設定する

サイトに複数のセクションがある場合、1つのセクションがデフォルトとしてマークされます。このセクションは、訪問者がサイトにアクセスしたときに表示され、サイトのルートURLから提供されます。その他の各セクションにはスラッグがあり、それがルートURLに付加されます。

セクションをデフォルトに設定するには、 アクションメニュー をそのセクションの表の行でクリックし、次に デフォルトに設定.

セクションを削除する

サイトからセクションを削除するには、ドキュメントサイトのダッシュボードで 設定 ボタンをクリックし、次に 構成 をクリックして削除したいコンテンツを見つけます。削除したいセクションの横にある 編集 ボタンをクリックし、次にモーダル左下の 削除 ボタンをクリックします。これにより、公開サイトからそのセクションと、その中のすべてのバリアントが削除されます。スペース自体や、その中のコンテンツは削除されません。

サイトからセクションを削除するには、ドキュメントサイトのダッシュボードで 設定 タブを開き、次に 構成 をクリックして削除したいコンテンツを見つけます。

開きます アクションメニュー 削除したいスペースの 削除.

サイトからセクションを削除すると、公開サイトからそのセクションとその中のすべてのバリアントが削除されますが、 スペースやその中のコンテンツは削除されません.