JavaScriptを送らないサイト — AstroとSSG

AstroとSSG。静的なWebページの書類と小さな動的部品、配信の矢印。

※本記事はアフィリエイト広告(PR)を含みます。

前々回で、curl を打って空のHTMLを見ました。その次の回で、dist/ を GitHub Pages に出して、世界に公開しました。

前回: Svelteは仮想DOMを使わない — React以外の現在地

作業場所は VMの中(Ubuntu)、確認はホストの Windows のブラウザです。

これまで作ったものは、1つも消しません。 ~/react-demo/ も ~/next-demo/ も残したまま、~/astro-blog/ を新しく作ります。比べるために残します。

このサイト(obmes.com)を移す話ではありません。 最後に「なぜ移さないか」を書きます。

そこまでは良かったのですが、1つ引っかかったままのことがあります。

~/react-demo/ のビルド結果を、もう一度見てください。

bash
$ ls ~/react-demo/dist/assets/

数百KBの JavaScript ファイルが入っています。 ビルドツールの回でやったとおり、React 本体と、自分が書いたコンポーネントが全部まとめられたものです。

これは、タスクを追加したりチェックを付けたりする画面なので、当然です。

問題は、そうではない画面です。

「この記事を読むだけのページ」に、React は要るのか。

いま読んでいるこのページには、押すところがありません。 文字とリンクと画像だけです。それでも React で作れば、React 本体(数十KB)と、自分のコンポーネント全部が、読者のスマホに送られます。

送られて、ダウンロードされて、パースされて、実行されて、そして——何も起きません。 押すところが無いからです。

JavaScript を全部送っているのに、動くところが1つも無い。 これが、いま一番よくある無駄です。

前々回の最後に、こう書きました。

一番強いのは、たいてい SSG。内容が読者ごとに変わらないページなら、SSRを選ぶ理由はほとんど無い。

今日は、その SSG を実際に使う道具の回です。 そして、「使わない判断」も同じだけの分量で書きます。

対象レベル: 中級 / 区分: 必修

目次

この記事でわかること

  • HTMLを作るやり方は3つしかないこと(サーバーが毎回作る / あらかじめ全部作っておく / ブラウザで作る)。WordPress・SSG・SPA は、この3つに1つずつ当てはまる
  • SSG の出力には、JavaScript が1バイトも入らないことがあること。「Reactを使ったのにJSが0」は誤植ではなく、Astro の既定の動作
  • アイランドアーキテクチャは「JSが0の状態が既定」だから成立すること。必要なところにだけ足すという順番であって、必要ないところから削るのではない
  • Eleventy は JavaScript を1行も書かなくてよいこと。設定ファイルすら要らない。その代わり、HTMLの外枠も自分で書く
  • VuePress と Docusaurus は「ドキュメント専用」だということ。検索とサイドバーが最初から付いてくる代わりに、見た目の自由度を捨てている
  • SSG が向かないものが、はっきりあること。ログインが要る / 内容が毎分変わる / 記事が数万本。ビルド時間には天井がある
  • このサイトが WordPress のままなのは、技術的に優れているからではないこと。書くことに集中したいからであり、移行のコストが見合わないから

この記事でやること

  1. 3つのやり方を表で並べる(サーバーが毎回作る / あらかじめ作る / ブラウザで作る)。このサイトがどれかも確定させる
  2. ~/astro-blog/ を作り、Markdown を置くだけで記事ページが増えることを見る
  3. ビルドして dist/ を作り、grep で <script を数える。 0 であることを目で見る
  4. React コンポーネントを1つだけ client:load で埋め、そのページにだけ JS が載ることを、同じ grep で確かめる
  5. ~/eleventy-demo/ を作り、設定ファイル0個で Markdown をHTMLにする
  6. ビルド時間を実測し、記事が1万本あったらどうなるかを計算する

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
SSGStatic Site Generation。ビルドのときに全ページ分のHTMLを作っておき、あとはファイルを配るだけ。前々回に出ました
静的サイトジェネレータSSG をやるための道具そのもの。Astro・Eleventy・Hugo など。SSG(やり方)と同じ略語で呼ばれるので紛らわしい
Astro中身を読ませるサイト向けの静的サイトジェネレータ。 既定でJSを送らないのが最大の特徴
Eleventy(11ty)JavaScript製だが、書く側はJSを1行も書かなくてよい静的サイトジェネレータ。設定ファイルすら省略できる
アイランドアーキテクチャページの大半は動かないHTMLにしておき、動かしたい部分だけを「島」として切り出す作り方
client:loadAstro で「このコンポーネントだけ、ブラウザでも動かす」と指示する書き方。これを書かない限りJSは送られない
フロントマターMarkdown ファイルの先頭に --- で挟んで書く、タイトルや日付などの付随情報。この記事の元ファイルにも付いています
テンプレートエンジン穴あきのHTMLに、値を差し込んでページを作る仕組み。Nunjucks・Liquid など
ヘッドレスCMS管理画面と記事の保管だけをやり、見た目は持たないCMS。 記事は API(JSON)で取り出す
インクリメンタルビルド前回から変わったページだけを作り直すこと。全ページ作り直すと遅すぎる規模で必要になる

