開頭

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

照慣例要先有需求才有目標，網路上很多文章都沒提到這點。作為個人知識庫來說，我的需求是：

• 主要是找文檔類的主題
• 右側 ToC 顯示文章內閱讀進度
• 左側側邊欄顯示多篇文章的閱讀近讀
• 配色鮮明，沒有對比度問題
• 有設計感，不然我直接寫 latex 不就好了
• 最好能整合部落格功能

主題比較

於是在 awesome-hugo-themes 上面尋找，沒想到這麼多主題沒半個可以，這邊回顧一下這些主題

1. PaperMod 沒有左側邊欄
2. Stack 沒有左側邊欄
3. Book 醜
4. Coder 醜，沒有左側邊欄
5. Docsy 醜
6. ✨ Doks 好看，和 Thulite 同一套系統，feature by Full speed/Max secure
7. Toha 好看，主要功能是自我介紹的作品集網站，但是也支援文檔和部落格功能

Doks

看到又快又安全還能不心動嗎，於是選擇了 Doks，然後就遇到各種問題：npm run dev？我的 hugo server 呢，為甚麼 layouts 裡幾乎啥都沒有？稍微研究才知道 npm 這個套件管理器，但是連基礎 layouts 都放在套件包裡面，然後總共用了**256個套件…**太扯了吧，然後好不容易找到我要改的套件，改老半天發現 Doks 的表格一樣對比度低，front matter 不用他限定的直接停機，網站部署的問題很多¹，youtube embed 是用 hugo 內建的 iframe² 而不是 youtube lite 套件（都標榜很快套件也 256 個了不捨得用這個==?雖然很好改），甚至連渲染都會有 render hook 的問題³，照他的解法還不是絕對成功，katex 語法也跟其他人不太一樣（讀不到 \footnotesize 語法），雖然都能解決但就很麻煩，我是來找現成的不是繼續幫自己搞事的，然後最後一根稻草是井字開頭如果幫他加上數字比如 # 1. xxx ToC highlight 功能直接失效…於是放棄 Doks。

其他主題

一開始沒找其他 Docs 主題的原因是上千星星的主題問題都一堆了，找那些名不見經傳的更可怕，不過寫這篇的同時看了一下，例如 hugo-theme-bootstrap 還算符合需求就是設計有點花俏，hextra 和 docura 感覺也還不錯，果然寫作還是能帶來一些好處，不然根本放棄了不會去看這些幾百星星的主題，不過有空再看看吧，暫時懶得改了。

心得

使用主題的 shortcode 時，盡量只用幾個常見的例如 expand (details), alert (info) 之類，嘗試遷移到 Doks 浪費很多時間在刪這些。之後 blowfish 應該是當作這種碎碎念部落格，資訊類型的文章乖乖放在文檔類型的主題。