發布新的筆記和文章網站

發布新的筆記與文章網站。

TL;DR

新網站： https://huanlin.cc 

或者用 https://huanlin.cc/docs 直接進入文章入口。

說明

為了替未來可能會用到的兩個技術文件需求預作準備，我註冊了一個新的網域 huanlin.cc，一方面作為練習和實驗，一方面也可能正式成為我的第二個筆記網站。這兩個需求是：

1. 多版本 API 文件切換。
2. 多國語系切換。

基於以上需求，之前試過 Docusaurus，也試過 MkDocs 搭配 Material theme，感覺都不錯。不過，最後嘗試了 Hugo + Docsy theme，花了不少時間微調樣式，我想就不再換了。

這個新搭建的筆記和文章網站的 URL 是 https://huanlin.cc。如果要跳過 landing page，直接進入文件首頁的話，則是這個網址：https://huanlin.cc/docs。

最近幾個星期以來，我為 huanin.cc 持續添加了文件和筆記，主要是從兩個地方搬過來：

1. 我原先寫的 C# 筆記。
2. 原本用 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!