T
traeai
登录
返回首页
Tw93(@HiTw93)

Kami V1.6.0

8.2Score

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 漏检而回归

结构提纲

按章节快速跳转。

  1. Kami 新增 Marp Slide Deck Variant,用户可使用单个 .md 文件通过 marp-cli 渲染为 HTML、PDF 或 PPTX。

  2. Marp 主题 CSS 自包含 Kami token 集(parchment、ink-blue、serif rhythm),Kami 构建流程不调用 marp,由用户自行触发。

  3. 新增 5 个 .example 文件用于部署多语言落地页,包括 llms.txt、robots.txt(AI 白名单)、sitemap.xml(hreflang)、vercel.json 等。

  4. 官网支持英文、简中、繁中、日文、韩文五语种,语言切换器自动检测浏览器语言;build.py 脚本行数从 1062 减至 361 并模块化。

  5. 新增 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)。

    Changelog

    ⬇︎ 下载 PNG𝕏 分享到 X
  • build.py 从 1062 行精简至 361 行,拆分为 lint / checks / verify / tokens / optional_deps 五个专注模块,提升可维护性。

    Scripts Split + Real Render CI

    ⬇︎ 下载 PNG𝕏 分享到 X
  • verify-render CI 任务安装 WeasyPrint + Noto CJK 实际渲染 strict-page-count 模板,使页数回归无法再通过仅 lint 的 CI 检测漏过。

    Scripts Split + Real Render CI

    ⬇︎ 下载 PNG𝕏 分享到 X
  • 渲染验证支持 DejaVu / Liberation 字体回退,并引入 KAMI_ALLOW_FALLBACK_ONLY 环境变量,允许 CI 在无商业字体环境下仍能校验页数。

    Robustness & CI Hardening

    ⬇︎ 下载 PNG𝕏 分享到 X
#Kami#Marp#Markdown#CI/CD#多语言
打开原文

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.

AI 可能会生成不准确的信息,请核实重要内容