專案簡介
TechHub 是一份持續成長的個人技術知識庫,基於 VitePress 建置,用 Markdown 累積所有學習內容,一鍵部署為靜態網站。
站點定位
彙整多種技術內容,一站式瀏覽:
| 板塊 | 路徑 | 內容 |
|---|---|---|
| 技術文件 | /frontend/ /backend/ /languages/ /ai/ | 各技術領域的知識筆記 |
| 學習路徑 | /paths/ | 從零到一的學習路線圖 |
| 過程記錄 | /journals/ | 學習日誌、踩坑與專案復盤 |
| 讀書筆記 | /books/ | 書籍精讀筆記 |
| 文獻收藏 | /papers/ | 論文閱讀筆記 |
| 專案文件 | /project/ | 本站自身的建置與維護文件 |
技術棧
- 建置:VitePress 1.x(Vue 3 + Vite)
- 搜尋:內建本機全文搜尋
- 部署:
scripts/deploy.mjs一鍵發布到騰訊雲 COS + CDN(含版本備份 / 回滾 / 自動刷新) - 託管:GitHub
0end1/docs-site
快速上手
bash
npm install # 安裝依賴
npm run docs:dev # 本機開發(http://localhost:5173)
npm run docs:build # 建置靜態網站(docs/.vitepress/dist)
npm run deploy # 發布到線上(需設定 .env,見部署發布)內容規範
- 技術文件依領域歸檔在
docs/對應目錄,一篇一頁,聚焦單一主題; - 每頁頂部使用 Frontmatter 宣告
title/description/tags; - 學習記錄類內容遵循各領域首頁的「寫作規範」範本;
- 新增頁面後同步登記到
docs/.vitepress/config.mjs的導覽與側邊欄。