git:20260318.4ba4f0c to git:20260318.07c6026

---

name: ppt-generator

---

# PPT Generator

python-pptx를 활용하여 템플릿 기반의 전문적인 PowerPoint 프레젠테이션을 생성합니다.

## 사용법

```

/ppt-generator 분기별 실적 보고서 PPT 만들어줘

/ppt-generator --template company.pptx 신제품 소개 자료

/ppt-generator 이 마크다운 내용으로 PPT 생성해줘

```

## 요구사항

```bash

pip install python-pptx Pillow

```

## 템플릿 구조

```

templates/

├── default.pptx # 기본 템플릿

├── corporate.pptx # 회사 브랜드 템플릿

├── pitch-deck.pptx # 투자자 피칭용

├── report.pptx # 보고서용

└── minimal.pptx # 미니멀 스타일

```

## 핵심 코드

### 기본 PPT 생성

```python

from pptx import Presentation

from pptx.util import Inches, Pt, Emu

from pptx.dml.color import RgbColor

from pptx.enum.text import PP_ALIGN, MSO_ANCHOR

from pptx.enum.shapes import MSO_SHAPE

from pathlib import Path

class PPTGenerator:

"""템플릿 기반 PPT 생성기"""

def __init__(self, template_path: str | None = None):

if template_path and Path(template_path).exists():

self.prs = Presentation(template_path)

else:

self.prs = Presentation()

self._setup_slide_layouts()

def _setup_slide_layouts(self):

"""슬라이드 레이아웃 매핑"""

self.layouts = {

'title': 0, # 제목 슬라이드

'title_content': 1, # 제목 + 내용

'section': 2, # 섹션 헤더

'two_content': 3, # 2단 레이아웃

'comparison': 4, # 비교

'title_only': 5, # 제목만

'blank': 6, # 빈 슬라이드

'content_caption': 7, # 내용 + 캡션

'picture_caption': 8, # 그림 + 캡션

}

def add_title_slide(self, title: str, subtitle: str = ""):

layout = self.prs.slide_layouts[self.layouts['title']]

slide = self.prs.slides.add_slide(layout)

slide.shapes.title.text = title

if subtitle and len(slide.placeholders) > 1:

slide.placeholders[1].text = subtitle

return slide

def add_content_slide(self, title: str, bullets: list[str]):

layout = self.prs.slide_layouts[self.layouts['title_content']]

slide = self.prs.slides.add_slide(layout)

slide.shapes.title.text = title

body = slide.placeholders[1]

tf = body.text_frame

tf.clear()

for i, bullet in enumerate(bullets):

if i == 0:

tf.paragraphs[0].text = bullet

else:

p = tf.add_paragraph()

p.text = bullet

p.level = 0

return slide

def add_two_column_slide(self, title: str, left: list[str], right: list[str]):

layout = self.prs.slide_layouts[self.layouts['two_content']]

slide = self.prs.slides.add_slide(layout)

slide.shapes.title.text = title

for placeholder_idx, items in [(1, left), (2, right)]:

tf = slide.placeholders[placeholder_idx].text_frame

tf.clear()

for i, text in enumerate(items):

if i == 0:

tf.paragraphs[0].text = text

else:

p = tf.add_paragraph()

p.text = text

return slide

def add_image_slide(self, title: str, image_path: str, caption: str = ""):

layout = self.prs.slide_layouts[self.layouts['title_only']]

slide = self.prs.slides.add_slide(layout)

slide.shapes.title.text = title

slide.shapes.add_picture(image_path, Inches(1.5), Inches(2), width=Inches(7))

if caption:

txBox = slide.shapes.add_textbox(Inches(1), Inches(6.5), Inches(8), Inches(0.5))

txBox.text_frame.paragraphs[0].text = caption

txBox.text_frame.paragraphs[0].alignment = PP_ALIGN.CENTER

return slide

def save(self, output_path: str):

self.prs.save(output_path)

print(f"PPT 저장 완료: {output_path}")

```

> 표, 차트, 마크다운→PPT, JSON→PPT 변환 코드 및 전체 사용 예시: [references/code-examples.md](references/code-examples.md)

## 템플릿 팁

### 좋은 템플릿 만드는 법

1. **마스터 슬라이드 정의**

- PowerPoint에서 보기 → 슬라이드 마스터

- 각 레이아웃에 플레이스홀더 배치

- 색상 테마, 폰트 설정

2. **플레이스홀더 활용**

```

Layout 0: 제목 슬라이드 (Title, Subtitle)

Layout 1: 제목+내용 (Title, Body)

Layout 2: 섹션 헤더

Layout 3: 2단 (Title, Left, Right)

Layout 5: 제목만 (이미지/차트용)

Layout 6: 빈 슬라이드

```

3. **브랜드 요소 포함**

- 로고 위치 고정

- 푸터 (페이지 번호, 날짜)

- 색상 팔레트 정의

## Helper Scripts

이 스킬에는 재사용 가능한 헬퍼 스크립트가 포함되어 있습니다.

SKILL.md의 `PPTGenerator` 클래스 없이 슬라이드를 빠르게 조합할 때 사용하세요.

| 스크립트 | 용도 |

|---------|------|

| `scripts/pptx_helpers.py` | python-pptx 기반 슬라이드 생성 헬퍼 (타이틀, 불릿, 이미지, 차트, 테이블) |

```bash

# 설치

pip install python-pptx Pillow

# 직접 실행 (샘플 PPT 생성)

python scripts/pptx_helpers.py

```

주요 함수:

| 함수 | 역할 |

|------|------|

| `create_presentation(title, subtitle, author)` | 타이틀 슬라이드 포함 Presentation 생성 |

| `add_title_slide(prs, title, subtitle)` | 타이틀 슬라이드 추가 |

| `add_content_slide(prs, title, bullets)` | 불릿 목록 슬라이드 추가 (들여쓰기 지원) |

| `add_image_slide(prs, title, image_path, caption)` | 이미지 + 캡션 슬라이드 추가 |

| `add_chart_slide(prs, title, chart_data, chart_type)` | 막대/꺾은선/파이 차트 슬라이드 추가 |

| `add_table_slide(prs, title, headers, rows)` | 교번 색상 테이블 슬라이드 추가 |

---

## 체크리스트

- [ ] python-pptx 설치됨

- [ ] 템플릿 파일 준비 (`templates/` 폴더)

- [ ] 이미지 경로 확인 (절대 경로 권장)

- [ ] 한글 폰트 지원 확인

- [ ] 출력 경로 쓰기 권한 확인

## 관련 명령어

- `/ppt-generator` - 이 스킬 실행

- `/erd-designer` - ERD 다이어그램 생성 (Mermaid)

- `/docker-deploy` - 배포 환경 구성