Skip to main content

從 Hexo 遷移到 docusaurus

· 2 min read

import Mindmap from '@theme/Mindmap'

<Mindmap markdown={`

基於 Docusaurus​

只使用Blog 部分​

優點​

  • 改版容易
  • 基於 React
  • 文章中可自訂或內嵌 Component
  • 支援 Emoji, Mermaid, MarkMap 圖

缺點​

  • 文章網址改變
  • RSS 連結改變 `}/>

更新 blog post 時發現自動 deploy 不運作，原來 Travis CI org 已經不服務了 Orz。

原來用的 hexo 版本也舊了，要更新也得費一番工夫，不如來試試之前考慮過的 Docusaurus 吧。

花了一天做基本的 Docusaurus 設定與文章修正 ✍️，另一天加上自動部署和網站樣式🎨，並加上 Mermaid, Markmap 圖支援後，就倉促上線了⚡️。

改版後一樣是透過 Github hosting + 使用 Markdown 保存文章。

改版的主要差異​

文章網址改變​

雖然這次改版不再相容舊版 Blogger 的設定，網址改變了，但舊文依然保留。 可以透過Tags 查看各標籤分類下的文章。

RSS 連結改變​

從 http://blog.gasolin.idv.tw/feeds/posts/default 改到 https://blog.gasolin.idv.tw/rss.xml

待修正​

  1. 修正文章內連結

根據建議，最好使用關聯檔案路徑（[文章]( 檔案.md )）而非相關連結 （[文章](https://post-url)）。

使用關聯檔案路徑有以下好處：

  • 在 Github 上連結也可以用
  • 可以隨時訂製 document slugs 而不需要更新所有連結
  • 多版本文件時，文件可以正確連到對應的版本
  1. 加回 Disqus 留言評論功能

看來需要進一步修改客製，就先不弄了。有什麼想向我講的就請留言到 https://twitter.com/gasolin 囉。