はじめに

このガイドでは、Xingluo をローカル開発および本番ビルド用にゼロから始める方法を説明します。

要件

ヒント：Node バージョンの管理には fnm または nvm を使用してください。

インストール

リポジトリをクローンした後、依存関係をインストールします：

bash
pnpm install

依存関係がインストールされると、references/ 配下の参照プロジェクトは TypeScript のコンパイルとビルドから自動的に除外されます（tsconfig.json の exclude を参照）。

ローカル開発

開発サーバーを起動します（デフォルトは http://localhost:4321/）：

bash
pnpm dev

開発モードでは：

• 下書きと予約投稿は すべて表示 されます（プレビュー用）。本番ビルド時にのみフィルタリングされます
• コンテンツコレクションの変更はホットリロードをトリガーします
• クライアント側の動作（テーマ切り替え、View Transitions など）は本番と一致します

型の同期

コンテンツコレクションのスキーマや型を変更した後は、.astro/types.d.ts を更新するために同期を実行します：

bash
pnpm sync

ビルド

本番ビルドは 3 つのステップで構成されます（package.json の build スクリプトを参照）：

bash
pnpm build

1. astro check：TypeScript および Astro テンプレートの型チェック。エラーがあるとビルドは中断されます
2. astro build：サイト全体を dist/ に静的に生成します（動的 OG 画像、RSS、サイトマップ、robots.txt を含む）
3. node scripts/generateSearchIndex.mjs：dist/ をスキャンして全文検索インデックスを dist/search/ に生成します

注：検索インデックスはビルド後に Node スクリプトによって生成されます。

ビルドのプレビュー

dist/ 内のビルド出力をローカルでプレビューします：

bash
pnpm preview

コード品質

次のステップ

• 設定ガイド を読んでサイト情報と機能トグルをカスタマイズする
• コンテンツ作成 を読んで執筆を始める
• デプロイ を読んでサイトを公開する