コンテンツにスキップ

サイト内検索(ローカル)

Starlight は標準で Pagefind を有効にします。 astro build 中に生成済み静的 HTML を索引化し、検索 bundle を dist/pagefind/ へ出力します。ヘッダーの検索 UI がローカル索引をブラウザで 読み込むため、外部サービス、API キー、バックエンドは不要です。

検索は本番ビルドの機能です。開発サーバーには新しい Pagefind 索引がないため、 結果は bun run build && bun run preview で確認します。

ページ frontmatter の pagefind: false や data-pagefind-ignore 属性で索引対象を 除外できます。