サイト構造

サイトのセクションやバリアントを使って公開ドキュメントに構造を追加する

あなたのサイトのコンテンツは次から提供されています スペース あなたの組織内の。1つまたは複数のスペースをリンクできます。GitBook はそれぞれを公開し、スペース間のナビゲーションを処理します。

コンテンツタイプ

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

サイトのセクション

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

コンテンツのバリアント

同じコンテンツの複数バージョンを公開します — ローカリゼーション、バージョニングなどに最適です。

サイト構造の管理

サイトの構造を管理することで、サイトのトップナビゲーションバーも管理できます。このナビゲーションバーにより、ユーザーは異なるサイトセクションやサイトセクショングループにジャンプできます。

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

サイトは最初、サイト名の単一セクションと、サイト設定時にリンクしたスペースを含む単一のバリアントで開始します。

公開されたドキュメントサイトの構造。

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

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

を追加するには バリアント、テーブルの下にある バリアントを追加 追加したいセクションのボタンをクリックし、リンクするスペースを選択します。新しいバリアントは選択したセクション内のバリアント一覧に追加され、サイト上のバリアントドロップダウンで訪問者に表示されます。

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

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

サイトセクションまたはバリアントを更新します。

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

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

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

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

サイトはセクションとバリアントを サイト構造 テーブルに表示されている順序で表示します。項目は ドラッグハンドル を掴んで上下に移動することで並べ替えできます。変更された順序はサイトにすぐ反映されます。

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

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

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

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

スペースをデフォルトに設定するには、そのスペースのテーブル行にある 操作メニュー をクリックし、次に デフォルトに設定.

をクリックします。スペースをデフォルトに設定すると、そのスラッグフィールドは削除され、セクションのルートから提供されるようになります。GitBook は訪問者がコンテンツを見続けられるように、スペースのスラッグを適切なパスへリダイレクトします。

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

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

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

サイトからスペースを削除すると、公開サイトからは削除されますが、 スペースやその中のコンテンツは削除されません.