Communitygithub.com

khatt

아랍어, 페르시아어, 우르두어 텍스트로 애니메이션 아랍어 서예(자체 재생 SVG 또는 HTML 페이지)를 만들고 새로운 애니메이션 효과를 발명합니다. 사용자가 아랍어 서예, 애니메이션 아랍어 단어, 이름, 인사(라마단, 이드, 결혼식, 생일), 서예 로고, 스티커, 배너를 원하거나 '아랍어 서예로' 무언가를 써 달라고 요청할 때 사용하세요.

khatt란 무엇인가요?

Khatt은 아랍어, 페르시아어, 우르두어 텍스트를 입력받아 HarfBuzz를 통해 문자를 올바르게 결합하고 정렬한 후, 순수 CSS 애니메이션과 함께 단일 SVG 파일로 렌더링하는 CLI 기반 도구입니다. 인터넷 연결이나 추가 설치 없이 스크립트, 폰트, 셰이핑 엔진이 모두 하나의 폴더에 포함되어 있어, 개발자나 디자이너가 빠르게 아랍어 서예 작품을 생성할 수 있습니다. Ruqaa, Naskh, Kufi, Nastaliq, Kano, Blaka 등 다양한 서체 스타일과 Line, Arc, Circle(별 포함), Mirror(무산나 양식) 레이아웃을 지원하며, Ink, Gold, Bleed, Mosaic, Sand, Neon, Stars, Lantern, Rise, Stamp, Reveal, Wave 등 12가지 이상의 내장 애니메이션 효과를 제공합니다. 또한 사용자가 직접 새로운 애니메이션 효과를 JavaScript 모듈(.mjs)로 작성할 수 있어, 브랜딩, 소셜 미디어 콘텐츠, 라마단/이드 인사, 결혼식 카드, 로고 등 다양한 용도로 활용 가능합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/M-Alkassem/khatt/tree/HEAD/skills/khatt

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Khatt: 애니메이션 아랍어 서예

Khatt은 HarfBuzz로 텍스트를 정형화(문자 결합, 오른쪽에서 왼쪽, 부호 배치)하고, 배치한 후 하나의 SVG 파일 내에서 순수 CSS로 애니메이션을 만듭니다. 네트워크도 설치도 필요 없습니다. 스크립트, 폰트, 셰이핑 엔진이 모두 이 폴더에 있습니다.

그림 만들기

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 (고전적인 대칭 무산나 양식)
--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을 사용하면 두 번째 줄을 추가할 수 있습니다 (최대 4줄).

잘 선택하기

  • 이름 및 영어 단어: 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 레이아웃, 2-3줄.

가능하다면 사용자에게 결과물을 열어 보여주세요 (예: macOS에서 open out.html).

새로운 효과 만들기

12가지 효과 중 어느 것도 맞지 않을 때 ("글자가 불타오르게", "흔들리는 라마단 등") 새 효과를 작성하세요. examples/ripple.mjs에서 시작하세요. 효과는 import가 없는 일반 객체입니다:

export default {
  id: "my-effect", name: "My effect", nameAr: "…", blurb: "…",
  palette: "night",          // 기본 팔레트 ID
  loop: false,               // 계속 움직이면 true
  render(ctx) {
    // return { 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 및 keyframe 이름에 사용하세요.

그림을 모든 프레임에서 일시 중지 가능하게 유지하는 규칙 (스틸 및 비디오 내보내기가 이에 의존함):

  1. 모든 애니메이션 요소는 class="${p}-a ..." 및 style="${at(seconds)}"를 받습니다.
  2. 클래스 규칙에 ctx.anim(...)을 사용하세요. 직접 animation: 단축 속성이나 animation-delay를 설정하지 마세요.
  3. keyframes 이름을 ${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/에 위치).

관련 스킬