# 카드 뉴스 자동 생성기 - 완벽 가이드

## 🎯 핵심 변경사항

### ✨ 새로운 기능
- **600x600 사이즈**: 인스타그램 최적화
- **자동 텍스트 래핑**: 텍스트가 절대 잘리지 않음
- **AI 자동 생성**: 주제만 입력하면 여러 장 자동 생성
- **간편한 워크플로우**: 유저는 주제 + 배경색만 제공

## 🚀 사용 방법

### 기본 사용법 (추천)

**유저가 제공하는 것:**
1. 주제 (예: "Z세대의 특징")
2. 배경색 RGB (예: `245,243,238`)

**Claude가 하는 것:**
1. 주제에 맞는 5-7개 카드 내용 생성
2. 자동으로 모든 카드 이미지 생성
3. 다운로드 링크 제공

### 예시 대화

```
유저: Z세대에 대한 카드 뉴스 만들어줘

Claude: Z세대 특징에 대한 카드 뉴스를 만들겠습니다!
       배경색을 선택해주세요 (RGB 형식):
       
       추천 색상:
       • 베이지: 245,243,238
       • 핑크: 255,229,229
       • 민트: 224,244,241

유저: 핑크로 해줘

Claude: 알겠습니다! Z세대 특징 카드 5장을 핑크 배경으로 생성하겠습니다.
       
       [카드 내용 생성 및 이미지 생성]
       
       ✅ 카드 뉴스 5장이 완성되었습니다!
       
       [카드 1 다운로드]
       [카드 2 다운로드]
       ...
```

## 📝 콘텐츠 생성 가이드라인

### 제목 작성
- **최대 20자** (공백 포함)
- 간결하고 임팩트 있게
- 핵심 키워드 중심

✅ 좋은 예:
- "디지털 네이티브"
- "개인화 중시"
- "소통 방식 변화"

❌ 나쁜 예:
- "Z세대는 디지털 네이티브 세대입니다" (너무 길다)
- "특징" (너무 짧고 모호)

### 설명 작성
- **최대 60자** (공백 포함)
- 2-3줄로 나누기
- 각 줄은 15-20자 정도

✅ 좋은 예:
```
태어날 때부터
디지털 환경에 익숙
```

❌ 나쁜 예:
```
그들은 태어날 때부터 스마트폰과 인터넷을 사용하며 자랐기 때문에 디지털 기술에 매우 능숙합니다
```

## 🎨 색상 가이드

### RGB 형식으로 입력
```
베이지: 245,243,238
핑크: 255,229,229
민트: 224,244,241
라벤더: 232,224,245
피치: 255,232,214
블루: 227,242,253
```

### 색상별 추천 용도

| 색상 | RGB | 용도 |
|------|-----|------|
| 🏜️ 베이지 | 245,243,238 | 전문적, 중립적 주제 |
| 🌸 핑크 | 255,229,229 | 부드럽고 감성적인 주제 |
| 🌿 민트 | 224,244,241 | 자연, 건강, 웰빙 |
| 💜 라벤더 | 232,224,245 | 힐링, 마인드풀니스 |
| 🍑 피치 | 255,232,214 | 따뜻하고 친근한 주제 |
| 🌤️ 블루 | 227,242,253 | 비즈니스, 신뢰성 |

## 🛠️ 기술 사양

### 캔버스 크기
- **크기**: 600x600 픽셀
- **패딩**: 40px (상하좌우)
- **텍스트 영역**: 520px 최대 폭

### 폰트 크기
- **번호 배지**: 60px (볼드)
- **제목**: 48px (볼드)
- **설명**: 28px (레귤러)

### 레이아웃
```
┌─────────────────────────┐
│         [번호]           │  ← 60px, 상단에서 60px
│                         │
│        [제목]           │  ← 48px, 볼드, 중앙정렬
│                         │
│        [설명]           │  ← 28px, 중앙정렬
│                         │
│                         │
└─────────────────────────┘
   600x600px
```

## 📋 Claude 사용 시나리오

### 시나리오 1: 기본 카드 뉴스 생성

**유저 입력:**
```
"밀레니얼 세대 특징으로 카드 뉴스 5장 만들어줘. 민트색으로."
```

