※本記事はアフィリエイト広告(PR)を含みます。
前々回で、curl を打って空のHTMLを見ました。その次の回で、dist/ を GitHub Pages に出して、世界に公開しました。
前回: Svelteは仮想DOMを使わない — React以外の現在地
作業場所は VMの中(Ubuntu)、確認はホストの Windows のブラウザです。
これまで作ったものは、1つも消しません。
~/react-demo/も~/next-demo/も残したまま、~/astro-blog/を新しく作ります。比べるために残します。このサイト(obmes.com)を移す話ではありません。 最後に「なぜ移さないか」を書きます。
そこまでは良かったのですが、1つ引っかかったままのことがあります。
~/react-demo/ のビルド結果を、もう一度見てください。
数百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 のままなのは、技術的に優れているからではないこと。書くことに集中したいからであり、移行のコストが見合わないから
この記事でやること
- 3つのやり方を表で並べる(サーバーが毎回作る / あらかじめ作る / ブラウザで作る)。このサイトがどれかも確定させる
~/astro-blog/を作り、Markdown を置くだけで記事ページが増えることを見る- ビルドして
dist/を作り、grepで<scriptを数える。 0 であることを目で見る - React コンポーネントを1つだけ
client:loadで埋め、そのページにだけ JS が載ることを、同じgrepで確かめる ~/eleventy-demo/を作り、設定ファイル0個で Markdown をHTMLにする- ビルド時間を実測し、記事が1万本あったらどうなるかを計算する
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| SSG | Static Site Generation。ビルドのときに全ページ分のHTMLを作っておき、あとはファイルを配るだけ。前々回に出ました |
| 静的サイトジェネレータ | SSG をやるための道具そのもの。Astro・Eleventy・Hugo など。SSG(やり方)と同じ略語で呼ばれるので紛らわしい |
| Astro | 中身を読ませるサイト向けの静的サイトジェネレータ。 既定でJSを送らないのが最大の特徴 |
| Eleventy(11ty) | JavaScript製だが、書く側はJSを1行も書かなくてよい静的サイトジェネレータ。設定ファイルすら省略できる |
| アイランドアーキテクチャ | ページの大半は動かないHTMLにしておき、動かしたい部分だけを「島」として切り出す作り方 |
client:load | Astro で「このコンポーネントだけ、ブラウザでも動かす」と指示する書き方。これを書かない限りJSは送られない |
| フロントマター | Markdown ファイルの先頭に --- で挟んで書く、タイトルや日付などの付随情報。この記事の元ファイルにも付いています |
| テンプレートエンジン | 穴あきのHTMLに、値を差し込んでページを作る仕組み。Nunjucks・Liquid など |
| ヘッドレスCMS | 管理画面と記事の保管だけをやり、見た目は持たないCMS。 記事は API(JSON)で取り出す |
| インクリメンタルビルド | 前回から変わったページだけを作り直すこと。全ページ作り直すと遅すぎる規模で必要になる |
① やり方は3つしかない
道具の名前を並べる前に、地図を作ります。
「読者にHTMLが届くまでに、誰がそれを組み立てたか」——見るのはここだけです。
| サーバーが毎回作る | あらかじめ全部作っておく | ブラウザで作る | |
|---|---|---|---|
| 呼び方 | SSR | SSG | CSR / SPA |
| 代表例 | WordPress・Next.js(動的) | Astro・Eleventy・Hugo | Vite + 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">) | 記事の本文がそのまま入っている |
| JavaScript | React 本体 + 全コンポーネント | 今日の結果を、この後で見ます |
「静的に置ける」と「JSを送らない」は、まったく別の話です。 前者だけ満たして後者を満たしていないのが、いまの ~/react-demo/ です。
② Astro でブログを1本作る
言葉はここまでです。実物を作ります。
作る
VMの中です。
フラグを付けているのは、対話の質問を減らすためです。何か聞かれたら、Enter(既定値)で構いません。
| フラグ | 意味 |
|---|---|
--template minimal | 中身が空のテンプレート。 ブログ用のテンプレートもありますが、最初から完成品だと、何が起きているか分かりません |
--install | npm install まで済ませる(npm の回) |
--no-git | この場では Git リポジトリを作らない(Git の回でやったものと混ざるのを避けます) |
--skip-houston | 起動時のアニメーションを飛ばす |
数分かかります。
何ができたか
~/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)ともぶつかりません。
-- を忘れないでください。 これが無いと、--host を npm 自身への指示だと解釈されます(前々回と同じ落とし穴です)。
ホストのブラウザで http://192.168.226.50:4321/ を開いてください(IPは自分の値に置き換えてください。分からなければ VMの中で ip a。ネットワークの回)。
[スクリーンショット: 01_astro_起動画面.png] ホストのブラウザで http://192.168.226.50:4321/ を開き、Astro の最小テンプレートのページが表示されている画面を撮ってください。
Markdown を置くだけで、記事になる
ここが、この道具の一番の売りです。
もう1枚ターミナルを開いて(開発サーバーは動かしたまま)、フォルダとファイルを作ります。
---
title: 最初の記事
pubDate: 2026-09-13
---
# 最初の記事
これは Markdown で書いた記事です。**太字**も書けます。
- 箇条書きも
- そのまま出ます
保存したら、ブラウザで http://192.168.226.50:4321/posts/hello を開いてください。
記事になっています。
.astroファイルを1文字も書いていません。src/pages/に.mdを置いた——それだけで、URLが1本増えました。
もう1本作って、確かめてください。
---
title: 2本目の記事
pubDate: 2026-09-14
---
# 2本目の記事
ファイルを増やすと、ページが増えます。
http://192.168.226.50:4321/posts/second が開けば成功です。
見た目の枠を、1回だけ書く
いま開いたページは、素のHTMLがそのまま出ているだけです。HTMLの回でやった状態と同じで、<title> すら入っていません。
枠を1枚作ります。
---
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行足します。
---
layout: ../../layouts/Post.astro
title: 最初の記事
pubDate: 2026-09-13
---
second.md にも、同じ layout: の行を足してください。 パスは同じで構いません。
../../layouts/ は、src/pages/posts/ から見た相対パスです(Linuxのディレクトリの回の .. と同じものです)。
ブラウザを更新すると、タブのタイトルが「最初の記事」に変わっています。
記事一覧を作る
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 で開発サーバーを止めてから、本番用にビルドします。
building client (vite)
✓ built in ...
generating static routes
▶ /index.html
▶ /posts/hello/index.html
▶ /posts/second/index.html
✓ Completed in ...
表示は違って構いません。 見てほしいのは、「3枚のHTMLファイルが書き出された」という部分です。
何が出来たか
/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 ファイルを数える
推測しないで数えます。
0
0本です。
~/react-demo/ 側と比べてください。
0 ではない数が返ります(dist/ を消してしまっていたら、cd ~/react-demo && npm run build で作り直せます)。
<script を数える
ファイルが無いだけでなく、HTMLの中にも書かれていないことを確かめます。
/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 の回)。
中身も見てください。
記事の本文が、そのまま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 を足す
「この2つのパッケージを入れて、設定ファイルをこう書き換えるが、いいか」と聞かれます。 y で進めてください。
何が変わったか、必ず見てください。
import { defineConfig } from 'astro/config';
import react from '@astrojs/react';
export default defineConfig({
integrations: [react()],
});
コンポーネントを書く
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 を編集します。
上の段に、読み込む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 を、もう一度打つ
/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 ファイルも増えています。
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を送らない」を後から作るのは、そう簡単ではありません。
動作も確かめてください。
ホストのブラウザで http://192.168.226.50:4321/ を開き、ボタンを押して数字が増えること、記事ページに移ると素のHTMLであることを見てください。確認したら Ctrl + C。
npm run dev ではなく astro preview を使うのは、パフォーマンスの回で書いたとおり、開発サーバーの結果は本番と違うからです。preview は、いま作った dist/ をそのまま配ります。
⑤ Eleventy — JavaScript を1行も書かない
Astro には、まだ「JSXっぽいもの」が残っていました。
それすら要らない、という選び方があります。
記事を1本置きます。
# はじめての Eleventy
設定ファイルは、まだ1つも作っていません。
ビルドします。
[11ty] Writing ./_site/index.html from ./index.md
[11ty] Wrote 1 file in ... seconds
設定ファイルは0個です。 package.json と、Markdown が1枚だけです。
<h1>はじめての Eleventy</h1>
<p>設定ファイルは、まだ1つも作っていません。</p>
ここが Astro との一番の違いです
<html> も <head> も <title> も、ありません。
Astro は、何も指定しなければHTML文書の形を勝手に整えてくれました。 Eleventy は、書いたものしか出しません。
枠が要るなら、自分で書きます。
<!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 側から指定します。
---
layout: base.njk
title: はじめての Eleventy
---
# はじめての Eleventy
設定ファイルは、まだ1つも作っていません。
今度は、完全なHTML文書が出ます。
JavaScript も、数えておきます。
0
Astro と Eleventy の棲み分け
| Astro | Eleventy | |
|---|---|---|
| 書くもの | .astro(JSXに近い) + Markdown | Markdown + テンプレート(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 / Eleventy | VuePress / Docusaurus |
|---|---|---|
| 左のサイドバー(章立て) | 自分で作る | 最初から付いている |
| ページ内検索 | 自分で作る(全文検索の回の話になります) | 最初から付いている |
| 「前へ / 次へ」のリンク | 自分で作る | 最初から付いている |
| バージョンごとのドキュメント(v1 / v2 を並存させる) | 自分で作る | Docusaurus は最初から対応 |
| 多言語 | 自分で作る | 最初から対応 |
| 見た目を自由に変えられるか | 完全に自由 | 決まった形から大きくは外れない |
この表の最後の行が、選ぶ理由でもあり、選ばない理由でもあります。
| 道具 | 土台 | ひとこと |
|---|---|---|
| VuePress | Vue | Vue の公式ドキュメント系で使われてきたもの。 軽い |
| Docusaurus | React | 機能が多い。 バージョン管理と多言語が要るなら、こちら |
「ドキュメントを書きたいのに、サイドバーの作り方を3時間調べている」——これが、汎用の道具を選んだときに起きることです。 逆に、「トップページを凝りたい」のに Docusaurus を選ぶと、決まった形と戦うことになります。
今日は作りません。 npm create vuepress@latest や npx create-docusaurus@latest で始められる、ということだけ覚えておいてください。VMのディスクは有限です。
選び方は1問
「これは、章立てのある説明書か?」 はい → VuePress / Docusaurus。 いいえ → Astro / Eleventy。
⑦ Markdown を、どこに置くか
ここまで、Markdown はすべてリポジトリの中のファイルでした。 置き場所には、もう1つの選択肢があります。
| リポジトリの中に置く | ヘッドレスCMSに置く | |
|---|---|---|
| 書くところ | エディタ(VS Code など) | ブラウザの管理画面 |
| 保存されるところ | Git | CMSのサーバー(DB) |
| 履歴 | 全部残る。 誰がいつ何を直したかが git log で追える | CMS次第。 残らないこともある |
| 公開の手順 | push → ビルド → 公開(GitHub Actions の回) | 管理画面で保存 → ビルドを呼び出す仕掛けが要る |
| 画像 | リポジトリが太る。数百枚になると重い | CMS側が持ってくれる |
| 書き手が自分以外にいる場合 | Git を覚えてもらう必要がある | 管理画面だけ渡せばいい |
| オフラインで書けるか | 書ける | 書けない |
| サービスが終わったら | 手元にファイルが残る | エクスポートが要る |
判断は、たいてい「自分以外が書くか」で決まります。
一人で書くなら、リポジトリの中が圧倒的に楽です。 記事も設定もコードも、
git log1本で追えます。 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. 記事が数万本あるもの
これが一番効きます。実測します。
real 0m6.4s
数字は違って構いません。 いま作ったのは3ページです。
ページを増やして、傾きを見ます。
203
時間が伸びます。 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本のファイルは、この後の話には要りません。
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つの流れにします。
- そのページの中身は、読者ごとに変わるか? —— 変わる → SSG ではない(CSR か SSR)
- 章立てのある説明書か? —— はい → VuePress / Docusaurus
- 押すところがあるか? —— 無い → Eleventy。ある → Astro
- 記事は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 と打つと全部消えます。 ⑧のコマンドを、そのまま使ってください。
後片づけ
開けたポートを閉じます。
ビルドの成果物は消して構いません。 npm run build で戻ります。
node_modules の大きさを、1回だけ見ておいてください。
数字は違って構いません。 npm の回で書いたとおり、これは消してよいものです。
Eleventy のほうは、この後使いません。消して構いません。
~/astro-blog/ は残してください。 全部やり直したいときは:
手元のフォルダは、こうなっています。
astro-blog next-demo react-demo server vite-demo web
| フォルダ | 中身 |
|---|---|
web | 素のHTML/CSS |
vite-demo | Vite だけ(Vanilla) |
react-demo | React + TypeScript。CSR |
next-demo | Next.js。SSR と SSG |
astro-blog | Astro。SSG とアイランド |
server | Node.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つ増えたことより大きいと思っています。
参考リンク
- roadmap.sh — Frontend
- roadmap.sh — React
- Astro 公式ドキュメント(日本語)
- Astro — アイランドアーキテクチャ
- Astro — Markdown コンテンツ
- Astro — テンプレートディレクティブ(
client:loadなど) - Astro — React インテグレーション
- Astro — CMS と組み合わせる
- Eleventy 公式ドキュメント
- Eleventy — Markdown
- Eleventy — レイアウト
- VuePress 公式
- Docusaurus 公式ドキュメント
- Jamstack — 静的サイトジェネレータの一覧
- Next.js — 静的エクスポート
- WordPress REST API ハンドブック
- web.dev — Rendering on the web
次に読む
この記事は 【第8段階】深掘り の 17 / 30 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | Svelteは仮想DOMを使わない — React以外の現在地 |
| → 次の記事 | 同じボタンが3種類できる理由 — デザインシステム |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- Astro / Eleventy — JavaScript を送らないサイト
- VuePress / Docusaurus — ドキュメント専用
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント