網站改版:從 VitePress 搬到 Astro
這是新網站的第一篇文章,也是一份功能範例:表格、程式碼、mermaid 圖在這裡都看得到效果。
為什麼換掉 VitePress
VitePress 很適合寫文件,但當它變成 blog,標籤、分頁、RSS 都得自己實作。Astro 的 Content Collections 則內建了這些需要:
| 需求 | VitePress | Astro |
|---|---|---|
| frontmatter 驗證 | 無 | schema 驗證,錯了 build 失敗 |
| RSS | 自己組 XML | @astrojs/rss |
| 文章頁 JS | 每頁載入 Vue | 預設零 JS |
程式碼
文章的 frontmatter 規則定義在 src/content.config.ts:
const schema = z.object({
title: z.string(),
date: z.coerce.date(),
tags: z.array(z.string()).default([]),
draft: z.boolean().default(false),
});
Mermaid
直接寫 mermaid 程式碼區塊,瀏覽器端會自動畫成圖:
flowchart LR
A[寫 Markdown] --> B[git push]
B --> C[Cloudflare build]
C --> D[stevnliao.com]
接下來
舊筆記目前都先標成草稿,會陸續整理後重新發佈。