サイトセクション

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

サイトセクション付きの GitBook サイトの例

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

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

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

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

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

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

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

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

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

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

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

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

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

サイトが複数の言語をサポートしている場合は、セクションタイトルや説明とあわせて、セクショングループのタイトルも翻訳できます。参照 多言語セクション.

セクションを編集する

編集したいセクションのテーブル行にある 編集 ボタンをクリックすると、各セクションの名前、アイコン、スラッグを変更できます。モーダルが開くので、変更したい項目を編集してから、 保存 ボタンをクリックします。また、 バリアントを削除 ボタンを左下でクリックして、バリアントを削除することもできます。

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

グループ内のサイトセクションには、任意で説明を表示することもでき、セクショングループにホバーすると、サイトのナビゲーションバーのドロップダウンメニューに表示されます。公開済みドキュメントでの表示例については、このページ上部の画像を参照してください。

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

セクションの並べ替え

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

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

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

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

セクションをデフォルトに設定するには、 アクションメニュー セクションのテーブル行にあるをクリックしてから、 デフォルトに設定.

セクションを削除する

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

サイトからセクションを削除するには、 設定 タブを開き、次に 構造 をクリックして削除したいコンテンツを見つけます。

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

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