Skip to main content

從 Hexo 遷移到 docusaurus

· 2 min read

更新 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 囉。