Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shuantt/technotes-vitepress

技術筆記站
https://github.com/shuantt/technotes-vitepress

Last synced: 10 days ago
JSON representation

技術筆記站

Awesome Lists containing this project

README 

        
## About 

使用 VitePress 框架，專門整理技術相關內容的筆記站。



## Why use VitePess



### 部落格 和 筆記站分開 的理由

一直覺得部落格並不適合整理技術筆記，常看到部落格有文章零散、缺乏大綱目錄、整理不佳等問題。有些文章也不適合我的學習模式，因為我沒什麼完整的時間，如果遇到主題文章非常長，一時根本看不完，不方便做碎片化學習。也很多人會將主題變系列文，這個部份我很喜歡，但會需要一篇篇點開，這次又缺乏大綱目錄可瀏覽。  

  

對我來說最大的問題，是部落格很雜亂。很多人會將學習筆記都發成貼文，結果點開「Archive 歸檔」，翻好幾頁都是基本語法的學習筆記，根本找不到精煉的內容。可能會有人說，部落格框架都自帶「標籤雲」分類功能可以查阿，但文章究竟該用什麼標籤也讓我煩惱，一篇文要放幾個標籤？標籤怎麼統一？會不會出現像是 vue, Vue, Vue.js ... 最後我可能會崩潰到懶得整理，標籤雲亂成一團。說更難聽的話，一大坨的標籤雲真的不好看，有的會根據篇數變大變小，甚至還不照字母排序! 對有點整理強迫症的人來說真的看得頗痛苦。



做為菜鳥，其實部落格就是自己看爽用的，所以寧可搞事建立一套整理系統，我也要滿足整理強迫症需求 (最近剛從 F 變 T 人，可能也快從 P 人變 J 人了吧)。總之，部落格就要像部落格，多帶點個人化風格；技術筆記則更像技術文件形式，清晰好讀又好整理。對於寫作，給自己的目標是能像 Huli 大一樣有個乾淨整潔的空間 (希望未來的我不要狠打自己的臉)。



### 從 docusaurus 轉到 VitePress 的經過

原本因部落格使用 React，筆記站決定跟著用 docusaurus。但實際規劃主題分類時卻遇到問題，docusaurus 的設計是希望能同時提供「筆記」加「部落格」功能，導覽列只能用預設關鍵字設定 docs/ blog / community，限制我想在導覽列上設置多主題的需求，雖然後來發現用巢狀路由就可以解決了，但家已搬XD，只能說體感上 VitePress 的 config 讀起來更好懂好設定，反正使用 Vue 對我來說一樣很方便，未來也不會想要在筆記站使用 blog 功能，就這麼定案上線。



### 架設方式

因為幾乎開箱即用，就直接貼上 [官方建置說明](https://vitepress.dev/guide/getting-started)，未來如果成功花式客製化，可能再寫一篇分享。