ページ

ページ、ページグループ、外部リンクを追加し、各ページで利用できるオプションについて学びましょう

ページとは、コンテンツを追加、編集、埋め込みできる場所です。ページは常に スペースの中にあり、関連するコンテンツをまとめたり、扱うトピックや領域ごとに異なるセクションを作成したりできます。

ドキュメントを公開すると、各スペースはそれぞれ独自の Docsサイト または サイトセクションになり、そのスペース内のページはすべてそのサイトに表示されます。

目次

スペース内では必要なだけページを作成できます。これらはすべて、画面左側のサイドバーにあるスペースの 目次に表示されます。スペースを公開すると、目次は同じ場所に表示されます。ただし、 それを非表示にする場合を除きます.

Docsサイトのランディングページ

目次の最初のページは、目次で非表示になっていても、常にスペースのランディングページになります。

新しいページを作成

のとき、 ライブ編集 モードまたは 変更リクエストでは、 新規追加... > ページ を目次の最下部でクリックすると新しいページを作成できます。あるいは、目次内のページの間にカーソルを合わせて、表示される + アイコンをクリックすることもできます。

GitBook内の空のページ。左側の目次に一覧表示されているのが確認できます。

新しいページを作成するオプションが表示されませんか？

もし ライブ編集 がスペースで無効になっている場合は、 変更リクエストを作成するか編集する必要があります。変更リクエストに入ると、 新しいページ ボタン（ページ、ページグループ、リンクを作成できます）が目次で利用可能になります。

あるいは、適切な 権限 がなくてページを編集できないのかもしれません。

コンテンツの整理

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

ページ

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

目次であるページを別のページの下にドラッグ＆ドロップすると、ページを入れ子にできます。これを行うと サブページ.

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

ヒント: ページの入れ子に制限はありませんが、ナビゲーションが複雑になりすぎないよう、3階層を超えないことをおすすめします。

ページのタイトルを変更すると、ページのスラッグ（URLの最後の部分。例： /hello-world）も変更されます。— ただし、以前にページのスラッグを手動で設定していた場合は除きます。

ページのタイトル、リンクタイトル、スラッグは、ページの アクションメニュー を開いて タイトルとスラッグを編集.

ページリンクのタイトル

ナビゲーション項目やリンク用には短いタイトルを維持しつつ、SEOに適した長めのタイトルにしたい場合は、任意でリンクタイトルを定義できます。

ページの アクションメニュー を開き、 タイトルとスラッグを編集を開きます。 ページを編集 ダイアログで、そのページのリンクタイトルを有効にして設定するオプションがあります。

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

# 目次

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

注: ページリンクのタイトルは、目次、各ページ下部のページ送りボタン、およびそのページに追加した相対リンクで使用されます。

ページリンクのタイトルは任意です。手動で追加しない場合、ページは既定で標準のページタイトルを使用します。

ページグループ

ページグループを使うと、関連するコンテンツを扱うセクションにページをまとめることができます。

新しいページグループは、目次の下部で 新規追加... > グループ をクリックすると作成できます。

ページグループは、目次の 最上位 にのみ配置できます。ページグループの中にページグループを入れ子にすることはできません。

ページグループのタイトルとスラッグを変更するには、目次内のグループタイトルの横にある アクションメニュー icon をクリックして、 名前を変更.

外部リンク

を選択します。

また、目次にリンクを追加することもできます。それをクリックすると、リンク先のコンテンツに直接移動します。 新規追加... > 外部リンク をクリックすると作成できます。

ページアイコンと絵文字

目次をざっと確認する読者の視認性を高めるために、各ページに任意のアイコンまたは絵文字を追加できます。アイコンまたは絵文字は目次と、ページ上部のタイトルの横に表示されます。

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

ページオプション

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

レイアウト

次の方法で ページオプション メニュー、またはページタイトルにカーソルを合わせてページのカバーを変更します。ページタイトルの少し上にボタンが表示されます。

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

各レイアウトプリセットでは、次のページ要素を個別にオン/オフできます：

• ページタイトル

• ページの説明

• 目次

• ページアウトライン

• 次/前リンク

• ページのメタデータ

• タグ

ページには ライブラリ → タグから1つ以上のタグを付けることができます。 ページにタグを表示 を有効にすると、ページヘッダーに表示されます。また、1つのタグをページの主要タグとして選ぶこともできます。GitBookでは、目次のページの横にそのタグを表示できます。詳細は タグ.

から確認できます。また、このメニューからページの全幅も設定できます。 ワイド を選ぶと、 全幅 オプションをサポートするブロック（表、カード、コードブロックなど）が自動的に広がり、ページ公開時により多くのスペースを使えるようになります。目を引くランディングページを作成するのに最適です。

表示設定

公開したドキュメントでどのページを表示/非表示にするかを決められます。また、そのページを公開ドキュメント内の検索にインデックスするか、検索エンジンにインデックスさせるかも決められます。

ページの アクションメニュー を開いて ページを非表示.

に切り替えることで、サイトの目次からページやページグループを非表示にできます。Git Syncを使用している場合、非表示にすると次の内容がMarkdownファイルのフロントマターに表示されます：

page.md

---
hidden: true
---

メタデータ（SEO）

使用 ページオプション → メタデータ を使って、検索エンジンが類似ページ間の関係を理解する方法を制御できます（例：ドキュメントのバージョンや コンテンツバリアント).

• 正規URL：このページの優先される（権威ある）URL。検索エンジンはこれを「真実のソース」として扱います。複数のURLで同じコンテンツが表示される場合に使用します。

• 代替URL：別のバリエーションにある同じコンテンツの他のURL。たとえば、別のバージョンや言語です。重複として扱うのではなく、検索エンジンがバリエーションをまとめるのに役立ちます。

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

バージョン管理されたドキュメントでは、古いページを最新の対応ページに対する正規URLに設定し（例： 1.0 → 2.0）、そのうえで最新ページに古いバージョンを代替として一覧表示するのが一般的です。

ページカバー

ドキュメントの各ページにページカバーを設定することもできます。 ページカバー オプションをクリックすると、既定のカバーがすぐに追加されます。そこから次のことができます：

• カバー画像を変更する

  ページカバーにカーソルを合わせて カバーを変更をクリックし、画像を選択またはアップロードします。現在のページカバーの表示方法に基づくと、1990×480ピクセルが理想的なサイズです。

• カバー画像の位置を調整する

  ページカバーにカーソルを合わせて アクションメニュー を開きます。 位置を調整をクリックし、必要に応じて画像をドラッグしてから 保存.

• カバー画像を削除する ページカバーにカーソルを合わせて アクションメニュー の上部近くにある組織切り替えトグルをクリックし、次に 削除.

• 全幅とヒーロー幅 ページカバーのスタイルを、画面全体の幅に広げるか、コンテンツの幅のみにするか変更できます。ページカバーにカーソルを合わせて アクションメニュー を開き、メニューから希望のオプションを選択します。