このサイトの構築方法の記録

公開:

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 をそのまま置きます。