ページ

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

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

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

目次

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

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

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

新しいページを作成する

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

A GitBook screenshot showing an empty page listed in the table of contents
GitBook の空のページ。左側の目次に一覧表示されているのが見えます。

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

コンテンツの整理

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

ページ

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

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

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

ヒント: ページの入れ子に制限はありませんが、ナビゲーションが複雑になりすぎないように、3レベル以上の入れ子は避けることをお勧めします。

ページのタイトルを変更すると、ページのスラッグ(URLの末尾の部分、例: /hello-world)も変更されます — ただし以前に手動でスラッグを設定している場合は例外です。

ページのタイトル、リンク用タイトル、スラッグはいつでもページの 「アクションメニュー」 The Actions menu icon in GitBook を開き、 「タイトルとスラッグを編集」.

から変更できます。

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

ページの 「アクションメニュー」 The Actions menu icon in GitBook を開き 「タイトルとスラッグを編集」を開いてください。の中の 「ページを編集」 ダイアログで、そのページのリンクタイトルを有効にして定義するオプションが見つかります。

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

# 目次

# Summary

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

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

ページグループ

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

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

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

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

を選択します。

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

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

ページアイコンと絵文字

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

かによって異なります。

で、 かによって異なります。 ボタン、またはタイトルの左にある絵文字ボタンをクリックします。

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

を開くには、 かによって異なります。 The Page options menu icon in GitBook レイアウト

で、 かによって異なります。 メニューからページタイトルにカーソルを合わせてページのカバーを変更できます。ボタンはページタイトルのすぐ上に表示されます。 公開されている サイドパネルでは、訪問者に対して各ページがどのように表示されるかを選択できます。レイアウトのプリセットが3つ用意されており、カスタムレイアウトを作成することも可能です。

各レイアウトプリセットはページの以下の要素のオン/オフを切り替えます:

  • ページタイトル

  • ページの説明

  • 目次

  • ページアウトライン

  • 前/次へのリンク

  • ページのメタデータ

このメニューからページのグローバル幅も設定できます。「 ワイド 」を選択すると、テーブル、カード、コードブロックなど 全幅 オプションに対応したブロックが自動的に幅広になり、公開時によりスペースが与えられます。ランディングページを魅力的に作るのに最適です!

表示設定

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

サイトの目次からページやページ群を非表示にするには、ページの 操作メニュー The Actions menu icon in GitBook を開いて 「ページを非表示」.

を切り替えます。非表示にすると、Git Sync を使用している場合、マークダウンファイルのフロントマターに以下が表示されます:

page.md
---
hidden: true
---

メタデータ(SEO)

次を使用します: ページオプション → メタデータ で、類似ページ間の関係(例:ドキュメントのバージョンや コンテンツバリアント).

  • 正規の URL(Canonical URL):このページの推奨(権威ある)URL。

  • 代替 URL(Alternate URLs):異なるバリアントで同じコンテンツを表す他のページ。

両方のフィールドは、別の GitBook ページを選択する(推奨)か、外部 URL を入力することができます。

バージョン管理されたドキュメントの一般的なパターンとして、古いページを最新の同等ページの正規ページに設定し(例: 1.02.0)、次に最新ページに古いバージョンを代替として列挙する方法があります。

ページカバー

各ドキュメントページにページカバーを設定することもできます。をクリックすると、 「ページカバー」 The Page cover icon in GitBook オプションでデフォルトのカバーが即座に追加されます。ここから次のことができます:

  • カバー画像を変更する

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

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

    ページカバーにカーソルを合わせて 操作メニュー The Actions menu icon in GitBookを開きます。をクリックして 「位置を再調整」を選び、画像をドラッグして希望の位置に調整し、クリックします。 保存.

  • カバー画像を削除する ページカバーにカーソルを合わせて 操作メニュー The Actions menu icon in GitBookで、次に 削除.

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

最終更新

役に立ちましたか?