> 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/content-structure/page.md).

# ページ

ページは、コンテンツを追加、編集、埋め込みできる場所です。ページは常にセクション内に配置され、扱っているトピックや分野に関連するコンテンツをまとめられます。

サイトを公開すると、各セクションがサイトのナビゲーションに表示され、その中のページはすべてそのセクションの下に表示されます。

### 目次

セクション内には必要なだけページを作成できます。これらはすべて、画面左側のサイドバーにあるセクションの目次に表示されます。公開サイトでも同じ場所に目次が表示されます。ただし、 [非表示にする場合は別です](#page-options).

{% hint style="info" %}
**セクションのランディングページ**

目次の最初のページは、目次から非表示にしていても、常にセクションのランディングページになります。
{% endhint %}

### 新しいページを作成

1. ライブ編集モードに入るか、変更リクエストを開きます。
2. 次をクリックします **新規追加...** 目次の下部に。
3. 次をクリックします **ページ**.

または、目次内のページ間にカーソルを合わせて、 **+** 表示されるアイコンをクリックします。

<figure><img src="/files/3ee8d38b934d081ec9436ae0fe73af015d57470d" alt="A GitBook screenshot showing an empty page listed in the table of contents"><figcaption><p>GitBook の空のページです。左側の目次に一覧表示されます。</p></figcaption></figure>

### 新しいページのオプションが見つからない

{% hint style="warning" %}
セクションでライブ編集が無効になっている場合は、変更リクエストを作成または編集してください。変更リクエストでは、 **新しいページ** ページ、ページグループ、リンクを作成するボタン — は目次で利用できます。

ページを編集する権限がない場合もあります。
{% endhint %}

### コンテンツの整理

目次内でコンテンツを整理する方法は3つあります。

#### ページ

ページには、タイトル、任意の説明、そしてあらゆる種類のコンテンツを記述・追加できる領域があります。

目次でページを別のページの下にドラッグ＆ドロップして入れ子にできます。これにより、 **サブページ**.

空の親ページにサブページを追加すると、GitBook は公開版のドキュメントにあるすべてのサブページへのリンクを含む「contents」ページを自動生成します。

{% hint style="info" %}
**ヒント：** ページのネストに制限はありませんが、ナビゲーションをシンプルに保つため、3階層を超えないようにしてください。
{% endhint %}

ページのタイトルを変更すると、ページのスラッグ（URL の末尾部分。たとえば `/hello-world`）も変更されます — 以前にページのスラッグを手動で設定していない限り。

ページのタイトル、リンクタイトル、またはスラッグを変更するには：

1. ページの **アクションメニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt="The Actions menu icon in GitBook"></picture>.
2. 次をクリックします **タイトルとスラッグを編集**.

#### ページのリンクタイトル

ナビゲーション項目やリンク用には短いタイトルを保ちつつ、SEO に配慮した長めのタイトルをページに付けたい場合は、リンクタイトルを設定します。

1. ページの **アクションメニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt="The Actions menu icon in GitBook"></picture>.
2. 次をクリックします **タイトルとスラッグを編集**.
3. 「 **ページを編集** 」ダイアログで、そのページのリンクタイトルを有効にして設定します。

Git Sync を使用している場合は、ページのリンクタイトルを `SUMMARY.md` のページリンクで設定します：

```markdown
# 目次

* [ページのメインタイトル](page.md "ページのリンクタイトル")
```

{% hint style="info" %}
**注：** ページのリンクタイトルは、目次、各ページ下部のページ送りボタン、そしてそのページに追加した相対リンクに表示されます。
{% endhint %}

ページのリンクタイトルは任意です — 追加しない場合、ページには標準のタイトルが使われます。

#### ページグループ

ページグループは、セクションの目次内で関連するページをまとめます。

{% hint style="info" %}
ページグループは整理します **ページを** 1つのセクション内で。サイト全体を整理するには、代わりに **セクション** グループを使用します。
{% endhint %}

次をクリックしてページグループを作成します **新規追加...** > **グループ** 目次の下部に。

ページグループは **最上位** の目次にのみ存在します — ページグループ同士を入れ子にすることはできません。

ページグループのタイトルとスラッグを変更するには：

1. 次をクリックします **アクションメニュー** アイコン <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt="The Actions menu icon in GitBook"></picture> 目次のグループタイトルの横にあります。
2. 次をクリックします **名前を変更**.

#### 外部リンク

目次にリンクを追加して、リンク先のコンテンツへ直接移動できるようにします。

次をクリックして外部リンクを作成します **新規追加...** > **外部リンク** 目次の下部に。

### ページアイコンと絵文字

目次をざっと見たときに読者が見つけやすくなるよう、各ページに任意のアイコンや絵文字を追加できます。アイコンや絵文字は目次に表示され、ページ上部のタイトルの横にも表示されます。

アイコンまたは絵文字を追加するには、 **アイコンを追加** ページタイトルにカーソルを合わせたときに表示されるボタン、またはタイトルの左側にある絵文字ボタンをクリックします。

### ページオプション

「 **ページオプション** メニューでは、セクション内の選択したページの見た目をカスタマイズし、表示/非表示を制御できます。

#### レイアウト

次を開きます **ページオプション** <picture><source srcset="/files/tb21SaZbz1g0fv6lzP83" media="(prefers-color-scheme: dark)"><img src="/files/505387fe5869c84d879d00ee08741fbf9b7b8651" alt="The Page options menu icon in GitBook"></picture> メニューを開くか、ページタイトルにカーソルを合わせてページのカバーを変更します。ボタンはページタイトルのすぐ上に表示されます。

「 **ページオプション** サイドパネルで、各ページをあなたのサイトの訪問者にどのように表示するかを選択します **公開済み** コンテンツ。選べるレイアウトのプリセットは3つあり、カスタムレイアウトを作成することもできます。

各レイアウトのプリセットでは、以下のページ要素を表示または非表示に切り替えます：

* ページタイトル
* ページ説明
* 目次
* ページアウトライン
* 次へ/前へリンク
* ページメタデータ
* タグ

次の中から1つ以上のタグでページをタグ付けします **ライブラリ** → **タグ**。オンにして **ページにタグを表示** をオンにすると、ページヘッダーに表示されます。あるいは、1つのタグをページの主要タグとして選ぶこともでき、その場合 GitBook は目次内のページの横に表示できます。詳細は「タグ」を参照してください。

このメニューからページの全体幅も設定できます。 **ワイド** を選ぶと、テーブル、カード、コードブロックなどのブロックに公開ページ上でより広いスペースが与えられます。目を引くランディングページに使ってください。

#### 表示設定

公開ドキュメントで表示するページと非表示にするページ、さらに各ページをサイト内検索や検索エンジンに表示するかどうかを選択します。

サイトの目次からページまたはページグループを非表示にするには：

1. ページの **アクションメニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt="The Actions menu icon in GitBook"></picture>.
2. 切り替え **ページを非表示**.

非表示のページは、公開された目次からのみ非表示になります。サイトの MCP サーバーおよび `llms-full.txt`.

Git Sync を使用している場合、非表示のページには Markdown ファイル内に次のフロントマターが含まれます：

<pre class="language-markdown" data-title="page.md"><code class="lang-markdown">---
hidden: true
<strong>---
</strong></code></pre>

{% hint style="warning" %}
非表示にすると **ページタイトル** または **ページ説明** 公開コンテンツではページヘッダーのみが非表示になります。ページ本文内の見出しは削除されません。見出しレベルの詳細は「見出し」を参照してください。
{% endhint %}

#### メタデータ（SEO）

使用 **ページオプション → メタデータ** を使って、検索エンジンが類似ページ間の関係（たとえばドキュメントのバージョンやコンテンツのバリエーション）をどのように理解するかを制御します。

* **正規 URL**：このページで優先される（正規の）URLです。検索エンジンはこれを「信頼できる元情報」として扱います。複数の URL で同じコンテンツが表示される場合に使用してください。
* **代替 URL**：同じコンテンツの別バリエーションの URL です。たとえば別バージョンや別言語です。検索エンジンが重複として扱うのではなく、バリエーションとしてまとめるのに役立ちます。

どちらの欄でも、別の GitBook ページを選択する（推奨）か、外部 URL を入力できます。

{% hint style="info" %}
バージョン管理されたドキュメントでは、古いページを最新の対応ページに対する正規ページに設定するのが一般的です（たとえば、 `1.0` → `2.0`）、そのうえで最新ページに古いバージョンを代替として列挙します。
{% endhint %}

### ページカバー

ドキュメントの各ページにページカバーを設定します。 **ページカバー** <picture><source srcset="/files/m3pW0fk37zO88JKWr4U5" media="(prefers-color-scheme: dark)"><img src="/files/c8656b72596b540f02c3735ba6fbb795250d63dc" alt="The Page cover icon in GitBook"></picture> オプションをクリックすると、GitBook はすぐにデフォルトのカバーを追加します。ここから次のことができます。

* **カバー画像を変更する**
  1. ページカバーにカーソルを合わせて、 **カバーを変更**.
  2. 画像を選択またはアップロードします。推奨サイズは 1990×480 ピクセルです。
* **カバー画像の位置を調整する**
  1. ページカバーにカーソルを合わせて、 **アクションメニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt="The Actions menu icon in GitBook"></picture>.
  2. 次をクリックします **位置を調整**.
  3. 画像をドラッグして位置を合わせ、 **保存**.
* **カバー画像を削除する**
  1. ページカバーにカーソルを合わせて、 **アクションメニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt="The Actions menu icon in GitBook"></picture>.
  2. 次をクリックします **削除**.
* **全幅とヒーロー幅**

  ページカバーのスタイルを、画面全幅またはコンテンツ幅に変更できます。

  1. ページカバーにカーソルを合わせて、 **アクションメニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt="The Actions menu icon in GitBook"></picture>.
  2. 希望するオプションをクリックします。


---

# 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/content-structure/page.md?ask=<question>&goal=<endgoal>
```

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