Kami V1.6.0
TL;DR · AI Summary
Kami V1.6.0 introduces a Markdown-first Marp slide path, enabling single .md files to render to HTML/PDF/PPTX; the site now supports 5 languages, build script reduced to 361 lines, and a new render-verification CI job prevents page-count regressions.
Key Takeaways
- New Marp Slide Deck Variant: one .md file renders to HTML/PDF/PPTX via marp-cli,
- build.py reduced from 1062 to 361 lines and split into 5 focused modules: lint /
- New verify-render CI job installs WeasyPrint + Noto CJK and renders strict-page-
Outline
Jump quickly between sections.
Kami adds Marp Slide Deck Variant, allowing users to render a single .md file to HTML, PDF, or PPTX via marp-cli.
The Marp theme CSS is self-contained with Kami token set (parchment, ink-blue, serif rhythm); Kami’s pipeline does not invoke marp—users run marp-cli manually.
Five .example scaffolding files added for deploying multilingual landing pages: llms.txt, robots.txt (AI allowlist), sitemap.xml (hreflang), vercel.json, documented in SKILL.md.
Official site now supports EN, ZH-CN, ZH-TW, JP, and KO with auto-detect language switcher; build.py shrinks from 1062 to 361 lines and is modularized.
A new verify-render CI job renders templates with WeasyPrint + Noto CJK to prevent page-count regressions; fallback fonts (DejaVu/Liberation) and KAMI_ALLOW_FALLBACK_ONLY opt-in improve CI reliability
Mindmap
See how the topics connect at a glance.
查看大纲文本（无障碍 / 无 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
Key sentences worth saving and sharing.
Marp Slide Deck Variant: one .md source renders to HTML, PDF, or PPTX via marp-cli, with theme CSS embedding the full Kami token set (parchment, ink-blue, serif rhythm).
build.py reduced from 1062 to 361 lines and split into five focused modules: lint, checks, verify, tokens, optional_deps—improving maintainability.
The verify-render CI job installs WeasyPrint + Noto CJK and actually renders strict-page-count templates, ensuring page-count regressions no longer slip through lint-only CI.
Render verification now accepts DejaVu / Liberation as serif fallback and adds KAMI_ALLOW_FALLBACK_ONLY so CI (lacking commercial fonts) can still gate page counts.
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.