ppt-generator

PPT Generator

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

사용법

/ppt-generator 분기별 실적 보고서 PPT 만들어줘
/ppt-generator --template company.pptx 신제품 소개 자료
/ppt-generator 이 마크다운 내용으로 PPT 생성해줘

요구사항

pip install python-pptx Pillow

템플릿

번들 템플릿 파일은 제공하지 않습니다. python-pptx의 기본 테마로 생성하거나, 직접 만든 .pptx를 템플릿으로 전달할 수 있습니다.

PPTGenerator()                       # 기본 테마
PPTGenerator("my-template.pptx")     # 사용자 제공 템플릿

template_path가 없거나 파일이 존재하지 않으면 기본 테마로 폴백합니다(scripts/pptx_helpers.py:42-45).

핵심 코드

기본 PPT 생성

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}")