跳至主要内容

2021 部落格搬家到 docusaurus

· 閱讀時間約 2 分鐘

docusaurus v2

過去的「未整理筆記」一直是使用 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 不太一樣,所以還是要簡單調整一下。