サイトセクション

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

サイトセクションを使用した GitBook サイトの例

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

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

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

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

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

同じコンテンツの別バージョンを追加したい場合、たとえばローカライズ版や同じ製品の過去バージョンなどは、 コンテンツバリアント の代わりに行うことをおすすめします。

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

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

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

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

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

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

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

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

セクションを編集する

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

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

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

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

セクションの並べ替え

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

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

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

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

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

セクションを削除する

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

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

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

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