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

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

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

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

目次

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

circle-info

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

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

新しいページを作成

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

A GitBook screenshot showing an empty page listed in the table of contents
GitBook の空のページ。左側の目次にリストされているのが確認できます。

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

circle-exclamation

がないためにページを編集できない可能性があります。

コンテンツの整理

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

ページ

ページにはタイトル、オプションの説明、および任意の種類のコンテンツを書いたり追加したりできる領域があります。 目次でページを別のページの下にドラッグ&ドロップすることで、ページを入れ子にすることができます。これにより.

サブページ

circle-info

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

ヒント: ページのネストに制限はありませんが、複雑なナビゲーションを避けるために3階層以上のネストは避けることをお勧めします。ページのタイトルを変更すると、ページのスラッグ(URLの末尾部分、例:

/hello-world )も変更されます — ただし以前に手動でスラッグを設定している場合はその限りではありません。 The Actions menu icon in GitBook ページのタイトル、リンクタイトル、スラッグはいつでもページの アクションメニュー.

を開いて

「タイトルとスラッグを編集」

を選択することで変更できます。 )も変更されます — ただし以前に手動でスラッグを設定している場合はその限りではありません。 The Actions menu icon in GitBook ページリンクタイトル アクションメニューページに長めでSEOに適したタイトルを持たせつつ、ナビゲーションやリンク用に短いタイトルを使いたい場合は、リンクタイトルを任意で定義できます。 ページの を開いて

を選択します。 「 ページ編集 」ダイアログで、そのページのリンクタイトルを有効にして定義するオプションが見つかります。

circle-info

ファイルのページリンクに設定されます: # 目次

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

注:

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

ページリンクタイトルは任意です — 手動で追加しない場合は、デフォルトでページの通常のタイトルが使用されます。 「新規追加...」 > ページグループ ページグループを使うと、関連するコンテンツをカバーするセクションとしてページをまとめることができます。

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

ページグループは目次の )も変更されます — ただし以前に手動でスラッグを設定している場合はその限りではありません。 最上位 The Actions menu icon in GitBook にのみ配置できます。ページグループの中にさらにページグループを入れることはできません。 ページグループのタイトルとスラッグを変更するには、目次のグループタイトル横にある.

をクリックして

「名前を変更」 「新規追加...」 > を選択してください。 ページグループを使うと、関連するコンテンツをカバーするセクションとしてページをまとめることができます。

外部リンク

目次に外部リンクを追加することもできます。クリックするとリンク先のコンテンツに直接移動します。

目次の下部で 「外部リンク」 をクリックして新しい外部リンクを作成します。

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

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

「アイコンを追加」

ボタン、またはタイトル左の絵文字ボタンをクリックしてください。 ページのアイコンと絵文字 The Page options menu icon in GitBook ページオプション

目次をざっと見る読者の視認性を高めるために、個々のページにオプションのアイコンや絵文字を追加できます。アイコンや絵文字は目次とページ上部のタイトル横に表示されます。 ページのアイコンと絵文字 メニューでは、スペース内の選択したページの見た目や表示方法をカスタマイズしたり、可視性を制御したりできます。 レイアウト ページタイトルにカーソルを合わせることで

メニューを開いたりページのカバーを変更したりできます。ボタンはページタイトルのすぐ上に表示されます。

  • サイドパネルでは、公開された

  • コンテンツ

  • 目次

  • を訪れる人に対して各ページがどのように表示されるかを選択できます。選べるレイアウトプリセットは3つあり、カスタムレイアウトを作成することもできます。

  • 各レイアウトプリセットは次の各パーツの表示をオンまたはオフに切り替えます:

  • ページタイトル

  • ページの説明

ページアウトライン 前後のリンク ページメタデータ ページの説明タグ ページには ライブラリ ページの説明.

から1つ以上のタグを付けることができます。ページヘッダーに表示するには 「ページにタグを表示」 をオンにしてください。ページの主要タグを1つ選ぶこともできます。GitBook は目次のページ横に主要タグを表示できます。詳細は をご覧ください。

このメニューからページのグローバル幅を設定することもできます。

「ワイド」

を選ぶと、テーブル、カード、コードブロックなど「 全幅 The Actions menu icon in GitBook 」オプションをサポートするブロックが自動的に広がり、ページ公開時により広いスペースを取れるようになります。目を引くランディングページの作成に最適です! 可視性.

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

を開き、

「ページを非表示」 を切り替えてください。 非表示にすると、Git Sync を使用する際にマークダウンファイルのフロントマターに次が表示されます: page.md).

  • hidden: trueメタデータ(SEO)

  • ページオプション → メタデータ

」を使って、類似ページ間の関係(例:ドキュメントのバージョンや

circle-info

コンテンツのバリアント 1.0 ページメタデータ 2.0)を検索エンジンにどう理解させるかを制御できます。

正規 URL

:このページの推奨(権威ある)URL。検索エンジンはこれを「真のソース」として扱います。複数のURLが同じコンテンツを示す場合に使用してください。 代替 URL The Page cover icon in GitBook :別のバリアントで同じコンテンツを指す他のURL。例えば別のバージョンや言語など。これにより検索エンジンは重複として扱うのではなく、バリアントをグループ化できます。

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

    バージョン管理されたドキュメントでよくあるパターンは、古いページを最新の同等ページに対して正規(canonical)に設定し(例えば、 )、最新ページに古いバージョンを代替として列挙することです。ページカバー

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

    ページカバー 全幅 The Actions menu icon in GitBook」オプションをクリックするとデフォルトのカバーがすぐに追加されます。ここから次のことができます: カバー画像を変更するページカバーにカーソルを合わせて 「カバーを変更」.

  • をクリックし、画像を選択またはアップロードします。現在の表示方法に基づくと、1990x480 ピクセルが理想的なサイズです。 ページカバー 全幅 The Actions menu icon in GitBookカバー画像の位置を調整する ページカバーにカーソルを合わせて.

  • を開きます。次に 「再配置」 全幅 The Actions menu icon in GitBookをクリックし、画像を希望の位置にドラッグしてから、

最終更新

役に立ちましたか?