> 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).

# 再利用可能なコンテンツ

セクション全体で使用できる再利用可能なコンテンツブロックを作成し、インスタンスを変更するとすべて一括で更新されます

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

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-91ee7221fa85ca607bb05c425da8f3fe94812ae2%2F25_12_10_creating_content_reusable_content%402x.png?alt=media" alt="A GitBook screenshot showing reusable content"><figcaption><p>セクション内で再利用可能コンテンツを作成します。</p></figcaption></figure>

## 基本

再利用可能コンテンツは他のコンテンツと同じように扱えます。変更リクエストで修正でき、レビュー ワークフローに含めることもでき、公開済みのどのサイトでも正しく表示されます。

再利用可能なコンテンツは複数のセクションから参照できますが、所属するのは1つの *親セクションです*.

### 「親セクション」の概念

親セクションとは、再利用可能コンテンツを所有するセクションです。そのコンテンツを編集できるのは、その場所だけです。

再利用可能コンテンツの更新はすべてのインスタンスに即座に反映されますが、変更はすべて親セクションから行う必要があります。直接編集する場合でも、変更リクエスト経由の場合でも同様です。

セクションは編集ワークフローとセキュリティの両方をサポートしています。GitBook は権限に基づく編集を強制するため、再利用可能コンテンツは親セクションからしか変更できません。これにより、組織全体でコンテンツが再利用されている場合でも、編集権限が適切に守られます。

### 既知の制限

#### 連携

連携機能が提供するブロックは、再利用可能コンテンツではサポートされていません。GitBook の連携機能はセクションごとにインストールされ、アクセスを制限することでサードパーティの連携機能に付与した権限だけを持たせています。セクション間で再利用可能コンテンツを参照すると、このセキュリティ境界が崩れてしまいます。

#### 検索

現在、再利用可能コンテンツは親セクション内の検索結果にのみ表示されます。参照されている場所ならどこでも検索結果に表示されるよう、この制限の解消に積極的に取り組んでいます。

## アプリ内

### **再利用可能コンテンツを作成**

再利用可能なコンテンツを作成するには、1つ以上のブロックを選択してから、 **「アクション」メニュー** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture> を開き、 **「変換」**&#x3092;選択して、 **「再利用可能なコンテンツ」**&#x3092;選びます。後で見つけて再利用しやすいように、ブロックに名前を付けることもできます。

または、1つ以上のブロックを選択して、 **Cmd + C** キーを押すと、再利用可能なコンテンツを作成するかどうかを尋ねるプロンプトが表示されます。

### **再利用可能コンテンツを挿入**

再利用可能なコンテンツは、他のブロックと同じように挿入できます。空行で `/` を押すと、 **「挿入」パレット**が開きます。また、任意のブロックまたは空行の横にある `+` をクリックすることもできます。

ページのサイドバーにある再利用可能コンテンツのパネルには、現在のセクションで以前に作成したコンテンツブロックが一覧表示されます。

現在のセクションまたは別のセクションから再利用可能コンテンツを挿入するには、次を利用できます:

1. 再利用可能なコンテンツの選択画面は、 **「挿入」パレット** または `+` メニューから開きます。
2. 上部のセクションセレクターを使って、ソースセクションを選択します。
3. 再利用ブロックを名前で検索し、選択して挿入します。

別のセクションからコンテンツを挿入しても、所有権は移りません。再利用可能コンテンツを編集できるのは親セクションだけです。その親セクションでの更新は、すべてのインスタンスに引き続き同期されます。

### **再利用可能コンテンツを編集**

再利用可能コンテンツは他のコンテンツと同様です。ライブ編集が有効なら任意のインスタンスを直接編集でき、そうでなければ変更リクエストで編集できます。加えた変更は、コンテンツが使われているすべての場所に同期されます。

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

### **再利用可能コンテンツを切り離す**

再利用可能なコンテンツを切り離すには、 **「アクション」メニュー** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture> を開いて **「切り離す」**&#x3092;選択します。切り離すと、コンテンツは通常のブロックに戻ります。

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

### 再利用可能コンテンツを削除

必要に応じて、セクションから再利用可能なコンテンツを完全に削除できます。ページの目次で該当する再利用可能なコンテンツを見つけ、削除したいコンテンツの横にある **「アクション」メニュー** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture> を開いて、 **「削除」**.

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

## GitHub と GitLab との同期

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

その後、他のページでは `includes` ディレクティブを使ってコンテンツを参照します。

{% hint style="info" %}
同期すると、各同期対象セクションのルート（リポジトリ全体のルートとは異なる場合があります）に `.gitbook/includes` ディレクトリが作成されます。 `.gitbook/includes` フォルダーまたはそのファイルがセクションの目次に表示される場合は、目次から手動で非表示にする必要があります。
{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/reusable-content.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
