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, …).
| Option | Valeurs |
|---|---|
--style | ruqaa (quotidien, incliné), naskh (écriture classique de livre), kufi (angulaire), nastaliq (persan suspendu), kano (gros calame), blaka (géométrique audacieux) |
--layout | line, arc, circle (un anneau avec une étoile au centre), mirror (le miroir musanna classique) |
--effect | ink, gold, bleed, mosaic, sand, neon, stars, lantern, rise, stamp, reveal, wave, ou un chemin vers un effet .mjs |
--palette | paper, night, neon, zellige, desert, clear (transparent) |
--ink, --accent, --bg | surcharge des couleurs, ex. --ink "#0b3d2e" --bg none |
--still | figer 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 :
lanternougoldavecnight, stylenaskhouruqaa. - Mariages et cartes formelles :
gold,riseouink; essayez--layout mirror. - Logos :
--still, stylekufioublaka,--palette clear. - Publications sociales : un fichier
.svganimé 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 surspreadsecondes.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) :
- Chaque élément animé reçoit
class="${p}-a …"etstyle="${at(seconds)}". - Utilisez
ctx.anim(...)dans vos règles de classe. N’écrivez jamais la forme raccourcieanimation:et ne définissez pasanimation-delayvous-même. - 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. - 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. - 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/).