Astroで軽量な静的サイトを構築する(テスト投稿)

この記事でできること

Astroプロジェクトを静的HTMLとしてビルドし，生成物をローカルで確認できる

WSL2 Ubuntuのターミナルを操作できること

Node.jsとnpm

npm install

npm run dev

表示されたローカルURLをブラウザで開く。Markdownを保存すると，変更がページへ反映される。

npm run build

このサイトでは型検査，Astroの静的ビルド，Pagefindの検索インデックス生成が順番に実行される。

処理が成功するとdist/にHTMLが生成され，dist/pagefind/に日本語を検索できるインデックスが作られる。

原因

使用中のNode.jsがAstroの対応バージョンより古い状態である

解決方法

Node.js 24へ切り替え，node -vで有効なバージョンを確認してから再実行。

生成物だけを消したい場合はdist/を削除。Markdownの原稿には影響しない。

開発サーバーは執筆確認用。公開前には必ずnpm run buildを実行。