サイトセクション

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

A GitBook screenshot showing site sections on a docs site
サイトセクションを含むGitBookサイトの例

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

サイトセクションは、ドキュメントの整理に最適です — 別々の製品を管理する場合でも、エンドユーザーと開発者それぞれに合わせたコンテンツを提供する場合でも有用です。

また、 サイトセクションをグループ化する。これによりナビゲーションバーにドロップダウンメニューが作成され、サイトセクションに階層を追加するのに理想的です。

circle-info

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

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

同じコンテンツのバリエーション(ローカリゼーションや製品の過去のバージョンなど)を追加したい場合は、次の使用を検討してください コンテンツバリアント を推奨します。

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

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

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

A GitBook screenshot showing site section structure
サイトセクションでドキュメントに構造を追加します。

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

サイトセクションを単一の見出しの下にまとめることができます。サイトセクショングループはサイトのナビゲーションにドロップダウンとして表示されます。グループ内のサイトセクションには省略可能な説明を含めることもでき、ドロップダウンメニューのセクションタイトルの下に表示されます。

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

セクションの編集

各セクションの名前、アイコン、スラッグは、をタップして変更できます。 The Edit icon in GitBook 編集 編集したいセクションのテーブル行にあるボタン。これによりモーダルが開きます。変更したいフィールドを編集してから、をクリックしてください。 保存 をクリックすると、バリアントを削除することもできます。 バリアントを削除 左下のボタン。

circle-info

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

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

セクションの並べ替え

サイトは、サイト構造テーブルに表示されている順序でセクションを表示します。セクションは、をつかんで ドラッグハンドル The Options menu icon in GitBook 上下に移動することで並べ替えることができます。そのセクション内のすべてのスペースも一緒に移動します。順序の変更はサイトに即座に反映されます。

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

デフォルトセクションの設定

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

セクションをデフォルトに設定するには、セクションの行にある 操作メニュー The Actions menu icon in GitBook をクリックしてから、をクリックします デフォルトに設定.

セクションの削除

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

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

を開いて 操作メニュー The Actions menu icon in GitBook 削除したいスペースのためのメニューを開き、次に選択します 削除.

circle-check

最終更新

役に立ちましたか?