サイト内検索(ローカル)
Nextra 4 は、完全にクライアントサイドで動作しバックエンドを必要としないローカル 検索エンジン Pagefind を使用する。外部の検索サービス・ APIキー・ホスト型インデックスは不要で、Pagefind は静的にレンダリングされた HTML出力をクロールし、サイトと一緒に配信される静的な検索インデックスを生成する。
そのインデックスは、Bun で動かす Next.js ビルドの後に自動実行される本プロジェクトの
postbuild スクリプト(pagefind --site out --output-subdir _pagefind)によって
生成される。インデックスは静的エクスポートから作られるため、検索は本番ビルドに
対してのみ機能する。リポジトリールートで mise run build && mise run serve を
実行すると検索ボックスが動作するが、bun run dev の開発サーバーではまだ
インデックスが生成されていないため結果が表示されない。
検索ボックスはナビバーにあり、どのページからもアクセスできる。キーボード ショートカット(通常 Cmd/Ctrl+K)でも素早く開ける。
Last updated on