サイト構造

サイト上のコンテンツは スペース から取得されます。組織内の1つまたは複数のスペースをリンクできます。GitBook は各スペースを公開し、スペース間のナビゲーションを処理します。

コンテンツタイプ

リンクされたスペースは 2 つの異なるコンテンツタイプのいずれかとして扱えます。これにより、GitBook がそれらを相互にどのように扱い、訪問者にどのように表示するかが決まります。

サイトセクション

サイトを個別のパートに分割します。複数の製品や組織内の複数の部門に最適です。

コンテンツのバリアント

同じコンテンツの複数バージョンを公開します。ローカライズやバージョン管理などに最適です。

サイト構造の管理

サイトの構造を管理することで、サイト上部のナビゲーションバーも管理できます。このナビゲーションバーを使うと、ユーザーは異なるサイトセクションやサイトセクショングループに移動できます。

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

サイトは、サイト名の付いた1つのセクションと、サイトのセットアップ時にリンクしたスペースを含む1つのバリアントから始まります。

スペースをドキュメントサイトにリンクする

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

を追加するには バリアント、 バリアントを追加 ボタンを、追加したいセクションでクリックし、次にリンクするスペースを選択します。新しいバリアントは選択したセクション内のバリアント一覧に追加され、サイト上のバリアントのドロップダウンから訪問者が利用できるようになります。

スペースをバリアントまたはセクションとして追加すると、スペースのタイトルに基づいて名前とスラッグが生成されます。

セクションまたはバリアントの変更

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

セクションまたはバリアントを置き換えるには、まずその 編集 ボタンをクリックして削除し、次に 削除 ボタンをモーダルの左下でクリックします。項目が削除されたら、 セクションを追加 または バリアントを追加 ボタンをクリックして再度追加します。

セクションまたはバリアントの並べ替え

サイトには、 サイト構造 テーブルに表示される順序でセクションとバリアントが表示されます。 ドラッグハンドル をつかんで上下に移動することで並べ替えられます。順序の変更はすぐにサイトに反映されます。

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

デフォルトコンテンツの設定

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

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

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

サイトからコンテンツを削除する

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

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