カテゴリをフラットなリストにする

2026年1月28日

すべての子ページが同じ小さなコレクションに属するなら、カテゴリインデックスをシンプルに保てます。

構造をコンテンツに合わせる

すべてのカテゴリにフォルダの階層が必要なわけではありません。Getting Startedは独立したページが並ぶ短い手順なので、インデックスを番号付きリストとして表示すると見つけやすくなります。ファイルは同じ場所に置いたまま、sidebar_position の値で順序を表現でき、人工的な階層を増やす必要がありません。

ナビゲーションガイドでは、ディレクトリをサイドバー構造のソースにする方針を説明しています。note trayもこの原則に沿っています。ディレクトリがカテゴリになり、カテゴリの宣言によって直下の子ページをフラットに表示できます。

役に立つ制約

リストをフラットに保つと、執筆の作業も明確になります。それぞれのページに役立つタイトル、意図した順位、そしてコンパクトなインデックスでも機能する説明文が必要です。話題が混ざり始めたり、一覧を素早く確認できなくなったりしたら、装飾を増やすのではなく新しいカテゴリを作る合図です。