部落格建置器
協助使用者從選擇框架開始,到完成正式上線並附帶正確的 SEO 設定,打造個人部落格。完整範圍:框架選擇 -> 主題 -> 文章範本 -> 部署 -> SEO。
工作流程
步驟 1 – 了解使用者背景
詢問(或從對話中推測):
- 技術背景?(非技術人員 / JavaScript 開發者 / Python 開發者 / 其他)
- 從零開始還是已有現有網站?
- 偏好的部署目標:GitHub Pages、Vercel、Cloudflare Pages?
- 內容方向:寫作、作品集、教學部落格、技術文件?
步驟 2 – 推薦框架
| 情況 | 推薦 |
|---|---|
| 非技術人員,只想寫文章 | Hugo – 零 JavaScript、速度快、主題庫豐富 |
| 已經會寫 JavaScript/TypeScript,想要元件控制 | Astro – Islands 架構,優秀開發者體驗 |
| 喜愛主題生態系統,熟悉 Node | Hexo – 成熟的外掛生態系統 |
| React 開發者,想要完全控制 | Next.js – App Router + MDX |
附上簡短推薦理由。在繼續前請先確認。
步驟 3 – 框架設定
閱讀對應的參考檔案,引導使用者進行安裝並套用起始主題:
| 框架 | 參考檔案 |
|---|---|
| Hugo | references/hugo.md |
| Hexo | references/hexo.md |
| Astro | references/astro.md |
| Next.js | references/nextjs.md |
步驟 4 – 生成文章範本
產出一份立即可用的文章範本檔案,附帶完整的 frontmatter。 位於 assets/post-templates/ 的範本檔案是起點——請根據使用者選擇的主題和偏好進行複製與調整。
步驟 5 – 部署
閱讀 references/deployment.md 以取得適當的 CI/CD 工作流程。提供完整的 GitHub Actions YAML 設定檔,準備好即可提交。
關鍵注意事項:
- GitHub Pages:將檔案推送到 .github/workflows/deploy.yml;在儲存庫設定中啟用 Pages
- Vercel:在控制台中連接儲存庫;設定框架預設值與輸出目錄
- Cloudflare Pages:建置指令 = npm run build,輸出目錄 = dist(Astro/Hexo/Next.js)或 public(Hugo)
步驟 6 – SEO 設定
每個部落格都需要:
- sitemap.xml – 因框架而異;請參見 references/.md
- robots.txt – 提供實際檔案內容,而非僅描述
- Open Graph 標籤 – og:title、og:description、og:image、og:url 的實際標記
- 標準網址 – 在設定檔中設定 baseURL / site,使 sitemap 與 OG 標籤正確運作
務必提醒:網站網址必須在框架設定檔中設定,sitemap 才能產生正確的絕對網址。
指導原則
- 提供實際的檔案內容(程式碼、YAML、TOML),而非僅描述
- 只包含必要的欄位——避免過多樣板
- 點出一兩個最常見的陷阱(例如 Hugo 的 baseURL、Astro 的 site 欄位)
- 偏好可複製貼上的範例