Communitygithub.com

khatt

Crée des calligraphies arabes animées (SVG auto-jouable ou page HTML) à partir de textes arabes, persans ou ourdous, et invente de nouveaux effets d’animation. À utiliser pour des calligraphies arabes, des mots ou prénoms animés, des vœux (Ramadan, Aïd, mariage, anniversaire), un logo, un autocollant ou une bannière calligraphiés, ou pour écrire un texte « en calligraphie arabe ».

Qu'est-ce que khatt ?

Khatt est un outil de calligraphie arabe animée qui transforme du texte en arabe, persan ou ourdou en magnifiques animations vectorielles. Il utilise HarfBuzz pour la mise en forme des lettres (liaisons, écriture de droite à gauche, placement des diacritiques) et génère un fichier SVG unique avec des animations purement CSS. L’outil propose douze effets d’animation prêts à l’emploi (encre, or, mosaïque, néon, sable, etc.) et cinq styles de calligraphie (ruqaa, naskh, kufi, nastaliq, kano, blaka) ainsi que plusieurs mises en page (ligne, arc, cercle, miroir). Il s’exécute localement via Node.js sans nécessiter de réseau ni d’installation, et permet même de créer des effets personnalisés en JavaScript. Sa documentation complète, incluse dans le fichier SKILL.md, explique comment l’utiliser en ligne de commande, choisir les options adaptées à différents contextes (vœux, logos, publications sociales) et développer de nouveaux effets tout en garantissant la mise en pause sur n’importe quelle image pour l’export vidéo.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/M-Alkassem/khatt/tree/HEAD/skills/khatt

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Khatt : calligraphie arabe animée

Khatt met en forme le texte avec HarfBuzz (lettres liées, écriture de droite à gauche, diacritiques en place), le dispose et l’anime avec du CSS pur dans un seul fichier SVG. Aucun réseau, aucune installation : le script, ses polices et le moteur de mise en forme se trouvent tous dans ce dossier.

Créer un dessin

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

Exécutez-le depuis le dossier de cette compétence, ou utilisez le chemin complet vers scripts/khatt.mjs. Écrivez la sortie là où l’utilisateur le souhaite (son dossier de projet, son Bureau, …).

OptionValeurs
--styleruqaa (quotidien, incliné), naskh (écriture classique de livre), kufi (angulaire), nastaliq (persan suspendu), kano (gros calame), blaka (géométrique audacieux)
--layoutline, arc, circle (un anneau avec une étoile au centre), mirror (le miroir musanna classique)
--effectink, gold, bleed, mosaic, sand, neon, stars, lantern, rise, stamp, reveal, wave, ou un chemin vers un effet .mjs
--palettepaper, night, neon, zellige, desert, clear (transparent)
--ink, --accent, --bgsurcharge des couleurs, ex. --ink "#0b3d2e" --bg none
--stillfiger sur le dessin terminé (idéal pour logos et impressions)
-o.svg pour le fichier lui-même, .html pour une page qui rejoue au clic

Exécutez node scripts/khatt.mjs --list pour voir toutes les options avec de courtes descriptions. Utilisez \n dans le texte pour une deuxième ligne (jusqu’à quatre lignes).

Bien choisir

  • Noms et mots anglais : Khatt ne dessine que l’écriture arabe. Translittérez d’abord (Sara → سارة, Kamangir → كمنجير) et, lorsque l’orthographe peut varier, montrez votre transcription à l’utilisateur avant le rendu.
  • Ramadan ou Aïd : lantern ou gold avec night, style naskh ou ruqaa.
  • Mariages et cartes formelles : gold, rise ou ink ; essayez --layout mirror.
  • Logos : --still, style kufi ou blaka, --palette clear.
  • Publications sociales : un fichier .svg animé fonctionne partout où un navigateur le peut. Pour une vidéo, orientez l’utilisateur vers le studio (https://m-alkassem.github.io/khatt/), qui exporte en MP4.
  • Les textes courts sont les plus beaux. Phrases longues : mise en page line, deux ou trois lignes.

Ouvrez le résultat pour l’utilisateur quand vous le pouvez (ex. open out.html sur macOS).

Créer un nouvel effet

Lorsqu’aucun des douze effets ne convient (« faire brûler les lettres », « une lanterne de Ramadan qui se balance »), créez-en un nouveau. Partez de examples/ripple.mjs. Un effet est un objet simple, sans import :

export default {
  id: "my-effect", name: "My effect", nameAr: "…", blurb: "…",
  palette: "night",          // identifiant de palette par défaut
  loop: false,               // true s’il continue de bouger
  render(ctx) {
    // return { css, defs?, body, duration, poster? }
  },
};

render(ctx) reçoit :

  • ctx.pieces : une entrée par glyphe : d (chemin SVG), order (ordre de lecture, 0 = première lettre), box {x0,y0,x1,y1}, cx, cy. Les copies en miroir partagent un ordre.
  • ctx.steps, ctx.box (cadre du texte), ctx.view (toile entière), ctx.em (taille de police, 100), ctx.palette (bg, ink, accent), ctx.rng() (aléatoire à graine fixe).
  • ctx.stagger(order, spread?) : décalage pour une lettre, réparti sur spread secondes.
  • ctx.sample(piece, count) : points aléatoires à l’intérieur d’une lettre, pour des particules.
  • ctx.inside(piece, x, y), ctx.area(piece).
  • ctx.anim(name, seconds, { ease, loop, alternate }) : CSS d’animation pour une classe.
  • ctx.at(seconds, extraStyle?) : le style en ligne qui définit le délai d’un élément.
  • ctx.n(number) : arrondit les nombres pour une sortie compacte.
  • ctx.p : un préfixe unique. Utilisez-le pour chaque classe, identifiant et nom d’image clé.

Règles pour que le dessin reste figé sur n’importe quelle image (essentiel pour les images fixes et l’export vidéo) :

  1. Chaque élément animé reçoit class="${p}-a …" et style="${at(seconds)}".
  2. Utilisez ctx.anim(...) dans vos règles de classe. N’écrivez jamais la forme raccourcie animation: et ne définissez pas animation-delay vous-même.
  3. Nommez les images clés ${p}-quelquechose. Ajoutez ${p}-b à un élément pour le redimensionner ou le faire pivoter autour de son propre centre.
  4. N’animez que des propriétés CSS (opacity, transform, stroke-dashoffset, fill-opacity, …). Les animations SMIL <animate> et les scripts ne se figeront pas correctement.
  5. Restez léger : au maximum quelques milliers d’éléments.

Exécutez ensuite :

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

Si l’utilisateur l’apprécie, suggérez-lui de le partager sous forme de pull request sur https://github.com/M-Alkassem/khatt (les effets se trouvent dans src/effects/).

Skills associés