레시피
작업 중심의 복사-붙여넣기 가능한 스니펫
레시피 인덱스
아래의 각 레시피는 Python 세션에 그대로 붙여넣어 실제 HWP 인스턴스에 대해 실행할 수 있는 자기-완결적인 스크립트입니다. HWP COM 서버가 필요한 스니펫은 eval: false 로 표시되어 있으므로, 본인의 스크립트로 복사해 Windows 환경에서 실행하세요.
이 레시피들은 v1 노트북 튜토리얼(nbs/01_tutorials/*.ipynb)과 예제 스크립트(examples/*.py)에서 이식되었으며, v2 API 표면(App.doc.* + 컬렉션 + 컨텍스트 스코프)에 맞게 다시 작성되었습니다.
| 제목 | 부제목 |
|---|---|
| .hwp 파일 폴더 일괄 처리 | 디렉토리의 모든 파일에 대해 열기 → 변환 → 저장 |
| PDF, HTML, 이미지, 텍스트로 내보내기 | 활성 문서를 HWP가 지원하는 어떤 포맷으로든 저장 |
| 그림 삽입 | v2 escape hatch 를 통해 활성 문서에 이미지 넣기 |
| 글자 서식 | 굵게, 색상, 크기 — 스코프와 ParameterSet 을 통해 |
| 데이터를 표로 | DataFrame / dict 의 list → HWP 표 |
| 디버깅 도구 | 뭔가 잘못됐을 때, 어디를 봐야 하는가 |
| 머리말과 꼬리말 | 프로그래밍 방식으로 페이지 머리말, 꼬리말, 페이지 번호 삽입 |
| 메일 머지 | 템플릿 + CSV → N개의 출력 파일 |
| 보고서 생성 | 엔드투엔드: 제목 + 텍스트 + 표 + 이미지 + PDF 내보내기 |
| 일괄 편집 | N개의 문단 서식 지정 / M개의 파일에 걸쳐 바꾸기 |
| 찾기 및 바꾸기 | 단순한 replace_all 부터 중첩된 모양 제약까지 |
| 퀵스타트 투어 | 모든 hwpapi 스크립트가 사용하는 7가지 동작 |
| 프리셋 갤러리 | 사전 제작된 서식 매크로 — 형광펜, 음영, 가로줄 |
| 필드 채우기 | dict 또는 CSV 로부터 누름틀 필드 일괄 채우기 |
일치 없음