python-hwpx 7.0 이주 가이드
7.0 은 python-hwpx 를 “파일에 적힌 대로 읽고 쓰는” 한/글 문서의 기본 엔진으로 정리한 판이다. 6.12.0 에서 7.0.0 으로 올리면 네 가지가 달라진다.
저장 은
doc.save(target)하나다 — 저장.변환·짐작 기능(Markdown·HTML, ingest, 이름표로 칸 찾기, 메일 머지, 미리보기 …)은 python-hwpx-automation 으로 옮겼다 — 옮겨 간 기능.
공개 이름 을 한 가지 규칙으로 맞추고 얼렸다 — 이름 규칙과 바뀐 이름.
몇몇 호출의 결과 가 달라진다 — 아래 표들의 “옛 동작을 유지하는 법”.
지운 이름·인자를 부르면 대부분 새 자리와 한 줄 예를 알려 주는 오류가 난다. 테스트를 한 번 돌려 오류가 가리키는 대로
고치고, 오류 없이 결과만 달라지는 것은 아래 표로 확인한다. 가장 먼저 바로 아래 new() 의 첫 줄을 본다.
표의 왼쪽 열에는 6.12.0 에 있던 이름과 함께, 6.12.0 뒤 7.0 을 만드는 동안에만 있던 이름도 들어 있다(저장소의 main 을 따라 쓴 경우를 위한 것이다). 6.12.0 에서 그 이름이 없었다면 그 줄은 건너뛴다.
가장 먼저 볼 것 — HwpxDocument.new() 의 첫 줄
무엇이 달라지나 |
옛 동작을 유지하는 법 |
|---|---|
|
|
달라지지 않는 경우: 표나 개체를 먼저 더한 문서(빈 줄 다음에 온다), 첫 줄을 직접 쓴 문서
(doc.paragraphs[0].text = ...), open() 으로 연 문서.
이 변경으로 함께 고쳐야 하는 습관이 둘 있다.
빈 첫 줄을 지우던 코드는 지운다. 6.x 에서 흔하던
doc.paragraphs[0].remove()·section.remove_paragraph(0)는 7.0 에서 방금 쓴 첫 문단을 지운다(구역 설정은 다음 문단으로 옮겨 가 남는다).paragraphs[0].runs[0].remove()는 구역 설정을 담은 런을 지우는 호출이라 7.0 이 거부한다 (paragraph-run-section-settings).문단 번호와
runs[0]에 기대지 않는다.add_paragraph()가 돌려준 문단 객체를 그대로 쓴다. 첫 문단의 첫 런은 구역 설정을 담은 빈 런이라,paragraph.runs[0]이 방금 쓴 글이 아닐 수 있다.
from hwpx import HwpxDocument
doc = HwpxDocument.new()
title = doc.add_paragraph("2026 운영계획") # 7.0: doc.paragraphs[0] (6.x: [1])
title.text = "2026 학교 운영계획" # 번호 대신 돌려받은 객체로 고친다
legacy = HwpxDocument.new(empty_first_line=True) # 6.x 처럼 빈 줄로 시작
legacy.add_paragraph("2026 운영계획") # legacy.paragraphs[1]
저장
저장 동사 넷을 doc.save(target, *, format=None, mode="auto", fallback="error", quality=None, pipeline=None) 하나로 모았다.
target 은 경로(str·PathLike)나 이진 스트림이다. 스트림은 쓰기에 더해 tell()·seek() 가 되고 지금 자리부터 끝까지를
읽거나(read()) 지금 자리가 끝이어야 한다 — 실패하면 쓰기 전 모습으로 되돌리고, 저장 뒤 스트림이 쓴 문서를 그대로 담는지 다시
읽어 본다. 스트림에 저장할 문서보다 긴 내용이 있으면 문서 끝에서 자른다(truncate(), 못 자르면 거부). write() 만 되는 스트림
(파이프·소켓 등)은 OSError 로 거부하니 경로에 저장한다. save() 는 늘 MutationReport 를 돌려준다.
바이트가 필요하면 doc.to_bytes() 다(그대로).
python-hwpx 6.x |
python-hwpx 7.0 |
|---|---|
|
|
|
|
|
|
|
|
|
|
저장 뒤 열기 안전 검사를 다시 돌리던 코드 |
|
렌더러를 쓰려고 |
|
옛 이름을 부르면 HwpxAttributeError(document-name-removed)가 위 표의 새 호출을 알려 준다.
doc.save(path, mode="fast") 처럼 없는 mode·fallback 은 거부하고, .hwpx·.hwp 가 아닌 이름은 경고한다.
import io
from hwpx import HwpxDocument
doc = HwpxDocument.new()
doc.add_paragraph("2026 운영계획")
report = doc.save("plan-out.hwpx") # 6.x doc.save_to_path("plan-out.hwpx")
print(report.path, [part.path for part in report.changed_parts])
buffer = io.BytesIO()
doc.save(buffer) # 6.x doc.save_to_stream(buffer)
same = HwpxDocument.open(doc.to_bytes()) # 6.x 의 from_package 도 open 으로
옮겨 간 기능
7.0 의 python-hwpx 는 “파일에 적힌 대로 읽고 쓰는” 엔진만 남긴다. 다른 형식으로의 변환, 양식의 뜻 짐작, 보고서 모양 같은 취향, 미리보기 그리기, 장르 규칙은 python-hwpx-automation 8.0 으로 옮겼다. 인자와 결과는 6.x 와 같고, 문서의 메서드였던 것은 문서를 첫 인자로 받는 함수가 됐다.
pip install -U "python-hwpx-automation>=8" # python-hwpx 7.0 을 함께 설치한다
pip install "python-hwpx-automation[xlsx]" # 메일 머지의 .xlsx 명부
pip install "python-hwpx-automation[preview]" # 미리보기의 수식 MathML
옛 이름을 부르면 새 자리와 설치 명령을 알려 주는 오류가 난다. 본체는 자동화 패키지를 import 하지 않는다.
-U 와 >=8 을 빼지 않는다. python-hwpx-automation 7.x 는 python-hwpx 6.x 만 받으므로, 7.x 가 깔린 환경에서
pip install python-hwpx-automation 만 치면 그 7.x 를 그대로 두고 python-hwpx 를 6.x 로 되돌린다. 반대로
python-hwpx 만 7.0 으로 올리면 pip 가 충돌을 알리고 자동화 패키지의 일부 모듈이 import 되지 않는다. 둘을 함께 올린다.
hwpx-mcp-server 를 쓰고 있었다면 그것도 8.0 이상으로 함께 올린다.
형태 |
오류 |
|---|---|
|
|
|
|
|
|
python-hwpx 6.x |
python-hwpx-automation 8.0 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
루트 옛 이름 |
위 |
|
|
from hwpx import HwpxDocument
from hwpx_automation.forms import fill_by_path
from hwpx_automation.markdown import append_markdown, to_markdown
doc = HwpxDocument.open("신청서.hwpx")
append_markdown(doc, "## 덧붙임\n\n- 확인 완료") # 6.x doc.text.append_markdown(...)
result = fill_by_path(doc, {"성명 > right": "홍길동"}) # 6.x doc.tables.fill_by_path(...)
markdown = to_markdown(doc, rich=True) # 6.x doc.text.markdown(rich=True)
엔진에 남는 것: 평문(doc.text.plain())·outline·paragraphs·blocks, 표 지도
(doc.tables.map()), 수식 변환(latex_to_eqedit·eqedit_to_latex)과 측정, 한/글의 메일 머지
필드(paragraph.add_mail_merge_field), 문서 합치기, 차례, 문서 비교(doc_diff), 변경 추적, 칸 맞춤
(hwpx.form_fit), 줄 배치 캐시, 품질 게이트. 미리보기가 쓰는 EQEDIT_MATHML_OPERATOR_COMMANDS 는
hwpx.equation 에서 내보낸다.
달라지는 점:
to_markdown·to_html은 문서 를 받는다. 6.xhwpx.tools.exporter.export_markdown·export_html은 패키지 바이트도 받았다(hwpx_automation은 바이트를 받지 않는다). 바이트는HwpxDocument.open(data)로 연 뒤 넘긴다.본체의
MarkdownStyle객체는 새from_markdown이 받지 않는다(클래스가 다르다).hwpx_automation.markdown.MarkdownStyle을 쓴다.extra
xlsx·preview·langchain·llamaindex는pip install "python-hwpx[xlsx]"가 깨지지 않게 이름만 남고 아무것도 설치하지 않는다(5.0 의visual과 같다). 그 의존성은 python-hwpx-automation 의 같은 이름 extra 가 끈다.오류 code
ingest-failed·ingest-format-unsupported·equation-mathml-unavailable·text-markdown-style-invalid·table-path-invalid-type는 그 기능과 함께 옮겨 갔다(자동화 패키지가 같은 code 로 내고, 예외는 모두hwpx.errors.HwpxError계열이다).except hwpx.ingest.DocumentIngestError처럼 옛 모듈의 예외를 잡던 코드는hwpx_automation.ingest의 같은 이름으로 바꾼다.
이름 규칙과 바뀐 이름
7.0 이 마지막 이름 변경이다. 7.0 의 공개 이름(최상위 hwpx.__all__, 루트 HwpxDocument, 묶음 doc.styles·doc.page …,
hwpx.model 의 계약 멤버, hwpx.objects 값 형식, 안정 모듈 이름)은 8.0 전에는 지우거나 바꾸지 않는다.
저장소의 tests/data/public_surface.json 이 그 목록이다.
규칙
새 이름은 다음 규칙을 따른다. 처음 보는 이름도 이 규칙으로 짐작할 수 있다.
값 하나는 속성으로 읽고 쓴다:
paragraph.alignment = "CENTER",run.size = 14,cell.vertical_alignment = "CENTER",obj.rotation = 90. 여러 값을 한 번에 바꾸는 것만set_…(...)메서드다(set_position,set_borders,set_format).인자 없는 읽기는 속성, 인자를 받는 읽기는 메서드 다.
get_을 붙이지 않는다(table.cell_map,properties.header()). 묶음의 읽기가section=때문에 메서드여도, 모델 객체에서는 같은 값을 속성으로 읽는다 (doc.page.headers(section=0)↔section.properties.headers).여러 개를 돌려주는 읽기는
tuple이다. 문서 전체를 차례로 훑는 것은 Iterator 를 돌려주는 메서드다.줄임말과 XML 이름을 쓰지 않는다:
vertical_alignment,horizontal_relative_to,full_size,item_id.단위는 이름에 붙인다: 접미사가 없으면 HWPUNIT(int),
_mm은 mm,_pt는 pt. 글자 크기size·font_size는 pt. 선 굵기는 어디서나…_width_mm(mm, float)이다.인자 이름: 문단은
paragraph=(하나)·paragraphs=(여럿)이고 번호와 문단 객체를 모두 받는다. 구역은section=, 몇 번째는index=, 표 좌표는row·col, 머리(header.xml) 정의를 가리키는 것은…_id_ref.add_<종류>는 그 종류를 읽을 때와 같은 객체를 돌려준다(add_hyperlink→Hyperlink). 문단을 담는 모든 그릇 (문서·구역·표 칸·각주·머리말·바탕쪽)의add_paragraph는text와style=·para_pr_id_ref=·char_pr_id_ref=를 같은 이름으로 받고, 정렬 같은 것은 돌려받은 문단의 속성으로 쓴다.같은 이름은 어디서나 같은 값 이다.
alignment는 문단·표·그림 어디서나Alignment값으로 읽고 문자열로 쓴다. 뜻이 다른 것은 이름을 나눈다(문단의page_break는 쪽 나눔, 표의page_split은 쪽 경계에서 나누는 방식).한 가지 일은 한 곳에서 한다(변경 추적은
doc.tracking, 서식 정의는doc.styles).실패는
hwpx.errors.HwpxError계열 이고code·suggestion을 싣는다. 대신하는 내장 예외(TypeError등)도 함께 상속한다.
.element는 계약 밖이다
모델 객체의 .element(감싼 XML 요소)는 7.0에서도 그대로 쓸 수 있다. 다만 공개 계약이 아니다. 요소의 모양은 판 사이에
바뀔 수 있고, .element로 고친 것은 엔진의 거부·검사·줄 배치 캐시 지우기를 거치지 않는다. XML을 직접 고쳤다면 그 문단에
paragraph.clear_layout_cache()를 부른다. 7.0에서 공개 API가 생긴 일(문단·런 서식, 표 속성, 개체 배치, 번호·글머리표, 누름틀 값
등)은 공개 API로 옮기기를 권한다. 자세한 것은 stable-api의 「.element — 약속하지 않는 탈출구」.
안내 오류
6.x 에 나간 이름을 7.0 에서 바꾸거나 지웠으면 새 자리를 알려 주는 오류가 난다. 7.0 개발 중에만 있던 이름은 안내 없이 바뀌었다.
부른 것 |
오류 |
|---|---|
없어진 메서드·속성( |
|
없어지거나 바뀐 인자( |
|
최상위에서 빠진 이름( |
|
옮긴 기능 |
오류가 나지 않는 것 — 반환 형식만 바뀐 것과, 같은 이름이 메서드에서 속성이 된 것 — 은 아래 반환 형식 표에 있다.
루트와 가져오기
python-hwpx 6.x |
python-hwpx 7.0 |
|---|---|
6.0 이 묶음으로 옮기고 경고와 함께 남겨 둔 루트 이름 79개( |
묶음의 새 자리( |
|
|
|
|
|
돌려받은 객체의 속성: |
|
|
|
엔진에 남은 11개는 |
|
|
문단·런·서식
python-hwpx 6.x |
python-hwpx 7.0 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
속성 |
|
|
|
|
|
|
개체·수식
python-hwpx 6.x |
python-hwpx 7.0 |
|---|---|
|
|
|
|
|
|
|
|
|
|
표
python-hwpx 6.x |
python-hwpx 7.0 |
|---|---|
|
|
|
속성 |
|
|
|
|
구역·머리말·바탕쪽·각주
python-hwpx 6.x |
python-hwpx 7.0 |
|---|---|
모델 |
없어졌다. 돌려받은 문단의 속성으로 쓴다 |
|
|
|
|
|
|
|
|
|
|
|
|
반환 형식만 바뀐 것
오류가 나지 않으므로 결과를 쓰는 곳을 직접 본다.
python-hwpx 6.x |
python-hwpx 7.0 |
고칠 것 |
|---|---|---|
여러 개를 돌려주는 읽기가 |
|
목록을 고치던 코드( |
|
|
이름은 |
|
그 문단에 바로 달린 것만 |
본문 문단을 돌며 문서의 각주를 모으던 코드는 |
|
|
|
|
|
XML 요소는 |
머리말·꼬리말의 |
문단·런·개체 객체 |
옛 요소는 |
|
|
|
|
|
|
|
같은 이름의 속성 |
괄호를 뗀다(부르면 |
|
문단 글을 줄 바꿈( |
|
|
계약에서 내렸다(메서드는 남는다) |
|
|
속성 |
괄호를 뗀다 |
|
읽기 전용 |
고치거나( |
|
|
XML 요소는 |
|
문서 순서의 |
|
|
|
목록을 고치던 코드는 |
|
|
XML 요소는 |
묶음(doc.*)과 값 형식
python-hwpx 6.x |
python-hwpx 7.0 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
7.0 개발 중의 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
메모 모양은 메모마다가 아니라 구역마다다(한/글은 |
|
|
|
|
값 형식(hwpx.objects)과 그 안의 매핑:
python-hwpx 6.x |
python-hwpx 7.0 |
|---|---|
|
|
|
없어졌다: |
|
|
|
|
|
|
|
|
|
|
7.0 개발 중에 생긴 값 형식의 이름(안내 없이 바꿈):
7.0 개발 중 |
python-hwpx 7.0 |
|---|---|
|
|
|
구역 객체(바탕쪽이면 |
|
|
|
|
새로 계약에 올린 것(이름은 그대로, 다음 major 까지 고정): stable 이름이 돌려주던 형식 26개를 hwpx.objects 에서도 가져올
수 있다 — Style·RunStyle·ParagraphProperty·Bullet·Font·MemoShape·TabDefinition·TrackChange·TrackChangeAuthor·
SectionGrid·SectionVisibility·LineNumberShape·DocumentMetadata·TextBlock·TextOutline·TextChangeReport·
ValidationReport·Hwp5ConversionReport·TableMapResult·GridPosition(table.cell_map 의 칸)·Caption·PictureShadow·
PictureGlow·PictureReflection·ContainerMember·GenericElement(구현 모듈의 같은 클래스다). paragraph.section(문단이 든
구역)도 계약이다. 그림·수식·도형·표도 obj.section(바탕쪽이면 None)으로 구역을 읽는다 — 6.x 에서 obj.paragraph.section.element
를 doc.sections 와 견주던 코드는 doc.sections.index(obj.section). 번호 수준은 NumberingLevel.use_instance_width
(useInstWidth)까지 값으로 읽으므로 머리 XML(hh:paraHead)을 직접 읽을 필요가 없다.
가장 자주 고치는 곳
자동화·학교 도구 저장소에서 센 깨지는 호출 수(받는 쪽을 가리지 못한 수는 상한)가 많은 순서다. 대부분 이름만 바꾸면 된다.
6.x |
7.0 |
옮기는 법 |
|---|---|---|
|
|
이름만. 반환값(경로)을 쓰던 곳은 |
|
|
이름만 |
|
|
키워드 이름. |
|
|
게이트 실패는 반환 대신 |
|
|
괄호를 뗀다 |
|
|
값도 mm 로 |
|
|
손으로 |
|
|
값도 mm 수로 |
|
|
이름만 |
|
|
속성 |
|
|
이름만 |
|
|
필드: |
|
|
가져오는 자리만 |
from hwpx import HwpxDocument
from hwpx.equation import latex_to_eqedit # 6.x from hwpx import latex_to_eqedit
doc = HwpxDocument.new()
title = doc.add_paragraph("2026 운영계획")
title.alignment = "CENTER" # 6.x add_paragraph(..., run_attributes=/XML 속성)
table = doc.add_table(2, 2)
cell = table.cell(row=0, col=1) # 6.x cell(row_index=0, col_index=1)
cell.vertical_alignment = "CENTER"
grid = table.cell_map # 6.x table.get_cell_map()
rows = list(table.rows) # tuple → 고칠 목록이 필요하면 list(...)
equation = title.add_equation(latex_to_eqedit(r"\frac{a}{b}"), font_size=11.0) # 6.x base_unit=1100
만들기·고치기 — 결과가 달라지는 것
무엇이 달라지나 |
옛 동작을 유지하는 법 |
|---|---|
|
|
수식 상자 폭을 한/글 2024(Windows)가 실제로 필요로 한 폭에 맞춰 다시 잡는다. 같은 수식의 |
없음(6.x 폭은 수식 뒤 글자와 겹쳤다) |
|
없음. 이미 그런 파일은 |
|
없음(옛 줄 배치를 남기지 않는다) |
|
|
정렬을 준 머리말·꼬리말·쪽 번호( |
없음(6.x 결과는 쪽 번호 밑에 줄이 그어지던 오류다) |
머리말·꼬리말을 한/글처럼 첫 문단의 본문 컨트롤( |
없음 |
|
스타일의 모양을 원하지 않으면 |
|
|
표 칸·글상자·각주·머리말 안에 떠 있게 만든 개체는 문단 기준으로 그 안에 머무르게 놓인다(한/글 저장본의 그 자리 개체들이 쓰는 배치). 본문에 만드는 개체는 그대로다 |
없음(6.x 배치는 한/글에서 표 밖에 그려졌다). 다른 배치는 |
각주·미주를 더하거나 지우면 같은 종류의 번호를 문서 순서대로 다시 매긴다(쪽마다 새로 매기는 구역은 아래) |
없음 |
칸에 색을 칠해도( |
없음(6.x 는 같은 색의 다른 정의를 가져와 선이 바뀌거나 사라졌다) |
글자·문단 모양 변경 추적은 쓰지도 거절하지도 않는다( |
없음(6.x 의 거절은 표시만 걷어 수락처럼 굴었다) |
|
|
크기가 0 인 수식·차트, 빈 책갈피 이름, 빈 링크 주소를 거부한다. |
없음 |
공개 메서드에 잘못된 타입을 주면 |
|
|
없음 |
|
고치지 않았으면 부르지 않는다 |
|
|
다단 문서에서 새 표와 차트의 기본 폭이 본문 전체 폭이 아니라 단 폭이다 |
|
구역이 여럿인 문서에서 |
|
테두리·단 구분선·각주/미주 구분선·메모 선 굵기( |
목록의 값을 직접 고른다(0.45 → 0.4 또는 0.5). 목록은 |
|
거부에 기대던 코드는 돌리기 전에 |
떠 있는 개체를 돌리면( |
옛 오프셋이 필요하면 돌린 뒤 |
돈 그림·도형·묶음의 |
상자 크기는 새 읽기 전용 |
|
없음. “적히지 않음”을 따로 보려면 |
용지 크기·여백( |
None` 이다. 한/글은 이 값을 늘 적으므로(공개 문서 1,637 구역 모두) 한/글 저장본은 전과 같다 |
숨은 설명( |
그 자리까지 보려면 |
|
본문 것만: |
|
없음 |
메모를 MEMO 누름틀의 |
메모는 |
|
만든 뒤 잇는다: |
MEMO 누름틀의 매개변수를 한/글 2024 저장본과 같은 일곱 개로 같은 순서에 쓴다: |
누름틀 매개변수를 직접 읽던 코드는 시각을 그 컴퓨터 시각으로 읽는다. UTC 가 필요하면 |
|
본문 쪽만: |
|
없음(문단 글과 개체 자리의 뜻은 같다) |
새로 만든 개체(도형·그림·수식·차트·표·묶음·선·연결선)의 |
0 이 필요하면 만든 뒤 |
|
없음. 두 문서가 같은 난수열을 나눠 쓰던 결과가 필요하면 한 문서에서 만든다 |
|
굵기를 적어야 하면 |
|
칸의 |
문단·개체를 복사하면( |
없음( |
다른 문서의 문단을 옮길 때( |
없음(가리키는 정의의 내용은 같다) |
|
|
|
|
표에 넣는 행과 열은 빈 칸이다
6.x 의 insert_rows 는 기준 행을 통째로 복제했다. 제목 행 아래에 줄을 넣으면 제목 글이 새 줄에 그대로 생겼다.
7.0 은 한/글의 “줄 추가하기”와 같다: 새 칸은 기준 칸의 서식(칸 속성·테두리/배경·여백·크기·문단 모양·글자 모양)만 받고
빈 문단 하나를 둔다. 합친 칸이 새 줄을 가로지르면 늘어나는 규칙은 전과 같다. 이 변경은 이름이 그대로라 오류가 나지
않는다 — blank= 없이 insert_rows·insert_columns 를 부르는 곳을 찾아 확인한다(blank= 를 주던 곳은 안내 오류가 난다).
from hwpx import HwpxDocument
doc = HwpxDocument.new()
table = doc.add_table(rows=2, cols=2)
table.cell(0, 0).text = "제목"
table.insert_rows(0) # 7.0: 새 줄은 빈 칸 (6.x: "제목"이 복사됐다)
assert table.cell(1, 0).text == ""
table.insert_rows(0, copy_content=True) # 6.x 의 insert_rows(0) 과 같다 (6.x: blank=False)
assert table.cell(1, 0).text == "제목"
바이트 편집 apply_table_ops 의 insert_row_by_clone·insert_column_by_clone 은 이름대로 전처럼 복사가 기본이다
(빈 칸은 "blank": True).
쪽마다 새로 매기는 각주
각주 번호 방식이 “쪽마다 새로”(ON_PAGE)인 구역이 하나라도 있으면, 엔진은 각주를 더하거나 지워도 이미 적힌 번호를
다시 쓰지 않고(다른 구역도), 새 각주에는 문서 전체에서의 순번을 적는다. 그 번호는 쪽 배치에 달려 있는데 엔진은 쪽을
배치하지 않기 때문이다. note.number 는 그 구역에서 파일에 적힌 값이다.
한/글 2024 는 문서를 열 때 쪽마다 번호를 다시 매겨 그리고, 저장할 때 쪽별 번호를 파일에 적는다(문서 순번 1..6 을 1,2,1,2,1,2 로
고쳐 적었다). 그래서 화면의 번호는 맞지만, 한/글로 다시 저장하기 전의 note.number 는 화면의 번호와 다를 수 있다.
쪽마다의 번호가 필요하면 한/글로 한 번 열어 저장한 파일을 읽는다.
수식 변환
latex_to_eqedit·eqedit_to_latex 의 결과가 달라지는 경우. 6.x 결과는 한/글에서 다른 기호로 그려지거나 깨졌다.
무엇이 달라지나 |
옛 동작을 유지하는 법 |
|---|---|
|
없음 |
|
첨자는 |
|
없음 |
net, initial, In 처럼 한/글 예약어로 시작하는 이름을 글자로 지킨다( |
없음 |
|
없음 |
|
없음 |
받는 표기가 늘었다(유니코드 기호, |
없음 |
Markdown 가져오기 — from_markdown·append_markdown (이제 python-hwpx-automation)
아래 동작 변화는 옮겨 간 hwpx_automation.markdown 의 함수에 그대로 있다.
무엇이 달라지나 |
옛 동작을 유지하는 법 |
|---|---|
|
|
표의 열 너비를 내용에 맞추고, 머리 행을 가운데로 놓고, 구분선의 |
|
목록 안의 목록을 깊이마다 오른쪽으로 들여 쓴다 |
|
중첩 번호 목록을 한/글처럼 |
없음 |
from hwpx_automation.markdown import MarkdownStyle, from_markdown # 6.x hwpx.tools.markdown_import
doc = from_markdown("# 제목\n\n- 항목\n - 하위 항목\n", style="plain") # 6.12 모양
old_tables = MarkdownStyle(table_fit_columns=False, table_header_align=None, list_indent_mm=0)
읽기 — Markdown 내보내기와 ingest (이제 python-hwpx-automation)
아래 동작 변화는 옮겨 간 hwpx_automation.markdown·hwpx_automation.ingest 에 그대로 있다.
무엇이 달라지나 |
옛 동작을 유지하는 법 |
|---|---|
|
없음 |
제목을 문단의 개요 수준(개요 번호, |
|
|
|
|
|
ingest(6.x |
|
그림을 꺼내지 않을 때( |
없음 |
to_markdown(doc, rich=True)(6.x doc.text.markdown(rich=True)) 의 새 옵션 headers_and_footers=·memos=·
equations=·list_labels= 은 기본이 꺼짐이다.
양식 채우기와 바꾸기
무엇이 달라지나 |
옛 동작을 유지하는 법 |
|---|---|
표 이름표를 공백을 무시하고 견준다( |
몇 번째 이름표인지 적는다: |
|
없음(앞 값이 뒤 이름표가 되던 동작에 기대던 코드는 호출을 나눈다) |
|
경고만 끄려면 |
.hwp 와 열기
무엇이 달라지나 |
옛 동작을 유지하는 법 |
|---|---|
|
|
|
없음(6.x 결과는 한/글이 지운 글까지 보통 글로 그렸다) |
문서 이력(DocHistory)이 든 |
|
개체 바로 앞에서 시작하는 변경 표시가 |
없음 |
테두리/배경 “없음”(id 0)을 가리키던 쪽 테두리·글자 모양·문단 모양·표 칸이, 머리에 새로 더한 “아무것도 그리지 않는” |
없음(OWPML 에는 id 0 이 없다) |
대각선 칸의 |
없음 |
한 구역 스트림에 구역 정의가 여럿인 |
없음 |
|
없음 |
HWP 3.x 이하 |
오류 문구를 비교하던 코드는 형이나 |
되돌리기
pip install "python-hwpx<7". 6.x 라인은 그대로 있다.