Skip to main content

網站搬家

· 3 min read
Simone
Front-End Developer

這篇想紀錄一下把網站從 docsify 搬到 docusaurus的過程。

最早最早想做這個網站的時候,主要只是想找個地方放自己的學習筆記。所以目的很單純:

  • 不需要 SEO,因為只有自己需要看
  • 有個地方可以存自己的筆記
  • 有分類的功能
  • 不管從哪台電腦都可以編輯自己的筆記
  • 有很多備份,不會不見

最一開始是選擇 HackMD 來當作存筆記的地方,剛好也符合上述的需求,但是隨著轉職中自學階段的筆記數量越來越多,到現在轉成功之後,覺得 HackMD 雖然可以一次匯出所有筆記,下載備份到電腦裡,但不會有資料夾的分類,會一次下載一包,這個部份是讓我比較困擾的地方。

為了解決上述的問題,所以之後選擇了用 GitHub + docsify,這個方式蠻好的符合了原本的需求,也解決了在 HackMD 上面遇到的問題,用了 git 簡直如魚得水。

但直到最近又有了新的想法,在公司用了 docusaurus 之後,發現與 docsify 相比, docusaurus 的客製化程度非常高:

  • 雖然目前沒有打算優化 SEO,但用了 docusaurus 之後,可以將優化 SEO 這件事放入未來優化的考量
  • 分類功能較進階,比較符合日後筆記越來越多的分類需求
  • 預設的模版就蠻好用了,要更進階也可以
  • 除了 markdown,也可以寫 mdx、react,可以高度客製化自己的筆記
  • 本來就是在 react 生態圈當中的我,用起來沒有任何困擾
  • docusaurus 官方文件寫得還不錯,遇到問題也不太會找不到解答

基於以上幾個理由,於是就趕快先趁筆記還不多的時候,先把網站搬家到 docusaurus 了。

當然 docusaurus 還有我最喜歡的功能(雖然很普通啦XD):

note
info
tip
caution
danger
Toggle me!
This is the detailed content

Nested toggle! Some surprise inside...

😲😲😲😲😲