Hugo

• 20260907 Blowfish 正在衰退 2026年9月7日

  Blowfish 今年的超大變化至今不到一年情況就完全不同，當時只到 v2.92.0，現在已經 v3，owner 完全擁抱 AI，製造了很多 bug 和 UX 問題。

• 部落格第四版：swup.js 參戰 2026年8月12日

  先看到了這個 Issue，看到了他的部落格，再看到他的真部落格，哇這真是個和我完全不同世界的人，不過重點是他的部落格，我發現他有用 PJAX，雖然我大概已經知道 PJAX 了但還是又丟源碼給 Claude 問 PJAX 和 swup.js 有啥差，他回我這個：

• 20260705 關注點分離 2026年7月5日

  這其實不是關注點分離而是關注點搶光光。寫這篇文章的原因是我改 A 壞 B，但是我真的要找一下藉口：這個 A 語法在 10 個地方都重複，我每次要修 A 我就要在 10 個地方一一檢查調用是否正確，而不是在同一個地方把精力花在想好 A 語法正不正確...因為我的關注點被 10 次重複使用搶走了，同樣的精力消耗我有 90% 都在重複檢查調用而不是語法本身，尤其 go-template 又會因為一個大小寫、一個 dollar sign 導致 scope 完全錯誤。

• Hugo 的問題根源 2026年1月26日

  我不斷重申過多次文檔問題，請注意我不是路邊隨便一個普通用戶，我是一個自己使用 Hugo 架站，又維護一個知名主題，自己還額外寫了三個 Hugo 主題的人，文檔的問題從我第一天使用 Hugo 到我維護主題，開新主題，這問題之於我從 noob 到 developer 階段都不斷重複遇到。

• Thoughts about Hugo's documentation 2026年1月25日

  這是我曾經在 Hugo 論壇提起的建議，當時想寫這篇文章的原因是看到文檔正在重構，也正好那段時間自己正在研究撰寫文檔撰寫的知識，因此想說給一點意見，免得重寫之後還是一樣的問題。

• 蘇格拉底式的反問沒有幫助 2026年1月24日

  單看我在論壇上的回應表面上看起來會是我莫名其妙不回應問題，但是看完前因後果我想讀者對是非對錯會更加清楚。為避免不必要的搜尋引擎曝光，本文設定為 noindex，因此搜尋 Hugo 相關內容不可能看到本文，這代表這篇文章是原本就是本部落格的讀者才會看到。

• 20251229 嘗試 Astro 2025年12月29日

  上一篇文章抱怨了一堆還不推薦人家用 Hugo，又在文章裡面建議，Astro 結果自己沒用過那不是很賤嗎？好吧說試就試，選擇最知名的官方主題 Astro Starlight 進行測試。

• 20251229 越來越沒辦法完全的推薦別人使用 Hugo 了 2025年12月29日

  Hugo 要用戶踩過坑才知道的點太多，本文不是普通用戶的設定踩坑文章，是專案維護者的踩坑體驗。

• Hugo 的相關文章演算法 2025年11月15日

  網路上找的到 Hugo 用戶怎麼設定相關文章，但是沒看過有人介紹他的相關文章是怎麼找的，於是本文簡介相關文章的核心邏輯，原始碼在 inverted_index.go，本文撰於 Hugo v0.152.2。

• Hugo 開發的實用知識 2025年11月6日

  本文彙整開發 Hugo 時一定會用到，但是很難在文檔中找到，或是文檔根本就沒寫的知識，主要是在 Hugo 論壇 挖到的資訊。

• Blowfish 今年的超大變化 2025年11月5日

  今年對 Blowfish 做了超多改變，目前我覺得已經把所有問題都解決的差不多了，只剩下 JS 是純 refactor 沒有實質收益，因此暫時不會去改他。這篇文章的目的是記錄 Blowfish 這幾個改版都改了些什麼，在 Hugo 知名主題中這個改變幅度應該算是超級巨大，順帶的讓網路上自定義教學全部過時 XD

• 成為 Blowfish Collaborator 2025年10月9日

  

  在 2025/10/7 成為 Blowfish 主題的 collaborator 啦！

