ページ

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

ページは、コンテンツを追加、編集、埋め込むことができる場所です。ページは常に、 スペースの中に存在し、関連するコンテンツをまとめたり、扱っているトピックや領域ごとにさまざまなセクションを作成したりできます。

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

目次

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

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

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

新しいページを作成

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

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

新しいページを作成するオプションが見つかりませんか？

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

または、ページを編集するための適切な 権限 を持っていない可能性があります。

コンテンツの整理

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

ページ

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

目次内でページを別のページの下へドラッグ＆ドロップすると、ページを階層化できます。これにより サブページ.

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

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

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

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

ページリンクのタイトル

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

ページの アクションメニュー を選択し、 タイトルとスラッグを編集から、メンバーを直接招待できます。 ページを編集 ダイアログを開くと、そのページのリンクタイトルを有効化して設定するオプションがあります。

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

# 目次

サイドバーのナビゲーションとページ本体で異なるタイトルを定義できます:

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

ページリンクタイトルは任意です。手動で追加しない場合、デフォルトではページの標準タイトルが使用されます。

ページグループ

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

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

ページグループは目次の トップレベル にのみ配置できます。ページグループの中にページグループを入れ子にすることはできません。

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

外部リンク

を選択します。

新しい外部リンクは、 新規追加... > 外部リンク を目次の最下部でクリックすると作成できます。

ページアイコンと絵文字

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

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

ページオプション

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

レイアウト

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

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

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

• ページタイトル

• ページの説明

• 目次

• ページアウトライン

• 次/前のリンク

• ページメタデータ

• タグ

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

このメニューからページの全体幅も設定できます。 ワイド を選ぶと、ページ公開時に表、カード、コードブロックなどのブロックにより広いスペースが与えられます。目を引くランディングページを作成するのに最適です。

表示設定

公開済みドキュメントで表示/非表示にしたいページを決めることができ、さらにそのページを公開済みドキュメントの検索にインデックスさせるか、検索エンジンにインデックスさせるかも選べます。

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

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

page.md

---
hidden: true
---

メタデータ（SEO）

使うもの ページオプション → メタデータ を使って、検索エンジンに類似ページ間の関係をどのように理解させるかを制御します（例：ドキュメントのバージョンや コンテンツバリアント).

• 正規URL：このページの推奨される（正規の）URLです。検索エンジンはこれを「真実の情報源」として扱います。複数のURLが同じ内容を表示する場合に使用します。

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

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

バージョン管理されたドキュメントでよくあるパターンは、古いページを最新の対応ページに対して正規ページに設定することです（たとえば、 1.0 → 2.0）、そして最新ページには古いバージョンを代替として列挙します。

ページカバー

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

• カバー画像を変更する

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

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

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

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

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