feat: 新增 VitePress 电子书网站，部署到 Cloudflare Pages

将笔记转化为精美的 VitePress 静态电子书网站： - site/ 工程目录：构建脚本从 chXX/README.md + .c 源码 + images/ 幂等生成 19 个章节页 + 96 个源码页（每个 .c 独立页面，Shiki 语法高亮） - 构建脚本零依赖，处理 3 种代码链接形态（同章/跨章/绝对URL）+ 110 处图片路径转换，保持原 Markdown 结构不变 - 首页 hero 用 AI 生成的网络主题封面图，配套 favicon 多尺寸 - 中文衬线正文排版 + GitHub 风格代码主题 + 本地全文搜索 - GitHub Actions + wrangler 自动部署到 Cloudflare Pages - 域名 tcp.riba2534.cn 原 chXX/ 目录与根 README 保持不动，网站内容每次构建从源重新生成。
2026-06-30 18:06:04 +08:00 · 2026-06-28 13:20:32 +08:00
parent 5625eea472
commit c6ddea28fe
16 changed files with 3012 additions and 0 deletions
--- a/site/scripts/build.mjs
+++ b/site/scripts/build.mjs
@@ -0,0 +1,199 @@
+// 构建脚本：从仓库源（chXX/README.md + chXX/**/*.c + images/）生成 VitePress 站点内容
+// 幂等：每次先清理生成物再全量生成。零第三方依赖，纯 Node fs/path。
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { CHAPTERS } from '../.vitepress/chapters.mjs'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const REPO_ROOT = path.resolve(__dirname, '../..') // 仓库根
+const SITE_ROOT = path.resolve(__dirname, '..') // site/
+
+const GENERATED_DIRS = CHAPTERS.map((c) => path.join(SITE_ROOT, c.dir))
+const PUBLIC_IMAGES = path.join(SITE_ROOT, 'public/images')
+
+// ---------- 工具 ----------
+function rmrf(p) {
+  fs.rmSync(p, { recursive: true, force: true })
+}
+function mkdirp(p) {
+  fs.mkdirSync(p, { recursive: true })
+}
+// 递归列出目录下所有 .c 文件，返回相对该目录的路径（如 "hello_server.c"、"homework/kehou4.c"）
+function listCFiles(chDir) {
+  const result = []
+  function walk(dir, relBase) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      const full = path.join(dir, entry.name)
+      const rel = relBase ? `${relBase}/${entry.name}` : entry.name
+      if (entry.isDirectory()) walk(full, rel)
+      else if (entry.name.endsWith('.c')) result.push(rel)
+    }
+  }
+  walk(chDir, '')
+  result.sort()
+  return result
+}
+
+// ---------- 步骤 A：清理生成物 ----------
+function clean() {
+  for (const d of GENERATED_DIRS) rmrf(d)
+  rmrf(PUBLIC_IMAGES)
+  mkdirp(path.join(SITE_ROOT, 'public'))
+}
+
+// ---------- 步骤 B：复制图片 ----------
+function copyImages() {
+  const src = path.join(REPO_ROOT, 'images')
+  if (!fs.existsSync(src)) {
+    console.warn(`[warn] 未找到 images 目录: ${src}`)
+    return 0
+  }
+  fs.cpSync(src, PUBLIC_IMAGES, { recursive: true })
+  return fs.readdirSync(PUBLIC_IMAGES).length
+}
+
+// ---------- 步骤 C：生成 .c 源码页 ----------
+function genSourcePages() {
+  let count = 0
+  for (const ch of CHAPTERS) {
+    const chDir = path.join(REPO_ROOT, ch.dir)
+    if (!fs.existsSync(chDir)) {
+      console.warn(`[warn] 章节目录不存在: ${ch.dir}`)
+      continue
+    }
+    const outDir = path.join(SITE_ROOT, ch.dir)
+    mkdirp(outDir)
+    const cFiles = listCFiles(chDir)
+    for (const rel of cFiles) {
+      const code = fs.readFileSync(path.join(chDir, rel), 'utf8')
+      const baseName = path.basename(rel) // hello_server.c
+      const outMd = path.join(outDir, `${rel}.md`) // .../hello_server.c.md 或 .../homework/kehou4.c.md
+      mkdirp(path.dirname(outMd))
+      // 相对返回链接：源码页可能在 homework/ 子目录，需回到章节根
+      const depth = rel.split('/').length - 1
+      const backHref = depth > 0 ? `${'../'.repeat(depth)}` : './'
+      const md = `---
+title: ${baseName}
+sidebar: false
+---
+
+<a class="back-to-chapter" href="${backHref}">← 返回${ch.title}</a>
+
+# ${baseName}
+
+\`\`\`c
+${code}
+\`\`\`
+`
+      fs.writeFileSync(outMd, md)
+      count++
+    }
+  }
+  return count
+}
+
+// ---------- 链接重写 ----------
+// 形态3：绝对 GitHub URL → 相对 clean URL（已验证均同章，但写稳健分支）
+function rewriteGitHubLinks(md, curCh) {
+  const re =
+    /\]\(https:\/\/github\.com\/riba2534\/TCP-IP-NetworkNote\/blob\/master\/([^)]+)\)/g
+  return md.replace(re, (m, p) => {
+    // p 形如 "ch18/thread4.c" 或 "ch18/homework/x.c"
+    const parts = p.split('/')
+    const targetCh = parts[0]
+    const file = parts[parts.length - 1]
+    if (targetCh === curCh) {
+      // 同章：直接文件名（章节页在 chXX/index.md，同目录）
+      return `](${file})`
+    }
+    // 跨章：相对路径
+    return `](../${targetCh}/${file})`
+  })
+}
+
+// 形态1/2：相对链接保持不变（镜像目录结构下天然正确）
+// 但为避免 VitePress 对无扩展名链接报死链，给同章裸 .c 链接加 ./ 前缀
+function normalizeRelativeLinks(md) {
+  // 匹配 ](xxx.c) 但不匹配已带 ./ 或 ../ 或 / 或 http 的
+  return md.replace(/\]\((?!\.\/|\.\.\/|\/|https?:|mailto:|#)([^)]+\.c)\)/g, (m, p) => `](./${p})`)
+}
+
+// 图片路径：](images/ → ](/images/
+function rewriteImages(md) {
+  return md.replaceAll('](images/', '](/images/')
+}
+
+// ---------- 步骤 D：转换章节 README → index.md ----------
+function genChapterPages() {
+  let count = 0
+  for (let i = 0; i < CHAPTERS.length; i++) {
+    const ch = CHAPTERS[i]
+    const srcReadme = path.join(REPO_ROOT, ch.dir, 'README.md')
+    if (!fs.existsSync(srcReadme)) {
+      console.warn(`[warn] 章节笔记不存在: ${srcReadme}`)
+      continue
+    }
+    let raw = fs.readFileSync(srcReadme, 'utf8')
+
+    // D1. 去掉首行 H1（## 第X章 …），由 frontmatter title 接管
+    raw = raw.replace(/^##\s+[^\n]*\n+/, '')
+
+    // D2. 图片路径转换
+    raw = rewriteImages(raw)
+
+    // D3. 代码链接重写
+    raw = rewriteGitHubLinks(raw, ch.dir)
+    raw = normalizeRelativeLinks(raw)
+
+    // D4. 追加"本章源码"附录
+    const chDir = path.join(REPO_ROOT, ch.dir)
+    if (fs.existsSync(chDir)) {
+      const cFiles = listCFiles(chDir)
+      if (cFiles.length > 0) {
+        raw += `\n\n## 本章源码\n\n`
+        for (const rel of cFiles) {
+          const baseName = path.basename(rel)
+          // 章节页在 chXX/index.md，源码页在 chXX/<rel>.md，相对链接加 ./ 前缀
+          raw += `- [${baseName}](./${rel})\n`
+        }
+      }
+    }
+
+    // D5. 注入 frontmatter（title + prev/next）
+    const prev =
+      i > 0
+        ? { text: CHAPTERS[i - 1].title, link: `/${CHAPTERS[i - 1].dir}/` }
+        : { text: '首页', link: '/' }
+    const next =
+      i < CHAPTERS.length - 1
+        ? { text: CHAPTERS[i + 1].title, link: `/${CHAPTERS[i + 1].dir}/` }
+        : null
+
+    const fm = [`---`, `title: ${ch.title}`, `prev:`, `  text: ${prev.text}`, `  link: ${prev.link}`]
+    if (next) {
+      fm.push(`next:`, `  text: ${next.text}`, `  link: ${next.link}`)
+    }
+    fm.push('---', '', `# ${ch.title}`, '')
+
+    const outDir = path.join(SITE_ROOT, ch.dir)
+    mkdirp(outDir)
+    fs.writeFileSync(path.join(outDir, 'index.md'), fm.join('\n') + raw)
+    count++
+  }
+  return count
+}
+
+// ---------- 主流程 ----------
+console.log('▶ 清理生成物...')
+clean()
+console.log('▶ 复制图片...')
+const imgCount = copyImages()
+console.log(`  图片: ${imgCount}`)
+console.log('▶ 生成 .c 源码页...')
+const srcCount = genSourcePages()
+console.log(`  源码页: ${srcCount}`)
+console.log('▶ 转换章节 README...')
+const chCount = genChapterPages()
+console.log(`  章节页: ${chCount}`)
+console.log(`✓ 完成：${chCount} 章 + ${srcCount} 源码页 + ${imgCount} 图片`)