2021 部落格搬家到 docusaurus
· 閱讀時間約 2 分鐘
過去的「未整理筆記」一直是使用 hexo 建置的,hexo 用起來其實非常方便,$ hexo generate -d
基本上就搞定了。大概在去年(2020)年中時接觸到 docusaurus 這套由 Facebook 推出的 docs + blogs 的工具,雖然目前還在 alpha.70 階段,但一用就非常吸引我。
Docusaurus v2 對於 markdown 有高度的支援,除了基本的程式碼高亮外,還可以哪些選擇行號要特別標註。下面列出幾點 docusaurus 特別吸引我的地方:
- 程式碼高亮更方便,可以顯示檔名、標註特定行號
- 和 React 無痛整合,可以用 React 撰寫獨立的頁面,也可以把 React Component 直接透過 mdx 插入文件中
- 可以在 md 中插入 live editor 的功能
- 開源專案可以免費使用 algolia search
- 內建深色和淺色主題
- 部署上很方便,且整合 Github Action 可以自動 CD
- 小恐龍很可愛
- ...
雖然有很多文章需要慢慢搬過來,但好險這些文章本來就都是 markdown,要改動的幅度不算太大,這也是我為什麼一直覺得筆記一定要用 #markdown 寫(搭配 Typora 👍),不要太倚賴其他第三方筆記軟體,因為搬家時會方便許多。
但因為 docusaurus 和 hexo 的 front matter 不太一樣,所以還是要簡單調整一下。