ローカル開発とリポジトリ構成¶
コマンドはリポジトリのルートで実行します。
起動¶
Node.js 24系(>=24.0.0 <25)を使用します。CIも24系で実行します。開発依存にもNode.js 24.22.2を含めており、依存関係のインストール後は npm run 内でこのバージョンを使用します。
npm ci
npm run dev
ローカルURLは http://127.0.0.1:4321/ です。
npm run check
npm run build
npm run preview
dist/ に出力したファイル一式を静的ホスティングで配信できます。ビルド時・閲覧時にWordPressへ接続しません。
ディレクトリ構成¶
.
├── src/
│ ├── components/ # ロゴ、テーマ切替、GA、お知らせ一覧
│ ├── content/pages/ # 固定ページの本文HTML
│ ├── data/
│ │ ├── pages.json # 固定ページのURL・タイトル・本文ファイルの対応
│ │ ├── pages.ts # メタデータと本文HTMLを結合するローダー
│ │ ├── news.json # お知らせの記事データ
│ │ ├── navigation.ts # 会社情報・商品情報・採用情報のナビゲーション
│ │ └── assets.json # 移行元画像URLと配信パスの対応
│ ├── layouts/Layout.astro # 共通head・ヘッダー・フッター
│ ├── pages/ # 公開URLに対応するAstroページ・静的データ生成
│ └── styles/ # 共通・ページ別のCSS
├── public/
│ ├── assets/original/ # 元画像
│ ├── assets/webp/ # 最適化スクリプトで生成する配信用画像
│ └── hp_pdf/ # 製品PDF
├── backend/contact-form/ # お問い合わせ送信API(サイトとは別に配置)
├── infra/contact-form/ # SAM定義・自前版の構築設定例
├── scripts/ # 画像最適化・表示検証・移行の補助スクリプト
├── source-archive/ # 移行元のHTML断片・RSS
├── original-home.html # 移行元トップページのHTML
├── astro.config.mjs # 本番URL・静的出力・Tailwindの設定
├── tsconfig.json # Astroのstrict設定を継承するTypeScript設定
├── package.json # 依存関係・実行コマンド・Node.js要件
├── package-lock.json # インストールする依存バージョンの固定
├── .gitlab-ci.yml # GitLab CIの自動検証と本番デプロイ
├── docs/ # 開発・運用・デザインのドキュメント
├── dist/ # 本番用ビルドの出力(Git管理対象外)
├── dist-preview/ # 確認環境用ビルドの出力(Git管理対象外)
└── qa-artifacts/ # 検証結果・スクリーンショット(Git管理対象外)
固定ページは現在26件(トップページを含む)、お知らせは12件です。固定ページの本文は src/content/pages/、URLなどのメタデータは src/data/pages.json で分けて管理し、src/data/pages.ts で結合します。
ページ生成の対応¶
| 公開URL | 実装・データ |
|---|---|
/ |
src/pages/index.astro。ご挨拶は home.html、お知らせは news.json から取得 |
| 会社情報・商品情報・採用情報などの固定ページ | src/pages/[...path].astro が pages.ts から生成(トップページを除く) |
/news/・/updates/・/careers/ |
各ディレクトリの index.astro と共通の NewsListing.astro |
/news/<slug>/ |
src/pages/news/[slug].astro が news.json から生成 |
/<slug>/ |
src/pages/[legacy].astro が生成する旧記事URLの互換ページ |
/search/ |
src/pages/search/index.astro |
/search-index.json |
src/pages/search-index.json.ts が固定ページ・お知らせの検索データを生成 |
/sitemap.xml |
src/pages/sitemap.xml.ts が公開URL一覧を生成 |
/404.html |
src/pages/404.astro |
.ts の検索データ・サイトマップもビルド時に静的ファイルとして出力します。公開サーバーでNode.jsを常駐させる必要はありません。public/ のファイルは、ディレクトリ構成を保って出力先へコピーされます。
本番・確認用ビルドの違い¶
npm run build の本番成果物は、通常ページのインデックス登録を禁止しません。404ページは noindex を維持します。npm run dev は noindex, nofollow を出力します。外部確認環境などでインデックス登録を防ぎたい場合は npm run build:preview を使い、dist-preview/ の成果物を配置してください。通常の npm run preview は本番成果物 dist/ のローカル確認なので、本番と同じrobots設定です。
sitemap.xml のURLとGoogleアナリティクスの計測対象オリジンには、astro.config.mjs の site(https://www.tectas.co.jp)を使用します。本番URLを変更する場合は、この設定を更新して再ビルドしてください。