python-hwpx

시작하기

  • 5분 안에 HWPX 문서 다루기
    • 준비물
    • 1. 새 문서 만들고 저장하기
    • 2. 기존 문서 열어 수정하기
    • 3. 문서 읽기 — 텍스트 추출
    • 4. 첫 성공 다음에 자주 하는 편집
    • 5. 저장에는 영수증이 따라온다
    • 6. 저장 방식 더 보기
    • 7. 파일이 없으면 기본 템플릿 바이트로 열기
    • 다음 단계
  • 설치 가이드
    • 요구 사항
    • PyPI에서 설치
    • 소스 코드에서 개발용 설치
    • 설치 검증
    • 테스트 실행 (선택 사항)
  • 순회 레시피 — 문서에서 원하는 것 꺼내기
    • 문단 텍스트를 전부 읽기
    • 중첩 표 안까지, 위치 정보와 함께 통독하기
    • 각주·미주를 본문과 함께 추출하기
    • 표를 찾아 셀 문단 읽기
    • 런 단위로 서식과 함께 순회하기
    • 메모와 누름틀(필드) 나열하기
    • 다음 단계
  • 편집 의미론 — 무엇이 돌아오고, 어떻게 실패하고, 다시 실행하면 어떻게 되나
    • 핵심 편집 호출 계약
    • 저장 의미론
    • 알아둘 캐비앗 (정직 고지)
    • 다음 단계
  • 사용 가이드
    • CLI 워크플로
    • 빠른 예제 모음
    • 패키지 열기와 기본 점검
    • HwpxDocument로 문서 편집하기
    • 단락 삭제
    • 섹션 추가·삭제
    • 메모 다루기
    • 스타일 기반 텍스트 변환
    • 본문 데이터 모델 살펴보기
    • 런 서식 지정
    • 텍스트 추출과 주석 표현
    • ObjectFinder로 요소 검색하기
    • 변경 사항 저장과 결과물 확인
    • 제안서 프리셋 — 5.0에서 이동
    • 응용 워크플로 — automation 문서로 이동
  • 실전 예제
    • 0. 빈 문서를 생성해 실습 환경 만들기
    • 1. 보고서 템플릿에 표와 개체 추가하기
    • 2. 단락 삭제와 섹션 관리
    • 3. 하이라이트와 주석을 포함한 텍스트 보고서 생성하기
    • 4. 특정 태그를 검색해 요약 정보 만들기
    • 5. 선언형 document plan과 양식 워크플로

