ページ

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

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

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

目次

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

ドキュメントサイトのランディングページ

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

新しいページを作成する

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

GitBookの空のページ。左側の目次にリストされているのが見えます。

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

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

あるいは、あなたに適切な 権限 がなく、ページを編集できない可能性もあります。

コンテンツの整理

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

ページ

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

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

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

ヒント： ページの入れ子には制限はありませんが、ナビゲーションが過度に複雑になるのを避けるために3階層以上の入れ子は推奨しません。

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

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

を選択することで変更できます。

ページリンクタイトル

ページに対してより長くSEOに適したタイトルを持たせつつ、ナビゲーション項目やリンクでは短いタイトルを維持したい場合、任意でリンクタイトルを定義できます。 アクションメニュー ページの 「タイトルとスラッグを編集」を開き、 「ページを編集」 ダイアログで、そのページのリンクタイトルを有効にして定義するオプションが見つかります。

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

# Table of contents

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

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

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

ページグループ

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

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

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

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

を選択します。

外部リンク

目次にリンクを追加することもできます。クリックすると直接リンク先のコンテンツに移動します。 「新規追加...」 > 目次の下部で をクリックして新しいページグループを作成できます。

「外部リンク」

をクリックして新しい外部リンクを作成します。

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

「アイコンを追加」

ボタン、またはタイトルの左側にある絵文字ボタンをクリックします。 「アイコンを追加」 ページオプション

メニューでは、スペース内で選択したページの外観をカスタマイズし、その可視性を制御できます。

レイアウト 「アイコンを追加」 ページタイトルにホバーしてメニューを開くか、カバーを変更することで

ボタン、またはタイトルの左側にある絵文字ボタンをクリックします。 「アイコンを追加」 メニューを開くことができ、ページタイトルのすぐ上にボタンが表示されます。 サイドパネルでは、訪問者があなたの 公開済み

コンテンツをどのように表示するかを選択できます。選べるレイアウトプリセットは3種類あり、カスタムレイアウトを作成することもできます。

• 各レイアウトプリセットは以下の各部分をオンまたはオフに切り替えます：

• ページタイトル

• 目次

• ページの説明

• ページの概要

• 前へ／次へリンク

ページのメタデータ このメニューからページのグローバル幅を設定することもできます。「 ワイド 」を選択すると、テーブル、カード、コードブロックなどの フル幅

オプションに対応するブロックが自動的に広がり、ページ公開時により多くのスペースを確保します。ランディングページを目立たせるのに最適です！

可視性

公開されたドキュメントでどのページを表示／非表示にするか、またそのページを公開ドキュメント内の検索に含めるか、検索エンジンにインデックスさせるかを決めることができます。 サイトの目次からページまたはページ群を非表示にするには、ページの アクションメニュー を開き、.

「ページを非表示」

を切り替えます。

---
非表示にした場合、Git Syncを使用しているとMarkdownファイルのフロントマターに以下が表示されます：
---

page.md

hidden: true メタデータ（SEO） 「 ページオプション → メタデータ).

• 」を使って、類似ページ間の関係（例えば：ドキュメントのバージョンやコンテンツのバリアント

• ）を検索エンジンがどのように理解するかを制御します。正準URL

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

別のURL（Alternate URLs） 1.0 ：別のバリアントで同じコンテンツを示す他のURL。例えば別のバージョンや言語です。検索エンジンが重複として扱うのではなくバリアントとしてグループ化するのに役立ちます。 2.0両方のフィールドは別のGitBookページを選択する（推奨）か、外部URLを入力することをサポートします。

バージョン管理されたドキュメントの一般的なパターンとして、古いページを最新の同等ページに対して正準に設定し（例えば、

→ ）、その後最新ページに古いバージョンを代替として列挙する方法があります。 ページカバー

• ドキュメントの各ページにページカバーを設定することもできます。

  「ページカバー」 オプションをクリックすると、デフォルトのカバーが即座に追加されます。ここから次のことができます：カバー画像を変更する

• ページカバーにホバーして

  「カバーを変更」 サイトの目次からページまたはページ群を非表示にするには、ページの をクリックし、画像を選択またはアップロードします。現在のページカバーの表示方法に基づくと、1990×480ピクセルが理想的なサイズです。 カバー画像の位置を調整するページカバーにホバーして を開きます。.

• 「位置を調整」 「カバーを変更」 サイトの目次からページまたはページ群を非表示にするには、ページの をクリックし、画像を希望の位置にドラッグしてから 「保存」.

• をクリックします。 カバー画像を削除する サイトの目次からページまたはページ群を非表示にするには、ページの 、その後「削除」をクリックします。