✨ git_hub Highlights

本頁記錄各月份中值得單獨標記的技術亮點、踩坑紀錄、或重要決策。

---

📅 2026-04-12

🏷️ kid eng

• from pdf to mp3
• 2秒輪播
• 15秒輪播（寫字時間）
• 打勾後可從 review 複習（考）
• 音標、例句、記憶圖
• Dashboard 打勾已完成，再選 incomplete only，隱藏已完成
• todo：上傳 pdf，生成 web page

🏷️ Sha Diary

（尚無內容）

🏷️ kid daily

（尚無內容）

---

📅 2026-04-14

🏷️ Cloudflare Pages 部署 Jekyll (Private Repo)

• 背景：將 GitHub Private Repo 中的 Jekyll 靜態網站，全自動部署至免費的 Cloudflare Pages，建立 CI/CD 流水線。
• 踩坑 1：Ruby 版本脫鉤
  • 問題：Cloudflare 預設 Ruby 版本太舊，無法編譯本機的 Jekyll 4.4.1
  • 解法：新增環境變數 RUBY_VERSION=4.0.2（對齊 Mac Studio 地端環境）
• 踩坑 2：中文編碼崩潰 (Encoding::UndefinedConversionError)
  • 問題：Cloudflare 容器預設為 ASCII，遇到中文檔名、標籤或路徑直接當機
  • 解法：新增環境變數 LANG=C.UTF-8 與 LC_ALL=C.UTF-8
• 踩坑 3：Worker 與 Pages 架構混淆 (Authentication error [code: 10000])
  • 問題：不小心建立成 Worker 專案，要求 API Token 才能執行 wrangler deploy
  • 解法：放棄 Worker，從畫面最下方 Looking to deploy Pages? Get started 進入正統 Pages 流程
• 🚀 黃金 SOP
  1. Cloudflare → Workers & Pages → 最下方 Get started
  2. Connect to Git → OAuth 授權 → 選 Private Repo
  3. Build command: bundle exec jekyll build，Output: _site
  4. 環境變數：RUBY_VERSION=4.0.2、LANG=C.UTF-8、LC_ALL=C.UTF-8
  5. Save and Deploy，之後只要 git push main 即自動更新

cloudflare_setting/SCR-20260414-1.png cloudflare_setting/SCR-20260414-2.png

cloudflare_setting/SCR-20260414-3.png

---

↩ git_hub 總覽