開頭

上一篇寫完那個表格之後感到一股火，對比度實在太低了寫到很不爽，又深深感到 blowfish 配色真的是要大改，有夠不清楚，從問題修復到進階客製化已經改夠多東西了，連基礎的語法渲染都改成 highlight.js，現在還有表格，之後不知道還會發現多少東西要改，才想到我幹嘛不直接找一個配色正常的模版來用，改 code 就算了調整配色我完全不會啊。除此之外也發現對於知識網站來說 blowfish 沒有左側 list 可以方便查詢。

照慣例要先有需求才有目標，網路上很多文章都沒提到這點。我的需求是：

主要是找 docs 類的主題
右側 ToC 有目前位置 highlight 顯示
左側列表折疊功能而不是進入新網頁
需要解決對比度問題
有基礎設計感，不然我直接寫 latex 不就好了
最好能整合部落格進去，不強求

主題比較

於是找了 awesome-hugo-themes（github上好像滿多 awesome-xxx 的表格可以看的，例如 awesome cloudflare, awesome self-hosted），沒想到這麼多主題沒半個可以，這邊回顧一下這些主題

PaperMod 沒有左側列表
Stack 沒有左側列表
Book 醜，ToC 沒有目前位置
Coder 醜，沒有左側列表
Docsy 醜，ToC 沒有目前位置，左側列表會開啟新網頁
✨ Doks 好看，和 Thulite 同一套系統，feature by Full speed/Max secure
Toha 好看，主要功能感覺是自我介紹的作品集網站，但是 doc 和 blog 功能也做出來了

Doks

看到又快又安全還能不心動嗎，於是選擇了 Doks，然後就遇到各種問題：h1 只能放標題，ToC 只顯示到 h3，npm run dev？我的 hugo server 呢，為甚麼 layouts 裡幾乎啥都沒有？稍微研究才知道他用 npm 管理所有套件，連基礎 layouts 都放在套件包裡面，然後猜猜他到底用了多少個套件：

256個！

太扯了吧，然後我好不容易找到我要改的套件，改老半天發現他的表格一樣對比度低，front matter 不用他限定的直接停機，deploy 問題很多¹，youtube embed 是用 hugo 內建的 iframe² 而不是 npm lite-youtube-embed （都標榜很快套件也 256 個了不捨得用這個==?雖然很好改），甚至連語法渲染都會有 render hook 的問題³，照他的解法還不是絕對成功，連 katex 語法也跟其他人不太一樣（讀不到\footnotesize語法），雖然都能解決但就很麻煩，我是來找現成的不是繼續幫自己搞事的，然後最後一根稻草是井字開頭如果幫他加上數字比如 # 1. xxx ToC highlight 功能直些失效…

其他主題

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