k1dav

S.Feng 的技術筆記與部落格，使用 Docusaurus 3 建置，透過 GitHub Actions 部署到 GitHub Pages，網址為 https://www.k1dav.fun。

開發

npm install
npm start        # http://localhost:3000
npm run build    # 輸出到 build/

內容結構

路徑	說明
docs/intro.md	Wiki 首頁
docs/playbooks/	DevOps / 基礎設施實作手冊（由 Obsidian 匯入）
docs/notes/	技術名詞筆記（由 Obsidian 匯入）
docs/tutorials/	系列教學
blog/	部落格文章
src/components/Evenly/	平平記帳共用產品頁版型與中英文文案
src/pages/evenly.tsx	中文產品頁 /evenly
src/pages/evenly/en.tsx	英文產品頁 /evenly/en

從 Obsidian 同步筆記

node scripts/import-obsidian.mjs ~/data/obsidian

腳本只匯入 10 - Playbooks 與 05 - Notes，會：

• 轉換 [[wikilink]] 與 ![[圖片]]，並複製附件
• 排除含客戶 / 公司內部資訊的筆記與截圖（見腳本中的 EXCLUDE、EXCLUDE_IMAGES）
• 遮蔽公司內部網域（REDACT）

新增筆記後請先檢查 diff 是否有敏感資訊再 commit。 docs/playbooks、docs/notes 每次執行都會整個重建，請不要直接在那裡改內容。

部署

push 到 main 後由 .github/workflows/gh-pages.yml 自動 build 並部署；PR 只會跑 build 檢查。

自訂網域由 static/CNAME（www.k1dav.fun）設定；主網域 k1dav.fun 不指向此站。