Hugo 的問題
- Hugo 的問題根源
我不斷重申過多次文檔問題,請注意我不是路邊隨便一個普通用戶,我是一個自己使用 Hugo 架站,又維護一個知名主題,自己還額外寫了三個 Hugo 主題的人,文檔的問題從我第一天使用 Hugo 到我維護主題,開新主題,這問題之於我從 noob 到 developer 階段都不斷重複遇到。
- Thoughts about Hugo's documentation
這是我曾經在 Hugo 論壇提起的建議,當時想寫這篇文章的原因是看到文檔正在重構,也正好那段時間自己正在研究撰寫文檔撰寫的知識,因此想說給一點意見,免得重寫之後還是一樣的問題。
- 蘇格拉底式的反問沒有幫助
單看我在論壇上的回應表面上看起來會是我莫名其妙不回應問題,但是看完前因後果我想讀者對是非對錯會更加清楚。為避免不必要的搜尋引擎曝光,本文設定為 noindex,因此搜尋 Hugo 相關內容不可能看到本文,這代表這篇文章是原本就是本部落格的讀者才會看到。
- 20251229 越來越沒辦法完全的推薦別人使用 Hugo 了
Hugo 要用戶踩過坑才知道的點太多,本文不是普通用戶的設定踩坑文章,是專案維護者的踩坑體驗。
- 20251019 放下工程師心理
應該放下工程師心理,不是想解決問題,而是想這個組織有沒有能力、想不想解決問題,要出事也是一群人一起出事,人多勢眾至少不是只有自己死。
- 20251019 三明治說話法
人類應該要發明一個三明治說話法(compliment sandwich)產生器,這樣就可以免去 50% 的煩惱和時間浪費。
- 我找到了使用 TailwindCSS 的 Hugo 主題分發的最佳方式
我曾經批評過 Hugo 主題不應該使用 Tailwind,除了使得下游用戶客製化困難外,主題安裝也是個大問題,於是最近稍微整理了一下 Tailwind 主題都是怎麼分發的:
- 20250514 記錄一次失敗的提問經驗
Hugo 雖然有顯著的缺點,比如說我在 SSG 比較 這篇文章就說過 Hugo 文檔很糟糕,但是開發者非常熱心的回應,甚至看原始碼找問題是我沒有想到的,然而本文的起因還是來自文檔。