サイト構造

セクション、バリアント、外部リンクを使って、公開ドキュメントを整理します

サイト上のコンテンツは、その中にあります sections。セクションは 1 つでも複数でも追加できます。GitBook はそれぞれを公開し、間のナビゲーションを処理します。

コンテンツの種類

サイト内のコンテンツは、2 つの異なるコンテンツタイプのいずれかとして機能でき、それによって GitBook がそのコンテンツをどのように扱い、訪問者に表示するかが決まります。

セクション

サイトを明確に区切られた部分に分けます。複数の製品や組織の複数部門に最適です。

コンテンツバリアント

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

サイト構造の管理

サイトの構造を管理すると、サイト上部のナビゲーションバーも管理できます。このナビゲーションバーでは、訪問者がセクション、グループ、外部リンクを開けます。

構造エディタを開く サイト構造 サイトのサイドバー内です。ここで、サイトのセクション、バリアント、外部リンクを確認できます。

サイトは、サイト名を持つ 1 つのセクションと、サイトのセットアップ中に作成したコンテンツを含む 1 つのバリアントから始まります。

公開済みドキュメントサイトの構造。

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

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

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

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

外部リンクを追加する

外部リンクを追加すると、サイト外の移動先をナビゲーションに加えられます。リンクを独立したナビゲーション項目として追加するか、関連するセクションとともにセクショングループに配置できます。

外部リンクを追加するには:

1. サイトのサイドバーで、 サイト構造.

2. 追加メニューで、 外部リンク.

3. リンクのラベルとリンク先 URL を入力します。

4. リンクを個別に追加するか、セクショングループに追加するかを選択します。

5. クリック 保存.

リンクは、選択した位置に公開済みサイトのナビゲーションに表示されます。

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

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

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

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

スラッグは組織全体で一意です。各パスは 1 つのサイトでしか使用できず、別のサイトをまたいでも重複できません。"path is already taken" エラーが表示される場合、別のサイトですでにそのスラッグが使われています。コンテンツに意味がありつつ、少しだけ変えたスラッグを選んでください。

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

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

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

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

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

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

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

セクションまたはバリアントをデフォルトに設定するには、 アクションメニュー そのテーブル行にある デフォルトに設定.

コンテンツをデフォルトに設定すると、セクションのルートから配信されるため、スラッグ欄は削除されます。GitBook は古いスラッグを適切なパスにリダイレクトし、訪問者が引き続きコンテンツを見られるようにします。

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

サイトからセクションまたはバリアントを削除するには、構造エディタを サイト構造 サイトのサイドバーで開き、削除したいコンテンツを見つけます。

次を開き アクションメニュー 、削除したいコンテンツについて 削除.

サイトからコンテンツを削除すると、公開済みサイトからは削除されますが、 コンテンツ自体は削除されません — まだ次で見つけることができます すべてのコンテンツ.

セクションのコンテンツを完全に削除しても、サイトは設定やカスタマイズとともに引き続き利用できます。削除されたコンテンツは ゴミ箱 に 7 日間保持された後、完全に削除されます。削除したセクションがサイトのデフォルトだった場合は、デフォルト設定がまだ正しいか確認してください。