文章

網站改版:從 VitePress 搬到 Astro

Astro網站

目錄
  1. 為什麼換掉 VitePress
  2. 程式碼
  3. Mermaid
  4. 接下來

這是新網站的第一篇文章,也是一份功能範例:表格、程式碼、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]

接下來

舊筆記目前都先標成草稿,會陸續整理後重新發佈。