메뉴
HWPX(한글) 문서를 XML 수준에서 편집합니다. 부동 개체(서명·직인) 배치, 이미지 교체, 표 셀 수정, 다른 문서를 도너로 삼은 교차 빌드, 빌드 후 무결성 검증을 다룹니다. 'hwpx', '한글 문서', '서명 위치', '직인', '그림이 검게 나옴', '표 셀 편집', '도너' 키워드에 사용합니다.
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/Dayoooun/dayoun-marketplace --skill edit-hwpx명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
승인된 내용을 원본 보존 작업용 HWPX에 반영하고, 사용자의 디자인 지시 또는 '알아서 보기 좋게' 요청에 맞춰 표·문단·시각자료·타이포·여백을 주도적으로 설계할 때 사용한다. HWP→HWPX 준비, 중괄호 치환, 의미 기반 시각자료 배치, 구조검사, PDF/PNG 화면검수까지 수행한다.
PPT·PPTX·파워포인트·슬라이드·발표자료·발표덱·피치덱·IR덱·제안서·강의자료를 새로 만들거나 수정·리디자인·PDF 변환·대본·예상 Q&A까지 요청하면 스킬명을 말하지 않아도 즉시 사용하는 통합 하네스. scene-deck과 image-first를 지원하고, 모든 제목·본문·캡션·대본·Q&A는 사실·수치·고유명사·URL·명령을 보호한 한국어 윤문을 반드시 거친 뒤 PPTX/PDF로 렌더한다. Windows와 macOS 지원.
사업계획서 작업을 시작할 때 원본, 사업 정보, 요구사항, 양식, 조사자료, 초안, 검토본, 최종본을 안전한 폴더 구조로 정리한다. 사용자가 사업계획서 프로젝트 만들기, 자료 정리, 폴더 생성, 작업 환경 준비를 요청할 때 사용한다.
SKILL.md 표시 중
| name | edit-hwpx |
| description | HWPX(한글) 문서를 XML 수준에서 편집합니다. 부동 개체(서명·직인) 배치, 이미지 교체, 표 셀 수정, 다른 문서를 도너로 삼은 교차 빌드, 빌드 후 무결성 검증을 다룹니다. 'hwpx', '한글 문서', '서명 위치', '직인', '그림이 검게 나옴', '표 셀 편집', '도너' 키워드에 사용합니다. |
HWPX 는 ZIP + XML 이라 파이썬 표준 라이브러리만으로 편집할 수 있습니다. 다만 한글 고유의 좌표계·캐시·매니페스트 규칙을 모르면 열리기는 하는데 화면이 깨진 문서가 나옵니다.
이 스킬은 한컴 공식 OWPML 모델 소스(github.com/hancom-io/hwpx-owpml-model, Apache-2.0)와
실무 문서 43개 / <hp:pic> 276개 전수 실측으로 확인한 규칙만 담았습니다.
상세는 references/hwpx-structure.md 를 읽으세요. 아래는 가장 자주 사고가 나는 4가지입니다.
treatAsChar 를 보세요표와 그림에 각각 규칙이 있습니다. 하나로 통일하면 안 됩니다.
표
| 표 | 값 |
|---|---|
| 제목·헤더·업체정보 | 1 (글자처럼) — 부동이면 서명이 엉뚱한 칸으로 |
| 본문 서술(2행1열)·증빙자료 | 0 (부동) — 길어서 페이지를 넘겨야 함 |
그림
| 그림 | 값 |
|---|---|
| 표 안 사진 | 1 — 부동이면 셀을 벗어나 표가 깨집니다 |
| 서명·직인 | 0 — 앵커 문단 기준 자유 배치 |
실측: 표 안 사진은 정상본 9/9 전부 1.
부동 서명·직인은 앵커 문단이 제목 문단(idx 0) 이어야 합니다.
treatAsChar=0 이고 표 밖에 있어도 앵커가 표 안 문단이면 그 셀을 밀어내 표가 늘어납니다(§11).
상세는 references/hwpx-structure.md §10.
사진 정렬은 hp:pic 이 아니라 담긴 문단의 paraPr 이 결정합니다.
표 앵커를 바꾸면 서명 좌표를 다시 잡아야 합니다.
hp:pos 가 결정합니다<hp:pic> 안에 좌표계가 둘 있는데 역할이 다릅니다.
| 요소 | OWPML 클래스 | 언제 쓰이나 |
|---|---|---|
<hp:offset x y> | CASCOffset (ASC = As-Character) | treatAsChar="1" (글자처럼 배치)일 때만 |
<hp:pos vertOffset horzOffset> | CPos | treatAsChar="0" (부동)일 때 유일한 결정자 |
부동 개체에서 hp:offset 을 아무리 고쳐도 화면은 안 움직입니다.
(검증: offset y 를 9종으로 바꿔 렌더 → md5 전부 동일)
vertRelTo="PARA" 는 앵커 문단이 기준입니다. 양식이 다르면 좌표를 이식하지 마세요.
앵커 문단이 다르면 같은 값이 다른 위치를 가리킵니다.
orgSz 는 건드리지 않습니다<hp:curSz> = 표시 크기 → 여기만 조정<hp:orgSz> = 원본 기준 크기(예: 485040x159960) → 수정 금지orgSz 에 픽셀값을 넣으면 배율이 26배로 튀어 그림이 페이지를 덮습니다.
이미지를 교체할 때는 폭은 유지하고 높이만 새 이미지 비율로 재계산합니다.
cw = 기존_curSz_width
ch = round(cw * new_img_h / new_img_w)
<hp:cellAddr colAddr rowAddr> 은 <hp:tbl> 마다 0부터 다시 시작합니다.
문서에 c1 r0 이 여러 개라 좌표로 찍으면 첫 번째 표가 걸립니다.
좌표 대신 기존 값을 지문으로 삼아 치환하세요.
x = x.replace("<hp:t>%s</hp:t>" % esc(old), "<hp:t>%s</hp:t>" % esc(new), 1)
다른 문서를 도너로 삼아 빌드할 때 텍스트만 바꾸면 사진·서명이 도너 것으로 남습니다.
이미지를 지웠다면 Contents/content.hpf 의 <opf:item> 도 반드시 함께 지웁니다.
매니페스트에 파일 없는 항목이 남으면 한글이 그림 영역을 통째로 검게 그립니다.
# ✗ [^/]* 는 href="BinData/..." 의 슬래시에서 끊깁니다
re.sub(r'<opf:item id="%s"[^/]*/>' % iid, '', manifest)
# ✓
re.sub(r'<opf:item id="%s"[^>]*/>' % iid, '', manifest)
python3 scripts/hwpx_verify.py <파일.hwpx> [--donor <도너.hwpx>]
--donor 를 주면 도너 업체 정보·이미지가 잔존하는지까지 검사합니다.
검사 항목: XML 유효성 / 매니페스트 유령 항목 / 미치환 placeholder / mimetype 압축방식 / 부동 개체 pos 누락 / orgSz 이상값 / curSz 비율 불일치 / 도너 잔존.
rhwp CLI (Rust, MIT, ★3.7k) 로 한글 없이 변환합니다. macOS aarch64 네이티브 바이너리 제공.
rhwp export-pdf input.hwpx -o output.pdf --profile print
rhwp-python 바인딩은 같은 코어지만 <hp:checkBtn> 을 안 그립니다xattr -dr com.apple.quarantine 필수 — 안 하면 실행이 무한 대기합니다grep -vE "DEBUG_TAB_POS|LAYOUT_OVERFLOW"CUPS 가상 프린터(SIP 차단)·LibreOffice(.hwpx 필터 없음)는 검증 후 배제했습니다.
상세는 references/hwpx-to-pdf.md.
접힌 줄이 왼쪽 끝으로 붙는 문제는 맥에서 코드로 잡힙니다. rhwp 는 표 셀 문단의
paraPr margin intent 를 렌더에 반영합니다. "표 셀은 intent 가 무시된다"는 통설은
오진이었습니다 (2026-08-27 실측).
python scripts/hwpx_hanging.py in.hwpx out.hwpx --markers □
python scripts/hwpx_hanging.py out.pdf --check # 게이트: MISS 0 이어야 통과
단일 intent 를 쓰면 안 됩니다. 접힌 줄은 그 문단 첫 글자 x 에 맞아야 하는데 접두사 폭이 패턴마다 다릅니다 (HWPUNIT = pt × 100):
| 문단 | 필요한 intent | 문서 |
|---|---|---|
□ 1. … / ○ (라벨) … | -1350 | 부산신보 2회차 |
- … (전각공백+대시) | -1725 | 부산신보 2회차 |
- (목표) … (반각 3칸) | -3086 | 경남신보 중간결과보고서 |
스크립트가 원본을 렌더해 실측하고, 결과를 다시 렌더해 남은 오차만큼 보정합니다
(기본 3회). 값을 손으로 넣지 마세요. 1패스로는 원본이 이미 intent 를 가진 문서에서
틀립니다 — 경남신보 paraPr 20 은 -3660 이 이미 들어 있는데도 5.7pt 어긋나 있었습니다.
left 는 건드리지 않습니다. intent 단독으로 완성됩니다linesegarray 를 지우지 않습니다. 지우면 vertRelTo="PARA" 부동 서명이 앵커를 잃고 떠오릅니다2. …)은 내용으로 거릅니다. 불릿 좌측에서 정확히 글자 한 칸 왼쪽이라
좌표로는 분리되지 않습니다. 단 한 자리 번호만 — 16. 완납 은 진짜 접힌 줄입니다--check 가 원본 HWPX 를 읽어 자동 판정⚠️ rhwp 는 <hp:switch> 의 hp:case(HwpUnitChar) 만 읽고 hp:default 는 무시합니다.
6종 변형 렌더 대조로 확정했습니다. 두 분기 값이 다른 문서가 실제로 있으므로
(경남신보 case=-3660 / default=-7320) 양쪽을 같은 값으로 맞춰 써야 합니다.
⚠️ 측정 함정: 전각·반각 공백은 렌더 시 여백으로 흡수돼 PDF 텍스트에 남지 않습니다.
기준점은 줄 시작 x 가 아니라 셀 좌측(페이지 내 마커 줄 최소 x)이고, 값 조회는
선행공백을 뺀 마커만으로 폴백해야 들여쓴 불릿이 보정에서 빠지지 않습니다.
상세는 references/hwpx-to-pdf.md §7.
.hwp(구 바이너리 포맷) 편집. 이 스킬은 .hwpx(OWPML) 전용입니다.