인터랙티브 인사말 카드
사용자가 가지고 놀고 싶은 카드를 만드세요: 페이지에서 살랑이는 접힌 카드 앞면에 있는 사진, 빛을 따라 움직이는 호일이나 물감, 탭하면 열리는 손글씨 메시지, 그리고 뒷면까지 보여줍니다. 짧은 빌드 과정으로 사진과 몇 가지 설정을 하나의 HTML 파일 (사진, 폰트, 렌더러 포함)로 만들어서, 파일에서 바로 열리고, 오프라인에서 작동하며, 어떤 웹 호스트에도 수정 없이 올릴 수 있습니다.
이 스킬의 구성:
scripts/make_card.py는 카드 데이터(JSON)로부터 페이지를 빌드합니다. 데이터를 확인하고 오류가 있으면 파일을 쓰기 전에 설명합니다.scripts/grid.py는 사진 위에 레이블이 지정된 픽셀 그리드를 그리고, 카드가 자르는 대로 정확히 잘라서 위치를 읽을 수 있게 합니다 (움직이는 효과 및 색상 선택에만 필요).scripts/foil_preview.py는 포일로 변환되는 부분을 자홍색으로 정확히 보여주므로, 빌드 전에 포일을 조정할 수 있습니다 (numpy 필요).scripts/snapshot.mjs(선택 사항, Node 및 Playwright 필요)는 앞면, 내부 및 뒷면을 스크린샷으로 찍고,--live옵션을 사용하면 움직이는 카드의 애니메이션과 각 탭 동작을 보여줍니다.references/options.md는 모든 설정을 나열합니다.references/living-cards.md는 카드에 생명을 불어넣는 방법을 설명합니다. 필요할 때 읽으십시오. 미리 읽지 마세요.
카드 만드는 방법
1. 사진과 메시지 받기
사용자에게 필요한 두 가지는 앞면에 쓸 사진과 안에 쓸 내용입니다. 둘 중 하나라도 없으면 요청하거나, 메시지를 대신 써 주겠다고 제안하세요 (누구에게, 누구로부터인지 물어보세요). 다른 모든 것은 합리적인 기본값이 있으므로, 질문지를 작성하게 하지 말고, 잘 선택하고 선택한 내용을 언급해서 변경할 수 있도록 하세요.
메시지는 그대로 받아들이세요. 요청하지 않는 한 말을 다듬지 마세요. 하지만 손글씨 카드에 있어야 할 줄바꿈은 넣으세요 (인사말은 자체 줄에, 끝맺음은 마지막에). 너무 긴 줄은 약 20자에서 자동으로 줄바꿈됩니다. 약 60단어까지는 크고 편안하게 읽힙니다. 더 긴 편지는 더 작게 쓰여지고, 한도를 초과하면 끝이 잘리므로, 매우 긴 편지는 줄이는 것을 제안하세요.
여러 장의 사진은 한 페이지에 여러 장의 카드를 만들어서, 하나씩 차례로 넘기며 전환할 수 있는 도크가 제공됩니다. 이는 카드 세트나, 하나의 카드를 여러 디자인으로 만들어 선택할 수 있게 할 때 적합합니다.
2. 사진을 보고 마감재 선택하기
마감재는 앞면이 빛을 받는 방식을 결정합니다. 선택하기 전에 사진을 살펴보세요:
| 사진 | 마감재 | 비고 |
|---|---|---|
| 붓 질감이 있는 그림 (유화, 구아슈, 아크릴, 두꺼운 수채화) | paint | 물감 자체의 붓 자국이 서서 빛 아래에서 반짝입니다. 금색 물감이 있다면 그것도 빛나게 하세요: foil.on: "colour" 와 함께 금색을 선택하세요. |
| 일러스트, 선화, 레터링 또는 평면 디자인 (특히 흰 종이 위) | foil | on: "details" 는 선과 어두운 디테일을 호일로 찍습니다. "colour" 는 선택한 하나의 색상 (예: 금색 레터링)을 찍습니다. "darks" 는 가장 어두운 형태 (실루엣)를 찍습니다. |
| 사진 | print | 무광 카드에 인쇄됩니다. 얇은 호일 border 가 잘 어울립니다. 사진의 디테일에 호일을 입히면 지저분해 보일 수 있습니다. |
호일 색상: gold (클래식, 따뜻함), silver (겨울, 웨딩, 쿨 팔레트), rose (로맨스), copper (가을, 러스틱), pink (장난기), holo (홀로그램, 생일). 사진의 색상 팔레트와 상황에 맞추세요.
빌드 전에 foil_preview.py 로 호일을 확인하세요 (카드 데이터를 작성한 후, 5단계). 의도한 부분이 단색으로 나와야 하고, 다른 부분이 걸리지 않아야 합니다. 두 가지 문제가 자주 발생합니다:
- 호일로 만들고 싶은 부분이 원하지 않는 부분과 색상이나 어두움이 같을 때 (예: 금색 중심을 가진 꽃 위의 금색 레터링).
foil.area로 상자 영역을 지정하세요. - 기본 금색은 연하고 클래식합니다. 훨씬 짙은 금색으로 그려진 아트는 자체 잉크를 사용하여 호일이 일치하도록 할 수 있습니다.
references/options.md 의 호일 섹션에는 잉크, 각 모드에서 amount 가 하는 일, 그리고 area 가 있습니다.
종이 (내부, 뒷면 및 가장자리): white, cream, blush, sage, sky, midnight 또는 #rrggbb. 사진이 일반 종이에 그려진 경우, 카드는 기본적으로 그 종이를 사용하며, 일반적으로 가장 좋아 보입니다.
카드는 사진의 중앙에서 모양에 맞게 잘립니다: portrait (5:7, 기본값), square, landscape (7:5) 또는 original (사진 자체의 모양, 제한 있음). 넓은 사진에는 landscape 를 사용하세요. 피사체가 가장자리 근처에 있다면 grid.py 를 실행하여 자르기가 무엇을 유지하는지 확인하세요.
3. 상황에 맞는 효과 추가하기 (선택 사항)
이 효과들은 위치가 필요 없으므로, 카드에 어울릴 때 자유롭게 추가하세요:
snow: 눈송이가 앞면 위로 내려옵니다 (겨울, 크리스마스)hearts: 작은 페인트 하트가 가끔 사진 위로 떠오릅니다 (사랑, 발렌타인 데이, 어머니날, 결혼식)fireflies: 부드러운 불빛이 아래쪽 부분을 떠다닙니다 (여름밤, 몽환적인 장면)shootingStars: 별이 가끔 위쪽을 가로질러 날아갑니다 (밤하늘)sparkle: 호일 포인트가 빛을 받아 반짝입니다 (호일 카드에 적합)
한두 가지 효과면 충분합니다. 더 많으면 복잡해집니다.
4. 생명 불어넣기 (선택 사항, 가장 좋은 부분)
카드는 훨씬 더 많은 것을 할 수 있습니다: 사진 속의 랜턴이 빛나고 깜빡이며 탭하면 불꽃이 튀고, 태양이 광선을 발산하고, 고양이 꼬리가 흔들리며 쓰다듬으면 하트가 올라가고, 가지가 흔들리며 눈을 떨어뜨리고, 스카프가 포인터의 바람에 펄럭입니다. 이렇게 하려면 사진 위의 위치가 필요하며, grid.py 의 그리드에서 읽어옵니다. references/living-cards.md 를 읽고 따라하세요.
사용자가 카드가 살아 움직이거나, 애니메이션이 되거나, 상호작용하기를 원할 때, 또는 사진에 눈에 띄는 빛 (촛불, 랜턴, 태양, 달, 불이 켜진 창문)이나 캐릭터가 있을 때 이 작업을 수행하세요. 시간이 좀 걸리므로 빠른 카드의 경우 다음 단계로 제안하세요.
5. 카드 데이터 작성하기
사진 옆에 JSON으로 저장하세요. 한 장의 카드:
{
"title": "엘리야, 생일 축하해",
"image": "ellie-birthday.jpg",
"alt": "양귀비 초원에 있는 여우의 수채화.",
"name": "여우와 양귀비",
"finish": "foil",
"foil": { "colour": "rose", "on": "details", "amount": 0.12 },
"paper": "cream",
"message": "사랑하는 엘리야,
내가 가장 좋아하는 사람의 생일을 축하해.
최고의 한 해가 되길!
사랑을 담아, 노라",
"signature": ["사랑을 담아", "노라"],
"effects": { "hearts": true, "sparkle": true }
}
alt 는 화면 판독기를 위해 앞면을 설명합니다. 항상 작성하세요. name 은 back 이나 signature 가 달리 지정하지 않는 한 뒷면에 작은 글씨로 표시됩니다. 여러 장의 카드는 "cards": [ {...}, {...} ] 안에 넣고, 맨 위에 title 과 page 를 지정합니다. 모든 설정은 references/options.md 에 있습니다.
6. 빌드하기
python scripts/make_card.py card.json --check # 데이터 확인, 카드의 픽셀 크기 출력
python scripts/make_card.py card.json -o card.html
JSON의 경로는 JSON 파일을 기준으로 합니다. 빠른 카드를 위한 한 줄 형식도 있습니다:
python scripts/make_card.py --image front.jpg --message "생일 축하해!" --finish foil --foil gold -o card.html
스크립트가 오류를 보고하면, 무엇이 잘못되었고 어떻게 수정해야 하는지 알려줍니다. 경고 (메시지 누락, 알 수 없는 설정, 카드 범위를 벗어난 위치)는 계속 빌드되지만, 수정하세요.
7. 확인하기
Node와 Playwright를 사용할 수 있다면, 전달하기 전에 카드를 살펴보세요:
node scripts/snapshot.mjs card.html shots/
node scripts/snapshot.mjs card.html shots/ --live # 살아 움직이는 카드: 무엇이 움직이는지도 확인
이 명령은 앞면, 빛이 비춰진 앞면 (front-lit: 호일이나 물감이 빛을 받음), 내부 및 뒷면을 PNG로 저장합니다. 확인하세요: 메시지가 읽기 쉬운지, 호일이 점박이처럼 보이지 않고 선명하게 찍혔는지, 사진이 예상한 대로 잘렸는지. 조정하고 다시 빌드하세요. 각 과정은 빠릅니다. 브라우저가 없으면 미리보기를 할 수 없다고 말하세요 (호일 미리보기는 여전히 작동합니다).
8. 전달하기
사용자에게 HTML 파일을 주고 사용 방법을 알려주세요:
- 브라우저에서 열면 카드가 보입니다. 탭 (또는 O 키)하여 열고, 옆으로 드래그 (또는 T 키)하여 뒤집습니다.
- 보내려면 온라인에 올리고 링크를 공유하세요: GitHub Pages, Netlify Drop 또는 정적 호스트라면 파일을 그대로 사용할 수 있습니다. 또는 파일 자체를 보내세요. 오프라인에서도 작동합니다.
- 크기는 1~2MB이며, 거의 대부분이 사진입니다.
선택한 내용 (마감재, 호일, 종이, 효과)을 한 문장으로 언급하여 변경을 요청할 수 있도록 하세요.
알아두면 좋은 점
- 휴대폰 사진은 올바른 방향으로 회전되고 큰 사진은 축소됩니다 (Pillow 사용). 투명 영역은 흰색이 됩니다. HEIC 사진은 Pillow가 읽을 수 없는 경우 JPEG로 변환해야 합니다.
- 손글씨는 Caveat이며 페이지에 포함되어 있습니다. 라틴어, 확장 라틴어 및 키릴 문자를 지원합니다. 다른 문자 (베트남어, 그리스어, CJK)는 기기의 자체 손글씨 폰트로 대체됩니다.
- WebGL이 없어도 페이지는 여전히 사진과 메시지를 평면으로 표시합니다.
- 페이지는 밝은 테마로 디자인되었습니다. 카드는 흰색 배경에 부드러운 그림자와 함께 표시됩니다.
- 이러한 설정 이상으로 카드의 모양이나 동작을 변경하려면 렌더러의 소스가 스킬의 GitHub 저장소 (
renderer/)에 있으며, 다시 빌드하면assets/greeting-card.js가 교체됩니다.