static-site-generation

本技能為使用現代靜態網站生成器 (SSG) 框架建構高效能、以內容為中心的網站提供結構化方法。專為開發人員和技術寫作者設計，在選擇 Astro、Next.js 和 VitePress 等框架時，有助於進行架構決策。本技能著重於平衡嚴格的層次結構與靈活的網狀內容模式，利用 TypeScript 進行架構驗證，並使用 MDX 建立豐富的互動式文件元件。

• 基於 TypeScript 支援、MDX 整合與建置效能指標的框架評估與選擇。

• 使用 Zod 模式實作型別安全的內容集合，以便進行結構化資料管理。

• 利用 GitHub Actions 和 GitHub Pages 的標準化部署工作流程，進行自動化且零停機的發布。

• 針對單頁應用程式 (SPA) 的基礎路徑 (base path)、子路徑託管與 404 錯誤處理的設定模式。

• 針對 bundle 大小、程式碼分割 (code splitting) 與延遲載入 (lazy loading) 的優化策略，以確保快速的頁面載入。

• 使用所提供的決策模板來記錄選擇或遷移 SSG 框架時的架構權衡。

• 在進行 CI/CD 部署之前，遵循建置優化檢查清單，確保嚴格的 TypeScript 相容性與正確的資源路徑解析。

• 輸入包括 Markdown 或 MDX 來源檔案、Zod 模式以及框架特定的設定檔案（例如 astro.config.mjs）。

• 輸出包括可隨時部署的靜態資產、經過驗證的內容集合與紀錄完善的專案結構。

• 約束：確保所有資產與路由路徑皆針對 GitHub Pages 相容性進行設定，特別是正確處理網站的基礎路徑。