Kami V1.6.0
TL;DR · AI 摘要
Kami V1.6.0 引入 Markdown 优先的 Marp 幻灯片路径,支持单 .md 文件输出 HTML/PDF/PPTX;站点扩展至 5 语言,构建脚本精简至 361 行,并新增渲染验证 CI 任务防止页数回归。
核心要点
- 新增 Marp Slide Deck Variant:通过 marp-cli 将单个 .md 文件渲染为 HTML/PDF/PPTX,主题 CSS 内置 Kam
- 构建脚本 build.py 从 1062 行精简至 361 行,拆分为 lint/checks/verify/tokens/optional_deps 5 个模
- 新增 verify-render CI 任务:安装 WeasyPrint + Noto CJK 实际渲染模板,确保页数不因 lint-only CI 漏检而回归
结构提纲
按章节快速跳转。
Kami 新增 Marp Slide Deck Variant,用户可使用单个 .md 文件通过 marp-cli 渲染为 HTML、PDF 或 PPTX。
Marp 主题 CSS 自包含 Kami token 集(parchment、ink-blue、serif rhythm),Kami 构建流程不调用 marp,由用户自行触发。
新增 5 个 .example 文件用于部署多语言落地页,包括 llms.txt、robots.txt(AI 白名单)、sitemap.xml(hreflang)、vercel.json 等。
官网支持英文、简中、繁中、日文、韩文五语种,语言切换器自动检测浏览器语言;build.py 脚本行数从 1062 减至 361 并模块化。
新增 verify-render CI 任务实际渲染模板以防止页数回归;支持 DejaVu/Liberation 字体回退,并提供 KAMI_ALLOW_FALLBACK_ONLY 开关适配无商业字体环境。
思维导图
用一张图看清主题之间的关系。
查看大纲文本(无障碍 / 无 JS 友好)
- Kami V1.6.0 核心更新
- Markdown 幻灯片路径
- Marp Slide Deck Variant
- 单 .md → HTML/PDF/PPTX
- 自包含 Kami token 主题
- 落地页生产支持
- 5 个 .example 配套文件
- llms.txt / robots.txt / sitemap.xml / vercel.json
- SKILL.md 文档化
- 多语言与构建优化
- 5 语言:EN/ZH-CN/ZH-TW/JP/KO
- build.py 1062→361 行,模块化
- 语言切换器自动检测浏览器语言
- CI 健壮性增强
- verify-render CI 实际渲染
- Noto CJK + 字体回退支持
- KAMI_ALLOW_FALLBACK_ONLY 开关
金句 / Highlights
值得收藏与分享的关键句。
Marp Slide Deck Variant:一个 .md 源文件通过 marp-cli 可渲染为 HTML、PDF 或 PPTX,主题 CSS 自含 Kami token 集(parchment, ink-blue, serif rhythm)。
build.py 从 1062 行精简至 361 行,拆分为 lint / checks / verify / tokens / optional_deps 五个专注模块,提升可维护性。
verify-render CI 任务安装 WeasyPrint + Noto CJK 实际渲染 strict-page-count 模板,使页数回归无法再通过仅 lint 的 CI 检测漏过。
渲染验证支持 DejaVu / Liberation 字体回退,并引入 KAMI_ALLOW_FALLBACK_ONLY 环境变量,允许 CI 在无商业字体环境下仍能校验页数。
Decks now begin in Markdown, and the same quiet rules carry them to PDF, PPTX, or the browser.
Changelog
Marp Slide Deck Variant: a new Markdown-first deck path (EN/CN) under assets/templates/marp/. One .md source renders to HTML, PDF, or PPTX via marp-cli, and the" / X
Kami V1.6.0 Decks now begin in Markdown, and the same quiet rules carry them to PDF, PPTX, or the browser. Changelog Marp Slide Deck Variant: a new Markdown-first deck path (EN/CN) under assets/templates/marp/. One .md source renders to HTML, PDF, or PPTX via marp-cli, and the theme CSS is self-contained, carrying the full Kami token set (parchment, ink-blue, serif rhythm). It joins WeasyPrint HTML-to-PDF (default) and python-pptx (editable) as a third, user-triggered slide path. Kami's own build pipeline does not call marp; users run marp-cli themselves. Landing-Page Production Companion Files: five .example scaffolding files for shipping a generated landing page as a real multilingual site, llms.txt + llms-full.txt for AI assistants, robots.txt with an AI allowlist, sitemap.xml with hreflang, and vercel.json for rewrites and headers. Documented in SKILL.md and packaged in the skill. Site Reaches Five Languages: the official site adds Traditional Chinese and Korean pages alongside English, Simplified Chinese, and Japanese, with a collapsible language switcher that auto-detects the browser language. Scripts Split + Real Render CI: build.py dropped from 1062 to 361 lines, split into focused lint / checks / verify / tokens / optional_deps modules. A new verify-render CI job installs WeasyPrint plus Noto CJK and actually renders the strict-page-count templates, so page-count regressions can no longer slip through lint-only CI. The overflow solver gains end-to-end tests. Robustness & CI Hardening: render verification now accepts DejaVu / Liberation as a serif fallback and adds a KAMI_ALLOW_FALLBACK_ONLY opt-in so CI (which never has commercial fonts) can still gate page counts; the build warns clearly when Pygments is missing; Marp deck visuals tightened.