① やり方は3つしかない

道具の名前を並べる前に、地図を作ります。

「読者にHTMLが届くまでに、誰がそれを組み立てたか」——見るのはここだけです。

サーバーが毎回作るあらかじめ全部作っておくブラウザで作る
呼び方SSRSSGCSR / SPA
代表例WordPress・Next.js(動的)Astro・Eleventy・HugoVite + React(~/react-demo/)
HTMLが作られる瞬間読者が開いた瞬間書き手がビルドした瞬間読者のブラウザにJSが届いた後
必要なもの動き続けるサーバー + DBファイルの置き場所だけファイルの置き場所だけ
curl に返るもの中身入りのHTML中身入りのHTML空(<div id="root"> だけ)
記事を1文字直したらすぐ反映されるビルドし直すまで反映されないすぐ反映される(データを外から取る場合)
1万人が読んだら1万回、同じHTMLを作り直す1回作ったものを1万回配るファイルを1万回配る
サーバーが落ちたらサイトが落ちる落ちるものが無い落ちるものが無い

このサイト(obmes.com)は、一番左です。 WordPress で公開した回でやったとおり、PHPが動いて、DBから記事を引いて、その場でHTMLを作っています。

~/react-demo/ は、一番右です。

今日やるのは、真ん中です。

真ん中が強い理由は、1つだけ

「読者ごとに変わらないものを、読者が来るたびに作り直すのは無駄」。

これだけです。 Redis の回でやった「結果を取っておいて2回目から使い回す」と、キャッシュの回でやった話が、設計の側に来ただけです。

そして SSG は、その極端な形です。 「2回目から使い回す」ではなく、「1回目が来る前に、全部作り終えておく」。

ただし、真ん中は右の弱点を引き継がない

ここが、今日の本題につながります。

~/react-demo/ を GitHub Pages に出したとき(静的ホスティングの回)、配ったのは静的ファイルでした。 置き場所は SSG と同じです。

でも、中身はまるで違いました。

~/react-demo/ の dist/これから作る SSG の dist/
index.html の中身空(<div id="root">)記事の本文がそのまま入っている
JavaScriptReact 本体 + 全コンポーネント今日の結果を、この後で見ます

「静的に置ける」と「JSを送らない」は、まったく別の話です。 前者だけ満たして後者を満たしていないのが、いまの ~/react-demo/ です。


② Astro でブログを1本作る

言葉はここまでです。実物を作ります。

作る

VMの中です。

bash
$ cd ~
$ npm create astro@latest astro-blog -- --template minimal --install --no-git --skip-houston

フラグを付けているのは、対話の質問を減らすためです。何か聞かれたら、Enter(既定値)で構いません。

フラグ意味
--template minimal中身が空のテンプレート。 ブログ用のテンプレートもありますが、最初から完成品だと、何が起きているか分かりません
--installnpm install まで済ませる(npm の回)
--no-gitこの場では Git リポジトリを作らない(Git の回でやったものと混ざるのを避けます)
--skip-houston起動時のアニメーションを飛ばす

数分かかります。

何ができたか

bash
$ ls ~/astro-blog/src ~/astro-blog/src/pages
~/astro-blog/src:
pages

~/astro-blog/src/pages:
index.astro

src/pages/ だけです。

src/pages/ の中のファイル構成が、そのままURLになります。 src/pages/index.astro → /、src/pages/about.astro → /about。

Next.js の回で app/ がURLになったのと、同じ考え方です。というより、この形のほうが先にありました。

動かす

Astro の開発サーバーは 4321番を使います。3000番(API)とも 4000番(Next.js)ともぶつかりません。

bash
$ sudo ufw allow 4321/tcp
$ cd ~/astro-blog
$ npm run dev -- --host 0.0.0.0 --port 4321

-- を忘れないでください。 これが無いと、--host を npm 自身への指示だと解釈されます(前々回と同じ落とし穴です)。

ホストのブラウザで http://192.168.226.50:4321/ を開いてください(IPは自分の値に置き換えてください。分からなければ VMの中で ip a。ネットワークの回)。

[スクリーンショット: 01_astro_起動画面.png] ホストのブラウザで http://192.168.226.50:4321/ を開き、Astro の最小テンプレートのページが表示されている画面を撮ってください。

Markdown を置くだけで、記事になる

ここが、この道具の一番の売りです。

もう1枚ターミナルを開いて(開発サーバーは動かしたまま)、フォルダとファイルを作ります。

bash
$ mkdir -p ~/astro-blog/src/pages/posts
$ nano ~/astro-blog/src/pages/posts/hello.md
---
title: 最初の記事
pubDate: 2026-09-13
---

# 最初の記事

これは Markdown で書いた記事です。**太字**も書けます。

- 箇条書きも
- そのまま出ます

保存したら、ブラウザで http://192.168.226.50:4321/posts/hello を開いてください。

記事になっています。

.astro ファイルを1文字も書いていません。 src/pages/ に .md を置いた——それだけで、URLが1本増えました。

もう1本作って、確かめてください。

bash
$ nano ~/astro-blog/src/pages/posts/second.md
---
title: 2本目の記事
pubDate: 2026-09-14
---

# 2本目の記事

ファイルを増やすと、ページが増えます。

http://192.168.226.50:4321/posts/second が開けば成功です。

見た目の枠を、1回だけ書く

いま開いたページは、素のHTMLがそのまま出ているだけです。HTMLの回でやった状態と同じで、<title> すら入っていません。

枠を1枚作ります。

bash
$ mkdir -p ~/astro-blog/src/layouts
$ nano ~/astro-blog/src/layouts/Post.astro
---
const { frontmatter } = Astro.props;
---

<html lang="ja">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>{frontmatter.title}</title>
  </head>
  <body>
    <header><a href="/">← 記事一覧</a></header>
    <article>
      <slot />
    </article>
    <footer>{frontmatter.pubDate}</footer>
  </body>
</html>

.astro ファイルは、上下2段に分かれています。

場所何を書くか
上(--- で挟んだ部分)ビルドのときにだけ実行される JavaScript。 ブラウザには送られません
下HTML。 { } の中に、上で作った値を差し込めます

<slot /> が、Markdown の本文が入る穴です。

この枠を使うように、Markdown 側に1行足します。

bash
$ nano ~/astro-blog/src/pages/posts/hello.md
---
layout: ../../layouts/Post.astro
title: 最初の記事
pubDate: 2026-09-13
---

second.md にも、同じ layout: の行を足してください。 パスは同じで構いません。

../../layouts/ は、src/pages/posts/ から見た相対パスです(Linuxのディレクトリの回の .. と同じものです)。

ブラウザを更新すると、タブのタイトルが「最初の記事」に変わっています。

記事一覧を作る

src/pages/index.astro を、まるごと書き換えます。

bash
$ nano ~/astro-blog/src/pages/index.astro
---
const posts = Object.values(import.meta.glob("./posts/*.md", { eager: true }));
---

<html lang="ja">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>記事一覧</title>
  </head>
  <body>
    <h1>記事一覧</h1>
    <ul>
      {posts.map((post) => (
        <li>
          <a href={post.url}>{post.frontmatter.title}</a>
          <span>({post.frontmatter.pubDate})</span>
        </li>
      ))}
    </ul>
  </body>
</html>

map して <li> を並べる形は、コンポーネントの回で書いたものと同じです。

違うのは、import.meta.glob の1行です。

「posts/ フォルダの .md を全部読み込め」という命令です。 これはビルドのときに実行されます。 ファイルを増やせば、一覧が勝手に増えます。

/ を開いて、2本のリンクが並んでいれば成功です。 third.md を作って、一覧に3本目が出ることを確かめてください。


③ dist/ に <script> が1個も無い

ここが、この記事で一番見てほしいところです。

Ctrl + C で開発サーバーを止めてから、本番用にビルドします。

bash
$ cd ~/astro-blog
$ npm run build
building client (vite)
✓ built in ...
generating static routes
▶ /index.html
▶ /posts/hello/index.html
▶ /posts/second/index.html
✓ Completed in ...

表示は違って構いません。 見てほしいのは、「3枚のHTMLファイルが書き出された」という部分です。

何が出来たか

bash
$ find ~/astro-blog/dist -type f
/home/user/astro-blog/dist/index.html
/home/user/astro-blog/dist/posts/hello/index.html
/home/user/astro-blog/dist/posts/second/index.html
/home/user/astro-blog/dist/favicon.svg

HTMLと、アイコンだけです。

ビルドツールの回で ~/react-demo/dist/ を見たときとは、まるで違います。 あちらには assets/ の下に JavaScript がありました。

JavaScript ファイルを数える

推測しないで数えます。

bash
$ find ~/astro-blog/dist -name "*.js" | wc -l
0

0本です。

~/react-demo/ 側と比べてください。

bash
$ find ~/react-demo/dist -name "*.js" | wc -l

0 ではない数が返ります(dist/ を消してしまっていたら、cd ~/react-demo && npm run build で作り直せます)。

<script を数える

ファイルが無いだけでなく、HTMLの中にも書かれていないことを確かめます。

bash
$ grep -rc "<script" --include="*.html" ~/astro-blog/dist/
/home/user/astro-blog/dist/index.html:0
/home/user/astro-blog/dist/posts/hello/index.html:0
/home/user/astro-blog/dist/posts/second/index.html:0

全ページ 0 です。

grep -c "<script" dist/**/*.html と書きたくなりますが、これは効きません。 ** を「何階層でも」の意味で解釈してくれるのは一部の設定のときだけで、素の bash では1階層しか見ません。 grep -r に --include を渡すほうが確実です(grep の回)。

中身も見てください。

bash
$ cat ~/astro-blog/dist/posts/hello/index.html

記事の本文が、そのままHTMLとして入っています。

[スクリーンショット: 02_grep_scriptが0.png] grep -rc "<script" --include="*.html" ~/astro-blog/dist/ を実行して、全ファイルが :0 になっている画面を撮ってください。

これが何を意味するか

前々回で、SSR についてこう書きました。

SSRにしても、JavaScript は結局ブラウザに送られます。

Astro の既定では、送られません。

送られるもの読者のブラウザがやること
~/react-demo/(CSR)空のHTML + JS一式JSを落として、実行して、DOMを作る
~/next-demo/(SSR)中身入りHTML + JS一式表示はすぐ。そのあとJSを落として、ハイドレーション
~/astro-blog/(SSG)中身入りHTMLだけ表示する。以上

ハイドレーションが要らないのは、乗せるものが無いからです。 速さの理由は「最適化が上手いから」ではなく、「そもそも仕事をしていないから」です。

そして重要なのは、ここまでで React を1行も書いていないのに、 Astro はビルド時に JSX とほとんど同じ書き方(map と { })を使わせてくれた、という点です。


④ React を1つだけ埋める — アイランド

「JSが0」は気持ちがいいのですが、それだけでは何も押せません。

現実のブログには、押すものが1つくらいあります。 ダークモードの切り替え、目次の開閉、いいねボタン。

そこで、React コンポーネントを1つだけ埋めます。

React を足す

bash
$ cd ~/astro-blog
$ npx astro add react

「この2つのパッケージを入れて、設定ファイルをこう書き換えるが、いいか」と聞かれます。 y で進めてください。

何が変わったか、必ず見てください。

bash
$ cat ~/astro-blog/astro.config.mjs
import { defineConfig } from 'astro/config';
import react from '@astrojs/react';

export default defineConfig({
  integrations: [react()],
});

コンポーネントを書く

bash
$ mkdir -p ~/astro-blog/src/components
$ nano ~/astro-blog/src/components/Counter.jsx
import { useState } from "react";

export default function Counter() {
  const [count, setCount] = useState(0);

  return (
    <button onClick={() => setCount(count + 1)}>
      押された回数: {count}
    </button>
  );
}

コンポーネントの回で書いた useState そのものです。Astro 用に書き換えたところは、1文字もありません。

一覧ページにだけ置く

src/pages/index.astro を編集します。

bash
$ nano ~/astro-blog/src/pages/index.astro

上の段に、読み込む1行を足します。

---
import Counter from "../components/Counter.jsx";
const posts = Object.values(import.meta.glob("./posts/*.md", { eager: true }));
---

下の段の <h1>記事一覧</h1> のすぐ下に、1行足します。

    <h1>記事一覧</h1>
    <Counter client:load />

client:load が、この記事の核心です。

書き方何が起きるか
<Counter />(指示なし)ビルド時に1回だけ実行され、結果のHTMLだけが出る。 ボタンは出るが、押しても増えない
<Counter client:load />HTMLも出る。加えて、このコンポーネント分のJSが送られ、ブラウザで動く

既定が「送らない」で、client:load が「送る」です。 順番が逆であることに注目してください。 削るのではなく、足すのです。 削り忘れは起きますが、足し忘れは動かないのですぐ分かります。

同じ grep を、もう一度打つ

bash
$ cd ~/astro-blog
$ npm run build
$ grep -rc "<script" --include="*.html" ~/astro-blog/dist/
/home/user/astro-blog/dist/index.html:1
/home/user/astro-blog/dist/posts/hello/index.html:0
/home/user/astro-blog/dist/posts/second/index.html:0

一覧ページだけが 1 になり、記事ページは 0 のままです。

JavaScript ファイルも増えています。

bash
$ find ~/astro-blog/dist -name "*.js" | wc -l

0 ではない数が返ります。

