> 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/kontentsuwosuru/reusable-content.md).
# 再利用可能なコンテンツ
再利用可能なコンテンツを使うと、複数のページやセクション間でコンテンツを同期できるため、ブロックのすべてのインスタンスを同時に編集できます。
セクション内に再利用可能なコンテンツを作成します。
## 基礎
再利用可能なコンテンツは他のコンテンツと同じように機能します。変更リクエストで変更でき、レビュー用ワークフローに含めることができ、公開済みのどのサイトでも正しくレンダリングされます。
再利用可能なコンテンツは複数のセクションから参照できますが、属しているのは1つの *親セクション*.
### 「親セクション」の概念
親セクションは、再利用可能なコンテンツを所有するセクションです。そこだけがそのコンテンツを編集できる唯一の場所です。
再利用可能なコンテンツへの更新はすべてのインスタンスに即座に反映されますが、すべての変更は親セクションから行われる必要があります。直接編集する場合でも、変更リクエストを通す場合でも同じです。
セクションは、編集ワークフローとセキュリティの両方をサポートします。GitBookでは権限に基づく編集が適用されるため、再利用可能なコンテンツは親セクションからのみ変更できます。これにより、コンテンツが組織全体で再利用されている場合でも、編集権限が確実に尊重されます。
### 既知の制限事項
#### 統合
統合によって提供されるブロックは、再利用可能なコンテンツではサポートされていません。GitBook の統合はセクションごとにインストールされ、アクセスを制限することでサードパーティ統合に付与した権限だけを持たせられるためです。セクションをまたいで再利用可能なコンテンツを参照すると、このセキュリティ境界が崩れてしまいます。
#### 検索
現在、再利用可能なコンテンツは親セクション内の検索結果にのみ表示されます。この制限をなくし、参照されているすべての場所の検索結果に再利用可能なコンテンツが表示されるよう、現在対応を進めています。
## アプリ内で
### **再利用可能なコンテンツを作成する**
再利用可能なコンテンツを作成するには、1つ以上のブロックを選択してから、次を開きます **アクションメニュー** 、 **変換**に移動し、 **再利用可能なコンテンツ**。また、後で見つけやすく再利用しやすいように、ブロックに名前を付けることもできます。
または、1つ以上のブロックを選択してから **Cmd + C** を押すと、再利用可能なコンテンツを作成するかどうかを尋ねるプロンプトが開きます。
### **再利用可能なコンテンツを挿入する**
他のブロックと同じように再利用可能なコンテンツを挿入できます。 `/` 空行で **挿入パレット**を開きます。また、 `+` 任意のブロックまたは空行の横をクリックすることもできます。
ページのサイドバーにある再利用可能なコンテンツのパネルには、現在のセクションで以前に作成したコンテンツブロックが一覧表示されます。
現在のセクションまたは別のセクションから再利用可能なコンテンツを挿入するには、次の方法でアクセスできます：
1. 再利用可能なコンテンツのピッカーを開くには **挿入パレット** または `+` メニュー。
2. 上部のセクションセレクターを使って、ソースとなるセクションを選択します。
3. 名前で再利用可能なブロックを検索し、選択して挿入します。
別のセクションからコンテンツを挿入しても、所有権は移りません。再利用可能なコンテンツを編集できるのは親セクションだけです。親セクションからの更新は、その後もすべてのインスタンスに同期されます。
### **再利用可能なコンテンツを編集する**
再利用可能なコンテンツは他のコンテンツと同じです。ライブ編集が有効なら任意のインスタンスを直接編集でき、そうでなければ変更リクエストを通して編集できます。加えた変更は、そのコンテンツが使われているすべての場所に同期されます。
変更リクエスト内で変更を行っている場合、その変更リクエストがマージされると、コンテンツは他のすべてのインスタンスにも同期されます。
### **再利用可能なコンテンツの切り離し**
次を開いて再利用可能なコンテンツを切り離すことができます **アクションメニュー** を開き、 **切り離す**を選択します。切り離すと、コンテンツは通常のブロックに戻ります。
切り離した後は、そのブロックに加えた変更は他のインスタンスに反映されなくなり、他のインスタンスで加えた変更も切り離されたブロックには反映されなくなります。再利用可能なコンテンツの他のすべてのインスタンス同士は、引き続き同期されたままです。
### 再利用可能なコンテンツを削除する
必要であれば、セクションから再利用可能なコンテンツを完全に削除できます。ページの目次で再利用可能なコンテンツを見つけ、削除したいコンテンツの横の **アクションメニュー** を開き、 **削除**.
再利用可能なコンテンツを削除すると **使用されているすべてのページから削除されます**。この操作は元に戻せません。
## GitHub と GitLab との同期
GitHub と GitLab に同期する場合、再利用可能なコンテンツは完全にサポートされています。再利用可能なコンテンツは専用の `には次が含まれます` フォルダに書き出され、各コンテンツは個別の Markdown ファイルになります。
その後、コンテンツは次の `には次が含まれます` ディレクティブ
{% 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/kontentsuwosuru/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.