發布新的筆記與文章網站。
TL;DR
新網站: https://huanlin.cc
或者用 https://huanlin.cc/docs 直接進入文章入口。
說明
為了替未來可能會用到的兩個技術文件需求預作準備,我註冊了一個新的網域 huanlin.cc,一方面作為練習和實驗,一方面也可能正式成為我的第二個筆記網站。這兩個需求是:
- 多版本 API 文件切換。
- 多國語系切換。
基於以上需求,之前試過 Docusaurus,也試過 MkDocs 搭配 Material theme,感覺都不錯。不過,最後嘗試了 Hugo + Docsy theme,花了不少時間微調樣式,我想就不再換了。
這個新搭建的筆記和文章網站的 URL 是 https://huanlin.cc。如果要跳過 landing page,直接進入文件首頁的話,則是這個網址:https://huanlin.cc/docs。
最近幾個星期以來,我為 huanin.cc 持續添加了文件和筆記,主要是從兩個地方搬過來:
- 我原先寫的 C# 筆記。
- 原本用 MkDocs + Material theme 搭建的「DevOps 小學堂」網站,我也把那個網站裡面的文章遷移到 huanlin.cc 了。(所以原先的「DevOps 小學堂」網站將會關閉)
另外,我也在 huanlin.cc 上面寫了一點英文筆記,除了用來實際體驗任意切換語系的功能,也當作自己練習英文寫作的機會。
我的 Docsy 自訂樣式與擴充
Docsy 雖然有許多現成的使用案例,包括 kubernetes 官方文件、kubeflow 等等,但預設的樣式風格實在不怎麼討喜,總覺得有點枯燥乏味。所以我四處尋找客製化的範例和解決方案,逐漸調整出我自己想要的網站風格。
主要還是受到先前搭建 「DevOps 小學堂」網站的影響吧。我蠻喜歡 Material for MkDocs 的設計,所以在調整 huanlin.cc 網站樣式的時候,最初的目標是希望做出風格類似先前的「DevOps 小學堂」網站的樣子。目前已經大致完成,文件入口的頁面看起來像這樣:
這個新網站也是架在 Github 平台,但我沒有開放 repository。如果你有興趣了解我對 Docsy 預設樣板做了哪些自訂調整和擴充,可以參考這篇筆記:網站版面樣式修改記錄。裡面有提及一個公開的 GitHub repo,我把所有客製化的檔案都擺進去了,可直接取用。
另外,我還有一些 Hugo 和 Docsy 筆記是用英文撰寫,也是放在新網站:Hugo & Docsy。
心得感想
對於像我這樣一個不熟悉前端技術的人來說,調整網站風格直到我滿意的樣子,意外地花了我好多時間。常常為了調整一個小地方(例如 padding 或 margin 增加或縮小幾點),不知不覺已經過了幾十分鐘(其中一些時間花在找出 Docsy 的「機關」)。
幾年前,我就曾經嘗試搬遷部落格,主要原因是 Google Blogger 平台沒辦法用 Markdown 撰寫。後來因為某些原因(我忘了 XD)而放棄,又回到這個部落格繼續發布筆記,但其實後來已經逐漸轉變成這樣的流程:先寫 Markdown,然後把生成的 HTML 貼到這個部落格來發布。
這次花了更多時間來建立新網站,希望就此大致底定,不再對網站樣式東改西改了。(不然正事都甭做啦!)
Keep learning!
沒有留言: