Hugo

kiwi-daily 停掉之後，把月曆搬到 Archives 頁首：桌機是一年 12 格的月份熱度長條加一篇一個 icon 的月曆，手機改成左右滑的月份滑桿，日格的底色和列表的縮圖則在看過預覽後拿掉。

PaperMod 讓文章表格在桌機只撐到內容寬、中文在手機不斷行。這篇記錄先量全站 101 張表、在建好的站上試 CSS，最後用 table render hook 把每張表包進可橫捲的框，以及一路踩到的斷字和選擇器權重問題。

/blogs/ 那 8 隻奇異鳥 logo 只顯示 108px，卻每隻都是 200 多 KB 的 PNG。這篇記錄怎麼換成 R2 上 128px／256px 的 WebP、為什麼沒用 srcset，以及讓上傳腳本以後自動把文章圖縮到 1400px 並轉 WebP。

PageSpeed 說我有 72 KiB 沒用到的 JavaScript、10 KiB 舊式 JavaScript。把 GA 的 gtag/js 移到 window load 之後、只在正式 build 載入，load 提早約 1.1 秒、FCP 小幅改善；但 Lighthouse 照樣量到 72 KiB，而那 10 KiB 根本是 Cloudflare 的 beacon。第一次拿兩個不同 host 比出來的 LCP 進步，換成同條件 A/B 也不見了。

kiwi-walk 的 /tags/ 有 159 個 tag，其中 115 個只有一篇文章。這篇記錄怎麼用一個參數 tagsMinCount（預設 2）把總覽縮到 44 個，同時讓單篇 tag 的頁面照樣存在、文章底下的 tag 照樣點得進去，以及驗證時被壓縮 HTML 和一個帶斜線的 tag 騙到的兩次。

kiwi-walk 的 Cloudflare Pages preview 上，首頁 22 個站內連結全部指向 https://kiwi-walk.com/，點一下就離開 preview。原因是 hugo.yml 寫死的 baseURL；改用一支 build script 讀 CF_PAGES_BRANCH 與 CF_PAGES_URL，在 preview 上換成部署自己的網址，並用逐檔 diff 確認正式站輸出不變。

kiwi-walk 的文章底部加了分享列。桌機是 LINE、Threads、Facebook 和複製連結四顆圓形 icon，手機只留「分享這篇」「複製連結」兩顆按鈕，交給系統分享選單。這篇記錄為什麼按鈕要少、手機和桌機怎麼切、瀏覽器不支援 navigator.share 或沒有 JS 時退回什麼，以及上線前把通用圖示換成官方 logo 的經過。

kiwi-walk 的精選系列「打造自己的 LLM Wiki」原本照日期排成一長串，看不出哪篇在講架構、哪篇在講儀表板。這篇記錄把它改成按功能分組的過程：系列是手挑的所以不自動收文章、「同步」這組放哪都尷尬最後併掉、還沒有文章的組也要先佔位；分組選單從跳轉連結改成切換顯示，換行的 chips 改成一排等寬方塊，手機不准左右滑就排成三欄兩列。實作是分組寫在系列的 front matter、一個 Hugo partial 同時餵給系列頁和文章下的系列導覽，以及 hidden 屬性沒效、走過的分頁文字消失這兩個 CSS 的坑。

kiwi-walk 的每日連載「Kiwi 的每日筆記」系列頁原本是一長串文章卡片，看不出 streak 有沒有斷。這篇記錄把它改成月曆的過程：先用 mockup 來回八輪才寫程式，今天用底色、選取用框框；做出來嫌月曆太大，改成左窄右寬的兩欄，點一天在右邊列出那天與前一後三篇。實作是 Hugo 模板直接算出每個月的格子、文章卡片放進 給 JavaScript 複製，以及上線後月曆整個沒反應：同時期開始強制的 CSP 擋掉了月曆的 inline script。

有讀者反應 kiwi-walk 的 engineer 分類訂不到 RSS。feed 本身完全正常，W3C 驗證也過；問題出在讀者用的 Chrome extension 用正規表示式找 ，只認有引號的 type="…"，而 Hugo 的 HTML 壓縮把引號拿掉了。這篇記錄怎麼一路排除到真因，以及一行 keepQuotes 加上幾條 _redirects 的修正。