Communitygithub.com

Khatt:阿拉伯文动画书法

将阿拉伯语、波斯语或乌尔都语文本生成为自带动画的SVG或HTML页面,自动应用书法效果和动画。适合制作阿拉伯书法、动画单词、节日祝福(斋月、开斋节、婚礼、生日)、书法标志、贴纸或横幅。

Khatt:阿拉伯文动画书法 是什么?

Khatt 是一个专注于阿拉伯文动画书法的 AI 辅助工具。它利用 HarfBuzz 引擎进行文本塑形(连字、从右向左排列、标记定位),并将结果以纯 CSS 动画的形式嵌入单个 SVG 文件中。该工具完全离线运行——脚本、字体和塑形引擎都包含在本地文件夹中,无需安装或网络连接。支持从命令行调用并提供丰富的样式参数:包括 ruqaa、naskh、kufi 等六种书法风格;line、arc、circle、mirror 四种排版布局;以及 ink、gold、neon、stars 等十二种动画效果。用户还可以通过编写自定义效果模块(JavaScript 对象)来扩展动画能力。最终输出可以是自播放的 SVG 文件或点击重播的 HTML 页面,并支持输出为静态图像用于标志和印刷。Khatt 特别适合快速生成阿拉伯语、波斯语或乌尔都语的艺术书法作品,广泛运用于节日贺卡、社交媒体帖子、品牌标志设计等场景。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/M-Alkassem/khatt/tree/HEAD/skills/khatt

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Khatt:阿拉伯文动画书法 是做什么的?

Khatt 使用 HarBuz 对文本进行塑形(连字、从右向左排列、标记定位), 将文本布局并利用纯 CSS 在单个 SVG 文件中实现动画效果。无需网络,无需安装: 脚本、字体和塑形引擎都位于此文件夹中。

创建绘图

node scripts/khatt.mjs "النص" --style ruqaa --layout line --effect ink -o out.svg

从本技能文件夹运行,或使用 scripts/khatt.mjs 的完整路径。 将输出文件写入用户指定的位置(如项目文件夹、桌面等)。

选项值
--styleruqaa(日常斜体)、naskh(经典书体)、kufi(角形)、nastaliq(波斯悬垂体)、kano(粗笔触)、blaka(粗体几何)
--layoutline、arc、circle(环形带星)、mirror(经典镜像 musanna)
--effectink、gold、bleed、mosaic、sand、neon、stars、lantern、rise、stamp、reveal、wave,或 .mjs 效果文件路径
--palettepaper、night、neon、zellige、desert、clear(透明)
--ink、--accent、--bg覆盖颜色,例如 --ink "#0b3d2e" --bg none
--still冻结在完成绘图上(适用于标志和印刷)
-o.svg 生成文件本身,.html 生成页面(点击重播)

运行 node scripts/khatt.mjs --list 查看所有选项及简要说明。 在文本中使用 \n 表示换行(最多四行)。

选择建议

  • 人名和英文单词: Khatt 仅绘制阿拉伯文字符。请先音译(Sara → سارة、Kamangir → كمنجير),当拼写有多种可能时, 在渲染前向用户展示你所用的拼写。
  • 斋月或开斋节: 使用 lantern 或 gold 配合 night,风格 naskh 或 ruqaa。
  • 婚礼和正式卡片: 使用 gold、rise 或 ink;尝试 --layout mirror。
  • 标志: 使用 --still,风格 kufi 或 blaka,--palette clear。
  • 社交媒体帖子: 动画 .svg 可在任何浏览器中播放。如需视频, 请引导用户访问工作室(https://m-alkassem.github.io/khatt/),它支持导出 MP4。
  • 短文本效果最佳。长句子:使用 line 布局,两到三行。

如果可能,请为用户打开结果文件(例如 macOS 上运行 open out.html)。

创建新效果

当现有十二种效果都不适用时(例如“让字母燃烧”、“一个摇摆的斋月灯笼”),可以编写新效果。 从 examples/ripple.mjs 开始。一个效果是一个不带导入的普通对象:

export default {
  id: "my-effect", name: "My effect", nameAr: "…", blurb: "…",
  palette: "night",          // 默认调色板 ID
  loop: false,               // 如果持续运动则为 true
  render(ctx) {
    // 返回 { css, defs?, body, duration, poster? }
  },
};

render(ctx) 接收:

  • ctx.pieces:每个字形的条目:d(SVG 路径)、order(阅读顺序,0 = 第一个 字母)、box {x0,y0,x1,y1}、cx、cy。镜像副本共享相同的 order。
  • ctx.steps、ctx.box(文本框)、ctx.view(整个画布)、ctx.em(字体大小,100)、 ctx.palette(bg、ink、accent)、ctx.rng()(种子随机数)。
  • ctx.stagger(order, spread?):字母的延迟,在 spread 秒内分布。
  • ctx.sample(piece, count):字母内部的随机点,用于粒子效果。
  • ctx.inside(piece, x, y)、ctx.area(piece)。
  • ctx.anim(name, seconds, { ease, loop, alternate }):为某个类生成动画 CSS。
  • ctx.at(seconds, extraStyle?):设置元素延迟的内联样式。
  • ctx.n(number):四舍五入数字以生成紧凑输出。
  • ctx.p:唯一前缀。用于每个类、ID 和关键帧名称。

保持绘图在任意帧可暂停的规则(静态图像和视频导出依赖于此规则):

  1. 每个动画元素都有 class="${p}-a ..." 和 style="${at(seconds)}"。
  2. 在类规则中使用 ctx.anim(...)。永远不要自己写 animation: 简写形式 或设置 animation-delay。
  3. 命名关键帧为 ${p}-something。如需将元素围绕其中心缩放或旋转, 添加 ${p}-b 类。
  4. 仅动画化 CSS 属性(opacity、transform、stroke-dashoffset、 fill-opacity 等)。SMIL <animate> 和脚本无法正确冻结。
  5. 保持轻量:最多几千个元素。

然后运行:

node scripts/khatt.mjs "نار" --effect ./my-effect.mjs -o fire.html

如果用户喜欢,建议他们将其作为拉取请求提交到 https://github.com/M-Alkassem/khatt(效果文件位于 src/effects/)。

相关技能