[スクリーンショット: 03_grep_islandだけscript.png] React を足した後の grep -rc "<script" --include="*.html" ~/astro-blog/dist/ の結果で、index.html:1 と posts/*/index.html:0 が並んでいる画面を撮ってください。

これがアイランドアーキテクチャです

言葉の意味が、ここで初めて分かります。

ページ全体は、動かないHTMLという「海」。 client:load を書いたところだけが、JSが動く「島」。

そして重要なのは、前提のほうです。

「JSが0の状態が既定」でなければ、島は作れません。 ③で 0 を確かめたのは、④のためです。

~/react-demo/ では、これはできません。 React アプリは、ページ全体が1つのReactの木だからです。「この部分だけJSを送らない」を後から作るのは、そう簡単ではありません。

動作も確かめてください。

bash
$ npx astro preview -- --host 0.0.0.0 --port 4321

ホストのブラウザで http://192.168.226.50:4321/ を開き、ボタンを押して数字が増えること、記事ページに移ると素のHTMLであることを見てください。確認したら Ctrl + C。

npm run dev ではなく astro preview を使うのは、パフォーマンスの回で書いたとおり、開発サーバーの結果は本番と違うからです。preview は、いま作った dist/ をそのまま配ります。


⑤ Eleventy — JavaScript を1行も書かない

Astro には、まだ「JSXっぽいもの」が残っていました。

それすら要らない、という選び方があります。

bash
$ mkdir -p ~/eleventy-demo
$ cd ~/eleventy-demo
$ npm init -y
$ npm install @11ty/eleventy

記事を1本置きます。

bash
$ nano ~/eleventy-demo/index.md
# はじめての Eleventy

設定ファイルは、まだ1つも作っていません。

ビルドします。

bash
$ npx @11ty/eleventy
[11ty] Writing ./_site/index.html from ./index.md
[11ty] Wrote 1 file in ... seconds

設定ファイルは0個です。 package.json と、Markdown が1枚だけです。

bash
$ cat ~/eleventy-demo/_site/index.html
<h1>はじめての Eleventy</h1>
<p>設定ファイルは、まだ1つも作っていません。</p>

ここが Astro との一番の違いです

<html> も <head> も <title> も、ありません。

Astro は、何も指定しなければHTML文書の形を勝手に整えてくれました。 Eleventy は、書いたものしか出しません。

枠が要るなら、自分で書きます。

bash
$ mkdir -p ~/eleventy-demo/_includes
$ nano ~/eleventy-demo/_includes/base.njk
<!doctype html>
<html lang="ja">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>{{ title }}</title>
  </head>
  <body>
    {{ content | safe }}
  </body>
</html>

{{ }} が、テンプレートエンジン(Nunjucks)の穴です。content に本文が入ります。

Markdown 側から指定します。

bash
$ nano ~/eleventy-demo/index.md
---
layout: base.njk
title: はじめての Eleventy
---

# はじめての Eleventy

設定ファイルは、まだ1つも作っていません。
bash
$ npx @11ty/eleventy
$ cat ~/eleventy-demo/_site/index.html

今度は、完全なHTML文書が出ます。

JavaScript も、数えておきます。

bash
$ find ~/eleventy-demo/_site -name "*.js" | wc -l
0

Astro と Eleventy の棲み分け

AstroEleventy
書くもの.astro(JSXに近い) + MarkdownMarkdown + テンプレート(Nunjucks / Liquid など)
JavaScript を書くか書く(ビルド時に動く分)書かなくてよい
React / Vue を混ぜられるかできる(client:load)想定していない。JSが要るなら自分で <script> を書く
既定の出力HTML文書の形になっている書いたものだけ。枠は自分で
設定ファイルastro.config.mjs が最初からある無くても動く
向いているもの一部だけ動くページがあるサイト。 ブログ・企業サイト・LP完全に静的なサイト。 個人ブログ・ドキュメント・社内の資料置き場
学習コストReact を知っていれば低いHTMLとMarkdownだけ知っていれば低い

「JavaScript のフレームワークを1つも足さなくてよい」なら、Eleventy が一番少ない道具で済みます。 押すところが1つでも出てきたら、Astro のほうが後で楽です。

どちらも「作れないもの」はほぼ同じです。違うのは、どこまで自分で書くかだけです。


⑥ VuePress と Docusaurus — ドキュメント専用

3つ目の分類です。 これらは「サイトを作る道具」ではなく、「ドキュメントを作る道具」です。

Astro や Eleventy で技術ドキュメントを作ると、必ず自分で作るはめになるものがあります。

欲しくなるものAstro / EleventyVuePress / Docusaurus
左のサイドバー(章立て)自分で作る最初から付いている
ページ内検索自分で作る(全文検索の回の話になります)最初から付いている
「前へ / 次へ」のリンク自分で作る最初から付いている
バージョンごとのドキュメント(v1 / v2 を並存させる)自分で作るDocusaurus は最初から対応
多言語自分で作る最初から対応
見た目を自由に変えられるか完全に自由決まった形から大きくは外れない

この表の最後の行が、選ぶ理由でもあり、選ばない理由でもあります。

道具土台ひとこと
VuePressVueVue の公式ドキュメント系で使われてきたもの。 軽い
DocusaurusReact機能が多い。 バージョン管理と多言語が要るなら、こちら

「ドキュメントを書きたいのに、サイドバーの作り方を3時間調べている」——これが、汎用の道具を選んだときに起きることです。 逆に、「トップページを凝りたい」のに Docusaurus を選ぶと、決まった形と戦うことになります。

今日は作りません。 npm create vuepress@latest や npx create-docusaurus@latest で始められる、ということだけ覚えておいてください。VMのディスクは有限です。

選び方は1問

「これは、章立てのある説明書か?」 はい → VuePress / Docusaurus。 いいえ → Astro / Eleventy。


⑦ Markdown を、どこに置くか

ここまで、Markdown はすべてリポジトリの中のファイルでした。 置き場所には、もう1つの選択肢があります。

リポジトリの中に置くヘッドレスCMSに置く
書くところエディタ(VS Code など)ブラウザの管理画面
保存されるところGitCMSのサーバー(DB)
履歴全部残る。 誰がいつ何を直したかが git log で追えるCMS次第。 残らないこともある
公開の手順push → ビルド → 公開(GitHub Actions の回)管理画面で保存 → ビルドを呼び出す仕掛けが要る
画像リポジトリが太る。数百枚になると重いCMS側が持ってくれる
書き手が自分以外にいる場合Git を覚えてもらう必要がある管理画面だけ渡せばいい
オフラインで書けるか書ける書けない
サービスが終わったら手元にファイルが残るエクスポートが要る

判断は、たいてい「自分以外が書くか」で決まります。

一人で書くなら、リポジトリの中が圧倒的に楽です。 記事も設定もコードも、git log 1本で追えます。 PRとレビューの回でやった仕組みが、そのまま文章にも効きます。

逆に、文章を書く人がエンジニアでないなら、git commit を覚えてもらうのは無理があります。 そこでヘッドレスCMSが出てきます。

WordPress をヘッドレスCMSとして使う、という手もある

意外に思えるかもしれませんが、これは普通にやられています。

WordPress には REST API があり、記事を JSON で取り出せます(REST API の回でやった形そのものです)。

  • 書く人は、いつもどおり WordPress の管理画面で書く
  • 表示は、Astro がビルド時に API を叩いてHTMLを作る

この構成なら、「書き心地は WordPress のまま、表示は静的」になります。 その代わり、動かす対象が2つに増えます。 WordPress は結局、動き続けます。

「静的にすればサーバーが要らなくなる」は、ここでは成立しません。 消えたのは、読者からのアクセスを受けるサーバーだけです。


⑧ SSG が向かないもの

ここまで褒めてきたので、天井を先に見ておきます。

1. ログインが要るもの

ビルドの時点では、誰が見に来るか分かりません。

「ログインした人の名前を出す」ページを、事前に作っておくことはできません。

逃げ道はあります。 枠だけ静的に作っておき、名前の部分だけブラウザから API を叩いて埋める——つまり、その部分だけ CSR にするやり方です。非同期処理の回でやった fetch です。

ただし、そうすると④の島が大きくなります。 島がページの大半になったら、それはもう SPA です。

2. 内容が毎分変わるもの

在庫数、株価、掲示板の書き込み。

ビルドし直すまで古いままです。1分ごとにビルドする、という力業もありますが、記事が増えると成立しなくなります。 次の話です。

3. 記事が数万本あるもの

これが一番効きます。実測します。

bash
$ cd ~/astro-blog
$ time npm run build
real	0m6.4s

数字は違って構いません。 いま作ったのは3ページです。

ページを増やして、傾きを見ます。

bash
$ cd ~/astro-blog/src/pages/posts
$ for i in $(seq 1 200); do
$   printf -- '---\nlayout: ../../layouts/Post.astro\ntitle: 記事 %s\npubDate: 2026-09-13\n---\n\n# 記事 %s\n\n本文です。\n' "$i" "$i" > "post-$i.md"
$ done
$ ls | wc -l
203
bash
$ cd ~/astro-blog
$ time npm run build

時間が伸びます。 1ページあたり何ミリ秒かかっているかを、割り算で出してください。

[スクリーンショット: 04_ビルド時間_200ページ.png] time npm run build の結果(3ページのときと200ページのときの2回分)を撮ってください。

仮に1ページ 30ms だとして、計算します。

記事数ビルド時間(1ページ30msの場合)
100本3秒
1,000本30秒
10,000本5分
100,000本50分

「誤字を1文字直したら、公開まで5分待つ」——これが SSG の天井です。 記事が増えるほど、直すのが億劫になります。

現実には、こういう逃げ道があります。

逃げ道中身代償
インクリメンタルビルド変わったページだけ作り直す「変わった」の判定が外れると、古いページが残る
ISR(Next.js など)最初のアクセス時に作って、以後は使い回すサーバーが要る。 静的ではなくなる
ビルドしないページを作る検索結果ページなどは CSR にするJSが増える

どれも「SSGをやめる方向」への一歩です。 そこが判断の分かれ目になります。

片づけておく

200本のファイルは、この後の話には要りません。

bash
$ rm ~/astro-blog/src/pages/posts/post-*.md
$ ls ~/astro-blog/src/pages/posts/
hello.md  second.md

⑨ このサイトが WordPress のままな理由

ここまで書いてきて、当然こう思うはずです。

「では、このサイトも Astro にすればいいのでは?」

静的ホスティングの回でも同じ問いを書きました。 そこでは「静的ホスティングには原理的に載らない」という理由でした。

今日の道具を使えば、載ります。 それでも移しません。 理由が変わるので、正直に書きます。

理由1: 書くことに集中したいから

このサイトの目的は「毎週、記事を1本増やすこと」です。

移行すると、増えるのはこういう仕事です。

  • 記事の書き方が変わる(管理画面 → Markdown と git push)
  • 公開までにビルドを待つ(いまは「公開」を押した瞬間に出ます)
  • ビルドが失敗したら、記事が出ない(GitHub Actions の回でやったとおり、CIは失敗します)

書く時間が、道具の面倒を見る時間に変わります。

「サイトを速くする」ことに使った時間は、「記事を1本増やす」ことには使えません。 いまの自分にとって、どちらが効くかは、はっきりしています。

理由2: プラグインで足りているから

このサイトが WordPress のプラグインでやっていることを並べます。

やっていることAstro に移したら
キャッシュ(HTMLをファイルに保存して2回目から返す)要らなくなる(最初から静的なので)
HTTPSの強制ホスティング側の設定になる
目次の自動生成自分で作る
記事内の検索自分で作る(⑥の表のとおり)
画像の自動リサイズ自分で作る、または別サービス
予約投稿自分で作る(ビルドを時刻で呼び出す仕掛けが要る)

右側の「自分で作る」が、全部「自分の宿題」になります。

プラグインは、他人が書いて他人が保守しているコードです。 それを自分のコードに置き換えるのは、資産が増えることではなく、保守対象が増えることです。

理由3: 移行のコストが見合わないから

得られるものを、正直に数えます。

得られるもの実際のところ
表示が速くなる速くはなります。 ただし、いまキャッシュが効いていて、遅くて困ってはいません
サーバー代が浮くレンタルサーバーの月額だけです。料金の回で書いたとおり、大きな額ではありません
JSが減るいまも、このサイトは React で作られていません。 もともと送っていません

最後の行が重要です。

①の表で見たとおり、WordPress は SSR 側です。 今日の「JSを全部送っているのに動くところが無い」という無駄は、このサイトでは最初から起きていません。 困っていない問題を、道具を替えて直そうとしていることになります。

そして、失うものがあります。

  • パーマリンクが1本でも変われば、貼られているリンクが死にます(WordPressで公開した回で決めたURLの形が、全記事で使われています)
  • 記事の中の画像を、全部移す必要があります
  • 移行中に間違えたときの被害が、公開中のサイト全体に及びます

だから、こう決めています

技術的に優れているほうを選ぶのではありません。 いま自分が困っていることを解くほうを選びます。

これは「WordPress のほうが良い」という主張ではありません。 新しくブログを始めるなら、今日の Astro を選ぶ可能性は十分にあります。

違うのは、「ゼロから始めるとき」と「動いているものを移すとき」で、計算が変わることです。


WordPress を続けるということは「サーバーが毎回作る」側に残るということなので、置き場所は静的ホスティングではなくレンタルサーバーになります。WordPress で学習記録サイトを持つならエックスサーバーのような共用レンタルサーバーが候補で、2026-11 時点の公式料金表ではスタンダードが 12 ヶ月契約で月額換算 1,100 円、36 ヶ月で 990 円(税込)です。料金は契約期間分の一括前払いで、支払った料金は返還されないとされているので、契約期間は慎重に選んでください。

⑩ やりすぎない

今日覚えたのは、「中身を読ませるサイトを、JSを送らずに作る道具」です。 全部を置き換える道具ではありません。

最後に、判断を1つの流れにします。

  1. そのページの中身は、読者ごとに変わるか? —— 変わる → SSG ではない(CSR か SSR)
  2. 章立てのある説明書か? —— はい → VuePress / Docusaurus
  3. 押すところがあるか? —— 無い → Eleventy。ある → Astro
  4. 記事は1万本を超えるか? —— 超える → ビルド時間を先に測る

そして、5つ目。

いま動いているものを、移す必要があるか? 困っていないなら、移さない。

フレームワーク選びの回で書いた「入れると増える仕事」は、静的サイトジェネレータにも同じだけあります。 軽いのは出来上がったページであって、作る作業ではありません。


つまずいたところ

npm create astro@latest が、いろいろ質問してくる → フラグを付けていません。 ②のとおり打つか、質問に答えても構いません(この記事と構成が変わるだけです)。

ホストのブラウザから 4321番に繋がらない → --host 0.0.0.0 の付け忘れか、sudo ufw allow 4321/tcp の忘れです。VMの中で curl http://localhost:4321/ が通るなら、原因は後者です(ネットワークの回)。

npm run dev -- --host 0.0.0.0 の -- を忘れて、効かない → -- が無いと、--host を npm 自身への引数だと解釈されます。 ハイフン2つは必須です。

grep -c "<script" dist/**/*.html が、1ファイルしか見てくれない → これで一番時間を使いました。 素の bash では ** は * と同じ扱いで、1階層しか展開されません。 dist/index.html は見つかっても、dist/posts/hello/index.html は見つかりません。 grep -rc "<script" --include="*.html" dist/ を使ってください。 shopt -s globstar を打てば ** も効くようになりますが、覚えることが増えるだけです。

