このサイトの構築方法の記録
公開:
waneco.jp とこのブログ(blog.waneco.jp)を作った方法を記録しておきます。
方針
- 共有のレンタルサーバーに置くので、出力は 静的な HTML だけ にする。サーバーで動く仕組み(SSR・API・データベース)は使わない
- サブドメインごとにサイトを分けつつ、見た目や多言語の仕組みは共通にする
- 依存は少なく、軽く。外部の解析や広告のスクリプト、Web フォントの読み込みは入れない
構成
Astro を静的出力(output: 'static')で使い、npm workspaces で 1 つのリポジトリにまとめています。
packages/
shared/ 共通の部品(レイアウト・ヘッダー・フッター・多言語の辞書・サイト一覧)
sites/
www/ waneco.jp
blog/ blog.waneco.jp
scripts/
check.mjs ビルド結果の確認
dist/
www/ ← waneco.jp に置くもの
blog/ ← blog.waneco.jp に置くもの
サブドメインを足すときは sites/ にフォルダを 1 つ足し、共通のサイト一覧に 1 件足すだけで済むようにしてあります。各サイトの astro.config.mjs は共通の設定を呼ぶだけです。
import { defineConfig } from 'astro/config';
import { siteConfig } from '@waneco/shared/config.ts';
export default defineConfig(siteConfig('blog'));
多言語
日本語を既定にして / に置き、英語は /en/ 以下に置きます。ページ本体は言語を引数に取る部品にして、src/pages/ と src/pages/en/ には薄い入口だけを置きました。各ページには相手の言語へのリンクと hreflang を付けます。
記事は src/content/posts/ja/ と src/content/posts/en/ に Markdown で書き、同じファイル名の記事を日英の対として扱います。
ビルドと確認
npm ci
npm run build # dist/www と dist/blog ができる
npm run check # リンク切れ・hreflang・lang 属性・公開してはいけない語を見る
npm run check は自前の小さなスクリプトで、ビルドした HTML を全部読み、サイトをまたぐリンクも含めてリンク先が dist/ にあるかを確かめます。
置き方
dist/ の中のフォルダを、それぞれのサブドメインの公開フォルダへ FTP でアップロードするだけです。ビルドは手元で行い、できた HTML をそのまま置きます。