python-pptx는 파이썬에서 PowerPoint 파일(.pptx)을 다룰 수 있는 라이브러리입니다. 이 라이브러리의 주요 클래스 중 하나인 도큐먼트(document) 클래스에 대해 살펴보겠습니다.
도큐먼트 클래스는 PowerPoint 파일을 나타내는 객체입니다. 이 클래스를 사용하여 PowerPoint 파일을 생성하고 수정할 수 있습니다. 아래는 도큐먼트 클래스의 기본 사용법입니다.
도큐먼트 생성하기
먼저, python-pptx를 설치하고 pptx 모듈을 import해야 합니다.
from pptx import Presentation
새로운 도큐먼트를 생성하려면 Presentation() 생성자를 호출합니다.
prs = Presentation()
위 코드는 빈 PowerPoint 프레젠테이션을 생성합니다.
슬라이드 추가하기
이제 도큐먼트에 슬라이드를 추가해 보겠습니다. slides 속성을 사용하여 슬라이드의 리스트에 접근할 수 있습니다. 슬라이드를 추가하려면 slides 속성의 add_slide() 메소드를 호출하여 슬라이드를 생성합니다.
slide = prs.slides.add_slide(prs.slide_layouts[0])
위 코드는 첫 번째 슬라이드 레이아웃을 사용하여 새로운 슬라이드를 추가합니다.
슬라이드 내용 수정하기
생성한 슬라이드의 타이틀과 내용을 수정해 보겠습니다. 슬라이드의 타이틀은 title 속성으로 접근할 수 있고, 내용은 text 속성으로 접근할 수 있습니다.
title = slide.shapes.title
title.text = "제목"
위 코드는 슬라이드의 타이틀을 “제목”으로 변경합니다.
content = slide.shapes.placeholders[1]
content.text = "내용"
위 코드는 슬라이드의 두 번째 플레이스홀더에 해당하는 내용을 “내용”으로 변경합니다.
도큐먼트 저장하기
슬라이드를 추가하고 수정한 후, 저장할 PowerPoint 파일의 이름을 지정하여 도큐먼트를 저장할 수 있습니다.
prs.save("example.pptx")
위 코드는 example.pptx라는 이름의 파일로 도큐먼트를 저장합니다.
결론
이상으로 python-pptx의 도큐먼트 클래스에 대해 알아보았습니다. 도큐먼트 클래스를 통해 파이썬에서 PowerPoint 파일을 쉽게 다룰 수 있습니다. 추가적인 기능과 사용법에 대해서는 python-pptx 공식 문서를 참고하시기 바랍니다.