Markdown を置いたのに、ページが真っ白 → src/pages/ の下に置いていますか。 src/posts/ ではURLになりません。src/pages/ の中だけが、URLに変換されます。

layout: を書いたのに、枠が付かない → 相対パスが違います。 src/pages/posts/hello.md からは ../../layouts/Post.astro です。../layouts/ だと1階層足りません。 ls ../../layouts/ を、その Markdown があるフォルダで打って確かめてください。

一覧ページに記事が出ない → import.meta.glob("./posts/*.md") のパスが、index.astro から見た相対パスになっているか確認してください。 src/pages/index.astro からは ./posts/*.md です。

<Counter /> を置いたのに、ボタンを押しても増えない → client:load を書き忘れています。 これが Astro の既定です。 ④の表のとおりで、不具合ではありません。

useState を書いたら、ビルドが落ちる → npx astro add react をやっていないか、.jsx ではなく .astro に書いています。 .astro ファイルの中で useState は使えません(ビルド時にしか動かないためです)。

npm run build のあと、dist/ を開いてもリンクが動かない → file:// で直接HTMLを開いていませんか。 npx astro preview を使ってください。

Eleventy の出力に <html> が無い → 不具合ではありません。 ⑤のとおり、Eleventy は書いたものしか出しません。 レイアウトを作ってください。

Eleventy が _includes/base.njk を見つけてくれない → フォルダ名の先頭のアンダースコアを忘れていませんか。 includes ではなく _includes です。

for ループで200ファイル作ったあと、ls が固まる → 固まってはいません。 ファイル数が多いだけです。ls | wc -l で数だけ見るほうが速いです(Linuxのコマンドの回)。

rm ~/astro-blog/src/pages/posts/post-*.md で、hello.md まで消した → 消えません。 post-* にマッチしないためです。ただし rm *.md と打つと全部消えます。 ⑧のコマンドを、そのまま使ってください。


後片づけ

開けたポートを閉じます。

bash
$ sudo ufw delete allow 4321/tcp
$ sudo ufw status

ビルドの成果物は消して構いません。 npm run build で戻ります。

bash
$ rm -rf ~/astro-blog/dist
$ rm -rf ~/eleventy-demo/_site

node_modules の大きさを、1回だけ見ておいてください。

bash
$ du -sh ~/astro-blog/node_modules ~/eleventy-demo/node_modules ~/react-demo/node_modules

数字は違って構いません。 npm の回で書いたとおり、これは消してよいものです。

Eleventy のほうは、この後使いません。消して構いません。

bash
$ rm -rf ~/eleventy-demo

~/astro-blog/ は残してください。 全部やり直したいときは:

bash
$ rm -rf ~/astro-blog

手元のフォルダは、こうなっています。

bash
$ ls ~
astro-blog  next-demo  react-demo  server  vite-demo  web
フォルダ中身
web素のHTML/CSS
vite-demoVite だけ(Vanilla)
react-demoReact + TypeScript。CSR
next-demoNext.js。SSR と SSG
astro-blogAstro。SSG とアイランド
serverNode.js の API

~/react-demo/ と ~/next-demo/ は消さないでください。 比較対象として、この先も使います。


まとめ

  • 押すところが1つも無いページに、JavaScript を全部送っている——これが一番よくある無駄。~/react-demo/ の dist/ には、React本体が丸ごと入っている
  • HTMLを作るやり方は3つだけ。 サーバーが毎回作る(WordPress・SSR)/ あらかじめ全部作る(SSG)/ ブラウザで作る(CSR)
  • 「静的に置ける」と「JSを送らない」は別の話。 GitHub Pages に置いた ~/react-demo/ は、前者だけを満たしていた
  • Astro は src/pages/ に .md を置くだけでURLが1本増える。 .astro を1文字も書かなくていい
  • .astro ファイルは上下2段。 上の --- で挟んだ JavaScript は、ビルド時にだけ動き、ブラウザには送られない
  • Astro の dist/ には、<script> が1個も無い。 grep -rc "<script" --include="*.html" dist/ で全ページ 0 になる
  • grep -c "<script" dist/**/*.html は効かない。 素の bash の ** は1階層しか展開しない
  • ハイドレーションが要らないのは、乗せるものが無いから。 速さの理由は「そもそも仕事をしていない」こと
  • client:load を書いたコンポーネントにだけ、JSが載る。 書かなければ、ビルド時に実行された結果のHTMLだけが出る
  • アイランドアーキテクチャは「JSが0の状態が既定」だから成立する。 削るのではなく、足す
  • Eleventy は JavaScript を1行も書かなくてよく、設定ファイルも要らない。 その代わり <html> の枠も出してくれない
  • 押すところが無いなら Eleventy、1つでもあるなら Astro。 作れるものはほぼ同じで、違うのはどこまで自分で書くか
  • VuePress と Docusaurus は、章立てのある説明書のための道具。 検索・サイドバー・前後リンクが最初から付く代わりに、見た目の自由度を捨てている
  • Markdown をリポジトリに置くと git log で履歴が全部残る。 その代わり、書き手に Git を覚えてもらう必要がある
  • ヘッドレスCMSは、書き手がエンジニアでないときの答え。 WordPress をヘッドレスに使う場合、WordPress は結局動き続ける
  • SSG が向かないのは3つ。ログインが要る / 内容が毎分変わる / 記事が数万本
  • ビルド時間には天井がある。 1ページ30msなら、1万本で5分。「誤字1文字を直すのに5分待つ」がSSGの限界
  • 逃げ道(インクリメンタルビルド・ISR・一部CSR)は、どれも「SSGをやめる方向」への一歩
  • このサイトを Astro に移さないのは、技術的に劣っているからではない。 書く時間が道具の面倒を見る時間に変わるから
  • プラグインは、他人が書いて他人が保守しているコード。 自作に置き換えるのは資産ではなく保守対象が増えること
  • WordPress は SSR 側なので、「JSを送りすぎる」問題はもともと起きていない。 困っていない問題を、道具を替えて直そうとしていた
  • ゼロから始めるときと、動いているものを移すときでは、計算が変わる

③で grep が 0 を返した瞬間が、この記事の全部です。

Reactを使えることと、Reactを使う必要があることは、別です。

そして、今日の道具でこのサイトを作り直せると分かったうえで、作り直さない—— その判断ができるようになったことのほうが、道具が1つ増えたことより大きいと思っています。

参考リンク


次に読む

この記事は 【第8段階】深掘り の 17 / 30 本目です。

記事
← 前の記事Svelteは仮想DOMを使わない — React以外の現在地
→ 次の記事同じボタンが3種類できる理由 — デザインシステム

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend›Static Site Generators
  • Astro / Eleventy — JavaScript を送らないサイト
  • VuePress / Docusaurus — ドキュメント専用

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次