新機能！ サイトワークスペース

サイトワークスペースによって、GitBook のナビゲーション、コンテンツ構造、権限がどう変わるかを学びます

GitBook のサイト優先ワークスペース

GitBook はサイト単位で再編成されました。アプリ内のすべては、公開するドキュメントサイトを中心に整理されているため、編集時に見えるものは、閲覧者が読むときに見えるものと一致します。

このページでは、何が変わったのか、既存コンテンツにどう影響するのか、そして有効にする方法を説明します。

なぜサイトワークスペースなのか

以前は、GitBook では作業をスペースとコレクションを中心に整理し、サイトはスペースをつなぎ合わせることで構築されていました。そのため、アプリ内で移動する構造と、公開されたサイトの構造は、どうしても完全には一致しませんでした。

サイトワークスペースはそのギャップを埋めます。組織にはサイトがあり、すべてのコンテンツはサイト内の セクションとして存在します。編集する階層が、そのまま読者が見る階層です。

新機能

「すべてのサイト」が新しいホームです

GitBook を開くと、 すべてのサイト 画面に移動します。組織内のすべてのドキュメントサイトを一か所にまとめたものです。これがこれまでのホーム画面に代わる開始地点になります。どこからでも戻るには、サイドバー上部の切り替えメニューを使ってください。

サイドバーに表示されるのは組織ではなくサイトです

サイトを開くと、サイドバーはそのサイトのコンテンツツリーに置き換わります。これは公開サイトで訪問者が見るのと同じ構造です。コンテキストを切り替えることなく、任意のセクションへ直接移動して編集を始められます。

サイドバーのコンテンツツリーは読み取り専用です。サイトを再編成するには、 構成エディタを開いてください。これは、サイト設定内の旧「構成」タブに代わる専用画面です。そこで行った変更は、すぐにサイドバーに反映されます。

セクションがスペースに置き換わります

サイト内のコンテンツは現在 セクションとして存在します。以前 GitBook を使ったことがあるなら、セクションはサイトにリンクされたスペースとして認識していたものです。セクションはエディタでも同じように機能します。変わったのは、その保存場所とサイトから設定を継承する方法です。

GitBook API では、セクションは引き続き スペース オブジェクトとして表されます。API 連携や Git Sync に変更はありません。

サイトツールにワンクリックでアクセス

Insights、Analytics、カスタマイズ、サイト設定は、現在サイトのサイドバー内の項目として表示され、メインビューで開きます。階層化された設定をたどって探す必要はもうありません。各画面の動作自体はこれまでとまったく同じです。

下書きセクション

新しいセクションは 下書きとして始まります。サイトにリンクされ、チームが編集できますが、訪問者には表示されません。準備ができたら、下書きを個別に公開するか、構成エディタからまとめて複数公開できます。

下書きがサイト上でどのように表示されるかを確認するには、サイトプレビューを 公開中 と 公開中 + 下書き.

コンテキスト内の組織設定

組織設定が画面全体を占めることはもうありません。組織レベルで、すべてのサイト画面の横にコンテキスト内で開くため、現在の場所を見失わずに組織全体のオプションを調整できます。

サイト継承の権限

セクションは、コレクションではなくサイトから権限を継承できます。メンバーが複数の経路でアクセス権を持つ場合は、最も許可範囲の広い付与が適用されます。Enterprise プランでは、複数のサイトで共有されるセクションは、最も広いアクセス権を継承します。

これはスペースごとに有効化します。有効化しないコンテンツは、既存のコレクションベースの権限が維持されます。

既存のスペースとコレクションはどうなるか

削除されたり、公開解除されたりすることはありません。

• すでにサイトにリンクされているスペースは、そのサイトのセクションになります。
• どのサイトにもリンクされていないスペースは、新しい すべてのコンテンツ セクションに、サイトと並んで、見慣れたツリービューで表示されます。コレクションはそこでフォルダとして保持されます。
• 組織内のすべてのスペースがサイトに属している場合、「すべてのコンテンツ」セクションは表示されません。

展開の仕組み

サイトワークスペースは段階的に展開されています。組織で利用可能になると、新しい体験を有効にするオプションと、何がどこに移動したかを案内する短いアプリ内ツアーが表示されます。