Cloudflare Pages 仕様データサイト運用メモ
LogicRoll の攻略サイト向けデータや開発仕様を、Markdown から静的 HTML に変換して Cloudflare Pages で公開する。
目的
docs/specs/*.mdに整理したデータを、ブラウザで見やすい HTML として共有する。- Discord には
index.htmlまたは個別ページの URL を貼る。 - 仕様が更新されたら、GitHub の
mainブランチへの push をきっかけに Cloudflare Pages を更新する。
現在公開対象
| ページ | 元Markdown | 出力HTML |
|---|---|---|
| パッシブアビリティ案カタログ X版 | docs/specs/passive-ability-idea-catalog.md | passive-ability-idea-catalog.html |
| パッシブアビリティ案カタログ 仮数値版 | docs/specs/passive-ability-idea-catalog-values-draft.md | passive-ability-idea-catalog-values-draft.html |
| 目次 | tools/build-pages-docs.py が生成 | index.html |
Cloudflare Pages 設定
Cloudflare Pages のプロジェクトを GitHub リポジトリ kisato7188/LogicRoll に接続し、以下の設定にする。
| 項目 | 値 |
|---|---|
| Production branch | main |
| Build command | python tools/build-pages-docs.py |
| Build output directory | build/pages |
| Root directory | 空欄、またはリポジトリルート |
この設定なら、対象 Markdown や生成スクリプトを更新して push するだけで Pages 側が再ビルドされる。
ローカル確認
python tools/build-pages-docs.py生成物は build/pages/ に出る。ローカル確認は次のファイルをブラウザで開く。
build/pages/index.html更新手順
1. docs/specs/*.md を更新する。
2. 必要なら tools/build-pages-docs.py の DOCS にページを追加する。
3. python tools/build-pages-docs.py でローカルHTMLを確認する。
4. 変更を commit / push する。
5. Cloudflare Pages のデプロイ完了後、/ または /index.html から各ページへアクセスする。
キャッシュ
tools/build-pages-docs.py は build/pages/_headers を生成し、HTML に Cache-Control: no-cache を付ける。Cloudflare Pages 上で仕様更新が見えにくくなるのを避けるため。