PPTX 생성, 편집 및 분석은(는) 무엇을 하나요?
.pptx 파일은 XML 파일들의 ZIP 아카이브입니다. 작업에 따라 접근 방식을 선택하세요:
| 작업 | 접근 방식 |
|---|---|
| 새 덱 생성 | pptxgenjs 스크립트 작성 — 아래 주의사항 참고 |
| 기존 덱 편집 또는 템플릿 기반 생성 | 압축 해제 → ppt/slides/slideN.xml 편집 → 압축 |
| 내용 읽기 | markitdown deck.pptx (<!-- Slide number: N --> 마커 아래 슬라이드당 한 블록); 시각적 그리드: python scripts/thumbnail.py deck.pptx |
스크립트
경로는 이 스킬의 디렉토리를 기준으로 합니다. 그 외에는 일반 Python, node 또는 셸입니다.
| 스크립트 | 기능 |
|---|---|
scripts/thumbnail.py deck.pptx [접두사] | 모든 슬라이드의 레이블이 지정된 그리드, 템플릿 레이아웃 선택용. .pptx만 가능. 접두사 전달 — 기본값은 thumbnails로, 같은 디렉토리에 있는 다른 덱의 그리드를 덮어씁니다 |
scripts/add_slide.py unpacked/ slide2.xml [--after slideN.xml] | 모든 패키지 부기와 함께 슬라이드(또는 slideLayoutN.xml)를 복제합니다. 또한 -o out.pptx와 함께 .pptx를 직접 입력받을 수 있습니다 |
scripts/clean.py unpacked/ | 더 이상 참조되지 않는 슬라이드, 미디어, rels를 삭제합니다. <p:sldIdLst>가 최종 확정된 후 실행하세요 |
scripts/office/validate.py deck.pptx [--original src.pptx] | 스키마, 관계, 콘텐츠 유형, 차트 및 슬라이드 검사; 각 실패는 수정 방법을 알려줍니다. 템플릿에서 파생된 덱의 경우 --original을 전달하세요 — 템플릿을 기준으로 스키마 검사를 벤치마킹하여 템플릿 자체의 XSD 오류가 사용자 오류로 간주되지 않도록 합니다 |
scripts/office/soffice.py --headless --convert-to pdf deck.pptx | LibreOffice 래퍼 — 기본 soffice는 이 샌드박스에서 중단됩니다 |
pptxgenjs로 생성하기 — 주의사항
pptxgenjs는 사전 설치되어 있습니다 — npm install을 먼저 실행하지 말고 스크립트를 작성하고 require('pptxgenjs')를 직접 호출하세요. 해당 require가 실패하는 경우에만: npm install pptxgenjs. 모델은 API를 알고 있습니다. 다음은 주의해야 할 함정들입니다:
- 슬라이드를 추가하기 전에
pres.layout을 설정하세요. 기본 캔버스는LAYOUT_16x9= 10" × 5.625" 이며, 13.3" 너비가 아닙니다. 가장자리를 넘는 좌표는 기록되지만 클램프되지는 않습니다 — 모양이 단순히 슬라이드에 없습니다. (LAYOUT_WIDE는 13.3" × 7.5"입니다.) - 16진수 색상:
#절대 사용 금지, 8자리 절대 사용 금지.color: "FF0000"."#FF0000"과 16진수에 알파를 포함하는 경우("00000020") 모두 파일을 손상시킵니다. 반투명도: 채우기 및 이미지에는transparency: 0-100, 그림자에는opacity: 0.0-1.0— 각각 다른 속성에서는 자동으로 무시됩니다. - pptxgenjs는 옵션 객체를 제자리에서 변경합니다 (첫 사용 시 값을 EMU로 변환). 두 개의
add*호출에서 하나의shadow/옵션 객체를 절대 공유하지 마세요 — 매번 새 객체를 만드세요. - 그림자
offset은 0 이상이어야 합니다 — 음수 오프셋은 파일을 손상시킵니다. 위쪽으로 그림자를 드리우려면 양수 오프셋과 함께angle: 270을 사용하세요. letterSpacing은 자동으로 무시됩니다 — 실제 옵션은charSpacing입니다.- 목록: 각 항목에
bullet: true를 사용하고, 리터럴•는 절대 사용하지 마십시오(이중 글머리 기호가 렌더링됩니다). 마지막 항목을 제외한 모든 배열 항목에breakLine: true를 설정하세요. 글머리 기호 단락 사이의 간격은lineSpacing이 아닌paraSpaceAfter를 사용하세요(큰 간격이 생깁니다). - 출력 파일당 하나의
new pptxgen()— 인스턴스를 절대 재사용하지 마세요. rectRadius는ROUNDED_RECTANGLE에서만 작동하며,RECTANGLE에서는 작동하지 않습니다.- 그라데이션 채우기는 지원되지 않습니다 — 대신 배경에 그라데이션 이미지를 사용하세요.
- 텍스트 상자에는 내장된 내부 패딩이 있습니다 — 텍스트가 같은 x 위치의 도형, 선 또는 아이콘과 정렬되어야 할 때마다
margin: 0을 설정하세요. - 발표자 노트는
slide.addNotes("...")에 들어갑니다 (일반 텍스트, 슬라이드당 한 번), 슬라이드의 텍스트 상자에 넣지 마세요. - 차트는 네이티브로 유지하세요. PowerPoint가 차트로 만들 수 있는 모든 것에
addChart()를 사용하세요(콤보 차트의 경우{type, data, options}배열 전달). 라이브러리가 노출하지 않는 PowerPoint 네이티브 기능(추세선, 오차 막대)의 경우, 직접 추가 시리즈를 계산하거나 생성된 OOXML을 후처리하세요 — 렌더링된 이미지로 대체하지 마십시오. PowerPoint에 네이티브 형식이 없는 차트 유형(샌키, 네트워크, 코드)만 이미지로 포함하세요. - 기본 차트는 투박하게 렌더링됩니다 — 제목, 데이터 레이블 없음, 구식 팔레트. 팔레트에서
showTitle+title,showValue: true+dataLabelPosition,chartColors: [...]을 설정하고 프레임을 조용하게 만드세요(catAxisLabelColor/valAxisLabelColor,valGridLine: { color, size },catGridLine: { style: "none" }, 단일 시리즈의 경우showLegend: false). - 누적 막대 또는 세로 막대형 차트에서
dataLabelPosition은ctr,inEnd또는inBase여야 합니다.outEnd는 파일을 손상시킵니다. secondaryValAxis/secondaryCatAxis를 사용하는 콤보 시리즈는 차트 옵션에valAxes와catAxes가 모두 필요하며 각각 두 개의 항목이 있어야 합니다. 이것들이 없으면 pptxgenjs는 선언하지 않은 축 ID를 작성하고 PowerPoint는 해당 차트를 버리고 파일이 손상되었다고 보고합니다.valAxes만 제공하는 것만으로는 충분하지 않습니다.writeFile()후에python scripts/office/validate.py deck.pptx를 실행하세요. 위의 두 가지 차트 결함과 PowerPoint가 거부하는 슬라이드 XML 결함을 보고하고 각각에 대한 수정 방법을 알려줍니다. 생성기에서 수정하고, 압축된 XML을 수동으로 편집하지 마세요.<p:presentation>의 자식 순서를 절대 변경하지 마세요. pptxgenjs는<p:sldIdLst>바로 뒤에<p:notesMasterIdLst>를 쓰고 두 마스터를 하나의 테마 파트로 연결합니다. PowerPoint는 이를 문제없이 읽습니다 — 요소를 이동하면 동일한 덱이 열리지 않게 됩니다.- 아이콘:
react-icons를 SVG로 렌더링(ReactDOMServer.renderToStaticMarkup)한 후,sharp로 256px 이상으로 래스터화하고addImage({ data: "image/png;base64," + buf.toString("base64") })를 통해 삽입하세요 —image/png;base64,접두사는 필수입니다(react-icons,react,react-dom,sharp는 사전 설치되어 있음 — require가 실패하는 경우에만npm install react-icons react react-dom sharp실행).
기존 덱 및 템플릿 편집
먼저 레이아웃을 선택하세요: python scripts/thumbnail.py template.pptx template-thumbs는 모든 슬라이드의 레이블이 지정된 그리드를 작성하고 생성된 파일을 출력합니다 — template-thumbs.jpg, 12개 슬라이드를 초과하면 template-thumbs-N.jpg로 분할됩니다. 항상 덱 이름을 따서 명명된 두 번째 인수를 전달하세요. 기본값은 thumbnails이므로 한 디렉토리에서 두 덱의 썸네일을 생성하면 서로의 그리드를 자동으로 덮어씁니다 — 첫 번째 덱의 것은 단순히 사라집니다(템플릿 분석 전용 — 시각적 QA는 이미지로 변환의 전체 해상도 렌더링이 필요합니다. .pptx만 허용하므로 먼저 .potx를 .pptx 이름으로 복사하세요). markitdown과 함께 사용하여 각 콘텐츠 섹션을 템플릿 슬라이드에 매핑하고 레이아웃을 다양하게 지정하세요 — 모든 섹션을 동일한 제목 및 글머리 기호 슬라이드에 넣지 마십시오.
python3 -c "import sys,zipfile; zipfile.ZipFile(sys.argv[1]).extractall('unpacked')" deck.pptx
python scripts/add_slide.py unpacked/ slide2.xml --after slide2.xml # 슬라이드(또는 slideLayoutN.xml) 복제; 새 슬라이드 경로 출력
# 슬라이드 재정렬/삭제 = ppt/presentation.xml에서 <p:sldIdLst> 편집
python scripts/clean.py unpacked/ # 삭제 후: 고아 슬라이드, 미디어, rels 제거
# ppt/slides/slideN.xml에서 슬라이드 내용 편집
(cd unpacked && rm -f ../out.pptx && zip -Xr ../out.pptx .) # 디렉토리 내부에서 압축; 먼저 rm을 실행하지 않으면 삭제된 부분이 유지됨
python scripts/office/validate.py out.pptx --original deck.pptx
- 슬라이드 내용을 편집하기 전에 모든 구조적 작업(추가, 삭제, 재정렬)을 먼저 수행하세요.
add_slide.py는 슬라이드 파일을 그대로 복사하므로 편집 후 복제하면 편집된 내용이 복제됩니다. 그리고clean.py는<p:sldIdLst>에 없는 슬라이드(방금 작성한 슬라이드 포함)를 삭제합니다. - 슬라이드 파일을 수동으로 복사하지 마세요 —
add_slide.py는 새 슬라이드에 필요한 모든 등록을 수행하고 생성된 내용을 보고합니다(Created ppt/slides/slide17.xml from slide2.xml). 또한 파일에서 직접 작동합니다:add_slide.py deck.pptx slide2.xml -o out.pptx—-o를 전달하지 않으면 입력 덱을 제자리에서 덮어씁니다. 복제된 슬라이드는 여전히 소스의 차트/SmartArt/임베디드 개체 부분을 참조하며 복제하지는 않으므로, 한 슬라이드의 차트를 편집하면 다른 슬라이드의 차트도 변경됩니다. python-pptx를 사용하는 경우, 세 가지 작업을 수행할 수 없습니다: 슬라이드 복제(유일한 진입점은add_slide(layout)입니다),text_frame.text = "..."를 통한 서식 유지(단일 스타일이 없는 실행으로 단락이 축소됨 — 대신run.text를 할당하세요), 또는 대부분의 템플릿 아트에서 사용하는 SVG/EMF 읽기(add_picture는UnidentifiedImageError를 발생시킵니다).- 레거시
.ppt는 먼저 변환해야 합니다:python scripts/office/soffice.py --headless --convert-to pptx file.ppt..potx템플릿은 동일하게 압축 해제 및 압축됩니다 — 출력 파일에.potx확장자를 유지하세요. - 템플릿 아이콘 또는 이미지를 재사용하려면 해당 아이콘/이미지가 이미 포함된 슬라이드 또는 레이아웃을 복제하세요.
템플릿을 채울 때:
- XML 변환을 스크립팅하는 경우
defusedxml.minidom으로 구문 분석하세요 —xml.etree.ElementTree를 통해 OOXML을 왕복하면 네임스페이스 접두사가 다시 작성되어 덱이 손상됩니다. - 템플릿 슬롯 ≠ 소스 항목. 템플릿에 4명의 팀 구성원이 표시되고 3명이 있는 경우, 4번째 구성원의 전체 그룹(이미지 + 텍스트 상자)을 삭제하고 텍스트만 삭제하지 마세요 — 그런 다음 QA에서 고아 시각적 요소가 있는지 확인하세요.
- 목록 항목당 하나의
<a:p>— 항목을 단일 단락으로 연결하지 마세요. 간격을 유지하기 위해 형제<a:pPr>을 복사하고, 제목, 섹션 헤더 및 인라인 레이블(Status:,Owner:)의<a:rPr>에b="1"을 넣으세요. - 글머리 기호가 레이아웃에서 상속되도록 하고, 재정의해야 하는 경우에만
<a:buChar>,<a:buAutoNum>(번호 매기기) 또는<a:buNone>을 추가하세요 — 텍스트에 리터럴•를 절대 사용하지 마세요. - 앞뒤에 공백이 있는 텍스트는 해당
<a:t>에xml:space="preserve"가 필요합니다.
디자인 아이디어
지루한 슬라이드를 만들지 마세요. 흰색 배경에 일반 글머리 기호는 누구에게도 깊은 인상을 주지 못합니다. 각 슬라이드에 대해 이 목록의 아이디어를 고려하세요.
시작하기 전에
- 대담하고 내용에 맞는 색상 팔레트를 선택하세요: 팔레트는 이 특정 주제를 위해 디자인된 것처럼 느껴져야 합니다. 색상을 완전히 다른 프레젠테이션에 적용해도 여전히 "작동"한다면, 충분히 구체적인 선택을 하지 않은 것입니다.
- 평등보다 지배력: 한 가지 색상이 지배적이어야 하며(60-70% 시각적 비중), 1-2개의 지원 톤과 하나의 날카로운 악센트가 있어야 합니다. 모든 색상에 동일한 비중을 절대 부여하지 마세요.
- 어두움/밝음 대비: 제목 및 결론 슬라이드에는 어두운 배경, 내용 슬라이드에는 밝은 배경("샌드위치" 구조). 또는 프리미엄 느낌을 위해 전체적으로 어두운 배경을 사용하세요.
- 시각적 모티프를 확정하세요: 하나의 독특한 요소를 선택하고 반복하세요 — 둥근 이미지 프레임, 색상이 있는 원 안의 아이콘. 모든 슬라이드에 걸쳐 이를 유지하세요. 모티프로 컬러 바 또는 악센트 스트라이프를 사용하지 마세요 (회피 목록 참조).
색상 팔레트
주제와 일치하는 색상을 선택하고, 기본 파란색을 사용하지 마세요. 다음 팔레트를 영감으로 사용하세요:
| 테마 | 기본 | 보조 | 강조 |
|---|---|---|---|
| 미드나잇 임원 | 1E2761 (네이비) | CADCFC (아이스 블루) | FFFFFF (흰색) |
| 숲과 이끼 | 2C5F2D (포레스트) | 97BC62 (모스) | F5F5F5 (크림) |
| 코럴 에너지 | F96167 (코럴) | F9E795 (골드) | 2F3C7E (네이비) |
| 웜 테라코타 | B85042 (테라코타) | E7E8D1 (샌드) | A7BEAE (세이지) |
| 오션 그라데이션 | 065A82 (딥 블루) | 1C7293 (틸) | 21295C (미드나잇) |
| 차콜 미니멀 | 36454F (차콜) | F2F2F2 (오프 화이트) | 212121 (블랙) |
| 틸 트러스트 | 028090 (틸) | 00A896 (씨폼) | 02C39A (민트) |
| 베리 & 크림 | 6D2E46 (베리) | A26769 (더스티 로즈) | ECE2D0 (크림) |
| 세이지 칼름 | 84B59F (세이지) | 69A297 (유칼립투스) | 50808E (슬레이트) |
| 체리 볼드 | 990011 (체리) | FCF6F5 (오프 화이트) | 2F3C7E (네이비) |
각 슬라이드에 대해
모든 슬라이드에는 시각적 요소가 필요합니다 — 이미지, 차트, 아이콘 또는 도형. 텍스트 전용 슬라이드는 기억에 남지 않습니다.
레이아웃 옵션:
- 2열(왼쪽 텍스트, 오른쪽 그림)
- 아이콘 + 텍스트 행(색상이 있는 원 안의 아이콘, 굵은 헤더, 아래 설명)
- 2x2 또는 2x3 그리드(한쪽에 이미지, 다른 쪽에 콘텐츠 블록 그리드)
- 하프 블리드 이미지(왼쪽 또는 오른쪽 전체)와 콘텐츠 오버레이
데이터 표시:
- 큰 통계 콜아웃(60-72pt 큰 숫자와 아래 작은 레이블)
- 비교 열(이전/이후, 장단점, 나란히 옵션)
- 타임라인 또는 프로세스 흐름(번호가 매겨진 단계, 화살표)
시각적 마무리:
- 섹션 헤더 옆의 작은 색상 원 안의 아이콘
- 주요 통계 또는 태그라인을 위한 이탤릭체 강조 텍스트
타이포그래피
.pptx에 작성하는 글꼴 이름은 사용자의 PowerPoint에서 렌더링되며, 이 환경에서는 렌더링되지 않습니다. 시각적 QA는 LibreOffice를 통해 렌더링되며, LibreOffice는 자체적으로 가지고 있지 않은 글꼴을 대체합니다 — 그리고 일부 글꼴의 경우 대체 글꼴의 너비가 달라서 QA 미리보기에서 실제 덱에는 없을 텍스트 오버플로(또는 적합)가 표시될 수 있습니다. QA를 신뢰할 수 있게 유지하려면:
- 안전한 글꼴(QA에서 정확한 너비로 렌더링되고 Office와 함께 제공됨): Arial, Calibri, Cambria, Times New Roman, Courier New, Bookman Old Style, Century Schoolbook. 본문 텍스트 및 맞춤이 중요한 모든 항목에 사용하세요.
- 제로 QA 위험으로 개성 있는 헤더: 안전한 목록의 세리프 헤더(Cambria, Bookman Old Style, Century Schoolbook)를 안전한 목록의 산세리프 본문(Calibri 또는 Arial)과 페어링하세요. 신뢰할 수 있는 오버플로 검사를 포기하지 않고 시각적 대비를 얻을 수 있습니다.
- 사용자가 안전한 목록에 없는 글꼴(예: Georgia 또는 Trebuchet MS)을 요청하는 경우: 사용자가 요청한 곳에서 해당 글꼴을 사용하되, 해당 컨테이너의 크기에 여유를 두고(~10%) 해당 요소의 QA 텍스트 맞춤을 신뢰하지 마세요 — 해당 글꼴의 미리보기는 근사치입니다. 사용자가 지정하지 않은 경우 본문 텍스트에는 안전한 목록의 글꼴을 선호하세요.
- QA 신뢰할 수 없는 글꼴(대체 글꼴의 너비가 다름 — 오버플로 검사가 잘못될 수 있음): Georgia, Trebuchet MS, Impact, Arial Black, Garamond, Consolas, Palatino Linotype. Calibri Light 대체는 환경에 따라 다릅니다. QA 신뢰할 수 없음으로 처리하세요. 여유를 두고 제목/악센트에 사용하는 것은 괜찮지만, 이러한 글꼴의 QA 텍스트 맞춤은 신뢰하지 마세요.
- Aptos를 기본값으로 절대 사용하지 마세요 — 2023년 이후 Office의 기본값은 여기에서 메트릭 호환 대체가 없으며 이전 Office 설치에는 없으므로 양쪽 끝에서 신뢰할 수 없습니다.
| 요소 | 크기 |
|---|---|
| 슬라이드 제목 | 36-44pt 굵게 |
| 섹션 헤더 | 20-24pt 굵게 |
| 본문 텍스트 | 14-16pt |
| 캡션 | 10-12pt 흐리게 |
…
[번역을 위해 잘렸습니다]