Editorial PPTX Deck
정제된 편집적 미니멀리즘 슬라이드 덱을 제작하고 편집 가능한 PPTX로 내보냅니다. 최종 산출물은 .pptx만 입니다. HTML 슬라이드는 빌드 소스일 뿐이며, PDF 또는 HTML 뷰어는 생성하지 않습니다.
작동 방식
슬라이드는 제한된 HTML(슬라이드당 하나의 파일)로 작성된 후, scripts/html2pptx.js가 각 DOM 요소를 네이티브 파워포인트 객체(실제 더블클릭하여 편집 가능한 텍스트 상자)로 변환합니다. 본문은 1280px × 720px = 960pt × 540pt(LAYOUT_WIDE)로 고정됩니다.
빌드 워크플로우
이 체크리스트를 복사하여 진행 상황을 추적하세요:
- [ ] 1. 프로젝트 스캐폴딩 (shared/ assets/ slides/ output/)
- [ ] 2. 내러티브 계획 → 각 슬라이드를 템플릿 유형에 매핑
- [ ] 3. 템플릿에서 slides/NN-name.html 작성 (텍스트만 편집)
- [ ] 4. check_overflow → 정확히 1280x720이 아닌 슬라이드 수정
- [ ] 5. PPTX 내보내기 (전용)
- [ ] 6. 빌드 소스 정리 (.pptx만 남김)
1. 스캐폴딩. 작업 프로젝트에 shared/, assets/, slides/, output/를 생성하세요. 이 스킬의 shared/tokens.css를 프로젝트의 shared/에 복사하세요. 이 스킬의 assets/에서 사용할 사진만 프로젝트의 assets/에 복사하세요. 종속성을 한 번 설치하세요:
npm i pptxgenjs playwright sharp && npx playwright install chromium
2. 계획. 원본 콘텐츠를 슬라이드 목록으로 전환하세요. 모든 슬라이드는 템플릿 유형 중 하나입니다. 일반적인 덱 = 커버 → (구분선 → 1~3개의 콘텐츠 슬라이드) × 섹션 → 클로징입니다. 텍스트는 간결하게 유지하세요. 이 스타일은 여유롭습니다.
3. 슬라이드 작성. templates/에서 가장 가까운 템플릿을 slides/NN-name.html로 복사하고 텍스트를 교체하세요. 규칙:
<link rel="stylesheet" href="../shared/tokens.css">를 유지하세요.- 제목은 세리프체를 사용하고, 나머지는 산세리프체를 사용합니다(이미 토큰에 설정됨).
- 빨간색 악센트는 하나만 사용하세요. 어두운 패널(
--ink-panel)은 대비를 위해 제한적으로 사용하며, 금색#C9A24B만이 유일한 악센트입니다. - 사진은
<img>를 통해 넣습니다(CSSbackground-image절대 사용 금지). 사진 라이브러리를 참조하세요.
4. 맞춤 확인. 넘치는 슬라이드는 PPTX에서 잘립니다:
node scripts/check_overflow.mjs --slides slides
OVERFLOW로 표시된 항목을 모두 수정(텍스트를 줄이거나 위치 조정)하여 모든 항목이 1280x720을 보고할 때까지 반복하세요.
5. PPTX만 내보내기.
node scripts/export_deck_pptx.mjs --slides slides --out output/DeckName.pptx
슬라이드는 파일 이름(01-…, 02-…) 순서로 정렬됩니다. PDF나 HTML 내보내기를 실행하지 마세요. PPTX가 유일한 산출물입니다.
6. 정리. slides/의 HTML 파일과 임시 파일을 모두 삭제하여 output/DeckName.pptx만 남기세요(사용자가 반복 작업을 원할 경우 재사용 가능한 shared/ + assets/는 남겨둡니다).
디자인 시스템
shared/tokens.css에 정의되어 있습니다. 새로운 색상을 임의로 만들지 마세요.
| 토큰 | HEX | 용도 |
|---|---|---|
--ink | #1A1A1A | 제목 및 주요 본문 |
--soft | #555555 | 보조 본문 |
--muted | #8C8C8C | 레이블, 메모, 페이지 번호 |
--red | #C8102E | 유일한 악센트: 막대, 킥커, 키워드, 밑줄 |
--red-deep | #A00C24 | 표에서 부정적 강조 |
--red-pale | #FBE9EC | 연결 칩 (예: "→" 원) |
--box | #F4F3F1 | 밝은 카드 / 얼룩말 행 |
--line | #E4E2DE | 가는 구분선 |
--ink-panel | #1C1C1C | 어두운 대비 패널 |
| gold | #C9A24B | 어두운 패널에서만 악센트 |
| background | #FFFFFF | 페이지 |
- 서체:
h*/제목에는 Georgia 세리프; 그 외 모든 것은 Arial/Helvetica 산세리프. - 시그니처: 제목 왼쪽의 얇은 빨간색 세로 막대 + 그 위에 작은 자간이 넓은 빨간색 킥커; 하단 중앙의 아주 작은 페이지 번호.
- 브랜드 교체: 다른 회사에 맞추려면
tokens.css에서--red(그리고 선택적으로--ink-panel/gold)만 변경하세요. 다른 것은 건드리지 마세요.
사진 라이브러리
사진은 이 스킬의 assets/에 있습니다. 세로 이미지는 오른쪽 약 40% 구분선/커버 패널을 채우고(object-fit:cover), 가로 이미지는 전체 채움 커버에 적합합니다.
| 파일 | 방향 | 최적 용도 |
|---|---|---|
sail.png | 세로 589×1024 | 구분선 / 커버 오른쪽 패널 (기본) |
lighthouse-cliff.png | 세로 627×1024 | 구분선 / 커버 오른쪽 패널 |
staircase.png | 긴 세로 312×1024 | 차분/추상 구분선 스트립 |
mast.png | 좁은 208×1024 | 좁은 구분선 스트립 |
hiker-clouds.png | 좁은 225×1024 | 좁은 구분선 스트립 |
lighthouse-sunset.png | 가로 1024×721 | 전체 채움 커버 / 상단 밴드 |
sailboat-deck.png | 가로 1024×721 | 전체 채움 커버 / 상단 밴드 |
<img src="../assets/….png">를 변경하여 사진을 교체하세요. 모든 구분선에 걸쳐 일관된 사진 한 장(또는 하나의 모티프)을 유지하여 통일감을 주세요. 사용자는 자신의 이미지를 assets/에 직접 넣을 수도 있습니다.
템플릿 카탈로그
templates/에 있음 (각각은 완전하고 오버플로우에 안전한 1280×720 슬라이드):
| 파일 | 유형 |
|---|---|
01-cover.html | 분할 커버: 왼쪽 세리프 제목, 오른쪽 세로 사진 |
02-divider.html | 섹션 구분선: 킥커 + 세리프 제목 + 빨간 막대, 오른쪽 세로 사진 |
03-three-column.html | 킥커/제목 + 핵심 라인 + 3개 열 + 결과 스트립 |
04-mapping.html | 두 열 "그들이 원하는 것 → 우리가 하는 것" 연결 칩 포함 |
05-compare-table.html | 3열 비교 표, 얼룩말 행 |
06-dark-contrast.html | 두 패널 (밝음 vs 어두움) + 세리프 하단 라인 |
07-pipeline.html | 번호가 매겨진 가로 단계 파이프라인 + 어두운 출력 막대 |
08-closing.html | 클로징 피치: 번호가 매겨진 세리프 라인 + 오른쪽 세로 사진 |
엄격한 제약 조건
다음 조건을 위반하면 HTML→PPTX 변환이 실패하거나 잘못 렌더링됩니다. 전체 세부 사항 및 해결 방법은 reference.md를 참조하세요:
- 텍스트는
<p>/<h1>–<h6>내부에만 위치해야 합니다 (<div>에 느슨한 텍스트 금지). - CSS 그라데이션 사용 금지.
background/border/box-shadow는<div>에만 적용하고, 텍스트 태그에는 절대 적용하지 마세요.background-image사용 금지;<img>를 사용하세요.- 인라인 태그(
span/em/strong)는 마진을 가질 수 없습니다. - 본문은 1280×720을 유지해야 하며, 어떤 것도 넘쳐서는 안 됩니다.