• 如何使用 hugo responsive images 模組 2025年10月5日

  #2523 提到了圖片自動轉檔，自用隨便改是很簡單沒錯，但是維護了一段時間之後現在看到任何 feature request 都覺得怕，一個 feature 後面可是會接著一堆向前兼容、無數的程式碼除錯、用戶抱怨和無止盡的 enhancement request 的，所以 survey 了一下發現確實有人做了圖片轉檔 module，這樣就不用自己寫了。

• Diátaxis Documentation 2025年9月5日
  更新

  對 Diátaxis 有更深的理解了，見我不贊同 Diátaxis 架構

  Hugo 文檔的問題眾所皆知，Hacker News 也有討論這個問題，比如說文檔的這張擷圖，你能找到怎麼安裝 Hugo 嗎？

• 我找到了使用 TailwindCSS 的 Hugo 主題分發的最佳方式 2025年9月4日

  我曾經批評過 Hugo 主題不應該使用 Tailwind，除了使得下游用戶客製化困難外，主題安裝也是個大問題，於是最近稍微整理了一下 Tailwind 主題都是怎麼分發的：

• 主題維護者對 Hugo 的心得雜談 2025年6月16日

  從使用者變成主題維護者，對 Hugo 越來越熟悉，也慢慢了解 Hugo 的設計理念和優勢，所以決定寫一下我的理解，畢竟網路上沒文章在說這些東西，裡面會有很多開發者相關的內容。

• 20250514 記錄一次失敗的提問經驗 2025年5月14日

  Hugo 雖然有顯著的缺點，比如說我在 SSG 比較 這篇文章就說過 Hugo 文檔很糟糕，但是開發者非常熱心的回應，甚至看原始碼找問題是我沒有想到的，然而本文的起因還是來自文檔。

• TIL：設定 Hugo 開發環境，整合 Linter 與程式碼格式化 2025年5月11日

  TIL (today I learned) 是一個新系列，隨手寫今天學到了什麼，今天的內容是設定 Hugo 開發環境。

• 20250502 Blowfish v2.85.1 2025年5月2日

  紀念一下在 Blowfish 連發三個 PR，結果 v2.85.1 這個 release 就只有我一個 contributor 了，ㄎㄎㄎ。

• 在 Hugo 中使用 Shiki 並且加快執行速度超過百倍 2025年4月21日
  在 Hugo 靜態網站中整合 Shiki 語法高亮腳本，實現240倍高效的速度提升，實測三種作法效能差異，從191秒壓到1.88秒，開發階段甚至只要0.8秒。
• 非前端專業的 SSG 使用心得 2025年4月21日
  本文從非前端專業角度，分享作者使用 Hexo, Hugo, Docusaurus, VitePress, MkDocs 等 SSG 的心得與比較，涵蓋優缺點、速度、客製化難度、主題等面向，提供選擇參考。
• Hugo 語法上色 Syntax Highlighter 2024年8月17日

  這是把語法上色從 Hugo 內建的 Chroma 改成 prism.js/highlight.js 又改成 shiki 的心得，網路上你哪裡能找到全部試過一輪的心得呢，想改的原因不外乎就是顏色醜，辨識度低，不好看。

• 20240803 好用的主題也不好找 2024年8月3日

  寫完上一篇的表格之後感到一股火，對比度實在太低了寫到很不爽，又深深感到 blowfish 配色真的是要大改，顯示很不清楚，從問題修復到進階客製化已經改夠多東西了，連基礎的程式語法上色都改成 highlight.js，現在還有表格，之後不知道還會發現多少東西要改，才想到我幹嘛不直接找一個配色正常的主題來用，改 code 就算了調整配色我完全不會啊，而且除了顏色的問題以外，也發現 Blowfish 沒有左側 sidebar 不是很適合作為知識網站使用。

• Hugo Blowfish 主題的客製化 2024年7月1日
  補足各種功能，例如文章存檔頁面、閱讀進度、文章編輯時間。
• Hugo Blowfish 的問題修復 2024年7月1日
  修復 blowfish 相關的功能問題。