再利用可能なコンテンツ

スペース全体で使用できる再利用可能なコンテンツブロックを作成し、インスタンスを変更すると同時にすべて更新されるようにする

再利用可能なコンテンツを使用すると、複数のページやスペースにまたがってコンテンツを同期できるため、ブロックのすべてのインスタンスを同時に編集できます。

スペース内で再利用可能なコンテンツを作成する。

基本事項

再利用可能なコンテンツは他のコンテンツと同様に機能します—変更リクエストを通じて修正したり、レビューのワークフローに含めたりでき、公開されたどのサイトでも正しくレンダリングされます。

再利用可能なコンテンツは複数のスペースで参照できる一方で、単一の 親スペース.

「親スペース」概念

親スペースは再利用可能なコンテンツを所有するスペースです。そこだけがそのコンテンツを編集できる場所です。

再利用可能なコンテンツの更新はすべてのインスタンスに即座に反映されますが、すべての変更は親スペースから発生する必要があります—直接編集によるものか変更リクエストを通じたものかのいずれかです。

スペースはGitBookのコア概念であり、編集ワークフローとセキュリティの両方をサポートします。GitBookは権限に基づく編集を強制するため、再利用可能なコンテンツは親スペースからのみ変更できます。これにより、コンテンツが組織内で再利用される場合でも編集権限が尊重されます。

既知の制限事項

統合

統合によって提供されるブロックは再利用可能なコンテンツではサポートされていません。これはGitBookの統合がスペースごとにインストールされるためであり、アクセスを制限することでサードパーティの統合が付与された権限のみを持つようにしています。再利用可能なコンテンツをスペース間で参照すると、このセキュリティ境界が破られる可能性があります。

検索

現時点では、再利用可能なコンテンツは親スペース内の検索結果にのみ表示されます。参照される場所すべてで再利用可能なコンテンツが検索結果に表示されるよう、この制限の解除に向けて積極的に取り組んでいます。

アプリ内で

再利用可能なコンテンツを作成する

再利用可能なコンテンツを作成するには、 1つ以上のブロックを選択します、次に 操作メニュー を選択し、バックエンドとして Okta を選びます。 に変換、そしてを選択します 再利用可能なコンテンツ。ブロックに名前を付けておくと、後で見つけて再利用しやすくなります。

あるいは、1つ以上のブロックを選択してから Cmd + C を押すと、再利用可能なコンテンツを作成するかどうかを尋ねるプロンプトが開きます。

再利用可能なコンテンツを挿入する

再利用可能なコンテンツは他のブロックと同様に挿入できます。 / 空の行で 挿入パレット を開くにはを押して、コンテンツを名前で検索するか「reusable」と検索します。あるいは、任意のブロックまたは空の行の左側にある + をクリックしてください。

また、ページのサイドバーに再利用可能なコンテンツパネルがあり、現在のスペースで以前に作成したコンテンツブロックの一覧を見つけることができます。

再利用可能なコンテンツを編集する

再利用可能なコンテンツは他のコンテンツと同様です — が有効になっている場合は任意のインスタンスを直接編集できます、 ライブ編集 、または無効の場合は 変更リクエスト を通じて編集できます。行った変更はコンテンツが使用されているすべての場所で同期されます。

変更リクエスト内で変更を行っている場合、その変更リクエストがマージされるとコンテンツは他のすべてのインスタンスに同期されます。

再利用可能なコンテンツの切り離し

再利用可能なコンテンツは、 操作メニュー を選択することで削除できます 切り離しを開いて切り離すことができます。切り離すとコンテンツは通常のブロックに戻ります。

一度切り離すと、そのブロックに対して行った変更は他のインスタンスに反映されず、他のインスタンスでの変更も切り離されたブロックには反映されません。再利用可能なコンテンツの他のすべてのインスタンスは引き続き相互に同期されたままです。

再利用可能なコンテンツを削除する

必要に応じてスペースから再利用可能なコンテンツを完全に削除できます。ページの目次で再利用可能なコンテンツを見つけ、削除したいコンテンツの横にある 操作メニュー を開いて、を選択します 削除.

再利用可能なコンテンツを削除すると、 それが使用されているすべてのページから削除されます。この操作は取り消せません。

GitHubおよびGitLabとの同期

再利用可能なコンテンツはGitHubおよびGitLabへの同期で完全にサポートされています。再利用可能なコンテンツは専用の includes フォルダにエクスポートされ、各コンテンツは個別のMarkdownファイルになります。

その後、コンテンツは他のページで includes ディレクティブ

を使用して参照されます。 同期する際、 .gitbook/includes 同期する際、 ディレクトリが各同期されたスペースのルートに作成されます（リポジトリ全体のルートではない場合があります）。もしあなたの

例

フォルダやそのファイルがスペースの目次に表示される場合は、目次から手動で非表示にする必要があるかもしれません。

もしGitHub側で執筆している場合、インクルードへのパスが参照を含むファイルに対して相対パスであることを確認してください（リポジトリのルートではありません）。