**Claude 워크플로우:**
1. 주제 확인: "밀레니얼 세대 특징"
2. 색상 확인: 민트 (224,244,241)
3. 5개 카드 내용 생성 (각 20자 이하 제목 + 60자 이하 설명)
4. auto_generator.py 실행
5. 다운로드 링크 제공

### 시나리오 2: 커스텀 색상

**유저 입력:**
```
"건강한 아침 습관에 대한 카드를 만들어줘.
배경은 RGB 200,230,201로 해줘."
```

**Claude 워크플로우:**
1. RGB를 Hex로 변환: #c8e6c9
2. 건강 관련 내용 5-7개 생성
3. auto_generator.py로 카드 생성
4. 결과 제공

### 시나리오 3: 시리즈물

**유저 입력:**
```
"Python 기초 강좌를 카드 뉴스로 만들어줘.
10장 정도로, 파란색 배경으로."
```

**Claude 워크플로우:**
1. Python 기초 10개 주제 선정
2. 각 주제별 간결한 설명 작성
3. 블루 배경 (227,242,253)으로 10장 생성
4. 순차적 번호와 함께 제공

## 💡 팁 & 트릭

### 1. 텍스트 길이 최적화
```python
# 제목 길이 체크
title = "디지털 네이티브"
if len(title) <= 20:  # ✓ Good
    
# 설명 길이 체크
content = "태어날 때부터\n디지털 환경에 익숙"
if len(content.replace('\n', '')) <= 60:  # ✓ Good
```

### 2. 줄바꿈 전략
```
# 자연스러운 줄바꿈
태어날 때부터
디지털 환경에 익숙

# 읽기 편한 리듬
나만의 개성과
취향을 중요시
```

### 3. 시리즈 일관성
- 모든 카드에 같은 배경색 사용
- 제목 길이 비슷하게 유지
- 설명 스타일 통일

### 4. 숫자 효과적 사용
```
1. [소개/정의]
2. [핵심 특징 1]
3. [핵심 특징 2]
4. [핵심 특징 3]
5. [결론/행동 촉구]
```

## 🔧 문제 해결

### Q: 텍스트가 여전히 잘려요
**A**: 내용이 너무 깁니다. 제목 20자, 설명 60자 이하로 줄이세요.

### Q: 폰트가 안 나와요
**A**: 한글 폰트 설치 확인:
```bash
sudo apt-get install fonts-noto-cjk
fc-cache -fv
```

### Q: 자동 생성이 안 돼요
**A**: 콘텐츠 형식 확인:
```
1. 제목
설명

2. 제목
설명
```
번호와 제목 사이에 `. ` (마침표 + 공백) 필요

### Q: 이미지 품질이 떨어져요
**A**: PNG 품질은 95%로 설정되어 있습니다. 충분히 고품질입니다.

## 📱 플랫폼별 최적화

### 인스타그램
- **크기**: 600x600 (기본값) ✓
- **형식**: PNG
- **업로드**: 그대로 사용

### 페이스북
- **크기**: 600x600 ✓
- **권장**: 밝은 배경색 사용

### 카카오톡
- **크기**: 600x600 ✓
- **팁**: 텍스트 크기 충분히 확보

### 블로그 썸네일
- 600x600 정사각형 그대로 사용 가능
- 또는 --width --height로 커스텀

## 🎓 고급 활용

### 커스텀 크기 생성
```bash
python generate_card.py \
  --title "제목" \
  --content "내용" \
  --width 800 \
  --height 800 \
  --output custom.png
```

### 폰트 크기 조정
```bash
python generate_card.py \
  --title "제목" \
  --content "내용" \
  --title-size 60 \
  --content-size 35 \
  --output larger_text.png
```

### 번호 없이 생성
```bash
python generate_card.py \
  --title "제목" \
  --content "내용" \
  --output no_number.png
# --number 옵션 생략
```

## 📊 성능

- **생성 속도**: 카드 1장당 ~0.5초
- **시리즈 생성**: 5장 기준 ~3초
- **메모리**: ~50MB per card
- **파일 크기**: 평균 30-50KB per PNG

## 📄 라이선스

MIT License - 자유롭게 사용, 수정, 배포 가능

---

**즐거운 카드 뉴스 제작 되세요!** 🎉
