コンテンツにスキップ

docs ディレクトリの配置自由度

Starlight の docsLoader() は src/content/docs/ から Markdown・MDX を 読み込みます。設定可能な glob loader と異なり、標準コンテンツルートは固定です。 独自の Astro collection や src/pages/ なら配置を自由にできますが、Starlight の layout・navigation との統合はプロジェクト側の責任になります。

README を index とみなす標準規約は文書化されておらず、このサンプルでも使いません。 Astro のファイルベース routing では index.md / index.mdx がディレクトリ ルートとなり、README.md は別の readme/ ページです。両言語で明示的な index.mdx を用意しています。