這篇文章宣布一個消息，我使用 Docusaurus 建立建立了一個新的技術部落格網站 Bosh’s Tech Notes，未來技術筆記類型的文章將會在新網站發布。其實很早以前我就開始觀望 Docusaurus 這個 SSG 了，但由於開始注意到 Docusaurus 時，已經使用 Hexo 幾個月，且當下使用 Hexo 也還算滿意的狀態。
由於目前對新站有比較明確的一些想法和目標，近期應該會比較著重於更新與經營新站，本站應該會暫時休耕。不過基於 Hexo 的喜愛還有對這個網站的情懷，本站不會關閉也不會移除原有的文章，目前我也還在摸索最適合自己的做筆記、寫文章方式，目前對於這個網站應該放什麼類型的文章或以什麼方法來寫都還沒有一個明確的想法，但比較確定的是，關於技術筆記類型的文章都會發佈在 Bosh’s Tech Notes 上，歡迎大家一起交流～

以 Docusaurus 建立新的技術筆記網站的原因

一開始建立本站的目的就是想要拿來做技術筆記，同時也想試著建立自己的工程師品牌。但後來發布 Hexo 教學系列文章和 C++ 筆記後我卻有很長一段時間完全把網站放著沒有更新，最主要的原因是對我來說 Hexo 不是一個好的筆記平台，文章在專案資料夾中默認以日期開頭常常讓我很難快速找到要修改編輯的檔案，且所有的文檔都只能放在 _posts 資料夾不能依據分類放在不同資料夾，對於文章分類管理也滿不方便的。 (感謝 Shuai-Xin的更正，在 _posts 中是可以用資料夾分類文檔的。)
站在讀者的角度，要找一個特定主題的文章需要先去分類頁面在進入對應的分類一個一個點選查看的過程就需要經過好幾次的畫面跳轉，其實不是個好的使用者體驗。

因為實在太久沒有更新網站了，前一個月決定將版面換成我喜歡的樣式，順便來培養寫筆記的習慣。但出於上述原因，我發現我潛意識中並沒有辦法把這個部落格當作筆記平台，反而會把它看待成像是 Medium 這類型的專欄，最近的這幾篇文章都不自覺的想要寫得精緻一點，也會不自覺的已與讀者對話的口吻來寫文章。並不是說這樣寫文章不好，但對我這樣文筆匱乏的人來說這樣寫文章真的很花時間，光是花在打磨文字的時間就佔據做筆記的大半時間了，實在是違反當初想要寫技術筆記的初衷。

我的筆記需求

我覺得我會不自覺把這個不落格當作專欄網站來經營的原因在於它的版型真的很精緻漂亮，我的潛意識會一直告訴自己：這麼漂亮的網站就應該配上精緻細心的文章才不會顯得突兀，進而導致想到要寫文章就要花很多時間就更沒動力去寫。
幾個月前偶然發現幾個用 Docusaurus 建立的技術筆記部落格，發現 Docusaurus 幾乎能夠滿足我的所有筆記需求，包括：

  • 側邊欄顯示所有文章名稱
  • 依照資料夾分類的文章管理系統
  • 類似 HackMD 的筆記版型（給人這就是拿來做筆記的平台的感覺）
  • 以 Markdown 編輯
  • 自定義性與可玩性高

在嘗試 Docusaurus 之後，我才發現這才是我理想中最棒的技術部落格版型啊！不僅具有可玩性，而且在上面做筆記的體驗很好，我能夠很自然的用它來寫平常在 Notion 上面做給自己看的那種類型的筆記。雖然我在大約一個月前才花了很多時間來整理我的 Hexo Blog，但還是毅然決然地決定以後都使用 Docusaurus 來發表技術筆記了。

Docusaurus 的優點

  • Category side bar:
    Docusaurus 功能中最吸引我的是 Docs 左側的 side bar。它的版型很像 Gitbook，可以顯示網站內所有文章的分類，文章依照資料夾式的結構摺疊收藏在不同的資料夾中，但它的功能更多也更美觀。此外，每個分類資料夾下面還可以有子分類資料夾，對作者來說更方便管理不同類別的文章，對讀者來說也更方便依照資料夾分類查詢文章。

過去我看自己的 Hexo Blog 時覺得最困擾的點是，讀者沒辦法一次性地看到我的網站裡有哪些文章，我的 Hexo 版面只能在最底層顯示與該文章最相關的 6 篇文章以及在側邊欄顯示最近發佈的幾篇文章，即便網站裡面有其他文章是讀者可能有興趣的，或是其他篇文章跟讀者目前正在閱讀的文章有高度關聯，但如果讀者沒有特別去翻的話可能也不會發現有這些文章可以看。而 Docusaurus 的版面讓讀者有更大的機會發現網站中其他感興趣的文章，這就大大增加讀者停留在我的網站的機會。

  • 以 React 自定義的獨立頁面:
    另一個很吸引我的是，Docusaurus 是基於 React 的 SSG，不僅在 markdown 文件中支援 React 語法，還還支援以 React 建立自己的獨立頁面，這就讓網站有非常大的可玩性，除了可以在同個網站放自己的履歷、作品集，甚至可以直接放一個小專案。而 Hexo 就比較難以完全自定義網站的所有元素，也比較難隨意在網站中任意新增非不落格文章的頁面，且大部分的版型都是由使用的主題決定，自定義樣式的門檻以及成本比較高，因此以 Hexo 建立的部落格通常都長得滿像的。

關於本站未來的一些想法與規劃

不得不說，我真的覺得 Hexo Butterfly 主題的版型很美，好看到讓我沒辦法直接放棄這個網站 XD 雖然我目前還不太確定這個網站接下來要用來發佈什麼樣的文章，但比較肯定的是從寫作動機來說， Bosh’s Tech Notes 的文章主要會是寫給自己看的，而這個網站的文章是寫給別人看的，可能會是針對特定主題的心得或是教學，總之希望這兩個網站可以順利長期更新經營～