TRAE 웹 PPT 제작流程
대학, 연구소, 기업의 PPT 템플릿을 편집 가능하고, 비율이 유지되며, 고화질로 내보낼 수 있는 HTML 슬라이드로 변환합니다. "마스터 제약 + 페이지별 레이아웃 + 스크린샷 품질 검사 + 헤드리스 브라우저 내보내기"의 완전한 순환 구조를 제공합니다.
적용 시나리오
- PPT 템플릿, 참조 스크린샷 또는 기존 HTML 마스터를 기반으로 웹 PPT 제작
- 전체 슬라이드 덱의 배너, 로고, 색상, 글꼴 및 그리드 통일
- TRAE 사용하여 페이지별 생성, 수정, 겹침 문제 수정 또는 텍스트 조정
- HTML 슬라이드를 고화질 PNG로 일괄 내보내기 (7680×4320 8K 이미지 포함)
사용자가 객체 수준 편집이 가능한 .pptx 파일을 요청한 경우, PPTX 도구를 사용해야 하며, HTML 이미지를 편집 가능한 PowerPoint로 속여서는 안 됩니다.
시작 전 확인
사용자가 이미 보유한 자료를 우선적으로 읽고, 작업 공간에 이미 있는 정보를 반복해서 요청하지 마십시오.
- 템플릿 기준: PPT, 참조 이미지, HTML 마스터 페이지 또는 브랜드 가이드라인
- 페이지 내용: 개요, 각 페이지 제목, 핵심 사항, 데이터, 이미지 및 참고 문헌
- 고정 사양: 페이지 비율, 주 색상, 글꼴, 로고, 머리글/바닥글 및 반드시 유지해야 할 요소
- 전달 형식: HTML 소스 파일, 로컬 자료, 미리보기 이미지, 8K 이미지 또는 내보내기 진입점
핵심 정보가 아닌 경우 합리적인 기본값 사용: 16:9, 시스템 글꼴, 로컬 자료, 1920×1080 품질 검사. 제작을 막는 누락 내용이 있을 때만 질문합니다.
핵심 원칙
- 마스터를 먼저 분해하고, 그 다음 페이지를 작성하십시오: 스타일을 추측하면서 생성하지 마십시오.
- 마스터 요소는 불변 항목입니다: 배너, 로고, 주 색상, 제목 위치 및 콘텐츠 영역 그리드는 페이지마다 변경되어서는 안 됩니다.
- 레이아웃 크기를 상대적으로 설정하십시오: 위치, 너비, 높이, 글꼴 크기 및 간격은
cqw/cqh를 사용하고, 레이아웃 제어에 고정px를 혼용하지 마십시오. - 한 페이지에 하나의 주요 표현 구조: 인접 페이지 간에 무의미한 "왼쪽 그림, 오른쪽 텍스트" 반복을 피하십시오. 비교 페이지 등 특수한 경우는 예외입니다.
- 자료는 로컬에 저장: 임시 이미지 호스팅에 의존하지 마십시오. 실제 사진은 출처가 명확해야 하며, 개념도는 우선 인라인 SVG를 사용하십시오.
- 각 페이지 스크린샷으로 검수: 코드에 오류가 없다고 해서 화면이 올바른 것은 아니므로 반드시 렌더링 결과를 확인해야 합니다.
- 최소 범위 수정: 단일 페이지 문제를 수정할 때 다른 모듈을 임의로 재배치하거나 전체 마스터를 변경하지 마십시오.
표준 워크플로우
1단계: 템플릿 분해, 불변 항목 설정
참조 템플릿에서 다음을 추출하고 기록합니다.
| 카테고리 | 확인해야 할 내용 |
|---|---|
| 배너 | 배경, 로고 위치, 제목 위치, 장식선, 고정 높이 |
| 색상 | 주 색상, 보조 색상, 본문 색상, 회색조, 강조 색상 사용 규칙 |
| 글꼴 | 제목 글꼴, 본문 글꼴, 글꼴 크기 계층, 글꼴 두께 |
| 그리드 | 좌우 안쪽 여백, 콘텐츠 영역 시작점, 열 간격, 바닥글 위치 |
| 가변 항목 | 각 페이지 제목, 부제목, 본문 구조, 이미지 및 차트 |
시스템 기본 글꼴을 우선 사용하여 다른 컴퓨터에서 외부 글꼴이 적용되지 않는 문제를 방지하십시오. 참조 이미지를 복제해야 하는 경우 "위치, 크기, 글꼴, 색상이 참조와 일치"를 하드 제약 조건으로 작성하고, "스타일이 비슷함"만으로 작성하지 마십시오.
2단계: 16:9 기술 기반 구축
모든 페이지는 동일한 컨테이너 로직을 공유합니다.
/* 슬라이드 컨테이너: 16:9 유지, 컨테이너 쿼리 크기 단위 활성화 */
.slide {
width: min(100vw, calc(100vh * 16 / 9));
aspect-ratio: 16 / 9;
position: relative;
overflow: hidden;
container-type: size;
}
/* 페이지 요소: 컨테이너를 기준으로 위치 지정, 창 크기를 조정해도 비율 유지 */
.title {
position: absolute;
top: 6.5cqh;
left: 4cqw;
font-size: 2.5cqw;
}
container-type: size는 cqw/cqh가 작동하는 데 필수적입니다. 1920×1080 캔버스에서 1cqw = 19.2px, 1cqh = 10.8px입니다. 창을 축소하거나, 프로젝션을 확대하거나, 고배율로 내보낼 때 레이아웃 비율이 일관되게 유지됩니다.
3단계: 마스터 페이지 제작
먼저 소수의 기준 페이지를 완성한 후 나머지 페이지를 일괄 생성합니다.
- 표지 페이지: 주제목, 발표자, 소속, 날짜 및 브랜드 비주얼
- 본문 마스터 페이지: 고정 배너, 제목 영역, 콘텐츠 그리드 및 바닥글
- 마무리 페이지: 결론, 감사 인사 또는 참고 문헌, 내용에 따라 용도 구분
마스터 검수가 완료되면 이를 후속 페이지의 구조 및 스타일 기준으로 사용합니다. 기존 페이지를 수정하기 전에 반드시 파일을 읽어야 하며, 파일 이름만으로 구조를 추측해서는 안 됩니다.
4단계: 페이지별 생성, 콘텐츠 구조에 맞추기
새 페이지를 생성할 때마다 다음 다섯 가지를 명확히 작성합니다.
- 어떤 마스터 페이지를 참조하며, 어떤 요소를 변경하지 않고 유지할지
- 페이지 비율, 파일 이름 및 저장 위치
- 현재 페이지의 제목, 핵심 사항, 데이터 및 결론
- 현재 페이지에 사용된 레이아웃과 이전 페이지와의 차이점
- 이미지 출처, 로컬화 요구 사항 및 저작권 제약
콘텐츠에 따라 레이아웃을 선택할 수 있으며, 참신함을 위해 정보 표현을 희생하지 마십시오.
| 콘텐츠 유형 | 권장 구조 |
|---|---|
| 표지 | 중앙 큰 제목, 브랜드 배너, 단일 메인 비주얼 |
| 병렬 항목 | 동일 너비 카드 배열, 분할 열 비교 |
| 프로세스 및 단계 | 계단, 타임라인, 점진적 배너 |
| 인과 관계 | 체인, 화살표 프로세스, 중심 방사형 |
| 핵심 개념 | 중앙 다이어그램 + 주변 설명 |
| 구조 및 원리 | 단면도, SVG 다이어그램 + 핵심 사항 |
| 데이터 및 대시보드 | 차트, 지표 카드, 양면 패널 |
| 다차원 정보 | 2×2 그리드, 매트릭스, 그룹화된 카드 |
| 결론 | 중심 논점, 수직 축 요약, 소량의 핵심 숫자 |
| 참고 문헌 | 문헌 표지 또는 출처 스크린샷 + 정리된 목록 |
| 감사 인사 | 큰 글꼴의 짧은 문구 + 메인 비주얼, 모듈 쌓기 최소화 |
5단계: 이미지 선택 방법
다음 우선순위에 따라 선택합니다.
- 실제 사진: 사용자가 제공했거나 권한이 명확한 자료를 우선 사용. 공개 자료는 라이선스를 확인하고 출처를 기록해야 함
- 인라인 SVG: 격자, 결함, 단면, 프로세스, 인과 관계 체인 등 직접 촬영할 수 없는 개념에 적합
- CSS 그래픽: 계단, 스펙트럼 막대, 배지, 지표 배경색 등 단순하고 장식적인 인포그래픽에 적합
모든 이미지는 로컬에 저장하고 참조 경로를 확인하십시오. 콘텐츠와 관련 없는 AI 분위기 이미지를 레이아웃을 채우는 데 사용해서는 안 됩니다.
6단계: 페이지별 시각적 품질 검사
Windows에서는 Edge의 헤드리스 모드를 호출하여 1920×1080 품질 검사 이미지를 생성할 수 있습니다. 실제 브라우저 경로와 파일 경로에 따라 조정합니다.
$edge = "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe"
& $edge --headless=new --disable-gpu --hide-scrollbars `
--virtual-time-budget=6000 --window-size=1920,1080 `
--screenshot="_chk.png" "file:///absolute/path/to/page.html"
페이지별로 다음을 확인합니다.
- 페이지가 16:9로 완전히 표시되고, 예상치 못한 스크롤바가 없음
- 요소 넘침, 잘림, 겹침 또는 모듈 간 간격이 너무 가깝지 않음
- 모든 이미지가 성공적으로 로드되었으며, 빈 자리 표시자나 깨진 이미지가 없음
- 제목, 본문, 그림 설명의 계층 구조가 명확하고, 고립된 단어나 비정상적인 줄바꿈이 없음
- 배너, 로고, 색상 및 그리드가 마스터와 일치
- 데이터, 단위, 연도, 용어 및 참고 문헌의 표기가 일치
- 창을 축소한 후에도 비율이 유지되며, 고정 픽셀 요소가 레이아웃을 깨뜨리지 않음
문제 발견 시 먼저 근본 원인을 파악하고, 관련 스타일이나 요소만 수정한 후 다시 스크린샷을 확인하십시오. 각도 표시, 머리글 등 요소를 삭제할 때는 해당 HTML, CSS 및 페이지 제목을 함께 확인하여 잔여물이 남지 않도록 하십시오.
7단계: 고화질 이미지 내보내기
1920×1080 뷰포트와 4배 장치 배율을 사용하여 7680×4320 PNG를 내보냅니다.
& $edge --headless=new --disable-gpu --hide-scrollbars `
--virtual-time-budget=6000 --window-size=1920,1080 `
--force-device-scale-factor=4 `
--screenshot="export/page.png" "file:///absolute/path/to/page.html"
이 방식은 브라우저가 고배율로 텍스트, CSS 및 SVG를 다시 렌더링하도록 하며, 저해상도 비트맵을 8K로 늘리는 것이 아닙니다.
일괄 내보내기 시에는 프로젝트에 이미 있는 스크립트를 우선 재사용하십시오. 프로세스가 종료된 후에도 파일이 존재하고, 크기가 정확하며, 디스크에 완전히 기록되었는지 확인해야 하며, 명령 종료 코드만으로 성공 여부를 판단해서는 안 됩니다.
8단계: 전달물 정리
다음과 같이 명확하고 재사용 가능한 디렉토리 구조를 권장합니다.
project/
├── 001.html ... NNN.html
├── assets/
│ ├── images/
│ └── logos/
├── export/
└── html2img_8k.py # 프로젝트에 이미 있거나 사용자가 요청한 경우 제공
전달 시 소스 파일, 자료 디렉토리, 내보내기 디렉토리 및 사용자가 아직 보충하지 않은 정보를 나열하고, 임시 품질 검사 스크린샷을 최종 결과물에 혼합하지 마십시오.
재사용 가능한 프롬프트
새 페이지 생성
[마스터 페이지 경로]를 기반으로 [새 페이지 파일 이름]을 생성해 주세요.
1. 16:9, 배너, 로고, 글꼴, 색상 및 그리드를 변경하지 않고 유지
2. 제목은 [제목], 내용은 [핵심 사항 A][핵심 사항 B][핵심 사항 C] 포함
3. [지정된 레이아웃] 사용, 인접 페이지와 구조적 차별화
4. 페이지 내 위치, 크기, 글꼴 크기 및 간격은 cqw/cqh 사용
5. 이미지는 로컬화하고 출처를 명시, 완료 후 1920×1080 스크린샷 품질 검사 수행
시각적 문제 수정
[페이지 경로]에서 [특정 모듈]에 [겹침/넘침/깨진 이미지/줄바꿈]이 발생한 근본 원인을 찾아주세요.
관련 문제만 수정하고, 다른 모듈과 마스터는 변경하지 마십시오. 수정 후 다시 스크린샷으로 검증하세요.
텍스트 조정
[페이지 경로]의 [원본 텍스트]를 [새 텍스트]로 바꿔 주세요.
기존 레이아웃을 유지하고, 한 줄 표시, 고립된 단어, 넘침 및 모듈 간격을 확인하세요.
일반적인 문제
| 문제 | 우선 확인 사항 |
|---|---|
cqw/cqh가 작동하지 않음 | 컨테이너에 container-type: size가 설정되었는지, 요소가 해당 컨테이너 내에 있는지 확인 |
| 컴퓨터 변경 후 글꼴 변경 | 외부 글꼴 또는 설치되지 않은 글꼴을 사용하는지 확인, 시스템 글꼴 스택으로 변경 |
| 이미지 빈 공간 또는 404 | 파일 이름, 대소문자, 상대 경로, 특수 문자 및 제로 너비 공백 확인 |
| 파일 이름에 제로 너비 공백 U+200B 포함 | 파일 이름 변경 또는 문자를 %E2%80%8B로 URL 인코딩 |
| 모듈이 제목 영역으로 침범 | 콘텐츠 영역 시작점, 모듈 높이, 계단식 상승량이 너무 큰지 확인 |
| 단락에 고립된 단어 발생 | 먼저 텍스트 최적화, 그 다음 글꼴 크기 또는 컨테이너 너비 미세 조정 |
| 페이지 스타일 점진적 변화 | 마스터를 무시하고 자유롭게 작업했는지 확인, 불변 항목 재확인 |
| 8K 이미지 흐림 | 기존 스크린샷을 확대한 것이 아닌, 4배 장치 배율로 다시 렌더링했는지 확인 |
| 내보내기 파일 불완전 | 페이지 렌더링 및 파일 디스크 쓰기 안정화를 기다렸는지 확인 |
완료 기준
다음 조건이 모두 충족되어야만 완료된 것으로 간주합니다.
- 마스터와 전체 페이지 세트의 스타일이 일관되고, 콘텐츠 페이지 구조가 정보 표현에 기여함
- 새로 추가되거나 수정된 모든 페이지가 실제 렌더링 검사를 거침
- 이미지, 글꼴, 로고 및 스크립트 참조가 사용 가능하며, 자료가 로컬화됨
- 내보낸 이미지 크기가 요구 사항을 충족하며, 8K 출력은 7680×4320임
- 전달 디렉토리가 명확하고, 임시 파일과 최종 결과물이 분리됨