ルート大全
大学受験の参考書 1,432 冊を科目別に図鑑化し、志望校から逆算した参考書ルートを提示する無料サイト。
公開 URL: https://route-taizen.com/
リポジトリ: https://github.com/daichi-ikeda-170329/study-route-compendium
概要
英語・国語・数学・理科・社会の 5 科目それぞれについて、市販の参考書を難易度・役割・接続関係で整理した「参考書図鑑」と、志望校と現在地から組み立てる「参考書ルート」を提供する。情報・小論文の 2 科目は参考書図鑑と 1 冊ごとの詳細ページだけを持つ（build/lib/extract.mjs の SUBJECTS で catalogOnly: true）。
サイトは 2 層でできている。
- 科目トップ（
<科目>/index.html）— 1 枚の HTML の中で図鑑・ルート・診断・学習ガイドを切り替える。HTML は markup と事前描画（build/prerender-tops.mjs）だけで、描画コードは assets/js/subject-<科目>.js（7 科目で同じ関数は assets/js/subject-common.js）、CSS は assets/css/subject-<科目>.css。データは assets/js/subject-loader.js が配信用の JSON を取ってから描く
- 生成ページ（書籍・志望校別ルート・大学別・記事・学習ガイド・信頼性ページほか）—
data/subjects/<科目>/ を正本として build/ のスクリプトが出力する。手で編集しない
収益はページ内の書籍リンク（Amazon アソシエイト・楽天アフィリエイト）と Google AdSense による。
収録数とページ数
| 科目 | ディレクトリ | 収録冊数 |
|---|
| 英語 | english/ | 263 |
| 国語 | japanese/ | 198 |
| 数学 | math/ | 172 |
| 理科 | science/ | 383 |
| 社会 | social/ | 298 |
| 情報 | joho/ | 29 |
| 小論文 | shoron/ | 89 |
| 合計 | — | 1,432 |
冊数は data/subjects/<科目>/books.json のレコード数で、npm run check:counts（build/apply-count.mjs --check）が
ポータル・科目トップ・この表との一致を確かめる。公開ページ数は sitemap.xml の <loc> の数
（grep -c "<loc>" sitemap.xml で数える。2026-09-11 時点で 1,751）。
ディレクトリの要点
| パス | 中身 | 編集 |
|---|
data/subjects/<科目>/ | 科目データの正本（書籍・ルート・大学・学習ガイド・段・設定・重点対策） | 手で編集 |
build/data/ | 台帳（大学の slug と出典・年度表記・冊数の前回値・更新日・OGP のハッシュなど） | 台帳ごとに決まっている |
build/ | 生成・検査のスクリプト。入口は build/all.mjs だけ | 手で編集 |
build/content/ | 記事と信頼性ページの本文 | 手で編集 |
index.html / 404.html | ポータルと 404 | markup は手で編集（書き込み区間は触らない） |
<科目>/index.html | 科目トップの markup | 同上 |
assets/js/・assets/css/・assets/site.css | 科目トップの描画コード・共有・検索・比較・画像書き出しなど | 手で編集 |
assets/generated/ | 科目データの配信用 JSON・検索索引 | 生成 |
<科目>/books/・<科目>/routes/・<科目>/guides/・univ/・guides/・compare/・new/ ほか | 生成ページ | 生成（手で編集しない） |
test/ / e2e/ | ユニットテスト / E2E とアクセシビリティ | 手で編集 |
docs/ | 設計・運用・調査の記録 | 手で編集 |
dist/ | 公開用の写し（pages.yml がこれだけを配信する） | 生成 |
全体の一覧と各スクリプトの役割は docs/architecture.md。
ビルドと検査
入口はひとつ。順序は build/all.mjs が持つので、個々のスクリプトを手で並べない。
npm ci
npm run build # データ検証 → 生成 → 冊数 → sitemap → OGP → 公開用 dist/
npm run build -- --no-ogp # OGP 画像を飛ばす
npm run check:generated # 生成せずに、ずれているかだけ見る
データを変えたら差分が出なくなるまで流す（通常 2 回）。1 回目で科目トップが変わると、2 回目で一覧の更新日が動く。
push の前に流すもの。
npm run check:data # データの形・ISBN・出典台帳（生成の前の関門）
npm test # ユニットテスト（test/*.test.mjs）
npm run check:site # データと出力 HTML の検査
npm run check:counts # 収録冊数
npm run test:e2e # E2E とアクセシビリティ（320/375/768/1366px。UI を触ったとき）
手元で見るときは npm run serve（HTTP で配信する。file:// では確かめない）。
各テストが何を見ているかと流すタイミングは docs/testing.md。
データの正本と読み口
- 科目データの正本は
data/subjects/<科目>/ の JSON だけ（books.json routes.json universities.json guides.json stages.json config.json、英語だけ focus.json）
- 読み口は
build/lib/load-subject-data.mjs の loadSubjectData(ROOT, dir) の 1 本。生成もテストもここを通す
- 形の検査は
build/lib/validate-subject-data.mjs（npm run check:data）。配信用は build/lib/subject-assets.mjs が作る
- 項目の一覧・型・値の読み方は
docs/data-model.md
ドキュメント
| ファイル | 内容 |
|---|
docs/architecture.md | ディレクトリ・ビルドの手順と順序・生成スクリプト・記事の記法・大学別ページ・検索・科目トップの静的化 |
docs/data-model.md | データファイルの項目と型・難易度の並びとスケール・シリーズ・書影・書名と著者名 |
docs/operations.md | 更新手順・冊数の整合・新刊・アフィリエイト・AdSense・X・OGP・IndexNow・DNS・外部サービス |
docs/sharing.md | 共有 URL のスキーマ・v の運用・保存データ・進めるペース |
docs/testing.md | テストの一覧と流すべきタイミング・check-site.mjs の検査項目 |
docs/deployment-runbook.md | 配信の反映・切り分け・切り戻し・Search Console へのサイトマップ送信 |
docs/style-guide.md | 文章のスタイルガイド（check-site.mjs が一部を機械で検査する） |
docs/data-quality.md | データ品質レポート（生成物） |
docs/remediation-progress.md | 運営者の残作業（OWNER ACTION）の正本と、改修で決めた守りごと（経緯は docs/archive/） |
CONTRIBUTING.md | 変更の進め方 |
運営者が行う手動設定
コードでは完結しない作業。やっていないものを「やった」と書かない。
GitHub Pages の配信元（切り替え済み）
.github/workflows/pages.yml が作る dist/ だけを配信している。
2026-09-04 に切り替え、2026-09-21 に切り替え直した（下を読む）。
配信の反映待ち・切り分け・切り戻しの手順は docs/deployment-runbook.md にまとめてある。
公開状態は npm run check:production で機械的に確かめる（終了コード 0 = 一致 / 1 = 食い違い /
2 = 未検査。2 を成功として扱わない）。
2026-09-21 に、配信元の設定が legacy（リポジトリ直下を配信）に戻っていたのを見つけて直した。
本番の URL が 404 を返すかどうかだけでは判断できないので、設定そのものを
gh api …/pages --jq '{build_type,source}' で見る（"workflow" なら正しい）。
経緯・直し方・切り戻し・環境を作り直すときの順番は docs/deployment-runbook.md の 1.1・4・5 節。
Google Search Console
未登録の理由ごとの読み方（どれがこちらの不備で、どれが待つだけか）は
docs/search-console-indexing.md にまとめてある。件数を見て慌てる前にそちらを読む。
Google アナリティクス 4
Google AdSense
同意管理（CMP）
リポジトリの説明
実施済み（2026-09-05）。 以前の Description は 参考書1,052冊 を含み実数と食い違っていた。
GitHub の設定なので npm run build では直らない。冊数を書かない文面に変え、Topics も設定した
（2026-09-08 に gh repo view で再確認。Topics は education / github-pages / japanese / static-site）。
ライセンス
連絡先