심화 주제

  • 실측 코퍼스 메트릭 (M9 Published Corpus)
    • 최신 측정 (2026-08-03 · corpus v3 · N=120 produced + 3 negative controls)
    • 왕복 충실도 (2026-08-19 · roundtrip v1 · N=76 실한컴 저장본)
    • 이전 전수 측정 (2026-07-19 · corpus v2 · N=497 produced + 9 negative controls)
    • 양식 채움 fit 실측 (S-085, 2026-07-20)
    • 구조결함 1차 실측 (S-087, 2026-07-20)
    • 구조결함 2차 실측 (2026-07-21)
    • 릴리스별 히스토리
    • 방법론 요약
  • 채택·응답 지표
    • 최근 스냅샷 (2026-07-30 UTC)
    • 측정 정의
    • 왜 이렇게 재나
  • 지원 매트릭스 (Support Matrix)
    • 매트릭스
    • 6.0 표면 위치
    • 상태 판정 근거 요약
    • 관련 문서
  • 안정 API 표면 (Stable API)
    • 계층 정책
    • stable (34)
    • experimental (23)
    • 5.0에서 제거된 deprecated 표면 (4)
    • 오류 계약 (4.0.0 도입)
    • 스키마 동결 정책
  • 4.x 호환 표면 관찰 정책
    • 현재 결정
    • 전체 family 판정
    • CLI와 스키마/리포트
    • 알려진 독립 사용
    • 이행과 rollback
    • 관찰 종료 뒤
  • 안전한 쓰기 계약 (Safe Write Contract)
    • 파라미터
    • 사용 예
    • MutationReport
    • PreservationDowngradeError
    • 편집 계획 실행기와의 관계 (hwpx.plan, 5.6.0+)
    • 관련 문서
  • HWPX 스키마 구조와 파이썬 모델 현황
    • DevDoc 스키마 자료 한눈에 보기
    • 주요 스키마 세부 구조
    • 파이썬 구현 현황 요약
    • 주요 누락 요소 및 확장 필요 영역
  • HWPX/OWPML 내부 실전 가이드
    • HWPUNIT 좌표계
    • hp:linesegarray — 조판(줄나눔) 캐시
    • 목차 필드(TABLEOFCONTENTS)와 dirty=”1”
    • OPC/ZIP 컨테이너 재패킹
    • 메모(hp:memo) 구조
    • 한/글 export 기반 검증의 한계
    • 문서 목록
    • 읽는 순서
    • 전제
  • 자주 묻는 질문 (FAQ)
    • ModuleNotFoundError: No module named 'hwpx' 오류가 발생합니다.
    • HwpxStructureError 예외가 발생하는 이유는 무엇인가요?
    • hwpx.package.HwpxPackage와 hwpx.opc.package.HwpxPackage의 차이는 무엇인가요?
    • 파일을 메모리 버퍼나 HTTP 응답으로부터 열 수 있나요?
    • 중첩 문단을 제외하거나 특정 섹션만 순회하려면 어떻게 해야 하나요?
    • 저장 시 원본 파일을 덮어쓰지 않고 새 파일로 만들고 싶습니다.
    • 단락을 삭제하면 오류가 발생합니다.
    • 섹션을 추가하면 한/글에서 보이지 않습니다.
  • 변경 로그
    • [6.3.0] - 2026-08-19
    • [6.2.1] - 2026-08-19
    • [6.2.0] - 2026-08-19 (보존된 실패 태그 — PyPI 미발행)
    • [6.1.0] - 2026-08-15
    • [6.0.3] - 2026-08-11
    • [6.0.2] - 2026-08-04
    • [6.0.1] - 2026-08-04 (preserved failed tag — nothing published)
    • [6.0.0] - 2026-08-04 (preserved failed tag — nothing published)
    • [5.8.0] - 2026-08-03
    • [5.7.0] - 2026-08-03
    • [5.6.0] - 2026-08-03
    • [5.5.0] - 2026-08-02
    • [5.4.0] - 2026-08-01
    • [5.3.0] - 2026-07-31
    • [5.2.0] - 2026-07-31
    • [5.1.1]
    • [5.1.0]
    • [5.0.2]
    • [5.0.1]
    • [5.0.0]
    • [4.2.0] - 2026-07-22
    • [4.1.1] - 2026-07-21
    • [4.1.0] - 2026-07-21
    • [4.0.0] - 2026-07-21
    • [3.8.0] - 2026-07-21
    • [3.7.0] - 2026-07-21
    • [3.6.0] - 2026-07-20
    • [3.5.0] - 2026-07-20
    • [3.4.1] - 2026-07-19
    • [3.4.0] - 2026-07-19 (tag preserved; not published)
    • [3.3.1] - 2026-07-18
    • [3.3.0] - 2026-07-18
    • [3.2.0] - 2026-07-17
    • [3.1.0] - 2026-07-16
    • [3.0.0] - 2026-07-16
    • [2.29.2] - 2026-07-15
    • [2.29.1] - 2026-07-15
    • [2.29.0] - 2026-07-15
    • [2.24.1] - 2026-07-14
    • [2.24.0] - 2026-07-08
    • [2.23.0] - 2026-07-03
    • [2.22.0] - 2026-07-03
    • [2.21.0] - 2026-07-03
    • [2.20.0] - 2026-07-02
    • [2.19.0] - 2026-07-02
    • [2.18.0] - 2026-07-01
    • [2.17.0] - 2026-06-30
    • [2.16.0] - 2026-06-29
    • [2.15.0] - 2026-06-27
    • [2.14.0] - 2026-06-25
    • [2.13.0] - 2026-06-24
    • [2.12.0] - 2026-06-24
    • [2.11.1] - 2026-06-12
    • [2.11.0] - 2026-06-12
    • [2.10.3] - 2026-06-09
    • [2.10.2] - 2026-06-06
    • [2.10.1] - 2026-06-04
    • [2.10.0] - 2026-06-02
    • [2.9.1] - 2026-04-27
    • [2.9.0] - 2026-04-02
    • [2.8.3] - 2026-03-10
    • [2.8.2] - 2026-03-08
    • [2.8.1] - 2026-03-08
    • [2.8] - 2026-03-08
    • [2.7.1] - 2026-03-08
    • [2.7] - 2026-03-08
    • [2.6] - 2026-03-08
    • [2.3.1] - 2026-02-28
    • [1.9] - 2026-02-18
    • [0.1.0] - 2025-09-17

API 참조

  • API Reference
    • 모듈 hwpx.templates
    • 모듈 hwpx.package
    • 모듈 hwpx.document
    • 모듈 hwpx.tools.package_validator
    • 모듈 hwpx.tools.archive_cli
    • 모듈 hwpx.tools.repair
    • 모듈 hwpx.oxml.common
    • 모듈 hwpx.oxml.body
    • 모듈 hwpx.oxml.header
    • 모듈 hwpx.oxml.utils
    • 모듈 hwpx.oxml.schema
    • 모듈 hwpx.oxml.parser
    • 모듈 hwpx.oxml.document
    • 모듈 hwpx.opc.package
    • 모듈 hwpx.tools.text_extractor
    • 모듈 hwpx.tools.object_finder
    • 모듈 hwpx.tools.validator
    • 모듈 hwpx.oxml.namespaces
    • 공개 심볼 (hwpx.__init__)
    • 모듈 hwpx.__init__
    • Proposal presets — 5.0에서 이동
python-hwpx
  • 검색

© Copyright 2026, python-hwpx Maintainers.

Built with Sphinx using a theme provided by Read the Docs.