Cloudflare Pages 部署
GitHub Pages 與 Cloudflare Pages 都由 main 分支建置，內容相同，差別只在網址的基底路徑。push 到 main 後，兩邊會各自建置並上線。
| 項目 | 值 |
|---|---|
| 網址 | https://robot-notes.pages.dev |
| 上線日期 | 2026-11-04 |
| 部署方式 | Git integration，GitHub App 以 Only select repositories 授權這個 repo |
| Production branch | main |
| Framework preset | None |
| Build command | LC_ALL=C.UTF-8 bundle exec jekyll build --baseurl "" |
| Build output | _site |
| Ruby | .ruby-version 指定 3.4.4，與 Cloudflare 建置映像的預設版本相同 |
為什麼這樣設定
_config.yml 的 baseurl: /robot-notes 是給 GitHub Pages 用的，因為它的網址在子路徑底下。Cloudflare Pages 的站台在網域根目錄，所以建置指令用 --baseurl "" 覆寫，兩邊共用同一份設定檔。
Cloudflare 需要 Gemfile 才知道要裝哪些套件。GitHub Pages 不讀這個檔，因此不受影響。Gemfile 釘住與 GitHub Pages 相同的 github-pages 套件，讓兩邊的 Jekyll 版本與外掛一致。
_config.yml 的 exclude 是自訂清單，會蓋掉 Jekyll 的預設排除，所以 Gemfile、Gemfile.lock、vendor/ 要自己列。
Cloudflare 的建置環境沒有設定 UTF-8 語系，Ruby 會把檔案當成 US-ASCII 讀取，遇到主題 jekyll-theme-primer 的 Sass 檔裡的非 ASCII 字元就中止，所以建置指令前面要加 LC_ALL=C.UTF-8。本機測試時要設 LANG=C LC_ALL=C 才重現得出來，ruby 映像預設是 UTF-8。
專案要有頂層的 404.html。少了它，Cloudflare Pages 會當成單頁應用，所有不存在的路徑都回首頁且狀態碼 200，讀者點到壞連結看不出來，爬蟲也查不到。
只有版控內的檔案會上線
Git integration 從 GitHub 取得原始碼，.gitignore 內的 tmp/、talk_record/、slam/ 不會進入建置。不要在本機工作樹建站後手動上傳：工作樹內有這些不公開的檔案。
依據
Cloudflare 官方文件，2026-11-04 查閱：
- Jekyll 框架指南：建置指令與輸出目錄。
- 從 GitHub Pages 遷移 Jekyll：需要
Gemfile。 - Build image：預設 Ruby 版本與
.ruby-version覆寫。 - Limits：單站檔案數與單檔大小上限。
- Serving Pages：沒有
404.html時視為單頁應用。 - Workers best practices：官方建議新專案用 Workers Static Assets，Pages 仍可使用。本站沿用 Pages 的 Git integration，推送後自動建置。