> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/creating-content/reusable-content.md).
# 再利用可能なコンテンツ
{% hint style="info" %}
この機能は～で利用できます [ProプランおよびEnterpriseプラン](https://www.gitbook.com/pricing).
{% endhint %}
再利用可能なコンテンツを使うと、複数のページやセクション間でコンテンツを同期できるため、ブロックのすべてのインスタンスを同時に編集できます。
セクション内で再利用可能なコンテンツを作成します。
## 基本事項
再利用可能なコンテンツは他のコンテンツと同じように機能します。変更リクエストで変更したり、レビューのワークフローに含めたりでき、公開されたサイト上では正しく表示されます。
再利用可能なコンテンツは複数のセクションから参照できますが、所属先は1つの *親セクション*.
### 「親セクション」の概念
親セクションとは、再利用可能なコンテンツを所有するセクションのことです。そこだけが、そのコンテンツを編集できる場所です。
再利用可能なコンテンツへの更新はすべてのインスタンスに即座に反映されますが、変更はすべて親セクションから行われる必要があります。直接編集する場合でも、変更リクエスト経由の場合でも同じです。
セクションは編集ワークフローとセキュリティの両方をサポートしています。GitBookでは権限ベースの編集が適用されるため、再利用可能なコンテンツは親セクションからしか変更できません。これにより、組織全体でコンテンツが再利用されても、編集権限が確実に尊重されます。
### 既知の制限
#### 連携
連携が提供するブロックは、再利用可能なコンテンツではサポートされていません。GitBook の連携はセクションごとにインストールされ、アクセスを制限することで、サードパーティの連携には付与した権限のみが与えられるようにしているためです。セクション間で再利用可能なコンテンツを参照すると、このセキュリティ境界が崩れてしまいます。
#### 検索
現在、再利用可能なコンテンツは親セクション内の検索結果にのみ表示されます。この制限をなくし、参照されているすべての場所の検索結果に再利用可能なコンテンツが表示されるよう、現在対応を進めています。
## アプリで
### **再利用可能なコンテンツを作成**
再利用可能なコンテンツを作成するには、1つ以上のブロックを選択してから **アクションメニュー** を開き、 **変換**を選択して、 **再利用可能なコンテンツ**を選びます。後で見つけやすく、再利用しやすくするために、ブロックに名前を付けることもできます。
別の方法として、1つ以上のブロックを選択してから **Cmd + C** を押すと、再利用可能なコンテンツを作成するかどうかを尋ねるプロンプトが開きます。
### **再利用可能なコンテンツを挿入**
再利用可能なコンテンツは、他のブロックと同じように挿入できます。 `/` を空行で押すと **挿入パレット**を開けます。 `+` また、任意のブロックや空行の横にある
をクリックすることもできます。
ページサイドバーの再利用可能なコンテンツパネルには、現在のセクションで以前に作成されたコンテンツブロックが一覧表示されます。
1. から再利用可能なコンテンツを挿入するには **挿入パレット** または `+` メニューを開きます。
2. 上部のセクションセレクターを使って、ソースセクションを選択します。
3. 名前で再利用可能なブロックを検索し、それを選択して挿入します。
別のセクションからコンテンツを挿入しても、所有権は移りません。編集できるのは親セクションだけです。その親セクションからの更新は、引き続きすべてのインスタンスに同期されます。
### **再利用可能なコンテンツを編集**
再利用可能なコンテンツは他のコンテンツと同じです。ライブ編集が有効なら任意のインスタンスを直接編集でき、無効なら変更リクエスト経由で編集できます。行った変更は、コンテンツが使用されているすべての場所に同期されます。
変更リクエスト内で変更を行っている場合、その変更リクエストがマージされると、コンテンツは他のすべてのインスタンスに同期されます。
### **再利用可能なコンテンツを分離**
再利用可能なコンテンツを分離するには **アクションメニュー** を開いて **分離**を選択します。分離すると、そのコンテンツは通常のブロックに戻ります。
分離後は、ブロックに加えた変更は他のインスタンスに反映されず、他のインスタンスで加えた変更も分離されたブロックには反映されません。再利用可能なコンテンツの他のすべてのインスタンスは、引き続き互いに同期されたままです。
### 再利用可能なコンテンツを削除
必要であれば、セクションから再利用可能なコンテンツを完全に削除できます。ページの目次で再利用可能なコンテンツを見つけ、削除したいコンテンツの横にある **アクションメニュー** を開いて、 **削除**.
再利用可能なコンテンツを削除すると **それが使用されているすべてのページから削除されます**。この操作は元に戻せません。
## GitHub と GitLab との同期
GitHub と GitLab に同期する場合、再利用可能なコンテンツは完全にサポートされています。再利用可能なコンテンツは専用の `includes` フォルダーにエクスポートされ、各コンテンツは個別の Markdown ファイルになります。
その後、他のページでは `includes` ディレクティブ
{% hint style="info" %}
を使ってコンテンツを参照します。 `.gitbook/includes` ディレクトリは、同期された各セクションのルートに作成されます（リポジトリ全体のルートとは限りません）。もし `.gitbook/includes` フォルダーやそのファイルがセクションの目次に表示される場合は、TOC から手動で非表示にする必要があるかもしれません。
{% endhint %}
#### 例
{% hint style="success" %}
GitHub 側で作業している場合、include へのパスが参照を含むファイル基準で相対パスになっていることを確認してください（リポジトリのルート基準ではありません）。
{% endhint %}
```markdown
{% include "../../.gitbook/includes/reusable-block.md" %}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/creating-content/reusable-content.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.