把真正理解过的东西留下来

03

内容如何发布

网站没有数据库或 CMS。内容以源文件保存，Node.js 脚本提取元数据生成列表，再由 Next.js 构建成静态页面发布。

1. 01

   撰写中文

   MDX / JSON

2. 02

   翻译英文

   LLM + 校对

3. 03

   生成索引

   generate:all

4. 04

   静态构建

   Next.js → out/

5. 05

   发布

   GitHub → Vercel

1. 01

   先人工写中文

   文章、速查和页面文案通常先写中文。文章使用目录名作为 slug；速查使用 metadata.slug，文件名可以不同。翻译版本共用对应的 URL slug。

   • —文章：src/content/zh-cn/articles/{slug}/index.mdx
   • —Cheatsheet：src/content/zh-cn/cheatsheets/{topic}/{article}.mdx
   • —页面文案：src/i18n/messages/zh-cn/{namespace}/index.json
2. 02

   英文由 LLM 翻译，再人工校对

   中文定稿后复制到英文目录，再用程序、agent 或 chatbot 翻译。LLM 只提供初稿；代码、命令、链接、事实和术语仍需人工检查。

   • —不翻译 id、slug、代码和 URL；翻译标题、摘要、正文和可见标签。
   • —未完成的内容使用 _draft 前缀或暂不创建；完成翻译后重新生成索引。
3. 03

   用 Node.js 从源文件提取元数据，生成列表

   pnpm generate:all 会扫描 MDX 里的 export const metadata，以及工具 / Explore 的 meta JSON，写出各语言的 list.json，供首页和列表页渲染。没有使用 MDX formatter 或 CMS 来生成列表，因为 JSON 更容易控制字段结构，中英文也更容易对齐。

   • —文章索引按日期倒序；工具和 Explore 元数据保留 sort 字段，展示排序由页面实现决定。
   • —list.json 和 src/generated/* 是生成结果，不要手改，下次生成会被覆盖
4. 04

   构建静态站点并发布

   pnpm build 会先跑 generate:all，再让 Next.js 把所有语言和路径预渲染到 out/。提交到 GitHub 后，Vercel 按仓库设置构建并发布静态产物。

   • —提交前可用 pnpm routes:list 确认中英文 URL 都已生成

• —网站没有数据库或后台 CMS。栏目由目录结构决定，标题、日期、摘要和排序由文件中的 metadata 决定。
• —metadata 必须是可序列化的字面量，不能调用函数或引用外部变量，否则生成脚本无法提取。

04

多语言如何实现

这是自研的轻量方案，没有使用 next-intl。英文和简体中文页面都在构建时预先生成，不是浏览器里即时翻译。

05

托管与外部服务

以下是网站当前使用的主要服务。