Skip to content

feat(readme): README 重做为简体中文衍生版定位#22

Merged
fancyboi999 merged 4 commits into
mainfrom
feat/readme-zh-derivative
Jun 9, 2026
Merged

feat(readme): README 重做为简体中文衍生版定位#22
fancyboi999 merged 4 commits into
mainfrom
feat/readme-zh-derivative

Conversation

@fancyboi999

Copy link
Copy Markdown
Owner

改动

把中文仓 README 从「翻译版」升级为「简体中文衍生版」定位,差异化呈现本地化价值:

  • banner/slogan 中文化 + 新增「在线阅读 aieng-zh.cn」badge,badge 顺序整理
  • 新增「这个中文版做了什么」特性表(全站中文 / 独立网站 / 为 AI 检索优化 / 课数护栏)
  • 新增目录导航行 + 6 处章节标题中文化(How this works→怎么运作 等)
  • 表格表头中文化(写入路径、你的背景·从哪开始·预计时间、hours→小时)
  • 修正过时数字:作品 435→近 500、技能 378→388

验证

  • 数字按 site/build.js 口径核准:503 课、388 技能(skill-*.md)、99 提示词(prompt-*.md)、outputs 493 均属实
  • TRANSLATION.md 存在、8 个目录锚点全部命中、4 语言(py595·ts129·rs10·jl20)说法属实
  • 纯 README 文档改动,不涉及课程内容 / 站点代码

把中文仓 README 从「翻译版」升级为「简体中文衍生版」定位,差异化呈现本地化价值:
- banner/slogan 中文化 + 新增「在线阅读 aieng-zh.cn」badge,badge 顺序整理
- 新增「这个中文版做了什么」特性表(全站中文 / 独立网站 / AI 检索优化 / 课数护栏)
- 新增目录导航行 + 6 处章节标题中文化(How this works→怎么运作 等)
- 表格表头中文化(写入路径、你的背景·从哪开始·预计时间、hours→小时)
- 修正过时数字:作品 435→近 500、技能 378→388

数字按 site/build.js 口径核准:503 课、388 技能(skill-*.md)、99 提示词
(prompt-*.md)、outputs 493 均属实;TRANSLATION.md / 8 个目录锚点 /
4 语言(py595·ts129·rs10·jl20)说法均验证无误。
@vercel

vercel Bot commented Jun 9, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ai-engineering-from-scratch-zh Ready Ready Preview, Comment Jun 9, 2026 7:51am

- 「课程的结构」flowchart:20 个 phase 节点中文化(用 README 目录官方译名)
- 「一节课的样子」flowchart:六节拍中文化(问题背景/核心概念/动手构建/
  实际使用/拿去用,与课程正文 zh.md 章节一致;MOTTO→主旨)
- stars badge URL 加 cacheSeconds=21600:强制 GitHub camo 重新抓图,绕过
  shields.io 偶发限流被缓存的「Unable to select token from pool」坏图

课数校验通过(503/20,Contents 表格未受影响)。
根因:init 里的 fontFamily:'JetBrains Mono' 是英文等宽字体、无中文字形,
GitHub 渲染 mermaid 时用它测量节点宽度,测中文偏窄→节点画得过窄→中文
(尤其较长的 <sub> 副标题)溢出被裁切("一句话核心理念"被截成"…核心理")。

去掉 fontFamily/fontSize,让 mermaid 用默认 sans 字体栈正确测量中文宽度。
颜色主题(primaryColor/borderColor/lineColor)保留不变。
接上一刀。去掉 JetBrains Mono 后主标题已正常、带空格的副标题也能撑开,
但纯中文的 <sub> 副标题仍被裁切——根因是 mermaid 对 <sub> 标签内文本
宽度算不准、不给节点撑宽,加上中文无空格不能自动断行,于是溢出。

把 <sub>...</sub> 降为普通的第二行文本(<br/> 保留换行,文字全保留,
仅不再小字号),mermaid 即可按副标题实际宽度撑宽节点。
@fancyboi999 fancyboi999 merged commit e26445a into main Jun 9, 2026
3 checks passed
@fancyboi999 fancyboi999 deleted the feat/readme-zh-derivative branch June 9, 2026 09:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant