변경 로그
모든 중요한 변경 사항은 이 문서에 기록됩니다. 형식은 Keep a Changelog과 Semantic Versioning을 따릅니다.
[Unreleased]
고침
python -m hwpx.capabilities(describe_capabilities())가 빈 extravisual·xlsx·preview를 맨 설치에서도true로 보고했다. 아무것도 끌어오지 않는 extra이므로false로 보고하고, 까닭과 그 기능이 있는 곳(python-hwpx-automation)을extrasNote에 적는다. 있던 키는 그대로다.
[7.0.0] - 2026-11-21
7.0은 python-hwpx를 한/글 문서를 위한 파이썬 기본 엔진으로 정리한 판입니다. 엔진은 같은 파일이면 같은 결과를 내고, 파일에 적힌
대로만 읽고 쓰며, 한/글 근거가 없는 쓰기는 하지 않고 거부합니다. 변환·짐작·취향·미리보기·AI 연동(Markdown·HTML, 양식 칸 찾기,
메일 머지, ingest, LangChain·LlamaIndex, 서식 규칙 검사)은 python-hwpx-automation 8.0으로 옮겼습니다. 공개 이름은 한 가지 규칙으로
맞춰 tests/data/public_surface.json으로 고정했고, 6.x 이름을 부르면 새 이름을 알려 주는 오류가 납니다. 그 대신 표·개체·서식·누름틀·
각주·차례·상호 참조·변경 추적처럼 XML을 직접 고쳐야 하던 일을 한/글 저장본을 근거로 공개 API로 열었습니다. 올리기 전에 7.0 이주
가이드(docs/migration-7.0.md)를 보세요.
본체의 줄 수는 6.12.0보다 약 2만 1천 줄(23%) 늘었습니다. 공개 API로 연 표·개체·서식·누름틀·각주·글 구간 편집이 문서 모델에
들어갔고(oxml 약 1만 4천8백 줄, _document 약 2천9백 줄, objects 약 2천3백 줄), 읽은 ZIP 기록을 그대로 옮기는 저장이
opc에 약 1천4백 줄을 더했습니다. 옮겨 간 기능만큼 tools가 약 2천6백 줄 줄고 ingest(552줄)가 없어졌습니다.
import hwpx가 읽는 모듈은 99개에서 95개로 줄었습니다.
깨지는 변경
저장
저장을
doc.save(target)하나로 모았다.doc.save_to_path(path)는doc.save(path),doc.save_to_stream(stream)은doc.save(stream),doc.save_report(target, quality=q)는doc.save(target, quality=q),HwpxDocument.from_package(pkg)는HwpxDocument.open(pkg)이다.save()는 늘MutationReport를 돌려준다(저장한 경로는report.path, 품질 보고는report.quality).return_report=는 없어졌고, 품질 게이트 실패는SaveError(quality-gate-failed)의.report에 있다..hwp로 쓰기는 실험 기능이다..hwp에서 연 문서를 그 원본 경로에.hwp로 저장하면Hwp5Error(hwp5-overwrite-source), 열 때 옮기지 못한 내용이 있는 문서(conversion_report가 비어 있지 않음)를.hwp로 쓰면Hwp5Error(hwp5-write-lossy-source)로 거부한다. 두 경우 모두.hwpx로는 저장된다. 처음.hwp로 저장할 때 실험 기능이라고 한 번 알린다.doc.save(path, mode="fast")처럼 없는mode나fallback은 거부한다..hwpx도.hwp도 아닌 이름으로 저장하면 경고한다.
이름 규칙
7.0이 마지막 이름 변경이다. 공개 이름(최상위·루트·묶음·
hwpx.model·hwpx.objects·안정 모듈)은 다음 major까지 바뀌지 않는다. 모델 객체의.element(감싼 XML 요소)는 이 약속에 들어 있지 않다. 쓸 수는 있지만 모양을 약속하지 않고, 이것으로 고친 것은 엔진의 거부와 검사를 거치지 않는다(docs/stable-api.md의 「.element— 약속하지 않는 탈출구」). 6.x 이름을 부르면HwpxAttributeError(document-name-removed)나HwpxTypeError(hwpx-argument-removed)가 새 이름과 한 줄 예를 알려 준다.hasattr는False다.6.0이 묶음(
doc.styles·doc.page…)으로 옮기고 경고와 함께 남겨 둔 루트 이름 79개를 지웠다(예:doc.set_header_text(...)→doc.page.set_header(text=...)). 6.0이 예고한section_index=(→section=)와style_id_ref=(→style=, 스타일의 문단·글자 모양까지 적용)도 지웠다. 스타일 번호만 붙이려면paragraph.style_id_ref = 2라고 쓴다.from hwpx import로 가져오던 실험 기능 26개 가운데 엔진에 남은 11개(편집 계획, 쪽 수 어림, 자기 서술)는from hwpx.experimental import ...로 가져온다. 수식 변환(latex_to_eqedit·estimate_equation_size·UnsupportedLatexError)은 안정 계약이 되어from hwpx.equation import ...로 가져온다. 나머지 12개(ingest 7개, 미리보기 5개)는 python-hwpx-automation으로 옮겼다(hwpx_automation.ingest·hwpx_automation.preview).이름에 줄임말과 XML 이름을 쓰지 않는다:
row_index=·col_index=→row=·col=,binary_item_id_ref→item_id,align=→alignment=,full_sz→full_size,horz_rel_to=→horizontal_relative_to=.길이 단위는 이름에 붙인다: 선 굵기
line_width='33'→line_width_mm=0.12, 수식base_unit=1100→font_size=11.0(pt),size=(w, h)→width=w, height=h.인자 없는 읽기는 속성이고
get_을 붙이지 않는다:table.get_cell_map()→table.cell_map,run.content_kinds()→run.content_kinds,RunStyle.is_superscript()→superscript(text_color()→color),properties.get_header()→properties.header().add_<종류>는 읽을 때와 같은 객체를 돌려준다:add_bookmark→Bookmark,add_hyperlink→Hyperlink,add_picture→Picture,add_equation→Equation.paragraph.add_new_num()은add_number_restart()다.문단을 담는 그릇(문서·구역·표 칸·각주·머리말·바탕쪽)의
add_paragraph는 모두text와style=·para_pr_id_ref=·char_pr_id_ref=를 같은 이름으로 받는다.run_attributes=·inherit_outline=·XML 속성 키워드(pageBreak="1")와 머리말의align=은 없어졌다. 돌려받은 객체의 속성으로 쓴다(p.page_break = True,p.alignment = "CENTER").한 가지 일은 한 곳에서 한다:
paragraph.add_tracked_insert()·add_tracked_delete()→doc.tracking.insert()·delete(),obj.get_attribute(name)→obj.attributes.get(name).바뀐 이름 전체는 이주 가이드의 “이름 규칙과 바뀐 이름” 절에 있다.
묶음(doc.*)
문서 전체를 차례로 훑는 메서드는
iter_로 시작한다:doc.text.runs()·blocks()→iter_runs()·iter_blocks()(7.0 개발 중의paragraphs()·objects()는iter_paragraphs()·iter_objects()).doc.styles.names()·doc.text.highlights()는 속성이다.선 굵기는 mm 숫자다:
doc.shapes.add_line·add_rectangle·add_ellipse·add_arc·add_polygon·add_curve·add_connector의line_width='33'→line_width_mm=0.12,doc.styles.ensure_border_fill·apply_paragraph_format의border_width='0.12 mm'→border_width_mm=0.12,doc.page.set_columns(separator_width=)→separator_width_mm=. 테두리·단 구분선은 한/글 굵기 목록의 값만 받는다(아래 “값 형식”).문단은
paragraph=(하나)·paragraphs=(여럿)로 가리키고 번호와 문단 객체를 모두 받는다:doc.styles.apply_paragraph_format·apply_list_format의paragraph_index=·paragraph_indexes=,doc.notes.add_memo(anchor=)(anchor_char_pr_id_ref=→paragraph_char_pr_id_ref=).doc.notes.add_footnote(text, p)·add_endnote(text, p)는paragraph=p로 부른다.머리(
header.xml) 정의를 가리키는 인자는…_id_ref다:ensure_run(base_char_pr_id=),ensure_paragraph_format(base_para_pr_id=),ensure_border_fill(base_border_fill_id=),doc.parts.set_paragraph_auto_spacing(para_pr_id=). 그림 데이터는item_id다:ensure_font(binary_item_id_ref=, subst_binary_item_id_ref=)→item_id=·subst_item_id=,doc.media.replace_picture(picture_index=, binary_item_id_ref=)→index=·old_item_id=. 줄 간격은line_spacing=하나다 (ensure_paragraph_format·apply_paragraph_format의line_spacing_percent=).그 밖의 이름:
doc.page.restart_page_number()·hide_page_elements()→add_number_restart()(→NumberRestart)·add_page_hiding()(→PageHiding),set_page_number(align=)→alignment=,doc.shapes.add_dutmal(main_text, sub_text, pos_type=, align=, sz_ratio=)→add_ruby(text, ruby_text, position=, alignment=, size_ratio=)(→Ruby),add_composed_character(compose_text, circle_type=, char_sz=, compose_type=)→add_composed_character(text, frame=, inner_size=, arrangement=)(→ComposedCharacter),add_drop_cap(style=)→kind=,add_equation(base_unit=1100, size=(w, h))→font_size=11.0, width=w, height=h,add_chart(size=)→width=·height=,doc.fields.fill(field_index=, fit_policy=)→index=·fit=,doc.tracking.add_change(author_name=)→author=.하나로 합쳤다:
doc.styles.border_fill_info(id)→border_fill(id),doc.parts.set_compatible_document_target_program·set_layout_compatibility_flags·set_doc_option_link_info·set_license_mark→set_document_options(target_program=, layout_compatibility=, link_path=, page_inherit=, footnote_inherit=, license_type=, license_flag=, license_lang=)(→ 읽기와 같은DocumentOptions),doc.media.picture_references()→doc.media.pictures. 7.0 개발 중의doc.styles.numbering_info(id)는numbering(id)다.doc.parts.add_master_page(...)는 id 대신MasterPage를 돌려주고(id는.id),paragraphs=[...]는 없어졌다 (mp.add_paragraph(...)).doc.page.set_master_page·doc.parts.remove_master_page는MasterPage도 받는다. 7.0 개발 중의doc.page.remove_master_page(id)(구역과의 연결 끊기)는remove_master_page_reference(id)다.반환 형식:
doc.styles.border_fill(id)·border_fills는BorderFillInfo를,numbering(id)·numberings는NumberingInfo를 돌려준다(전: XML 요소).doc.tracking.changes는 id를 키로 한 dict가 아니라 문서 순서의TrackedChangetuple이고,change(id)도TrackedChange(change_id·kind·author·date·paragraph)다.doc.tables.all·doc.tables[a:b],doc.text.find_runs(),doc.notes.memos,doc.styles.ensure_numbering(),doc.parts.master_pages·histories·clear_document_metadata()·clear_preview()는 tuple이다.
값 형식(hwpx.objects)
구역은 번호가 아니라 구역 객체로 읽는다:
check_box.section_index→check_box.section(번호는doc.sections.index(check_box.section)). 7.0 개발 중의RadioButton·ComboBox·EditBox.section_index와ParagraphPlace·ObjectPlace·TextMatch.section(번호)도 구역 객체다(to_dict()는 그대로 번호).hwpx.objects.PictureRef를 지웠다:doc.media.pictures의Picture(item_id·width·height)를 쓴다.배치와 정렬을 풀어 쓴다:
obj.position(ObjectPosition)의horz_rel_to·vert_rel_to·horz_align·vert_align→horizontal_relative_to·vertical_relative_to·horizontal_alignment·vertical_alignment(set_position의 인자와 같은 이름,to_dict()열쇠도),NumberingLevel.align→alignment(Alignment),bullet.para_head.align→alignment(Alignment).그룹 구성원의 선 굵기도 mm다:
ContainerMember.rect·ellipse·polygon·line·text_box(line_width="33")→line_width_mm=0.12,text_box(vert_align=)→vertical_alignment=.테두리 면 매핑의 굵기는 mm 숫자다:
ensure_border_fill(sides={"top": {"width": "0.4 mm"}})·apply_paragraph_format(border={"width": ...})→{"width_mm": 0.4}.테두리·단 구분선·각주/미주 구분선·메모 선 굵기는 한/글 굵기 목록(0.1 … 5 mm)의 값만 받는다. 목록에 없는 값은 가장 가까운 값으로 바꿔 쓰지 않고 문서를 바꾸기 전에
HwpxValueError(style-line-width-invalid,suggestion에 쓸 수 있는 값)로 거부한다.메모 선 굵기는
doc.styles.ensure_memo_shape(line_width_mm=0.12)하나로 준다. XML 값을 그대로 적던 6.xline_width=1은 없어졌다(lineWidth는 한/글 굵기 목록의 순번임을 한/글 2024로 확인했다). 순번이 아닌lineWidth("0.6mm")는 한/글처럼 0(0.1 mm)으로 읽는다.doc.page.text_direction(section=)은SectionTextDirection대신 표 칸의cell.text_direction과 같은 문자열 ("HORIZONTAL"·"VERTICAL"·"VERTICALALL")을 돌려준다. 머리말·꼬리말 세로쓰기는 새doc.page.vertical_header_footer(section=)로 읽는다.stable 이름이 돌려주던 형식 26개(
Style·RunStyle·ParagraphProperty·Font·Bullet·Caption·GridPosition·ContainerMember·PictureShadow…)를hwpx.objects에서도 내보내 공개 표면 잠금에 올렸다.paragraph.section도 계약이다.
옮긴 기능
변환·짐작 기능을 본체에서 지웠다(목록은 아래 “옮긴 것”). 옛 이름을 부르면
hwpx.MovedToCompanion(ImportError),ModuleNotFoundError, 문서 메서드면HwpxAttributeError(document-name-moved)가 새 자리와pip install python-hwpx-automation을 알려 준다. 본체는 자동화 패키지를 import 하지 않는다.extra
xlsx·preview·langchain·llamaindex는pip install "python-hwpx[xlsx]"가 깨지지 않게 이름만 남고 아무것도 깔지 않는다. 같은 이름의 extra가 python-hwpx-automation에 있다. 명령hwpx-check-format은 자동화 패키지가 선언하고,hwpx-text-extract --format markdown은 옮겼다는 안내를 내고 종료 코드 2로 끝난다(--format plain은 그대로다).
반환 형식
여러 개를 돌려주는 읽기는
tuple이다:doc.paragraphs,doc.sections,section.paragraphs,paragraph.runs·tables,table.rows,row.cells,cell.paragraphs,memo.paragraphs,doc.parts.headers등. 목록을 고치던 코드(append)는list(...)로 바꾼다.paragraph.bookmarks는 이름 목록이 아니라Bookmark의 tuple이다.paragraph.hyperlinks는Hyperlink의 tuple이고,link["url"]대신link.url이나link.to_dict()를 쓴다.add_*가InlineObject나None대신 그 종류의 객체를 돌려준다(위 이름 규칙). 머리말·꼬리말의add_paragraph·add_run·add_page_number_field는 문단·런·개체 객체를 돌려준다(옛 요소는.element).HeaderPart.border_fill(id)·border_fills는BorderFillInfo를,properties.start_numbers는hwpx.objects.StartNumbers를 돌려준다(hwpx.oxml.SectionStartNumbering은 없어졌다).doc.oxml의 서식 읽기 16개(char_property등)는 공개 계약에서 내렸다. 메서드는 남아 있으니doc.styles의 같은 이름을 쓴다.doc.styles.char_properties는dict가 아니라 읽기 전용Mapping(id →RunStyle)이다. 사본이 아니라 머리를 읽을 때마다 그때 모습으로 읽는 보기라, 받아 둔 뒤.element로 고친 글자 모양도 다음 읽기에 보인다. 고치기(chars[id] = ...)·.copy()는 없고, 그대로 남는 사본은dict(doc.styles.char_properties)로 뜬다. id 하나 찾기(chars[id]·chars.get(id)·id in chars)는 글자 모양 수와 상관없이 그 하나만 견주고,len·차례로 훑기·items()는 모두를 견준다.
오류 code
unknown-contract-document·unknown-contract-schema가contract-document-unknown·contract-schema-unknown이 되었다.section-argument-conflict·style-argument-conflict는 인자와 함께 없어졌다.ingest-failed·ingest-format-unsupported·equation-mathml-unavailable·text-markdown-style-invalid·table-path-invalid-type은 그 기능과 함께 옮겼다(자동화 패키지가 같은 code로 내고, 예외는 모두hwpx.errors.HwpxError계열이다).공개 메서드에 잘못된 타입을 주면 내장
TypeError·AttributeError대신code·suggestion을 실은HwpxError계열이 난다. 흔한 실수(표 번호·칸 좌표 범위 밖, 잘못된 표 크기, 문자열이 아닌 문단 글)도 같다. 내장 예외도 함께 상속하므로 기존except는 그대로 잡는다.열지 못하는 파일(빈 파일, 텍스트 파일, 잘린 HWPX, 이름만 바꾼 Office 문서, 폴더, 암호 문서, HWP 3.x)은 사유별 문구와
code·suggestion을 싣는다. 형은 그대로라except BadZipFile이 잡고,.hwp에는 ZIP 얘기를 하지 않는다.HwpxDocument.open(123)처럼 경로·bytes·스트림이 아닌 값은HwpxTypeError다.HwpxIndexError가hwpx.errors에 있다(옛 경로도 된다). 새 code는docs/error-codes.md에 있다.
행동 변화
문서에서 떼어 낸 것(지운 표·각주·글상자 안의 문단과 그 런, 지운 구역의 문단, 지운 표와 그 칸·행·열, 지운 각주·글상자·캡션· 개체)은 더는 그 문서에 속하지 않는다. 규칙은 하나다: 그 대상 자신의 글과 값만 바꾸고 문서 쪽에 아무것도 쓰지 않는 편집은 된다 — 문단의
text =·insert_text·delete_range·replace_range·set_text_preserving_runs·clear_text, 서식 없는add_run·split_run, 문서에 있는 모양 번호 대입(char_pr_id_ref =), 표·칸·행·개체의 크기·여백·배치·값. 문서 쪽에 쓰는 편집은 아무것도 바꾸기 전에 거부한다(문단·런·각주는paragraph-not-in-document, 표·칸은table-not-in-document, 글상자·캡션은shape-not-in-document): 머리에 모양을 등록할 수 있는 서식(서식을 준add_run·insert_text,format_range, 문단 정렬·간격 같은 문단 모양, 런의bold =등, 표 테두리·채우기·정렬), 번호를 매기는 것(각주·미주·번호 다시 시작·쪽 감추기·글머리표·번호), 문서가 세는 표시·개체 넣기(형광펜·책갈피·누름틀·하이퍼링크·체크 상자·그림·차트·도형·수식·표), 옆에 문단 더하기 (insert_before·insert_after, 칸·각주·글상자·캡션의add_paragraph), 표의 행·열·칸 구조 편집(행·열 넣기·지우기·옮기기·복사, 칸 합치기·나누기)과 표 복사, 글 구간·각주·개체를 문서와 주고받기.add_form_field가 누름틀을 한/글이 저장하는 꼴로 쓴다(한/글 2024에서 다시 저장해 확인). 이미 있는 글 위에 씌운 누름틀(start=,end=)은 채워진 것(dirty="1",field.filled가 참)으로 쓴다. 안내문·도움말의 길이는 UTF-16 단위로 쓴다 — 글자 수로 쓰면 이모지처럼 기본 평면 밖 글자가 든 안내문의 뒤쪽이 한/글에서 잘렸다.run.text가 런 바로 아래 적힌 탭(hp:tab·탭 컨트롤, 한/글이 아닌 도구가 쓰는 꼴)도 센다. 한 문단의run.text를 이으면 늘paragraph.text다.run.text = …는 그 탭도 값으로 바꾼다. 한/글 저장본은 탭을hp:t안에 쓰므로 그대로다.읽기만 해서는 문서가 바뀌지 않는다:
hp:secPr가 없는 구역(한/글 저장본에는 없다)의section.properties·doc.page.size()등이 빈hp:secPr를 넣고 구역을 바뀐 것으로 표시하던 것을 고쳤다. 값은 “적히지 않음”(None)이고, 그 설정에 쓸 때 넣는다.선 없는 면(
ensure_border_fill(sides={...: None}))을 한/글처럼type="NONE" width="0.1 mm"로 쓴다(전: 기준 굵기).ensure_border_fill이 새로 짓는 테두리 정의의 대각선(hh:diagonal)을 한/글 저장본의 테두리 정의 3,511개가 모두 쓰는type="SOLID" width="0.1 mm" color="#000000"로 쓴다(전:NONE에 면의 굵기·색).hh:slash·hh:backSlash가NONE이라 그려지는 것은 없다. 같은 내용의 정의를 찾을 때도 이 꼴의 대각선을 보므로, 한/글이 저장한 정의 가운데 같은 것이 있으면 새로 만들지 않고 그 id를 돌려준다. 기준 정의에서 짓는 길(base_border_fill_id_ref=)은 전처럼 기준의 대각선을 그대로 둔다.ensure_run(font="X")가 X를 일곱 언어 모두에 준다. 전에는 X를 글꼴 목록에 이미 선언한 언어만 바꿔서, 한글 목록에 X가 없는 문서에서는 한글 글꼴이 오류 없이 그대로 남았다(docstring은 “모든 언어”라고 했다). 이제 X가 없는 언어 블록에 먼저 선언한다: 다른 블록의 X 선언을 id만 바꿔 복사하고(replace_font와 같다), 어디에도 없으면 전처럼 일곱 블록에 기본 선언을 더한다. 한/글 저장본의 글자 모양 12,188개 가운데 12,187개가 일곱 언어에 같은 글꼴을 쓴다.run.set_format(font=)는 이미 일곱 언어에 줬다. 몇 언어만 바꾸려면font_by_lang=.그 언어의
hh:fontface블록 자체가 없는 문서에서도 블록을 한/글의 자리에 만들고 같은 규칙으로 복사한다(글꼴 형식·대체 글꼴이 그대로다. 전에는 새 블록에 TTF 기본 선언을 썼다). 한/글 저장본 1,265개는 모두 일곱 블록을 갖는다.font_by_lang=,run.set_format(font=, font_by_lang=)·run.set_font,set_style_format(font=),set_char_property(font=)도 같은 규칙으로 선언한다(전에는 다른 블록에 HFT·대체 글꼴로 선언된 글꼴도 TTF 기본 선언을 더했다).ensure_font는 전처럼 준 인자(font_type=기본 TTF)대로 선언한다.
거부한 서식 호출은 문서를 조금도 바꾸지 않는다.
ensure_run은 색(color·highlight·underline_color·shadow)을 글꼴을 선언한 뒤에 검사해서, 잘못된 색으로 거부해도 글꼴 선언이 남았다(새 글꼴이면 일곱 개). 이제 모든 인자를 문서를 건드리기 전에 검사한다.font=에 글이 아닌 값은AttributeError대신style-font-face-empty다.ensure_memo_shape도 잘못된 색으로 거부할 때 빈hh:memoProperties를 남기던 것을 고쳤다.자간은 어느 길이나 -50 ~ 100 %다.
ensure_run(letter_spacing=)만 100까지 받고letter_spacing_by_lang=·run.set_format·set_char_property·set_style_format은 51 ~ 100을 거부해서, 문서에 이미 있는 +75 같은 자간을 일부 언어나 한 런에 다시 줄 수 없었다. 한/글 2024는 51·80·100으로 쓴 자간을 다시 저장해도 그대로 둔다.table.set_in_margins가 표 안여백으로 배치되는 칸(hasMargin꺼짐)의hp:cellMargin도 같은 값으로 쓴다.add_table(in_margins=CellMargins(...))로 만들 때 준다.복사한 문단·개체의 모든 개체
id를 새로 매기고(선·사각형 등도), 새로 넣은 개체의id가 문서의 다른 개체와 겹치지 않는다. 사본의instid는id와 같다.다른 문서의 문단을 옮기면(
copy_to,insert_document) 받는 문서의 같은 내용 정의(글꼴·테두리·탭·글자·문단 모양·스타일)를 다시 쓰고, 없는 것만 마지막 id 다음부터 만든다. 정의가 다른 정의를 가리키는 값(글꼴·테두리·탭·글자·문단 모양·스타일 id)도 받는 문서에서 내용이 같은 정의 가운데 첫 것으로 읽어 견준다. 그래서 한/글 문서처럼 같은 글꼴을 두 번 둔 머리(한자 블록의 함초롬바탕 0·6 등)에서도 같은 글자 모양을 새로 만들지 않는다. 번호 정의는 내용이 같아도 따로 둔다. 번호 정의 id가 목록이 이어지는지를 가르고, 한/글도 같은 번호 정의를 따로 둔다(pages_empty_numbered_paragraphs).HwpxDocument.new()로 만든 문서가 처음 더한 문단으로 시작한다. 전에는 처음 더한 문단이 빈 첫 문단 뒤에 붙어 모든 새 문서가 빈 줄로 시작했다. 이제 처음 더하는 문단(add_paragraph,add_heading)이 그 빈 줄을 차지하고, 구역 설정과 먼저 넣어 둔 머리말·꼬리말·쪽 번호는 그 문단으로 옮겨 간다. 문단 번호가 하나씩 당겨진다: 6.x의doc.paragraphs[1]이 7.0의doc.paragraphs[0]이다. 6.x 동작은HwpxDocument.new(empty_first_line=True). 표나 개체를 먼저 더한 문서, 첫 줄을 직접 쓴 문서, 열어서 고치는 문서는 전과 같다.add_equation이 적는 수식 글꼴이HYhwpEQ에서HancomEQN으로 바뀌었다. 한/글 수식 편집기의 글꼴이라 한/글에서 직접 넣은 수식과 같은 모양이 된다. 획이 조금 굵어지고 일부 글자의 폭이 달라진다. 전의 모양은font="HYhwpEQ".add_heading뒤에add_paragraph로 더한 본문이 제목의 문단 모양과 스타일(개요)을 물려받지 않는다. 물려받은 본문에는 한/글이 다음 개요 번호(“나.”, “다.” …)를 붙였다. 본문 뒤의 본문은 전처럼 앞 문단을 따른다. 제목 모양이 필요하면inherit_style=True. 모델의section.add_paragraph는 전처럼 앞 문단을 그대로 따른다.머리말·꼬리말을 한/글처럼 본문 컨트롤(
hp:ctrl) 한 곳에만 쓴다. 6.x는hp:secPr아래에 사본과headerApply를 하나 더 썼다 (OWPML 스키마에 없는 모양). 공개 한/글 저장본 68개가 모두 한 곳에만 둔다. 6.x로 만든 문서는 그 머리말을 다시 설정할 때 사본을 걷어 낸다.table.insert_rows()·insert_columns()(doc.tables.insert_rows·insert_columns도)가 한/글처럼 빈 행·열을 넣는다. 6.x는 기준 행의 글·개체까지 복사해서, 제목 행 아래에 넣으면 제목 글이 새 행에 그대로 생겼다. 이제 새 칸은 기준 칸의 서식(칸 속성·테두리/배경·여백·크기·문단 모양·글자 모양)만 받고 빈 문단 하나를 둔다(한/글 저장본table_insert_row_*·table_insert_column_*와 같은 모양).blank=를 주지 않던 코드는 오류 없이 결과가 바뀐다. 복사하려면copy_content=True.blank=는 없어졌다(부르면hwpx-argument-removed가 알려 준다:blank=True는 지우고,blank=False는copy_content=True). 바이트 편집apply_table_ops의insert_row_by_clone·insert_column_by_clone은 전처럼 복사가 기본이다("blank": True로 빈 칸).doc.add_table(style=)·doc.add_picture(style=)가 스타일의 문단·글자 모양도 적용한다. 6.x는 스타일 이름표만 붙였다.obj.remove()·table.remove()가 다른 곳에서 쓰지 않게 된 그림 데이터도 함께 지운다. 남기려면remove_orphaned=False.표 칸·글상자·각주·머리말 안에 떠 있게 만든 개체는 문단 기준으로 그 안에 머무르게 놓인다(한/글 저장본의 그 자리 개체들이 쓰는 배치). 본문에 만드는 개체의 기본값은 그대로다.
각주·미주를 더하거나 지우면 같은 종류의 번호를 문서 순서대로 다시 매긴다. 쪽마다 새로 매기는 각주(
ON_PAGE)가 있는 문서는 다시 매기지 않는다(아래 “한/글이 하는 것”).note.text는 문단을 줄 바꿈으로 잇는다.파일에 적히지 않은 속성은 OWPML 스키마의 기본값으로 읽는다:
editable이 없는 누름틀의field.editable이True(6.x는False),autoIndent·textOffset이 없는 번호 수준의auto_indent·text_offset이True·50(6.x는False·0). 한/글은 두 속성을 늘 적으므로 한/글 저장본은 전과 같다(공개 문서의 필드 703개·번호 수준 12,872개 모두 적혀 있다).용지 크기와 여백도 파일에 적힌 대로 읽는다: 적히지 않은 값은 스키마 기본값(용지 59528×84188, 머리말·꼬리말 4252, 제본 0)이고, 기본값이 없는 왼·오른·위·아래 여백이 없거나 숫자가 아니면(또는 용지 설정이 없으면) 0이 아니라
None이다. 그래서doc.page.size()·doc.page.margins()의 값이int | None이다. 한/글 저장본(공개 문서 1,637 구역)은 모두 적혀 있어 전과 같다.doc.text.highlights가 본문만이 아니라 표 칸·글상자·머리말·각주 등 모든 문단의 형광펜을 돌려준다.칸에 색을 칠해도(
set_cell_shading,set_shading) 그 칸의 선·대각선과 그림 배경은 그대로 남고, 그러데이션은 새 색으로 바뀐다. 새로 만드는 칠의 무늬 색(hatchColor)은#FF000000대신#999999로 적는다(둘 다 한/글이 쓰는 값이고, 무늬가 없어 보이는 모양은 같다). 그림을 넣으면 면 색이 남는다. 칸마다 제 테두리 정의에서 사본을 만들므로header.xml의 테두리 정의가 늘 수 있다.글자·문단 모양 변경 추적은 쓰지도 거절하지도 않는다(
track-format-change-unconfirmed). 6.x의 거절은 표시만 걷어 수락처럼 굴었다.doc.styles["바탕글"]처럼 이름·영문 이름·번호로 스타일을 찾는다(6.x는KeyError)."바탕글" in doc.styles도True다.크기가 0인 수식·차트, 빈 책갈피 이름, 빈 링크 주소를 거부한다.
paragraph.style에 스타일이 아닌 값을 주면HwpxTypeError다.doc.refs.cross_references의 항목이 살아 있는CrossReference라 값을 바꾸고 지울 수 있다(같은지는 요소로 견준다).paragraph.clear_layout_cache()가 늘 그 문단의 파트를 바뀐 것으로 표시한다. 고치지 않은 문단에 불러도 그 구역을 다시 쓴다.다단 문서에서 새 표와 차트의 기본 폭이 본문 전체 폭이 아니라 단 폭이다.
구역이 여럿인 문서에서
doc.page.*를section없이 부르면 마지막 구역만 바뀐다는 경고가 한 번 나온다. 모든 구역은section="all".열기에 실패할 때 stderr에 traceback을 찍지 않는다. 미리보기 파트가 없는 문서도 경고 없이 연다.
.hwp를 연 문서의conversion_report: 글자·문단 모양 변경 추적을 옮기므로range-tag-18(옮기지 못함)·range-tag-19(버림)가 더 나오지 않는다. 문서 이력(DocHistory)이 있으면unconverted["doc-history"]로 알리고, 그 문서는.hwp로 다시 쓰지 않는다.배포: sdist에 테스트 파일을 싣지 않는다. 릴리스 태그는
v7.0.0처럼v접두사가 붙은 최종판 버전만 받는다. 개발 단계 분류는 안정(Production/Stable)이다.
옮긴 것(python-hwpx-automation 8.0)
인자와 결과는 6.x와 같고, 문서의 메서드였던 것은 문서를 첫 인자로 받는 함수가 됐다. pip install python-hwpx-automation이
python-hwpx 7.0을 함께 설치한다.
Markdown으로 문서 만들기:
hwpx.tools.markdown_import.from_markdown·MarkdownStyle,doc.text.append_markdown(md)→hwpx_automation.markdown.from_markdown·MarkdownStyle,append_markdown(doc, md).Markdown·HTML 내보내기:
doc.text.markdown()·html(),hwpx.tools.exporter.export_markdown·export_html,hwpx.tools.markdown_export→hwpx_automation.markdown.to_markdown(doc)·to_html(doc)·equation_markdown.색인용 변환:
hwpx.ingest,hwpx.HwpxMarkdownConverter,hwpx.experimental의 ingest 7개 →hwpx_automation.ingest.LangChain 로더·LlamaIndex 리더:
hwpx.integrations.langchain.HwpxLoader,hwpx.integrations.llama_index.HwpxReader→hwpx_automation.integrations.langchain·hwpx_automation.integrations.llama_index.양식 칸 찾기·채우기:
doc.tables.find_cell_by_label·form_slots·fill_by_path→hwpx_automation.forms.find_cell_by_label(doc, ...)·form_slots(doc)·fill_by_path(doc, ...).글자로 적힌 선택 칸:
doc.fields.choices()·choose()→hwpx_automation.forms.form_choices(doc)·choose(doc, ...).메일 머지:
hwpx.merge_template_rows·load_mail_merge_rows·inspect_mail_merge_placeholders·MAIL_MERGE_REPORT_VERSION,hwpx.tools.mail_merge→hwpx_automation.mail_merge. 한/글의 메일 머지 필드를 넣는paragraph.add_mail_merge_field는 엔진에 남는다.미리보기:
render_layout_preview·render_document_viewer(hwpx.experimental,hwpx.tools.layout_preview·document_viewer)와 수식 그림hwpx.equation.render_equation·latex_to_mathml등 →hwpx_automation.preview.서식 규칙 검사:
hwpx.tools.format_rules.check_format, 명령hwpx-check-format→hwpx_automation.format_rules, 같은 이름의 명령.표 정리·보고서 수치:
hwpx.tools.table_cleanup·hwpx.tools.report_utils→hwpx_automation.office.utilities.참조 일관성 검사:
hwpx.inspect_reference_consistency·REFERENCE_CONSISTENCY_REPORT_VERSION→hwpx_automation.office.compliance.6.x 루트 이름
doc.export_markdown()·export_rich_markdown()·export_html()·fill_by_path()·find_cell_by_label()→ 위의 새 자리.
6.12.0 뒤 이 기능들에 생긴 변화(보고서 모양이 기본인 from_markdown, Markdown의 그림·링크·각주·인용·수식·머리말·메모, 양식
이름표의 공백 무시와 몇 번째 이름표 고르기, 메일 머지의 한글 키 등)는 자동화 8.0에 그대로 있다. 결과가 달라지는 것은 이주 가이드에 있다.
추가
글과 서식
내용을 파일에 적힌 차례대로 읽는다.
run.content는 런이 담은 것을 조각(InlineItem)마다 차례로 돌려준다: 글자, 탭·줄 바꿈· 묶음 빈칸·고정폭 빈칸·하이픈, 형광펜·차례 표시·변경 추적 표시, 누름틀 시작·끝, 각주·미주, 책갈피, 자동 번호 같은 컨트롤, 개체·덧말·글자 겹치기. 모르는 요소도 버리지 않고"unknown"과 요소 이름으로 낸다.run.to_model()이 버리던 글자 원자가 모두 나오고(공개 견본 1,300여 개의 런 약 10만 개 중 1만 2천 개에서 둘이 달랐다), 트리를 다시 파싱하지 않는다.paragraph.iter_objects(kinds=, where=)는 문단 안의 개체를 표 칸·글상자·묶음·각주 속까지 문서 차례로,shape.iter_paragraphs(where=)는 도형 안의 문단(글상자·캡션·구성원·안쪽 표)을,section.blocks는 구역의 문단과 다른 프로그램이 구역 바로 아래 쓴 표를 파일 차례로 돌려준다.paragraph.nested_text(where=)는 문단의 글에 문단 안 표 칸·글상자· 캡션·각주 문단의 글을 문서 차례로 더해 읽는다(paragraph.text는 그대로 문단 자신의 글이다). 모두 읽기만 한다.BorderFillInfo.fill_kinds: 테두리/배경 정의의 채움 종류를 적힌 차례로 읽는다("color"·"gradation"·"image", 채움이 아예 없으면()). 전에는fill(단색)만 있어 그러데이션·그림 채움과 채움 없음을 가르지 못했다.런의 서식을 한 줄로 읽고 바꾼다:
run.size = 14(pt),font,color,highlight,strike,superscript,subscript,letter_spacing,ratio, 여럿은run.set_format(...), 언어별 글꼴은run.set_font(face, lang=...). 엔진이 그 런만의 글자 모양 사본을 만들고(같은 정의가 있으면 그것을 쓴다), 같은 모양을 쓰던 다른 런은 그대로다.run.fonts는 일곱 언어(한글·영문·한자· 일본어·기타·기호·사용자)의 글꼴을 한 값(LanguageFonts)으로 돌려준다.문단의 서식도 속성으로 읽고 바꾼다:
alignment,indent_left_mm,indent_right_mm,first_line_indent_mm,spacing_before_pt,spacing_after_pt,line_spacing,page_break_before,keep_with_next,keep_lines,widow_orphan,page_break,outline_level,style(스타일의 문단·글자 모양까지 적용).paragraph.format_range(start, end, bold=True)로 문단 안 글자 범위에 서식을 주고,paragraph.split_run(offset)으로 런을 나눈다. 위치는paragraph.text대로 세고, 탭·줄 바꿈·책갈피는 그대로 남는다.스타일:
doc.styles.set_style_format(style, ...)으로 스타일의 글자·문단 모양을 고치고,remove_style(style, replacement=...)로 지운다(쓰던 문단은 대체 스타일을 받는다).outline_style(3)은 “개요 3” 스타일을,outline_level(style)은 개요 수준을 돌려준다.ensure_tab_definition,ensure_paragraph_format(line_spacing=, condense=, break_setting=), 한 변만 바꾼 테두리ensure_border_fill(base_border_fill_id_ref=..., sides={"bottom": {...}})도 있다.sides=에서None을 준 면은 선을 긋지 않아, 위아래만 굵은 표나 머리 행 아래 이중선을 만들 수 있다.번호·글머리표:
doc.styles.add_numbering(levels)는 한/글이 새 번호 목록에 쓰는 열 수준 정의(1.·가.·1)·가)…)를 새로 만든다.tests/fixtures의 번호 정의 1,157개 가운데 1,071개가 이 모양이다. 한/글은 번호를 정의마다 세므로 늘 새 정의(새 목록)다.ensure_bullet("●"),set_numbering_level(...),numbering(id)(값NumberingInfo), 문단에 거는paragraph.set_numbering(numbering, level=1)·set_bullet(bullet, level=1)(None은 뗀다), 구역의 개요 번호 정의section.properties.outline_shape_id_ref도 있다.NumberingLevel.use_instance_width(hh:paraHead/@useInstWidth, 번호 너비를 번호 글자 너비에 맞추는지)로 번호 수준의 속성 11개를 모두 값으로 읽는다. 머리 XML을 직접 읽지 않아도 된다.찾기·바꾸기:
doc.text.find("글")·doc.text.find(r"\d+", regex=True)가 표 칸·머리말·각주·캡션까지 찾은 곳을TextMatch(문단,paragraph.text기준 위치, 자리)로 돌려준다. 그 위치는format_range에 그대로 넘긴다.doc.text.replace(..., regex=True)는 바꿀 글에\1·\g<이름>을 쓴다. 기본 범위(본문 문단의 런 하나 안)에서 0건인데 찾는 글이 그 밖에 있으면ReplaceScopeWarning(hwpx.errors)으로everywhere=True를 알린다. 돌려주는 횟수와 문서는 같다.덧말·글자 겹치기를 읽고 고치고 지운다:
doc.shapes.rubies·composed_characters,paragraph.rubies·composed_characters,ruby.remove()(본말은 글로 남긴다). 한/글 저장본으로 읽기·고치기·지우기를 확인했다.문단:
paragraph.insert_after()·insert_before()로 원하는 자리에 문단을 넣거나 복사하고(누름틀 id는 새로 매긴다),move_after()·move_before()로 옮긴다(구역 설정과 걸린 메모도 함께 옮긴다).paragraph.objects·pictures·equations가 문단의 개체를 모델 객체로 돌려준다.줄 배치:
paragraph.line_segments로 한/글이 저장한 줄 배치(줄마다 시작 글자·세로 위치·높이·기준선·폭)를 읽는다. XML을 직접 고친 뒤에는paragraph.clear_layout_cache()·section.clear_layout_cache()·doc.oxml.clear_layout_cache(stale_only=...)로 옛 캐시를 지운다. 공개 편집 API는 캐시를 알아서 지운다.paragraph.available_width는 문단이 쓸 수 있는 폭이다.hwpx.tools.exporter의ListLabels(doc).label(paragraph)가 한/글이 문단 앞에 그리는 번호(“1.”, “가.”, “●”)를,NoteLabels(doc).label(note)가 각주 번호를 돌려준다.number_text,table_grid_text,hwpx.oxml.run.text_element_content도 공개다.doc.shapes.*·doc.refs.*·doc.notes.add_footnote·doc.page.set_columns의paragraph=에 문단 번호(정수)를 줄 수 있다.doc.styles.ensure_run(letter_spacing_by_lang={"HANGUL": 0, "LATIN": -5}): 언어마다 다른 자간(-50 ~ 100 %)을 쓰는 글자 모양을 만든다. 언어 이름과 검사는font_by_lang과 같고, 대지 않은 언어는 기준 글자 모양의 값을 그대로 둔다.letter_spacing과 함께 주면letter_spacing_by_lang이 이긴다. 잘못된 값은 아무것도 바꾸기 전에style-run-letter-spacing-by-lang-invalid로 거부한다. 전에는 몇 언어의 자간만 바꾸려면ensure_char_property(predicate=, modifier=)안에서 XML을 고쳐야 했다.
표
정렬: 칸의 세로 정렬
cell.vertical_alignment, 표의 가로 정렬table.alignment.크기:
table.width·set_width(w, proportional=True),column_widths·row_heights,set_column_width·set_row_height,set_row_heights([...]),table.columns[i].width = w,table.rows[i].height = h. 병합 칸도 함께 맞춘다. 한/글은 행을 정한 높이보다 낮게 그리지 않고 글이 길면 늘린다.테두리와 배경:
table.set_borders(cell_range, sides=, line_type=, border_width_mm=, color=, inner=),set_shading(cell_range, color=),cell.border_fill, 표 자체의table.border_fill_id_ref·border_fill.칸 영역(여러 칸에 한 칸처럼 테두리·배경을 줄 때 한/글이 저장하는 것)을 만들고 고치고 지운다:
table.add_cell_zone("A2:C4", border_fill_id_ref=...),set_cell_zone,remove_cell_zone,cell_zones. 행·열을 넣고 지우면 영역이 따라간다(한/글 저장본으로 확인).제목 행
header_rows·set_header_rows(n, repeat=True)·repeat_header·cell.is_header, 쪽 경계에서 나누는 방식table.page_split,no_adjust, 칸 간격cell_spacing, 안 여백in_margins·set_in_margins, 바깥 여백out_margins·set_out_margins, 배치text_wrap·set_position(개체와 같은 인자). 표도 개체처럼position·z_order·locked·numbering_type을 읽는다.칸: 세로쓰기
cell.text_direction = "VERTICAL", 셀 보호cell.protected, 양식 모드 편집cell.editable, 칸 비우기cell.clear().열 단위 접근
table.columns(TableColumn), 범위의 칸cells_in("A1:C2"), 표 복사copy_after()(새 id), 표 지우기table.remove(), 칸 안의 표까지 표 지도(doc.tables.map())와 같은 순서·번호로 돌려주는doc.tables.with_nested.
개체
set_position(flow_with_text=, allow_overlap=): 떠 있는 개체를 쪽 영역 안으로 제한하거나 겹침을 허용한다(hp:pos/@flowWithText·@allowOverlap).obj.position.has_position·treat_as_char_written은hp:pos와treatAsChar가 적혔는지 읽는다.python-hwpx 6.x가 구역 설정 안과 본문 컨트롤에 두 벌 적은 머리말·꼬리말은 어느 공개 길(
doc.text.iter_paragraphs(where="footer"),doc.page.footers(),run.content의 꼬리말 조각)로 고쳐도 저장할 때 두 벌이 같아진다(바뀐 쪽을 다른 쪽에 옮긴다). 한/글 저장본은 본문 컨트롤에만 적는다(hancom_saved의 머리말·꼬리말 16개 모두).그림·수식·차트·도형·글상자·묶음·표를 지우고(
obj.remove(), 문단은 남고 연결선은 연결만 놓는다), 같은 문서의 다른 문단(표 칸· 글상자·각주·머리말 포함)의 원하는 글자 자리로 옮기거나 복사한다(obj.move_to(paragraph, offset=...), 사본을 돌려주는obj.copy_to(...)). 사본은 새 id를 받고 그림은 같은 이미지를 쓴다. 한/글 문서가 두지 않는 자리(쪽 기준으로 떠 있는 개체를 표 칸으로 등)는 바꾸기 전에 거부한다. 한/글 저장본의 칸 안 개체 634개 가운데 633개가 문단 기준이다. 공개 문서 990개에서 2,756번 옮기고 복사해 편집 탓 오류와 다른 파트의 바이트 변화가 없었다.배치와 크기:
obj.position(ObjectPosition), 읽고 쓰는 속성z_order·rotation·description(대체 글),obj.set_position(treat_as_char=, text_wrap=, ...)(도형도 같은 인자),width·height·resize(width=...)(한쪽만 주면 비율을 지킨다), 바깥 여백out_margins·set_out_margins(...),locked·numbering_type.그림 모델
hwpx.model.Picture:doc.media.pictures,original_size, 읽고 쓰는crop, 밝기·대비·효과·테두리·그림자 읽기,line_width_mm. 공개 문서의 그림 897개 모두에 공개 API로 닿는다.회전은 한/글 저장본으로 확인된 모양에만 쓴다. 늘이거나 줄인 그림·도형도 돌리고, 돈 그림의 크기를 바꾸거나 자른다.
글상자·글이 든 타원 같은 글이 든 도형과 묶음 전체를
obj.rotation = 각도로 돌린다. 한/글 2024가 돌려 저장한 문서(30·45·90·180· 270·330°, 사각형·글상자·글이 든 타원, 사각형·타원·선·다각형·글상자로 된 묶음, 늘인 묶음, 묶음 안 묶음, 이미 30° 돈 글상자·묶음을 45°로)와 개체 부분(크기·변환 행렬·회전 중심·글 폭)이 같다. 글은 한/글처럼 돌지 않고 돈 도형을 감싸는 상자 폭에 가로로 다시 놓인다. 각도는 한/글처럼 처음 모양에서 잰 절대각이고 0~359로 바꿔 쓴다(-30 → 330). 돈 묶음은 다른 각도로 다시 돌리거나 0으로 되돌릴 수 있다. 늘인 묶음 안의 묶음도 돈다. 묶음 구성원 하나만 돌리기(shape-group-member-unsupported), 혼자 돌았거나 뒤집힌 구성원이 든 묶음(shape-rotation-unsupported)은 근거가 없어 계속 거부하고, 오류가 무엇은 되는지 알려 준다.돈 개체(그림·도형·묶음, 뒤집힌 것 포함)의
resize(width, height)는 돌리기 전 자기 크기를 받는다. 0으로 되돌려 크기를 바꾸고 다시 돌린 것과 같아, 돈 직사각형이 평행사변형으로 기울지 않는다. 한/글이 크기를 먼저 바꾸고 돌린(뒤집은) 저장본과 개체 부분이 같다. 한/글의 개체 속성은 돈 개체를 감싸는 상자의 크기를 받아 쪽의 가로·세로로 늘이므로 모양이 기우는데, 그렇게 저장된 개체는 읽고 그대로 두되 다시 크기를 바꾸거나 돌리거나 뒤집지 않는다(shape-rotation-unsupported). 7.0 개발 중 한때 돈 묶음의resize가 상자의 크기를 받던 것이 7.0에서 달라진다.그림·도형·묶음의
width·height가resize와 같은 자기 크기(돌리기 전 그려진 크기)를 읽어,obj.resize(obj.width, obj.height)는 어떤 개체에서도 아무것도 바꾸지 않는다. 돈 개체가 문단에서 차지하는 상자(hp:sz)는 새 읽기 전용 속성box_width·box_height로 읽는다(돌지 않은 개체에서는width·height와 같다).사각형·글상자·타원·다각형·선·호·곡선·그림과 묶음 전체를 읽고 쓰는 속성
obj.flip_horizontal(좌우)·obj.flip_vertical(상하)로 뒤집는다. 한/글 2024의 좌우·상하 뒤집기(뒤집기만, 뒤집은 뒤 45°·30°, 45°에서 다시 0°, 30° 돈 글상자·묶음 뒤집기, 양쪽 뒤집기)로 저장한 개체와 개체 부분이 같다. 돈 개체를 뒤집으면 한/글처럼 반대 방향으로 돈 것이 된다(30° → 330°). 뒤집힌 개체는 돌릴 수 있고False로 되돌린다. 묶음은 그려진 크기의 가운데에서 제자리로(돈 묶음도 자리·상자를 그대로) 양쪽으로도, 늘인 것도, 묶음을 품은 것도(상하·돈 것· 늘인 것 포함) 뒤집히고, 구성원은 자기hp:flip이 0인 채 행렬로 뒤집히며 구성원 각도는 한/글처럼 “(좌우 180, 상하 0) − 구성원 각도 − 뒤집을 때 묶음 각도”로 적힌다. 뒤집은 그림(돌지 않은 것)과 뒤집은 돌지 않은 묶음(양쪽 포함)은 한/글처럼 크기를 바꾸고(거울 축은 그대로,scaMatrix가 늘거나 준 만큼 옮긴다), 그렇게 바꾼 그림은 돌리거나 다시 뒤집을 수 있으며 늘인 그림·호·곡선도 뒤집는다. 늘이고 돌린 묶음은 한/글처럼 자기 늘인 직사각형이 그려진 자리를 감싸는 상자의 가운데에서 그려진 대로 거울에 비춘다(가운데는hp:sz의 절반). 그 묶음에 다시 각도를 주면 바뀐 각도만큼 묶음이 쥔 가운데에서 돈다. 꼭짓점으로 그린 호(hp:flip만 켠 꼴)를 뒤집으면 한/글처럼 그려진 모양을 거울에 비추고 그 거울의 표시·각도로 적는다. 늘인 사각형·타원·다각형·선도 뒤집고, 뒤집은 사각형·타원·다각형도 그림처럼 크기를 바꾼 뒤 돌린다(홀수 크기 다각형은 한/글처럼 자기 크기의 정수 가운데를 늘인 자리에서 거울, 쥔 가운데에서 돌림). 뒤집고 늘인 묶음도 돌고, 묶음을 품은 뒤집힌 묶음도 크기를 바꾼다. 한/글 2024가 저장한 74가지 계획(사각형·타원·다각형·대각선·수평선, 묶음, 묶음 안 묶음) 가운데 아래 거부로 남긴 15가지(모두 선) 밖의 59가지와 개체 부분이 같다. 높이나 너비 0으로 그린 선 뒤집기(한/글은 반 바퀴 돌림으로 적는다), 뒤집힌 선의 크기 바꾸기 (한/글은 거울을 버려 뒤집히지 않게 그린다), 뒤집힌 그림 자르기는 거부한다(shape-flip-unsupported·shape-flip-value).떠 있는 개체를 돌리면(
rotation, 돈 개체의resize) 한/글처럼 돌리는 가운데가 쪽 위에서 제자리에 있게hp:pos오프셋을 옮긴다. 왼쪽·위 기준과 가운데 정렬, 문단·단·용지 기준 모두 한/글 2024 저장본(그림·사각형·묶음, 30·45·90°, 다시 돌리기, 되돌리기, 늘인 뒤 돌리기, 돈 뒤 풀기)과 오프셋까지 같고, 0으로 되돌리면 처음 자리로 온다. 한/글은 옮긴 개체를 그 높이의 문단에 다시 걸지만 엔진은 원래 문단에 두어 같은 자리에 그린다. 오른쪽·아래·안쪽·바깥쪽 정렬은 근거가 없어 옮기지 않는다.글상자가 든 묶음을 늘이면 글상자 글이 그려진 폭(
orgSz너비 × 가로 배율)에 놓인다(drawText/@lastWidth, 줄 캐시를 지운다). 한/글 2024가 글자처럼·떠 있음·가운데 정렬, 뒤집은 것, 다시 열어 저장한 것 모두 그렇게 저장했다. 전에는 양쪽으로 뒤집은 묶음 밖에서는 옛 폭이 남아, 늘인 글상자 안에서 글이 옛 폭으로 줄을 바꿀 수 있었다. 글상자 하나를 늘여도 새 폭에 놓는다. 구성원의 회전 가운데는 한/글이 조건과 저장 때마다 다르게 적고(그리는 데 영향이 없다) 엔진은 그대로 둔다.묶음을 풀면 구성원이 묶음의 그리는 순서 자리를 이어받는다(첫 구성원이 묶음의
zOrder, 마지막이 맨 위, 묶음 위의 개체는 그만큼 위로). 전에는 구성원을 모든 개체 위로 올렸다. 가운데 정렬로 놓인 묶음도 푼다.높이나 너비가 0인 선(수평선·수직선)도 뒤집는다. 한/글처럼 그림은 바뀌지 않고(끝의 화살표도 그대로) 뒤집기 표시와 반 바퀴 회전을 함께 적는다(좌우면 각도 180). 읽으면
flip_horizontal == True,rotation == 180이다. 다시 뒤집으면 처음 꼴로 오고, 뒤집은 뒤 돌리거나 크기를 바꾸는 것도 한/글 저장본과 같다. 높이 0 선을 그냥 돌리면 납작한 축의 배율을 0으로 쓴다. 6.x와 7.0 개발 중에는 1로 두어 한/글이 돌린 선을 수평 그대로 그렸다. 돌린 뒤 뒤집기도 한/글처럼 거울에 비추고, 그 뒤 다시 돌리기(0으로 되돌리기 포함)도 한/글과 같다.Shape.ungroup()이 좌우·상하로 뒤집은 묶음(30° 돈 것도)과 묶음을 품은 묶음(바깥만 풀린다)도 한/글처럼 푼다. 양쪽으로 뒤집은 묶음, 뒤집고 늘인 묶음, 뒤집고 돌린 묶음, 묶음을 품은 뒤집힌 묶음도 푼다. 뒤집은 묶음의 구성원은 묶음의 뒤집기 표시를 받고, 안쪽 묶음은 그 도형들의 자리를 자기 기준으로 옮기고 한 단계 올라온다. 양쪽으로 뒤집은 묶음, 뒤집고 늘인 묶음은 근거가 없어 거부한다(shape-ungroup-unsupported).묶음의 구성원
shape.members. 묶음 안의 개체를 지우면 묶음이 남은 구성원에 맞춰진다.그림·수식·도형·표가 든 구역을
obj.section으로 읽는다(표 칸·글상자·머리말·각주 안의 개체도). 번호는doc.sections.index(obj.section)이고, 바탕쪽의 개체는None이다.한/글 선 굵기 목록(
hwpx.oxml.utils.LINE_WIDTHS_MM, 테두리 굵기가 받는 값 16개)과 그림·도형 선 굵기의 mm↔HWPUNIT 변환 (hwpx.oxml.shape_position.line_width_units·line_width_mm_for_units·LINE_WIDTH_UNITS_PER_MM)이 안정 계약이 되었다. 목록 밖 굵기를 가까운 값으로 맞추는 일은 하지 않는다(그런 굵기는 계속 거부한다).
수식
수식 모델
hwpx.model.Equation:paragraph.equations,doc.shapes.equations(표 칸·글상자·각주 안까지),eq.script = ...(상자를 다시 잰다),eq.font_size(pt),eq.font. 공개 문서의 수식 23,079개 모두에 공개 API로 닿는다.add_equation의font=로 수식 글꼴을 준다(doc.shapes.add_equation, 문단의add_equation).수식 변환
latex_to_eqedit·eqedit_to_latex·estimate_equation_size가 안정 계약(hwpx.equation)이 되었다.LaTeX → 한/글 수식이 받는 표기가 늘었다: 유니코드 기호(× ÷ ± ≤ → ∞ ° √ 등),
\displaystyle·\limits·\Big,\ell,\hbar,\colon,\pmod,\operatorname, 긴 화살표,\not=,\lfloor…\rfloor같은 짝 괄호,\|,\nearrow·\searrow,\Leftrightarrow·\iff,\perp,\parallel,\varnothing,\uparrow·\downarrow·\Uparrow, 가역 반응\rightleftharpoons, 호\overset{\frown}{AB}·\wideparen{AB},\boxed{}, 여러 줄 정렬aligned, 띄어쓰기\·\;·\:·\!·\quad·\qquad. 모두 한/글 2024(Windows)에서 그려 보고 기호로 나오는 표기만 넣었고, 읽는 쪽 (eqedit_to_latex)도 같은 표기를 안다. 중·고 수학·과학 표기 229개 가운데 226개가 변환된다.\mathbb·\widehat·\square는 맞게 그려지는 표기가 없어 계속 거부하고, 받지 못하는 표기는 거부 문구에 대신 쓸 표기를 알려 준다.
표시(누름틀·각주·메모·차례·상호 참조·변경 추적)
각주·미주:
doc.notes.footnotes·endnotes가 문서의 모든 각주·미주를 한/글 번호(note.number)와 함께 돌려준다.note.add_paragraph()로 문단을 더하고,note.remove()로 표시와 내용을 함께 지운다.누름틀:
field.remove()는 틀만,keep_text=False면 내용까지 지운다. 이름·안내문·메모·편집 가능 여부를 바꾼다. 시작을 담은 문단(field.paragraph), 끝 위치(end_location), 값을 담은 요소(text_elements)를 읽는다.양식 개체:
doc.fields.radio_buttons·combo_boxes·edit_boxes로 읽고 값을 쓰고,add_radio_button·add_combo_box·add_edit_box로 만든다. 요소 순서·속성·기본값은 한/글 저장본과 한/글이 만든 공개 표본을 따른다. 한/글 파일에는 콤보 상자의 고를 목록이 없어 목록은 쓰지 않는다.하이퍼링크·책갈피:
doc.refs.hyperlinks가 표 칸·글상자·각주 안까지 모든 링크를 돌려준다. 링크 주소와 표시 글을 바꾸거나link.remove()로 링크만 걷어 낸다(글자 모양은 한/글처럼 그대로 둔다).bookmark.rename(name)은 그 책갈피로 가는 링크도 함께 바꾸고,bookmark.remove()는 책갈피를 지운다.상호 참조:
doc.refs.add_cross_reference(target, content_type=..., hyperlink=...)로 만들고, 가리키는 대상(set_target)·보일 것· 링크를 바꾸고,remove()로 보이던 글을 남기고 지운다. 대상은 한/글 파일에서 본 것만 받는다: 개요 문단, 표, 책갈피. 그림·수식· 각주는 거부한다.차례:
doc.refs.tables_of_contents로 읽고,add_table_of_contents(levels=2, leader="DASH", hyperlink=True)로 만들고, 개요가 바뀐 뒤toc.rebuild()로 항목을 다시 만들고,toc.remove()로 지운다.메모:
doc.notes.add_memo(..., match="글")로 문단 일부 글자에만 건다.memo.move_to(section, index=...)·memo.copy_to(...)로 다른 구역 메모 묶음의 원하는 자리로 옮기거나 복사한다. 메모 선 굵기는doc.styles.ensure_memo_shape(line_width_mm=...)로 주고memo_shape.line_width_mm로 읽는다.변경 추적:
doc.tracking.accept()·reject()로 하나, 작성자별(author=), 전체를 수락·거절한다.
쪽과 구역
쪽·구역 설정을 읽는다:
doc.page.columns()(문단 중간 단 바꿈 포함),page_number_controls(),number_restarts(),page_hidings(),auto_numbers(),start_numbers(),doc.parts.begin_numbers,doc.parts.document_options.각주·미주 모양과 쪽 테두리:
doc.page.footnote_shape()·set_footnote_shape(),endnote_shape()·set_endnote_shape(),page_border()·set_page_border().doc.page의 설정 메서드에section="all"을 주면 모든 구역을 한 번에 바꾼다.머리말·꼬리말을 쪽 종류별로 읽고 그 문단을 고친다:
doc.page.headers()·footers()·header(page_type=)·footer(page_type=),header.add_paragraph("글").바탕쪽의 문단을
doc.parts.master_pages[i].paragraphs로 읽고 고치며(add_paragraph,text),doc.page.remove_master_page_reference(id)로 구역과의 연결을 끊는다.문서 전체 훑기:
doc.text.iter_paragraphs(where=...)·doc.text.iter_objects(kinds=..., where=...)가 표 칸·글상자·캡션·머리말·각주·메모· 바탕쪽까지 자리와 함께 돌려준다.
저장과 검사
HwpxDocument.new(seed=..., now=...)(그리고open)로 같은 스크립트가 다른 프로세스에서도 바이트까지 같은 파일을 만든다. 시각까지 고정하므로 초 경계에서 바이트가 달라지던 일(#683)도 없다. 기본은 전처럼 무작위 id다.seed=·now=는 그 문서에만 쓰인다: 7.0 개발 중에는 닫지 않은 seed 문서가 같은 스레드의 다른 문서(seed 없는 문서도)에 id와 메모·변경 추적 날짜를 주었고, 함께 연 seed 문서들은 따로 만들 때와 다른 바이트를 썼으며, 만든 순서대로 닫거나 닫지 않고 버리면 seed가 남았다. 이제는 무엇을 함께 열든 한 문서의 바이트는 그 문서만 따로 만들 때와 같다. 다른 문서에서 복사해 온 내용(copy_to,insert_document)의 새 id는 받는 문서의 것이다. 그룹 부재(ContainerMember)는 id 없이 만들어져(member.element의instid가 빈 값) 문서가 받을 때 그 문서의 id를 받는다. 부재를 만든 뒤 다른 것을 더하고 나서 묶으면 seed 문서의 id 차례가 7.0 개발 중과 다르고, 한 부재를 두 묶음에 넣으면 묶음마다 다른 id를 받는다(전에는 같은 id가 두 번 쓰였다).doc.save()의 영수증(MutationReport)에 품질 보고(quality)와, 저장한 바이트에 대해 이미 낸 열기 안전 보고 (editor_open_safety)가 있다. 다시 검사하지 않는다.doc.save(path, quality=policy, pipeline=SavePipeline(oracle_factory=...))로 품질 관문에 렌더러(예: python-hwpx-automation의 한/글 백엔드)를 준다. 렌더러는 정책이 렌더링할 때만 만들어지고, 그 밖의 저장(바이트, 열기 안전 검사 한 번,.hwp, 거부 때 아무것도 쓰지 않음)은 같다. 문서의 비공개 속성_save_pipeline에 넣던 방법은 없어졌다.저장에 실패하면
hwpx.errors.SaveTargetError가 대상 경로와 할 일을 말한다. Python의PermissionError·FileNotFoundError등이기도 해서 기존except가 그대로 잡는다.docs/stable-api.md에 엔진이 지키는 약속 아홉 가지(같은 바이트면 같은 결과, 고치지 않은 저장은 바이트 그대로, 공개 편집은 그 파트만 바꾸고 알린다 등)와 약속마다 그것을 지키는 테스트를 적었다.공개 표면 잠금이
tests/data/public_surface.json하나다. 이름·서명·반환이 바뀌면tests/test_public_surface.py가 실패한다 (기여자용,CONTRIBUTING.md의 “공개 표면 잠금”).입력 방어 함수(
hwpx.opc.security)와 글자 폭 측정 함수(hwpx.form_fit)가 공개 계약에 들어왔다.큰 문서의 저장이 빨라졌다. 저장 관문이 방금 쓴 문서를 한 번만 열고 압축을 한 번만 푼다. 결과는 공개 문서 1,304개에서 모두 같았고, 1 MB 이상 문서의 저장 시간 중앙값이 2.28초에서 1.46초로 줄었다.
validate_document는 이미 연HwpxDocument도 받는다.문서: 7.0 이주 가이드(
docs/migration-7.0.md), 사용 가이드의 “있는 문서 고치기”와 “시험지·학습지” 절.
.hwp 읽기
hwpx-text-extract가.hwp(HWP 5.0)에서도 글을 뽑는다..hwp를 HWPX로 열 때 한/글 자체 변환이 담는 것을 담는다: 글자·문단 모양 변경 추적과 그 정의(작성자·시각·종류), 꺾인 대각선과 중심선이 있는 칸, 채우기 그림의 밝기·명암, 표의 개체 설명, 공백으로 시작·끝나는 수식, 반전 사각형 속 숫자. 공개 표본 250개를 한/글이 같은.hwp를 HWPX로 저장한 것과 구조로 견주니, 뜻이 다른 문서가 151개에서 9개로 줄었다. 옮기지 못하는 것은conversion_report에 알린다.
하류 도구가 XML로 하던 일
글자 자리 읽기(글자 자리는
paragraph.text의 자리 하나다: 글자·탭·줄 바꿈·특수 공백 1, 컨트롤·개체 0):개체·표·각주/미주·누름틀·하이퍼링크·책갈피·상호 참조·선택 상자의
offset: 그 앞 글자 수.obj.move_to(paragraph, offset=obj.offset)이 제자리다.ObjectPlace.offset(doc.text.iter_objects())과InlineItem.offset(run.content의 조각마다, 글이면 첫 글자의 자리)도 같은 값이다.run.has_text_element(빈hp:t도),run.is_plain_text(글·탭·줄 바꿈·특수 공백만 든 런).cell.address_written(hp:cellAddr가 적혔는지),cell.has_sub_list.hp:subList없이 문단을 바로 품은 칸(한/글이 쓰지도 열지도 않는 꼴, 다른 도구가 쓴irb_form_*)의 문단도cell.paragraphs가 읽는다. 그 칸에 쓰기는table-cell-no-sublist로 거부한다.런 안
hp:switch:run.content의"switch"조각object가SwitchChoice(required_namespace,case·default의 개체)다.LineSegment.text_position·paragraph.line_texts의 자리는 한/글의 셈(탭·컨트롤 8, BMP 밖 2)이라paragraph.text의 자리와 다르다고 설명에 적었다.
글 구간 쓰기(자리 셈은 위와 같다. 범위
[start, end)는 양 끝에 선 컨트롤·개체를 품지 않는다):paragraph.insert_text(offset, text, *, char_pr_id_ref=None, **format): 그 자리에 이미 있는 컨트롤·개체 뒤, 그 자리 글자 앞에 넣는다. 모양을 주지 않으면 들어간 런(그 자리 마지막 컨트롤의 런, 없으면 앞 글자의 런)의 모양이다. 모양을 주면 런을 따로 둔다.paragraph.delete_range(start, end, *, objects="refuse"): 글·탭·줄 바꿈·특수 공백과 그 안의 표시를 지운다. 비는 런은 지우고, 나란해진 같은 모양 런은 하나로 합친다. 범위 안 컨트롤·개체는paragraph-range-holds-objects로 거부한다.objects="remove"면 각자의remove()대로 함께 지운다(각주 번호 다시 매김, 쓰지 않는 그림 정리).paragraph.copy_range(start, end, *, to, offset=None)·move_range(...): 같은 문서나 다른 문서의 문단으로 복사하거나 옮기고 새 자리를 돌려준다. 다른 문서로는copy_to처럼 정의·그림을 가져가고 새 id를 준다. 표·글상자·캡션은 다른 문서로 가지 않는다 (shape-copy-document-unsupported). 같은 문서 안 옮기기는 개체 자신이 옮겨 가 id가 그대로다.거부(새 오류 코드):
누름틀·하이퍼링크의 시작이나 끝 한쪽만 품은 범위:
paragraph-range-splits-field.변경 추적 표시를 품은 범위:
paragraph-range-splits-mark.자기 안으로 옮기기:
paragraph-range-into-itself.각주를 각주·머리말·꼬리말로 옮기기:
paragraph-move-place-unsupported.없는 글자 모양:
style-char-pr-missing.
한/글이 쓰는 꼴로 쓴다. 근거는 한/글 2024가 저장한
mid_text_*·highlight_*(tests/fixtures/hancom_saved)다.글 가운데 각주·책갈피는 한 런 안 두
hp:t사이에 둔다.범위 밖으로 이어지는 형광펜은 남은 쪽 가장자리에서 시작하거나 끝나게 한다.
형광펜을 복사하면 사본 가장자리에서 열고 닫는다.
한/글이 문서를 여는 캐럿 자리(
settings.xml의ha:CaretPosition):doc.caret으로 읽는다.doc.set_caret(paragraph, offset=0)으로 본문 문단에 둔다. 자리는 한/글의 셈이다(컨트롤·개체·탭 8).doc.reset_caret()은 본문 첫 문단의 글 처음(새 문서는pos="16")으로 둔다.저장할 때 캐럿이 없는 본문 문단을 가리키면 그 자리로 되돌린다. 한/글 2024도 그렇게 연다.
틀에서 지은 문서는
reset_caret()을 부를 때까지 틀의 캐럿을 그대로 가진다.표 칸·글상자·각주에 두기는
document-caret-place-unsupported로 거부한다. 그 목록 번호는 한/글 저장본으로 정해지지 않았다.settings.xml은 캐럿 요소만 고쳐 쓰고, 나머지 바이트는 그대로다.
구역 첫 문단에
hp:secPr는 있는데 단 정의(hp:ctrl/hp:colPr)가 없으면 패키지 검사와 열기 안전 검사가section-columns-missing으로 알린다.한/글은 그 구역을 기본 용지·여백으로 연다.
저장은 막지 않는다.
hwpx-repair는hp:secPr바로 뒤에 한/글이 쓰는 1단 정의를 넣는다.
FormField.start·end로 누름틀이 그 문단 글에서 시작하고 끝나는 자리를 읽는다. 한 문단 안 누름틀이면paragraph.text[start:end]가 그 글이다.clear_body·clear_content가 컨트롤 안 내용 때문에 거부할 때, 오류context에 문단 자리(paragraph, 구역 안 차례)와 문단마다 든 것(paragraphs)을 싣는다.각주·미주·책갈피·누름틀·형광펜을 글자 자리에 둔다. 근거는 한/글 2024 저장본
mid_text_*·highlight_*(tests/fixtures/hancom_saved)다.각주·미주·책갈피:
doc.notes.add_footnote(..., offset=)·add_endnote(..., offset=)·paragraph.add_bookmark(name, offset=)·doc.refs.add_bookmark(..., offset=)로 둔다.그 자리 컨트롤 뒤, 그 자리 글자 앞에 둔다. 글 가운데면 한/글처럼 그 런의
hp:t를 둘로 나누고 사이에 둔다.뒤 각주·미주 번호는 다시 매긴다.
note.move_to(paragraph, offset=)·note.copy_to(paragraph, offset=):사본은 새
instId를 받는다.각주·머리말·꼬리말·메모 안으로는
paragraph-move-place-unsupported, 다른 문서로는note-other-document-unsupported로 거부한다.
paragraph.add_form_field(name, start=, end=):있는 글을 누름틀 값으로 감싼다. 런을 넘어도 된다. 글을 감싸면 안내문 런은 쓰지 않는다.
빈 범위(
start == end)에 안내문을 주면 범위 없이 넣을 때처럼 begin과 end 사이에 안내문 런을 쓴다. 한/글 저장본의 값 없는 누름틀 가운데 안내문이 있는 12개가 모두 이 런을 두고, 한/글은 이 런 없이 쓴 문서를 다시 저장할 때 런을 넣는다.다른 필드 한쪽만 품는 범위는
paragraph-range-splits-field로 거부한다.
형광펜 범위:
paragraph.add_highlight(color=, start=, end=)·doc.text.highlight(paragraph, start=, end=)로 칠한다. 런을 넘으면 시작·끝을 각 글자의hp:t에 한 번씩 둔다.doc.text.highlight_span(start_paragraph, start, end_paragraph, end)는 문단을 넘는 범위를 문단마다 한 쌍으로 칠한다.이미 있는 형광펜과 겹치면
paragraph-range-splits-mark로 거부한다.
note.copy_to가 원본 각주의 소문자instid를 사본에 그대로 두던 것을 고쳤다. 그래서 한 문서 안에 같은 인스턴스 id가 둘 생겼다.다른 도구나 python-hwpx 6.6 이하가 쓴 꼴이다.
이제 사본은 가진 표기(
instId·instid) 그대로 새 id를 받는다.새로 쓰는 각주는 한/글처럼
instId다(hancom_saved138개 모두).
doc.text.highlights가 런을 넘는 형광펜(한/글의highlight_across_runs꼴)을 통째로 읽는다. 전에는 첫hp:t안 부분만 읽었다.paragraph.clear_content(*, keep_headers=True, on_control_content="raise"): 문단의 본문 내용(글·표·그림·각주·책갈피·필드)을 비우고 구역 설정은 남긴다.남는 것은
hp:secPr와 그 옆 쪽 단위 컨트롤이다. 단 정의는 늘, 머리말·꼬리말은keep_headers대로 남는다.남는 컨트롤 안의 글·개체는
clear_body처럼on_control_content를 따른다.글이 하나도 남지 않으면
<hp:t/>런 하나를 둔다.
표 행 옮기기·복사:
table.move_rows(rows, *, to),table.copy_rows(rows, *, to, source=None).이어진 행 묶음을 그 행 앞(행 수면 끝)으로 옮기거나 복사한다.
rowAddr·rowCnt를 다시 매긴다.사본은 새 id를 받는다. 같은 문서·같은 열의 다른 표에서도 복사한다.
병합 칸이 묶음 경계나 넣을 자리를 가로지르면
table-rows-merge-crossed로 바꾸기 전에 거부한다.놓인 행을 돌려준다. 행 번호·자리가 잘못되면
table-rows-invalid, 열이 다르면table-columns-differ, 다른 문서 표는table-rows-other-document, 다른 표로 옮기기는table-rows-move-other-table로 거부한다.칸 영역(
hp:cellzone)은 제 행을 따라간다. 한 영역 안에서 행 순서만 바꾸면 영역은 그대로 한 덩어리로 남고 주소를 다시 적는다. 옮긴 뒤 영역의 행이 이어지지 않게 되면 바꾸기 전에table-rows-split-cell-zone으로 거부한다. 복사한 행이 들어간 자리 뒤의 영역은 그만큼 내려가고, 영역 가운데에 들어가면insert_rows처럼 영역이 그 행들까지 넓어진다(전에는 영역 주소를 그대로 두어 다른 행을 덮었다).
section.clear_body(keep_column_changes=True): 구역 가운데에서 단을 바꾸는 문단을 남긴다. 한/글은 단 바꿈을 뒤 문단의 런에 둔hp:colPr컨트롤로 쓴다. 남는 문단은 id·속성이 그대로이고, 런에는 그 컨트롤만 남는다. 남긴 수는ClearBodyReport.kept_column_paragraphs다. 기본값(False)이면 전처럼 지운다. 남기는 문단의 단 정의 컨트롤 안에 글·개체가 함께 있으면, 첫 문단처럼on_control_content를 따른다 (기본"raise"는 거부,"strip"은 지우고stripped_controls·control_content에 적는다).paragraph.set_text_preserving_runs(value)가hp:t안에 탭·줄 바꿈·특수 공백이 이미 있는 문단(한/글이 쓰는 꼴)도 고친다. 고친 곳 밖의 탭은 그 요소(너비 등) 그대로 남는다. 전에는paragraph-mixed-text-unsupported로 거부했다.누름틀을 채울 때 값의 글자 모양을 고른다:
doc.fields.fill(value, name=..., char_pr_id_ref=...). 주지 않으면 전처럼 누름틀 시작이 든 런의 모양이다(한/글이 채우는 방식). 값이 누름틀 시작·끝이나 앞뒤 글과 한 런에 있으면 런을 나눠 값만 바꾼다(한/글도 다른 모양의 값을 제 런에 둔다).개체와 표가 어느 캡션 번호에 드는지 쓴다:
obj.numbering_type = "PICTURE"("NONE"·"TABLE"·"EQUATION"),table.numbering_type.한/글이 저장한 줄마다의 글을 읽는다:
paragraph.line_texts(줄 배치 캐시의textpos를 한/글처럼 세어 자른다 — 탭·컨트롤·개체 8, 줄 바꿈 1). 표 칸 안 문단도doc.text.iter_paragraphs()로 읽는다. 셈법이 확인되지 않은 표시(변경 추적의 시작·끝 등)가 든 문단은 짐작하지 않고None이다. 공개 표본 250개의 한/글 변환본 문단 192,299개에서 강제 줄 바꿈이 늘 줄 끝에 왔다.doc.save(path, format="hwpx")처럼 형식을 밝히면 임시 이름(out.hwpx.tmp등)에도 확장자 경고를 내지 않는다(.hwp이름은 여전히 경고).같은 요소를 감싼 객체는 같다: 문단·런·표·행·칸·각주/미주·메모·개체·머리말/꼬리말 객체를
==로 견주고 dict 키·set 원소로 쓴다.doc.paragraphs.index(paragraph)도 된다. 전에는 표·행·런·각주 등을 부를 때마다 다른 객체로 보아id(x.element)로 견줘야 했고, 문단은 해시가 없어 dict 키로 쓸 수 없었다.칸 하나의 테두리·배경을 바꾼다:
cell.border_fill_id_ref = doc.styles.ensure_border_fill(...). 문서에 없는 id는 아무것도 바꾸기 전에table-border-fill-not-found로 거부하고, 이 칸의 참조만 바뀐다(줄 배치 캐시는 그대로).표의 제목 줄 반복만 켜고 끈다:
table.repeat_header = True. 제목 칸(cell.is_header)은 그대로다. 한/글이 만든 표도 제목 칸 없이repeatHeader="1"을 적는다(tests/fixtures/hancom_saved/cell_border_2x3_base.hwpx등). 바뀌면 표를 담은 문단의 줄 배치 캐시를 지운다.누름틀에 내용을 넣었는지 읽는다:
field.filled(hp:fieldBegin/@dirty). 한/글 저장본에서 넣은 내용을 보이는 누름틀은"1", 안내문을 보이는 누름틀은"0"이다.문단의 id를 읽는다:
paragraph.id(파일에 적힌 대로, 고유 키가 아니다).문단 하나를 다른 문서로 복사한다:
paragraph.copy_to(other_doc.paragraphs[i], before=False). 글자·문단 모양, 스타일, 테두리, 탭, 번호·글머리표, 글꼴 정의를 받는 문서에 새로 만들고 그림·차트 파트를 옮기며 누름틀·책갈피·개체·문단 id를 새로 매긴다 (insert_document가 한/글이 그냥 여는 꼴로 쓰는 규칙과 같고, 거부도 같다). 구역 설정은 따라가지 않는다. 같은 문서에서는insert_after()사본과 같다.글자 범위를 런 그대로 바꾼다:
paragraph.replace_range(start, end, text). 새 글자는 같은 자리 옛 글자의 런에 들어간다 (doc.text.replace와 같은 규칙). 범위가 탭·줄 바꿈·컨트롤·개체를 건너면paragraph-range-crosses-element.본문을 비울 때 머리말·꼬리말도 지운다:
section.clear_body(keep_headers=False). 구역 설정·단·쪽 번호와 빈 줄 하나가 남는다.명령 단추를 읽는다:
doc.fields.buttons(Button.caption). 숨은 설명의 문단은doc.text.iter_paragraphs()에서where="hidden_comment"로 나오고, 글맵시의 글은iter_objects(kinds="textart")의object.attributes["text"]로 읽는다.개체를 옮길 때 겹친 차례를 지킨다:
obj.move_to(paragraph, keep_order=True)는zOrder를 그대로 둔다. 기본은 전처럼 한/글의 오려 붙이기와 같이 맨 위로 올린다(표는 전에도zOrder를 바꾸지 않았다).글자 모양 정의 하나를 제자리에서 고친다:
doc.styles.set_char_property(char_pr_id_ref, letter_spacing=-5, ratio=95, ...)(인자는run.set_format과 같다). 사본을 만들지 않으므로 그 id를 가리키는 모든 런·스타일·문단 번호·글머리표가 함께 바뀐다. 그 id를 쓰는 런이 있는 문단(문단 번호·글머리표가 이 모양이면 번호·글머리표가 있는 문단도)의 줄 배치 캐시를 지우고 그 수를 돌려준다. 스타일에 딸린 모양만 고치려면 전처럼doc.styles.set_style_format(한/글의 스타일 고치기)을 쓴다.메모를 걸 글이 문단에 여러 번 나오면 몇 번째 것에 걸지 고른다:
doc.notes.add_memo(..., match="답", index=1),doc.notes.attach(..., match=, index=)(0부터, 한 런 안에 온전히 든 곳만 센다). 메모 본문의 문단 여러 개는memo.paragraphs[0].insert_after(line)으로 잇는다(add_memo문서에 예).안 쓰게 된 서식 정의를 걷어 낸다:
doc.styles.remove_unused_definitions(kinds=None). 글자·문단 모양, 테두리, 탭 정의 목록 끝에서 아무것도 가리키지 않는 정의를 지우고 지운 id를 돌려준다. 끝에서부터 처음 쓰이는 정의를 만날 때까지만 지우고 첫 정의는 남겨, 남은 id가 바뀌지 않는다. 한/글 저장본은 정의 id가 늘 빈틈없이 이어진다(tests/fixtures/hancom_saved1,257개 모두). 엔진 문서를 한/글이 다시 저장하면 쓰지 않는 정의를 지우고 id를 다시 매긴다(재저장 짝에서 쓰지 않는 문단 모양이 있던 29쌍 중 20쌍).run.set_format으로 시험값 사본을 만들었다가 되돌린 뒤 걷어 내는 쓰임에 맞다.paragraph.iter_paragraphs(where=): 문단 안의 모든 문단(표 칸·칸 안 표·캡션·글상자·묶음·각주·메모)을doc.text.iter_paragraphs()와 같은 걷기로 문서 차례로 내놓는다(문단 자신은 빼고).doc.text.iter_objects()·paragraph.iter_objects()의place.object가paragraph.objects와 같은 모델이다: 그림은item_id가 있는Picture, 수식은script가 있는Equation(둘 다InlineObject를 잇는다). 전에는 둘 다InlineObject였다.run.content의 조각:child_index(런의 몇째hp:t·hp:ctrl에 적혔는지), 머리말·꼬리말 컨트롤 조각의object(머리말·꼬리말 모델), 모든 누름틀 시작의object— 하이퍼링크·메모 밖의 것은 새 값 형식hwpx.objects.FieldControl(field_type·field_id·name·parameters)이고Hyperlink·메모도parameters를 읽는다.paragraph.add_run(text, tab_widths=[...]): 잰 탭 폭을 한/글 저장 꼴(<hp:tab width="N" leader="0" type="1"/>)로 쓴다.tests/fixtures/hancom_saved1,257개의hp:tab11,177개가 모두 이 세 속성을 적는다. 인자가 없으면 전처럼<hp:tab/>이다.
고침
다른 문서에서 가져온 것이 받는 문서의 것과 섞이던 곳(성공을 돌려주고 검사도 통과했다):
문단을 다른 문서로 복사하면(
paragraph.copy_to,append_document) 그림이 받는 문서의 그림으로 바뀌거나 데이터 없이 남았다. 한/글이 저장한 문서는 그림을 매니페스트에만 적는데, 병합은 머리의 목록만 봤다(append_document는 6.x부터). 이제 원본의 그림 데이터를 받는 문서의 새 항목으로 복사한다.변경 추적이 든 내용을 병합하면 표시가 원본의 변경 번호를 그대로 가져 받는 문서의 변경을 가리켰다. 자기 삽입을 거절하면 가져온 문서의 글이 함께 지워졌다. 이제 가져온 변경은 종류·작성자·날짜와 함께 받는 문서의 새 번호를 받는다. 받는 문서가 변경을 보이거나 숨기던 설정은 그대로다.
그림이 아닌 이진 항목(차트의 OLE)은 원본이 적은 종류(
application/ole,isEmbeded) 그대로 옮긴다.데이터가 없는 그림 참조(메모 글 안의 것 포함), 머리에 정의가 없거나 변경 번호가 없는 변경 추적, 글자·문단 모양 변경 추적이 든 원본은 받는 문서를 건드리기 전에 거부한다(
document-merge-unsupported-reference).
변경 추적을 병합할 때, 들어오는 작성자가 받을 번호를 받는 문서의 변경이 이미 적고 있으면(작성자 기록 없이) 받는 문서를 건드리기 전에 거부한다(
document-merge-unsupported-reference). 한/글이 저장한 문서는 하나뿐인 작성자의 id가 0이고 변경의authorID가 1이라, 다음 작성자가 1을 받으면 그 변경들이 새 작성자의 것으로 읽힌다. 같은 이름의 작성자는 그대로 들어온다.tracking.insert(author=)로 새 작성자를 직접 더하는 경우의 같은 문제는 남아 있다.수락하거나 거절한 변경 추적의 번호를 다음에 만든 변경이 받았다. 처리한 변경의 객체로
reject를 부르면 다른 사람의 새 변경이 거절됐다. 이제 문서를 열어 둔 동안 번호를 다시 쓰지 않고, 처리한 변경의 객체는track-change-not-found다.인라인 표시를 가로지르는 글을 변경 추적으로 지우거나 바꾸려 하면(
tracking.delete(match=),tracking.replace) 머리에 변경을 더한 뒤에 코드 없는ValueError로 실패했다. 이제 머리를 건드리기 전에track-match-crosses-markup로 거부한다 (지우기는 그 글이 처음 나오는 런에서, 바꾸기는 그 글을 처음 담은 글 요소에서 가로지르면 거부한다: 쓰는 쪽이 거기서 멈춘다. 바꾸기는 한 런의 글 요소 둘에 나뉜 것을 지나 뒤에 온전히 있는 것을 감싼다).저장한 문서를 같은
seed로 다시 열면(open(..., seed=)) 이미 있는 id를 또 받았다(누름틀 둘이 한 id, 둘 다 id로 채울 수 없음). 이제 연 파일에 있는 id(문단·개체·누름틀·각주의 것)를 피해서 준다.여러 문단에 걸친 누름틀의 한 문단을 그 옆에 복사하면(
paragraph.insert_after()) 시작이 둘, 끝이 하나가 되고 둘 다 끝이 있다고 보고했다. 이제 복사본의 시작은 새 id를 받고(끝 없는 누름틀), 짝 없는 끝은 복사본에 넣지 않는다. 다른 복사 경로 (insert_paragraphs, 다른 문서로의 복사)는 전과 같다: 나눠 가져온 누름틀의 끝은 먼저 온 시작의 것이다.이미 그 각도인 개체에 같은 각도를 주면 자리를 다시 계산해, 한/글이 돌리고 뒤집어 저장한 묶음이 866만큼 내려갔다. 이제 아무것도 하지 않는다.
from hwpx.tools.text_extract_cli import extract_markdown(6.x가 내보내던 이름)이 안내 없는ImportError였다. 이제 새 자리를 알려 준다.문서: 지원 매트릭스가 연결선·차트가 든 문서의 병합을 거부한다고 적고 있었다(7.0은 함께 옮긴다). 커버리지 원장이
hp:startPt·hp:endPt(연결선 끝점, 쓴다)와hp:btn(명령 단추, 읽는다)을 못 한다고 적고 있었다. 이주 가이드에 정책 없이 부른save_report의 대체(save(..., quality=QualityPolicy.transparent()))를, 엔진 계약에 seed 결정성의 조건(메모는 같은 시간대에서)을 적었다.남이 준 파일을 여는 비용(6.6.0부터 있던 것들이다. 작은 파일이 크기와 상관없이 시간이나 메모리를 쓰게 할 수 있었다):
파트를 파싱하기 전의 이름공간 정리가 파트 크기의 제곱에 비례하는 시간을 쓸 수 있었다. 이제 어떤 바이트에도 크기에 비례한다 (실제 문서의 파트 75,236개에서 결과는 전과 같다).
문서 형식 선언(DTD)을 파트의 첫 4 KiB에서만 찾았다. 글 추출·레이아웃 점검이 쓰는 파서는 그 뒤에 온 선언의 엔티티를 풀었다. 이제 선언이 어디에 어떤 인코딩으로 있든
HwpxSecurityError로 거부한다.HWP 5.0 파일의 스트림은 하나씩만 한도가 있고 합계에는 없었다. 이제 한 파일의 스트림이 읽히는 양과 풀리는 양에 합계 한도 (각 512 MiB, HWPX 보관함의 합계 한도와 같다)가 있고, 넘으면
hwp5-limit-exceeded다.표의 칸 병합(
rowSpan·colSpan)과 행·열 수(rowCnt·colCnt)를 적힌 대로 펼쳤다. 이제 한 칸은 65,535, 표 하나는 격자 100만 자리까지이고(실제 표 12,369개 중 가장 큰 것이 812자리), 넘으면table-grid-too-large다.ZIP 암호가 걸린 항목은
RuntimeError, 글이 아닌mimetype은UnicodeDecodeError가 그대로 나왔다. 이제HwpxError다.
보관함이 아닌 바이트를 열면 열에 넷은
UnicodeError가 그대로 나왔다(7.0에서 생긴 문제: 무엇인지 알려 주려고 머리를 읽는 곳). 그림 파일을 올린 경우가 그랬다. 이제 늘HwpxError(open-not-hwpx)다.각주·미주 스타일(
각주·미주)이 없는 문서에add_footnote·add_endnote를 하면 틀의 고정 id(스타일 15, 모양 10·3)를 썼다. 그 id가 없는 문서(시험지 양식 등)에서는 없는 것을 가리켰고, 다른 스타일이 그 번호인 문서에서는 각주 글이 개요 스타일이 됐다. 이제 문서의 첫 스타일(바탕글)과 그 모양을 쓴다.렌더 확인을 요구하는 품질 정책(
QualityPolicy.strict(),QualityPolicy())으로 저장하면 렌더러가 없는 곳에서는 어떤 문서든 거부되는데, 그 오류에 이유가 없었다(Document save failed the quality gate:뒤가 비어 있고errors도 비어 있었다). 이제 오류가 “렌더 확인을 요구하는데 하지 못했다”는 것과 되는 정책(QualityPolicy(require_visual_complete=False), 열림 검사와 참조 검사는 그대로 한다)을 말한다. README와 사용 가이드가 참조 검사용으로 권하던 호출도 이 정책으로 바꿨다.머리말·꼬리말의 6.x 이름
apply_page_type에 값을 넣으면 오류 없이 받아 두고 아무것도 쓰지 않았다(읽을 때만 새 이름을 알려 줬다). 이제 쓸 때도page_type을 알려 주는 오류가 난다.doc.fields.fill(None, ...)이 누름틀에 글자None을 썼다. 이제HwpxTypeError로 거부한다(비우려면"").글 추출의 형광펜 표시(
AnnotationOptions(highlight="markers"))가 런 둘에 걸친 형광펜에서 시작 하나에 끝을 둘 냈다 (앞부[HIGHLIGHT …]분글자[/HIGHLIGHT]굵은부[/HIGHLIGHT]분글자). 이제 시작과 끝이 하나씩이다.“python-hwpx-automation으로 옮겼다”는 오류와 문서의 설치 명령이
pip install python-hwpx-automation이었다. 7.x가 깔린 환경에서 이 명령은 그 7.x를 그대로 두고 python-hwpx를 6.x로 되돌린다. 이제pip install -U "python-hwpx-automation>=8"이다.문서: 이주 가이드에
paragraph.footnotes가 표 칸 안 각주를 더는 돌려주지 않는다는 것을, README에 커서가 없는 문단을 가리키는 문서는 고치지 않은 저장에서도settings.xml이 달라진다는 것을 적었다.doc.tables.map()의 표 번호가doc.tables.with_nested의 번호라는 것(칸 안에 표가 있는 양식에서doc.tables[i]와 다르다)을 README와 사용 가이드에 적었다. 사용 가이드의 가로 용지 예제는 mm 값을 HWPUNIT 자리에 넣어 741×1048 mm 쪽을 만들었고, 구역 메모 예제는 저장되지 않는 문서를 남겼다. 첫 문단·첫 런을 지우면 용지가 0×0이 된다는 경고 세 곳은 7.0의 동작 (첫 런 지우기는 거부, 첫 문단을 지우면 구역 설정이 다음 문단으로 옮겨 간다)으로 고쳤다.llms.txt는 7.0에서 없어진 이름이 아직 된다고 적고 있었다. 비교 문서의 문서 객체 멤버 수는 잰 값(35)으로 고쳤다.docs/stable-api.md에 7.0이 예고 없이 지운 이름이 있다는 것을 적었다. README의 문서 링크는 PyPI 페이지에서도 열리게 전체 주소로 바꿨다.릴리스: GitHub 릴리스 본문(이 절 전체)이 한도 125,000에 120바이트 남아 있었고, 그 단계는 PyPI 업로드 뒤에 돈다. 본문이 110,000바이트를 넘으면 줄 끝에서 자르고 전체 변경 내역의 주소를 붙인다.
다른 구역으로 옮긴 뒤 옮기기 전에 얻어 둔 책갈피·체크 상자·라디오 단추·콤보 상자·입력 상자·이름 붙은 글상자로 고친 것이 저장되지 않았다(옮긴 뒤 문서를 한 번 쓴 다음부터). 문단·런·표·개체·각주는 이미 옮겨 간 구역을 따랐지만 이 여섯은 옛 구역만 바뀐 것으로 표시했다. 책갈피는 표 칸·글상자·각주 안에 있을 때도 같았다. 이제
bookmark.rename·remove,checked,text·value대입이 지금 담긴 구역을 표시하고,check_box.section도 그 구역이다. 글 범위째 옮긴(move_range) 하이퍼링크도 옮겨 간 문단을 따른다(link.url =,link.paragraph).책갈피 이름 바꾸기(
rename)의 세 가지: 바탕쪽에 있는 책갈피는 이름이 저장되지 않고 본문의 링크만 새 이름을 가리켰다. 같은 책갈피를 가리키는 객체 둘로 차례로 바꾸면 둘째가 링크를 찾지 못했다(객체가 얻을 때의 이름으로 찾았다). 시작과 끝이 다른 문단에 있는 책갈피는 시작 문단만 다른 구역으로 옮긴 뒤 지우면(remove) 끝 표시가 남았다. 떼어 낸 사본의 책갈피를 지워도 문서에 남은 같은 id의 책갈피는 그대로다.문서에서 떼어 낸 책갈피의 이름을 바꾸면(
rename) 문서에 남은 하이퍼링크(#옛이름)가 새 이름을 가리키게 바뀌었고, 지운 문단에 있던 라디오 단추를 켜면(checked = True) 문서에 남은 같은 묶음의 단추가 꺼졌다. 떼어 낸 것은 자기 이름·값만 바뀌고 문서는 그대로다(떼어 낸 체크 상자·입력 상자의 값을 바꿔도 구역을 바뀐 것으로 표시하지 않는다).doc.styles.apply_paragraph_format을 거부할 때 머리에 탭 정의나 테두리 정의가 남았다. 탭 정의를 쓴 뒤에 정렬과 테두리를 검사했기 때문이다(tab_stops=와 잘못된border=·alignment=를 함께 준 경우). 이제 정렬·테두리를 먼저 검사해, 거부한 호출은 문서를 바이트까지 그대로 둔다. 서식 API 열네 개에 인자마다 잘못된 값을 넣어 확인했고, 남기던 것은 이 하나였다. 탭 정의 목록 (hh:tabProperties)이 없는 머리에서는 잘못된 탭을 거부하면서 빈 목록을 남겼는데(ensure_tab_definition도), 이제 남기지 않는다.doc.save(stream, format="hwp")가 스트림이 일부만 받아도(예: 10,752바이트 가운데 64바이트) 저장한 것으로 보고했다..hwpx스트림 저장처럼 쓴 바이트 수를 확인하고, 모자라면OSError를 내며 스트림을 쓰기 전 모습으로 되돌린다. 되돌릴 때도 스트림이 옛 내용을 나눠 받으면 끝까지 쓴다(.hwpx포함). 고치지 않은 문서를.hwp로 저장한 보고가whole_package_identical을 참으로 하던 것도 고쳤다(쓴 파일은 HWP 5.0이고 원본과 같은 바이트가 아니다).각주·미주의 저장된 번호가 문서가 세는 번호와 달라지던 나머지 길: 번호 새로 매김(
add_number_restart)만 든 문단을 옮기거나 복사할 때,insert_rows·insert_columns(copy_content=True)로 각주가 든 칸을 복사할 때(1·1), 각주나 번호 새로 매김이 든 문단· 런·표·글상자를 지울 때(remove), 각주가 든 행·열을 지울 때(delete_rows·delete_columns). 이제 이 길들도 문서 차례로 번호를 다시 쓴다. 각주 안 번호 표시(hp:autoNum)에num이 없으면 1로 읽고(스키마 기본값), 번호가 1이 아니면 적는다.누름틀 안내문(
prompt,Direction)이나 메모(memo,HelpState)에 탭·줄바꿈을 주면 만들 때(add_form_field)는 탭을 말없이 지웠고 나중에 바꿀 때(field.prompt =)는 그대로 썼다. 한/글 저장본 시험의 누름틀 안내문 35개에는 탭·줄바꿈이 든 것이 없어 한/글이 어떤 꼴로 쓰는지 근거가 없다. 이제 두 길 모두 아무것도 쓰기 전에field-text-control-unsupported로 거부한다(새 코드).글 범위를 복사(
copy_range)하면 범위와 그 안의 각주·글상자에 든 개체의 사본이 원본의 겹침 순서(zOrder)를 그대로 가져가 한 층에 개체 둘이 놓였다. 이제note.copy_to·shape.copy_to처럼 사본마다 놓인 차례대로 다른 개체들 위의 새 순서를 받는다.각주·미주가 든 것을 통째로 복제하거나 옮기면 저장된 번호가 겹치거나(1·2·1) 거꾸로(2·1) 남았다: 문단
copy_to·insert_after()·insert_before()·move_after·move_before,section.insert_paragraphs·doc.insert_paragraphs, 문서 끼워 넣기(insert_document·append_document), 다른 문서로 문단 복사, 표copy_to·copy_after·move_to,copy_rows·move_rows, 도형copy_to·move_to. 이제 이 길들도note.copy_to·copy_range처럼 문서 차례로 번호를 다시 쓴다(쪽마다 새로 매기는 구역이 있으면 전처럼 두는 것까지 같은 규칙).떠 있는 표가 든 글 범위를 표 칸·글상자·각주로 복사·이동(
copy_range·move_range)하면 성공하고 칸 안 표가 쪽 기준(PAGE· PAPER) 그대로 저장되었다. 같은 표를 같은 칸으로 보내는table.copy_to·move_to는shape-move-place-unsupported로 거부한다. 이제 범위의 표도 같은 판단을 거쳐, 한/글 문서가 칸·글상자·각주에 두지 않는 배치(문단 기준이 아니거나 쪽 영역 안에 두지 않은 떠 있는 표)면 아무것도 쓰기 전에 같은 코드로 거부한다. 한/글이 붙여 넣는 배치를 확인한 것은 도형·그림이고 표는 아니어서, 표는 배치를 바꿔 넣지 않는다.표·글상자·각주나 문단을 다른 구역으로 옮긴 뒤, 옮기기 전에 얻어 둔 객체(칸·캡션·글상자·각주의 문단, 런, 표, 개체, 캡션, 글상자 글, 누름틀에 든 메모)로 고친 것이 저장되지 않았다. 고치는 호출은 성공했고 메모리에서는 바뀌었지만, 객체가 옛 구역을 기억하고 있어 그 구역만 바뀐 것으로 표시했다. 이제
paragraph.section은 그 문단을 지금 담은 구역이고, 런·표·개체·각주의paragraph는 그것을 지금 담은 문단이다(옮겨 간 곳). 떼어 낸 객체는 전처럼 떼어 낸 구역을 가리킨다.저장이 연 파일에 든 것을 말없이 잃거나 잘못 세던 것을 고쳤다(6.12에도 있던 것 포함).
이름이 같은 ZIP 항목이 둘 이상인 파일(한/글은 쓰지 않는다)을 고치지 않고 저장해도 앞 항목의 내용이 뒤 항목의 내용으로 바뀌었다. 이제 열기는 되지만(읽는 것은 각 이름의 마지막 항목) 열 때
UserWarning으로, 패키지 검사(validate_package,hwpx-validate-package)는 경고로,hwpx-text-extract·hwpx-unpack·hwpx-repair는 표준 오류·출력 한 줄로 어느 이름이 몇 번 나오는지 알린다. 저장(doc.save·to_bytes)은 아무것도 쓰기 전에HwpxPackageError(save-duplicate-entry-names)로 거부한다.hwpx-repair는 모든 항목을 그대로 두고 고치지 못했다고 말한다.더 긴 문서가 들어 있던 스트림에 짧은 문서를 저장하면 끝에 옛 데이터가 남아 다시 열 수 없었다. 이제 문서 끝에서 자르고, 쓴 뒤 스트림이 그 문서를 담는지 다시 읽어 본다. 자를 수 없는 스트림은 옛 내용으로 되돌리고 거부한다.
ZIP64나 첫 기록 앞에 바이트가 붙은 ZIP처럼 기록째 옮길 수 없어 다시 압축한 저장에서, 보존 보고(
report.preservation)가 ZIP 정보 몇 칸이 같으면 로컬 기록을 “검증”으로 셌다. 이제 바이트로 견준 기록만 센다. 이 길에서 사라지던 아카이브 주석은 그대로 쓰고,zipRecordsRewritten의 사유는 실제 꼴(zip64,bytes-before-first-entry등)로 적는다.고치지 않은 저장이 ZIP의 디렉터리 항목(
BinData/등)을 지웠고, 중앙 디렉터리 차례와 다르게 놓인 기록을 중앙 차례로 다시 늘어놓았다. 이제 디렉터리 항목을 그 자리에 두고, 기록은 원본의 물리 차례대로(새 항목은 뒤에) 쓴다. 중앙 디렉터리는 원본 차례다.저장이
mimetype을 늘 맨 앞에 압축 없이 다시 써,mimetype이 맨 앞이 아니거나 압축된 파일은 고치지 않은 저장도 파일째 같지 않았고 보존 보고는 그것을 말하지 않았다. 이제mimetype도 적힌 자리·꼴 그대로 옮긴다(표준 꼴로 고치는 것은hwpx-repair). 새 문서는 전처럼 맨 앞에 압축 없이 쓴다. 한/글 저장본 시험 1,265개가 모두 파일째 같다(전에는 1,259). 공개 표본 1,442개로는 열고 저장되는 문서 가운데 파일째 같은 것이 1,420에서 1,436(모두)이 됐다.바이트 패치(
replace_package_text·paragraph_patch·rewrite_package_parts, 이것들 위의fill_cells·apply_table_ops·apply_body_ops·strip_runs_by_color등)는 이름이 같은 ZIP 항목이 둘 이상인 파일에서 한쪽 항목의 글을 바꾸면서 다른 항목의 내용을 덮어쓰고도 성공을 보고했다. 이제 문서 저장과 같은HwpxPackageError(save-duplicate-entry-names)로, 출력 파일을 만들기 전에 거부한다(있던 출력 파일은 그대로).ZIP64나 첫 기록 앞에 바이트가 붙은 ZIP처럼 기록째 옮길 수 없어 모든 항목을 다시 압축하는 저장과 패치에서,
mimetype을 맨 앞에 압축 없이 옮기고 기록을 중앙 디렉터리 차례로 늘어놓았다. 이제 이 길에서도 중앙 디렉터리 차례·기록의 물리 차례·mimetype의 자리와 압축을 읽은 그대로 쓴다(바이트는 다시 압축한 것이고 보존 보고의zipRecordsRewritten이 그렇다고 말한다).이 길을 타는 패치(
paragraph_patch·replace_package_text)와 공개rewrite_package_parts(일반 ZIP 포함)가 아카이브 주석을 지웠다. 이제 주석을 그대로 쓴다.replace_package_text는 글이 바뀐 파트의 줄 배치 캐시(hp:linesegarray)를 모두 지워, 바깥 문단만 고쳐도 건드리지 않은 표 칸 문단의 캐시까지 사라졌다. 이제 글이 바뀐 문단 자신의 캐시만 지운다(글은 그것을 둘러싼 가장 안쪽 문단의 것이다).paragraph_patch로 표를 품은 문단의 글을 바꾸면 표 칸 문단의 글까지 지우고(original_text에도 칸 글이 섞였다) 칸 문단의 캐시를 지우면서, 정작 글이 바뀐 바깥 문단의 캐시는 남겼다(한/글이 옛 줄 배치에 새 글을 겹쳐 그릴 수 있다). 이제 그 문단 자신의 글과 캐시만 바꾸고, 안에 든 칸 문단은 바이트 그대로 둔다.다시 읽을 수 없는 스트림(쓰기만 되는 스트림)에 저장하면 쓴 내용을 확인하지 못했는데도 보존 보고가
whole_package_identical=True였다. 이제whole_package_identical=False,output_read_back=False(to_dict()에는"outputReadBack": false)로 확인하지 못했다고 말한다. 다시 읽을 수 있는 스트림과 경로 저장은 전과 같다.
doc.parts.clear_document_authors()가 같은 이름의 칸(creator·lastsaveby)이 둘이면 첫 칸만 비워 저장에 이름이 남았고, 칸 차례가 바뀌어도 늘("creator", "lastsaveby")를 돌려주었다. 이제 모두 비우고 값이 있던 칸마다 이름을 문서 차례로 돌려준다.set_document_metadata도 같은 키의 칸 모두에 쓴다.set_document_metadata의 제목·설명 등에 쓴 CR·CRLF가 다시 열면 LF가 되던 것(문서 정보만 바이트째 고치는 길)을 고쳤다.엔진이 새로 쓰는 요소의 속성 차례를 한/글 저장본(
tests/fixtures/hancom_saved)에서 가장 흔한 차례에 맞췄다. 뜻은 같고 바이트만 바뀐다.대상:
새
hp:p(표 칸·각주·미주·머리말·꼬리말·쪽 번호·표 행/열 더하기·copy_after·변경 추적 끼움)는id를 맨 앞에 둔다.새
hh:charPr·hh:paraPr도id를 맨 앞에 둔다.개체(
hp:rect·hp:ellipse·hp:line·hp:arc·hp:pic)는 공통 속성(id·zOrder…instid)을 앞에, 종류별 속성을 뒤에 둔다.hp:sz는width·widthRelTo·height·heightRelTo·protect차례다.hp:drawText는lastWidth·name·editable차례다.떠 있는 개체(
treat_as_char=False)의hp:pos는vertRelTo·horzRelTo·vertAlign·horzAlign차례다(전에는vertAlign이horzRelTo앞).병합을 나눠 새로 만든 칸의
hp:cellAddr·hp:cellSpan은colAddr·rowAddr,colSpan·rowSpan차례다. 새 스타일(ensure_style)과 있던 스타일에 더한 속성도 한/글의hh:style차례(nextStyleIDRef뒤langID)에 둔다.
파일에서 읽은 요소의 차례는 건드리지 않는다.
한/글 저장본에 없는 요소(선택 상자·변경 추적 정의·바탕쪽)는 전 차례 그대로다.
새로 만든 개체의
zOrder가 모두 0이던 것을 고쳤다.add_rectangle·add_picture·add_equation·add_chart·add_table(칸 안 표 포함)·add_container·add_line·add_connector등으로 만든 개체는 한/글처럼 문서의 지금 최댓값 + 1을 받아, 나중에 만든 것이 위에 그려진다.근거:
tests/fixtures/hancom_saved에서 개체를 한/글이 만든 문서는 만든 차례대로 번호를 매긴다. 글자처럼 놓인 표도 센다(memos_in_fields: 표 0, 타원 1).묶음 구성원은 0이다(구성원이 있는 77개 문서 모두).
뒤 구역은 앞 구역 번호를 잇는다(hwpxlib_corpus
error__20251107__test: 0-4, 그다음 5-30).
한/글은 다시 저장할 때
zOrder를 고치지 않으므로, 6.x·7.0 개발 중에 만든 문서의 0은 그대로 남는다.붙여 넣은 개체(
copy_to, 표의copy_to·copy_after포함)도 문서 전체의 맨 위로 간다. 전에는 구역 안 맨 위였고, 표 사본은 원본 번호 그대로였다.옮기기(
move_to)는 전처럼 개체는 맨 위, 표는 그대로다.
obj.move_to·copy_to(표의 것도)가 개체를 마지막 런의 빈hp:t뒤가 아니라 앞에 넣는다(<hp:run><hp:rect/><hp:t/></hp:run>). 빈 문단으로 옮길 때 7.0 개발 중에는 한/글 저장본에 없는 꼴([t/][개체])을 썼다. 한/글 저장본(tests/fixtures/hancom_saved)에서 개체와 빈hp:t만 든 런 4,676개 가운데 4,675개가 빈hp:t로 끝난다.구역 설정(
hp:secPr)이 구역 첫 문단이 아닌 뒤 문단에 있는 문서를 막는다. 한/글 2024는 첫 문단에서만 구역 설정을 읽어, 그런 구역을 기본 용지·여백으로 열고 다시 저장할 때 첫 문단에 기본hp:secPr를 새로 쓴다(여백·단이 사라지고 쪽 수가 바뀐다).열기 안전 검사와
validate_package가 이 꼴을 오류(section-properties-not-first)로 잡고, 저장은HwpxValueError(section-properties-not-first)로 거부한다. tests/fixtures·rhwp·kordoc 표본·한/글 2024 변환본 250개 등 1,635개 파일에서 이 꼴은 0개였다.hwpx-repair(repair_repack)가 구역 설정과 그 문단의 쪽 단위 컨트롤(단·머리말·꼬리말·쪽 번호)을 첫 문단 앞으로 옮겨 고친다.section.insert_paragraphs(0, ...)(doc.oxml.insert_paragraphs도)가 구역 맨 앞에 넣을 때 구역 설정을 옛 첫 문단에 남겨 이 꼴을 만들던 것을 고쳤다. 이제 첫 사본이 구역 설정을 넘겨받고, 넣는 사본은 구역 설정 없이 들어간다 (paragraph.insert_after()사본과 같다). 앞에 넣기·옮기기·지우기·표와 개체 옮기기·구역 넣고 지우기·문서 끼워 넣기의 다른 공개 길은 이미 첫 문단에 두고 있었다(시험으로 고정).
paragraph.column_break = True도page_break처럼 그 문단의 줄 배치 캐시를 지운다. 전에는 단이 바뀌어 줄의 세로 자리가 달라지는데도 옛 줄 배치를 남겼다.메모를 한/글 2024 저장본처럼 MEMO 누름틀의
hp:subList에만 쓴다. 6.x는hp:memogroup에도 사본을 써서, 한/글이 다시 저장할 때 그 사본을 버렸고(누름틀의 글은 남는다) 메모를 고치면 두 사본이 어긋났다.doc.notes.add_memo(..., paragraph=)·doc.notes.attach가 메모를 누름틀로 옮기고, 같은 객체가 그 누름틀의 메모가 된다. 문단·표·글상자를 복사하거나 다른 구역으로 옮기거나 문서를 이어 붙여도(append_document)hp:memogroup을 새로 쓰지 않는다. 문단에 걸지 않은 채 남은 새 메모는 저장을HwpxValueError(note-memo-unanchored)로 거부한다. 6.x 문서는 그대로 읽히고, 그 메모를 고치면 그 메모만 누름틀로 옮기고hp:memogroup사본을 지운다(고치지 않은 저장은 그대로).메모 모양을 한/글처럼 구역마다 둔다:
doc.notes.set_memo_shape(shape_id, section=i)가hp:secPr@memoShapeIDRef를 쓰고 (section="all"은 모든 구역, 헤더에 없는 id는note-memo-shape-not-found),doc.sections[i].properties.memo_shape_id_ref로 읽는다. MEMO 누름틀에는 한/글처럼 늘MemoShapeIDRef=65535를 쓴다. 6.x의 메모마다 모양(add_memo(memo_shape_id_ref=),memo.memo_shape_id_ref)은 없어졌고 새 자리를 알려 주는 오류를 낸다. 6.x 문서가 누름틀에 적은 id는 그대로 읽힌다.MEMO 누름틀의 매개변수를 한/글 2024 저장본과 같은 일곱 개(
Prop·Command·ID·Number·Author·MemoShapeIDRef·CreateDateTime)로 같은 순서에 쓴다.ID는memo<번호>,CreateDateTime은 한/글처럼 그 컴퓨터의 시각,Command의 FILETIME은 같은 순간의 UTC다. 6.x의 다섯 개 꼴도 그대로 읽는다.doc.parts.add_master_page(...)로 만들고 어느 구역에도 잇지 않은 바탕쪽은 저장을HwpxValueError(master-page-unlinked)로 거부한다. 전에는 잇지 않은 파트를 그대로 써서, 한/글 2024가 다시 저장할 때 바탕쪽과 그 글이 사라졌다. 만든 뒤doc.page.set_master_page(mp, section=0)로 잇거나add_master_page(..., section=0)으로 만든다. 읽어 온 바탕쪽은 그대로 둔다.doc.text.iter_paragraphs()가 MEMO 누름틀에만 있는 메모(한/글 2024가 저장하는 모양)의 글을where="memo"로 내놓지 않아, 한/글로 다시 저장한 문서에서 메모 글이 빠진 것처럼 보이던 문제를 고쳤다.열기 안전 검사가 저장을 거부할 때
to_bytes()·save()가 code 없는HwpxPackageError를 내던 문제를 고쳤다. 이제 엔진 계약대로code="open-safety-failed"·suggestion을 싣는다.HwpxPackageError·HwpxStructureError계열(HwpxArchiveError등)과HwpxSecurityError도HwpxError를 상속해 늘 code를 낸다(package-invalid·open-input-unsafe등). 앞에서 잡던 형식으로도 그대로 잡힌다.HwpxXmlSyntaxError.code는 이제 이 code이고 lxml의 숫자는lxml_code에 있다.한 번도 글을 넣지 않은 칸(한/글이 런 없는
<hp:p/>로 저장한 칸) 옆에insert_rows·insert_columns로 빈 행·열을 넣거나 그 칸을split_cell로 나누면XMLSyntaxError가 나던 문제를 고쳤다.아주 큰 표가 든 문서에서 행 넣기와 저장이 표 크기의 제곱으로 느려지던 문제를 고쳤다. 글자 모양 캐시가 매번 머리 전체를 다시 읽었고(표의 쪽 높이 어림이 칸마다 글자 모양을 찾는다), 구역을 쓸 때 모든 자식을 새 뿌리로 옮겼다. 결과 바이트는 같다.
글머리표를 처음 만드는 문서(
doc.styles.apply_list_format(kind="bullet"),doc.styles.ensure_bullet())가hh:bullets를 머리의 맨 뒤에 두어doc.validate()의 스키마 검사에 걸리던 문제를 고쳤다. 이제 한/글 저장본과 스키마처럼hh:numberings바로 뒤에 둔다(새로 만드는hh:styles·hh:trackChanges·hh:trackChangeAuthors도 같은 차례를 따른다).한/글 2024가 저장한 날짜 코드(
SUMMERY)나 교정 부호(덧붙임 줄·덧붙임·잘라냄)가 든 문서를 고치지 않고 저장해도 “한/글이 열기를 거부한다”며 막던 것을 고쳤다. 문서를 이어 붙일 때도 이 필드의fieldid를 한/글이 쓰는 제어 id로 둔다.doc.styles.char_property(id)·char_properties·run.size등이 XML(.element)로 더하거나 고친 글자 모양을 저장 전까지 못 보던 문제를 고쳤다. 이제 읽을 때마다 머리의 현재 상태를 본다(invalidate_char_property_cache()를 부를 필요가 없다).위 고침 뒤로
doc.styles.char_properties가 읽을 때마다 모든 글자 모양을 다시 견주어, 문단마다 부르는 쓰임(자동화의 rich Markdown·ingest)이 글자 모양 수 × 문단 수로 느려지던 것을 고쳤다(글자 모양 405개 문서에서 2,000번 읽고 하나 찾기 17.4초 → 0.09초). 이제 읽기는 답하는 정의 하나만 견준다: 그 요소가 아직 머리의 목록에 있는지, 속성과 자식(자식의 속성·비었는지)이 읽었을 때와 같은지, 글꼴 이름을 읽은hh:font가 같은 블록에 같은 id·이름으로 있는지. 목록에 없는 id는 목록의 id를 한 번 훑어 찾으므로 더하거나 제자리에서 id를 바꾼 정의도 보인다. 보지 못하는 것은 하나뿐이다: 이미 있는 id를 다른 정의에 하나 더 준 경우(한 id에 정의 둘 — 한/글은 이렇게 쓰지 않는다)는 처음 찾은 정의가 바뀌기 전까지 그것으로 답한다.문단 모양·스타일·탭 정의·테두리/배경·글머리표·변경 추적(과 작성자) 하나를 id로 찾을 때마다 그 목록 전체를 훑거나 다시 읽던 것을 고쳤다(
doc.styles.paragraph_property(id)·tab_property(id)·border_fill(id)·bullet(id),doc.oxml.style(id)등과 문단의 개요 수준 읽기). 머리는 id → 요소 색인을 두고, 찾은 요소가 아직 그 목록에 그 id로 있는지 견준 뒤 그 정의 하나만 읽는다(정의마다 XML이 같으면 읽은 값을 다시 쓴다). 위와 같이 XML로 고친 것도 보인다. 13 MB 견본의 rich Markdown 변환(자동화)이 900초를 넘던 것이 약 5초다. 목록 전체를 돌려주는 읽기(paragraph_properties등)는 전처럼 목록 크기만큼 든다.table.set_treat_as_char()가 표를 품은 문단의 줄 배치 캐시를 지우지 않아, 한/글이 옛 줄 높이로 글을 겹쳐 그릴 수 있던 문제를 고쳤다.표 칸의 크기·병합 값을 읽기만 해도 문서가 바뀌던 문제를 고쳤다.
TableCell.span·width·height가 없는 요소를 새로 만들어 저장하면 문서가 달라졌고, lxml로 연 문서에서는TypeError가 났다.선이 굵은 칸에 색을 칠하면 같은 색의 다른 테두리 정의를 가져와 칸의 선이 바뀌거나 사라지던 문제를 고쳤다.
표 칸 안에 떠 있게 만든 그림이 한/글에서 표 밖에 그려지고 표를 밀어내던 문제(6.x부터)를 고쳤다.
묶음 안에 만든 묶음과, 작성자가 둘 이상인 변경 추적이 저장할 때 스키마 경고를 내던 문제를 고쳤다.
paragraph.footnotes가 표 칸 안 각주를 두 번 세던 문제를 고쳤다.돌린 개체의 숫자가 한/글이 쓰는 값과 한 단위쯤 어긋나던 문제를 고쳤다. 한/글처럼 cos·sin을 소수 여섯 자리로 계산하고 상자를 옮기는 양(
transMatrix)을 정수로 쓴다. 14400×7200 사각형을 30° 돌리면 한/글처럼 상자가 16071×13435가 아니라 16070×13436이다.doc.text.iter_paragraphs()·iter_objects()가 표 캡션 안의 문단과 표를 본문·표 칸의 것으로 표시하던 문제를 고쳤다. 이제where="caption"이고,where="body"는doc.paragraphs와 같다.메모가 걸린 문단이나 표를
insert_after()·copy_after()로 복사하면 사본과 원본이 한 메모를 같은 번호로 가리키던 문제를 고쳤다.도형 크기를 바꿔도 그 문단의 옛 줄 배치 캐시가 남던 문제를 고쳤다.
.element로 문단을 고친 뒤paragraph.clear_layout_cache()를 불러도, 지울 캐시가 없으면 고친 것이 저장되지 않던 문제를 고쳤다.add_paragraph등에 옛 인자(section_index=0)를 주면 XML 속성으로 몰래 써지던 문제를 고쳤다. 이제HwpxTypeError(hwpx-argument-removed)다.doc.fields.add·add_check_box에paragraph=0처럼 번호를 주면AttributeError가 나던 문제, 문단·런의 글을 잘못된 타입으로 주면 옛 글이 지워진 채 실패하던 문제,typing.get_type_hints가 묶음 메서드에서NameError를 내던 문제를 고쳤다.새 차례를 한/글이 열면서 다시 만들 때 부르지 않은 표·그림·수식 차례까지 생기던 문제를 고쳤다(#735). 새 차례는 제목 차례만 만든다(
ContentsMake17, 한/글 2024에서 값을 바꿔 열어 확인)..hwp를 열어 HWPX로 저장할 때 글자 모양 변경 추적이 든 문서에서 변경 추적 정의가 통째로 빠져, 한/글이 지운 글까지 보통 글로 그리던 문제(6쪽 문서가 15쪽)를 고쳤다. 그림·표 같은 개체 바로 앞에서 시작하는 삭제 표시가 한/글이 읽지 않는 자리에 들어가 지운 그림이 다른 쪽에 나타나던 문제도 고쳤다..hwp에서 연 문서의 쪽 테두리·글자 모양·문단 모양·표 칸이 테두리/배경 “없음”을 없는 id(0)로 가리키던 문제를 고쳤다(공개 표본 250개 중 117개). 한/글처럼 아무것도 그리지 않는 테두리/배경을 더해 가리킨다. 한 구역 스트림에 구역 정의가 여럿 든.hwp(한/글이 쓰지 않은 파일)는 구역별로 나눠 연다.LaTeX에서 net, initial, In처럼 한/글 예약어로 시작하는 이름을 쓰면 한/글이 F≠t, ∈₂O₃처럼 다른 기호로 그리던 문제를 고쳤다.
한/글 수식을 LaTeX로 읽을 때 root3를 빈 세제곱근으로, a over b^2를 (a/b)²로 읽던 문제를 고쳤다. rarrow, ANGLE, CDOT, INF, pile, 붙여 쓴 sinx·1 overa 같은 한/글 낱말도 이제 LaTeX로 바뀐다. 공개 문서 5.5만 개 수식에서 이상한 LaTeX가 2,978개에서 8개로 줄었다.
\text{ 또는 }의 앞뒤 공백이 사라지던 문제와, 따옴표 글의 %·_·}가 LaTeX를 깨던 문제를 고쳤다.\frac{1},\sqrt{},x^^2처럼 틀린 LaTeX를 받아 한/글에서 깨진 수식을 만들던 문제를 고쳤다. 이제 거부한다. LaTeX 원문이나 짝이 안 맞는 중괄호를 수식 스크립트로 저장하는 것도 막았다.\mathrm{H_2O}·\mathrm{m/s^2}처럼 첨자가 든 곧은 글자 묶음이H _ 2 O라는 글자 그대로 찍히던 문제를 고쳤다. 이제 곧은 글자의 수식으로 바꾼다.\text{...}안의^·_는 거부한다.\mathrm{km/h}가km / h로 벌어지던 것도 원문 띄어쓰기를 따른다.수식 상자 폭이 좁아 한/글(Windows)에서 수식 뒤 글자가 수식과 겹치던 문제를 고쳤다. 한/글 2024가 실제로 필요로 한 폭 1,800건 (
tests/data/equation_windows_needed_widths.json)에 맞춰 폭 표를 다시 만들었고, 수식 219개를 두 글꼴로 10~13pt에서 열었을 때 뒤 글자에 닿는 것이 없었다. 맥 한/글이 저장한 상자보다 폭이 평균 10% 넓다.구역의 첫 문단을 지우면 쪽 설정이 사라져 저장이 실패하던 문제를 고쳤다. 설정은 다음 문단으로 옮겨 간다.
doc.paragraphs[0]을 먼저 잡아 둔 뒤 첫 문단을 더하면 그 객체에 쓴 글이 사라지던 문제를 고쳤다.한/글이 만든 문서에서 머리말·꼬리말·쪽 번호를 설정하면 하나가 더 생기던 문제를 고쳤다. 쪽 번호와 꼬리말 문구가 서로를 지우면 경고한다.
정렬을 준 머리말·꼬리말과 쪽 번호(
doc.page.set_page_number,set_header/set_footer의align)가 본문 문단의 테두리·간격을 물려받아 쪽 번호 밑에 줄이 그어지던 문제를 고쳤다. 이제 기본 문단 모양에 정렬만 바꾼 모양을 쓴다.XML을 직접 고친 표에 행·열 삽입·삭제나 칸 나누기를 하면 옛 줄 배치 정보가 남아 한/글에서 글자가 겹치던 문제를 고쳤다.
표 칸 하나를 지워 격자에 구멍을 내던
cell.remove()를 막았다. 그림이 아닌 데이터나 모르는 형식 이름을 그림으로 넣는 것, 다른 문서의 문단을 넘겨 그 문서가 조용히 바뀌는 것도 막았다.fields.fill(name="없는이름")의 오류가 “form field index not found: None” 대신 준 이름과 문서에 있는 누름틀 이름을 말한다.명령줄 도구가 없는 파일, 폴더,
.hwp에 traceback 대신 한 줄 오류와 실패 종료 코드를 낸다.hwpx-validate는.hwp를 변환본으로 검사했다고 밝히고, 도움말의 스키마 폴더 설명을 실제와 맞췄다.hwpx-validate-package는 manifest에 version.xml이 없다는 경고를 내지 않는다(한/글이 저장한 문서와 같은 정상 상태).HWP 3.x 이하
.hwp를 열면 “File is not a zip file” 대신 지원하지 않는 형식임을 알린다. 오류 형(HwpxArchiveError)은 전과 같다.META-INF/container.xml이 가리키는 미리보기(Preview/PrvText.txt등)가 패키지에 없는 문서를 열고 저장한다. 전에는HwpxStructureError로 거부했지만 한/글 2024는 이런 문서를 그대로 연다. 본문처럼 미리보기가 아닌 대상이 없으면 전처럼 오류다.사용 가이드와 예제가 새 문서의 첫 문단이나 첫 런을 지우라고 가르쳐, 따라 하면 용지 크기가 0×0인 문서가 저장되던 예제를 고쳤다.
거부한 호출이 문서를 바꾸던 곳을 고쳤다. 태그 전 마지막 검토에서 나온 것과, 공개 메서드 전체에 틀린 값을 넣어 거부될 때마다 문서를 견주는 검사(
tests/test_refused_calls_sweep.py)가 찾은 것이다. 이 검사는 구역·머리·바탕쪽의 XML과 그림 목록을 견주며, 오류 code가 있는 거부 가운데 문서를 바꾸는 것을 더는 찾지 못한다(씨앗 일곱, 호출 약 45만 번).각주·미주를 자기 글 안의 표 칸이나 글상자로 옮기면(
note.move_to) 거부하면서 각주와 그 안의 표가 사라졌다. 바꾸기 전에note-move-into-itself로 거부한다(copy_to로 사본을 넣는 것은 된다).doc.add_picture가 없는 스타일 등으로 거부될 때 그림 파일이BinData/에 남았다(6.x는 스타일을 먼저 찾았다). 문단을 먼저 만들어 검사하고, 그 뒤에 무엇이 거부해도 그림과 빈 문단을 남기지 않는다.doc.shapes·doc.refs·doc.notes·doc.fields의add_*와doc.page.set_columns는 문단을 주지 않으면 구역 끝에 새 문단을 만든 뒤에 넣을 것을 검사했다. 거부하면(add_line(line_color="nope"),add_footnote(123),add_bookmark(offset=5)) 빈 문단이 남았다. 이제 그 호출이 만든 문단은 남지 않는다(호출 중에 다른 것이 바꾼 것은 건드리지 않는다).section=에 다른 문서의 구역을 주면section-not-found로 거부한다. 전에는 받아서 문단은 그 문서에, 그림 파일·스타일·id는 이 문서에 썼다(add_picture는 한 파일에 그림 개체, 다른 파일에 그림 파일을 남겼다).doc.oxml의add_paragraph도 같다.글(
text)이str이 아닐 때의 거부(paragraph-text-invalid-type)가 쓰기 뒤에 났다:note.text = None은 각주 글을 비웠고, 머리말·꼬리말의text대입과doc.page.set_header(text=)는 머리말을 비웠으며,add_footnote·add_endnote·add_memo·add_run·add_paragraph(칸·각주·글상자·캡션·머리말)·add_form_field·add_check_box·set_caption·set_draw_text는 반쯤 만든 것을 남겼다. 모두 쓰기 전에 거부한다. 메모의text = None은 전처럼 빈 글이다.머리말·꼬리말의 내용(
set_content,doc.page.set_header(content=))을 거부하면 앞의 런이 만든 글자 모양이 머리에 남았고, 되돌리면서 문단을 사본으로 바꿔 넣어 전에 얻어 둔 문단 객체로 고친 것이 저장되지 않았다. 내용 전체(항목 종류, 색, 크기, 글꼴, 쪽 번호 형식, 정렬)를 쓰기 전에 검사하고, 되돌릴 때는 있던 요소를 그대로 돌려놓는다. 모르는 항목 종류는story-content-type-unsupported다(ValueError인 것은 같다). 같은 쪽의 머리말이 둘인 구역에서는 거부하면서 둘째 머리말이 사라졌다(쓸 자리를 찾으며 정리한 뒤에 검사했다). 글과 내용을 그보다 먼저 검사한다(글꼴 이름에 XML에 쓸 수 없는 문자가 든 경우는 아직 쓰는 도중에 실패한다).doc.notes.add_memo(..., paragraph_text="새 글", match=..., index=n)은 새 글에 그 자리(n번째match)가 없을 때 문단 글을 바꾼 뒤에 거부했다. 쓰일 글(XML에 쓸 수 없는 제어 문자를 뺀 것, 탭·줄 바꿈·CR에서 끊긴 것)에서 먼저 센다(음수index도 먼저 거부한다).paragraph_text가str이 아니면 메모를 만든 뒤에 거부해, 걸리지 않은 메모가 남아 문서를 저장할 수 없었다. 메모를 만들기 전에 거부한다.doc.page.set_master_page(mp, section="all")이 둘째 구역에서 거부되면(master-page-pages-taken) 첫 구역에는 이미 이어져 있었다. 모든 구역을 먼저 검사한다.doc.page.setup(paper_size="A5", columns=0)은 단 수를 거부하기 전에 용지 크기와 여백을 썼다. 단 수(1~255)와 단 사이를 먼저 검사한다.칸 안의 표(
cell.add_table)는 행·열 수를 거부하기 전에 테두리 정의와 빈 문단을 만들었다. 먼저 검사한다. 새 표의 높이 (height)는 검사하지 않아 숫자가 아니면 테두리 정의를 만든 뒤TypeError가 났다.table-height-value로 먼저 거부한다 (0 이상 2**31 미만의 정수 값만 받아 정수로 쓴다:numpy정수, 값이 정수인Decimal·Fraction·0차원 배열은 받고, 전에 받던2.5·2.0·True·음수는 거부한다).doc.add_table(style="없는 스타일")은 테두리 정의를 만든 뒤에 스타일을 찾았다. 스타일을 먼저 찾는다.doc.refs.add_table_of_contents(index=9999)는 넣을 자리가 없다는 것을 제목 문단에 id를 준 뒤에야 알았고IndexError를 냈다. 구역과 자리를 먼저 검사해toc-place-value로 거부한다.doc.add_heading(..., level=11, style=...)처럼 스타일을 함께 주면 수준을 문단을 넣은 뒤에 검사해, 거부하면서 문단이 남았다. 수준을 먼저 검사한다.값이 XML에 쓸 수 없는 형식일 때(이름 자리에 숫자, 글 자리에 bytes)
add_check_box·add_shape·add_control·add_column_definition·add_composed_character·add_dutmal·add_date_field는 반쯤 만든 런을 문단에 남겼다(컨트롤 없는hp:ctrl은 한/글이 문서를 열지 못하게 한다). 그 호출이 만든 런을 다시 떼고, 문단의 자식과 속성이 그대로이면 지운 줄 캐시도 돌려놓는다.add_run은 속성을 글자 모양을 만들기 전에 검사한다. 같은 경우에 아직 남기는 것이 있는 메서드는 검사의KNOWN_UNTYPED에 있다(형식이 틀린 호출이고, 목록은 줄어들기만 한다).
각주·미주에 적힌 번호(
number와 글 머리의hp:autoNum)가 읽는 번호(note.number)와 달랐다: 각주가 든 문단을 비우거나 (paragraph.clear_content), 각주가 든 글상자의 글을 떼거나 바꾸거나(remove_draw_text,set_draw_text), 캡션을 지우거나 (remove_caption), 머리말·꼬리말의 내용이나 각주의 글을 바꾸거나(set_content,story.text =,note.text =), 번호를 새로 매기거나(add_number_restart의FOOTNOTE·ENDNOTE, 구역의set_footnote_numbering·set_endnote_numbering), 안에 다른 각주가 든 각주를 복사하면(note.copy_to) 남은 각주가 옛 번호를 그대로 가졌다(하나 남은 각주가 파일에는 2). 이제 다시 매긴다. 쪽마다 새로 매기는(ON_PAGE) 구역이 문서에 하나라도 있으면 어느 구역도 다시 매기지 않았는데, 그 구역보다 앞의 구역들은 매긴다. 그 뒤에서도 번호를 새로 시작하는(ON_SECTION) 구역부터는 다시 매긴다(쪽마다 매기는 구역에서 이어 세는 구역 안의add_number_restart는 아직 따르지 않는다). 각주를 지울 때(note.remove) 그 안에 든 다른 종류의 각주, 머리말· 꼬리말을 지우거나(remove_header) 같은 쪽의 머리말이 둘일 때 정리되어 사라지는 머리말 안의 각주, 글을 바꾸거나 지운 메모 안의 각주도 센 데서 뺀다.복사한 각주(
note.copy_to) 안의 누름틀·하이퍼링크와section.insert_paragraphs로 복사한 문단의 누름틀이 원본과 같은 id를 가져, 어느 쪽도 이름이나 id로 채울 수 없었다(field-ambiguous). 복사한 문단·표·글 구간처럼 새 id 쌍을 받는다(시작과 끝이 다 있는 누름틀의 일이다. 새 id는 문서에서 쓰는 어느 누름틀 id와도 겹치지 않는다. 같은seed로 만든 다른 문서의 문단을insert_paragraphs로 받은 문서 객체는 그 누름틀 id를 뒤에 다른 복사(표 행 복사)에 다시 주지 않는다. 저장한 파일을 같은seed로 다시 열면 전처럼 겹칠 수 있다.insert_paragraphs는 그 문서의 구역과 바탕쪽에 이미 있는 id이거나 한 번에 두 번 넣는 id일 때만 새로 주고, 새 id는 함께 넣는 다른 필드의 id와도 겹치지 않는다: 다른 문서에서 가져온 문단은 겹치지 않으면 가지고 온 id 그대로다). 한 문단에서 시작해 다른 문단에서 끝나는 누름틀도 함께 복사한 문단들 안에서 한 쌍으로 새 id를 받고(같은 문단을 한 번에 여러 번 복사해도 사본마다 제 쌍이다), 복사한 각주 안에 걸린 메모는 제 번호(Number와Command안의 번호, 문서의 메모가 쓴 번호보다 큰 것)와 id를 가진 메모가 된다.문서를 합칠 때(
append_document·insert_document) 한 id를 잇달아 두 번 쓴 누름틀(한/글이 저장한 파일에 있다)의 끝 표시가 둘 다 둘째 누름틀을 가리켜, 첫 누름틀은 채울 수 없고 둘째를 채우면 둘 다 바뀌었다. 끝 표시를 앞의 시작과 차례로 짝짓는다. 넣을 자리가 없어(document-merge-index-out-of-range) 거부할 때 원본의 그림과 글자 모양이 대상 문서에 이미 들어가 있었다. 자리를 먼저 검사한다.각주·미주를 바탕쪽의 표 칸이나 글상자로 옮기거나 복사하면 받아들여졌고, 다시 열면 그 각주가 문서의 각주 목록에 없었다.
add_footnote처럼paragraph-move-place-unsupported로 거부한다.덧말(
Ruby)과 글자 겹치기(ComposedCharacter)는 글 범위째 다른 구역으로 옮긴(move_range) 뒤 옮기기 전에 얻어 둔 객체로 고치면(ruby_text =,text =,remove()) 저장되지 않았다. #800·#803이 다른 객체에 한 것처럼 지금 담긴 문단과 구역을 따른다 (ruby.paragraph도 옮겨 간 문단이다).변경 추적을 넣을 때(
doc.tracking.insert·delete·replace) 머리의hh:trackchageConfig@flags에 비트 0을 켜지 않는다. “표시용”으로 켰지만 표시를 정하는 비트가 아니다: 한/글은 56(한/글이 쓰는 값, 변경 내용이 있는 한/글 저장본도 56이고 새 문서도 56), 57, 요소 없음일 때 똑같이 변경 표시를 그리고 0·1·4일 때는 그리지 않는다. 비트 0이 켜진 문서에 새로 만들 차례 (add_table_of_contents의dirty="1")가 함께 있으면 한/글이 여는 중에 죽었다(한/글 12.30.0 macOS에서 재현, 6.x도 같았다). 이제 비트 0은 건드리지 않고, 변경 표시를 숨기는 값(0·1·4 등,flags가 없는 요소 포함)인 문서에서만 표시를 정하는 비트 (2~32)를 한/글이 쓰는 56의 모양으로 맞춘다(그 밖의 비트는 그대로라 1은 57, 4는 56이 된다). 표시되는 값이거나 요소가 없으면 그대로 둔다.hwpx.tools.redline의displayEnabled도 비트 0이 아니라 실제로 표시되는 값인지를 본다 (전에는 표시되지 않는 5도 True였다). Windows 한/글에서는 확인하지 않았고, 비트 0이 무엇인지는 찾지 못했다.머리말·꼬리말 객체는 그 컨트롤이 든 본문 문단을 다른 구역으로 옮긴 뒤 옮기기 전에 얻어 둔 객체로 고치면(
story.text =,add_run,set_content) 저장되지 않았다. 6.x 문서의 메모(hp:memogroup에 든 것)도 걸린 문단을 다른 구역으로 옮긴 뒤 같았다 (옮길 때 메모를 누름틀 안으로 접어 넣고 옛 항목은 떼어 냈는데, 얻어 둔 객체는 떼어 낸 항목을 감싸고 있었다). 둘 다 지금 있는 자리를 따른다. 한 메모를 가리키는 객체가 둘일 때(doc.notes.add_memo가 돌려준 것과doc.notes.memos에서 얻은 것) 한쪽으로 문단에 걸면(attach) 다른 쪽은 옛 글을 읽고, 지워도 메모가 남고, 속성을 고치면 옛 글을 되돌려 썼다. 이제 둘 다 접혀 들어간 누름틀의 메모다(복사copy_to·옮기기move_to도 그 메모로 한다). 지운 메모의 객체는 같은 메모 id나 같은 누름틀 id를 받은 새 메모를 따라가지 않는다. 한 문서 안에서의 일이다: 걸기 전에 얻어 둔 메모의 문단 객체, 지운 메모를 다시 건 경우, 다른 문서를 거쳐 건 메모의 둘째 객체, 6.x 메모와 새로 건 메모가 함께 든 글 구간을 다른 구역으로 옮긴(move_range) 뒤의 둘째 객체로 고친 것은 전처럼 저장되지 않는다.doc.remove_section(n)뒤 남은 구역의 각주·미주가 적힌 번호를 그대로 가졌다(둘째 각주가 파일에는 3). 다시 매긴다.바탕쪽 문단의
add_footnote·add_endnote가AttributeError를 냈다. 한/글 저장본에 바탕쪽의 각주가 없어 쓰기 전에paragraph-move-place-unsupported로 거부한다. 파일에서 읽은 바탕쪽의 표는 행·열을 넣고 지울 수 있다(표를 고친 뒤AttributeError가 났다).같은 묶음의 라디오 단추가 바탕쪽에 있으면 본문의 단추를 켜도 꺼지지 않았다. 묶음을 구역과 바탕쪽에서 함께 찾는다.
스트림 저장이 실패했을 때의 되돌리기: 스트림의 자리가 끝보다 뒤였으면(
b"abc"에서seek(6)) 되돌린 스트림이 원래보다 길었다(b"abc\x00\x00\x00"). 원래 끝을 기억해 거기서 자른다. 되돌리기까지 실패하면 올라오는 오류에stream_restored = False가 붙고(되돌렸으면True), Python 3.11부터는 오류의 노트에도 적힌다. 전에는 알 수 없었다. 되돌린 뒤에는 읽을 수 있는 스트림이면 다시 읽어 원래 내용인지 확인하고서True라고 한다.False인 경우: 다시 읽을 수 없고 되돌리는 쓰기가 얼마나 받았는지도 알려 주지 않았을 때(None), 원래 자리로 돌아가지 못했을 때(확인하려던 읽기가 실패했으면 먼저 원래 자리로 돌아간다), 끝으로seek하지 못하는 스트림이 자리(0이 아닌)에서 아무것도 읽히지 않아 원래 끝을 알 수 없을 때. 실패하며 닫힌 스트림에서는 되돌리기의ValueError가 아니라 원래 오류가 올라온다.
한/글이 하는 것
엔진은 쪽을 배치하지 않는다. 쪽 배치에 달린 값은 짐작해 쓰지 않고, 한/글이 문서를 열거나 다시 저장할 때 정한다.
줄 배치: 글·크기·배치가 바뀐 문단(과 그 문단을 담은 문단)의 줄 배치 캐시를 지운다. 한/글이 열 때 그 문단을 다시 배치한다. 옛 캐시가 남으면 한/글이 글자를 겹쳐 그린다.
쪽마다 새로 매기는 각주(
ON_PAGE)의 번호: 엔진은 각주를 더하거나 지워도 적힌 번호를 다시 쓰지 않고, 새 각주에는 문서 순번을 적는다.note.number는 파일에 적힌 번호다. 한/글 2024는 열 때 쪽마다 번호를 다시 매기고, 저장할 때 쪽별 번호를 적는다(확인함).차례의 쪽 번호:
add_table_of_contents와toc.rebuild()는 쪽 번호를 비우고refresh_on_open을 켠다. 한/글이 열 때 항목과 쪽 번호를 다시 만든다(확인함).상호 참조의 보일 글: 대상이나 보일 것이 바뀌면 보이던 글을 비운다. 쪽 번호·번호는 한/글이 쪽을 배치하며 채운다(확인함).
글자·문단 모양 변경 추적: 엔진은 새로 쓰거나 거절하지 않고, 파일에 있는 항목은 읽고 그대로 둔다. 한/글 2024는 다시 저장할 때 그 항목을 버린다(확인함).
[6.12.0] - 2026-11-11
2026-11 전체 점검에서 나온 수정을 모은 릴리스입니다. 성공으로 보고하면서 내용이 달라지던 편집 경로를 바로잡았습니다. 찾아 바꾸기와 부분 편집이 줄 바꿈과 탭을 한/글의 요소로 쓰고, 내용이 바뀐 문단에 남던 옛 줄 배치 캐시를 저장 때 지우며,
한/글을 종료시키던 빈 글맵시·OLE·동영상 요소는 저장 관문이 거부합니다. 신뢰할 수 없는 .hwp·.hwpx를 다룰 때의 자원
한도와 출력(미리보기 HTML, 리치 마크다운, 그림 내보내기)을 보강했습니다. 그래서 리치 마크다운은 http·https·mailto가
아닌 링크를 글로만 남기고, image_dir에는 그림 파일만 꺼냅니다. 새 기능으로 Markdown을 HWPX로 쓰는 from_markdown,
id로 가리키는 글 덩어리와 일괄 바꾸기, 서식 규칙 점검(check_format, hwpx-check-format)이 들어갔습니다. 배포판의
모든 파일이 256 KiB 아래가 되어, 6.8.0에 멈춰 있던 Claude 플러그인의 엔진을 다시 올릴 수 있습니다. 표 격자·스타일 조회·
문단 추가의 반복 비용을 줄였습니다. 코어의 줄 수는 6.11.0보다 약 8천8백 줄(8.8%) 줄었는데, FormFit 글꼴 폭 표를
압축 자료 파일로 옮겼기 때문이고(약 1만 2천 줄), 그 밖에는 도구(약 1,240줄)와 문서 모델(약 530줄)이 늘었습니다.
import hwpx가 읽는 모듈 수는 99개로 그대로입니다. 저장 성공만으로 시각 품질을 보증하지 않습니다.
추가
서식 규칙 점검
check_format(document, rules)(hwpx.tools.format_rules)과 명령hwpx-check-format RULES DOCUMENT. 기관이 정한 서식(글꼴·글자 크기·장평·자간, 정렬·줄 간격·들여쓰기·문단 간격, 표의 글자처럼 취급·표 안의 표, 문자 범위, 하이퍼링크·매크로 허용 여부)을 JSON 규칙 파일로 적어 문서가 따르는지 본다. 규칙의 항목 이름과 단위는 한컴이 공개한 검사기hancom-io/dvc와 같아 그 규칙 파일을 그대로 쓸 수 있다. 지원하지 않는 항목은unsupported_rules로 알리고, 어긋난 곳은 구역·문단 번호와 글로 알린다(쪽·줄 번호는 파일에 없어 주지 않는다). 파일에 저장된 값만 읽는다.from_markdown(markdown, style=...)(hwpx.tools.markdown_import): 흔히 쓰는 Markdown 부분 집합으로 새 문서를 만든다.#~####제목, 문단,-/*/1.목록(들여쓰기로 수준을 나누고 한/글 목록으로 적용),|표(구분선 위 행은 굵게·음영 머리글),**굵게**·*기울임*을 쓰고, 그 밖의 Markdown은 평문으로 쓰며 오류를 내지 않는다. 이미 있는 문서에는doc.text.append_markdown(markdown)으로 덧붙인다. 모양은 장르 중립MarkdownStyle(같은 모듈, 기본#16pt·##12pt 굵게)로 바꾼다. 공문·가정통신문 같은 장르 프리셋은 응용 계층이 이 스타일로 넘긴다.HwpxDocument.new(inherit_style=False): 깨끗한 새 문서.add_paragraph가 앞 문단의 문단·글자 모양을 물려받지 않고 바탕글에서 시작하므로, 제목이나 목록 다음 문단에 개요·목록 번호가 따라붙지 않는다.add_paragraph의inherit_style기본값은 이제None(문서를 따름)이고, 기본 문서에서는 전처럼 물려받는다.doc.text.blocks()가 본문 문단과 표 칸 문단(칸 안 표 포함)을 문서 순서대로, 위치로 정해지는 id(s0p16,s0p16t0r3c0q0)와 사람이 읽는 위치(표1 4행 1열)와 함께 내놓는다. 병합 칸은 대표 칸에서 한 번만 나오고, id는 저장·재열기 뒤에도 같다(#666).doc.text.outline(max_chars=8000)이 글자가 있는 덩어리만{"id", "where", "text"}목록으로, 글자 예산 안에서 돌려준다. 탭·줄 바꿈은 공백, 제어 문자는 지우고, 긴 덩어리는 앞부분만 남긴다. 예산이 다하면next_after로 다음 쪽을 읽고,to_text()는 한 줄에 한 항목인 프롬프트 형태다. 작은 모델에 문서 전체 대신 짧은 목록을 넘기는 용도다(#668).doc.text.apply_changes({id: 새 글})이 여러 덩어리를 한 번에 바꾸고 id마다changed·unchanged·unknown_ids·rewritten을 보고한다. 한 런 안의 바꿈은 런과 컨트롤을 지키고, 칸이 품는 줄보다 많이 필요할 것으로 추정되는 칸은overflow로 미리 알린다(form-fit 측정기의 추정, 렌더 아님)(#667).
고침
apply_body_ops가 문서를 망가뜨리던 네 경우를 거부하거나 바로잡는다(전에는 모두applied에 열림 검사 통과였다).구역 정의(
hp:secPr)를 품은 문단:delete_paragraph는 구역 정의째 지웠고,insert_paragraph_by_clone은 구역 정의를 한 벌 더 만들었고,reorder_paragraphs는 그 문단을 첫 자리에서 옮겼다. 이제 셋 다 거부한다.글상자·각주·머리말을 품은 문단:
set_paragraph_text와texts를 준insert_paragraph_by_clone이 새 글을 안쪽 문단의 첫 글 자리에 넣고 나머지 글을 비울 수 있었다. 이제 거부한다(표를 품은 문단은 전부터 거부).restyle_text: 찾은 글이 표 뒤에 있으면 그 글의 run이 아니라 표 마지막 칸 안 run의 글자 모양을 바꿨다. 이제 글을 직접 가진 run을 바꾼다.
XML 주석이나 처리 지시문이
header.xml이나 줄 배치 캐시가 있는 문단에 든 문서도 저장된다. 전에는 문서가 열리고 열림 검사도 통과했지만, 고치지 않은 저장까지TypeError: argument of type 'cython_function_or_method' is not iterable로 끝났다(저장 때 도는 검사가 주석 노드의tag를 요소 이름으로 읽었다). 문서 병합(append_document)도 같은 오류였다.저장 관문이 필수 자식(
offset·orgSz·curSz·sz·pos,renderingInfo)이 없는 글맵시(hp:textart)·OLE(hp:ole)· 동영상(hp:video)도hp:rect처럼 거부한다.doc.shapes.add_raw("textart"|"ole"|"video")로 만든 빈 요소는 전에 저장됐고, 그 파일을 한/글 2024가 열다가 경고 없이 종료했다(종료 코드 0xC0000005).validate_package·validate_editor_open_safety도 오류로 보고한다. 한/글이 저장한 글맵시·OLE·동영상은 전처럼 통과하고, 빈 수식(hp:equation)은 한/글이 정상으로 열므로 막지 않는다.paragraph.apply_model(글·런을 바꾼 경우),add_index_mark,add_title_mark,add_drop_cap이 고친 문단의 줄 배치 캐시를 지운다. 전에는 문단 내용이 바뀌어도 옛 캐시가 남았다.apply_model은 모델이 문단 내용을 바꾸고 캐시는 그대로 돌려준 때만 지우므로, 모델로 캐시 자체를 고치는 쓰임은 전과 같다.저장 때의 낡은 캐시 훑기가, 고친 구역에서 내용이 바뀐 문단에 남은 옛 캐시를 지운다. 구역은 읽을 때(그리고 저장할 때마다)의 “문단 내용 + 캐시” 짝을 기억하고, 파일에 있던 캐시가 다른 내용 위에 놓여 있으면 그 캐시를 지운다. 편집 API가 캐시 지우기를 빠뜨려도 글이 한 글자만 늘어난 경우까지 잡힌다(전에는 마지막 줄 뒤 글이 그 줄 폭의 2배를 넘어야 지워졌다). 내용이 그대로인 문단의 캐시와 읽은 뒤 새로 쓴 캐시는 건드리지 않는다. 고치지 않은 구역은 전처럼 바이트 그대로 저장된다. 폭 추정으로 지우는 기존 기준(2배)은 그대로다.
찾아 바꾸기와 부분 편집도 줄 바꿈을
hp:lineBreak로, 탭을hp:tab으로 쓴다.run.replace_text,doc.text.replace(기본·everywhere=True),doc.replace_text_in_runs,paragraph.apply_model·run.apply_model은 바꿀 글의"\n"을hp:t안에 글자로 남겼고,paragraph.set_text_preserving_runs는"\n"을 글자로 남기고 탭은 지웠다. 이제paragraph.text =·add_run과 같은 요소로 쓴다("\r\n"·"\r"도 줄 바꿈 하나).strip_runs_by_color가 표·글상자·각주를 품은 대상 색 run에서 안쪽 run의 글을 지우지 않는다. 전에는 run의 여는 태그를 그 뒤 첫</hp:run>과 짝지어, 빨강 run이 표를 품고 있으면 첫 칸의 검은 글이 지워지고도applied로 보고됐다. 빈 run(<hp:run …/>) 뒤의 다른 색 글도 같은 까닭으로 지워졌다. 이제 대상 run이 직접 가진 글만 비우고, 표 등을 품은 run을 비운 수를runsHoldingNestedRuns로 알린다. 줄 배치 캐시는 글이 바뀐 문단의 것만 지운다(전에는 표 뒤 글이 지워진 바깥 문단의 캐시가 남았고, 원래 비어 있던 문단의 캐시는 지워졌다).배포판에 든 파일이 모두 256 KiB 아래로 내려간다. Claude 플러그인은 엔진 배포판을 풀어 싣는데, 플러그인 디렉터리가 파일 하나에서 256 KiB까지만 읽어 6.9.0부터 플러그인의 엔진이 6.8.0에 멈춰 있었다(hwpx-plugins #66). FormFit 글리프 표(
form_fit/_glyph_table.py, 454 KiB)는 gzip으로 압축한 JSON 자료 파일_glyph_table.json.gz(65 KiB)로 싣고 모듈을 가져올 때 읽는다. 표의 값과 순서는 그대로다. 쪽 수 추정(layout/pages.py, 325 KiB)은 아래쪽 절반을layout/_page_measure.py로 옮겼다. 코드는 한 줄도 바꾸지 않았고hwpx.layout.pages에서 전과 같은 이름을 쓴다. 배포 파일이 한도에 닿으면 실패하고 80%를 넘으면 경고하는 검사(tests/test_distribution_file_sizes.py)를 더했다.표 행·열·칸 구조 편집(객체 경로와
apply_table_ops)이 쪽을 넘어 나뉜 표의 저장 높이(hp:sz)를 그대로 둔다. 한/글은 그런 표에 첫 쪽 조각의 높이만 저장하므로(같은 행의 표가 놓인 자리에 따라 30463·17551·5865로 저장됨) 행 높이 증감을 더할 근거가 없다. 전에는 증감을 그대로 더해, 평가계획 채우기가 13행 표(행 28762, 저장 13222)에서 9행을 지우면 높이가 0이 됐다(#539 후속). 행 높이만큼 저장된 표는 전처럼 증감만큼 움직인다.줄 캐시(
write_line_caches)가 머리에 정의되지 않은 글머리표·번호를 가리키는 문단 모양(예: 글머리표 idRef 0)의 문단에는 캐시를 쓰지 않는다. 한/글은 정의가 없어도 글머리 자리를 잡아 첫 줄에 글자를 덜 넣는데, 전에는 글머리 없이 나눈 줄을 써서 한/글이 그 줄을 눌러 담을 수 있었다.줄 캐시가 왼쪽이나 오른쪽 여백이 음수인 문단(줄이 단·칸 가장자리 밖으로 나가는 문단)에도 캐시를 쓰지 않는다. 한/글이 그런 줄을 어떤 폭으로 나누는지 확정하지 못했고, 한 글자 이상 다르게 나눈 문단이 있었다.
쪽 수 추정이 표 칸 안에서 양쪽에 글 자리가 있는 어울림 개체 곁에 빈 줄만 오는 칸도 추정한다. 한/글처럼 빈 줄은 개체 곁에 한 높이 두 조각으로 둔다(곁에 글이 오면 지금처럼 지원 밖). 한/글이 저장한 줄 캐시가 있는 칸에서 그런 두 조각을 줄 둘로 세어 칸을 조각 수만큼 높게 잡던 것도 바로잡았다.
쪽 수 추정이 종이(또는 쪽) 기준으로 놓인 어울림 개체 곁의 글도 추정한다. 한/글처럼 그 쪽에서 개체 띠에 걸치는 줄은 앵커 문단 앞 문단의 줄까지 모두 좁히고, 양쪽에 자리가 있으면 한 높이에 두 조각으로 나눈다. 곁 줄은 문단 여백에서 개체까지 (또는 개체에서 여백까지)이고 개체 쪽 여백은 더 빼지 않는다. 전에는 지원 밖으로 두었다. 종이 가로 가운데에 놓인 어울림 개체의 곁 너비도 이제 바르게 잰다(전에는 오른쪽 기준처럼 쟀다).
쪽 수 추정과 FormFit이 줄 바꿈 뒤 빈 run으로 끝나는 문단의 빈 마지막 줄을 한/글처럼 그 run의 크기로 잡는다(글자보다 작아도). 전에는 작은 run은 무시하고 큰 run은 줄 바꿈 앞 줄까지 키웠다. 끝 run이 더 크면 그 문단의 줄 캐시는 쓰지 않는다.
쪽 수 추정이 첫 줄에 붙은 어울림 개체의 세로 위치를 한/글처럼 위 간격 위 문단 맨 위에서 잰다. 전에는 첫 줄 맨 위에서 재서, 위 간격이 있는 문단에서 개체 곁에 좁아지는 줄을 위 간격만큼 아래로 잡았다.
셀 줄간격(
set_cell_line_spacing)이 표를 품은 칸도 바꾼다. 칸 자신의 문단(표를 담은 문단 포함)만 줄간격을 바꾸고 그 문단들의 줄 캐시만 지우며, 안쪽 표와 글상자는 바이트 그대로 둔다. 전에는 그런 칸을 거부했고, 다른 칸에 표가 든 표에서 행을 고르면 안쪽 표의 같은 주소 칸까지 바꿨다.복제한 것을 다시 복제해도 번호가 겹치지 않는다. 표를 품은 행을 복제한 뒤 열을 복제하면(또는 반대로) 안쪽 표의
id가 겹쳤고,insert_block_by_clone을 두 번 하면 문단id가 겹쳤다. 이제 복제된 표는 한/글이 붙여 넣은 표처럼 문서에 없는 새id와 문서 맨 위zOrder를 받고, 문단은 문서에 없는id를 받는다.insert_block_by_clone이 그림·도형·필드·메모가 든 칸을 행 복제처럼 복제한다. 전에는 같은 번호로 복사했다. 차트, 연결된 글상자, 칸 안 머리말·꼬리말 정의가 든 블록은 거부한다.clone_table이 표와 그 안의 표·개체에 한/글이 붙여 넣은 표처럼 새 번호를 준다. 전에는 문단id만 바꿔 표id와 개체 번호가 원본과 같았다. 차트, 연결된 글상자, 칸 안 머리말·꼬리말 정의가 든 표는 거부한다.split_cell_vertical이 새로 생긴 칸을 빈 문단 하나로 둔다(칸 나누기와 같음). 전에는 원래 칸의 문단을 글자만 비워 복사해서, 그 칸의 그림·도형이 같은 번호로 겹쳤다.객체 모델
set_column_widths·equalize_column_widths가 칸을 안쪽 표보다 좁게 만들면 바이트 편집처럼 거부하고 표를 그대로 둔다(TableStructureError)..hwp의 스크립트 스트림도 다른 스트림과 같은 크기 한도 안에서 읽는다. 한도를 넘으면Hwp5Error(hwp5-limit-exceeded)로 거부하고, 스크립트를 네 개보다 훨씬 많이 적은 스트림은 읽지 못한 것으로 센다.손상된
.hwp를 열다 나는ValueError·OverflowError·UnicodeEncodeError·RecursionError·MemoryError등이Hwp5Error(hwp5-damaged또는hwp5-limit-exceeded)로 나온다. 원래 예외는__cause__에 있다. 512MiB보다 큰.hwp는 읽지 않고hwp5-limit-exceeded로 거부한다(hwpx.hwp5.package.MAX_FILE_BYTES).hwpx-repair와hwpx-pack이 패키지의 XML 부품을 엔티티를 풀지 않는 파서로 읽는다.수식 안 따옴표 글이 미리보기 MathML에 마크업이 아닌 글로 들어간다(
<,&가 이스케이프된다).쪽 미리보기와 문서 뷰어가
hp:t안의 줄 바꿈·탭·형광펜 표시 뒤의 글도 보여 준다. 전에는 그 앞 글만 나왔다. 미리보기의 글자색·테두리 색은 16진 색, 테두리 굵기는 mm 길이, 정렬은 알려진 값일 때만 쓰고 아니면 기본값을 쓴다.리치 마크다운 내보내기가 글자색·형광색을 16진 색일 때만
<span>·<mark>로 감싸고, 하이퍼링크는http·https·mailto대상만 링크로 쓴다. 그 밖의 대상(문서 안 책갈피, 파일 경로 포함)은 글만 남긴다.export_markdown(image_dir=…)이BinData/의 그림 파일(png·jpg·gif·bmp·tif·webp·svg·wmf·emf·ico)만 꺼내고, 이름에 드라이브·스트림 표시나 장치 이름이 있으면 꺼내지 않는다.폐기 경고와
docs/migration-6.0.md가 없는 이름으로 안내하던 두 곳을 바로잡았다.doc.style(…)의 이동 대상은doc.styles.get,doc.set_check_box(…)의 이동 대상은doc.fields.set_check_box다(전에는 없는doc.styles.style·doc.fields.check_box(...).checked를 가리켰다). 이동 대상 79개가 실제 속성으로 풀리는지 테스트가 확인한다.llms.txt는.hwp가 열린다고 적고,examples/build_release_checklist.py는 6.x 이름으로 끝까지 돈다(전에는 없는document.save()를 불렀다).공개 예외 7종(
EquationConversionError,UnsupportedLatexError,MathMLUnavailableError,DocumentIngestError,UnsupportedDocumentFormat,RecoverError,WordBoxExtractorRequired)이HwpxError도 상속한다. 기존 부모 (ValueError·RuntimeError)는 그대로라 기존except는 전처럼 잡는다. 각자code가 생겼다 (equation-conversion,equation-latex-unsupported,equation-mathml-unavailable,ingest-failed,ingest-format-unsupported,recover-unsafe,toc-word-box-extractor-required).손상된 HWPX를 열 때 나던 날 예외를
HwpxStructureError하위 클래스로 묶었다. ZIP이 아니거나 잘린 입력은HwpxArchiveError, 압축 데이터 손상은HwpxCompressedDataError, 깨진 XML 파트(암호 걸린 HWPX 포함)는HwpxXmlSyntaxError(part_name에 파트 이름)다. 각 클래스는 전에 나던zipfile.BadZipFile·zlib.error·lxml.etree.XMLSyntaxError도 상속하므로 기존except는 그대로 잡고, 원래 예외는__cause__에 있다.HwpxDocument.open의 독스트링과docs/stable-api.md가 이 표를 적는다.HwpxDocument.new()로 만든 문서가 동봉 템플릿의 지은이(synthetic-fixture-author)와 만든 날(2025-09-17)을 물려받지 않는다. 지은이·마지막 저장한 이·date는 비고,CreatedDate·ModifiedDate는 만든 시각(UTC)이다 (SOURCE_DATE_EPOCH가 있으면 그 시각). 지은이는doc.package.set_document_metadata(creator=...)로 넣는다.버전 이력이 있는 한/글 문서에서
doc.parts.histories의historylastdoc.hml(마지막 문서의 HWPML 스냅숏)이to_model()에서HwpxValueError를 내지 않고 항목 없는History를 돌려준다. 버전 기록인지는 새 속성is_version_log로 가린다.doc.text.html()이 병합된 표 칸에colspan·rowspan을 쓴다. 전에는 병합 표의 뒤 칸이 왼쪽으로 밀렸다.doc.tables.all의 설명을 실제 범위(본문 문단에 바로 놓인 표)로 고쳤다. 동작은 그대로다.hwpx.ingest의 HWPX → Markdown 변환이 손실을 항상"low"로 보고하지 않는다. Markdown에 글이 실리지 않은 요소 (머리말·꼬리말·메모·각주·미주·글상자·수식·덧말·글자 겹침·양식 개체 캡션·글맵시·바탕쪽)를 결과와 대조해 종류별로 세어warnings와metadata["left_out"]에 싣고, 빠진 것이 있으면lossiness가"medium"(빠진 글이 실린 글보다 많으면"high")이다. 변경 추적으로 지운 글 표시가 있으면 따로 경고한다. 빠진 것이 없으면 전처럼"low"다.describe_capabilities()의 자리 안내를 실제와 맞췄다. 차례·상호참조(hwpx.tools.toc_author), 제목 차례 표시·색인 표시·날짜/교정 부호/파일 이름 필드·메일머지 표시 필드(HwpxOxmlParagraph.add_*)는doc.refs·doc.fields에 없으므로namespace가None이고 진입점이 그 모듈·문단 클래스다. 지원 매트릭스의 같은 표와 arc·polygon·curve·connectLine 행, 차트 행(add_chart(chart_xml))도 고쳤다.커버리지 장부가
.hwp변환기(hwp5/)가 써내는 태그를 읽기로 세지 않는다(읽기 266 → 256).쪽 수 추정이 글 없이 어울림 개체와 글자처럼 취급한 개체 하나만 있는 문단도 추정한다. 한/글처럼 그 개체를 곁 줄에 둔다(곁보다 넓어도). 전에는 그런 문서를 추정하지 않았다.
쪽 수 추정이 표 칸 안에 다단이 있는 문서를 추정하지 않는다. 한/글은 칸의 글을 그 단에 나눠 놓는데, 전에는 한 단으로 놓아 행 높이를 크게 잡았다.
쪽 수 추정이 표 칸 문단 안에 아래로 놓인 위아래 표를 한/글처럼 위 간격 위 문단 맨 위에서 잰다. 전에는 칸 문단의 위 간격만큼 칸을 크게 잡았다.
쪽 수 추정이 어울림 개체가 있는 글 문단에 글자처럼 취급한 개체가 함께 있어도 문서를 추정한다. 한/글처럼 그 개체를 어울림 곁 줄에 둔다. 전에는 그런 문서를 추정하지 않았다.
쪽 수 추정이 줄보다 넓은 글자처럼 취급한 표 뒤에 앞 문단에서 시작한 필드의 끝만 있으면, 한/글처럼 그 문단을 한 줄로 둔다. 필드 끝은 줄에 자리를 차지하지 않는다. 전에는 필드 끝을 다음 줄로 보내 빈 줄을 하나 더 셌다.
쪽 수 추정이 글 문단 첫 줄 아래로 놓인 나누지 않는 위아래 표가 쪽에 들어가지 않을 때, 한/글처럼 문단 줄은 들어가는 쪽에 두고 표만 다음 쪽 맨 위로 보낸다. 전에는 문단 줄까지 다음 쪽 표 아래로 보내 쪽 수가 하나 늘었다.
쪽 수 추정이 글자 모양의 위·아래 테두리를 줄 높이에 넣는다. 한/글은 테두리가 있는 글자(문단 끝 빈 run 포함)가 선 줄을 그 두께만큼 위아래로 키우고 줄 간격도 그 높이로 잰다. 그런 문단의 줄 캐시는 쓰지 않는다.
[6.11.0] - 2026-11-02
표 안에 표가 든 문서를 끝까지 다루고, 쪽 수 추정과 FormFit을 한/글에 더 가깝게 맞춘 릴리스입니다. 바이트 보존 편집이
안쪽 표를 품은 칸을 채우고, 표를 품은 표에도 행·열·칸 구조 편집을 적용합니다. 행·열을 내용째 복제할 때 그림·도형·필드·
메모가 든 칸도 한/글이 붙여 넣을 때처럼 번호를 새로 매겨 복제합니다. 그래서 6.10.0이 거부하던 부모 칸 채우기와 이런 칸의
복제가 이제 적용되고, set_text(split_paragraphs=True)는 안쪽 표를 담은 문단을 지우지 않습니다. 쪽 수 추정은 위아래 개체,
흐르는 표, 칸 안 표와 각주가 든 문서를 더 많이 추정하고, FormFit과 함께 KoPub·한컴·HY 글꼴 폭과 글자 상대 크기를 한/글
저장본에 맞췄습니다. 그래서 FormFit이 고르는 글자 크기와 줄 수, 쪽 수 추정 결과가 6.10.0과 달라질 수 있습니다. MS Word
호환으로 둔 문서는 쪽 수 추정을 미지원으로 알립니다. 코어는 6.10.0보다 약 4천4백 줄(4.6%) 늘었는데, 대부분 FormFit의
글꼴 폭 표(약 3,300줄)와 쪽 수 추정(약 430줄), 표 편집이 든 최상위 모듈(약 470줄)입니다. import hwpx가 읽는 모듈 수는
99개로 그대로입니다. 저장 성공만으로 시각 품질을 보증하지 않습니다.
추가
응용 정책을 주입할 공용 경로를 추가한다:
paragraph_texts문단 읽기, Markdownheading_detector콜백, 호출자가 대상을 고르는strip_trailing_table_text. 기존 diff·제목 판정·짧은 캡션 제거의 6.x 이름과 기본 동작은 유지한다.표를 품은 칸(부모 칸)도 바이트 셀 채움으로 채운다. 칸 자신의 글자만 바꾸고 안쪽 표는 바이트 그대로 둔다. 표 옆 글자는 그 자리에서 바꾸고, 표만 있는 칸은 표 위에 표 문단 모양의 새 문단을 둔다.
표를 품은 표에도 행·열 삽입·삭제·순서 변경, 열 폭·자동 맞춤, 행 높이, 칸 나누기, 표 나누기·합치기를 적용한다. 안쪽 표는 칸과 함께 옮겨지거나 지워지고, 칸을 내용째 복제하면 새 id로 복제된다. 안쪽 표가 들어갈 폭보다 칸을 좁히는 편집은 거부하고, 자동 맞춤은 그 열을 안쪽 표 폭에서 멈춘다.
행·열을 내용째 복제하거나 칸을 나눌 때 그림·도형·수식·각주·누름틀 같은 필드·책갈피·메모가 든 칸도 복제한다. 전에는 “local identities or references”로 거부했다. 한/글에서 복사·붙여넣기한 결과를 저장해 본 규칙을 따른다: 개체는 문서에 없는 새
id·instid와 문서 맨 위zOrder를, 필드는 새id(끝이 따라감)를 받고fieldid와 이름은 그대로 둔다. 묶음 개체 안 도형은 한/글이 저장한id·zOrder(0이거나 묶음 안에서 겹치는 값)를 그대로 두고instid만 새로 받는다. 메모는 다음 메모 번호를 받고, 복사된 연결선은 연결이 끊긴다. 차트, 연결된 글상자, 칸 안 머리말·꼬리말 정의는 계속 거부한다.
고침
쪽 수 추정이 아래로 놓인 위아래 표의 띠가 오기 전에 쪽 나눔이 있어도 문서를 추정한다. 한/글처럼 표는 제자리에 두고, 쪽 나눔 문단은 표가 끝나는 쪽의 다음 쪽에서 시작한다. 전에는 그런 문서를 추정하지 않았다.
쪽 수 추정이 한 문단에 종이 기준으로 놓인 개체가 여럿이어도 문서를 추정한다. 한/글처럼 개체마다 따로 띠로 보고 본문 줄을 그 띠 밖에 둔다. 전에는 그런 문서를 추정하지 않았다.
쪽 수 추정이 글자 크기·모양이 섞인 표 칸 문단에 위아래 개체가 있어도 문서를 추정한다. 개체가 붙은 줄까지는 위에, 나머지 줄은 그 아래에 둔다. 전에는 그런 문서를 추정하지 않았다.
쪽 수 추정이 표 칸 안 어울림 개체 곁의 문단에 왼쪽·오른쪽 여백이나 들여쓰기가 있어도 문서를 추정한다. 한/글처럼 개체가 남긴 폭 안에서 여백과 들여쓰기를 건다. 전에는 그런 문서를 추정하지 않았다.
쪽 수 추정이 글 없는 문단에 쌓인 위아래 개체 가운데 문단보다 위로 올린 것(세로 위치 음수)도 한/글처럼 올리지 않은 것으로 보고 쌓는다. 전에는 그런 문서를 추정하지 않았다.
FormFit과 쪽 수 추정이 U+0080~U+00FF 글머리표(소프트 하이픈·가운뎃점 등)를 한/글처럼 ASCII와 같이 반 em으로 잰다. 전에는 em으로 재서 글머리표 문단의 줄 폭을 반 em 좁게 잡았다.
쪽 수 추정이 쪽 끝을 넘는 흐르는 표를 그 쪽 앞 문단의 각주 영역 위에서 나눈다(한/글처럼 구분선 굵기는 빼고). 전에는 각주가 없는 것처럼 표 행을 본문 끝까지 채워, 표 뒤 글을 각주 영역만큼 위에 놓았다.
FormFit과 쪽 수 추정이 낱말 안의 ASCII 기호를 한/글처럼 괄호로 다룬다.
$·<·\는 줄 끝에 두지 않고 뒤 글자와 함께 내리며(가가$가가→가가|$가가),>·^·~는 줄 처음에 두지 않고 앞 글자와 함께 내린다(가|가>가).쪽 수 추정이 글자 단위(
unit="CHAR")로 적힌 고정·최소·줄 사이 줄 간격을 여백과 같이 바탕글 글자 크기의 1/200로 읽는다 (10pt에서 320이면 줄 1,600). 전에는 그 값을 HWPUNIT으로 읽어 줄을 겹치게 잡았고, 실험write_line_caches는 그 간격(−680)을 줄 캐시에 썼다.MS Word 호환으로 둔 문서(
hh:compatibleDocument targetProgram="MS_WORD")는 쪽 수 추정이 미지원으로 알리고, 실험write_line_caches는 줄 캐시를 쓰지 않는다. 한/글은 그런 문서를 Word처럼 배치해서(줄 높이를 글꼴의 위·아래 높이로, 그림 줄은 그림 높이에 글꼴 아래 높이를 더해) 엔진 추정과 달랐다. 전에는 일반 문서처럼 추정하고 줄 캐시를 써서, 한/글이 그 캐시를 믿으면 줄이 겹칠 수 있었다.실험
write_line_caches가 여백이 -1(부호 없는 값)로 적힌 표 칸에는 줄 캐시를 쓰지 않는다. .hwp에서 바꾼 문서에 있는 이런 칸은 한/글이 표 여백과 다른 폭으로 글을 놓아서(표 여백으로는 2,175인 칸을 2,888로), 줄 나눔이 엇갈렸다.FormFit과 쪽 수 추정이 여는 따옴표(“ ‘)를 여는 괄호처럼, 뒤 글자가 줄에 안 들어가면 그 글자와 함께 다음 줄로 내린다.
가]“가는가]|“가로 나눈다. 전에는 따옴표에서 줄을 끝낼 수 없어 두 글자 앞에서 나눴다.바이트 셀 채움이 중첩 표의 주소·span을 바깥 셀 메타데이터로 읽지 않도록 한다. 충돌·불완전 격자는 변경 없이 건너뛴다. 다른 바깥 셀과 안쪽 표를 직접 지정한 채움은 계속 지원한다.
바이트 셀 채움에서 칸의 문단보다 많은 줄을 넣으면 넘치는 줄이 사라지던 문제를 고친다. 마지막 문단에 줄 바꿈(
hp:lineBreak)으로 이어 넣는다.바이트 셀 채움이 글상자·각주처럼 자기 문단을 가진 개체가 든 칸에서 개체 안 글자를 지우고 개체 뒤 칸 글자를 남기던 문제를 고친다. 개체 안 문단은 그대로 두고 칸 자신의 글자만 바꾼다.
cell_paragraph_spans도 개체 안 문단을 칸 문단으로 세지 않는다.표 합치기(
merge_table)가 표 안에 든 표를 “다음 표”로 잡아 거부하던 문제를 고친다. 같은 층의 다음 표와 합친다.칸 글 쓰기
set_text(..., split_paragraphs=True)(table.set_cell_text도 같다)가 안쪽 표·개체를 담은 문단까지 지우던 문제를 고친다. 그 문단은 자리와 담은 것을 그대로 두고 자기 글만 비우며, 줄마다 만든 새 문단은 첫 글 문단 자리(글 문단이 없으면 첫 개체 문단 앞)에 둔다. 기존 문서의 “안쪽 표를 담은 문단도 함께 지운다”는 동작이 바뀐다.FormFit과 쪽 수 추정이 사용자 정의 영역 글자 U+F020–F0FF(Word 문서가 옮겨 온 Symbol·Wingdings 글머리, U+F0A7 등)를 한/글이 놓는 폭으로 잰다. 맑은 고딕·함초롬바탕·함초롬돋움·한컴산뜻돋움·휴먼명조·한양신명조·한양중고딕·HY헤드라인M·HY중고딕· KoPub바탕체·돋움체 Light에서 글자마다 제 폭(대부분 0.89 em)이다. 전에는 글자 갈래 평균(0.42 em)으로 재서, 그런 글머리로 시작하는 문단을 한/글보다 늦게 나눴다.
붙여 쓴 수식 글꼴 명령(
rmA,itx,boldx)을 한/글처럼 해석해 LaTeX 변환과 폭 계산에 반영한다. 일반 LaTeX 변수 이름이 같은 접두사로 시작하면 인용해 글자가 사라지지 않게 한다. 한컴에서 확인한 소문자·첫 글자 대문자·전체 대문자 형태만 명령으로 인식하며, 단어 내부와 따옴표 안은 그대로 보존한다.쪽 수 추정이 합친 칸으로만 덮인 표 행을 한/글처럼 높이 100 이상으로 잡는다(표가 셀 크기를 조정하지 않게
hp:tbl@noAdjust로 정해 둔 것은 빼고). 전에는 그런 행을 0에서 풀어 53처럼 얇게 두어, 합친 칸이 엇갈린 표를 그만큼 낮게 보고 뒤 글을 위에 놓았다.단 폭을 4의 배수로 내린 뒤 0이 되는 구역은 쪽 수 추정과 줄 배치 캐시 쓰기를 미지원으로 알린다.
문단 서식을 다시 쓸 때, 이번 요청의 비교 기준을 한 번 준비해 기존 서식들과 대조한다. 반복 요청의 후보 탐색에서 같은 속성·자식 구조를 거듭 복사하지 않는다. ID 재사용·자식 순서·알 수 없는 요소 보존은 그대로이며, 다음 호출은 XML 변경을 다시 읽는다.
FormFit과 쪽 수 추정이 한컴 고유 글꼴 명조·고딕의 ASCII 글자를 한/글처럼 반 em(바탕체와 같은 폭)으로 잰다. 전에는 목록에 없는 글꼴로 보고 한컴바탕 폭(숫자 약 0.58 em 등)으로 재서, 숫자·영문이 많은 명조 문단을 한 글자 일찍 나눴다.
native 누름틀을 채운 뒤 결과를 만들 때 선택한 필드가 있는 문단만 다시 읽는다. 선택 전 전체 탐색은 그대로 유지하며, 결과의 값·서식·위치와 여러 문단·중첩 누름틀 채움은 보존한다. 많은 필드를 연속 채울 때 불필요한 두 번째 전체 탐색을 없앴다.
각주가 든 흐르는 표가 쪽 끝에서 각주 영역과 겹치면 쪽 수 추정을 미지원으로 알린다. 그 경계에서 표를 다시 나누는 동작은 한/글 실측 전까지 추측하지 않는다.
쪽 수 추정이 글 안에 그대로 든 줄 바꿈 없는 빈칸(
hp:t안의 U+00A0,hp:nbSpace가 아닌 것)을 글꼴 자체의 그 글자 폭으로 잰다(한컴산뜻돋움 10pt에서 264). 한/글은 그 빈칸을 글꼴 자체 빈칸을 쓸 때처럼 놓고, 양옆 낱말은 한 줄에 둔다. 전에는 반 em으로 재서 그런 빈칸이 든 표 머리 칸을 한 줄 더 나누고 표 뒤 글을 그만큼 아래에 놓았다. 실험write_line_caches는 그런 빈칸이 든 문단을 한/글에 맡긴다(hp:nbSpace는 전처럼 쓴다).쪽 수 추정이 표 칸 안의 각주를 그 표가 놓인 문단의 각주처럼 쪽(단) 아래 각주 영역에 놓는다(글자처럼 놓인 표, 종이·쪽 기준 표, 쪽에서 나뉘지 않는 흐르는 표). 전에는 칸 안 각주를 세지 않아서, 그 자리만큼 본문 줄을 더 넣고 다음 쪽(단) 글을 위에 놓았다. 글 사이에 놓인 표의 각주는 개체의 실제 줄을 따라갈 때까지 추정을 보류한다.
쪽 수 추정이 글자처럼 놓인 개체가 든 표 칸 문단도 본문처럼, 글자 없는 끝 런이 글보다 크면 마지막 줄을 그 크기로 잰다. 전에는 칸에서 이런 문단만 끝 런을 빼고 재서 칸을 그만큼 낮게 보고 표 뒤 글을 위에 놓았다.
바이트 보존 표 구조 편집도 객체 편집처럼 행 높이의 전후차만큼 표 전체 높이를 갱신한다. 행 삽입·삭제와 칸 나누기 후 표 뒤 글의 위치가 두 경로에서 달라지던 경우를 바로잡았다. 행 높이를 측정할 수 없는 표의 저장 높이는 유지하며, 편집 대상 밖 XML과 ZIP 파트는 그대로 보존한다.
쪽 수 추정이 표가 든 칸을 쪽 끝에서 줄 사이로 나눌 때, 칸 첫 문단에 위 간격이 없어도 다음 쪽 몫을 그 첫 문단의 위 간격 아래에서 시작한다. 전에는 칸 첫 문단에 위 간격이 있을 때만 문단마다의 간격을 따져, 다른 문단들만 위 간격이 있는 칸은 다음 쪽 몫을 그만큼 위에서 시작했다.
쪽 수 추정이 단 하나인 구역의 줄 폭도 여러 단일 때처럼 4의 배수로 내려 잡는다(왼쪽·오른쪽 여백 8503이면 42,520). 전에는 남는 폭 그대로(42,522) 잡아서, 그 폭에 꼭 맞는 글자처럼 놓인 표 뒤의 쪽 번호·쪽 감추기를 표 줄에 두고 다음 줄을 빠뜨렸다. 실험
write_line_caches도 그 폭으로 줄을 나누고 쓴다.쪽 수 추정이 칸 줄 사이로 나뉘는 흐르는 표에 아래 캡션이 있으면, 표가 이어지는 쪽마다 끝에 캡션 자리(캡션 높이와 간격)를 비운다. 전에는 마지막 행에서만 비워서, 앞 쪽들에 그만큼 더 많은 행을 놓고 표 뒤 글을 위에 놓았다.
쪽 수 추정이 글상자가 든 그리기 개체의 높이를 그 글을 다시 배치해 잰다. 저장된 현재 크기(
hp:curSz)는 다시 잰 높이와 한두 단위 차이일 때만 따른다. 전에는 다른 글꼴이나 글로 저장할 때 늘었던 현재 크기를 하한으로 써서, 개체를 그만큼 높게 보고 뒤 문단을 아래에 놓았다.FormFit과 쪽 수 추정이 KoPub 12종에서 악센트 붙은 라틴 문자(à, é, ā, ǎ, ạ, ế 등)와 ․, 〇, 「」, ・, ▪, ✔, Ⅺ, ➜, 々 같은 글자를 한/글이 놓는 폭으로 잰다. 전에는 글자 갈래 평균으로 재서 이런 글자가 든 줄을 한/글과 다른 곳에서 나누었다.
쪽 수 추정이 합친 칸으로 묶인 행들을 쪽 끝에서 칸마다 나눌 때, 다음 쪽에 넘어가는 칸 조각을 그 첫 문단의 위 간격 아래에서 시작한다(칸 맨 위처럼). 전에는 그 간격을 빼고 쌓아 표 뒤 글이 그만큼 위에 놓였다.
쪽 수 추정이 칸 줄 사이로 나뉘는 표의 칸을 쪽 끝에서 나눌 때, 칸 첫 문단의 위 간격만큼 줄을 내려 잰다. 전에는 그 간격을 빼고 재서, 합친 칸의 한 줄이 쪽 끝에 들어간다고 보고 그 칸을 잘라 남겼다(한/글은 칸을 통째로 다음 쪽에 넘긴다). 첫 줄을 이미 놓은 칸이 여러 쪽에 이어질 때는 그 첫 문단의 위 간격을 다시 더하지 않는다.
FormFit과 쪽 수 추정이 KoPub·KoPubWorld 돋움체·바탕체(12종)에 없는 글자를 한/글이 놓는 폭으로 잰다. ∙·∘·⋅·・·‐, 옛 한글 자모(ㆍ 등), 가나, 그리스·키릴 문자는 한/글이 KoPub 글꼴마다 같은 제 폭으로 놓는다. 전에는 글자 갈래 평균이나 글꼴 밖 값으로 재서 ∙로 시작하는 칸 문단을 한 줄 덜 나누고, 그 표가 앞 쪽에 남아 쪽 수가 줄었다.
쪽 수 추정이 합친 칸으로 묶인 행들을 쪽 끝에서 칸마다 나눌 때, 여러 문단이 든 칸의 줄을 저마다의 높이로 잰다. 전에는 칸의 줄 간격 하나로 재서, 큰 글자 줄이 섞인 칸의 다음 쪽 몫을 그만큼 낮게 보고 표 뒤 글을 위에 놓았다.
쪽 수 추정이 흐르는 표의 행을 쪽 끝에서 나눌 때 글이 가장 많이 채운 칸을 따른다. 행의 남는 공간은 그 칸 아래에 남는 만큼이다. 전에는 높이가 같으면 줄이 많은 칸을 따랐다. 그래서 다른 칸이 글자처럼 놓인 표로 꽉 찬 행을 남는 공간만큼 잘라 쪽 끝에 남겼고, 그 칸의 표 줄 대신 짧은 글 줄로 다음 쪽 몫을 쟀다. 그런 행의 첫 줄(표)이 쪽 끝 위에 들어가지 않으면 행을 통째로 다음 쪽에 넘기고(전에는 추정하지 못했다), 줄이 다 들어가지 않으면 다음 쪽 몫을 남은 줄과 선언된 남은 높이 중 큰 쪽으로 잡는다.
FormFit과 쪽 수 추정이 설치되지 않은 글꼴의 기호(∙, ○, □, →, ‐, ― 등)와 그리스·키릴 문자를 함초롬바탕 폭으로 잰다. 한/글은 찾지 못한 글꼴의 한글·라틴 문자는 한컴바탕으로 놓지만, 그 밖의 글자는 함초롬바탕 폭을 한컴바탕 단위로 옮겨 놓는다. 전에는 한컴바탕 폭으로 재서 ∙를 반 em으로 좁게 보고, ∙로 시작하는 칸 문단을 한 줄 덜 나누었다.
FormFit과 쪽 수 추정이 글자 모양의 상대 크기(
hh:relSz)를 읽는다. 한/글은 상대 크기만큼 글자를 작게(크게) 놓고 자간도 그 크기에 붙이며, 줄 높이는 글자 크기 그대로 둔다. 언어마다 상대 크기가 다르면 글자마다 제 언어 값을, 빈칸은 한글 값을 따른다. 전에는 상대 크기를 몰라 상대 크기 95%인 칸 문단을 한 줄 더 나누고, 그 표가 다음 쪽으로 밀려 쪽 수가 한 쪽 늘었다. 실험write_line_caches도 같은 폭으로 줄을 나눈다.쪽 수 추정이 표 칸 첫 문단에서 글 앞·뒤에 놓인 개체를 칸 맨 위부터 잰다. 전에는 그 문단의 위 간격만큼 더 내려 재서 행을 그만큼 높였다.
쪽 수 추정이 칸 안에 표가 든 행을 쪽 끝에서 줄 사이로 나눌 때, 각 부분을 그 첫 문단의 위 간격 아래에서 시작한다(표가 없는 칸처럼). 전에는 그 간격을 빼고 쌓아 다음 쪽의 글이 그만큼 위에 놓였다.
쪽 수 추정이 줄보다 넓은 글자처럼 놓인 표로 시작하는 문단에서, 표 뒤의 조종 문자(쪽 번호 등)를 표 다음 줄에 놓는다. 그 줄은 조종 문자 run의 크기만큼 높아지고, 표 줄의 간격에는 그 크기를 넣지 않는다. 전에는 조종 문자를 표 줄에 세어 두 줄의 높이와 간격이 함께 어긋났다.
쪽 수 추정이 글 문단 맨 위에서 위아래로 놓인 개체(표·그림·도형)를 그 문단의 위 간격보다 위에 세우고, 글을 개체 바로 아래에 놓는다. 그 개체가 든 run의 글자 크기도 글 줄 높이에 넣는다. 전에는 개체를 위 간격 아래에 세우고 줄 높이를 글자로만 재서, 그 문단 뒤 글이 간격만큼 내려가거나 줄 높이만큼 올라갔다.
저장할 때와 열기 안전 검사가 줄 배치 정보를 ‘줄이 모자란 낡은 캐시’로 판정할 때, 문단 글자의 상대 크기·장평만큼 남은 글 폭을 줄여 어림한다. 전에는 글자 크기 그대로 어림해, 상대 크기 50%처럼 작게 놓인 글자의 한/글 캐시를 낡은 것으로 보고 지우거나 열기 안전 검사에서 거부했다.
쪽 수 추정이 ‘글꼴에 어울리는 줄 높이’(
fontLineHeight) 문단 가운데 빈 문단의 줄을 글자 크기만큼으로 잡는다. 한/글은 글자가 있는 줄만 글꼴 높이(맑은 고딕 11pt는 1464)로 키운다. 전에는 빈 줄도 키워 그 아래 글이 내려갔다.FormFit이 굵은 #신명조 글자를 em의 1/20만큼 넓게 둔다(한/글 2024 측정, 한양 글꼴과 같은 규칙). 그 글꼴이 다른 글꼴에서 빌려 쓰는 그리스 문자·위아래 첨자 숫자·낮은 작은따옴표는 그대로다. 한컴 소망 M·B, HY태백B, 궁서는 측정한 라틴·그리스 폭과 앞서 있던 기호·전각 폭을 한 표로 합쳤다.
FormFit과 쪽 수 추정이 한컴·HY 글꼴 14종의 라틴 글자를 한/글 2024가 놓는 폭으로 잰다: #신명조, 양재백두체B, 양재참숯체B, 한컴 소망 M·B, 한컴 솔잎 M·B, 한컴 윤고딕 740, HY동녘B, HY수평선B, HY태백B, MD이솝체, 궁서, 태 헤드라인D. 전에는 표에 없는 글꼴이라 한컴바탕 폭으로 쟀다. 한글 음절은 지금처럼 한 em이다. 굵게는 아직 재지 않아 보통 폭으로 둔다.
쪽 수 추정이 빈칸뿐인 문단의 위아래 표가 그 쪽에서 시작하지 못하고 문단 줄마저 쪽 끝을 넘을 때, 줄을 표와 함께 다음 쪽으로 넘겨 표 아래에 놓는다. 줄이 그 쪽에 들어가면 지금처럼 줄은 남고 표만 다음 쪽 맨 위로 간다. 전에는 넘어간 줄을 다음 쪽 맨 위에 놓아 그 뒤 글이 표 높이만큼 위로 올라갔다.
쪽 수 추정이 크기 고정(
hp:sz@protect="1") 표의 행을 선언된 높이 그대로 둔다. 한/글은 칸 내용이 넘쳐도 표를 키우지 않고 넘치는 글을 잘라 두며, 쪽 끝에서는 행을 나누지 않고 통째로 넘긴다. 전에는 내용만큼 키워 그 뒤 글이 내려갔다.쪽 수 추정이 글 문단 맨 위에 위아래로 놓인 행 단위(TABLE) 표의 첫 행이 그 쪽에 들어가지 않을 때, 나뉘지 않는 표처럼 표만 다음 쪽 맨 위로 넘기고 문단 줄과 그 뒤 줄은 들어가는 데까지 그 쪽에 둔다. 다음 쪽 맨 위로 넘어간 표나 개체가 있는 쪽 뒤의 쪽 나눔은 그 다음 쪽에서 시작한다. 전에는 추정하지 못했거나 쪽 나눔 문단을 넘어간 표 아래에 두었다.
쪽 수 추정이 칸 안 문단에 글자처럼 놓인 표의 캡션(위·아래)을 그 줄 높이에 넣는다. 본문 문단에서는 이미 넣었다. 전에는 빼서 그 칸이 든 행이 선언 높이에 머물고 바깥 표 뒤 글이 캡션만큼 올라갔다.
쪽 수 추정이 여러 행을 합친 칸이 있는 흐르는 표(CELL)에서 쪽 끝에 걸린 행의 한 칸이라도 첫 줄을 그 쪽에 둘 수 없으면, 그 행의 칸들을 나누지 않고 통째로 다음 쪽에 넘긴다. 합친 칸이 없는 행은 이미 그랬다. 전에는 들어가는 칸만 첫 줄을 남겨 표 뒤 글이 올라갔다.
쪽 수 추정이 글 뒤나 가운데에 있는 글자처럼 아닌 개체(위아래 표·글 앞 그리기 개체)와 조종 문자의 run 크기를, 그 자리가 떨어지는 줄의 높이와 간격에 넣는다. 전에는 글 앞의 run만 첫 줄에 셌다. 또 크기가 섞인 문단에서 위아래로 놓인 개체의 줄을 엔진이 나눈 줄로 찾는다(전에는 한/글 줄 캐시가 없으면 첫 줄로 보았다).
쪽 수 추정이 글 문단에 위아래로 놓여 아래로 떨어진 개체(표·그리기 개체)의 세로 위치를, 개체가 첫 줄에 있으면 문단 맨 위(위 간격 위)에서 잰다. 둘째 줄부터는 지금처럼 그 줄 맨 위에서 잰다. 전에는 첫 줄도 줄 맨 위에서 재어 위 간격만큼 아래에 놓았다. 쪽 끝을 넘어 시작하는 문단은 개체와 함께 다음 쪽으로 간다.
쪽 수 추정이 빈 문단에 홀로 위아래로 놓인 표가 겹침 허용(
allowOverlap="1")이고 문단 줄 안에서 시작하면, 문단의 빈 줄을 표 아래에 놓는다. 그림·그리기 개체에 쓰던 규칙을 표에도 쓴다. 전에는 빈 줄을 표 옆에 두어 다음 문단이 한 줄 올라갔다.쪽 수 추정이 글자나 개체 뒤의 조종 문자(쪽 번호 등)를 폭 없이 그 run 크기만큼 높은 글자로 센다. 줄에 들어가는 개체 뒤면 개체 줄에 남아 그 줄 간격에 크기가 들고, 줄보다 넓은 개체 뒤면 다음 줄로 간다. 표뿐 아니라 그리기 개체도 같다. 전에는 글 뒤 개체나 그리기 개체 뒤의 조종 문자를 세지 않아 줄 수와 간격이 어긋났다.
글꼴에서 줄 높이를 받는 문단(
fontLineHeight)의 줄 높이를, 한/글 2024 데스크톱에서 잰 표(ascent·descent가 em과 다른 글꼴 20개 × 5~40pt 50단위)로 맞춘다. 표에 없는 크기는 지금처럼 ascent·descent를 올림해 더한다. 전에는 크기에 따라 한두 단위(큰 글자에선 서너 단위) 어긋났다.쪽 수 추정이 줄보다 넓은 글자처럼 놓인 표 앞에 조종 문자(쪽 번호·머리말 등) run이 있을 때, 그 줄 간격을 표 run과 앞 조종 문자 run 가운데 큰 글자 크기에서 잡는다. 전에는 표 run 크기에서만 잡아 뒤 문단이 올라갔다.
쪽 수 추정이 빈 문단에 홀로 위아래로 놓인 개체의 아래 끝이 본문 끝에 꼭 닿으면 그 쪽에 둔다(글 줄은 본문 끝에 닿으면 넘어가는 것과 다름). 전에는 문단째 다음 쪽으로 넘겼다.
쪽 수 추정이 빈 문단에 홀로 위아래로 놓인 개체(그림·그리기 개체)의 세로 위치를 문단 맨 위(위 간격 위)에서 잰다. 전에는 줄 맨 위에서 재어 위 간격만큼 뒤 문단이 내려갔다.
쪽 수 추정이 한 쪽의 두 문단이 저마다 앵커보다 뒤(다음 쪽)에서 시작하는 표를 둘 때를 배치한다. 첫 표는 다음 쪽 맨 위에서, 둘째 표는 첫 표가 끝난 쪽의 다음 쪽 맨 위에서 시작하고, 그 뒤 글은 첫 표의 끝 아래로 이어진다. 전에는 그런 문서의 쪽 수를 추정하지 않았다.
쪽 수 추정이 줄 사이로 나뉘는 표 칸에 홀로 위아래로 놓인 표의 행을, 쪽 끝에서 표 자름(101)과 그 표의 아래 바깥 여백만큼 더 위에서 끝날 때만 그 쪽에 둔다(칸 글 사이 표의 행과 같음). 전에는 글 줄처럼 쪽 끝까지 채워, 쪽 끝에 겨우 닿는 행을 한 쪽 앞에 두었다.
쪽 수 추정이 줄 사이로 나뉘는 표 칸에 홀로 위아래로 놓인 표가 셀 병합으로 이어진 행을 가질 때도 그 표를 쪽 끝에서 나눈다. 쪽 끝이 이어진 행 사이에 걸리면 본문 표처럼 칸마다 들어가는 줄을 남기고 나머지를 다음 쪽으로 넘긴다. 전에는 그런 표를 나누지 않고 통째로 다음 쪽에 넘겨 다음 쪽 글이 그만큼 내려갔다.
쪽 수 추정이 줄 사이로 나뉘는 표 칸에서 글 앞에 위아래로 놓인 표(같은 문단에 표 뒤 글)가 아래 바깥 여백이나 셀 병합으로 이어진 행을 가질 때도 그 표를 쪽 끝에서 나눈다. 행은 표 자름(101)과 아래 바깥 여백만큼 쪽 끝 위에서 끝나야 남고, 이어진 행은 칸마다 나눈다. 전에는 그런 표를 통째로 다음 쪽에 넘겼다.
쪽 수 추정이 칸마다 나뉘는 표(CELL)의 첫 행에서 한 줄도 앵커 아래에 들어가지 않으면, 행 단위로 옮기는 표처럼 그 표를 다음 쪽 맨 위에서 시작하고 뒤 글은 앵커 줄 아래에 이어 둔다. 전에는 그 표가 이 쪽에서 흐르는 것으로 보아 뒤 글을 다음 쪽 표 아래로 보냈다.
쪽 수 추정이 줄 사이로 나뉘는 표 칸 안 표의 행이 또 표를 품을 때도 그 표를 쪽 끝에서 나눈다. 품은 표가 홀로 놓여 나뉘면 그 조각 사이에서, 글자처럼 놓인 표면 그 줄 사이에서 나누고, 행 안에서 끝나는 조각은 그 행의 아래 칸 여백과 품은 표의 표 자름까지 쪽 끝 위에 남긴다. 전에는 그런 표를 통째로 다음 쪽에 넘기거나 쪽 끝에 넣었다.
쪽 수 추정이 한/글이 쪽 끝에서 나눈 표 칸(줄 캐시가 나뉜 부분마다 맨 위에서 다시 시작)에서도, 칸 안 표가 조각으로 나뉘는 행의 높이를 그 줄과 조각의 높이 합보다 낮게 잡지 않는다. 전에는 캐시대로 재어 행이 짧아져, 넘치는 표를 한 쪽에 넣고 쪽 수가 하나 적었다.
쪽 수 추정이 줄 사이로 나뉘는 표 칸 안 표의 다음 쪽으로 이어지는 부분을 그 표의 위 바깥 여백 아래에서 다시 시작한다(본문 표와 같음). 전에는 그 여백을 빼고 이어 붙여 다음 쪽 글이 그만큼 위에 놓였다.
쪽 수 추정이 줄 사이로 나뉘는 표 칸 안 표의 행이 글보다 높게 선언돼 남는 공간이 있으면, 글이 쪽 끝 위에 들어갈 때 그 행을 그 쪽에 두고 남는 공간을 쪽 끝에서 자른다(본문 표의 행과 같음). 전에는 행 전체가 들어가야 남겨, 그 행을 한 쪽 뒤로 넘겼다.
[6.10.0] - 2026-10-28
문서를 고치는 공개 동사를 더하고, 한/글 수식을 LaTeX로 되돌리는 변환과 쪽 수 추정·FormFit을 한/글에 더 가깝게 맞춘
릴리스입니다. 지금까지 헤더 내부 메서드나 ZIP·XML을 직접 다뤄야 했던 일에 공개 API가 생겼습니다. 스타일·문단 모양을 만들고
번호 정의를 읽는 doc.styles.ensure_style()·ensure_paragraph_format()·numberings, 언어마다 글꼴을 주는
ensure_run(font_by_lang=...), 패키지 글 치환 hwpx.patch.replace_package_text(), 표 계산식과 책갈피를 읽는
doc.fields.formulas·doc.refs.bookmarks입니다. eqedit_to_latex가 한/글 수식의 글꼴 전환 rm·it·bold를
LaTeX 글꼴로 읽어, 원안지 수식을 되돌렸다가 다시 쓸 때 전환이 글자로 찍히던 문제(#582)를 고쳤습니다. 이 때문에
{rm "d"} x처럼 rm이 중괄호 밖까지 이어지는 스크립트의 LaTeX 결과가 6.9.0과 다릅니다. FormFit과 쪽 수 추정은
기울임, Windows 영문 글꼴 11종, 한자·한컴돋움 기호·그림 글머리표의 폭과 줄 격자·구역 바뀜·칸 안 표 배치를 한/글
저장본에 맞췄습니다. 그래서 FormFit이 고르는 글자 크기와 줄 수, 쪽 수 추정 결과가 6.9.0과 달라질 수 있습니다. 코어는 6.9.0보다 약
3천7백 줄(4.1%) 늘었는데, 대부분 FormFit의 글꼴 폭 표(약 2,300줄, Windows 영문 글꼴과 기울임 폭)와 쪽 수 추정(약
600줄)입니다. import hwpx가 읽는 모듈 수는 99개로 그대로입니다. 저장 성공만으로 시각 품질을 보증하지 않습니다.
추가
doc.styles.ensure_style()·doc.styles.ensure_paragraph_format()·doc.styles.numberings/numbering()을 공개한다. 스타일 이름으로hh:style을 보장하고(같은 이름이면 다시 쓴다), 문단 모양 id를 만들고, 번호 정의를 읽는다. 지금까지는 헤더 객체의 내부 메서드(_styles_element·_allocate_ref_id·_update_item_count)를 불러야 했다. 헤더가 없으면document-header-missing으로 거부한다.hwpx.patch.replace_package_text()와hwpx.tools.repair.normalize_package_namespaces()를 공개한다. 앞의 것은 패키지의.xml·.hpfpart에서 텍스트 노드만 치환하고(속성·주석·CDATA는 그대로) 바뀐 part의 줄 캐시를 지운다. 뒤의 것은repair_repack의 namespace 정규화만 한다. 둘 다 open-safety 게이트를 통과할 때만 출력 파일을 쓴다. 앞의 것이 돌려주는PackageTextReplaceResult는 다른 바이트 쓰기 결과처럼as_mutation_report()로 변경 보고(hwpx.mutation-report/v1)를 낸다. ZIP·XML을 직접 고치던 플러그인 지원 스크립트(zip_replace_all.py·fix_namespaces.py)가 이 둘에 위임한다.doc.styles.ensure_run(font_by_lang=...)로 언어마다 다른 글꼴을 쓰는 글자 모양을 만든다(예:{"HANGUL": "함초롬바탕", "LATIN": "Arial"}). 기준 글자 모양을 복사해, 언어마다 그 글꼴을 그 언어 블록에 등록하고(없으면 더한다) 그 블록의 id로fontRef를 맞춘 뒤, 내용이 같은 글자 모양이 있으면 그것을 다시 쓴다. 이름을 대지 않은 언어와 크기·색·굵기는 기준을 따르고, 기준과 다른 글자가 함께 쓰는 글자 모양은 바뀌지 않는다.font와 함께 주면font_by_lang이 댄 언어는font_by_lang을 따른다. 모르는 언어(style-font-lang-invalid), 빈 글꼴 이름(style-font-face-empty), 매핑이 아니거나 같은 언어를 두 번 댄 값(style-run-font-by-lang-invalid)은 아무 글꼴도 등록하기 전에 거부한다. (#564)(실험)
write_line_caches(doc)가 줄 배치 정보를 쓰는 문단을 넓힌다. 이 함수를 부른 뒤.hwp로 저장하면 아래 그림 문단도PARA_LINE_SEG를 얻어, 이 레코드로 그림 자리를 찾는 다른 HWP 뷰어가 그림을 그린다.글자처럼 놓인 그림 하나만 든 문단: 캡션이 있는 그림(위·아래 캡션은 캡션의 줄과 간격만큼 줄이 높고, 옆 캡션은 그림 높이 그대로), 부드러운 가장자리나 안쪽 그림자가 있는 그림, 줄 간격이 고정·최소·줄 사이인 문단(간격은 그림 줄 높이에서 센다), 글자를 줄의 위·가운데·아래에 놓는 문단.
글자처럼 놓인 그림 여럿만 든 문단: 단 폭에 드는 만큼 한 줄에 놓고, 줄마다 그 줄의 가장 큰 그림 높이로 쓴다. 줄 간격에 영향을 주는 그림이 있거나 줄 간격이 비율이 아닌 문단은 쓰지 않는다.
너비가 같은 보통 다단 구역: 글 문단과 그림 문단을 그 단의 폭으로 쓴다. 구역 중간에서 단이 바뀌면 문단이 놓인 단의 폭으로 쓴다(전에는 구역 첫 단의 폭으로 쟀다). 고른 배분·평행 다단과 너비가 다른 단은 쓰지 않는다.
글이 개체 옆으로 흐르는 구역: 전에는 구역 전체를 건너뛰었지만, 이제 그 개체를 품은 문단이 놓인 쪽과 다음 쪽만 뺀다.
빛남·바깥 그림자·반사처럼 그림 둘레에 자리를 차지하는 효과가 있는 그림과 그리기 개체의 그림자(
hp:shadow)가 있는 그림, 줄 나눔이 확실하지 않은 캡션이 달린 그림은 쓰지 않고 한/글에 맡긴다.
쪽 수 추정이 뒤 문단의 구역 설정(
hp:secPr)을 따른다. 한/글처럼 그 문단에서 새 구역이 새 쪽에서 그 설정으로 시작하고, 첫 문단에 구역 설정이 없으면 그 앞 문단들은 한/글 기본 용지(A4 59528×84188, 기본 여백, 한 단)에 놓인다. 전에는 추정하지 않았다. 실험write_line_caches는 이런 구역에 줄 배치 정보를 쓰지 않는다.쪽 수 추정이 줄 격자(
hp:grid@lineGrid)를 따른다. 격자에 맞추는 문단(snapToGrid)은 줄 높이·줄 간격과 문단 위아래 간격이 각각 격자 칸 단위로 올림되고, 첫 줄은 놓일 자리에서 다음 격자 줄로 내려간다. 글자 격자(charGrid)는 모든 문단에 한/글 줄 배치 정보가 있을 때만 따른다. 격자 구역에 표·개체·주석이 있거나 단이 여럿이면 아직 추정하지 않는다.쪽 수 추정이 본문 아래 각주(
beneathText)와 구역 끝 미주(END_OF_SECTION)를 따른다. 본문 아래 각주는 쪽 아래 각주와 같은 자리를 차지하고, 구역 끝 미주는 그 구역 본문 뒤, 다음 구역 쪽 앞에 놓인다.쪽 수 추정이 표 칸 안에서 글 사이나 글 뒤에 놓인 표, 어울림 표, 글 뒤·앞에 놓인 표를 한/글 줄 배치 정보 없이도 배치한다. 전에는 이런 칸을 추정하지 않았다(
a nested table). 한/글처럼 표는 조종 문자가 놓인 줄(칸 폭 전체로 나눈 줄)의 위에 서고, 아래 오프셋만큼 내려간다(위 오프셋은 0). 위아래 표는 그 줄부터 표와 캡션 아래로 밀고, 옆 자리가 있는 어울림 표는 그 옆 줄을 좁히며, 글 뒤·앞 표는 줄을 밀지 않고 칸을 표 아래 끝까지 늘린다. 쪽 끝에서는 한/글처럼, 표가 들어가는데 그 아래 줄이 넘치거나 표 위끝이 이미 쪽 아래를 넘으면 표가 그 줄과 함께 다음 쪽으로 가고, 표가 걸치면 쪽 아래에서 101 위(아래 캡션이 있으면 그만큼 더 위)까지 끝나는 행만 남기고 나머지 행과 그 아래 줄을 다음 쪽 맨 위로 보낸다. 남는 행이 없으면 표만 다음 쪽 맨 위로 가고, 들어가는 기준 줄은 제자리에 남는다. 쪽 끝이 어울림·글 뒤·앞 표, 여러 줄 행, 행 합치기 표(글 앞에 놓인 표는 전처럼 줄과 함께 넘긴다)를 가로지르거나 표만 옮긴 뒤 다음 줄들이 그 쪽에 들어가는 경우는 아직 추정하지 않는다. 실험write_line_caches는 이런 칸과 그 표를 담은 문단에 지금처럼 줄 배치 정보를 쓰지 않는다.doc.fields.formulas가 한/글이 저장한 표 계산식(hp:fieldBegin type="FORMULA")을 문서 순서로 읽는다. 본문 표와 칸 안의 표를 보고, 계산식마다FormulaField(식formula, 표시 형식result_format, 한/글이 마지막으로 계산한 값last_result,command, 문서에 보이는 글value, 칸의(행, 열)cell_address, 위치)를 돌려준다. 값은 한/글이 적은 그대로이고 다시 계산하지 않는다(=SUM(?1:?3)의?같은 표기도 그대로). 지금까지는 계산 결과 글만 보이고 어느 칸이 계산식인지는ObjectFinder로 XML을 찾아야 알았다. (#578)doc.refs.bookmarks가 문서의 모든 책갈피를 문서 순서로 낸다(표 칸과 개체 안 포함). 한/글이 책갈피를 저장하는 두 형태를 함께 보고, 책갈피마다Bookmark(이름, 형태kind:"point"=hp:bookmark·"field"=fieldBegin type="BOOKMARK", 필드 형태의 시작과 끝 사이 글text, 위치)를 돌려준다. (#579)
고침
쪽 수 추정에서 미주의 마지막 줄 아래 줄 간격을 세지 않는다. 한/글은 한 줄 미주를 글 높이만큼씩 붙여 쌓는다. 그래서 미주가 많은 문서의 쪽 수가 전보다 적게 나올 수 있다.
eqedit_to_latex가 한/글 수식의 글꼴 전환rm·it·bold(대문자 포함)를 낱말로 남기던 문제를 고쳤다. 원안지 수식을 LaTeX로 되돌린 뒤latex_to_eqedit로 다시 쓰면 그 낱말이 따옴표 글이 되어 한/글이 글자로 찍었다(AB = ita). 이제 한/글이 그리는 대로 읽는다.rm뒤 영문자는it까지 정자(\mathrm{…})다. 중괄호·첨자·분수·근호·LEFT/RIGHT·행렬 밖으로도 이어지고, 그리스 문자는 그대로다.bold는 바로 다음 덩어리만 굵게 한다(\boldsymbol{…},rm뒤면\mathbf{…}). 뒤에 곧바로rm·it이 오면 굵게는 그 전환에 쓰인다. 예:rm {bar{BC}}→{\bar{\mathrm{BC}}},{vec{rm AB}} = it {vec{a}}→{\vec{\mathrm{AB}}} = {\vec{a}},5 rm cm→5 \mathrm{cm},bold x→\boldsymbol{x}. 정규 저작 모양({rm "…" it}·{rm {bold X} it})과 따옴표로 감싼 식별자(e ^{"it"})는 전과 같이 읽는다. 계약이 바뀐 곳은 다음과 같다.{rm {bold {v}}} w·{rm "d"} x·rm text는 전에는 그대로 돌려줬지만, 이제{\mathbf{v}} \mathrm{w}·{\text{d}} \mathrm{x}·\mathrm{text}로 읽는다. 한/글에서rm이 중괄호 밖까지 이어지기 때문이다. 변하지 않는 곳도 있다. 글자에 붙은 전환(rmA·itab)은 전처럼 한 식별자로 둔다. 따옴표 글에 건bold는 LaTeX에서 굵게를 잃는다. 근거는 macOS 한/글로 렌더한 합성 탐침 30개이며, 원본과 왕복한 스크립트가 같게 그려지는 것을 확인했다(따옴표 글에 건bold1건만 다르다). (#582)latex_to_eqedit가\boldsymbol{X}를{bold {X}}로 쓴다(굵은 기울임, 뒤로 이어지지 않는다). 전에는UnsupportedLatexError로 거부했다. (#582)Paragraph.bookmarks가hp:fieldBegin type="BOOKMARK"로 저장된 책갈피를 놓치던 문제를 고쳤다. 한/글로 저장한 문서에서 책갈피가 모두 이 형태이면 문서에 책갈피가 없는 것처럼 보였다. 이제hp:bookmark와 이 형태를 문단 안 순서대로 함께 낸다. (#579)paragraph.add_run(..., expand_special_characters=True)가 탭과 단독 CR("\r")을 지우던 문제를 고쳤다. 이제 이 옵션을 켜도 끈 것과 같이 탭은hp:tab, 줄바꿈("\n"·"\r\n"·"\r")은 하나마다hp:lineBreak로 쓰고, 옵션은 줄바꿈 없는 공백(U+00A0)과 전각 공백(U+3000)을hp:nbSpace·hp:fwSpace로 바꾸는 일만 더한다. (#563)FormFit과 쪽 수 추정이 기울임(
hh:italic)을 읽는다. 한/글 2024는 한양중고딕·한양신명조·한양견고딕·HCI Poppy의 기울임을 따로 된 기울임 글꼴 폭으로 놓아(한양신명조 기울임 “f” 10pt는 240, 보통은 352) 영문·숫자·문장 부호가 보통 글자와 폭이 다르다. 한글 음절은 그대로이고, 한양 글꼴의 굵은 기울임은 굵게처럼 em/20 넓다. 그 밖의 글꼴(함초롬·맑은 고딕·바탕 계열 등)은 제자리에서 기울여 폭이 그대로다. 전에는 기울임을 몰라 보통 폭으로 쟀다. Times New Roman·Cambria처럼 설치된 기울임 글꼴을 쓰는 영문 글꼴은 아래 항목에서 보통 폭과 함께 넣었다.실험
write_line_caches가 한양 글꼴과 HCI Poppy의 기울임 글자가 든 문단, HCI Poppy의 굵은 글자가 든 문단에 줄 배치 정보를 쓰지 않고 한/글에 맡긴다. 이 글자들은 한/글이 보통 글자와 다른 폭으로 놓는데 전에는 보통 폭으로 줄을 나눠 썼다.FormFit과 쪽 수 추정이 Windows 영문 글꼴 11종(Times New Roman·Arial·Cambria·Constantia·Calibri·Georgia·Verdana·Tahoma· Segoe UI·Consolas·Courier New)을 한/글 2024가 놓는 폭으로 잰다. 전에는 표에 없는 글꼴이라 한컴바탕 폭으로 쟀다(Times New Roman “a” 10pt는 444인데 500으로). ASCII·라틴-1·라틴 확장-A·그리스 글자와 따옴표·대시·말줄임표 같은 기호를 글꼴마다 넣었다. 기울임은 한/글이 설치된 기울임 글꼴로 놓아 폭이 다르고(Times New Roman 기울임 “f”는 276, 보통은 332), 굵게는 보통 글자를 굵게 그려 폭이 그대로다. 이 글꼴로 쓴 한글 음절은 한 em이다.
실험
write_line_caches가 위 영문 글꼴을 라틴·기호 글꼴로 쓴 문단(한글 글꼴은 지금처럼 줄 캐시가 믿는 글꼴)에도 보통·굵게· 기울임 모두 줄 배치 정보를 쓴다. 영문 글꼴이 한글 글꼴이기도 한 문단은 지금처럼 한/글에 맡긴다.쪽 수 추정이 칸 안 표의 캡션(위·아래) 자리를 센다. 글 앞에 놓인 위아래 표와 빈 문단에 홀로 놓인 위아래 표는 전에 캡션 없이 표 높이만 쟀다.
쪽 수 추정이 한/글 줄 배치 정보가 있는 칸에서 글 뒤·앞에 놓인 표만큼 칸을 늘리고, 글 사이·뒤에 놓인 표를 조종 문자가 놓인 줄의 위에서 잰다. 다음 쪽에서 표와 함께 다시 시작한 줄은 그 표 자리를 가지고 간다. 한/글이 쪽 끝에서 나눠 저장한 칸 안 표(표 높이가 행보다 낮음)는 추정하지 않는다.
FormFit과 쪽 수 추정이 그리스 위 점(U+0387, 낱말 사이 가운뎃점으로도 쓰임)을 한/글처럼 잡는다. 전에는 문장 부호 평균 폭(0.42 em)으로 쟀다. 글꼴에 그 글자가 없으면 약 0.16 em(1000 단위 글꼴 161, 1024 단위 글꼴 165, 휴먼 글꼴 164), 있으면 글꼴 폭(바탕 321/1024, 굴림·궁서·돋움·새굴림 320/1024, 바탕체·굴림체·궁서체·돋움체 반 em, 한양신명조· 한양중고딕 313/1000)이다. 한양 글꼴에서 굵게여도 넓어지지 않는다.
FormFit과 쪽 수 추정이 한컴돋움의 기호를 한/글 2024처럼 잡는다. 한/글 2024는 한컴돋움의 영문(ASCII·라틴-1·라틴 확장-A·곡선 따옴표)과 몇 글자만 글꼴 폭으로 놓고, 기호·그리스·키릴·전각 문자는 함초롬돋움 폭으로 놓는다. 전에는 글꼴 파일의 폭을 써서 “※”·”「” 같은 글자를 1 em, “∘”을 반 em으로 쟀다(한/글은 0.77·0.5·0.97 em).
FormFit과 쪽 수 추정이 한컴 윤고딕 250을 한/글 2024처럼 잰다. 한컴오피스 2024에 들어 있는 글꼴이라 한/글은 이 글꼴의 폭으로 놓는데(한글 음절 0.9 em, 영문·기호는 글꼴 폭, 없는 글자는 함초롬돋움 폭), 전에는 표에 없는 글꼴로 보아 한컴바탕 폭(한글 1 em)으로 쟀다. 키릴 문자는 아직 한/글과 다를 수 있다.
FormFit과 쪽 수 추정이 그림 글머리표(
hh:bullet@useImage)의 자리를 한/글처럼 잡는다. 한/글은 그림 모양과 상관없이 그림을 글자 하나(1 em)로 놓고 그 뒤에 간격(textOffset)과 폭 조정(widthAdjust)을 더해 첫 줄에서 빼고, 자동 내어 쓰기면 다음 줄에서도 뺀다. 전에는 자리를 차지하지 않는다고 보아, 글머리표 문단의 줄이 한/글보다 길게 나뉘었다. 그림 크기를 따르는 글머리표(useInstWidth)는 아직 자리를 재지 않으며, 실험write_line_caches는 그런 문단에 줄 배치 정보를 쓰지 않는다.쪽 수 추정과 실험
write_line_caches가 탭을 그 문단이 든 구역의 기본 탭 간격(hp:secPr@tabStopVal)으로 놓는다. 전에는 모든 구역을 4,000(한/글 기본값)으로 셌다. HWPUNIT이 아닌 단위로 준 구역에는 줄 배치 정보를 쓰지 않는다.FormFit과 쪽 수 추정이 한자 폭을 한/글처럼 잰다. 한/글은 글꼴과 상관없이 한자를 1 em으로 놓되, 한글 음절처럼 글자 크기의 4분의 1 단위로 맞추고 장평·자간을 그 단위로 줄인다(10pt 장평 95에서 948, 10.5pt에서 1,048). 굵게여도 넓어지지 않는다. 전에는 1 em에 장평을 곱한 값을 반올림 없이 썼다. 한양신명조·한양중고딕 굵게는 글꼴에 있는 한자만 넓어져서 아직 다를 수 있다.
[6.9.0] - 2026-10-23
쪽 수 추정과 FormFit의 글자 폭·줄 나눔을 한컴오피스 2024의 한/글에 맞춘 릴리스입니다. 한양·HCI·KoPub 글꼴과
굵은 글자, 장평·자간, 위·아래 첨자, 탭·빈칸·문장 부호의 줄 끝 처리, 표·그림·캡션·미주의 배치를 한/글 저장본에 맞춰
고쳤습니다. 그래서 FormFit이 고르는 글자 크기와 줄 수, 쪽 수 추정 결과가 6.8.0과 달라질 수 있습니다. 실험 기능
hwpx.layout.line_cache.write_line_caches가 새로 들어왔습니다. 한/글이 저장할 줄 배치 정보를 한/글과 같은 값을 확실히
아는 문단에만 쓰며, 부르지 않으면 지금처럼 쓰지 않습니다. 이 함수를 부른 뒤 .hwp로 저장하면 줄 배치 정보로 그림 자리를
찾는 다른 HWP 뷰어도 그림을 그립니다(#550). 글의 줄바꿈("\n")은 한/글처럼 hp:lineBreak로 씁니다. add_section()
뒤에 넣은 그림이 매니페스트에서 빠지던 문제(#549)를 고쳤습니다. 표 구조 편집(열 넣기, 칸 나누기, 표 객체의 행·열 편집)과
doc.tables[i]가 더해졌습니다. 코어는 6.8.0보다 약 7천3백 줄(8.7%) 늘었는데, 대부분 FormFit의 글꼴 폭 표(약 3,900줄)와
쪽 수 추정·줄 배치 정보(약 1,500줄)입니다. 저장 성공만으로 시각 품질을 보증하지 않습니다.
추가
(실험)
write_line_caches(doc)가 글자처럼 놓인 그림만 든 문단에도 한/글이 쓰는 한 줄을 쓴다(#550). 줄 높이와 글 높이는 그림 높이와 바깥 여백(글자가 더 크면 글자 크기), 기준선은 그 85 %, 줄 간격은 문단 글자 기준이다. 캡션·그림자· 효과가 있는 그림과 줄 간격이 비율이 아닌 문단은 쓰지 않는다. 이 함수를 부른 뒤.hwp로 저장하면 줄 배치 정보가 문단의PARA_LINE_SEG로 들어가, 이 레코드로 그림 자리를 찾는 다른 HWP 뷰어도 그림을 그린다. 부르지 않으면 지금처럼 줄 배치 정보 없이 저장하고 한/글이 열 때 배치한다.쪽 수 추정이 문서 끝 미주를 따른다. 미주는 본문 마지막 줄 바닥 아래에 미주 영역의 위 간격·구분선·아래 간격을 두고 줄마다 이어지며 쪽 끝을 넘어간다. 각주가 자리를 차지한 쪽 뒤에서는 다음 쪽에서 시작한다. 전에는 미주가 있으면 추정하지 않았다. 구역 끝 미주와 여러 단 구역 뒤 미주는 아직 추정하지 않는다.
(실험)
hwpx.layout.line_cache.write_line_caches(doc)가 글만 든 문단에 한/글이 저장할 때 쓰는 줄 배치 정보 (hp:linesegarray)를 쓴다. 줄 높이·글 높이·기준선·줄 간격은 한/글이 쓰는 값 그대로, 줄 시작·위치·폭은 쪽 수 추정이 놓는 대로이고, 탭에는 한/글이 배치한 폭을 쓴다.쓰는 문단: 단이 하나이고 글이 개체 옆으로 흐르지 않는 구역의, 개체·사용자 탭 정의가 없는 문단. run마다 글꼴이 달라도 되고, 글자 크기가 섞이면 줄마다 가장 큰 글자의 높이로 쓴다. 내어 쓰는 번호·글머리표와 머리말·꼬리말· 쪽 번호처럼 줄에 자리를 차지하지 않는 컨트롤은 된다.
그 구역 표의 칸도 칸 안 문단이 모두 그런 문단이면 쓴다. 글자처럼 놓인 표만 든 문단에는 표 높이의 한 줄을 쓰고, 표의
hp:sz높이도 행 높이의 합으로 쓴다. 표 위·아래 캡션은 그 줄 높이와 간격만큼 표의 줄에 더한다(옆 캡션은 더하지 않는다).글자 크기보다 큰 빈 run으로 끝나는 문단은 마지막 줄의 글 높이도 그 크기로 쓴다. 기준선은 문단 모양의 세로 정렬대로 글꼴 기준이면 글 높이의 85 %, 위면 0, 가운데면 절반, 아래면 글 높이 그대로 쓴다.
한/글은 줄이 어디서 나뉘는지도 배치 정보를 따르므로, 줄 나눔이 덜 확실한 문단은 쓰지 않는다: 한컴오피스 2024 데스크톱에서 폭을 확인한 글꼴(함초롬·맑은 고딕·바탕·돋움·굴림·궁서·한컴 고딕·HY헤드라인M 등·휴먼·한양·HCI)이 아니거나, 굵은 글자가 HCI Hollyhock이거나, 장평 50~200 %·자간 −30~30 %·최소 공백 50 % 밖이거나, 최소 공백이나 자간이 있는 문단에 묶음 빈칸이 있거나, 한글 음절과 확인한 기호 밖의 글자가 든 문단, 쪽 컨트롤이 글자 뒤에 있는 문단, 글자 폭 표에 없는 글자나 한 줄보다 긴 낱말이 든 문단, 줄 폭을 100 HWPUNIT 좁히거나 넓히면 줄 나눔이 바뀌는 문단, 탭 앞 글이 탭 정지 위치에서 줄 처음이나 앞 탭 정지부터 센 글자 수 × 4 HWPUNIT(배치 단위, 많아야 100) 안쪽인 문단.
나머지 문단과 이미 배치 정보가 있는 문단은 그대로 두어 한/글이 열 때 배치한다. 쪽 수 추정이 문서를 따르지 못하면 아무것도 쓰지 않는다. 기본 저장은 바뀌지 않는다.
그림을 만들 때(
doc.add_picture,paragraph.add_picture) 그림 효과와 테두리를 줄 수 있다.brightness(밝기)·contrast(대비): -100~100.effect:REAL_PIC(원래 그림)·GRAY_SCALE(회색조)·BLACK_WHITE(흑백), 대소문자 무관.alpha(투명도): 0(불투명)~255(보이지 않음).line_color를 주면 실선 테두리를line_width(HWPUNIT, 기본 33) 굵기로 두른다.한/글은 이 범위 밖의 값을 그대로 그리지 않는다(밝기는 끝값처럼, 대비는 색이 뒤집히거나 회색으로, 투명도 256은 0으로, 다른 효과는 원래 그림으로). 그런 값은 문단·그림을 더하기 전에
shape-picture-image-value·shape-picture-border-value로 거부한다.crop=(왼쪽, 위, 오른쪽, 아래)는widthxheight그림의 네 변에서 그만큼(HWPUNIT) 잘라 낸다. 한/글처럼 축척은 그대로라 그림은width - 왼쪽 - 오른쪽xheight - 위 - 아래로 그려진다. 0 이상의 int 네 개가 아니거나 그림을 다 잘라 내면shape-picture-crop-value로 거부한다.shadow=PictureShadow(...)는 그림자를,glow=PictureGlow(...)는 빛남을 그린다(hwpx.oxml에서 가져온다). 그림자는 색·투명도(0~1)·흐림·방향(오른쪽에서 시계 방향 0~359도: 0 오른쪽, 90 아래)·거리·안쪽 여부를, 빛남은 색·투명도·반경을 받는다(길이는 HWPUNIT). 한/글은 그림을 그 효과까지 합친 크기로 배치하므로, 글자처럼 취급한 그림은 줄이 그만큼 높아진다. 범위 밖의 값은shape-picture-effect-value로 거부한다.soft_edge(HWPUNIT)는 그림 가장자리를 그만큼 안쪽부터 흐리게 하고,reflection=PictureReflection(...)은 그림 아래에 반사를 그린다(크기: 그림 높이의 0 초과 1 이하, 거리, 시작·끝 투명도 0~1, 흐림). 부드러운 가장자리는 자리를 차지하지 않고, 반사는 대략 크기만큼의 그림 높이와 거리만큼 아래로 자리를 차지한다.
FormFit과 쪽 수 추정이 한컴 글꼴 8종의 글자 폭을 안다: HCI Poppy·HCI Hollyhock·한양중고딕·한양신명조·한양견고딕· 휴먼옛체(한/글이 배치하는 폭)와 HY견명조·HY동녘M(글꼴의 설계 폭, 글꼴에 없는 글자는 함초롬바탕의 폭). 전에는 한글 아닌 글자에 글자 종류의 평균 폭을 썼다. 한글 음절은 모두 한 em이다. 이 글꼴로 쓴 칸의 채우기 결과와, 줄 배치 정보가 없는 문서의 쪽 수가 달라질 수 있다.
FormFit과 쪽 수 추정이 KoPub 글꼴 12종도 글꼴의 설계 폭으로 잰다: KoPub돋움체·KoPub바탕체·KoPubWorld돋움체· KoPubWorld바탕체의 Light·Medium·Bold. 전에는 글자 종류의 평균 폭을 썼다. 한글 음절은 모두 같은 폭이고(돋움체 872/1000, 바탕체 936/1000), 다른 글자도 글꼴의 폭을 쓴다. 이 글꼴로 쓴 칸의 채우기 결과와, 줄 배치 정보가 없는 문서의 쪽 수가 달라질 수 있다.
묶음(
doc.shapes.add_container)에 선·글상자·그림·묶음 안 묶음 부재를 더한다:ContainerMember.line,ContainerMember.text_box,ContainerMember.picture,ContainerMember.group.선은 두 끝 중 왼쪽 위에 놓이고, 두 끝을 그 모서리 기준으로 지닌다.
글상자는 사각형에
set_draw_text와 같은 글을 담는다(이름·편집 가능·여백·글자 모양·문단 모양·세로 정렬). 글은 묶음이 구역에 들어간 뒤 쓰여 문단 id가 구역에서 겹치지 않는다. 잘못된 세로 정렬은 문서를 바꾸기 전에 거부한다.그림은
doc.media.add_image가 돌려준 이진 항목을 받아 주어진 크기에 그린다. 이진 항목이 비면shape-container-picture-image로 거부한다.묶음 안 묶음은 꼬리(
sz·pos·outMargin·shapeComment) 없는 부재다. 모든 깊이의 도형은 가장 바깥 묶음의 좌표에 놓인다. 한/글은 각 도형을 그 좌표의 자기transMatrix에 그리므로, 안쪽 묶음 좌표에 둔 도형은 바깥 묶음의 왼쪽 위에 겹쳐 그려진다.한/글이 저장한 묶음처럼 모든 부재는
id·zOrder0,numberingType="NONE"이고,groupLevel은 깊이다 (1, 2, 3…).묶음은 부재를 복사해 조립한다. 넘긴
ContainerMember는 바뀌지 않으므로 같은 부재를 여러 묶음이나 한 묶음에 다시 써도 된다.
표 구조 편집(
hwpx.table_patch.apply_table_ops)에 열 삽입insert_column_by_clone을 더한다. 격자 열ref_col의 오른쪽(side: "left"면 왼쪽)에 그 열을 복제한 열count개를 넣는다.새 열은 기준 열과 같은 폭이고, 표는 그만큼 넓어진다. 본문 폭을 넘어도 줄이지 않는다.
새 칸은 같은 행 기준 칸의 테두리·문단 모양·글자 모양을 따른다. 글은 행 삽입(
insert_row_by_clone)처럼 복제하고,blank: true면 한/글처럼 빈 문단 하나만 둔다.개체 ID·필드·책갈피·로컬 참조가 있는 내용을 그대로 복제하면 거부한다. ID를 중복시키지 않으며, 빈 칸 삽입은 사용할 수 있다. 기존 행 복제도 같은 거부 계약을 따른다.
새 열을 가로지르는 합친 칸은 그 열만큼 colSpan과 폭이 는다. 기준 열에서 끝나는(왼쪽이면 시작하는) 합친 칸 옆에는 그 칸 서식의 빈 칸이 들어가고, 기준 열에서 세로로 합친 칸은 같은 행들에 걸쳐 복제된다.
칸 영역(
hp:cellzone)의 열 주소도 함께 옮긴다.
행 삽입
insert_row_by_clone이side: "above"(기준 행 위)와blank: true(한/글처럼 빈 문단 하나)를 받는다.새 행은 기준 행과 같은 높이이고, 새 칸은 같은 열 기준 칸(열을 합친 칸 포함)의 서식을 따른다.
위쪽 삽입에서 새 행을 가로지르는 합친 칸은 rowSpan이 는다. 기준 행에서 시작하는 세로 합친 칸 위에는 그 칸 서식의 빈 칸이 들어간다(아래쪽 삽입에서 기준 행에서 끝나는 칸과 같은 규칙).
칸 나누기
split_cell(한/글의 셀 나누기)을 더한다. 칸의 주소(row,col)와rows·cols(2~63)를 받는다.세로만 나누는 경우에도 정확한 앵커 주소가 필요하다. 합친 칸의 피복 주소·범위 밖 주소는 문서를 바꾸지 않고 거부한다.
열로: 칸 폭을 똑같이 나누고(나머지는 마지막 칸), 새 격자 선을 넣는다. 다른 칸은 폭은 그대로 두고, 덮는 열만큼 colSpan이 는다.
나눈 칸이 한/글이 그리는 가장 좁은 열(칸의 왼쪽·오른쪽 안 여백 + 283)보다 좁으면 그 폭으로 쓴다. 칸 오른쪽의 격자 선과 표 폭은 늘어난 만큼 옮긴다.
줄로: 칸이 덮는 행이 똑같이 나뉘면 그 행들에 나누고, 아니면 한 행씩 나누고 모자라는 행을 칸의 마지막 행 뒤에 더한다. 그 행 옆 칸은 새 행까지 덮는다. 칸의 저장 높이는 똑같이 나눈다.
글은 첫 칸에 남고, 나머지 칸에는 그 칸 서식의 빈 문단 하나를 둔다. 칸 영역은 덮던 자리를 그대로 덮는다.
표 객체(
hwpx.model.Table)에 행·열 구조 편집을 더한다:insert_rows(위·아래),insert_columns(왼쪽·오른쪽),delete_rows,delete_columns,split_cell.doc.tables에도 같은 이름이 있다(첫 인자로 표).apply_table_ops의 같은 편집과 같은 규칙(한/글의 줄/칸 추가하기·지우기, 셀 나누기)을 따른다. 새 칸은 기준 칸의 글을 복제하고,blank=True면 그 칸 서식의 빈 문단 하나만 둔다.편집하면 표를 담은 문단의 줄 캐시를 지운다. 편집 전에 얻은 셀·행 객체는 표에 속하지 않으니 다시 얻는다.
doc.tables를 번호로 꺼낼 수 있다:doc.tables[0],doc.tables[-1],doc.tables[1:3](문서 순서,doc.tables.all[...]와 같다). 범위 밖이면IndexError.
바꿈
글에 든 줄바꿈(
"\n"·"\r\n"·"\r")을 한/글이 쓰는 대로hp:t안의<hp:lineBreak/>로 쓴다.add_paragraph·paragraph.text =·add_run·cell.text =·run.text =·paragraph_patch·apply_body_ops의replace_text가 다 그렇다. 전에는add_run이 줄바꿈 문자를 글에 그대로 두었고(expand_special_characters=True일 때만 요소로 썼다),paragraph_patch는 줄바꿈이 든 글을 건너뛰었다. 읽을 때는 전처럼"\n"이다.FormFit과 쪽 수 추정의 글자 폭을 한컴오피스 2024의 한/글에 맞췄다. 칸 채우기 결과와 줄 배치 정보가 없는 문서의 쪽 수가 달라질 수 있다.
!는 어느 글꼴에서든 반 em이다(공백처럼, 다만 장평·자간은 다른 글자처럼 받는다).함초롬돋움의 간격 수정 문자·일반 문장 부호(따옴표 빼고)·통화 기호는 함초롬바탕의 폭이다(…·※·‰·—·–·₩ 등). 함초롬돋움으로 대신 그리는 글꼴(한컴산뜻돋움·한컴 고딕 등)의 이 글자들도 그렇다.
HY헤드라인M은 한컴오피스 2024에 든 글꼴 판의 설계 폭을 쓴다(라틴 글자 폭이 옛 판과 다르다).
휴먼명조·휴먼고딕은 한/글이 배치하는 폭이다(1024 단위, 10·40·80pt에서 잰 값: 괄호는 320 단위라 15pt에서 468). HY헤드라인M과 이 둘의 그리스·키릴 문자와 글꼴에 없는 글자도 한/글이 배치하는 폭이다.
HY견고딕·HY울릉도M·HY견명조·HY동녘M의
`는 0.584 em이고, HY울릉도M에 없는 글자는 함초롬바탕의 폭이다.
add_paragraph가 앞 문단의 문단 모양을 물려받을 때 쪽 나눔 설정(page_break_before·keep_with_next·keep_lines)은 빼고 물려받는다. 정렬·여백·줄 간격 등은 전처럼 물려받는다. 전에는 한 문단에 준 “문단 앞에서 쪽 나눔”이 뒤에 더하는 문단 모두에 퍼져, 문단마다 새 쪽에서 시작했다. 문단 모양 id를 직접 주면 그대로 쓴다.그림 문자(😀·📌·✅·⭐·❌ 등, BMP 밖 그림 문자 영역과 BMP에서 컬러 이모지로 그려지는 기호)는 어느 글꼴에서든 1.373 em이다(국기를 이루는 지역 표시 글자는 빼고). ⚫·⚡·☎·✔·➡ 같은 다른 기호는 전처럼 글꼴의 폭이다. 이모지 변형 선택자(U+FE0E·U+FE0F)와 폭 없는 접합자(U+200D)는 폭이 없다.
고침
add_section()을 부른 뒤 넣은 그림이 저장할 때Contents/content.hpf매니페스트에서 빠지던 문제를 고쳤다(#549). 그림을 넣으면 패키지가 매니페스트를 다시 읽는데, 문서는 처음 읽은 매니페스트를 계속 들고 있다가 저장할 때 그것으로 덮어써 첫 그림 뒤의 항목이 사라졌다. 이제 문서도 패키지의 매니페스트를 쓴다. 그 문서를.hwp로 저장하면 첫 그림만 남던 것도 함께 고쳐진다.쪽 수 추정이 쪽(본문)이나 종이 아래에 붙인 위아래 개체(결재란 표 등)를 품은 문단을 한/글처럼 놓는다. 개체가 기준 문단과 같은 쪽에 있도록 한 경우(
hp:pos@holdAnchorAndSO="1")에, 그 문단 첫 줄과 줄 간격이 그 쪽의 개체 자리에 닿으면 한/글은 문단과 개체를 다음 쪽 맨 위로 보낸다. 앞 문단 줄은 개체 자리에 걸쳐 있어도 그 쪽에 남는다. 전에는 개체 자리가 이 쪽과 다음 쪽을 오가며 정해지지 않아 쪽 수를 추정하지 않았다. 첫 줄 높이만 개체 자리 위에 들어가는 경우에는 문단을 그 쪽에 두었다.(실험) 줄 배치 정보 쓰기가 글 앞에 컨트롤만 든 run(구역·단 정의, 쪽 번호, 감추기 등)이 글보다 큰 글자 모양을 가진 문단을 건너뛴다. 한/글은 그 줄을 컨트롤 run 크기만큼 높게 둔다. 전에는 글 크기로 줄 높이를 써, 한/글이 그 줄을 낮게 그릴 수 있었다.
쪽 수 추정이 글자처럼 놓인 그림·도형의 캡션을 표의 캡션처럼 센다. 위·아래 캡션은 캡션 줄 높이와 간격(
gap)만큼 그 개체의 줄을 높이고, 옆 캡션은 캡션 폭과 간격만큼 개체를 넓힌다(줄 높이는 캡션이 개체보다 길어도 개체 높이 그대로). 전에는 표가 아닌 개체의 캡션을 세지 않아, 캡션 달린 그림이 든 줄과 칸을 낮게 세고 옆 캡션 그림 뒤 글을 한 줄에 더 담았다. 글자처럼 놓이지 않은 개체의 캡션은 전처럼 세지 않는다.FormFit·쪽 수 추정이 문단 모양의 여백·간격 단위
unit="CHAR"(hp:case안hc:left·hc:right·hc:intent·hc:prev·hc:next)를 한/글처럼 읽는다. 한/글은 값 v를 바탕글 스타일 글자 크기의 v/200로 놓는다(바탕글 15pt에서 80은 600). 문단 자신의 스타일이나 글자 크기와는 무관하다. 전에는 v를 HWPUNIT으로 읽어 그런 문단 아래 간격을 80으로 세는 등 여백·간격을 작게 셌다. 문단 모양 여백(ParagraphMargin)에 항목별 단위(units)를 담는다.쪽 수 추정이 번호가 붙는 빈 문단의 줄을 번호 글자 크기가 문단 끝 글자보다 크면 그 크기로 센다. 한/글은 글이 있는 번호 문단처럼 빈 번호 문단도 번호(
hh:paraHead@charPrIDRef) 크기로 줄을 세운다(글머리표 글자 모양은 줄 높이에 세지 않는다). 전에는 빈 문단의 번호를 세지 않아 그 줄을 낮게 셌다. (실험) 줄 배치 정보 쓰기는 그런 빈 문단을 건너뛴다. 전에는 끝 글자 크기의 줄을 써, 한/글이 번호보다 낮은 줄로 그릴 수 있었다.쪽 수 추정이 흐르는 표를 품은 문단의 줄이 쪽 끝을 넘을 때, 다음 쪽이 앞 문단의 표(첫 행이 안 들어가 그 쪽에서 시작한 표)로 차 있어 그 표 끝 아래에 줄이 들어가지 않으면 그다음 쪽 맨 위에 둔다. 한/글이 그렇게 놓는다. 전에는 그 줄을 앞 표 끝 아래, 본문 바닥을 넘는 자리에 두었다.
FormFit과 쪽 수 추정이 장평이 100 %가 아닌 한양 글꼴 굵은 글자도 em의 1/20만큼 넓게 잡는다. 한/글은 설계 폭에 그 1/20을 더한 뒤 장평을 곱하고 배치 단위로 내린다(한양중고딕 12pt 장평 95 % “가”가 1,140이 아니라 1,196). 전에는 장평 100 %에서만 넓게 잡아, 장평을 준 굵은 한양 글자 문단의 한 줄에 글자를 더 담았다. (실험) 줄 배치 정보 쓰기도 그런 문단에 한/글과 같은 줄 나눔을 쓴다. 전에는 한/글보다 긴 줄을 써, 한/글이 글자를 눌러 담을 수 있었다.
FormFit·쪽 수 추정이 최소 공백(
condense) 문단에서, 빈칸 묶음의 한 칸이 줄 끝에 닿거나 넘어서 시작하면 그 줄을 끝낸다. 다음 낱말은 빈칸을 줄여도 다음 줄에서 시작하고, 셋째 칸부터는 앞 글이 줄 끝에 닿았어도 다음 줄을 연다. 줄 끝을 넘는 낱말을 위해서는 전처럼 묶음 안 빈칸을 모두 같은 몫으로 줄인다. 전에는 둘째 칸이 줄 끝을 넘어 시작해도 다음 낱말을 줄여 담아, 한/글보다 한 줄에 글자를 더 담았다. (실험) 줄 배치 정보 쓰기도 그런 문단(빈칸 둘이 이어진 최소 공백 문단)을 이제 건너뛰지 않고 한/글과 같은 줄 나눔을 쓴다.FormFit·쪽 수 추정이 줄 끝 자동 탭(
hh:tabPr@autoTabRight)으로 줄 끝까지 닿는 탭을, 그 뒤에 글이 없으면(문단 끝이나 다음 탭 앞) 한/글처럼 그 줄에 둔다. 그 뒤 탭은 다음 줄에서 시작한다. 전에는 줄 끝에 닿는 탭을 모두 다음 줄로 넘겨, 글 뒤에 탭 하나로 끝나는 문단(”□ 상세 정보⇥” 같은 제목)을 두 줄로 셌다. 탭 뒤에 글이 있는데 줄 끝에 닿는 탭은 전처럼 다음 줄로 간다.표의 행·열 넣기·지우기와 셀 나누기(
doc.tables.insert_rows·delete_rows·insert_columns·delete_columns·split_cell)가 표 높이(hp:sz)를 행이 늘거나 준 만큼 옮긴다. 한/글은 표를 배치한 행 높이의 합을 저장하는데, 전에는 행을 넣거나 지워도 편집 전 높이가 남았다. 병합 칸이 있는 표는 쪽 수 추정이 그 저장된 높이를 쓰므로, 행을 넣은 표 아래 문단을 넣은 행만큼 위에 두었다. 건드리지 않은 행은 한/글이 준 높이를 그대로 둔다.hwpx.table_patch.apply_table_ops의 같은 편집은 아직 높이를 옮기지 않는다.쪽 수 추정이 줄 배치 정보 없는 표 칸 안의 위아래(
TOP_AND_BOTTOM)·어울림(SQUARE) 그림·도형을 한/글처럼 놓는다. 개체는 컨트롤이 놓인 줄의 위(첫 줄이면 문단 위 간격 앞의 문단 위)에서 세로 오프셋만큼 아래에 서고(위로 놓은 오프셋은 0), 거기서부터 그 문단과 뒤 문단의 줄이 개체를 피한다. 위아래 개체나 옆 자리가 1,440보다 좁은 어울림 개체에 닿는 줄은 개체 아래로 내려가고, 어울림 개체 옆 줄은 옆 자리 폭으로 다시 나뉜다. 칸은 가장 낮은 개체 바닥까지 늘어난다. 글과 함께 이동하지 않는 개체(flowWithText="0")는 칸 배치에 영향이 없다. 전에는 줄과 개체를 겹쳐 세어, 글이 있는 문단이나 개체 아래 빈 줄이 있는 칸의 행 높이를 낮게 셌다. 한 문단에 그런 개체가 둘 이상이면(한/글은 겹치는 개체를 아래로 쌓는다) 전처럼 센다. 글이 개체 양쪽으로 흐르거나, 여백·번호가 있는 문단이 어울림 개체 옆에 오면 아직 추정하지 않는다.쪽 수 추정이 줄 배치 정보가 있는 표 칸 안의 위아래·어울림 그림·도형도 한/글처럼 잰다. 개체는 문단 위가 아니라 컨트롤이 놓인 줄의 위(첫 줄이면 문단 위 간격 앞의 문단 위)에서 선다. 그 줄은 칸 전체 폭으로 나눴을 때의 줄이라, 개체 옆에서 다시 나뉜 줄이 있으면 그중 첫 줄이다. 글과 함께 이동하지 않는 개체는 칸 높이에 넣지 않는다. 전에는 개체 바닥을 늘 문단 위에서 재어, 글 끝에 컨트롤이 있는 긴 문단의 행을 낮게, 이동하지 않는 개체가 든 행을 높게 셌다.
표 칸이나 캡션의 문단을 고쳐 그 문단의 줄 배치 정보(
hp:linesegarray)를 지울 때(칸 글 채우기·doc.text.replace·문단 모양·글자 모양 바꾸기 등), 그 표를 품은 문단의 줄 배치 정보도 함께 지운다. 칸 안 표면 바깥 표를 품은 문단까지 지운다. 그 문단의 줄은 표 높이만큼 높은데, 표는 칸 줄 수를 따라 커지거나 줄어든다. 전에는 칸 글이 늘어 표가 커져도 표를 품은 문단에 옛 표 높이가 남았고, 쪽 수 추정도 그 높이를 썼다.(실험) 줄 배치 정보 쓰기가 영문 낱말 안에서 줄을 나누는 문단(
breakLatinWord가KEEP_WORD가 아닌 문단)을 건너뛴다. 그런 문단에서 한/글이 닫는 부호·넓은 괄호 옆을 어디서 나누는지 아직 몰라, 한/글과 다른 줄 나눔을 쓸 수 있었다.쪽 수 추정이 표 칸 안 문단의 글 앞·글 뒤 그림·그리기 개체(글자처럼 놓지 않은 것)를, 글과 함께 움직이면 칸 높이에 넣는다. 한/글은 그런 개체로 줄을 밀지 않지만, 칸 위 여백부터 문단 위 + 세로 오프셋 + 개체 높이(바깥 여백 포함)까지 행을 늘린다. 글과 함께 움직이지 않는 개체는 행을 늘리지 않는다. 전에는 그런 개체를 세지 않아 표 높이를 낮게 셌다.
쪽 수 추정이 run의
hp:switch안 개체를 한/글처럼 배치한다. 한/글은 차트를 저장할 때마다hp:switch로 감싸(차트는 2016 차트 이름공간을 요구하는hp:case에, 옛 판을 위한 OLE 개체는hp:default에) 그hp:case의 차트로 배치한다. 전에는 그런 구역을 지원 밖으로 알려, 한/글이 저장한 차트 문서는 추정하지 않았다. (실험) 줄 배치 정보 쓰기는 그런 구역을 계속 건너뛴다.FormFit과 쪽 수 추정이 자간이 있는 문단의 한글·영문/숫자 자동 간격을 한/글처럼 잰다. 한/글은 간격(글자 크기의 4분의 1)을 앞 글자 폭에 더한 뒤 둘을 합친 폭에 자간을 매겨 배치 단위로 반올림한다(10pt 자간 −10 %에서 함초롬바탕 ‘가’ 뒤 222, 맑은 고딕 ‘가’ 뒤 226). 전에는 간격에만 자간을 매겨(225) 간격이 여럿인 줄이 한 글자 일찍 나뉠 수 있었다.
FormFit과 쪽 수 추정이 고정폭 빈칸(
hp:fwSpace)에 장평과 자간을 매긴다. 한/글은 고정폭 빈칸을 글자 크기의 4분의 1(배치 단위로 내림)에 장평을 매겨 반올림한 뒤 자간을 더한다(11pt에서 272, 장평 120 %면 328, 자간 −8 %면 252). 전에는 장평·자간과 상관없이 4분의 1로 세어, 자간을 줄인 칸에서 고정폭 빈칸이 든 글이 한/글보다 일찍 줄을 나눴고 (실험) 줄 배치 정보는 그 뒤 탭 폭을 틀리게 썼다.FormFit과 쪽 수 추정이 한글을 글자 단위로 나누는 문단(
breakNonLatinWord="KEEP_WORD")에서, 넘친 글자 바로 앞의 여는 괄호(·[를 그 글자와 함께 다음 줄로 내린다. “%(평가”에서 “%”와 “(“까지 들어가고 “평”이 넘치면 한/글은 “%” 뒤에서 나눈다 (“(“가 넘치면 “%” 앞에서, 괄호 안이 영문·숫자면 낱말째). 전에는 “%” 앞(빈칸·탭 뒤)에서 나눠, (실험) 줄 배치 정보도 그런 문단에 한/글과 다른 줄 나눔을 썼다.FormFit·쪽 수 추정·(실험) 줄 배치 정보가 위 첨자·아래 첨자(
hh:supscript·hh:subscript) 글을 한/글처럼 글자 크기의 0.64배로 놓는다(자간은 그 크기 기준). 전에는 보통 크기로 세어 첨자가 든 줄이 일찍 나뉘었고, 줄 배치 정보는 첨자 뒤 탭 폭을 틀리게 썼다.(실험) 줄 배치 정보 쓰기가 한글·영문/숫자 자동 간격이 켜진 문단에도 쓴다: 탭 폭에도 그 간격을 넣는다. 자간이 있는 그런 문단은 한/글이 간격을 어떻게 반올림하는지 아직 몰라 계속 건너뛴다.
쪽 수 추정이 문단 모양의 줄 나눔 방식이 “한 줄로 입력”(
hh:breakSetting@lineWrap="SQUEEZE")인 문단을, 한/글처럼 길이와 상관없이 한 줄로 센다. (실험) 줄 배치 정보는 그런 문단에 쓰지 않는다. 전에는 보통 문단처럼 여러 줄로 나눠, 줄 배치 정보가 한/글이 한 줄로 누르는 문단에 여러 줄을 썼다. 저장과 패키지 검증도 그런 문단에 한/글이 쓴 한 줄짜리 배치 정보를 “줄이 모자란 낡은 정보”로 보지 않는다(전에는 손대지 않고 저장해도 지웠고, 검증기는 오류로 냈다).쪽 수 추정이 글자처럼 놓인 개체가 든 run의 글자 크기를 줄 간격에만 넣고 줄 높이에는 넣지 않는다. 한/글은 그 줄을 글자와 개체 중 큰 높이로 놓고, 줄 간격은 글자와 개체 run 크기 중 큰 크기로 정한다. 전에는 개체 run이 글보다 크면 줄을 그만큼 높게 셌다.
쪽 수 추정이 차례 표시(
hp:titleMark)를 폭 없는 글자로 센다. 한/글은 표시가 든 줄을 그 표시 run의 글자 크기만큼 높이고 그 크기로 줄 간격을 정한다. 전에는 표시를 없는 것으로 보아, 글보다 큰 run에 든 표시의 줄을 낮게 셌다.FormFit과 쪽 수 추정이 낱말 바로 뒤의 빈칸 두 개를 줄 끝 너머에 매단다. 첫 빈칸이 줄 끝을 넘고 둘째 빈칸이 줄 끝 너머에서 시작해도 둘째까지 그 줄에 남고, 셋째부터 다음 줄로 간다. 한/글이 그렇게 놓는다. 전에는 둘째 빈칸부터 다음 줄로 보내 빈칸이 여러 개 이어진 자리에서 줄이 한 글자 일찍 나뉘었다.
FormFit과 쪽 수 추정이 탭 바로 뒤의 닫는 문장 부호(
)·.·!·」등)로 줄을 시작할 수 있게 한다. 빈칸 뒤처럼 탭은 앞 줄에 남고 부호가 다음 줄을 시작한다. 한/글이 그렇게 놓는다. 전에는 탭까지 다음 줄로 보냈다.쪽 수 추정(실험,
estimate_pages)이 머리 정보 파트(Contents/header.xml)가 없는 문서에서IndexError로 멈추던 것을 지원 밖(a document without a header part (Contents/header.xml))으로 알린다. 줄 배치 정보 쓰기도 그런 문서에는 쓰지 않는다.(실험) 줄 배치 정보 쓰기가 문단 모양이 한글·영문/숫자 자동 간격(
hh:autoSpacing)을 켜고 한글 음절 바로 옆에 영문 글자나 숫자가 있는 문단을 건너뛴다. 한/글은 그 사이를 넓히는데 그 폭을 아직 재지 않아, 쓴 줄 나눔이 한/글과 다를 수 있었다.(실험) 줄 배치 정보 쓰기가 글 사이에 필드(하이퍼링크·누름틀·날짜·메일 머지)나 형광펜이 든 문단에도 쓴다. 필드의 시작·끝은
(실험) 줄 배치 정보 쓰기가 글 사이에 필드(하이퍼링크·누름틀·날짜·메일 머지)나 형광펜이 든 문단에도 쓴다(구역 첫 문단의 필드와 메모 필드는 한/글이 배치 정보 없이 저장해 건너뛴다). 필드의 시작·끝은 줄에 자리를 차지하지 않고 줄 위치(textpos)에서 하나에 8글자씩이며, 줄이 나뉘는 자리에 있으면 다음 줄이 그것으로 시작한다. 형광펜 표시는 자리도 줄 위치도 차지하지 않는다. 한/글이 그렇게 놓는다. 전에는 그런 문단을 건너뛰었다.
FormFit과 쪽 수 추정이 문단 모양의 한글·영문/숫자 자동 간격(
hh:autoSpacing의eAsianEng·eAsianNum)을 따른다. 한/글은 한글 음절 바로 옆의 영문 글자(또는 숫자) 사이에 em의 1/4(자간 적용, 장평은 그대로)을 넣고, 그 간격은 앞 글자에 붙어 줄이 그 자리에서 나뉠 때도 앞 줄 폭에 든다. 빈칸·문장 부호를 사이에 두거나 영문과 숫자 사이는 넣지 않는다. 전에는 간격 없이 세어 그런 문단의 줄이 한/글보다 늦게 나뉘었다.TextStyle.auto_space_latin·auto_space_digit,auto_space_gap().FormFit과 쪽 수 추정이 글꼴 폭 표에 없는 가나(히라가나·가타카나)를 그 글꼴의 한글 음절 폭으로 잡는다(함초롬바탕 972, 한컴 고딕 932). 한/글이 그렇게 놓는다. 전에는 전각(1 em)으로 셌다.
쪽 수 추정(실험,
estimate_pages)이 탭 정의를 한 번만 읽는다. 전에는 글자 모양을 볼 때마다 머리 정보의 탭 정의 전체를 다시 읽어 큰 문서(185쪽)에서 6분 가까이 걸렸다(이제 약 2분).write_line_caches는 쪽 수 추정이 따르지 못하는 첫 구역에서 멈춘다(그런 문서에는 어차피 아무것도 쓰지 않는다). 그 구역 하나의 사유만 알린다.doc.styles.replace_font가 바뀐 글꼴을 쓰는 문단의 줄 배치 정보(hp:linesegarray)를 지운다. 한/글은 남은 정보의 줄 나눔을 그대로 따르므로, 전에는 새 글꼴이 옛 글꼴의 줄 폭에 맞춰 눌리거나 겹쳐 보일 수 있었다.doc.parts.set_paragraph_auto_spacing도 값이 바뀌면 그 문단 모양을 쓰는 문단의 줄 배치 정보를 지운다.apply_body_ops의replace_text가 표를 담은 문단과 그 표의 칸 문단에서 함께 찾은 글을 바꿀 때 XML을 깨뜨려 저장 검사에서ValueError: malformed XML로 멈추던 것을 고친다. 두 문단의 편집 구간이 겹쳐 있었다. 이제 바깥 문단 하나로 묶어 그 안의 치환과 칸의 줄 나눔(SQUEEZE→BREAK) 편집을 한 번에 적용한다.(실험)
write_line_caches가 한양신명조·한양중고딕의 굵은 글자가 든 문단에도 줄 배치 정보를 쓴다. FormFit이 그 폭(em의 1/20 넓게)을 한/글처럼 잡게 되어서다. 한양견고딕·HCI Hollyhock의 굵은 글자는 여전히 쓰지 않는다.FormFit과 쪽 수 추정이 글자 모양의 언어별 글꼴이 서로 다를 때 영문 글자·숫자·ASCII 문장 부호·가운뎃점을 영문 글꼴의 폭으로, 한중일 문장 부호·기호·화살표·도형을 기호 글꼴의 폭으로 센다. 한/글이 그렇게 놓는다. 전에는 한글·영문·기타·기호 글꼴이 모두 같을 때만 글꼴 폭을 쓰고, 다르면 평균 폭으로 셌다.
TextStyle.latin_face·symbol_face가 그 글꼴을 담는다.(실험) 줄 배치 정보 쓰기도 그런 문단에 쓴다: 영문·기호 글자마다 자기 언어의 글꼴이 확인된 글꼴이면 된다.
FormFit과 쪽 수 추정이 한양 글꼴(한양신명조·한양중고딕·한양견고딕)의 굵은 글자를 em의 1/20만큼 넓게 잡는다. 한/글은 그 폭을 더한 뒤 배치 단위로 반올림한다(14pt “가”가 1,400이 아니라 1,472). 전에는 굵은 글자도 보통 폭으로 셌다. 다른 글꼴의 굵은 글자는 전처럼 보통 폭이다.
TextStyle.bold가 글자 모양의 굵게를 담는다.쪽 수 추정(실험,
estimate_pages)이 run의hp:switch안에 든 개체(차트와 그것을 대신하는 OLE 개체 등)가 있는 구역을 지원 밖으로 둔다(an object in a switch (hp:switch)). 한/글은 그런 개체도 자리를 차지해 곁의 줄을 좁히는데, 전에는 개체가 없는 것처럼 추정했다.FormFit과 쪽 수 추정이 묶음 빈칸(
hp:nbSpace)에 장평만 적용하고 자간은 적용하지 않는다. 한/글이 그렇게 놓는다(9pt 장평 120 %·자간 −12 %에서 536, 전에는 472). 공백과 고정폭 빈칸은 전과 같다.FormFit과 쪽 수 추정에서
!의 반 em을 공백처럼 배치 단위(1/1800인치)로 내림한다. 9·11·13pt처럼 글자 크기의 4분의 1이 홀수인 크기에서!가 4 넓게 잡혀, 그 뒤 탭 폭이 한/글보다 4 좁았다.FormFit과 쪽 수 추정이 공백 뒤의 닫는 문장부호(
!·?·)·%·」··등 줄 머리에 오지 않는 문자 모두)로 줄을 시작한다. 한/글이 그렇게 놓는다. 전에는 말줄임표(…)만 그랬고, 다른 문자는 공백 앞 낱말까지 다음 줄로 넘겨 한 줄에 낱말 하나가 덜 들어갔다. 앞 글자에 붙은 문장부호는 전처럼 그 글자와 함께 다음 줄로 간다..hwp를 HWPX로 읽을 때 변경 추적 설정(hh:trackchageConfig@flags)을 설정 레코드의 첫 값 그대로 쓴다. 한컴오피스 2024가 쓰는 값이다(대개 56). 전에는 레코드가 있으면 늘 4를 썼다..hwp로 쓸 때도 HWPX의 flags를 그 자리에 쓴다(없으면 56).메모 필드(
notes.add_memo)와.hwp에서 읽은 필드의hp:fieldBegin에 한/글처럼metaTag=""를 단다(메일 머지 표시 필드는 전처럼 달지 않는다)..hwp를 HWPX로 읽을 때 메모 답글 관계(Contents/memoExtended.xml)와 참고 문헌(Custom/bibliography.xml)을 잃지 않는다. 한/글은 둘을.hwp의 MemoExtended·Bibliography 스트림에 두고 HWPX로 저장할 때 그 부분으로 쓴다(매니페스트도 한/글 순서대로). 전에는 둘 다 빠졌다. 스트림 길이가 맞지 않으면 쓰지 않고conversion_report.dropped에memo-replies·bibliography로 센다..hwp를 HWPX로 읽을 때 상호 참조와 메일 머지 필드의 매개변수를 한/글처럼 쓴다. 상호 참조는 명령(Command)에서RefPath·RefType(표·그림·수식·각주·미주·개요·책갈피)·RefContentType(쪽·번호·내용·위/아래)·RefHyperLink·RefOpenType을, 메일 머지는FieldType(USER_DEFINE)·FieldValue를 풀어 쓰고metaTag=""를 단다. 필드 속성의 비트 0x2는 어느 필드든 첫 매개변수Fiexde(한/글 철자) 1로 쓰고,.hwp로 쓸 때도Fiexde가 있는 필드만 그 비트를 켠다(전에는 상호 참조·메일 머지면 늘 켰다). 한컴오피스 2024 데스크톱이 같은.hwp를 HWPX로 저장한 값과 같다..hwp를 HWPX로 읽을 때 그림자 있는 개체의 바깥 여백을 한컴오피스 2024처럼 읽는다..hwp는 여백에 그림자가 닿는 만큼을 더해 부호 있는 16비트로 두고 넘치면 감아 쓰는데, 한/글 2024는 0 아래로 저장된 여백을 0으로 보고 거기서 그림자 몫(역시 16비트로 감은 값)을 뺀다. 전에는 감긴 값을 풀어 원래 여백으로 읽어, 큰 원근 그림자 사각형(28346×42520)이 한/글의 왼쪽 26411·아래 22733 대신 0이었다. 확대 그림자는 개체의 1/4을 반올림해 잡는다(28347 → 7087)..hwp를 HWPX로 읽을 때 한 문단에 쪽 번호 위치(hp:pageNum)가 여럿이면 마지막 것만 남긴다. 한/글은 마지막 것으로 쪽 번호를 매기고 그것만 저장한다. 전에는 모두 남겨, 첫째가 “아래 가운데”이고 마지막이 “없음”인 문서를 첫째부터 읽는 도구는 한/글에 없는 쪽 번호를 보았다.쪽 수 추정에서 글이 없는 문단의 줄은 컨트롤이나 개체를 든 run과 마지막 run(문단 끝) 가운데 가장 큰 글자 크기로 잰다. 한/글은 그 앞의 빈 글 run은 세지 않는다. 전에는 빈 글 run의 가장 작은 크기로 재서, 구역 정의나 표를 든 큰 글자 run과 작은 빈 run이 섞인 문단(예: 문서 첫 문단)의 줄이 낮았다.
쪽 수 추정과 배치 검사(
hwpx.layout)가 음수 쪽 여백을 음수로 읽는다. 머리말·꼬리말 여백이 음수인 문서(.hwp를 HWPX로 바꾼 문서에 있다)는 그 값을 부호 없는 32비트(-1400이면 4294965896)로 남기는데, 전에는 이를 큰 양수로 읽어 본문 높이가 음수가 되고 쪽 수 추정이 끝나지 않았다. 한/글은 그 값을 음수로 읽어 본문을 그만큼 늘린다. 반면 마이너스 기호로 쓴 여백(header="-1400")은 한/글이 읽지 않고 새 쪽의 여백(위 5668, 아래 4252, 왼쪽·오른쪽 8504, 머리말·꼬리말 4252, 제본 0)으로 놓은 뒤 그 값으로 저장하므로, 추정도 그 값을 쓴다. 여백 때문에 본문 높이나 글 너비가 0 이하이면 추정은 끝없이 돌지 않고 지원 밖(page margins leaving no room for the body)을 돌려준다.FormFit과 쪽 수 추정이 옛 한/글이 저장한 문서(
version.xml의xmlVersion이 1.31보다 작음)에서hp:switch밖에 쓰인 문단 여백과 HWPUNIT 줄 간격을 반으로 읽는다. 한/글은 그 값을hp:default처럼 두 배로 쓴 값으로 읽는다. 전에는 그대로 읽어, 그런 문서의 들여쓰기·문단 간격·고정 줄 간격이 두 배가 됐다. 새 문서(1.31 이상)와hp:switch안의 값은 전처럼 읽는다.FormFit과 쪽 수 추정이 탭을 한/글처럼 놓는다.
탭은 단(셀이면 셀 글 영역)의 왼쪽 끝에서 4000 HWPUNIT마다 있는 기본 탭 위치 가운데 지금 위치 다음 것까지 간다. 줄은 문단 왼쪽 여백에서, 첫 줄은 들여쓰기만큼 더 들어가 시작한다(내어쓰기는 둘째 줄부터).
탭의 앞뒤 어디서나 줄이 바뀔 수 있다.
전에는 탭을 공백 크기 글자처럼 재서, 탭이 있는 문단의 줄 나눔이 한/글과 달랐다.
탭 정의에 자기 탭 위치가 있으면 그 위치가 먼저다. 탭 뒤 글을 그 위치에 맞출 수 있는(탭 앞에서 시작하지도, 줄 끝을 넘지도 않는) 첫 위치로 간다. 왼쪽 위치는 글을 거기서 시작하고, 오른쪽은 거기서 끝내고, 가운데는 거기에 가운데를 맞추고, 소수점은 마지막
.을 거기에 둔다. 왼쪽 위치는 글이 줄 끝을 넘어도 그대로 가지만, 앞에서 지나친 위치가 있으면 글을 줄 끝에서 끝낸다. 줄 끝에 닿은 탭은 다음 줄로 간다. 오른쪽 끝 자동 탭은 줄 끝의 오른쪽 위치로 함께 센다. 그다음은 기본 탭 위치다. 맞출 수 없어 지나친 위치가 있는데 기본 탭 위치에서 글이 줄에 들어가지 않으면 탭은 폭이 없다. 내어쓰기 자동 탭은 둘째 줄이 시작하는 곳에 왼쪽 위치를 둔다.
.hwp를 열 때 높이가 음수인 표 칸(파일에는 부호 없는 32비트로 남는다, -633이면 4294966663)을 한/글처럼 그 칸의 위·아래 여백 합(칸 자체 여백이 있으면 그것, 없으면 표 안 여백) 높이로 바꾼다. 전에는 그 값을 그대로 써서 큰 양수 높이로 읽혔다. 한/글은 그 높이에서 글에 맞게 칸을 키운다.
쪽 수 추정과 배치 검사가 HWPX의 음수 칸 높이(부호 없는 32비트로 남은 값)를 없는 높이로 센다. 한/글은 그 칸을 위·아래 여백 높이로 놓고 글에 맞게 키우는데, 전에는 40억이 넘는 높이로 읽어 .hwp를 바꾼 문서의 쪽 수가 수만 쪽으로 나왔다.
쪽 수 추정에서 강제 줄 바꿈 다음 줄은 첫 줄이 아니다. 들여쓰기를 빼지 않고 다른 줄의 폭으로 잰다. 전에는 첫 줄 폭으로 재서, 들여쓴 문단에서 줄이 하나 더 생길 수 있었다.
쪽 수 추정에서 자기 글자 모양이 없는 글머리표·번호(
hh:paraHead@charPrIDRef없음)는 문단 끝(마지막 run)의 글자 모양으로 잰다. 그 크기로 머리 폭을 재고, 그 크기가 첫 줄 높이에도 들어간다. 전에는 문단 첫 글자의 모양으로 재서, 크기가 섞인 개요·번호 문단의 줄 나눔과 첫 줄 높이가 한/글과 달랐다.FormFit과 쪽 수 추정이 텍스트 내보내기가 쓰지 않는 번호 형식(
KOREAN_DIGIT,HANGUL등)의 문단 번호를 만나도 멈추지 않는다. 한/글이 재는 번호(useInstWidth)이면 그 숫자를 한글 한 글자 폭으로 잰다. 전에는 번호가 자기 글자 모양을 가진 문단에서KeyError가 났다.쪽 수 추정이
hp:colPr@sameSz와 각주hp:placement@beneathText의true를1과 같이 읽는다(xs:boolean). 전에는sameSz="true"인 같은 폭 다단을 폭이 다른 다단으로 보고 추정하지 않았다..hwp를 열 때 그림의 투명도와 반전을 한/글이 읽는 자리에서 읽는다. 한/글은 그림 레코드의 투명도를 그림 원래 크기 뒤 마지막 바이트에서 읽고, 바이너리 항목 번호 뒤 바이트는 읽지 않는다(저장할 때 0으로 쓴다). 전에는 그 바이트를 투명도로 옮겨, 거기에 255가 든 문서의 그림이 HWPX에서 보이지 않았다. 반전(hp:pic@reverse)은 그림 개체 속성의 24번 비트에서 읽는다(전에는 늘 0). HWP 5.0으로 저장할 때도 두 값을 같은 자리에 쓴다.쪽 수 추정이 줄보다 넓은 글자처럼 취급한 표·그림을 한컴오피스 2024의 한/글처럼 놓는다.
표 앞의 조판 부호(책갈피·누름틀·머리말·쪽 번호 위치 등)와, 문단 첫머리에 앵커된 위아래 배치 개체는 표의 줄에 선다. 전에는 그 앞에 빈 줄 하나를 따로 두어 뒤 문단이 그만큼 내려갔다.
글자로 번호를 찍는 조판 부호(번호 넣기)는 전처럼 표 위에 자기 빈 줄을 둔다.
표 뒤의 조판 부호는 전처럼 표 아래 빈 줄에 선다.
어울림 개체 옆 좁은 띠에 든 이런 개체는 띠보다 넓어도 띠 안 그 자리에 놓인다. 전에는 개체 아래 전체 폭 줄로 내렸다.
FormFit과 쪽 수 추정이 HCI Poppy·HCI Hollyhock·한양중고딕·한양신명조·한양견고딕·휴먼옛체의 라틴 확장·그리스·키릴 문자와 기호(표준 글자 1,678자)도 한/글이 배치하는 폭으로 잰다. 전에는 표에 없어 글자 종류의 평균 폭을 썼다.
쪽 수 추정이 문단 위로 올려 놓은 도형(문단 기준 음수
vertOffset, 파일에는 부호 없는 32비트로 남는다)을 그만큼 위에 놓인 것으로 센다. 전에는 그 값을 큰 양수로 읽어 문단 줄이 40억 넘게 높아지고, 한 쪽짜리 문서가 세 쪽으로 나왔다. 한/글은 그 도형을 문단 위가 있었을 자리에서 그만큼 위에 놓고, 그 띠에 걸린 앞 줄(아래끝이 띠 위끝보다 아래인 줄)을 띠 아래끝으로 내린 뒤 그다음 줄을 이어서 놓는다. 도형의 문단 줄은 그 뒤에 온다. 추정도 이제 그렇게 놓는다(옮긴 줄이 쪽 끝을 넘거나 그 사이에 표·개체·각주가 있으면 지원 밖).FormFit과 쪽 수 추정이 표에 없는 글꼴 이름(설치되지 않은 글꼴 등)을 한컴바탕의 폭으로 잰다. 한/글은 찾지 못한 글꼴을 한컴바탕으로 배치한다. 전에는 글자 종류의 평균 폭을 썼다. 글꼴 이름이 없으면 전처럼 평균 폭이다.
한컴바탕의
※는 788,…는 983(1024 단위)으로 한/글이 배치하는 폭이다.
쪽 수 추정이 빼기 부호로 쓴 개체 오프셋(
vertOffset="-1500"처럼, 한/글이 쓰는 부호 없는 32비트 꼴이 아닌 것)을 한/글처럼 0으로 읽는다. 한/글은 그런 값을 0으로 읽어 개체를 문단(또는 종이) 기준 자리에 그대로 그리고, 저장할 때 0으로 고쳐 쓴다. 전에는 그만큼 위(왼쪽)로 놓인 것으로 읽어 뒤 줄 자리가 한/글과 달랐다.쪽 수 추정이 “다음 문단과 함께”가 이어진 문단들(사슬)을 한/글처럼 놓는다. 사슬 문단이 쪽 끝에서 넘치면 다른 문단처럼 나뉘고 그 앞 사슬은 남는다. 사슬 문단이 통째로 다음 쪽으로 가야 하면(다음 문단 첫 줄이나 표가 들어가지 않으면) 그 앞 사슬 전체가 함께 간다. 사슬 문단의 각주도 자리를 차지한다. 전에는 바로 다음 문단만 보았다.
쪽 수 추정이 글자처럼 취급한 그림을 그 효과까지 합친 크기로 놓는다. 빛남은 네 변에 반경만큼, 바깥 그림자는 그림(빛남 포함)을 방향으로 거리만큼 옮기고 반경만큼 넓힌 자리까지 차지해, 그 줄이 그만큼 높아진다. 전에는 효과를 세지 않아 줄과 쪽이 한/글보다 짧게 나왔다. 안쪽 그림자는 자리를 차지하지 않는다. 그림자의 흐림은 한/글처럼 화면 픽셀(96dpi, 75 HWPUNIT) 단위로 올려 세고(반경 400은 450), 뻗는 길이는 HWPUNIT 아래를 버린다. 반사는 대략 그 몫만큼의 그림(빛남 포함) 높이와 거리만큼 아래로 자리를 차지한다(한/글과 한 픽셀 안팎 차이). 부드러운 가장자리는 자리를 차지하지 않는다.
add_section()이 만든 구역은 메모리에서도 한/글의 이름공간 접두사(hs:sec,hp:p등)를 쓴다. 전에는ns0:sec,ns4:p처럼 붙어(저장할 때는 바로잡혔다), 그 구역에 넣은 표의 셀 나누기 같은 구조 편집이TableStructureError로 멈췄다. 그 오류 문구도 바로잡았다.쪽 수 추정이 문단 맨 위에 둔 위아래 배치 표 아래로 문단 첫 줄이 그 쪽에 들어가지 않을 때 한/글처럼 놓는다. 그 쪽에서 끝나는 표는 첫 줄과 함께 다음 쪽 맨 위로 간다. 행 단위로 나누는 표는 그 쪽에 다 들어갈 때, 셀 단위로 나누는 표는 마지막 행의 남는 높이를 잘라 그 쪽에서 끝날 때도 그렇다. 나누지 않는 표가 그 자리에 들어가지 않으면 표만 다음 쪽 맨 위로 가고, 문단 줄과 그 뒤 문단은 제자리에 남는다. 전에는 앞의 두 경우 표를 그 자리에 두어 쪽 수가 한/글과 달랐고, 나누지 않는 표는 첫 줄과 함께 넘겨 쪽이 하나 더 나왔다.
FormFit과 쪽 수 추정이 공백 뒤의 말줄임표(
…)로 줄을 시작한다. 한/글이 그렇게 놓는다. 앞 글자에 붙은…는 전처럼 그 글자와 함께 다음 줄로 간다.쪽 수 추정이 문단 아래로 띄워 둔 위아래 배치 개체가 쪽 끝 가까이 있을 때 한/글처럼 놓는다. 개체 아래로 내려간 다음 줄이 쪽 끝을 넘으면 다음 쪽 맨 위에서 시작한다(개체 아래 간격은 그 쪽으로 가져가지 않는다). 개체의 앵커 줄이 다음 쪽으로 넘어가면 개체도 그 줄과 함께 넘어가, 그 줄 위에서 오프셋만큼 아래에 선다. 전에는 앞의 경우를 지원하지 않았고, 뒤의 경우 개체를 다음 쪽 맨 위에, 앵커 줄을 그 아래에 놓았다.
쪽 수 추정이 단 간격(
hp:colPr@sameGap)을 부호 있는 32비트 수로 읽는다. 2³¹ 이상으로 쓰인 값은 음수 간격이고, 한/글은 단이 겹치도록 단 폭을 그만큼 넓힌다. 전에는 아주 큰 간격으로 읽어 단 폭이 거의 없었다.쪽 수 추정이 빈 문단에 홀로 든 위아래 배치 개체(그림·도형) 뒤의 다음 문단을 한/글처럼 놓는다. 개체가 글과 함께 움직이고 겹침을 허용하며 빈 줄의 글자 높이 안에서 시작할 때만 빈 줄이 개체 아래로 내려간다. 그 밖에는 빈 줄이 문단 위에 그대로 있고, 다음 문단은 개체의 아래끝과 빈 줄에 두 문단 간격(앞 문단 아래·다음 문단 위)을 더한 자리 중 더 낮은 곳에서 시작한다. 전에는 개체 아래에 두 간격을 더했고, 빈 줄이 내려가는 경우에는 빈 줄의 높이를 빠뜨렸다.
FormFit과 쪽 수 추정이 한/글이 다른 글꼴로 바꾸지 않고 따로 배치하는 신명 태명조·신명 견고딕·한양그래픽을 한/글이 배치하는 폭으로 잰다(신명 태명조·한양그래픽은 2048 단위, 신명 견고딕은 1000 단위). 신명 태명조의 숫자는 0.71 em, 괄호는 반 em이다. 전에는 표에 없는 글꼴이라 글자 종류의 평균 폭을 썼다.
쪽 수 추정이 줄보다 넓은 글자처럼 취급한 개체(표 등)와 위아래 배치 개체가 함께 든 문단을 한/글처럼 놓는다. 넓은 개체는 한 줄을 혼자 차지한다. 위아래 배치 개체의 자리(조판 부호)가 그 앞, 곧 문단 맨 앞에 있으면 넓은 개체 위에, 그 뒤, 곧 문단 맨 끝에 있으면 아래에 글자 높이만 한 빈 줄이 하나 더 생긴다. 위아래 배치 개체는 그 빈 줄 위에 놓인다. 전에는 줄 배치 정보가 없으면 둘을 한 줄로 셌고, 줄 배치 정보가 있어도 자리가 문단 맨 앞이면 넓은 개체의 줄 위에 놓았다. 그래서 넓은 개체가 다음 쪽으로 밀리기도 했다.
쪽 수 추정에서 흐르는 표가 쪽마다 되풀이하는 머리 행을 쪽 끝에서 나누지 않는다. 남은 자리에 머리 행이 다 들어가지 않으면 한/글처럼 표가 다음 쪽에서 시작하고(머리 행은 그 쪽 위에 한 번), 표 뒤 문단은 앵커 줄 아래에 이어진다. 전에는 셀 단위로 나뉘는 표(
pageBreak="CELL")는 머리 행을 줄 사이에서 나눴고, 행 단위로 옮기는 표(TABLE)는 첫 행만 보고 옮긴 뒤 그 쪽에 머리 행을 두 번 셌다.쪽 수 추정이 글자처럼 취급한 개체가 든 문단에서 위아래 배치 개체가 놓일 줄을 한/글처럼 고른다. 자리(조판 부호) 바로 뒤에서 다음 줄이 시작하면 자리는 앞 줄 끝에 남고, 개체는 그 앞 줄 위에 놓인다. 전에는 줄 배치 정보가 있으면 다음 줄 위에 놓았고, 줄 배치 정보가 없으면 글자처럼 취급한 개체를 빼고 글만으로 줄을 나눠 자리의 줄을 정했다.
쪽 수 추정에서 어울림(
SQUARE) 개체를 든 빈 문단의 줄은 개체에 닿을 때만 개체 양옆 두 조각이 된다. 개체가 줄 바닥보다 아래에 놓이면 한/글처럼 한 줄이다. 전에는 개체의 세로 위치를 보지 않고 늘 두 조각으로 나눴다.문단에서 run을 빼거나(
HwpxOxmlRun.remove()) 더하거나(add_run), 그림·표·도형 같은 개체를 넣거나, 메모를 달거나 지우거나(필드 컨트롤), 각주·미주를 넣으면 그 문단의 줄 배치 캐시(hp:linesegarray)를 지운다. 한/글은 저장된 캐시를 다시 쓰므로, 내용이 바뀐 문단에 옛 캐시가 남으면 줄이 옛 자리에 그려지고, 줄 시작이 남은 내용을 넘으면 문서를 손상·변조 가능성으로 경고했다. 글만 든 문단은 저장할 때의 낡은 캐시 검사가 지워 줬지만, 개체가 든 문단은 그 검사에서 빠졌다. 다른 문단의 캐시는 그대로 둔다(#436).문단 모양 조회와 글꼴·테두리 조회가 큰 머리말에서 느리던 것을 고친다. FormFit과 쪽 수 추정(실험)이 문단·글자 모양마다 이 조회를 불러, 문단 모양이 많은 문서에서는 거의 모든 시간을 여기에 썼다.
문서의
paragraph_property()가 부를 때마다 모든 머리말의 문단 모양을 모두 읽었다. 이제 머리말마다 찾는 모양만 읽는다(뒤 머리말이 이기는 것은 그대로).font_face()·border_fill_info()가 부를 때마다 머리말 전체를 훑었다. 이제hh:refList의 글꼴·글자 모양· 테두리 목록만 보고, 그런 목록이 없는 머리말만 전체를 훑는다.
표 구조 편집(
apply_table_ops)이hp:cellAddr·hp:cellSz가 없는 칸(다른 프로그램이 쓴 표)에서AssertionError로 멈추거나 엉뚱한 이유로 거부하던 것을 고친다. 행·열 삭제와 삽입, 열 폭 설정과 맞춤, 표 나누기, 행 순서 바꾸기가 이제 그런 표를 표 안의 표처럼 거부한다.표의 열을 모두 지우는
delete_column(1열 표의 열 포함)이ZeroDivisionError로 멈추던 것을 고친다. 행을 모두 지우는delete_row도 남는 격자 탓으로만 거부했다. 한/글도 마지막 행·열은 지우지 않는다. 이제 둘 다 거부하고delete_table을 쓰라고 알린다.행 삽입(
insert_row_by_clone)과 행·열 삭제(delete_row,delete_column)가 칸 영역(hp:cellzone)을 옮기지 않던 것을 고친다. 영역은 그려지므로, 남은 영역이 다른 칸에 테두리를 그렸다. 이제 영역이 칸과 함께 움직인다.삽입: 새 행 뒤의 영역은 밀고, 새 행을 가로지르는 영역은 넓힌다.
삭제: 영역은 남는 줄만큼 줄고, 줄이 모두 지워진 영역은 없어진다(마지막 영역이면 목록째).
글머리표·번호 목록(
doc.styles.apply_list_format)이 10보다 깊은 수준을 받던 것을 고친다.한/글 목록은 1~10수준이다. 11수준 이상을 쓴 문서는 한/글이 다시 저장하지 못하고 멈춘다.
이제 수준이 1 이상 10 이하의 int가 아니면 무엇도 바꾸기 전에
style-list-level-invalid오류로 거부한다(전에는 1 미만만 거부했다).
쪽 수 추정이 글 뒤에 둔 어울림(
textWrap="SQUARE") 개체의 자리가 문단 둘째 줄 이후에 오는 경우도 따른다. 한/글처럼 문단을 단 폭 그대로 나눴을 때 그 자리가 든 줄을 찾고, 개체를 그 줄 위에서부터 놓는다. 그 앞 줄은 단 폭 그대로이고, 그 줄부터 개체 곁으로 좁아진다. 전에는 첫 줄에 드는 경우만 따르고 나머지는 지원하지 않았다.위의 어울림 개체 자리가 앞 줄을 꼭 채운 바로 뒤(다음 줄의 시작)에 오면, 한/글처럼 그 글이 끝나는 앞 줄에 든 것으로 센다. 예를 들어 첫 줄을 꼭 채운 글 뒤의 개체는 문단 위에서부터 놓인다. 전에는 줄 배치 정보가 없는 문서에서 다음 줄에 든 것으로 세어, 개체와 그 곁 줄이 한 줄 아래로 내려갔다.
FormFit과 쪽 수 추정이 한/글처럼 글자 폭을 잡는다.
한양견고딕의 영문·숫자·기호(ASCII·라틴-1·라틴 확장-A·‘’“”„‟)는 설계 폭(4096 단위)을 1200 단위로 반올림한 폭이다. 굵은 “a”는 10pt에서 608이 아니라 604다. 나머지 글자는 글꼴 폭 그대로이고 굵게여도 넓어지지 않는다.
한양 글꼴에서 굵게여도 겹받침 자모(ㄳ·ㄺ 등), 채움 문자, 옛 자모(ㆍ 등)는 넓어지지 않는다.
“!”는 빈칸처럼 반 em에 장평을 곱한 뒤 반올림한다(7pt 장평 120 %에서 420이 아니라 416).
한양견고딕 “…”의 설계 폭은 3,933이 아니라 3,932다. 전에는 이런 글자가 든 문단에서 줄 폭을 1~2 배치 단위씩 다르게 잡았다. (실험) 줄 배치 정보 쓰기도 그런 문단의 탭 폭을 한/글과 같게 쓴다.
한양 글꼴(한양중고딕·한양신명조·한양견고딕)의 굵은 한글 음절 가운데 KS X 1001 완성형 2,350자에 없는 음절(갂·똠·햏·힣 등 8,822자)은 em과 그 1/20에 더해 1/1200 em만큼 더 넓게 잡는다. 40pt에서 굵은 “힣”은 4,200이 아니라 4,204다. 완성형 음절과 보통 글씨는 그대로다. 전에는 그런 음절이 든 굵은 문단의 줄 폭을 음절마다 1 배치 단위쯤 좁게 잡았고, (실험) 줄 배치 정보 쓰기가 굵은 한양중고딕·한양신명조 문단에 한/글과 다른 탭 폭을 쓸 수 있었다.
(실험) 줄 배치 정보 쓰기가 굵은 한양견고딕 문단에도 쓴다. 한양견고딕의 굵은 영문·숫자·기호·자모·한글 음절 폭이 한/글과 같아졌다.
[6.8.0] - 2026-10-06
import hwpx가 HWP 5.0 모듈과 hwpx.tools를 처음 쓸 때 읽도록 바꿔 가벼워진 릴리스입니다. FormFit은 글꼴
38종을 글꼴 파일의 설계 폭으로 재고, 수식 상자 폭은 한/글 저장값과의 평균 오차가 10.8%에서 3.6%로 줄었습니다.
그래서 FormFit이 고르는 글자 크기와 줄 수, add_equation이 쓰는 수식 상자 크기가 6.7.0과 달라질 수 있습니다.
save_report는 .hwp 경로를 HWP 5.0으로 씁니다. 쪽 수 추정(실험)은 개체·표·칸의 배치를 한/글 저장본에 맞춰
넓게 고쳤습니다. 코어는 6.7.0보다 약 6천 줄(7.7%) 늘었는데, 대부분 FormFit의 글꼴 폭 표(약 4,300줄)와 쪽 수
추정(약 1,300줄)입니다. import hwpx가 읽는 hwpx 모듈은 117개에서 97개로 줄었습니다. 저장 성공만으로 시각 품질을
보증하지 않습니다.
바꿈
import hwpx가 HWP 5.0 모듈(hwpx.hwp5)을 읽지 않는다..hwp를 열거나 HWP 5.0으로 저장할 때 처음 읽는다.Hwp5Error·Hwp5ConversionWarning은 이제hwpx.errors에 있고,hwpx와hwpx.hwp5.errors는 같은 클래스를 내보낸다.import hwpx가hwpx.tools(텍스트 추출·문서 비교·메일 머지·패키지 검증·내보내기 등)를 읽지 않는다.hwpx.TextExtractor·hwpx.doc_diff·hwpx.validate_package처럼hwpx.tools에 사는 이름은 처음 쓸 때 경고 없이 읽고, 같은 객체다. 위hwpx.hwp5와 합쳐import hwpx가 읽는 hwpx 모듈은 117개에서 97개로 준다. 저장은 여전히 처음 저장할 때 패키지 검증 도구를 읽는다.FormFit이 글꼴 12종(바탕·바탕체·돋움·돋움체·굴림·굴림체·궁서·궁서체·한컴 고딕·함초롬바탕·함초롬돋움·맑은 고딕)에서 KS X 1001 특수 기호와 전각 문자, 라틴-1·라틴 확장-A·일반 문장 부호·통화 기호·수학 연산자·도형·기타 기호·딩뱃· 반각/전각 형태 블록의 글자를 글꼴의 설계 폭으로 잰다. 전에는 흔한 문장 부호와 기호 몇십 자 말고는 글자 종류의 평균 폭을 썼다. 글꼴에 없는 글자는 한/글이 대신 그리는 글꼴(바탕·궁서와 -체 글꼴은 함초롬바탕, 굴림·돋움·맑은 고딕·한컴 고딕은 함초롬돋움, 함초롬 글꼴은 Segoe UI Symbol)의 폭을 그 글꼴 단위로 옮겨 쓴다. 이런 글자가 든 칸은 채우기 결과(글자 크기, 줄 수)가 달라질 수 있다.
기호 글꼴 Wingdings·Symbol도 문서가 글자를 두는 사용자 영역(U+F020–F0FF)의 설계 폭으로 잰다. 실제 너비를 쓰는 Wingdings 글머리표(U+F09F)는 10 pt에서 456을 차지한다.
HY헤드라인M도 글꼴의 설계 폭으로 잰다. 글꼴에 없는 글자와
`는 함초롬바탕의 폭을 쓴다.휴먼명조도 글꼴의 설계 폭으로 잰다. 글꼴에 없는 글자는 함초롬바탕의 폭을 쓴다.
FormFit이 한/글이나 Windows와 함께 오는 글꼴 26종도 글꼴의 설계 폭으로 잰다. 전에는 글자 종류의 평균 폭을 썼다. 이 글꼴로 쓴 칸은 채우기 결과(글자 크기, 줄 수)가 달라질 수 있다.
글꼴: 한컴산뜻돋움, 휴먼고딕, 한컴돋움, HY울릉도M·B, HY중고딕, HY견고딕, HY신명조, HY태백B, HY그래픽, 한컴바탕, 한컴 윤고딕 230·240·720·760, 한컴 윤체 L, 한컴 소망 M·B, 한컴 백제 B·M, 한컴 바겐세일 B·M, 새굴림, 한컴 말랑말랑 Regular·Bold, MD개성체
글꼴에 없는 글자는 한컴산뜻돋움·새굴림이 함초롬돋움의 폭을, HY중고딕·HY견고딕·HY신명조·한컴 말랑말랑 Regular가 함초롬바탕의 폭을 그 글꼴 단위로 옮겨 쓴다. 나머지 글꼴에 없는 글자는 전처럼 평균 폭이다.
한글 음절마다 폭이 다른 글꼴은 음절마다 그 폭을 쓴다(
_glyph_table.HANGUL_ADVANCES). 예를 들어 한컴 말랑말랑은 가로 모음(ㅗ·ㅛ·ㅜ·ㅠ·ㅡ)이 든 음절이 820/1000이고, 나머지는 880이다.
고침
쪽 수 추정(실험,
estimate_pages)이 글자처럼 둔 도형의 그림자를 줄 높이에 넣지 않던 것을 고친다.한/글은 그런 도형의 줄을 도형과 평행 그림자의 세로 이동만큼 높게 놓는다. 이동은 아래쪽 그림자면
offsetY + 600, 위쪽 그림자면offsetY - 600이다(아래가 양수). 그림자가 위로 가면 도형이 그만큼 아래에 그려진다. 선 굵기는 줄 높이에 더하지 않는다.전에는 도형 크기만 세어, 그런 도형 뒤 줄들이 그만큼 위에 놓였다.
쪽 수 추정(실험,
estimate_pages)이 글꼴에서 줄 높이를 정하는 문단 모양(fontLineHeight)을 무시하던 것을 고친다.한/글은 그런 문단의 줄을 글자 크기가 아니라 글꼴의 오름과 내림(OS/2 usWinAscent·usWinDescent)만큼 높게 놓고, 줄 간격도 그 높이에서 센다. 함초롬 글꼴과 한컴산뜻돋움은 1.3배, 맑은 고딕은 약 1.33배다. 바탕·굴림·HY 글꼴처럼 오름과 내림을 더하면 em인 글꼴은 크기 그대로다.
이제 줄 캐시가 없는 문단은 FormFit 글꼴 표에 더한 오름·내림으로 줄 높이를 잡는다. 오름과 내림을 각각 올림해 더하며, 한/글은 크기에 따라 1~2 더 높게 놓기도 한다. 표에 없는 글꼴은 전처럼 글자 크기다.
FormFit도 칸의 첫 문단이 그런 모양이면 칸에 들어가는 줄 수를 그 줄 높이로 센다(
SlotMetrics.font_line,line_size).
hwpx.tools도 공개 이름과 하위 모듈을 처음 쓸 때 읽는다. 첫 저장은 패키지·문서 검증기만 읽고, 내보내기·뷰어·문서 비교·메일 머지 등은 읽지 않는다. 기존 import·객체·타입 정보와doc_diff함수 이름을 유지한다. HWPX Markdown 변환기의 배포판 버전 조회도 변환 시점으로 미뤄,import hwpx가importlib.metadata를 읽지 않는다(#386).수식 상자 측정(
measure_equation,estimate_equation_size)의 폭을 한/글이 저장한 상자에 더 가깝게 고친다. 합성 수식 말뭉치(132식 × 기준 크기 1000·1100·1300, macOS 한/글 저장값)에 대한 폭의 평균 절대 오차가 10.8%에서 3.6%로 준다(1000: 8.4→2.8%, 1100: 15.0→6.1%, 1300: 8.9→1.9%). 높이(2.5%)와 기준선(평균 0.9)은 그대로다.글자 폭을 글리프별로 잰다. 숫자·기울인 글자는 더 좁고(
x0.52em, 숫자 0.47em),i·j·l·t는 좁고m·w는 넓다. 연산자·관계 기호는 기호마다 폭이 있고 양옆에 같은 간격을 둔다. 앞에 받을 것이 없는+·-는 부호라 뒤에만 간격을 둔다. 상자 끝의 여백은 없앤다.rm뒤의 글자는it이나 묶음 끝까지 바로 선 글자 폭으로, 함수 이름(sin·log등)도 바로 선 글자 폭의 합으로 잰다. 따옴표 안 글자는 그때의 글꼴 모양을 따른다.첨자의 폭은 본 크기의 0.55배가 아니라 0.66배로 잰다(높이는 그대로).
LEFT/RIGHT와 행렬이 늘이는 괄호는 괄호 모양마다((·[·|·{) 폭이 다르다.choose·binom은 한/글이pmatrix {n # r}과 같은 상자로 저장하므로, 늘인 괄호 안의 두 줄로 잰다.atop은 전처럼 가로줄 없는 분수다.상자는 여전히
baseUnit에 비례해 커진다. 한/글(macOS)은 글자 폭을 크기에 꼭 비례해 두지 않아(1100에서 글자가 1000과 같은 폭) 1100의 오차가 가장 크다. Windows 한/글에서의 비례는 아직 확인하지 않았다.
도형·그림·수식을 넣을 때 음수 크기와 사각형의 음수 모서리 곡률을 그대로 쓰던 것을 고친다.
한/글은 음수 크기를 0으로 읽고 0으로 저장한다. 그 크기에서 쓴 원래 크기(
orgSz)·회전 중심·그림의 이미지 크기(imgDim)도 0이 된다. 음수 곡률(ratio)도 0으로 읽는다.사각형·타원·호(
doc.shapes.add_rectangle·add_ellipse·add_arc), 그림(doc.add_picture), 수식 상자 (doc.shapes.add_equation의size), 도형 크기 바꾸기(HwpxOxmlShape.resize)는 이제 0 이상 2**31 미만의 크기만 받는다. 그 밖의 값은 문단·런·그림을 더하기 전에shape-size-value오류로 거부한다. 곡률은shape-rect-ratio-value로 거부한다.수식의
base_unit이 0 이하일 때 내던ValueError를shape-equation-base-unit-value(HwpxValueError)로 바꾸고 문단을 더하기 전에 낸다. 231 이상도 거부한다. 아주 큰base_unit으로 잰 상자가 231 이상이면shape-size-value로 거부한다. 한/글은 그런 상자를 2**32 - 1로 줄여 저장한다.HwpxOxmlParagraph.add_picture는 그림 요소를 만든 뒤에 런을 더한다. 값이 거부되면 빈 런이 남지 않는다.그림의 HWPUNIT 크기는 정수 변환 전에 검사한다. bool·소수·문자열을 정수로 바꾸어 받아들이지 않는다.
캡션 간격, 같은 폭 단의 간격, 새 번호를 한/글이 그대로 두지 않는 값도 그대로 쓰던 것을 고친다.
한/글은 캡션 간격(
hp:caption@gap)과 단 간격(hp:colPr@sameGap)을 부호 있는 16비트 수로, 새 번호 (hp:newNum@num)를 부호 없는 16비트 수로 읽는다. 범위 밖 값은 감싸 읽는다. 캡션 간격 32768은 −32768, 새 번호 −1은 65535, 65536은 0이 된다. 단 간격 32768은 −32768로 읽어 둘째 단이 첫째 단과 겹친다. 음수 글로 쓴 단 간격은 0으로 읽는다.이제 캡션 간격(
set_caption의gap)은 −32768 이상 32767 이하, 단 간격(doc.page.set_columns의same_gap,doc.page.setup의column_gap_mm)은 0 이상 32767 이하, 새 번호(doc.page.restart_page_number의number)는 0 이상 65535 이하만 받는다. 그 밖의 값은 무엇도 바꾸기 전에shape-caption-gap-value,page-column-gap-value,page-new-num-value오류로 거부한다.doc.page.setup은 쪽 크기와 여백을 바꾸기 전에 단 간격을 검사한다.
너비가 다른 단(
doc.page.set_columns(same_size=False, column_widths=...))의 너비와 간격을 한/글이 읽는 꼴로 쓴다. 한/글은hp:colSz의 너비와 간격을 HWPUNIT이 아니라 본문 폭을 32768로 나눈 몫으로 읽고, 단을 너비 × 본문 폭 / 32768로 놓는다. 전에는 받은 값을 그대로 써서, 본문 폭에 맞춰 HWPUNIT으로 준 단(A4에서[(20000, 1000), (21520, 0)])이 1.3배 넓게 놓여 둘째 단이 종이 밖으로 나갔다.이제
column_widths를 비율로 받아 합이 32768이 되게 맞춰 쓴다. 본문 폭에 맞춘 HWPUNIT 값은 그 너비 그대로 나오고, 합이 32768인 값은 그대로 쓴다.음수, 정수가 아닌 값, 모두 0인 값, 두 값이 아닌 쌍은 무엇도 바꾸기 전에
page-column-widths-value오류로 거부한다.쪽 수 추정(실험,
estimate_pages)도 단 너비를 너비 × 본문 폭 / 32768로 센다. 전에는 너비들의 합으로 나눴다. 한/글이 만든 문서는 합이 32768이라 결과가 같다.
쪽·구역·목록 설정에서 한/글이 그대로 두지 않는 값과, 음수를 조용히 0으로 쓰던 값을 거부한다.
한/글은 줄 번호의 시작·간격(
doc.page.set_line_numbers의start_number·count_by), 구역 시작 번호 (set_start_numbering), 목록 시작 번호(doc.styles.apply_list_format의start)를 부호 없는 16비트 수로, 쪽 테두리 오프셋을 부호 있는 16비트 수로 둔다. 그 밖의 값은 감싸 읽는다(예: 65536은 0). 모르는 제본 방식 (gutter_type)과 쪽 테두리 채울 영역(fill_area)은 기본값(LEFT_ONLY,PAPER)으로 읽는다.이제 번호는 0 이상 65535 이하, 줄 번호 거리와 재시작은 0 이상 231 미만, 쪽 테두리 오프셋은 0 이상 32767 이하, 쪽 크기와 여백은 0 이상 231 미만만 받는다. 쪽 테두리 종류(
page_type)는BOTH·EVEN·ODD, 채울 영역은PAPER·PAGE·BORDER, 제본 방식은LEFT_ONLY·LEFT_RIGHT·TOP_BOTTOM만 받는다. 음수 글자 크기(ensure_run의size)도 거부한다.그 밖의 값은 무엇도 바꾸기 전에 형식 있는 오류(
page-number-value,page-border-fill-invalid,page-gutter-type-invalid,page-size-value,style-list-start-value,style-run-size-value)로 거부한다. 전에는 음수를 0으로 쓰고, 범위 밖 값은 그대로 썼다.doc.page.setup은 쪽을 바꾸기 전에 크기와 여백을 검사한다.목록 시작 번호 0은 그대로 쓴다(한/글이 그대로 두고 1처럼 그린다). 전에는 1로 썼다.
구역에 없던 설정(쪽 테두리, 시작 번호, 줄 번호, 격자, 보이기 등)을 더할 때
TypeError가 나던 것을 고친다. 예를 들어 새 종류의 쪽 테두리를 만들면 그랬다.
새 표(
doc.add_table, 칸 안의add_table)와 열 너비 바꾸기(HwpxOxmlTable.set_column_widths)가, 한/글이 그리는 것보다 좁은 열을 그대로 쓰던 것을 고친다.한/글은 표의 열을 적어도 그 칸들의 왼쪽·오른쪽 여백과 283을 더한 폭(새 표는 510 + 510 + 283 = 1303)으로 그린다. 칸에 적힌 좁은 폭은 그대로 두고, 표는 그만큼 넓게 저장한다. 예를 들어 폭 0으로 쓴 2×2 표는 2606이 되고, 42520 폭 표에 열 비율 0과 1을 주면 43823이 된다.
이제 새 표는 적어도 열마다 그 폭으로,
set_column_widths는 그보다 좁은 열을 그 폭으로 쓰고 표 폭을 그만큼 늘린다. 그래서 쓴 표가 한/글이 그리고 저장하는 표와 같다. 폭을 주지 않은 좁은 칸 안의 표도 그렇다.새 표의 폭이 0 초과 2**31 미만의 int가 아니면, 문단이나 테두리 채우기를 더하기 전에
table-width-value오류로 거부한다. 전에는 0이나 음수 폭을 0으로 썼다.
문단에서 새 단을 시작하는 단 정의(
doc.page.set_columns(..., paragraph=...),add_column_definition)를 문단의 글 뒤 런에 쓰던 것을 고친다. 한/글은 문단의 글보다 앞에 있는 단 정의로만 새 단을 시작하고(한/글 문서는 그것을 문단의 첫 런에, 구역 설정 다음에 둔다), 글 뒤에 있으면 새 영역만 열고 단은 적용하지 않아 뒤 글이 본문 폭으로 놓였다. 이제 단 정의의 런을 문단의 글보다 앞에 쓴다.구역의 첫 문단에서는 구역 설정 옆 단 정의를 그 자리에서 고쳐 쓴다(문단을 주지 않은
set_columns와 같다). 첫 문단에 단 정의가 하나 더 있으면 한/글이 문서를 열지 못한다.
쪽 수 추정(실험,
estimate_pages)이 구역 안에서 단이 바뀌는 문서를 지원 밖(the columns change inside the section)으로 두던 것을 고친다. 이제 한/글처럼 단 영역별로 놓는다.구역 첫 문단 뒤에서 단 정의를 가진 문단은 새 단 영역을 시작한다.
영역은 앞 영역이 끝난 쪽에서, 앞 영역의 가장 낮은 줄 아래끝보다 1134(4mm) 아래에 시작한다. 줄 간격이나 문단 간격과 상관없다. 자리가 없으면 다음 쪽 위에서 시작한다.
영역의 줄 위치는 그 쪽에서 영역 위쪽부터 센다(한/글의 줄 캐시와 같다).
다음 영역이 오는 영역은 마지막 쪽의 단을 높이로 균형 맞춘다. 모든 줄이 그 쪽에 남는 가장 짧은 단이다. 균형 다단(
BALANCED_NEWSPAPER)의 단 나누기도 새 균형 영역을 연다.문단의 글 뒤에 있는 단 정의는 영역만 새로 열고 단은 바꾸지 않는다.
단이 바뀌는 구역의 각주와 쪽·종이 기준 개체는 여전히 지원 밖이다.
쪽 수 추정(실험,
estimate_pages)이 쪽 번호 조판 부호(hp:ctrl/hp:pageNum)와 줄보다 넓은 글자처럼 둔 표만 있는 문단을 표 높이의 한 줄로 세던 것을 고친다.한/글은 둘을 한 줄에 두지 않는다. 부호의 줄은 문단 글의 빈 줄이다.
부호가 앞이면 빈 줄 다음에 표의 줄이 오고, 표 뒤면 표의 줄 다음에 빈 줄이 온다.
표가 줄에 들어가거나, 앞에 구역·단 정의 부호만 있으면 전처럼 한 줄이다.
쪽 수 추정(실험,
estimate_pages)이 줄보다 넓은 글자처럼 둔 표 곁의 다른 조판 부호(감출 쪽 번호, 새 번호, 자동 번호, 머리말·꼬리말, 쪽 번호 위치, 책갈피, 누름틀, 찾아보기 표시 등)를 표의 줄에 함께 세던 것을 고친다.한/글은 단 정의(
hp:colPr)를 뺀 모든 조판 부호를 쪽 번호처럼 표와 다른 줄에 둔다. 표 앞의 부호는 표 위의 빈 줄, 표 뒤의 부호는 표 아래의 빈 줄이다.그때 표의 줄 간격은 표가 든 런의 글자 크기로, 부호 줄은 그 부호들이 든 런의 글자 크기로 센다. 전에는 문단 모든 런 가운데 가장 큰 글자로 셌다.
쪽 수 추정(실험,
estimate_pages)이 문단 글 뒤에 놓인 어울림(SQUARE) 개체를 지원 밖 (... wrapped square after text)으로 두던 것을, 그 개체의 조판 부호가 문단 첫 줄에 있을 때 고친다.한/글은 개체의 문단 기준 세로 자리를 부호가 놓인 줄(문단을 단 전체 폭으로 놓았을 때)의 윗선에서 잰다. 부호가 첫 줄에 있으면 문단 윗선이라, 글 앞에 놓인 개체와 같다. 띠에 닿는 줄은 그 문단의 줄도 곁으로 간다.
첫 줄은 FormFit으로 문단을 단 전체 폭에서 나누어 가린다. 부호가 뒤 줄에 있으면 전처럼 지원 밖이다.
쪽 수 추정(실험,
estimate_pages)이 문단 맨 위(세로 위치 0)에 둔 위아래 배치 개체가 본문 바닥을 넘을 때 문단째 다음 쪽으로 넘기거나(빈 문단) 지원 밖(... anchored in text at a page end)으로 두던 것을 고친다.한/글은 글과 함께 움직이는 개체(
flowWithText)면 개체만 다음 쪽 본문 맨 위로 보낸다. 문단의 줄은 빈 줄이든 글 줄이든 제자리에 전체 폭으로 남고, 다음 쪽 내용은 개체 아래에서 시작한다. 문단 위치에서 아래로 내려 둔 개체(세로 위치 > 0)에 쓰던 규칙과 같다.글과 함께 움직이지 않는 개체는 그 쪽에 남아 바닥을 넘는다. 이때 들어가야 하는 것은 문단의 줄뿐이고, 다음 문단은 개체 아래(대개 다음 쪽 맨 위)에서 시작한다.
개체만 넘기는 것은 문단 자기 줄이 제자리에 들어갈 때뿐이다. 줄도 안 들어가면 문단째 넘어간다(문단 위치에서 내려 둔 개체도 같다). 개체가 혼자 넘어간 쪽을 따르지 못하는 구역(그 띠를 흐르는 표가 지나가는 등)은 예전처럼 개체를 문단과 함께 넘겨 다시 놓는다.
개체가 넘어간 쪽에서, 통째로 넘어간 위아래 배치 표는 개체 아래에서 시작하고 그 문단 줄은 앞 쪽에 남는다. 앞 쪽에서 나뉘어 이어지는 표는 그 쪽 맨 위에서 개체와 겹쳐 이어지고, 뒤 글은 둘 아래에서 시작한다. 그 쪽으로 넘어간 표 문단은 개체 아래에서 쪽 맨 위처럼 놓인다.
쪽 수 추정(실험,
estimate_pages)이 줄을 나누지 않는 표 칸(hp:subList@lineWrap이 SQUEEZE나 KEEP)의 글을 칸 폭에서 나누던 것을 고친다.한/글은 그런 칸의 문단을 한 줄로 두고, 그릴 때 칸 폭에 눌러 넣는다. 줄 바꿈과 문단 나눔만 새 줄을 연다.
이제 캐시 없는 그런 칸의 줄을 줄 바꿈마다 한 줄로 센다.
쪽 수 추정(실험,
estimate_pages)이 표 칸 문단에 홀로 둔 위아래 배치 표(중첩 표)를 바깥 칸의 한 줄로 세어, 바깥 행이 쪽 끝에 걸리면 그 행을 쪽 바닥에서 그대로 자르던 것을 고친다.한/글은 그런 표를 행 사이에서 나눈다(쪽 나눔 CELL·TABLE). CELL이면 여러 줄인 행도 줄 사이에서 나누고, 나뉜 행의 각 부분에 칸 여백을 둔다. 머리행 반복이면 다음 쪽 부분 위에 머리행을 다시 둔다.
이제 그 표를 행(또는 줄) 조각으로 펼쳐 바깥 칸의 줄처럼 나눈다. 글자처럼 둔 중첩 표는 전처럼 나뉘지 않고 통째로 넘어간다. 나누지 않는 표(NONE), 아래로 내려 둔 표, 캡션이 있거나 행이 병합된 표는 전처럼 한 덩어리다.
쪽 수 추정(실험,
estimate_pages)이 글과 함께 움직이고 나뉠 수 있는 어울림(SQUARE) 표가 본문 바닥을 넘을 때, 줄 캐시가 없으면 지원 밖으로 두던 것을 고친다.한/글은 그런 표를 흐르는 표처럼 쪽 끝에서 행 사이나 칸 줄 사이로 나눈다. 표가 걸친 쪽마다 곁 줄은 그 쪽 부분 곁으로 간다. 첫 쪽은 표 위부터 바닥까지, 표가 쪽을 다 덮으면 그 쪽 모든 줄, 마지막 쪽은 맨 위부터 표 끝까지다.
이제 그 표를 흐르는 표처럼 놓아 쪽마다 띠를 두고, 띠에 닿는 줄을 다시 나눈다.
한 쪽에 띠가 둘이면(앞 표의 끝과 다음 표의 시작) 둘 다 둔다. 한 문단이 두 띠에 걸치면 지원 밖이다.
쪽 수 추정(실험,
estimate_pages)이 문단 글 앞에서 조판 부호만 든 런(구역·단 정의, 쪽 번호, 자동 번호, 꼬리말 등)의 글자 크기를 줄 높이에서 빼던 것을 고친다.한/글은 그런 런의 글자를 첫 줄의 글자로 센다. 그 런이 글보다 크면 첫 줄이 그만큼 높다. 머리표·번호와 같다.
부호도 글도 없는 빈 런은 전처럼 자리를 차지하지 않는다.
쪽 수 추정(실험,
estimate_pages)이 앞 문단의 어울림(SQUARE) 개체 띠가 남은 채 위아래 배치 개체(표 등)를 글 앞에 둔 문단을 지원 밖(... beside a square-wrapped object)으로 두던 것을, 그 문단의 줄이 띠에 닿지 않을 때 고친다.한/글은 그 개체를 띠와 상관없이 자기 위치(문단 윗선 + 세로 위치)에 놓고, 겹치면 띠의 개체 위에 그린다. 문단의 글 줄은 개체 아래에서 시작한다.
이제 개체가 첫 줄에 닿아 줄을 자기 아래로 밀고 그 발이 띠 끝보다 낮으면, 그 문단을 띠 없이 놓는다. 개체 아래 줄이 아직 띠에 닿는 경우와 어울림 개체가 둘인 경우는 전처럼 지원 밖이다.
쪽 수 추정(실험,
estimate_pages)이 글과 함께 움직이는 어울림(SQUARE) 그림·도형이 본문 바닥을 넘을 때, 줄 캐시가 없으면 지원 밖으로 두던 것을 고친다.한/글은 그 개체를 띄움과 상관없이 다음 쪽 본문 맨 위로 옮긴다. 개체가 있던 쪽의 줄은 모두 전체 폭이다. 다음 쪽에서 줄 위가 개체 아래 끝보다 위인 줄은 개체 곁으로 간다.
이제 그 쪽들을 다시 놓는다. 개체 문단과 뒤 문단을 전체 폭으로 나누고, 다음 쪽 맨 위의 개체 곁에서 줄을 다시 나눈다. 그 자리에 개체·각주가 든 문단이나 표가 오면 지원 밖이다.
나누지 않게 둔 어울림 표도 그렇게 옮겨 간다. 나뉘는 어울림 표는 쪽 끝에서 나뉜다(아래 항목).
문단 줄 아래로 띄워 위아래로 둔 그림·도형도, 문단이 놓인 자리에서 개체 발이 바닥을 넘으면 다음 쪽 맨 위로 옮겨 간다. 문단 줄은 제자리에 남고, 다음 쪽에서 개체에 닿는 줄은 그 아래로 간다. 캐시가 있을 때도 전에는 문단째 다음 쪽으로 보냈다.
양옆에 글이 가는 개체 곁의 줄은, 글이 첫 조각에서 끝나거나 글이 없어도 두 조각이다(둘째는 빈 조각). 캐시 없는 추정도 이제 그렇게 센다.
문단 첫 줄을 그림 아래로 밀어낸 위아래 그림은, 밀린 줄 자리에 그림 높이를 한 번 더 더해 바닥을 넘는다고 보아 지원 밖으로 두었다. 이제 밀리기 전 줄 자리에서 잰다.
쪽 수 추정(실험,
estimate_pages)이 세로쓰기 칸(hp:subList@textDirection="VERTICAL")의 글을 가로 글처럼 칸 폭에서 나누어 행을 키우던 것을 고친다.한/글은 세로쓰기 칸의 줄을 칸 높이를 따라 세로로 놓고 옆으로 늘어놓는다. 넘치는 글은 잘리고, 행은 선언 높이 그대로다.
세로쓰기 칸이 있는 흐르는 표는 쪽 끝에서 나뉘지 않고, 나누지 않게 둔 표처럼 통째로 다음 쪽으로 간다. 기준 문단 줄과 그 뒤 글은 앞 쪽에 남는다.
쪽 수 추정(실험,
estimate_pages)이 표 칸의 글을 칸 자신의 폭(hp:cellSz)에서 나누던 것을 고친다. 같은 열의 칸들이 폭이 다르면 한/글은 칸을 표 격자의 폭으로 놓는다.열은 왼쪽부터 쌓는다. 열마다 그 열에서 끝나는 칸들의 시작 + 폭(+ 칸 간격
cellSpacing) 가운데 가장 먼 곳에서 끝난다. 그래서 열은 그 열 낱칸 가운데 가장 넓은 것만큼 넓고, 여러 열을 합친 칸이 그 열들보다 넓으면 넘침이 마지막 열에 붙는다.칸은 첫 열의 시작부터 마지막 열의 끝까지다. 다른 행 때문에 자기 폭보다 넓어질 수 있다.
줄 캐시가 없는 칸의 줄 나눔과 행 높이에 쓴다(
hwpx.oxml.table_sizes.grid_widths_of).FormFit(
resolve_slot_metrics)도 칸의 자리를 그 폭에서 잰다(SlotMetrics.raw_width). 전에는 칸 자신의hp:cellSz폭이었다.
쪽 수 추정(실험,
estimate_pages)이 표의 칸 간격(hp:tbl@cellSpacing)을 표 높이에서 빠뜨리던 것을 고친다.한/글은 행마다 위에 칸 간격을 두고, 마지막 행 아래에도 하나 둔다. 쪽을 넘는 표는 바깥 여백처럼 쪽마다 그 쪽 조각의 마지막 행 아래에 간격을 다시 두고, 다음 쪽 첫 행 위에도 간격이 있다.
글자처럼 둔 표의 줄은 행들과 그 위아래 간격만큼 높다.
쪽 수 추정(실험,
estimate_pages)이 줄 캐시 없는 표 칸에서 글자처럼 둔 표 옆에 글 앞·뒤로 둔 개체가 있는 문단을 지원 밖(a nested table)으로 두던 것을 고친다.그런 개체는 자리를 차지하지 않으므로, 그 문단은 표 혼자인 문단처럼 표 높이의 한 줄이다.
위아래로 둔 표 옆에 그런 개체가 있으면 한/글은 빈 줄을 표 아래에 둔다(표 둘일 때처럼). 이제 캐시 없이도 따른다(아래 항목).
쪽 수 추정(실험,
estimate_pages)이 글 없는 문단에 문단 위에서 위아래로 둔 개체(표·그림)와 글 앞·뒤로 둔 개체가 함께 있을 때, 빈 줄을 위아래 개체의 윗선에 두던 것을 고친다.한/글은 공백이나 머리표가 있을 때처럼 빈 줄을 그 개체 아래에 전체 폭으로 둔다. 뜬 개체가 종이 기준이든 문단 기준이든, 글 앞이든 뒤든 같다.
위아래 개체만 있으면 전처럼 윗선에 폭 0이다.
본문과 표 칸 모두 그렇다. 표 칸에서는 전에 캐시 없이 지원 밖(
a nested table)이었다.
쪽 수 추정(실험,
estimate_pages)이 위아래 배치 개체와 글자처럼 둔 개체가 함께 있는 문단 일부를 지원 밖 (an object with text or other objects in its paragraph)으로 두던 것을 고친다.글 없는 문단에 문단 위에서 위아래로 둔 개체가 여럿이면, 한/글은 그 개체들을 쌓고 글자처럼 둔 개체의 줄을 그 아래에 둔다. 런 순서와 상관없다. 전에는 위아래 개체가 하나일 때만 셌다.
글 문단의 줄 아래로 띄워 둔 위아래 개체는 글 속에 글자처럼 둔 개체가 있어도 같다. 문단 줄은 제자리이고, 개체 띠에 닿는 줄은 개체 발 아래로 간다. 그 줄이 다음 쪽으로 가도 개체는 첫 줄의 쪽에 남는다.
글자처럼 둔 개체가 있는 문단에서 문단 위보다 위로 둔(세로 위치가 음수인) 위아래 표는 문단 윗선에 놓는다. 한/글은 표의 음수 세로 위치(부호 없는 32비트로 적힌다)를 0으로 보고 그 자리에 그린다.
공백만 든 문단도 글 문단이다. 공백 하나라도 있으면, 문단 줄 아래로 띄운 위아래 개체에 닿는 그 줄은 개체 발 아래로 간다. 빈 문단의 줄만 전처럼 문단 윗선에 남는다.
쪽 수 추정(실험,
estimate_pages)이 글자처럼 둔 개체 하나와 공백·줄 바꿈만 있는 문단을 언제나 한 줄로 세던 것을 고친다.한/글은 개체 바로 뒤 공백 둘을 여백을 넘어도 그 줄에 두고, 그다음 공백이 여백이나 그 너머에서 시작하면 다음 줄로 넘긴다. 개체 앞에 공백이 있고 그 뒤에 개체가 들어가지 않으면 개체가 다음 줄로 간다.
개체 앞뒤의 줄 바꿈도 새 줄을 연다. 개체 앞의 빈 줄은 글 한 줄만큼 내려간다.
이제 그런 문단을 FormFit 줄 나눔으로 나누고, 줄마다 높이를 센다(본문과 표 칸). 넘치지 않으면 전처럼 개체 높이의 한 줄이다.
유효한 줄 캐시가 있으면 다른 문단처럼 캐시의 줄(한/글이 파일을 열 때 쓰는 줄)을 그대로 쓰고, 캐시가 없을 때만 FormFit으로 나눈다.
FormFit
hancom_line_starts가 개체 자리(objects)를 받아, 개체 바로 뒤 둘째 공백도 여백 밖에 매단다.
쪽 수 추정(실험,
estimate_pages)이 글자처럼 둔 개체만 있는 문단의 줄 간격을, 문단 줄 간격의 종류와 상관없이 글자 크기에서 세던 것을 고친다.고정 줄 간격이면 다음 줄은 개체가 더 높아도 그 값만큼만 내려간다(개체는 겹쳐 그려진다).
최소 줄 간격이면 줄 사이는 개체 높이와 그 값 가운데 큰 쪽이다.
비율 줄 간격은 전처럼 글자 크기에서 센다. 개체를 줄 간격에 영향을 주게 둔 것(
hp:pos@affectLSpacing) 이면 줄 높이(개체 높이)에서 센다.본문과 표 칸 모두 그렇다.
쪽 수 추정(실험,
estimate_pages)이 줄 캐시 없는 표 칸에서 글자처럼 둔 표가 글 사이에 있거나 여럿인 문단을 지원 밖(a nested table)으로 두던 것을 고친다.이제 본문처럼 그 문단의 줄에 놓는다. 줄은 그 줄의 표와 글 가운데 큰 쪽만큼 높고, 들어가지 않는 표는 다음 줄로 간다.
칸 문단에 둔 머리말·꼬리말·각주 같은 컨트롤 안의 표는 그 칸이 아니라 컨트롤 자리에 놓이므로, 칸 안 표로 세지 않는다.
저장할 때, 줄이 개체 양옆 두 조각으로 나뉘고 오른쪽 조각이 비어 있는 한/글 줄 캐시를 낡은 것으로 보고 지우던 것을 고친다.
한/글은 그런 빈 조각(
hp:lineseg@flags의 16번 비트)을 글 끝 바로 다음 자리(textpos= 글 길이 + 1)에서 시작한다.전에는
textpos가 글 길이를 넘으면 문단의 줄 캐시를 통째로 지워, 무편집 저장에서도 캐시가 사라졌다.패키지 검사(
validate_package)와 레이아웃 검사도 이를 낡은 캐시로 보고했다.이제 글 끝 바로 다음의 빈 조각만 받아들인다. 그보다 뒤이거나 비지 않은 조각은 전처럼 낡은 캐시다.
쪽 수 추정(실험,
estimate_pages)이 글과 함께 움직이지 않게 둔(flowWithText="0") 어울림(SQUARE) 개체가 본문 바닥을 넘으면 지원 밖으로 두던 것을 고친다.한/글은 그런 개체를 다음 쪽으로 옮기지 않고 제 쪽에 둔다(바닥을 넘어 그린다).
곁 줄은 그 쪽 끝까지 좁게 이어지고, 다음 쪽 줄은 개체 없이 전체 폭이다.
이제 그 개체를 옮기지 않는다. 곁 문단이 다음 쪽으로 넘어가도, 그 줄이 캐시를 지키거나 글이 없으면 따른다. 글과 함께 움직이는 개체는 전과 같다.
쪽 수 추정(실험,
estimate_pages)이 문단 줄 아래로 띄워 둔 흐르는 위아래 표 바로 다음 문단에 또 그런 표가 있으면 지원 밖(a page break or another object beside a top-and-bottom table's band)으로 두던 것을 고친다.한/글은 뒤 문단을 앞 표의 발(쪽을 넘었으면 다음 쪽 조각의 발)에서 시작한다. 뒤 문단의 표는 그 문단 윗선
세로 위치에 놓이고, 그 뒤 글은 그 표의 발에서 시작한다.
뒤 문단의 첫 줄이 앞 표에 닿지 않으면 전처럼 지원 밖이다.
쪽 수 추정(실험,
estimate_pages)이 개체 하나만 든 빈 문단에 위아래로 띄워 둔 표나 그림을, 문단을 ‘띄운 거리개체 높이’만큼 높은 한 줄로 세어 뒤의 모든 줄을 개체 아래로 보내던 것을 고친다.
한/글은 빈 문단의 줄을 제자리에 둔다(개체의 띠가 그 줄 아래끝보다 위에서 시작하면 폭 0인 빈 조각이 된다).
뒤 줄은 보통 간격으로 놓이다가, 띠와 겹치는 첫 줄부터 띠 아래끝으로 간다(줄 간격은 겹침에 넣지 않는다).
흐르는 표는 홀로 둔 표처럼 앞 간격 위 문단 위쪽부터 띄운 거리를 잰다.
쪽 수 추정(실험,
estimate_pages)이 표 칸 첫 문단의 앞 간격을 칸 높이에서 빠뜨리던 것을 고친다.한/글은 칸의 첫 줄을 그 간격만큼 아래에서 시작한다. 글이 선언 높이보다 길면 행이 그만큼 더 늘어난다.
행이 쪽을 넘어 줄 사이에서 나뉘면 다음 쪽 부분에는 붙지 않는다(문단 중간 줄이므로). 행째 넘어가는 표는 행마다 붙는다.
글자처럼 둔 표도 그렇다.
쪽 수 추정(실험,
estimate_pages)과 FormFit이, 들여쓰기나 내어쓰기가 줄에 1440보다 좁은 폭을 남기는 문단의 그 줄을 1440 폭으로 놓고 나누던 것을 고친다.한/글은 그런 들여쓰기를 통째로 무시하고 문단의 모든 줄을 전체 폭으로 놓는다. 글자 크기와 상관없다.
1440 이상을 남기면 전처럼 들여쓰기를 둔다. 글자 하나가 들어가지 않을 만큼 좁아도 줄마다 한 글자씩 둔다.
글머리표·번호가 있는 문단은 전과 같다.
쪽 수 추정(실험,
estimate_pages)이 글상자(hp:drawText)가 든 도형의 높이를hp:sz로만 세던 것을 고친다.한/글은 글상자의 글이 넘치면 도형을 글과 위아래 글 여백만큼 늘려 그린다. 늘어난 크기는
hp:curSz에만 적고 (hp:sz는 그대로 둔다), 가끔 1 작게 적는다.이제 글상자의 글(캐시가 있으면 그 줄, 없으면 배치한 줄)과 위아래 글 여백을 더한 높이, 그리고
hp:curSz가운데 큰 쪽이hp:sz보다 높으면 그 높이로 센다.글자처럼 둔 것과 그렇지 않은 것, 본문과 표 칸 모두 그렇다. 글이 넘치지 않으면 전처럼
hp:sz다.위아래로 뒤집은 도형은
hp:curSz가 음수로 적힌다. 그 크기를 쓴다.
HwpxDocument.save_report가.hwp경로에도 HWPX 패키지(ZIP)를 써서, 확장자와 다른 형식의 파일이 경고 없이 생기던 것을 고친다(#375). 이제save_to_path처럼 HWP 5.0으로 쓴다. HWP 5.0으로 담을 수 없는 내용이면 아무것도 쓰기 전에Hwp5Error(hwp5-write-unsupported)를 낸다. 저장 관문은 전처럼 HWPX 부분을 검사하고, 통과했을 때만 쓴다.도형 위치(
HwpxOxmlShape.set_position)와 새 연결선(doc.shapes.add_connector)이 기준 위나 왼쪽으로 둔 음수 오프셋을"-2000"처럼 부호 있는 수로 쓰던 것을 고친다.한/글은 음수 오프셋을 부호 없는 32비트(
4294965296)로 적고 읽는다. 부호 있는 수는 0으로 읽어, 도형이 기준 가장자리에 그려지고 다시 저장하면 0이 된다. 스키마도 음 아닌 정수다.이제 둘 다 부호 없는 32비트로 쓴다. 연결선은 잇는 도형의 오프셋을 부호 있는 수로 다시 읽는다.
쪽 수 추정(실험,
estimate_pages)이 흐르는 표가 그 문단 줄보다 뒤 쪽에서 끝날 때, 다음 문단을 한/글처럼 둔다.한/글은 다음 문단의 줄을 개체 띠 아래로 밀린 줄처럼 표 끝 바로 아래에 둔다. 그 문단의 앞 간격은 자리를 차지하지 않는다. 전에는 앞 간격을 더했다.
그 문단이 단 나누기로 시작하면 앞 문단 줄의 다음 단에 놓인다. 1단이면 표가 끝난 쪽의 표 아래다. 전에는 그 다음 쪽으로 보냈다.
쪽 나누기는 전처럼 표가 끝난 쪽의 다음 쪽 맨 위다.
쪽 수 추정(실험,
estimate_pages)이 쪽이나 용지 기준으로 세로 가운데에 둔 위아래 개체를 지원 밖 (... placed TOP_AND_BOTTOM relative to PAGE·PAPER)으로 두던 것을 고친다.한/글은 그 개체를 본문(쪽 기준)이나 용지(용지 기준)의 세로 가운데에 놓고, 세로 위치만큼 내린다. 음수면 올린다(부호 없는 32비트로 적힌다). 그 쪽에서 개체 띠에 닿는 줄은 띠 아래로 간다.
위·아래 기준은 전과 같다.
쪽 수 추정(실험,
estimate_pages)이 표 칸 문단에서 위아래로 둔 그림·도형을 한/글처럼 센다.캐시가 있으면 표가 든 칸처럼 칸 줄을 한/글이 둔 자리대로 센다. 개체 아래로 밀린 줄과, 개체 끝까지 닿는 칸이 그대로 들어간다.
위로 띄운 개체(음수 띄움)는 그 문단 윗선에 선다. 칸 위나 앞 문단으로 올라가지 않는다. 전에는 띄움만큼 위로 셈해 행 높이에서 빠졌다.
개체 뒤에 글이 있으면(공백 하나나 글머리표·번호도) 그 줄은 개체 아래로 간다. 캐시가 없을 때 표 뒤 글만 그렇게 셌던 것을 그림·도형으로 넓힌다.
쪽 수 추정(실험,
estimate_pages)이 표 위·아래 캡션의 높이에서 캡션 첫 문단의 앞 간격을 빠뜨리던 것을 고친다. 한/글은 캡션의 첫 줄을 그 간격만큼 아래에서 시작한다. 캡션이 차지하는 자리는 그 앞 간격과 줄들과 gap을 더한 높이다. 마지막 문단의 뒤 간격은 들지 않는다. 글자처럼 둔 표와 흐르는 표 모두 그렇다.쪽 수 추정(실험,
estimate_pages)이 위아래 배치 개체(표·그림) 뒤에 공백만 있는 문단, 그리고 글머리표·번호가 붙은 문단을 글 없는 문단으로 보던 것을 고친다.한/글은 공백과 머리표·번호도 글로 본다. 그 줄을 개체 아래에 전체 폭으로 두고, 다음 문단은 그 줄 아래에 둔다.
공백도 머리도 없을 때만 줄을 개체 윗선에 폭 0으로 둔다.
공백은 본문과 표 칸 모두, 머리표·번호는 본문에서 따른다.
공백만 있는 한 줄 문단의 표가 그 자리에서 시작하지 못하면 표 혼자인 문단처럼 놓는다. 표는 다음 쪽 맨 위에서 시작하고, 문단 줄은 제자리에 남으며, 뒤 글은 그 줄 아래에 이어진다. 나누지 않게 둔 표도 같다.
쪽 수 추정(실험,
estimate_pages)이 줄 캐시 없는 표 칸에서 위아래 배치 표 하나가 든 문단을 지원 밖 (a nested table)으로 두던 것을 고친다. 이제 그림·도형처럼 칸이 그 표의 아래 끝(행으로 잰 표 높이와 바깥 여백)까지 닿고, 칸의 다음 줄은 그 아래에서 이어진다. 위로 띄운 표는 문단 윗선에 선다. 그런 행이 쪽을 넘어 줄 사이에서 나뉠 때도 표는 그 높이의 한 줄로 센다. 글 앞에 둔 그런 표는 거기 닿는 첫 줄부터 표 아래로 보낸다. 한 문단에 표가 둘이면 한/글은 빈 줄을 아래 표 밑으로 보내므로 전처럼 캐시가 있어야 한다.쪽 수 추정(실험,
estimate_pages)이 위아래 개체의 띠에 닿는 줄에 글자처럼 둔 개체가 있으면 지원 밖 (a page break or another object beside a square-wrapped object)으로 두던 것을 고친다. 한/글은 그런 줄도 글 줄처럼 띠 아래로 보낸다. 글자처럼 둔 개체가 줄 높이를 키우지 않으면 줄 높이는 글 높이 그대로다.쪽 수 추정(실험,
estimate_pages)이 어울림(SQUARE) 개체 곁 띠에 글자처럼 둔 개체 하나만 든 빈 문단을 지원 밖 (an object beside a square-wrapped object)으로 두던 것을 고친다. 한/글은 개체가 곁 자리보다 넓으면 그 줄을 띠 아래로 보내 전체 폭에 두고, 좁으면 곁에 둔다.쪽 수 추정(실험,
estimate_pages)이 어울림 개체 곁 띠에서 글 사이에 글자처럼 둔 개체가 든 문단을 띠 없이 세던 것을 고친다. 이제 띠 안에서 시작하는 줄은 곁 자리 폭으로 나눈다. 곁 자리보다 넓은 개체가 든 첫 줄은 한/글처럼 띠 아래로 보내 전체 폭에 두고, 곁의 남은 자리는 비운다. 글이 개체 양쪽에 놓이는 띠에서는 지원 밖 (objects set as characters among text beside a square-wrapped object)이다.쪽 수 추정(실험,
estimate_pages)이 칸 단위로 나누는 흐르는 표(pageBreak="CELL")에서 병합 칸으로 이어진 행들이 한 쪽보다 길면 “rows merged together taller than a page”로 거부하던 것을 고친다. 한/글은 쪽 끝마다 다시 나눈다. 칸마다 그 쪽에 들어가는 줄까지 두고 나머지는 다음 쪽 머리 행 아래로 넘기며, 넘긴 부분이 다시 쪽보다 길면 그 쪽 끝에서 또 나눈다. 행들보다 긴 병합 칸은 행이 끝난 뒤에도 혼자 다음 쪽들로 이어진다. 글보다 높게 선언된 칸의 남는 높이도(글이 다 들어간 뒤에도) 쪽 끝마다 행처럼 잘려 이어진다. 어느 쪽에도 한 줄도 들어가지 않는 칸만 전처럼 거부한다. 줄 사이에서 나뉜 선언 행의 다음 쪽 부분은 선언 높이의 나머지와, 이어지는 줄에 칸 위아래 여백을 더한 높이 가운데 큰 쪽이다. 이어지는 줄이 있으면 남은 높이가 낮아도 버리지 않는다.쪽 수 추정(실험,
estimate_pages)이 곁에 자리를 남기는 종이·쪽 기준 어울림(SQUARE) 개체의 띠에 닿는 줄을, 그 줄이 줄 캐시를 가질 때 따른다. 한/글은 그런 줄을 같은 높이·간격으로 개체 곁에 좁혀 둔다(양옆에 자리가 있으면 한 높이에 두 조각). 캐시 없는 줄·표·개체가 닿으면 전처럼 지원 밖이다.쪽 수 추정(실험,
estimate_pages)이 같은 폭의 여러 단 쪽에서 종이 기준으로 둔 위아래 배치 개체가 본문 너비를 다 덮지 않으면 지원 밖(objects placed on the paper)으로 두던 것을 고친다. 한/글은 개체가 가로로 걸치는 단에서만 줄을 개체 아래로 보내고, 걸치지 않는 단의 줄은 개체가 없을 때 자리에 둔다. 이제 종이의 왼쪽·가운데· 오른쪽을 기준으로 둔 개체는 바깥 여백까지 쳐서 걸치는 단마다 그렇게 놓는다.hwpx.experimental.latex_to_eqedit(실험)가e^{it},x_{rm}처럼 글자가rm·it·bold가 되는 식별자를 그대로 쓰던 것을 고친다. 한/글은 이 낱말을 글꼴 전환으로 읽어서, 첨자에 홀로 오면 아무것도 그리지 않는다. 이제 다른 예약어처럼 따옴표로 감싸 쓰고(e ^{"it"}),eqedit_to_latex는 그것을 다시 글자로 읽는다.latex_to_eqedit가\lbrace·\rbrace를\{·\}처럼LBRACE·RBRACE로 옮긴다(\left·\right뒤에서도). 전에는 지원하지 않는 명령이었다.eqedit_to_latex는LEFT·RIGHT밖의 맨LBRACE·RBRACE를\{·\}로 읽는다. 전에는 낱말 그대로 남았다.수식 상자 설명에, Windows의 한/글은 저장할 때 상자(
hp:sz)와baseLine을 그대로 두고 그 상자로 쪽을 배치한다는 점을 더한다.쪽 수 추정(실험,
estimate_pages)이 줄 캐시 없는 표 칸 문단에서 글자처럼 둔 개체(그림·도형·수식 등)를 세지 않던 것을 고친다. 전에는 칸 문단에 혼자 든 표만 그 높이로 셌고, 다른 개체는 없는 것처럼 줄을 세어 행이 한/글보다 낮았다. 이제 개체 하나만 든 문단은 개체 높이의 한 줄이고 줄 간격은 글자 크기로 센다. 글 사이에 있거나 여럿이면 본문처럼 개체의 폭과 높이로 줄 안에 놓는다.쪽 수 추정(실험,
estimate_pages)이 빈 문단에 문단 위 기준으로 둔 위아래 개체 여럿(표·그림)을 지원 밖 (an object with text or other objects in its paragraph)으로 두던 것을 고친다.한/글은 개체를 차례로, 문단의 쪽부터 그 쪽에서 가로로 겹치는 앞 개체 아래에 들어가는 첫 쪽에 둔다. 문단의 쪽에서는 띄움과 앞 개체 아래 가운데 낮은 곳이다. 그래서 뒤 개체가 다음 쪽으로 간 앞 개체를 건너 문단의 쪽에 들어가기도 한다.
어느 쪽에도 들어가지 않는 개체는 마지막으로 쓴 쪽의 다음 쪽 맨 위에서 시작한다. 다만 첫 개체는 문단 자리에서 시작해 흐른다. 쪽보다 긴 표는 그 뒤 쪽들로 나뉜다(CELL은 줄 사이에서, TABLE은 행째).
이런 문단이 이어지면 뒤 문단의 개체도 앞 문단 개체를 비켜 들어가는 첫 쪽에 놓인다. 다만 쪽을 넘어 이어지는 표의 나머지는 다음 쪽 맨 위에서 이어지고, 그 쪽의 다른 개체와 겹쳐도 비키지 않는다.
문단의 줄과 뒤 줄은 개체를 비킨 첫 자리에 놓이고, 그 쪽에 자리가 없으면 다음 쪽 맨 위로 간다. 개체가 혼자 차지한 쪽으로 넘어간 줄(글자처럼 둔 표가 든 줄도)은 개체 아래 남은 자리에 들어가지 않으면 그 쪽을 건너뛴다.
여러 단, 쪽 바닥을 넘는 그림·도형은 전처럼 지원 밖이다.
쪽 수 추정(실험,
estimate_pages)이hp:t글 안에 글자로 든 전각 공백(U+3000)을 고정폭 빈칸(hp:fwSpace)으로 보던 것을 고친다(python-hwpx는 둘을 모두 U+3000으로 읽는다). 글자 전각 공백은 글꼴의 폭(대개 글자 크기만큼)을 차지하고, 그 뒤에서 줄이 나뉘며, 줄 끝에서는 몇 개가 이어져도 모두 매달린다. 전에는 1/4 폭의 고정폭 빈칸으로 재어 줄을 늦게 나누었다.FormFit은 고정폭 빈칸이 낱말 바로 뒤라도 여백에서(또는 넘어서) 시작하면 다음 줄로 넘긴다. 전에는 낱말이 여백에 딱 맞을 때 그 뒤 고정폭 빈칸을 줄 끝에 매달았다.
쪽 수 추정(실험,
estimate_pages)이 글 문단의 첫 줄에서 아래로 띄운 흐르는 위아래 표를 쪽 끝에서도 따른다.그 줄이 쪽 바닥 위에 들어가지 않으면 줄과 표가 함께 다음 쪽으로 가고, 표는 거기서 띄운 만큼 아래에서 흐른다.
줄은 들어가는데 표 윗선이 바닥을 넘거나, 행 단위로 옮기는(TABLE) 표의 첫 행이 들어가지 않으면, 표만 다음 쪽 맨 위에서 시작한다. 문단의 글은 그 줄 아래로 이어지고, 표가 차지하는 쪽에서는 표 아래로 간다.
전에는 모두 지원 밖(
a top-and-bottom table offset down from a line at a page end)이었다. 첫 줄이 아닌 줄에서 띄운 표는 전처럼 지원 밖이다.
쪽 수 추정(실험,
estimate_pages)이 표 칸 안에 위아래나 어울림으로 둔 그림·도형의 높이를 행 높이에 넣는다. 글 없는 칸 문단에서 문단 위를 기준으로 둔 것(글자처럼 두지 않은 것)이면, 칸이 그 개체의 아래 끝(바깥 여백 포함)까지 온다. 전에는 그 개체를 세지 않아 행을 한 줄 높이로 잡았다.쪽 수 추정(실험,
estimate_pages)이 병합 칸으로 묶인 행들이 쪽 바닥을 빈 높이 안에서만 넘을 때, 그 행들을 그 쪽 바닥에서 끝낸다. 모든 칸의 글이 바닥 위에 들어가고 남는 높이가 1282 이하면 다음 쪽으로 넘길 것이 없다. 전에는 표 윗 여백만 있는 빈 쪽이 하나 더 생겼다.쪽 수 추정(실험,
estimate_pages)이 띠가 본문 아래 끝을 넘는 어울림(SQUARE) 개체를, 그 문단과 곁 문단이 줄 캐시를 가질 때 받는다.한/글은 이런 개체만 다음 쪽 맨 위로 보낸다. 개체는 줄 높이를 차지하지 않으므로 캐시를 가진 줄은 캐시 자리에 그대로 있다.
캐시 없는 문단이 그 곁에 있으면 전처럼 지원 밖이다. 줄을 어디서 나눌지가 개체의 쪽에 달려 있기 때문이다.
쪽 수 추정(실험,
estimate_pages)이 곁에 줄 하나 들어갈 자리를 남기는 종이·쪽 기준 어울림(SQUARE) 개체를 받는다(한 단일 때).그 쪽의 줄·표·개체가 개체의 띠에 닿지 않으면 개체가 없을 때와 같다. 띠 위 끝에 바닥이 맞닿은 줄도 그렇다.
닿는 줄은 한/글이 개체 곁에 좁혀 둔다. 이것은 따르지 않고 지원 밖으로 둔다(
text beside an object placed on the paper).
쪽 수 추정(실험,
estimate_pages)이 시험지 첫 쪽 모양을 따른다. 종이 위에서 본문 머리에 걸친 머리 표 아래에 문단 위에서 위아래로 둔 문항 표가 서는 모양이다.종이·쪽 기준 어울림(SQUARE) 개체가 본문 양옆에 줄 하나 들어갈 자리(1440)를 남기지 않으면, 위아래 개체처럼 그 쪽 줄을 띠 아래로 민다. 곁에 자리가 남으면 전처럼 지원 밖이다.
문단 첫 줄 위에 앵커한 위아래 개체는 그 줄이 띠에 밀리면 띠 바로 아래에 서고, 그 줄은 개체 아래로 간다. 흐르는 표만 든 문단도 줄이 띠에 밀리면 표가 띠 바로 아래에 서고 빈 줄은 표 아래로 간다. 밀리지 않으면 줄은 전처럼 표 윗선에 있다.
띠 끝에 맞닿아 시작하는 이런 표는 받는다. 띠에 닿는 흐르는 표는 전처럼 지원 밖이다.
쪽 수 추정(실험,
estimate_pages)이 구역의 ‘빈 줄 감추기’(hp:visibility@hideFirstEmptyLine)를 따르지 않던 것을 고친다. 이 설정이 켜진 구역에서 한/글은 다음 쪽이나 단을 시작할 빈 문단을 둘까지 앞 쪽 바닥 밑, 그 문단이 설 자리에 겹쳐 두어 감춘다. 감춘 문단은 자리를 차지하지 않고 쪽을 만들지 않으며, 다음 글은 다음 쪽 맨 위에서 시작한다. 셋째 빈 문단부터, 쪽을 나누는 문단, 빈칸이 든 문단은 감추지 않는다. 전에는 그런 빈 문단을 다음 쪽으로 넘겨, 문서가 빈 문단으로 끝나면 빈 쪽을 하나 더 세기도 했다.그림 넣기(
doc.add_picture)가align에 받은 값을 검사 없이hp:pos@horzAlign에 쓰던 것을 고친다.한/글은 모르는 정렬 값을 왼쪽(LEFT)으로 읽는다. 정수 같은 값은 그림과 문단을 더한 뒤에야 오류가 났다.
이제 대소문자와 상관없이
LEFT·CENTER·RIGHT·INSIDE·OUTSIDE만 받는다. 그 밖의 값은 아무것도 더하기 전에shape-position-frame오류로 거부한다.
쪽 수 추정(실험,
estimate_pages)이 칸 단위로 나누는 흐르는 표에서 문단이 여럿인 칸을 줄 간격 하나로만 세어 나누던 것을 고친다. 한/글은 문단 사이 간격(앞 문단의 아래 간격과 다음 문단의 위 간격)도 세고, 다음 쪽 부분이 문단의 첫 줄로 시작하면 그 문단의 위 간격을 그대로 둔다. 이제 그런 칸은 줄마다 제 자리로 나눈다. 전에는 문단 간격이 있으면 한 쪽에 줄을 더 넣어, 표가 한/글보다 짧게 끝날 수 있었다.문단 모양 적용(
doc.styles.apply_paragraph_format)이 퍼센트 줄 간격의hh:lineSpacing@unit을PERCENT로 쓰던 것을 고친다.스키마의 단위는
CHAR·HWPUNIT이고, 한/글은 퍼센트 줄 간격도HWPUNIT으로 적는다.PERCENT로 쓴 것도 같게 배치하지만, 다시 저장하면 바꾼다. 이제 처음부터 그렇게 쓴다.그래서 같은 줄 간격의 문단 모양이 이미 있으면, 단위만 다른 모양을 새로 만들지 않고 그것을 쓴다.
[6.7.0] - 2026-10-01
본문 쪽 수 추정(실험, hwpx.experimental.estimate_pages)을 더하고, 곡선·연결선, 바탕쪽 정리, 글상자 채우기,
쓰지 않는 그림·차트 정리 같은 저작·정리 API를 넓힌 릴리스입니다. FormFit은 글꼴마다 한/글이 배치하는 폭과
칸을 늘리는 식을 따르도록 다시 맞춰서, 고르는 글자 크기와 줄 수가 6.6.0과 달라질 수 있습니다. 누름틀 채우기도
한/글에 맞췄습니다. 여러 문단에 걸친 누름틀은 걸친 문단을 지우고, 끝(hp:fieldEnd)이 없는 누름틀은
field-end-missing 오류를 냅니다. 새 도형의 기본 선 굵기는 33(0.12 mm)이고, 각주·미주의 인스턴스 ID는
instId로 씁니다. 저장 성공만으로 시각 품질을 보증하지 않습니다.
추가
hwpx.experimental.latex_to_eqedit(실험)가 고등학교 수학에서 흔한 표기 몇 가지를 더 옮긴다(#347). 전에는UnsupportedLatexError로 거부했다.\,→`(작은 공백),\overrightarrow{AB}→vec {AB}(두 글자 위로 늘어난 화살표),\overleftrightarrow{AB}→dyad {AB}(↔),\therefore→therefore(∴),\because→because(∵).\mathbf{X}→{rm {bold {X}} it}.bold만으로는 영문자가 기울임으로 남고,rm은 중괄호 밖으로 번지므로 곧은 굵은 글꼴로 그린 뒤it으로 기울임을 되돌린다.eqedit_to_latex는 이 철자들을 되읽는다(`→\,,dyad→\overleftrightarrow,therefore·THEREFORE→\therefore,because→\because,{rm {bold X} it}→\mathbf{X}). 수식 크기 추정은dyad를vec처럼 꾸밈으로 잰다.
hwpx.experimental.latex_to_eqedit(실험)가\mid와\binom도 옮긴다(#347). 전에는UnsupportedLatexError로 거부했다. 철자는 한/글에서 그려 본 결과(#347 댓글)를 따른다.\mid→~|~. 맨|는 앞뒤 간격 없이 붙어 그려지고,~|~가\mid의 간격에 가장 가깝다.\binom{n}{r}→{n} choose {r}.binom {n} {r}·pmatrix {n # r}와 같은 모양이고,( {n} atop {r} )는 괄호가 늘어나지 않는다.eqedit_to_latex는~|~를\mid로,{n} choose {r}와binom {n} {r}를\binom{n}{r}로 되읽는다. 수식 크기 추정은 둘을atop처럼 두 줄로 잰다.choose·binom은 예약어가 되어, LaTeX의 맨 글자choose는 따옴표로 감싼다.LaTeX
~(띄움)를 EqEdit의 보통 띄움~로 옮긴다. 전에는 거부해서,eqedit_to_latex가 내보낸~가 든 LaTeX를 다시 EqEdit로 옮기지 못했다. 이제 EqEdit의 작은 띄움`(\,)과 보통 띄움~가 모두 왕복한다.
doc.shapes.add_curve()·add_connector()를 더한다(곡선과 붙은 연결선 저작).곡선은 앵커를 지나는
CURVE구간으로 쓴다(닫으면 끝에서 첫 앵커로). 한/글은 곡선의 크기 상자를 다시 계산하지 않으므로, 한/글 곡선이 갖는 상자(앵커를 지나는 Catmull-Rom 곡선을 구간마다 16단계로 근사한 상자)를 쓰고 앵커는 그 상자 기준으로 둔다. 직선 구간이 섞인 곡선과 묶음 안 곡선은 쓰지 않는다.연결선은 글자처럼 두지 않고 같은 기준에 놓인 두 도형의 변 가운데(위·오른쪽·아래·왼쪽)에 붙인 직선(
STRAIGHT)이나 꺾인 선(STROKE)이다. 한/글은 붙은 연결선을 도형 상자로 다시 그리므로 도형을 옮기거나 키워도 선이 따라간다. 호(ARC) 연결선은 제어점이 필요해 거부한다(shape-connector-kind-unsupported).오류 코드
shape-curve-too-few-points,shape-connector-target-inline,shape-connector-frame,shape-connector-side-invalid,shape-connector-kind-unsupported를 더한다.
doc.shapes.add_drop_cap(style="DoubleLine")을 지원한다(전에는TripleLine만 받고 나머지는shape-drop-cap-style-unsupported로 거부했다). 한/글은 같은hp:rect+hp:drawText구조에hp:parameterset값만 1(TripleLine은 2)인 첫 글자 장식을 읽고, 그리고, 그대로 저장한다. 상자 크기가 같으면 두 스타일의 화면이 같다. 상자 옆으로 가는 줄 수는 상자 높이가 정한다.Margin은 상자를 여백 쪽 어디에 두는지 근거가 없어 계속 거부한다.쪽 수 추정(실험,
estimate_pages)이 문단 위에서 위아래로 둔 개체와 글자처럼 둔 개체가 함께 있는 문단을 따른다(글이 없어도). 한/글은 글자처럼 둔 개체의 줄을 위아래 개체 아래(바깥 여백 포함)에 두고, 흐르는 표가 쪽 끝에서 나뉘면 표의 끝 아래에 둔다. 전에는 글이 있는 문단만 따랐고, 글자처럼 둔 개체가 함께 있으면 지원 밖이었다.문단 위에서 아래로 띄운 위아래 개체도 글 없이 글자처럼 둔 개체만 있는 문단에서 따른다. 글자처럼 둔 개체들이 한 줄이고, 글 문단의 줄처럼 개체에 닿으면 개체 아래로 가고 닿지 않으면 제자리이며, 다음 문단은 보통 자리와 개체 아래 가운데 낮은 쪽에 온다. 그런 줄의 높이는 글자처럼 둔 개체와 글자 크기 가운데 큰 쪽이다.
쪽 수 추정(실험,
estimate_pages)이 중첩 표를 품은 행이 쪽을 넘어 나뉜 흐르는 표를 따른다. 한/글은 그런 칸의 줄 캐시를 다음 쪽 부분에서 맨 위부터 다시 적는데, 전에는 그 칸을 읽지 못해 지원 밖이었다. 이제 위로 되돌아간 줄을 나뉘지 않은 칸에서 설 자리로 이어 읽고(앞 줄의 높이와 간격 아래, 문단의 첫 줄이면 문단 위), 행을 다시 나눈다. 문단 위에서 놓은 개체 아래에 있는 첫 줄은 그 위 공간을 함께 차지해, 개체와 함께 다음 쪽으로 간다.쪽 수 추정(실험,
estimate_pages)이 폭이 다른 다단 구역을 따른다. 모든 문단이 저장 때 남는 줄 캐시를 가지고 개체를 글자처럼만 두면, 줄은 캐시대로 두고 단마다 같은 본문 높이로 흐른다(전에는 지원 밖이었다). 글자처럼 두지 않은 개체가 있으면 지원 밖이다.쪽 수 추정(실험)이 폭이 다른 다단에서 줄 캐시가 없는 문단도 따른다. 단의 폭은 본문 폭을 단 너비·간격 (
hp:colSz)의 비율로 나눠 반올림한 값이다. 단에 든 줄은 그 단의 폭으로 나누고, 문단이 폭이 다른 단으로 넘어가면 남은 글을 그 단의 첫 글자부터 그 단의 폭으로 다시 나눈다. 전에는 줄 캐시가 없는 문단이 있으면 지원 밖이었다. 그런 문단에 개체·글자 겹치기·덧말·각주가 있으면 여전히 지원 밖이다.쪽 수 추정(실험)
hwpx.experimental.estimate_pages(document)를 더한다. 한/글 없이 본문 문단의 줄마다 쪽·단· 세로 위치(EstimatedLine)와 쪽 수(PageEstimate.pages)를 추정한다.줄 나눔: 문단의 줄 캐시가 저장 때 남는 것이면 그 줄(한/글이 그린 줄)을 쓰고, 아니면 FormFit처럼 줄을 나눈다. 캐시의 줄은 한/글이 준 높이와 간격(
vertsize,spacing)대로 놓는다. 캐시 없이 글자 크기가 여럿인 문단은 글자마다 제 크기로 줄을 나누고, 줄마다 그 줄에서 가장 큰 글자만큼 높으며 줄 간격도 그 크기로 센다. 빈 run은 자리를 차지하지 않는다. 글이 든 run마다 글꼴·장평·자간이 다르면 글자마다 제 run의 것으로 줄을 나눈다(전에는 첫 run의 것을 모든 글자에 썼다). FormFit의hancom_line_starts()에 글자마다 크기와 글자 모양을 주는sizes·styles를 더한다.세로: 줄 간격 네 종류, 문단 앞뒤 간격, 쪽·단 나눔, 문단 보호·다음 문단과 함께·외톨이줄, 같은 폭 다단, 글자처럼 취급한 표·그림, 문단에 붙은 위아래 배치 개체, 본문과 함께 흐르는 표(칸·행 단위로 나눔, 나누지 않음, 머리행 반복), 각주(다음 쪽으로 이어짐 포함)를 따른다. 줄은 끝이 본문 끝보다 위일 때만 그 쪽에 남는다. 끝이 본문 끝과 같은 줄(빈 줄도)은 다음 쪽으로 가고(전에는 남았다), 1 위에서 끝나는 줄은 남는다.
글 사이에 글자처럼 둔 개체(그림·표·도형·수식, 글 앞·가운데·뒤)는 그 자리에서 글자처럼 제 폭을 차지하고, 그 줄을 개체 높이까지 높인다. 줄 간격은 글의 것이고, 고정 줄 간격이면 다음 줄은 그만큼 아래에 온다. 줄 간격이 퍼센트·고정이 아니면 따르지 않는다.
글 앞으로·글 뒤로 둔 개체(글자처럼 두지 않은 것)는 자리를 차지하지 않는다. 문단·종이 어느 기준에 놓이든, 쪽 끝을 넘어도 줄은 그 개체가 없을 때 자리에 놓인다. 전에는 그런 개체가 글이나 다른 개체와 한 문단에 있거나 문단에 혼자 있으면 따르지 않았다.
종이나 쪽(본문)의 위 끝이나 아래 끝을 기준으로 놓은 위아래 배치 개체(글자처럼 두지 않은 것)는 앵커 문단이 놓인 쪽 전체에 작용한다. 그 쪽에서 개체 자리(기준 끝에서 오프셋만큼 안쪽, 개체 높이만큼)에 닿는 줄은 앵커 문단의 줄이든 그 앞뒤 문단의 줄이든 개체 아래로 내려가고(자리가 본문 끝까지 닿으면 다음 쪽으로), 뒤 줄이 따라간다. 표도 같다. 다단이면 본문 너비를 다 덮는 개체가 그 쪽의 모든 단에 작용한다. 개체는 문단 안에서 자리를 차지하지 않는다. 같은 쪽의 흐르는 표가 앵커 줄부터 끝까지 개체 자리에 닿거나 그 바로 아래에서 시작하면 따르지 않는다(전에는 이런 개체를 따르지 않았다).
글이 든 문단에 앵커한 위아래 배치 개체(문단 위 기준, 오프셋 0)는 그 자리가 든 줄의 위에 놓이고, 그 줄과 문단의 나머지는 개체 아래에 온다. 흐르는 표면 행 단위로 나뉜다. 오프셋이 있으면 개체는 그 줄의 위에서 오프셋만큼 아래에 놓이고, 개체에 닿는 첫 줄(그 문단이나 다음 문단의)과 그 뒤 줄들이 개체 아래로 내려간다. 흐르는 표(칸·행 단위로 나눔)는 그 자리에서 쪽 끝을 넘어 이어지고, 표에 닿는 첫 줄은 표가 끝나는 쪽의 표 아래로 간다(전에는 따르지 않았다). 그 밖의 개체나 그 위의 줄이 쪽을 넘으면 따르지 않는다.
글 앞에(또는 문단에 혼자) 둔 어울림(SQUARE) 개체(문단 위 기준, 단·문단·종이의 왼쪽이나 오른쪽에서 오프셋만큼 — 첫 글자 장식도 그렇다)는 곁의 두 쪽 가운데 폭이 1440 이상이고 글 흐름(양쪽·넓은 쪽·왼쪽만· 오른쪽만)이 허락하는 쪽에 글을 둔다. 개체 높이 안에 줄의 위가 드는 줄은 그 문단과 다음 문단들에서 그만큼 좁아지고, 양쪽에 글이 가면 한 줄이 같은 높이의 두 조각(왼쪽 먼저)이 된다. 전에는 단 끝에 붙고 양쪽으로 흐르는 개체만 따랐다. 표는 행 높이의 합을 높이로 쓴다. 단보다 넓어 곁에 자리가 없는 어울림 개체는 위아래 배치처럼 글을 아래로 민다. 개체나 그 곁의 줄이 쪽을 넘으면 따르지 않는다. 줄 캐시에서도 같은 높이에 나란한 두 조각은 한 줄로 센다.
글자 겹치기·덧말이 든 문단은 저장 때 남는 줄 캐시가 있으면 그 줄(한/글이 그린 줄)을 따른다. 캐시가 없으면 (표 칸 안 문단도) 글자 겹치기·덧말을 그 run의 글자처럼 제자리에 두고 줄을 나눈다. 글자 겹치기는 틀(원·사각형 등)이 있거나 펼침(
SPREAD)이면 한글 한 글자의 폭, 틀 없이 겹치면 가장 넓은 글자의 폭이고, 줄 높이를 바꾸지 않는다. 덧말은 본말의 폭이다(덧말이 더 길어도). 덧말이 든 줄은 본말 위에 덧말(크기 비율, 0이면 절반)을 얹은 높이, 아래 덧말이면 본말 높이의 91/100에 덧말을 더한 높이이고(둘 다 1/1800인치 단위로 셈), 줄 간격도 그 높이로 센다. 전에는 캐시가 없으면 본문 문단은 따르지 않았고, 칸 안 문단은 글자 겹치기·덧말을 빼고 셌다.줄 캐시를 쓸 때 줄의 높이와 다음 줄까지의 거리는
textheight와spacing으로 센다. 글자처럼 둔 개체가 뒤따르는 줄은vertsize가 개체 높이일 때가 있지만, 한/글은 그 줄의 글 높이만큼만 내려간다. 표 칸 안 문단도 저장 때 남는 줄 캐시가 있으면 그 줄 높이와 간격을 쓴다(전에는 줄 수만 쓰고 높이는 첫 글자 크기로 셌다). 높이가 0인 줄로 된 캐시는 없는 것으로 본다.흐르는 표의 앵커 줄이 쪽 끝에 들어가지 않으면, 앵커 줄과 표가 다음 쪽 위에서 시작한다.
행 단위로 나누는 흐르는 표의 첫 행이 앵커 문단 아래에 들어가지 않으면, 표는 다음 쪽에서 시작한다. 표 뒤의 글은 앵커 아래에 이어지다가, 표가 차지한 쪽에서는 표 아래에 놓인다.
칸 안에 글자처럼 둔 표가 문단에 혼자 있으면, 그 줄은 표 높이(행 높이의 합과 바깥 여백)만큼 높고 줄 간격은 글의 것이다. 칸 단위로 나누는 표에서 그런 칸이 든 행은 칸 줄 사이에서 나뉜다. 줄마다 제 높이이고(안쪽 표는 한 줄), 쪽 끝에 들어가는 줄만 남고 나머지는 다음 쪽에서 이어진다. 행 단위로 나누는 표에서는 행째 다음 쪽으로 간다. 칸 안 표가 글과 한 문단에 있거나 글자처럼 두지 않은 것(위아래 배치나 어울림)이어도, 칸의 모든 문단이 저장 때 남는 줄 캐시를 가지면 따른다. 칸은 한/글이 그린 줄 위치대로 높고, 위아래 배치나 어울림 표가 마지막 줄보다 아래로 내려가면 그 표의 아래 끝까지 높다. 문단 위에서 위로 둔(음수 오프셋) 표는 문단 위에 선다 (전에는 따르지 않았다). 간다. 선언 높이가 글보다 큰 그런 행은 여느 선언 높이 행처럼 첫 줄이 들어가면 쪽 끝 바로 위에서 잘린다(아래). 간다.
흐르는 표의 행은 쪽 본문 끝에서 101 HWPUNIT 위까지만 쓴다. 그보다 아래에서 끝나는 행은 다음 쪽으로 가고, 칸 단위로 나누는 표에서는 그 아래로 내려가는 칸 줄부터 다음 쪽에서 이어진다(전에는 쪽 끝까지 썼다). 행 단위로 나누는 표의 첫 행이 앵커 아래에 들어가는지도 이 자리로 따진다.
칸 단위로 나누는 흐르는 표에서 선언 높이가 글보다 큰 행은 쪽 끝 바로 위(101 HWPUNIT)에서 잘리고, 남은 높이는 다음 쪽으로 넘어간다. 남은 높이가 1282(기본 칸 여백의 10pt 한 줄) 이하이면 넘기지 않는다. 칸 여백, 세로 정렬, 글자 크기는 자르는 자리와 이 문턱을 바꾸지 않는다.
글자처럼 취급한 표에 병합 행이나 중첩 표가 있어도, 표 안 모든 문단이 저장 때 남는 줄 캐시를 가지면 (한/글이 배치한 그대로면) 한/글이 저장한 표 높이(
hp:sz)를 쓴다. 그 밖의 병합 행 표(본문과 함께 흐르는 표 포함)는 행마다 한 행짜리 칸 가운데 가장 높은 칸의 높이이고, 병합된 칸이 걸친 행들보다 높으면 모자란 만큼 그 마지막 행이 높아진다. 병합 칸이 여럿이면 끝 행이 먼저인 것부터 차례로 따진다(걸친 행이 같거나, 엇갈리거나, 한쪽이 다른 쪽을 품어도). 한 행짜리 칸이 없는 행은 높이 0에서 시작한다. 행 단위로 나누는 흐르는 표에서는 병합 칸으로 이어진 행들이 한 덩어리로 다음 쪽으로 간다. 칸 단위로 나누는 표에서는 그 행들의 칸마다 쪽 끝까지 들어가는 줄만 남고 나머지 줄이 다음 쪽에서 이어진다. 쪽 끝이 걸린 행부터는 칸의 남은 줄만큼 높고, 병합 칸의 남은 높이는 모자란 만큼 그 마지막 행에 더한다. 그 행들에서 선언 높이가 글보다 큰 칸은 글의 첫 줄이 쪽 끝에 들어가면(글이 다 들어가지 않아도) 선언 높이를 행처럼 쪽 끝 바로 위에서 자르고, 남은 높이가 1282 이하이면 버린다. 첫 줄도 들어가지 않으면 칸째 다음 쪽으로 간다. 글이 든 문단에 앵커한 위아래 배치 표도 같다. 칸·글상자 안 문단의 단 설정은 그 목록의 것이라 구역의 단 변경으로 보지 않는다.그 밖의 것(미주, 구역 안 단 변경, 첫 문단 뒤의 구역 설정, 격자, 글과 개체가 한 문단(위의 글자처럼 둔 개체는 빼고)과 그런 문단의 각주, 앵커 아래나 한 쪽에 들어가지 않는 병합 행 덩어리, 한/글이 배치한 그대로가 아닌 표에서, 줄 캐시가 없는 칸의 글과 한 문단에 있거나 글자처럼 두지 않은 중첩 표, 표를 품은 칸 곁에 더 높은 칸이 있는 흐르는 표 행의 쪽 나눔, 다음 쪽에서 시작하는 흐르는 표 둘이 한 쪽에 놓임, 쪽·종이 기준 개체(글 앞·뒤 개체와, 흐르는 표가 없는 쪽의 종이 위 기준 위아래 개체는 빼고), 줄 캐시 없는 문단에서 위·아래가 아닌 자리나 퍼센트가 아닌 줄 간격의 덧말, 글자처럼 두지 않은 개체 곁의 글자 겹치기·덧말)이 있으면
pages는None이고unsupported가 구역마다 까닭을 적는다.
doc.shapes.remove_unused_charts()를 더한다. 어떤 차트도 가리키지 않는 차트 파트(Chart/chartN.xml)를 모두 지우고 지운 파트 이름을 돌려준다. 본문에서 차트를 지우면(section.clear_body(), 문단 삭제) 그 파트가 차트의 항목 이름·값과 함께 파일에 남았다. 한/글은 문서를 저장할 때 이런 파트를 지운다.docs/known-traps.md와clear_body()설명에도 적는다.export_text()·export_html()·export_markdown()에notes를 더한다.True면 각주·미주를 본문·칸·글상자 안의 제자리에 한/글 텍스트 저장처럼 쓴다. 참조 번호(1)) 뒤에 각주의 문단마다 그 번호로 시작하는 글과 줄바꿈이 온다. 번호는 각주·미주를 따로 문서 순서로 매기고, 구역의 번호 모양(autoNumFormat)과 번호 매기기(ON_SECTION은 구역마다newNum부터, 새 번호 지정hp:newNum)를 따른다. 쪽마다 새로 매기는 번호는 쪽을 나누지 않으므로 이어 매긴다. 기본값은 전처럼 각주·미주를 쓰지 않는다.doc.styles.apply_list_format()에continue_list를 더한다.True면 대상 문단 앞의 마지막 번호 목록(개요는 개요 목록)과 같은 번호 정의를 써서 한/글에서 번호가 이어진다. 전에는 부를 때마다 번호 정의를 새로 만들어, 문단마다 따로 부르면 목록이 매번 1부터 다시 시작했다(기본 동작은 그대로다). 앞에 그런 목록이 없으면 새 목록을 만든다. 앞 목록의 번호 정의에 없는 더 깊은 수준으로 이어 붙이면 그 수준의 모양을 새 목록과 같은 꼴(^1.^2.)로 정의에 더한다. 한/글은 번호 정의에 없는 수준에는 번호를 그리지 않는다.number_format·start와 함께 주면style-list-continue-conflict로 거부한다.doc.media.remove_unused_images()를 더한다. 문서가 어디서도 가리키지 않는 이진 항목(매니페스트 항목·파트· header의binItem)을 모두 지우고 지운 항목을 돌려준다. 한/글은 문서를 저장할 때 이런 항목을 지운다. 본문에서 그림을 지우면(section.clear_body(), 문단 삭제) 그 그림의 이진 항목이 남으므로 이 호출로 정리한다.remove_image가 확인하는 참조(그림, 채우기 그림·그림 글머리표, 바탕쪽, 동영상, OLE, 내장 글꼴)가 있는 항목은 남긴다.doc.fields.text_boxes와doc.fields.fill_text_box()를 더한다. 한/글은 이름이 있는 글상자 (hp:drawText@name)를 필드로 보고, 필드 목록에 넣고 이름으로 채운다.text_boxes는 이름 붙은 글상자를 문서 순서로 돌려준다(이름 없는 글상자는 뺀다).fill_text_box(value, name=, index=)는 한/글처럼 글상자의 글을 값 한 문단으로 바꾼다. 첫 문단과 첫 run의 모양은 그대로이고, 줄바꿈은hp:lineBreak로 쓴다. 같은 이름의 글상자는 모두 채우고, 없는 이름은field-text-box-not-found로 거부한다.set_draw_text(name=)의 설명도 고쳤다(이름이 글상자를 필드로 만든다).doc.parts.remove_master_page(id)를 더한다. 어느 구역도 참조하지 않는 바탕쪽의 매니페스트 항목과 파트를 지우고, 저장된 적이 있어 패키지에 있는 파트 파일도 지운다. 구역이 참조하는 바탕쪽은master-page-in-use, 없는 id는master-page-not-found로 거부하고 아무것도 바꾸지 않는다.doc.parts.add_master_page()에section을 더한다. 주면 만든 바탕쪽을 그 구역에 바로 연결한다. 그 구역에 같은 쪽의 바탕쪽이 이미 있으면 파트를 만들기 전에master-page-pages-taken으로 거부하므로, 거부된 호출은 문서에 아무것도 남기지 않는다.add_rectangle()·add_ellipse()(doc.shapes와 문단)에original_size=(w, h)를 더한다.hp:orgSz를 그리는 크기와 따로 쓴다. 도형과 기하는 원래 크기로 만들고,curSz·sz는width×height,scaMatrix는 두 크기의 비율, 회전 중심은curSz의 절반이다. 한/글이 저장한 코퍼스 파일의 크기 바뀐 도형과 같은 배치다. 주지 않으면 출력은 전과 같다. 양의 정수 두 개가 아니면shape-original-size-invalid로 거부한다. 한/글에서 렌더는 확인하지 않았다.doc.styles.replace_font()에font_type(REP/TTF/HFT)을 더한다. 이 호출이 새로 선언하는 글꼴의type을 정한다. 이미 있던 글꼴은 바꾸지 않는다.hwpx.opc.relationships.ManifestItemRef에 매니페스트 항목의isEmbeded값을 담는is_embeded필드를 더한다.
바꿈
hwpx.experimental.latex_to_eqedit(실험)가\text{…}·\mathrm{…}·\textrm{…}·\mbox{…}를{rm "…" it}로 옮긴다(#347). 전에는 따옴표 글"…"로 옮겼는데, 한/글은 따옴표 글을 기울여 그린다.rm은 곧게 그리되 중괄호 밖으로 번지므로it으로 뒤 글자를 기울임으로 되돌린다(예:\mathrm{d}x→{rm "d" it} x).eqedit_to_latex는 이 묶음을\text{…}로 되읽는다. 따옴표 글은 전처럼\text{…}로 읽되, 낱말 하나가 EqEdit 예약어인 것(쓰는 쪽이 기호로 바뀌지 않게 감싼T _{"int"}같은 것)은 맨 글자로 읽는다. 그래서 쓰기 → 읽기 → 쓰기가 전처럼 고정점이다.
FormFit이 칸의 높이 예산으로 저장된 안쪽 높이를 그대로 쓴다. 한/글은 그 높이까지 줄을 넣어도 행을 키우지 않고, 줄 간격은 한/글과 같게 센다. 폭의 안전 여유(0.93)는 그대로다. 전에는 높이에도 0.93을 곱해, 칸에 들어가는 값을 줄이거나 거부했다(예: 안쪽 2047에 1939를 쓰는 두 줄 값).
FormFit이 화살표·도형 기호·그 밖의 기호(U+2190–21FF, U+25A0–25FF, U+2600–26FF: → ○ □ △ ☆ ☎ 등)를 글꼴 폭 표에 없는 글꼴에서 전각(1 em)으로 센다. 표에 있는 한국어 글꼴에서 이 기호들은 0.89~1 em이다. 전에는 문장 부호 폭으로 세어, 표에 없는 글꼴의 ○ 다섯 개를 한 줄로 예측했는데 한/글은 두 줄로 나눴다.
탭 정의를 한/글처럼 읽고 쓴다. 한/글이 저장한
hh:tabPr은 탭마다hp:switch로 감싸hp:case에 HWPUNIT 위치 (unit="HWPUNIT")를,hp:default에 그 두 배를 쓴다.doc.styles.tab_properties·tab_property()의tab_stops가 이제 모든 스위치의hp:case위치를 읽는다. 전에는 첫 스위치의hp:default만 읽어서, 탭이 여럿인 정의를 탭 하나로, 위치는 두 배로 보고했다. 스위치 없는hh:tabItem은 전처럼 그 값 그대로다(한/글도 HWPUNIT으로 읽는다).ensure_tab_definition()(apply_paragraph_format(tab_stops=…), 차례 만들기)도 탭마다 같은 스위치로 쓰고, 같은 정의를 찾을 때hp:case위치로 비교한다.FormFit이 저장 높이가 한 줄보다 낮은 칸(글에 따라 늘어나는 칸)에도 높이 예산을 쓴다. 한/글은 이런 행을 그 행에서 가장 높은 칸만큼 그린다. 그 높이에서 이 칸의 위아래 여백을 뺀 것이 예산이다. 칸의 높이는 한/글이 배치한 줄(줄 캐시)의 끝에 여백을 더한 것이고, 줄 캐시가 없으면 그 칸의 글을 잰 줄 수로 계산한다. 저장 높이가 더 크면 저장 높이다. 전에는 이런 칸을 너비로만 맞춰서, 행이 담는 것보다 줄이 많은 값을 쓰면 행이 커졌다. 이제 다른 행과 같이 정책을 따른다. 기본 정책은 그런 값을 거부하고,
allow_row_expand를 주면 전처럼 행이 커진다.FormFit이 줄이 이미 저장 높이를 넘친 행에서는 한/글이 그린 높이를 예산으로 쓴다. 한/글은 칸의 줄이 저장 높이를 넘으면 행을 그 줄만큼 그린다. 전에는 저장 높이로만 예산을 잡아, 원래 두 줄이던 칸에 두 줄 값을 넣어도 한 줄로 줄이거나 거부했다.
doc.fields.fill()이 값을 누름틀 시작이 든 런의 글자 모양으로 쓴다. 한/글은 값이 이미 든 누름틀을 채울 때도 옛 값의 글자 모양(파란 글자, 굵게 등)을 버리고 시작 런의 모양으로 쓴다. 전에는 안내문(자리표시)을 바꿀 때만 시작 런의 모양으로 바꾸고, 값이 든 누름틀에서는 옛 값 런의 모양을 지켰다. 그런 누름틀을 채운 결과의style_preserved는 이제False다.셀 글 쓰기(
table.set_cell_text(),cell.text = …,doc.fields.fill_cell())가 값을 받은 문단 밖의 빈 문단을 모두 지운다. 한/글은 칸을 채우면 값을 칸의 한 문단으로 만든다. 전에는 이번 쓰기로 비운 문단만 지우고 원래 비어 있던 문단(빈 줄)은 남겼다. 그래서 칸이 빈 줄만큼 높았고,cell.text가 쓴 값과 다르게 읽히기도 했다. 안쪽 표·개체를 담은 문단은 전처럼 남는다.add_paragraph(style=…)가 문단에 그 스타일의 문단 모양과 글자 모양을 쓴다. 한/글이 스타일을 적용할 때처럼 문단의paraPrIDRef와 첫 run의charPrIDRef가 스타일의 것이 된다. 전에는styleIDRef만 바꾸고 모양은 앞 문단에서 물려받아, 한/글에서 개요 스타일 문단이 본문처럼 보이거나 앞 제목의 번호가 붙었다.para_pr_id_ref·char_pr_id_ref나run_attributes의charPrIDRef를 함께 주면 그 값을 쓴다. 숫자 id를 쓰는style_id_ref는 전처럼 스타일 이름만 붙인다. 개요 스타일 문단에는 한/글이 개요 번호를 붙이므로 README 예시에서 글에 쓴 번호를 뺐다.FormFit이 로마 숫자(Ⅰ–Ⅻ, ⅰ–ⅻ)와 원 숫자·괄호 숫자(①–⑳, ⑴–⒇)를 글꼴에서 한/글이 배치하는 폭으로 센다. 함초롬바탕·함초롬돋움은 0.972 em, 맑은 고딕은 로마 숫자 0.952 em·원 숫자 1 em이다. 글꼴 폭 표에 없는 글꼴이나 글자도 전각(1 em)으로 본다. 전에는 평균 폭(0.62 em)으로 세어, 이런 글자가 든 칸을 한 줄로 예측했는데 한/글은 두 줄로 나눴다.
FormFit이 한글 한 자를 글자 모양의 한글 글꼴에서 한/글이 배치하는 폭으로 센다. 함초롬바탕·함초롬돋움은 0.972 em, 한컴 고딕은 0.932 em이고, 다른 글꼴(맑은 고딕·바탕· 돋움·굴림·궁서 등)은 전처럼 1 em이다. 이 세 글꼴의 셀과 누름틀에는 전보다 한 줄에 글자가 조금 더 들어간다고 본다.
TextStyle.hangul_advance(em, 기본 1.0)를 더했다. 글자별 폭을 모르는 글꼴의 한글 폭이다.
FormFit이 한글이 아닌 글자(숫자, 영문, 문장 부호, 자주 쓰는 기호)도 함초롬바탕·함초롬돋움·맑은 고딕에서는 한/글이 배치하는 글자별 폭으로 센다. 전에는 글자 종류별 평균(숫자 0.55 em, 문장 부호 0.42 em 등)을 썼다. 한글·영문·기타·기호 글꼴이 모두 같은 글자 모양일 때 쓰고, 다른 글꼴이나 표에 없는 글자는 전처럼 평균을 쓴다(
TextStyle.glyph_face,hwpx.form_fit.measure.glyph_advance_em).FormFit의 세로 예산(
SlotMetrics.height_lines)이 한/글이 칸을 늘리는 식을 따른다. n줄은 (n − 1) × 줄 간격 + 글자 크기를 차지하고 마지막 줄의 줄 간격은 들어가지 않는다. 전에는 n × 줄 간격으로 셌다. 줄 간격은 비율(PERCENT)뿐 아니라 고정(FIXED= 값), 여백만(BETWEEN_LINES= 크기값), 최소(
AT_LEAST= 크기와 값 중 큰 것)도 읽는다(SlotMetrics.line_spacing). 전에는 비율이 아니면 160%로 봤다. 비율 줄 간격에서 크기를 넘는 부분은 한/글처럼 1/1800인치(4 HWPUNIT) 단위로 센다(크기를 그 단위로 내린 em에 비율을 곱해 반올림, 10.5pt 160%는 630이 아니라 628).
FormFit이 글자 폭을 한/글처럼 1/1800인치(4 HWPUNIT) 단위로 센다. 글꼴의 설계 폭을 글자 크기에 맞춘 뒤 장평이 100%면 반올림하고 다른 장평이면 내린다. 자간은 그 폭에 비율을 곱해 0에서 먼 쪽으로 반올림해 더한다. 반각 공백은 em의 절반(내림)에 장평을 곱해 반올림한다. 전에는 10pt에서 본 비율을 크기에 곱하기만 해서, 10pt가 아닌 크기나 장평·자간이 있는 칸에서 줄 끝이 한/글과 어긋날 수 있었다.
글자별 폭을 아는 글꼴에 바탕·바탕체·돋움·돋움체·굴림·굴림체·궁서·궁서체·한컴 고딕을 더했다(모두 12개). 굵은 글자도 같은 폭을 쓴다.
TextStyle.hangul_face를 더했다. 셀·누름틀 슬롯은 첫 run 글자 모양의 한글 글꼴 이름으로 채우고, 표에 있는 글꼴이면hangul_advance대신 그 글꼴의 한글 폭을 쓴다.glyph_advance_em()은 글꼴의 설계 폭(em)을 돌려준다.
FormFit이 칸 줄 폭을 한/글처럼 센다. 1440 HWPUNIT 하한을 들여쓰기를 뺀 뒤 줄마다 적용하고(좁은 칸의 내어쓰기 줄도 1440), 칸보다 넓은 인라인 개체 다음 줄들은 칸 폭으로 센다(
SlotMetrics.line_width,SlotMetrics.min_line_width).FormFit이 칸 첫 줄의 인라인 개체(체크 상자·그림 등) 뒤에 글의 첫 글자도 들어가지 않으면, 한/글처럼 글이 다음 줄에서 시작한다고 센다. 전에는 첫 줄에 한 글자를 억지로 넣어 한 줄 적게 세거나, 개체 뒤 폭이 0이면 들어갈 수 없다고 보았다.
한 줄에 좁혀 넣는 칸(
lineWrap="SQUEEZE")에 글을 넣으면(cell.text = …,set_cell_text()), 값이 칸 줄 폭의 1.1배 이하일 때는 SQUEEZE를 그대로 둔다. 전에는 글이 바뀌면 늘 BREAK로 바꿔서, 줄 폭을 조금만 넘어도 줄이 바뀌고 행이 커져 쪽이 밀렸다. 한/글은 SQUEEZE 칸의 글을 한 줄에 두고 글자 사이만 좁히며, 1.1배까지는 읽히고 그보다 길면 글자가 닿거나 겹친다. 그래서 더 긴 값은 전처럼 BREAK로 바꾼다. 폭은 칸의 글자 모양으로 잰다.도형의 기본 선 굵기를 283(1 mm)에서 33(0.12 mm)으로 바꾼다. 한/글이 새 도형에 쓰는 굵기다.
doc.shapes.add_line()·add_rectangle()·add_ellipse()·add_arc()·add_polygon(), 문단의 같은 이름 메서드, 묶음 도형의 멤버가 이 기본값을 쓴다.line_width를 주지 않은 도형은 전보다 가늘게 그려진다. 옛 5.x 이름(doc.add_rectangle()등)은 시그니처를 그대로 두기로 한 호환 계층이라 전처럼 283이다.set_footnote_numbering()·set_endnote_numbering()의 설명과docs/known-traps.md에, 시작 번호(new_num)는 번호 방식이ON_SECTION일 때만 한/글에 보인다고 적는다.CONTINUOUS·ON_PAGE는 1부터 매긴다.FormFit이 칸을 채울 때 기본으로 행 높이를 지킨다. 값이 칸 높이가 담는 줄 수보다 조금 많으면 전에는 줄여 넣지 못한 경우 경고(
overflow_detected)만 남기고 값을 넣어 행이 늘었고, 그 뒤 쪽이 밀렸다. 이제 넘는 정도와 관계없이 글자를 줄여(min_font_pt까지) 칸 안에 넣고, 그래도 안 되면FitPolicy.overflow를 따른다. 기본fail은 채우지 않는다(doc.fields.fill()은field-fit-failed,set_cell_text(fit=...)는 칸을 그대로 두고ok=False인 결과). 행을 늘려도 되면FitPolicy(allow_row_expand=True), 경고만 받고 넣으려면FitPolicy(overflow="warn")을 준다. 칸 높이를 잴 수 없는 칸(병합·자동 늘어남)은 전처럼 폭만 본다.docs/known-traps.md와section.clear_body()설명에, 본문에서 지운 그림(clear_body(), 문단 삭제)의 이미지가 파일에 남는다고 적는다. 파일에서도 없애려면 저장 전에doc.media.remove_unused_images()를 부른다. 한/글은 저장할 때 아무것도 가리키지 않는 이미지를 지운다.
고침
쪽 수 추정(실험,
estimate_pages)이 줄 사이에서 나뉘는(CELL) 흐르는 표의 아래 캡션을 한/글처럼 둔다. 마지막 행이 글보다 높게 선언돼 있으면, 그 행과 캡션을 함께 다음 쪽으로 보내지 않고 행의 빈 높이를 캡션 위에서 자른다. 쪽 끝에서 빈 높이를 자르는 규칙과 같다. 남은 높이가 1282 이하면 버리고 캡션은 그 쪽에 남는다. 넘으면 남은 부분과 캡션이 다음 쪽으로 간다. 빈 높이로 모자라면 전처럼 행이 캡션과 함께 넘어간다.쪽 수 추정(실험,
estimate_pages)이 문단 위에서 단이나 문단의 왼쪽·오른쪽 끝을 기준으로 둔 어울림(SQUARE) 개체 가운데, 글이 갈 수 있는 양옆에 1440보다 좁은 자리만 남기는 것을 위아래 개체처럼 받는다. 전에는 단보다 좁으면 지원 밖(wrapped square leaving little room for text)이었다.글은 개체 아래(문단 윗선 + 개체 높이)로 간다. 표만 든 문단의 빈 줄은 표 윗선에 있고, 다음 문단은 표 아래에서 시작한다.
쪽 수 추정(실험,
estimate_pages)이 줄 캐시 없는 문단의 글머리표·번호 표지가 자기 글자 모양을 가질 때 그 크기를 세지 않던 것을 고친다. 한/글은 그런 표지를 문단 첫 줄에 놓인 그 크기의 글자로 두어, 표지가 글보다 크면 첫 줄이 표지만큼 높아지고 줄 간격도 그 크기로 센다(고정 간격이면 다음 줄은 그 간격만큼 아래). 표지가 글보다 작으면 그대로다. 본문 문단과 표 칸 문단 모두 그렇다(_head_size,_line_metrics의head).쪽 수 추정(실험,
estimate_pages)이 줄 캐시 없는 표 칸 문단의 글자 크기를 문단의 첫 run에서 읽던 것을 고친다. 칸 문단이 다른 크기의 빈 run으로 시작하면(빈 문단에 run을 더해 쓴 문단처럼) 그 빈 run의 크기로 줄 높이와 간격을 셌다. 이제 본문 문단처럼 글이 든 run의 크기를 쓰고, 빈 run은 자리를 차지하지 않는다.수식 상자 측정(
measure_equation,estimate_equation_size)이 기호를 뜻하는 수식 명령어를 그 철자 글자들로 재던 것을 고친다.lbrace·rbrace(대소문자 무관)는 중괄호 한 글자로,LINE·vert는|,VERT는 겹세로줄로 잰다.CHOOSE·BINOM처럼 대문자로 쓴 이항계수도choose·binom처럼 두 줄로 잰다. 전에는lbrace x | x > 0 rbrace가 한/글이 저장한 상자보다 2.5배 넓었다. 다음 폭도 맞춘다:prime과'는 좁은 표시,DEG는 도 기호 하나,theta등 그리스 글자는 글자별 폭,root의 짧은 지수는 근호 왼쪽 홈에 들어가 폭을 더하지 않고, 근호와 행렬 괄호는 더 좁다.atop(과 같은 모양의choose·binom)은 가로줄이 없어over보다 낮고,LEFT/RIGHT괄호는 높이를 더하지 않으며, 그 묶음(과 분수)에 붙은 첨자는 묶음의 위아래를 따라 밖으로 나간다. 따옴표 안의 대문자·숫자는 글자 종류대로 잰다.수식 측정 모듈 설명에서 “한컴은 문서를 열 때 수식을 다시 재지 않는다”는 문장을 관찰한 대로 고친다. macOS 한/글은 저장할 때 저장된 크기와 상관없이 수식을 다시 배치해
<hp:sz>를 다시 쓰는 것이 관찰되었다. 파일을 읽어 쪽을 배치하는 다른 프로그램에는 저장된 상자가 그대로 쓰인다.FormFit(과 줄 캐시 없는 문단의 쪽 수 추정)이 글머리표·문단 번호·개요 번호가 붙은 문단의 줄을 표지 없이 나누던 것을 고친다. 이제 표지 폭과 너비 조정(
widthAdjust), 본문과의 간격(textOffset: 표지 글자 크기의 %나 HWPUNIT)만큼 첫 줄이 좁아진다. 자동 내어 쓰기(autoIndent)면 둘째 줄부터도 좁아지고, 문단의 들여쓰기는 둘째 줄부터만 든다(내어쓰기면 더 좁고, 첫 줄 들여쓰기면 그만큼 넓다). 표지 폭은 실제 너비 사용 (useInstWidth)이면 표지 글자들의 폭이고, 아니면 ASCII 글자는 반 em, 다른 글자는 1 em이다(번호는 그 형식의 글자 하나로 센다). 쪽 수 추정은 번호 문단마다 한/글이 그리는 번호를 읽는 순서대로 세어 쓰고, FormFit은 그 수준의 첫 번호를 쓴다(TextStyle.head·head_hangs,indented_widths(),label_room(),paragraph_label()).쪽 수 추정(실험,
estimate_pages)이 줄 캐시 없는 문단 끝의 빈 run을 세지 않던 것을 고친다. 한/글은 문단 끝을 마지막 run의 글자 모양으로 두어, 빈 run이 문단을 끝내면 마지막 줄이 그 글자 크기만큼 높아진다(빈칸만 든 줄도, 글이 든 줄도). 견주는 것은 마지막 줄의 글자다. 앞 줄에 더 큰 글자가 있어도 그렇다. 글 앞의 빈 run은 전처럼 자리를 차지하지 않는다.FormFit이 묶음 빈칸(U+00A0,
hp:nbSpace)과 고정폭 빈칸(U+3000,hp:fwSpace)을 한/글과 다르게 세던 것을 고친다. 묶음 빈칸은 반각 빈칸만큼 넓고, 줄 끝에 걸리지 않으며 그 자리에서 줄이 나뉘지 않는다(앞뒤 낱말이 한 낱말이 된다). 전에는 줄 끝에 걸리는 빈칸으로 보았다. 고정폭 빈칸은 장평·자간·최소 공백과 상관없이 글자 크기의 1/4(1/1800인치 단위로 버림)이고, 빈칸처럼 줄 끝에 걸리며 그 뒤에서 줄이 나뉜다. 전에는 온폭 글자로 보았다. 줄 캐시 없는 문단의 쪽 수 추정은 둘을 글에서 빼고 줄을 나누었는데, 이제 글자로 센다.쪽 수 추정(실험,
estimate_pages)이 나누지 않게 한 흐르는 표(hp:tbl@pageBreak="NONE")의 높이를 세지 않던 것을 고친다(다음 쪽으로 넘어갈 때 쪽 수만 하나 더했다). 한/글은 그런 표의 행이 앵커 줄 아래에 다 들어가면 여느 흐르는 표처럼 그 자리를 차지하고, 다음 문단은 표 끝 아래에 온다. 다 들어가지 않으면 표만 다음 쪽 맨 위로 옮기고, 뒤 글은 앵커 줄 아래에 이어지며, 다음 쪽의 줄은 표 아래에서 시작한다(쪽보다 큰 표도 다음 쪽으로 간다). 글이 든 문단 맨 앞에 둔 표는 그 아래 줄까지 들어가지 않으면 문단째 다음 쪽으로 간다.FormFit(과 줄 캐시 없는 문단의 쪽 수 추정)이 최소 공백(
condense)을 한/글과 다르게 세던 것을 고친다. 빈칸은 자간을 뺀 빈칸 폭의 그 비율만큼 줄어든다(전에는 자간을 넣은 폭의 비율). 빈칸이 줄어드는 것은 여백을 넘는 낱말을 넣을 때뿐이다. 줄의 글이 자간을 넣어 여백에 닿으면 그 뒤 빈칸은 모두 줄 끝에 걸리고 다음 낱말은 다음 줄에서 시작한다. 전에는 빈칸을 줄여 다음 낱말도 넣었다.FormFit이 모든 글자에 한글의 장평·자간을 쓰던 것을 고친다. 글자 모양이 영문·기호·한자에 따로 준 값이 있으면 그 글자에 쓴다(
glyph_script(),TextStyle.scripts). 영문은 U+024F까지(숫자, 문장 부호, 가운뎃점, °, ×)와 ‘’“”다. 기호는 일반 문장 부호(줄표, 줄임표, ‰, ※), 글자꼴 기호(℃), 숫자 꼴(Ⅰ, ①), 화살표, 도형, CJK 기호와 괄호, 전각 문자다. 한자는 CJK 한자다. 반각 빈칸은 한글 장평에 영문 자간을 쓴다.쪽 수 추정(실험,
estimate_pages)이 줄 캐시 없는 표 칸 문단의 줄을 칸 안쪽 폭 그대로, 첫 run의 글자 크기와 모양 하나로 나누던 것을 고친다. 이제 본문 문단처럼 문단 여백과 첫 줄 들여쓰기(내어쓰기면 둘째 줄부터)를 빼고, 글자 크기나 모양이 섞이면 글자마다 제 크기와 모양으로 나누며, 줄마다 그 줄의 가장 큰 글자만큼 높다.묶음(
hp:container)의resize()가 원래 크기(orgSz)를 새 크기로 덮고 배율 행렬과 구성원은 그대로 두던 것을 고친다. 한/글은 묶음을sz크기로 그리고, 크기를 바꾼 묶음을 저장할 때orgSz를 두고sz·curSz를 새 크기로(바뀌지 않은 축의curSz는 0), 묶음의scaMatrix를 새 크기/원래 크기로 쓴다. 구성원마다(묶음 안 묶음의 구성원도) 첫scaMatrix에 같은 배율과 오프셋 × (배율 − 1)만큼의 이동을,curSz에orgSz× 들어 있는 묶음들의 배율(버림)을 쓴다. 이제resize()가 그 모양을 쓴다. 전에도 그림은 새 크기였지만, 한/글이 다시 저장하면curSz가 그린 크기의 두 배로 기록됐다.메모 API(
doc.notes.memos,doc.notes.remove_memo())가 MEMO 필드에만 든 메모를 보지 못하던 것을 고친다. 한/글은 메모를hp:memogroup없이 MEMO 필드(hp:fieldBegin type="MEMO")의hp:subList에 두며, HWP를 HWPX로 읽은 문서도 그렇다. 이제notes.memos가 그런 메모도 문서 순서대로 돌려준다(HwpxOxmlFieldMemo: id·번호·작성자는 필드의 매개변수, 글은hp:subList). 메모 그룹과 필드에 함께 있는 메모(python-hwpx가 앵커를 건 메모)는 한 번만 센다.remove_memo()는 필드의 두 제어와 메모 글을 지우고 필드가 걸친 글은 남긴다. python-hwpx가 앵커를 건 메모를 지우면 그 MEMO 필드도 함께 지운다(전에는 필드가 남아 한/글에 메모가 그대로 보였다).쪽 수 추정(실험,
estimate_pages)이 칸 줄 사이에서 나누는 흐르는 표 행을 한 칸(가장 높은 칸)의 줄로만 나누던 것을 고친다. 한/글은 모든 칸의 첫 줄이 쪽 끝 바로 위까지 들어갈 때만 행을 나누고, 그렇지 않으면 행째 다음 쪽으로 보낸다.쪽 수 추정(실험,
estimate_pages)이 글자처럼 둔 개체가 든 줄의 줄 간격을 개체가 든 런의 글자 크기 없이 세던 것을 고친다. 한/글은 그 줄의 가장 큰 글자로 줄 간격을 세며, 개체는 그 런의 글자 크기로 센다. 개체 곁에 공백만 있으면(또는 아무것도 없으면) 그 문단의 어느 런이든 가장 큰 글자 크기로 센다(전에는 가장 작은 글자).쪽 수 추정(실험,
estimate_pages)이 표의 캡션을 세지 않던 것을 고친다. 한/글은 표 위나 아래의 캡션에 그 줄과 간격만큼 자리를 둔다(글자처럼 둔 표는 그 줄이 그만큼 높다). 아래 캡션이 표의 마지막 행과 함께 쪽 끝 바로 위까지 들어가지 않으면 그 행과 함께 다음 쪽으로 간다. 표 곁의 캡션은 자리를 두지 않는다.쪽 수 추정(실험,
estimate_pages)이 문단에 혼자 있는 흐르는 표의 오프셋(문단 위에서 아래로 둔 거리)을 무시하던 것을 고친다. 한/글은 그 표를 문단 위(문단 위 간격보다 위)에서 오프셋만큼 아래에서 시작한다(위로 둔 표는 문단 위에서). 다음 문단은 표 끝과, 앵커 문단의 줄 뒤에 제 문단 위 간격을 더한 자리 가운데 더 아래에 놓인다. 오프셋을 두고 흐르는 표 뒤에 그런 문단이 오면, 그 줄은 앞 표가 끝난 자리로 내려가고 표는 거기서 흐른다(전에는 지원 밖이었다).쪽 수 추정(실험,
estimate_pages)이 선언 높이가 글보다 큰 흐르는 표 행을 쪽 끝에서 자를 때, 들어가지 않은 글 줄을 잃던 것을 고친다. 남은 선언 높이가 1282 이하이면 버렸지만, 한/글은 들어가지 않은 줄을 다음 쪽으로 보내고 남은 높이를 그 줄과 칸 여백만큼은 둔다. 같은 높이의 칸이 여럿이면 줄이 가장 많은 칸으로 행을 나눈다(전에는 첫 칸).쪽 수 추정(실험,
estimate_pages)이 제목 줄을 반복하는 흐르는 표에서 행의 제목 여부를 가장 높은 칸 하나로만 보던 것을 고친다. 그 칸이 제목 칸이 아니면 행을 다음 쪽에 되풀이하지 않았지만, 한/글은 제목 칸이 하나라도 있는 행을 되풀이한다.쪽 수 추정(실험,
estimate_pages)이 크기를 자동으로 조절하지 않게 한 흐르는 표(hp:tbl@noAdjust="1")의 쪽 끝을 여느 표처럼 보던 것을 고친다. 한/글은 여느 표의 행과 칸 줄을 본문 끝 101 위까지만 두지만, 그런 표는 2 위까지 둔다(끝이 1 위면 다음 쪽). 선언 높이가 글보다 큰 행도 거기서 자른다.쪽 수 추정(실험,
estimate_pages)이 음수인 바깥 여백(파일에는 부호 없는 32비트 수로 남는다)을 그 큰 수 그대로 세던 것을 고친다. 한/글은 그런 여백을 없는 것으로 배치하고, 저장하면 0으로 쓴다.쪽 수 추정(실험,
estimate_pages)이 여러 쪽에 걸친 흐르는 표의 바깥 여백을 쪽 끝과 다음 쪽에서 따르지 않던 것을 고친다. 한/글은 표의 행과 칸 줄을 본문 끝에서 바깥 아래 여백을 뺀 자리의 바로 위까지만 두고, 다음 쪽에서는 표를 바깥 위 여백만큼 내려 다시 시작한다. 전에는 두 여백을 표의 처음과 끝에서만 셌다(여백이 0인 표는 그대로).쪽 수 추정(실험,
estimate_pages)이 흐르는 표(글자처럼 두지 않은 표)를 품은 문단의 쪽 나누기를 무시하던 것을 고친다. 그 표는 앞 글이나 앞 표 바로 뒤에 놓였지만, 한/글은 새 쪽에서 시작한다. 앞 표가 다음 쪽까지 이어지면 그 표가 끝난 쪽의 다음 쪽이다.편집기 안전 검사가 한/글이 여는 중에 멈추는 바탕쪽을 통과시키던 것을 고친다. 이제
hp:subList가 없는 바탕쪽(masterPage)과 바탕쪽 파트의 문단 없는hp:subList는 오류다(문단 없는hp:subList검사는 전에는 구역 파트만 보았다).doc.parts.add_master_page(paragraphs=[])는 문단 없는 바탕쪽을 쓰던 것을 고쳐, 이제 빈 문단 하나를 쓴다.문단 모양 조회(
paragraph_property())가 부를 때마다 헤더의 문단 모양을 모두 다시 읽던 것을 고친다. 이제 찾는 문단 모양 하나만 읽고, 찾는 규칙(id, 숫자로 고친 id)은paragraph_properties와 같다. FormFit 칸 채우기처럼 칸이나 문단마다 문단 모양을 찾는 일이, 문단 모양이 많은 문서에서 크게 빨라진다.remove_section()이 지운 구역의 파트(Contents/sectionN.xml)를 패키지에 남기던 것을 고친다. 매니페스트는 그 파트를 더 가리키지 않지만 저장한 파일 안에 지운 구역의 글이 그대로 남았다(한/글은 읽지 않고, 다시 저장하면 없어진다). 이제 구역을 지우면 그 파트도 지운다.편집기 안전 검사가 한컴이 열지 못하거나 여는 중에 멈추는 찾아보기 표시·도형 매개변수 묶음을 통과시키던 것을 고친다. 이제 다음은 오류다:
hp:firstKey가 없는hp:indexmark,hp:parameterset안의name없는hp:listParam·hp:unsignedintegerParam,cnt로 매개변수가 있다고 하면서 하나도 없는hp:parameterset·hp:listParam.cnt="0"인 빈 묶음과, 매개변수가 있는데cnt만 다른 묶음은 한컴이 열므로 그대로 둔다.doc.page.set_header()·set_footer()·set_page_number()가 구역 첫 문단의 첫 run에서 시작하는 필드(누름틀 등) 뒤에 머리말·꼬리말 컨트롤을 넣던 것을 고친다. 그 자리는 필드 범위 안이라 한/글이 저장하면서 머리말·꼬리말을 버렸다. 이제 필드가 시작하는 컨트롤 앞에 넣는다. 머리말·꼬리말 글을 고치며hp:ctrl사본을 새로 만들 때도 같다.편집기 안전 검사(
validate_package·validate_editor_open_safety)가 한컴이 열지 못하거나(거부) 멈추거나 배치를 끝내지 못하는 문서를 통과시키던 것을 고친다. 이제 다음은 오류이고, 공개 저장 경로는 이런 문서를 쓰지 않는다.패키지:
rootfile@media-type,opf:item의id·href·media-type,opf:itemref@idref,opf:meta@name이 없거나opf:manifest에 항목이 없음hh:head@secCnt없음(예전에는 경고),HCFVersion@tagetApplication없음표:
hp:tbl의rowCnt·colCnt,hp:tr/hp:tc,hp:cellAddr의colAddr·rowAddr,hp:cellSpan의colSpan·rowSpan이 없음hp:secPr에hp:startNum·hp:visibility없음,hp:lineseg@textpos없음필드:
hp:fieldBegin@id,hp:fieldEnd@beginIDRef가 없거나, 없는fieldBegin을 가리키는fieldEnd가 자기hp:run의 맨 앞에 있거나, 필드 종류와fieldid가 둘 다 한컴이 모르는 값임. run 안에서 글·빈hp:t·다른 컨트롤 뒤에 오는 그런fieldEnd는 한컴이 버리고 문서를 연다도형: 필수 하위 요소가 없는 도형과 빈
hp:ctrl(예전에는 경고),hp:renderingInfo행렬이 없는 도형, 모서리 점(hc:pt0~pt3)이 없는 사각형,hc:img가 없는 그림구역 설정의
hp:parameterset안hp:booleanParam, 패키지에 없는 바탕쪽을 가리키는hp:masterPage,hp:subList가 없는 머리말·꼬리말 컨트롤, 문단 없는hp:subList머리말·구역 항목의
opf:item@href가 패키지 루트에서 본 파트 이름이 아님 (content.hpf폴더 기준 상대 경로,/로 시작하는 경로). 한컴은 href를 패키지 루트에서 그대로 찾는다. 그림 항목이 그러면 경고다(한컴은 그 그림을 빼고 연다)구역 항목의
opf:item@id가section0부터 번호가 이어지지 않음. 한컴은 구역을 이 id의 번호 순서로 찾고(spine이나 파일 이름이 아니라) 하나라도 없으면 열지 않는다. 번호는 이어지지만 spine 순서와 다르면 경고다(한컴은 id 순서로 읽는다). id는 spine이 가리키는 것을 보고, 같은 구역 파트를 가리키는 다른 항목은 세지 않는다.repair_repack은 구역 id를 spine 순서대로 다시 매긴다
add_heading(level=8~10)과apply_paragraph_format(outline_level=8~10)이 문단 모양의 개요를 한/글과 다른 모양으로 쓰던 것을 고친다. 개요 8~10 수준은 2016 문단 이름공간에만 있어서, 한/글은hp:switch의hp:case에 개요를 두고hp:default에NONE을 둔다(새 문서의 개요 8~10 스타일도 이렇다). 전에는 이hp:switch를 비우고 개요를 문단 모양에 바로 썼다. 이제 한/글과 같은 모양으로 쓰고, 새 문서에서는 개요 8~10 스타일의 문단 모양을 그대로 쓴다. 문단 모양을 읽을 때도hp:switch안의 개요를 읽는다(paragraph_property().heading, 목록 글자 내보내기).글자 겹치기(
add_composed_character())와 덧말(add_dutmal())을 한/글이 쓰는 모양으로 쓴다. 글자 겹치기는 늘hp:charPr열 칸을 쓰고(쓰지 않는 칸은4294967295), 주지 않은 속성은 한/글이 새 글자 겹치기에 주는 값 (circleType="SHAPE_CIRCLE",charSz="-4",composeType="SPREAD")으로 쓴다. 덧말은 스타일을 주지 않으면styleIDRef="0"을 쓴다. 전에는 준 칸만 쓰고 속성을 뺐으며, 한/글은 저장할 때 이 값들을 채웠다.새 도형(
add_rectangle()·add_ellipse()·add_line()·add_arc()·add_polygon()·add_container())에textWrap·textFlow를 쓴다. 한/글은 모든 도형에 이 둘을 쓰고, 없으면SQUARE·BOTH_SIDES로 읽는다. 그래서 새 도형은textWrap="SQUARE" textFlow="BOTH_SIDES"이고, 묶음(hp:container) 안 도형은 한/글처럼TOP_AND_BOTTOM이다. 채운 도형의hc:winBrush에도 한/글처럼alpha="0"을 쓴다. 한/글에서 보이는 모양은 그대로다.FormFit이 공백이 이어진 글을 한/글처럼 줄 나눈다. 낱말 바로 뒤의 공백은 전처럼 줄 끝에 매달리지만, 그 뒤로 이어지는 공백이 줄 끝이나 그 너머에서 시작하면 다음 줄로 간다. 최소 공백(
condense)은 줄의 첫 글자 뒤에 있는 공백만 줄이고, 줄 앞의 공백은 줄이지 않는다. 전에는 이어진 공백을 모두 줄 끝에 매달고 줄 앞 공백까지 줄여서, 공백으로 칸을 채운 값을 한 줄로 예측했는데 한/글은 두 줄로 나눴다.누름틀 안에 다른 누름틀이 있을 때 바깥 누름틀을
doc.fields.fill()로 채우면 안쪽 누름틀의 시작과 끝을 지운다. 한/글은 바깥 누름틀의 내용 전체를 값으로 바꾸므로 안쪽 누름틀도 함께 없어진다. 전에는 안쪽 누름틀의 시작과 끝이 빈 채로 남아 필드 목록에 그대로 있었다. 안쪽 누름틀만 채우면 바깥 누름틀은 그대로다.필드를 쓸 때
fieldid에 그 필드 종류의 제어 id를 쓴다. 한/글은 종류마다 모든 필드에 같은fieldid를 쓴다. 제어 id 네 글자를 수로 읽은 값이다(누름틀%clk627272811, 날짜%dte, 경로%pat, 교정 부호%sig, 메일 머지%mmg, 차례%toc, 하이퍼링크%hlk, 상호 참조%xrf). 전에는 누름틀·날짜·경로·교정 부호·메일 머지· 차례·상호 참조 필드에 임의 수를 썼고, 차례 도구가 쓴 필드 끝에는fieldid가 없었다. 문서 합치기 (insert_document()·append_document())도 가져온 필드의fieldid를 임의 수 대신 종류의 제어 id로 쓴다.누름틀의 끝을 찾을 때
beginIDRef가 있는 끝은 그 id의 누름틀 끝으로만 본다. 같은 종류의 필드는fieldid를 함께 쓰기 때문에, 한/글이 저장한 문서에서 끝이 없는 누름틀이 다음 누름틀의 끝을 제 끝으로 잡았다. 그러면 채울 때 그 사이 내용을 지웠다. 이제 이런 누름틀은field-end-missing으로 거부한다.FormFit이 문단의 왼쪽·오른쪽 여백을 줄 폭에서 빼고, 문단 위 간격을 칸의 높이 예산에서 뺀다. 한/글은 줄을 문단 왼쪽 여백에서 시작하고, 줄 폭은 칸 안쪽에서 두 여백을 뺀 값이다. 첫 줄은 위 간격 아래에서 시작하고, 칸 마지막 문단의 아래 간격은 자리를 차지하지 않는다. 전에는 두 여백과 위 간격을 무시해서, 여백이 있는 칸에서 줄 수를 적게 세고 칸에 들어가는 줄 수를 많게 셌다.
메모를 여럿 달면 모두
Number1로 쓰던 것을 고친다. 한/글은 번호가 같은 메모를 한 메모로 보아, 문서를 다시 저장할 때 둘째 메모부터 메모 범위의 끝(hp:fieldEnd)을 지웠다. 이제doc.notes.add_memo()·doc.notes.attach()에number를 주지 않으면 메모는 문서의 다음 번호(zorder와 같은 값)를 쓴다. 메모 필드도 한/글이 쓰는 모양으로 쓴다. 필드 id는 숫자이고,fieldid는 메모 필드의 종류 코드(%%me)다.name="",editable="1",dirty="0"을 쓰고, 메모 글subList에는 한/글과 같은 속성을 쓴다.doc.fields.fill()이 내용이 여러 문단에 걸친 누름틀을 채우면 값만 시작 뒤에 넣고 걸친 문단의 원래 글을 그대로 두던 것을 고친다. 누름틀 끝을 시작과 같은 문단에서만 찾았기 때문이다. 이제 끝을 뒤 문단에서도 찾고, 한/글처럼 걸친 문단(그 안의 표 포함)을 지운 뒤 값과 끝을 시작 문단에 둔다. 끝 문단에서 끝 뒤에 있던 글은 시작 문단으로 합치고, 시작 문단의 문단 모양은 그대로다. 이런 누름틀의FormField.value는 걸친 문단의 글을 한 줄에 한 문단씩 읽는다.끝(
hp:fieldEnd)이 없는 누름틀을doc.fields.fill()로 채우면HwpxValueError(code="field-end-missing")를 낸다. 바꿀 내용이 없기 때문이다(한/글도 이런 누름틀은 채우지 않는다). 전에는 값을 시작 뒤에 넣었다.안내문을
Command문자열(Clickhere:set:…:Direction:wstring:<길이>:<안내문> …) 안에만 둔 누름틀을 자리표시로 알아보지 못하던 것을 고친다. 그래서doc.fields.fill()이 값을 안내문의 글자 모양(보통 빨강)으로 남겼다. 이제 안내문을 그 문자열에서도 읽고(FormField.prompt,is_placeholder), 값은 누름틀의 글자 모양으로 쓴다. 누름틀의 매개변수는 바꾸지 않는다.doc.parts.add_master_page(section=...)가 내는master-page-pages-taken을 오류 코드 목록 (hwpx.errors.ERROR_CODES,docs/error-codes.md)에 올린다. 전에는 목록에 없었다.doc.styles.replace_font()가 dst_face를 새로 선언하는 블록에 늘type="TTF"를 쓰던 것을 고친다. 다른 블록이 같은 글꼴을HFT로 선언해도 그랬다. 이제 다른 블록에 dst_face 선언이 있으면 그hh:font를 id만 바꿔 복사한다. 그래서type·isEmbedded·hh:typeInfo가 그 선언과 같다. 어느 블록에도 없을 때만 전처럼TTF로 선언한다.check_id_integrity()가 동영상이 가리키는 항목(포스터imageIDRef, 파일fileIDRef)을 고아 BinData로 보고해ok=False를 내던 것을 고친다.binaryItemIDRef만 참조로 셌기 때문이다. 이제imageIDRef·fileIDRef·soundIDRef도 참조로 세고, 패키지 밖 파일을 잇는 항목(isEmbeded="0"이고 href가BinData/밖)은 고아 목록에 넣지 않는다. 이진 항목 판정·이름 비교·참조 속성은doc.media.remove_image()·doc.media.images·doc.validate()와 같은 규칙(hwpx.opc.relationships)을 쓴다. 참조 무결성 게이트(require_reference_integrity)가 고아 항목 때문에 실패하면 메시지에 그 항목을 적는다. 전에는 메시지가ID/reference integrity failed:로 끝났다.doc.media.images가 한/글이BinData/에 두는 OLE 항목을 빼던 것을 고친다.isEmbeded="0"이면 모두 바깥 파일로 봤기 때문이다. 이제 href가BinData/밖인isEmbeded="0"항목(패키지 밖 파일)만 뺀다.표 칸의 안쪽 여백을 읽는 곳마다 규칙이 달라 같은 칸에 서로 다른 값을 쓰던 것을 고친다. 이제 양식 맞춤(
resolve_slot_metrics), 칸 안 중첩 표의 기본 너비, 새 표의 쪽 넘김 판단, 레이아웃 미리보기의 칸 안쪽 여백, 템플릿 분석(analyze_template)의CellSummary.margin, 바이트 보존 칸 채우기(fill_cells)의 글자 줄이기가 모두cell.margins와 같은 규칙을 따른다. 칸의hasMargin이 켜져 있을 때만 칸의hp:cellMargin을 쓰고, 꺼져 있거나 없으면 표의hp:inMargin을 쓴다. 전에는 양식 맞춤이hasMargin이 없는 칸에 칸 여백을 썼고, 나머지는hasMargin을 보지 않고 칸 여백만 읽었다. 한/글이 저장한 실문서의 줄 너비(lineseg@horzsize)가 이 규칙과 맞는다.hasMargin="0"이고 두 여백이 다른 칸이 있는 문서는 중첩 표 기본 너비, 미리보기 안쪽 여백, 템플릿 분석 값,fill_cells의 글자 줄이기 판단이 바뀐다. 양식 맞춤 결과는 테스트 실문서에서 바뀌지 않는다.tests/data/model_surface.json의internalCount(stable 목록 밖 공개 멤버 수)를 확인하는 테스트가 없어 19개 클래스 중 12개 값이 실제와 어긋나 있던 것을 고친다. 값을 실제에 맞추고(합 82 → 154), 표면 테스트가 모든 클래스의 값과docs/stable-api.md의 수를 확인한다. 공개 API는 바뀌지 않는다.5.0에서
python-hwpx-automation으로 옮긴 모듈(hwpx.builder,hwpx.authoring,hwpx.exam,hwpx.tools.pii등 21개)을 import하면No module named ...만 나오던 것을 고친다. 이제ModuleNotFoundError메시지가 새 모듈 경로(예:hwpx_automation.office.authoring.builder),pip install python-hwpx-automation, 이전 가이드 주소를 알려 준다. 배포본에서 뺀 저장소 전용 패키지(hwpx.benchmark,hwpx.conformance,hwpx.tools.fuzz)는 소스 체크아웃에서 쓰라고 알려 준다. core는 여전히 companion 패키지를 import하지 않고, 옮긴 경로를 파일로 되살리지 않는다. 모듈별 대체표는docs/migration-5.0.md의 “Module paths”에 있고 메시지와 같은 표에서 나온다.validate_package()(hwpx-validate-package)가 패키지 밖 파일을 잇는 매니페스트 항목(isEmbeded="0"이고 href가BinData/밖, 예: 연결한 동영상)을 파트가 없다는 오류로 보고해ok=False를 내던 것을 고친다. 이 때문에 참조 무결성 게이트(require_reference_integrity)로 저장하면OPC/package validation failed로 실패했다. 이제doc.validate()·check_id_integrity()·doc.media.images와 같은 규칙(is_linked_file)으로 이런 항목을 건너뛴다.BinData/에 파일을 두는 OLE 항목은isEmbeded="0"이어도 계속 검사한다.doc.validate()와validate_document()(hwpx-validate)가 같은 패키지에 다른 답을 하던 것을 고친다. 매니페스트 불일치 경고(파트가 없는 매니페스트 항목, 매니페스트 항목이 없는BinData/파트)를doc.validate()만 냈기 때문이다. 이제 이 검사를validate_document()가 하고doc.validate()는 그 결과를 그대로 돌려준다. 파트가 없는 매니페스트 항목을 오류로 보는 것은 여전히 패키지 검사(validate_package())다.doc.validate()의 docstring에 무엇을 검사하는지 적는다.lint_layout()이 글을 채워 쪽 본문보다 높아진 글자처럼 취급한 표를 알리지 못하던 것을 고친다. 행 높이를 칸에 저장된 높이(hp:cellSz)로만 셌기 때문이다. 글을 채워도 저장된 높이는 그대로이고, 한/글은 칸의 줄에 맞춰 행을 늘려 그린다. 이제 칸마다 문단과 줄바꿈(hp:lineBreak, 글 안의 줄바꿈 문자) 수만큼 줄을 센다. n줄은 (n − 1) × 줄 간격 + 글자 크기를 차지하고, 여기에 칸 위아래 여백을 더한 값을 행 높이의 하한으로 쓴다. 글자 모양이 하나인 문단은 긴 글이 칸 폭에서 접혀 생긴 줄도 센다. 줄 나눔은 FormFit과 같고, 글자마다 측정 오차만큼 좁게 재므로 한/글이 그리는 줄보다 많이 세지 않는다. 탭·개체가 있거나 글자 모양이 여럿인 문단은 문단과 줄바꿈 수만 센다.문단이나 표 칸에 이미 가진 글을 다시 넣으면(
paragraph.text = paragraph.text,cell.text = cell.text) 줄 배치 캐시(hp:linesegarray)를 지우던 것을 고친다. 한/글은 캐시가 없는 문단을 다시 배치하는데, 다른 판의 한/글이 만든 캐시와 결과가 달라 글이 바뀌지 않았는데도 쪽 수가 달라질 수 있었다. 여러 런 문단은 런까지 첫 글자 모양으로 합쳐졌고, 여러 문단 칸은 한 문단이 됐다. 이제 같은 글이면 아무것도 바꾸지 않는다(set_text_preserving_runs와 같다). 칸의set_text(..., preserve_format=False)는 같은 글이어도 전처럼 글자 모양을 되돌린다.lint_layout()이pageBreak="TABLE"표를 검사하지 않던 것을 고친다. 한/글은 이 표를 행 사이에서만 나눈다. 그래서 쪽 본문보다 높은 행은 한 쪽에 그리고, 종이 아래 끝을 넘는 줄은 그리지 않는다. 이제 이런 행을TABLE_TALLER_THAN_PAGE로 알린다(detail["row"]는 행 번호). 행 안에서도 나누는pageBreak="CELL"표는 전처럼 검사하지 않는다.각주·미주의 인스턴스 ID를
instid속성으로 쓰던 것을 고친다. 스키마(NoteType)와 한/글이 쓰는 이름은instId이고, 소문자instid는 그림·도형 같은 개체의 철자다. 한/글은 이런 파일을 저장하며instid를 버리고instId를 새로 매겼다. HWP로 저장하면 각주·미주의 인스턴스 ID가 0이 됐다. 이제add_footnote()·add_endnote()는instId를 쓰고, 읽기는instId를 먼저 보고 전에 쓴instid도 읽는다. 문단 복제는 어느 철자든 값만 새로 매긴다.doc.fields.fill()이 값의 줄바꿈 문자(CRLF·LF·CR)를 글 안에 그대로 쓰던 것을 고친다. 한/글은 이 문자를 열 때 같은 문단 안 줄바꿈(hp:lineBreak)으로 바꿔 보여 줬다. 이제 줄바꿈마다hp:lineBreak를 쓴다. 누름틀 값을 읽을 때도hp:lineBreak를 줄바꿈 문자로,hp:tab을 탭으로 읽는다(전에는 빠졌다). 채울 때 옛 값에 있던 줄바꿈·탭 요소가 새 값 뒤에 남던 것도 함께 고친다.이름이 빈 누름틀(
name="")을doc.fields.all이id를 이름으로 삼아 보여 주던 것을 고친다. 한/글은 이런 누름틀을 이름 없는 필드로 보고 필드 목록과 이름으로 채우기에서 뺀다. 이제name속성이 있으면 빈 값이라도 그 값을 이름으로 쓴다. 이름 없는 누름틀은doc.fields.all·list_form_fields()에 빈 이름으로 나오고(field_id로 구별한다),fill(name=)으로는 찾지 않는다(안내문으로도 찾지 않는다).fill(field_index=)·fill(field_id=)로는 전처럼 채울 수 있다.안에 표가 든 칸에 글을 넣으면(
cell.text = …,set_cell_text()) 안쪽 표의 칸 글까지 모두 지워 빈 표가 남던 것을 고친다. 이제 칸 자신의 문단 글만 바꾸고, 칸 안의 표·개체는 글을 그대로 둔다. 누름틀 칸 채우기 (doc.fields.fill_cell())도 같은 방식으로 쓴다. 그래서fill_cell()도 이번 쓰기로 비워진 칸 문단을 지운다(전에는 빈 줄로 남아 칸이 높아졌다).
[6.6.0] - 2026-09-28
HWP 5.0(.hwp) 읽기·쓰기를 더하고, 템플릿·양식을 공개 API만으로 다루는 기능(칸 안쪽 여백,
글꼴·테두리 읽기와 글꼴 교체, 떠 있는 도형의 기준 틀, 본문 비우기, 메타데이터·미리보기·그림
정리)을 공개한 릴리스입니다. 한/글과 결과를 맞추느라 출력이 바뀌는 고침이 여럿 있습니다.
특히 equalize_column_widths()는 한/글처럼 표 폭을 행별 칸 수의 공배수로 올립니다. 전의 분배가
필요하면 set_column_widths([1] * column_count)를 씁니다. 저장 성공만으로 시각 품질을
보증하지 않습니다.
바꿈
FormFit(
hwpx.form_fit)이 셀과 누름틀 값의 줄을 한컴의 줄 배치 규칙으로 센다. 글꼴 파일은 쓰지 않는다. 공백은 0.5 em이고, 폭에 장평과 (1 + 자간)을 곱한다(줄 끝 글자에는 자간을 붙이지 않는다). 칸 안 폭이 1440 HWPUNIT보다 좁아도 줄 폭은 1440이다. 한글·영어 나눔 설정을 따른다(한글BREAK_WORD는 어절 단위,KEEP_WORD는 글자 단위). 줄 끝 공백은 여백 밖으로 걸치고, 첫 줄 들여쓰기와 내어쓰기, 최소 공백, 닫는 부호의 줄 머리 금칙을 반영한다. 영어 단어 안의/ - . @뒤에서는 나누지 않는다. 같은 줄의 체크박스 같은 인라인 개체는 첫 줄 폭만 줄인다.셀 슬롯(
resolve_slot_metrics)은 셀 첫 문단의 문단 모양과 글자 모양에서, 누름틀 슬롯은 필드 문단과 글자 모양에서 이 설정(TextStyle)을 읽는다.새
TextStyle과hancom_line_starts()를 공개한다.estimate_text_width와estimate_lines는style을 선택 인자로 받고,style없이 부르면 전과 같다.문단 모양 읽기(
ParagraphProperty.margin)가 한컴 표기의 여백 값 (<hc:intent value="1000" unit="HWPUNIT"/>)을 읽는다. 전에는 요소 글자에서만 값을 찾아 한컴 문서의 문단 여백이 모두None이었고, FormFit도 들여쓰기를 0으로 봤다.
추가
Section.clear_body()로 문서를 양식 틀로 비운다. 첫 문단 첫 run의hp:secPr(쪽 설정)와 첫 문단 모든 run의hp:ctrl(단·머리말·꼬리말·쪽 번호 — 한/글은 이것들을 흔히 둘째 run에 쓴다)을 남기고, 나머지 문단, 첫 문단 run의 다른 자식, 컨트롤이 없는 뒤쪽 run, 첫 문단의 줄 배치 캐시를 지운다. 머리말·꼬리말처럼 남길 컨트롤 안에 글·표·개체·양식 개체·덧말·글자 겹침이 있으면 기본으로section-clear-control-content로 거부하고,on_control_content="keep"은 남기며,"strip"은 그 컨트롤과hp:secPr안의 머리말·꼬리말 사본을 지운다."strip"으로도 지울 수 없는 내용이 있으면 거부한다.hp:t안 자식 뒤의 글(<hp:t><hp:tab/>이름</hp:t>)도 내용으로 본다. 어느 쪽이든 찾은 태그를ClearBodyReport.control_content에 담는다. 거부는 바꾸기 전에 일어난다.Run.content_kinds()가 run이 담은 것을 닫힌 어휘(RUN_CONTENT_KINDS:text·table·picture·shape·equation·ole·chart·video·form·control·section_properties·other)로 알려 준다. 빈hp:t는 글로 세지 않는다.doc.text.plain()·markdown()·html()(hwpx.tools.exporter)에list_labels인자(기본False): 번호·개요·글머리표 문단 앞에 한/글이 그리는 글자(1.·가.·①·●등)와 공백 하나를 붙인다. 번호는 번호 정의와 수준마다 문서 순서로 세고(윗수준이 오면 아랫수준은 새로 시작, 건너뛴 윗수준은 시작값), 개요 문단은 구역의 개요 번호를 쓴다. 표 칸 문단도 읽는 순서로 센다(include_tables=False로 표를 빼도 세기는 한다). 쓸 수 있는 번호 모양은 숫자·한글·자모· 원 숫자·원 한글·로마 숫자·라틴 문자이고, 다른 모양(갑·일·一 등)의 문단에는 라벨을 붙이지 않는다. 센다(include_tables=False로 표를 빼도 세기는 한다).^N은 1수준부터 그 수준까지의 번호를 숫자로 잇고(1.2.), 정의가 없는 번호는 모든 수준을 그렇게 쓰며, 정의가 없는 글머리표는●로 쓴다. 글자가 기호 글꼴 문자(사용자 정의 영역의 U+F09F·U+F0A7 등) 하나뿐이면 한/글의 텍스트 저장처럼●·■등 유니코드 기호로 쓴다. 쓸 수 있는 번호 모양은 숫자·한글·자모·원 숫자· 원 한글·로마 숫자·라틴 문자이고, 다른 모양(갑·일·一 등)의 문단에는 라벨을 붙이지 않는다.셀 필드(이름 붙은 표 칸,
hp:tc@name):doc.fields.cells가 문서 순서로 돌려주고(본문 표와 칸 안의 표),doc.fields.fill_cell(value, name=..., index=None)이 한/글PutFieldText처럼 같은 이름의 칸을 모두 채운다.index(0부터)를 주면 그 하나만 채운다. 칸의 이름은cell.field_name으로 읽고 쓴다. 채우면 칸 자신의 문단 글만 바뀌고, 칸 안에 든 표나 개체의 글(그 안의 셀 필드 값 포함)은 그대로다. 새 오류 코드field-cell-not-found.doc.text.replace(search, replacement, everywhere=True): 한/글 “모두 바꾸기”처럼 표 칸(칸 안 표 포함)·글상자·캡션·머리말·꼬리말·각주·미주·바탕쪽의 문단도 바꾸고, 서식이 다른 런에 걸친 말도 바꾼다. 바꿀 글의 글자는 같은 자리의 찾은 글자가 있던 런의 서식을 따르고, 남는 글자는 찾은 글의 마지막 글자 뒤에 붙는다. 탭·줄 바꿈이나 컨트롤을 사이에 둔 글은 한 말로 보지 않고, 메모 본문은 바꾸지 않는다. python-hwpx가 두 벌로 쓰는 머리말·꼬리말은 두 곳을 같이 바꾸고 한 번으로 센다. 기본값(False)은 전처럼 본문 문단의 런 안만 바꾼다.docs/ai-assistants.md의 양식 채우기 예제는 이 인자를 쓴다.doc.styles.apply_paragraph_format(paragraphs=[...]): 본문 인덱스 대신 문단 객체를 받아 표 셀(중첩 표 포함)·머리말·꼬리말 문단에도 사람 단위(mm·pt·%) 문단 서식을 적용한다(예:paragraphs=[table.cell(0, 0).paragraphs[0]]). 같은 문단 모양을 쓰던 다른 문단은 그대로다. 이 문서에 속하지 않은 문단(다른 문서의 문단, 지운 문단)이 섞이면 아무것도 바꾸기 전에paragraph-not-in-document로 거부하고, 인덱스 인자와 함께 주면paragraph-argument-conflict로 거부한다. 결과의paragraphs에는 본문 문단 인덱스만 담기고formatted는 대상 수다. 기존paragraph_index·paragraph_indexes의 뜻은 그대로다. 머리말·꼬리말 객체에paragraphs속성 (cell.paragraphs처럼 문단 객체 목록)을 더한다.apply_list_format()의 기본 글머리표·번호 모양이 한/글 새 목록과 다른 점(글머리표-·○대●, 번호 2수준1.1.대가., 3수준1.1.1.대1))과 글머리표를 맞추는 법 (bullet_char="●")을 설명과 known-traps에 적는다. 한/글이 새 목록에 쓰는 모양은 한/글이 저장한 목록 fixture로 테스트에 고정한다.HWP 5.0(
.hwp)을 읽고 쓴다.HwpxDocument.open이.hwp를 같은 문서 모델로 열고,save_to_path("x.hwp")·save_to_stream(..., format="hwp")·to_bytes(format="hwp")가 HWP 5.0으로 쓴다. 본문·글자와 문단 모양·스타일·표·그림·그리기 개체·글맵시·수식·차트·OLE· 동영상·필드·누름틀과 양식 개체·머리말과 꼬리말·각주와 미주·메모·바탕쪽·변경 추적· 문서 정보·인쇄 설정·스크립트를 옮긴다. 옮기지 못한 내용은document.conversion_report(unconverted·dropped)에 세고Hwp5ConversionWarning으로 알린다. HWP 5.0으로 쓸 수 없는 내용은 쓰기 전에Hwp5Error(hwp5-write-unsupported)로 거부하고, 암호·배포용·DRM 문서도Hwp5Error로 거부한다(hwp5-*코드).HwpxPackage.open은 그대로 HWPX 전용이며.hwp에는HwpxDocument.open을 안내한다. 새 의존성은 없다.쪽 번호·줄 번호 설명을 보강한다(
page.set_page_number,set_visibility,hide_page_elements,set_line_numbers와 known-traps).set_page_number()의 번호는 머리말/꼬리말 글이라 한컴의 쪽 번호 감추기(hide_first_page_num,hide_page_elements(page_num=True))로 숨지 않으니 머리말/꼬리말째 감춘다.hide_page_elements()는 문단이 있는 쪽에서만 감춘다(다음 쪽부터 다시 보임, 설명을 바로잡음). 줄 번호는set_visibility(show_line_number=True)일 때만 그려진다.새 문서가 빈 줄로 시작하는 까닭(
HwpxDocument.new()의 첫 문단은 구역 설정을 담은 빈 문단이고add_paragraph()는 그 뒤에 붙는다)과 첫 줄부터 쓰는 법 (doc.paragraphs[0].text = ...)을HwpxDocument.new()설명과 known-traps에 적는다.hwpx.layout.lint_layout()이 쪽에서 나뉘지 않는 본문 표(글자처럼 취급한 표,pageBreak="NONE"표)가 쪽 본문보다 높으면TABLE_TALLER_THAN_PAGE로 알린다. 한컴은 이런 표를 한 쪽에 그린다. 쪽 첫머리가 아니면 다음 쪽으로 옮기고, 아래 여백까지 내려 그리며, 종이 아래 끝을 넘는 행은 그리지 않는다. 높이는 행마다 가장 높은 셀 높이의 합(아래 한계)으로 잰다. 행이 잘리면overflow_policy="fail"에서 오류, 아니면 경고다. 여러 쪽에 걸칠 표는Table.set_treat_as_char(False)로 흐르게 한다.styles.apply_paragraph_format(border={...})로 문단 테두리를 만든다. 키는sides(기본 네 면),color(#000000),width(0.12 mm),type(SOLID),offset_mm(글과의 간격 mm, 수 하나 또는 왼쪽·오른쪽·위·아래),connect,ignore_margin이다.connect=True면 같은 문단 모양을 쓰는 연속 문단이 단과 쪽을 넘는 상자 하나로 그려진다(한컴의 “문단 테두리 연결”). 상자 안의 빈 문단에도 같은 서식을 주면 상자가 끊기지 않는다. 기존bottom_border=True는 그대로 아래 한 면만 켠다. 잘못된 지정은paragraph-border-invalid로 거부한다.템플릿을 넘기기 전에 패키지를 정리하는 기본 동작을 더한다. 무엇을 지울지는 호출자가 정한다.
doc.parts.clear_document_metadata(keep=("title", "language"), timestamp="1970-01-01T00:00:00Z")(HwpxPackage에도 같은 이름)는opf:metadata에서keep밖의 필드를 모두 비우고 비운 키를 문서 순서로 돌려준다. 이 라이브러리가 모르는opf:meta이름도 비운다.CreatedDate·ModifiedDate처럼 이름에Date가 든 필드는timestamp로 바꾸고, 자유형식date를 비롯한 나머지는 요소와 속성을 두고 내용만 비운다.doc.parts.clear_preview()는Preview/PrvText.txt를 비우고Preview/PrvImage.png를 1×1 흰 PNG로 바꾼다. 두 파트를 지우지는 않는다.doc.validate()가 파트가 없는 매니페스트 항목과, 매니페스트 항목이 없는BinData/파트를 경고로 알린다. 경고라서ok는 그대로다.BinData/밖의 파일을 잇는isEmbeded="0"항목(동영상 링크 등)은 알리지 않는다. 한/글은 OLE 개체에도isEmbeded="0"을 쓰지만 그 파일은BinData/안에 두므로, 빠지면 알린다.
Shape.set_position()이 기준 프레임과 정렬도 정한다.horz_rel_to·vert_rel_to·horz_align·vert_align이hp:pos의horzRelTo·vertRelTo·horzAlign·vertAlign을 쓴다. 값은 OWPML 스키마 철자 그대로다(vert_rel_to에는COLUMN이 없다).PAPER로 두면 확인 도장 같은 떠 있는 도형을 쪽 여백에 고정할 수 있다. 주지 않은 값은 그대로 두므로 오프셋만 주는 기존 호출은 결과가 같다. 스키마 밖의 값은 아무것도 바꾸기 전에shape-position-frame으로 거부한다.Shape.set_draw_text()에para_pr_id_ref(도형 안 문단의paraPrIDRef)와vert_align(hp:subList/@vertAlign,TOP/CENTER/BOTTOM)을 더한다. 둘 다 생략하면 XML이 전과 같다. 잘못된 정렬 값은shape-draw-text-vert-align으로 거부한다.Shape.draw_text·set_draw_text·remove_draw_text를 stable 표면에 올리고, 이들이 돌려주는 글상자를hwpx.model.DrawText라는 계약 이름으로 낸다(name·editable·text_margin·paragraphs·text·add_paragraph가 stable). 반환 객체 계약은 19개 클래스 / 189개 멤버가 된다.글꼴 표와 테두리를 값으로 읽는다.
doc.styles.fonts(lang="HANGUL")는 그 lang 블록의 글꼴을 id 문자열 →Font로,doc.styles.font_face(char_pr_id_ref, lang="HANGUL")는 글자 모양이 그 lang에서 가리키는 글꼴 이름을 돌려준다.doc.styles.border_fill_info(id)는hh:borderFill하나를BorderFillInfo(네 변과 대각선의BorderLine(type, width_mm, color), 단색 채우기fill)로 돌려준다. 값은 저장된 그대로이고, 그라데이션·그림 채우기는 설명하지 않는다(fill은None). 너비를 읽을 수 없으면style-border-fill-width-invalid다. 기존border_fill()은 그대로GenericElement를 돌려준다. 모두 메모리의 헤더를 읽어ensure_font()·ensure_border_fill()직후에도 맞는다.doc.styles.replace_font(src_face, dst_face, *, langs=None)로 글꼴 하나를 문서 전체에서 다른 글꼴로 바꾼다(읽는 쪽에 없는 장식 글꼴을 흔한 글꼴로 바꿀 때). lang 블록마다 바꿀 글꼴을 지우고 남은 글꼴 id를 0부터 다시 매기며, 모든 글자 모양의fontRef를 옮겨 다른 참조가 가리키는 글꼴은 바뀌지 않는다. 결과는FontReplaceReport(바뀐 블록langs, 새로 선언한 블록declared, 옮긴 참조 수repointed)다. 같은 글꼴 둘은style-font-replace-same-face로 거부한다.표 셀 안쪽 여백을 읽고 쓴다.
cell.margins는 한/글이 셀을 배치하는 여백을hwpx.objects.CellMargins(HWPUNIT,left·right·top·bottom)로 돌려준다. 셀의hasMargin이 꺼져 있으면 표의hp:inMargin, 켜져 있으면 셀의hp:cellMargin이다.add_table()이 만든 셀은CellMargins(510, 510, 141, 141)이다.cell.set_margins(left=, right=, top=, bottom=)는 주지 않은 면을 지금 여백으로 채워 네 면을 셀 여백에 쓰고hasMargin="1"로 켠 뒤 새 여백을 돌려준다. 여백이 실제로 바뀌면 그 셀에 바로 든 문단의 줄 배치 캐시를 지운다(안쪽 표 문단은 그대로). 인자가 없으면 아무것도 바꾸지 않는다.0 <= v < 2**31인int가 아닌 값(bool포함)은 바꾸기 전에HwpxValueError(cell-margin-value)로 거부한다.편집 의미론 문서에
table.set_cell_text()가 남기는 것과 다시 만드는 것(기본은 첫hp:t에 쓰고 나머지hp:t를 비우며 그렇게 비워진 문단만 지운다,split_paragraphs=True는 문단을 다시 만든다),table.set_column_widths([1] * column_count)가 나누는 규칙(전의equalize_column_widths()나눔: 표 너비 유지, 앞n-1열round(W / n), 마지막 열 나머지)과Paragraph.char_pr_id_ref가 그 문단의 run 전부에 들어간다는 것을 적는다.
바꿈
마지막 문단을 지우려는
paragraph.remove()가 맨ValueError대신HwpxValueError(ValueError하위라except ValueError는 그대로 잡는다)를 낸다.code는paragraph-remove-last,context["container"]는 문단을 담은 곳 (section·cell·header·footer)이다. 메시지는 같다.HwpxOxmlTable.equalize_column_widths()가 한/글 “셀 너비를 같게”처럼 행마다 칸을 같은 너비로 나눈다. 합친 칸은 그 행의 한 칸으로 세고, 모든 행이 같은 자리에서 끝나도록 표 너비를 행마다의 칸 수로 모두 나누어떨어지는 값까지 올린 뒤(예: 3칸 행과 4칸 행이면 12의 배수) 열 격자(colCnt·cellAddr·cellSpan)를 새 칸 경계로 다시 짠다. 한/글과 같아서 칸 수가 다른 행이 많으면 표가 크게 넓어질 수 있다. 칸 영역(hp:cellzone)의 열 주소도 새 격자로 옮기고, 같은 칸을 덮을 수 없으면 표를 그대로 두고HwpxValueError를 낸다. 합친 칸 아래에 크기 0인 자리 표시 칸이 남아 있는 표에서는 자리 표시 칸마다 덮는 칸의 새 열을 하나씩 주고, 열이 모자라면 남는 빈 자리 표시 칸은 없앤다(한/글은 합친 칸 아래에 칸을 쓰지 않는다). 전에는 격자 열을 같게 해서, 칸 경계가 행마다 다른 표에서는 칸 너비가 고르지 않았다. 세로로 합친 칸이 행마다 다른 너비를 받아야 하는 표는 한/글처럼 바꾸지 않고HwpxValueError를 낸다. 격자 열마다 같은 너비가 필요하면set_column_widths([1] * column_count)를 쓴다.validate_document()가 구역·머리 XML을 번들된 전체 OWPML 스키마(DevDoc/OWPML SCHEMA의 Body·ParaList·Core·Header)로도 검사한다(#118). 한/글 2011 네임스페이스를 2024로 바꿔 끼운 사본을 보고, 한/글이 여는 문서에도 있는 편차(2011 관행)는 빼고 나머지를 경고(OWPML schema: …)로 낸다.ok는 전처럼 하드 오류만 본다. 끄려면full_schema=False. 이 검사가 돌지 못하면 멈추지 않고 그 까닭을 경고로 남긴다.hp:secPr안의 주석·처리 지시는 건너뛴다.문단 객체의
add_hyperlink(url, text)도doc.add_hyperlink·doc.refs.add_hyperlink처럼 링크 글을 한/글 관례(파랑#0000FF+ 파랑 밑줄)로 쓴다. 전에는 문단의 글자 모양을 그대로 써서 링크가 보통 글처럼 보였다. 글꼴·크기·굵기 같은 나머지 모양은 링크가 들어가는 문단의 글자 모양을 따른다. 두 경로 모두 같고, 모양이 같은 문단의 링크는 글자 모양 하나를 함께 쓴다.char_pr_id_ref를 주면 그 모양을 쓴다. 각주·미주 본문의add_hyperlink도 같다. Markdown 내보내기는 링크 글에 밑줄·글자색 장식을 붙이지 않는다 (링크 표기가 이미 그 모양이다).doc.text.plain()·markdown()·html()(hwpx.tools.exporter)이 본문 글상자(도형 안 글)의 글을 내보낸다. 글상자의 문단은 그 글상자가 놓인 자리에, 그 문단의 표와 함께 문서 순서로 온다. 쪽 미리보기(render_layout_preview, 문서 뷰어)는⟦도형⟧표시 옆에 글상자 글을 쓴다. 전에는 둘 다 글상자 글을 버렸다(칸 안 글상자는 전부터 칸 글에 들어갔다). 머리말·꼬리말·각주·미주·메모 안의 글상자는 전처럼 본문으로 치지 않는다. 칸 안 글상자의 글은 미리보기에 한 번만 나온다. 메일 머지(merge_template_rows)는 글상자 속 자리표시자도 바꾼다 (본문·칸·다른 글상자 안의 글상자 모두). 전에는 찾기만 하고 바꾸지 않았다.doc.text.plain()·markdown()·html()(hwpx.tools.exporter)이 문단 안의 표·글상자· 캡션을 그 문단의 글 뒤에 모아 쓰지 않고, 한/글의 텍스트 저장처럼 놓인 자리에서 문단 글을 나눠 쓴다(개체 앞 글, 개체, 개체 뒤 글).list_labels의 번호와 글머리표는 첫 조각에 붙는다. 표 칸 안에서도 같아서, 칸 안의 글상자와 표는 칸 글 속 제자리에 오고 칸 안 표의 캡션은 그 표 뒤에 온다(전에는 칸 문단의 글 뒤에 왔고 캡션은 표 앞에 왔다).apply_table_ops의insert_row_by_clone이 합친 칸이 걸린 행도 한/글이 줄을 넣듯 처리한다. 기준 행 아래로 이어지는 합친 칸은 복제하지 않고 새 행 수만큼rowSpan을 늘리며, 윗행에서 내려와 기준 행에서 끝나는 합친 칸 밑에는 새 행마다 그 칸의 서식·너비로 빈 칸(기준 행 높이)을 넣는다. 전에는 기준 행에 여러 행에 걸친 칸이 있으면 거부했고(“clone source row must have rowSpan==1 cells”), 합친 칸이 기준 행에서 끝나면 새 행에 칸이 비어 거부했다. 모든 칸이 아래로 이어지는 행은 복제할 칸이 없어 거부한다.doc.parts.add_master_page()(doc.oxml.add_master_page())가page_number를 받지 않으면OPTIONAL_PAGE는 1, 다른 종류(BOTH·ODD·EVEN·LAST_PAGE)는 한/글처럼 0을 쓴다. 전에는 종류와 상관없이 1을 썼다.한 구역에 같은 쪽의 바탕쪽을 둘 연결하면(
add_master_page_reference·doc.page.set_master_page)HwpxValueError(master-page-pages-taken)를 낸다. 양쪽·홀수·짝수·마지막 쪽은 하나씩, 한 쪽 바탕쪽은 쪽 번호마다 하나다. 전에는 그대로 연결되어.hwp저장이 실패했다.add_table()이 만드는 표의 행 높이 기본값을 12.7 mm(3600)에서 한컴이 새 표에 쓰는 282로 바꾼다. 행은 셀 글 높이에 맞춰 자라서, 한 줄이면 약 4.6 mm다. 전처럼 높은 행이 필요하면height=를 준다.add_table()은 행들만으로 쪽 본문보다 높은 표를 흐르는 표로 만든다(글자처럼 취급을 끔). 행 높이는 셀 높이와 셀 글 한 줄 + 셀 위아래 여백 중 큰 값으로 잰다. 한컴은 글자처럼 취급한 표를 쪽에서 나누지 않아, 이런 표는 종이 끝에서 잘렸다. 흐르는 표는 행 사이에서 쪽을 넘는다. 쪽 크기는 그려지는 쪽(가로면 돌린 높이)으로 잰다.doc.media.remove_image()가 문서가 아직 가리키는 이진 항목을 지우지 않고HwpxValueError(media-item-in-use)를 낸다. 가리키는 곳은 그림, header의 채우기 그림·그림 글머리표, 바탕쪽, 동영상 파일·포스터, OLE, 내장 글꼴이고,context["references"]에"파트: 요소@속성"으로 담긴다. 거부는 바꾸기 전에 일어난다. 전에는 그대로 지워서 쪽 테두리 채우기 그림 같은 참조가 끊긴 채 저장되었다. 그래도 지우려면force=True를 준다. 구역·header처럼 이진 항목이 아닌 매니페스트 항목은 지우지 않고False를 돌려준다(전에는remove_image("section0")이 구역 파트를 지웠다).
고침
doc.styles.replace_font()가 한 언어 블록에 같은 이름으로 두 번 선언된 글꼴을 하나만 바꾸던 것을 고친다. 한/글이 저장한 문서에 흔한 모양으로, 둘째 선언을 가리키는 글자 모양은 옛 글꼴로 남는데 보고서는 그 블록이 바뀌었다고 알렸다. 이제 블록 안의 같은 이름 선언을 모두 지우고 그 참조를 모두 새 글꼴로 옮긴다.MS Word처럼 배치하는 문서(
hh:compatibleDocument의targetProgram="MS_WORD")를.hwp로 열고 저장할 때 배치 호환 설정이 사라지던 것을 고친다. 열 때hh:layoutCompatibility를 비워 두고 저장할 때 0으로 써서, Word 호환 배치가 모두 꺼졌다. 이제 켜진 설정마다hh:layoutCompatibility의 자식 하나로 한/글이 쓰는 순서대로 열고, 저장할 때 다시 쓴다. 한/글처럼HWP201X문서는 설정 없이 저장하고, 한/글이 모르는 자식이 있으면 한/글의 기본 설정으로 저장한다. 한/글의 일부 판이 쓰는 묶음 요소 (hh:char·hh:paragraph·hh:section·hh:object·hh:field)와 그 안의 것은 한/글처럼 건너뛴다.applyFontspaceToLatin은 한/글이 HWPX로 쓰지는 않지만 읽는 설정이라, 문서의 배치가 그대로 남도록 열어 둔다..hwp로 저장할 때 줄 간격AT_LEAST(최소)를 옛 줄 간격 필드에 한/글처럼 100%로 쓴다. 전에는 옛 필드에BETWEEN_LINES와 새 값을 썼다.표
merge_cells()(doc.tables.merge_cells)가 가려지는 칸의 글과 개체를 버리던 것을 고친다. 이제 병합 칸이 글이나 개체가 있는 칸의 문단을 읽기 순서(행마다 왼쪽에서 오른쪽, 위 행부터)로 모두 받고, 빈 칸(빈 문단 하나)은 아무것도 보태지 않는다. 병합 칸이 비어 있었으면 그 빈 줄 대신 옮겨 온 문단만 남는다. 칸 크기가 바뀌므로 병합 칸의 줄 배치 캐시는 비운다. 병합한 뒤split_merged_cell()로 나누면 옮겨 온 글은 첫 칸에 남는다. 병합할 영역의 칸 격자는 한 번만 만들어서 큰 표의 병합이 빨라졌다. 병합으로 칸이 하나도 남지 않은 행과, 어느 칸도 시작하지 않는 열은 한/글처럼 없앤다(행 전체를 합치면 그 높이의 한 행이 되고, 표 전체를 합치면 한 칸짜리 표가 된다). 빈hp:tr이 남은 표는 한/글이 열지 못했다.표 칸의
.text =(set_text)가 글을 지운 문단을 빈 줄로 남기던 것을 고친다. 글이 지워지고 남은 것이 없는 칸 문단은 없애서, 넣은 글이 그대로 읽힌다(병합한 칸에 글을 넣을 때도 같다). 원래 빈 줄이던 문단과 개체가 든 문단은 그대로 둔다.번호 형식을 받은 그대로(대문자로만 바꿔) 쓰던 것을 고친다. 목록(
styles.apply_list_format의number_format,ensure_numbering레벨의format), 각주·미주(set_footnote_auto_num_format·set_endnote_auto_num_format의type), 쪽 번호(page.set_page_number의format_type)가 그렇다. 한컴은 모르는 형식을 거부하지 않고 아라비아 숫자로 매겨서,number_format="decimal"같은 값이 조용히1. 2. 3.이 되었다. 이제 목록·개요 머리와 쪽 번호는 한컴 번호 모양 15개(hc:NumberType1:DIGIT·ROMAN_SMALL·ROMAN_CAPITAL·LATIN_SMALL·CIRCLED_DIGIT·HANGUL_SYLLABLE등,hwpx.oxml.numbering_kinds.NUMBER_FORMATS)를, 각주·미주 번호는 여기에DECAGON_CIRCLE·DECAGON_CIRCLE_HANJA·SYMBOL·USER_CHAR를 더한 19개(hc:NumberType2,NOTE_NUMBER_FORMATS)를 받는다. 쪽 번호가 먼저 받던 짧은 이름(roman→ROMAN_CAPITAL,roman_lower→ROMAN_SMALL,alpha→LATIN_CAPITAL등)도 받고, 그 밖의 값은HwpxValueError(style-number-format-invalid)로 거부한다.색 인자가
#RRGGBB가 아니어도 그대로 쓰던 것을 고친다. 한컴은 색 값을 16진 수 하나로 읽고 나머지를 거부하지 않아서,#ABC는 CSS의#AABBCC가 아니라#000ABC로,red는 검정으로,#12345는#012345로 보였다. 이제styles.ensure_run(color·highlight·underline_color·shadow), 칸·테두리 채우기와 그러데이션 색, 메모 모양, 도형 선·채우기, 단 구분선,body_patch의restyle_text글자색은#RRGGBB와#AARRGGBB(#생략·소문자 허용)만 받고(none을 받던 자리는none도), 그 밖의 값은HwpxValueError(style-color-invalid)로 거부한다.#AARRGGBB는 한컴이 무늬·테두리·선·그림자 색에 쓰는 꼴(알파 먼저)이라, 문서에서 읽은 색을 넘겨도 그대로 쓴다. 거부하면 아무것도 바꾸지 않는다: 머리말·꼬리말set_content는 내용을 비우기 전에 색을 검사하고, 그 뒤에 값이 거부되어도 원래 내용으로 되돌린다.set_columns도 구분선 값을 먼저 검사한다.테두리 굵기(
styles.ensure_border_fill의border_width,apply_paragraph_format의 문단 테두리 굵기)와 단 구분선 굵기(page.set_columns의separator_width)를 받은 그대로 쓰던 것을 고친다. 한컴은 선 굵기 목록(0.1 mm~5.0 mm)에 글자 그대로 있는 값만 읽고,1 mm·2 mm·0.12mm처럼 목록 밖의 값은 가장 가는0.1 mm로 그렸다. 이제"1 mm"·"1mm"·1은"1.0 mm"로 쓰고, 목록에 없는 굵기는 가장 가까운 목록 값으로 쓴다(한가운데면 굵은 쪽:"0.45 mm"는"0.5 mm","6 mm"는"5.0 mm"). 0보다 큰 mm 값이 아니면 ("thick"·"1 cm"·0)HwpxValueError(style-line-width-invalid)로 거부한다.hwpx.oxml.utils.LINE_WIDTHS가 그 목록이다.styles.ensure_run(ratio=...)(장평)가 256~400을 받던 것을 고친다. 한컴은 장평을 한 바이트로 두어 256 이상은 256을 뺀 값이 된다(300은 44%로 그려짐). 이제 범위는 10~255다.테두리 종류(
styles.ensure_border_fill의border_type, 문단 테두리, 표 칸 테두리)의THICK_3D·THICK_3D_REVERSE_LIGHTING·SLIM_3D·SLIM_3D_REVERSE_LIGHTING을 그대로 써서, 한컴이 모르는 표기라 테두리가 없는 것(NONE)으로 그려지던 것을 고친다. 이제 한컴 표기THICK3D·THICKREV3D·3D·REV3D로 바꿔 쓰고, 한컴 표기도 그대로 받는다..hwp로 저장할 때 그림 효과PATTERN8x8을 한/글이 읽지 않는 값으로 쓰던 것을 고친다. 한/글처럼 원래 그림(REAL_PIC)으로 쓰고,.hwp에서 이름이 없는 효과 값은effect없이 연다..hwp의 선 종류 13~17을 한/글이 쓰는 이름(DOUBLEWAVE·THICK3D·THICKREV3D·3D·REV3D)으로 열고, 저장할 때는 이 이름과THICK_3D같은 다른 철자를 모두 받는다. 문단 번호의 번호 형식을 4비트로만 써서DECAGON_CIRCLE_HANJA가 다른 형식으로 바뀌던 것도 고친다.그림자가 있는 도형을
.hwp로 저장하고 열 때 바깥 여백을 한/글처럼 셈한다. 기울임·원근·확대·축소 그림자가 도형 밖으로 나간 만큼을 더하고 빼며, 왼쪽이나 위로 민 그림자도 그쪽 여백에 더한다. 큰 도형에서 여백이 16비트를 넘으면 한/글처럼 아래 16비트로 저장하고, 열 때 원래 여백으로 되돌린다 (전에는 32비트를 넘는 값으로 열렸다).HWPX에 없는 배치 속성을
.hwp에 쓸 때 한/글이 주는 값을 쓴다.textWrap은 도형이SQUARE, 양식 개체가TOP_AND_BOTTOM이고,vertRelTo·horzRelTo는PAPER,widthRelTo·heightRelTo는PAGE, 캡션side는LEFT다. 채운 화살표(FILLED_*)와 덧말 위치CENTER처럼.hwp에 없는 값도 한/글처럼 기본값으로 쓴다..hwp의 틀 없는 글자 겹치기를 한/글처럼OVERLAP으로 연다. 전에는SPREAD로 열어 저장할 때 빈칸을 붙였다. 수식 버전이 빈.hwp수식은 빈 채로 열고 저장한다.export_text()·export_markdown()·export_html()이 표 칸 글의 앞뒤 공백을 지우던 것을 고친다. 들여 맞춘용 역 명이용 역 명으로,협조자가협조자로 나왔다. 한/글이 저장한 문서의 미리보기 글(Preview/PrvText.txt)도 칸 글의 공백을 그대로 둔다. 칸 끝의 빈 문단은 전처럼 빼고, 글에 든 공백만 지킨다.apply_paragraph_format()가 여백·들여쓰기·문단 간격을hp:switch안에 쓸 때hp:default에는hp:case값의 두 배를 쓴다. 한컴 문서와 같은 표기다. 전에는 두 곳에 같은 값을 써서,hp:case를 모르고hp:default를 읽는 프로그램에서는 여백이 절반으로 보였다.hp:switch밖의 여백은 준 값 그대로다.표 칸 하나의 테두리를 바꾸면(
table.set_cell_borders) 이웃 칸의 맞닿은 변이 옛 선으로 남아, 한컴에서 두 선이 겹쳐 그려지던 것을 고친다. 칸마다 네 변을 따로 가지고 맞닿은 변은 두 칸의 선이 다 그려지므로, 한컴의 칸 테두리 명령은 이웃 칸의 맞닿은 변도 같은 선으로 바꾼다. 이제set_cell_borders()도 이웃 칸의 맞닿은 변만 같은 선으로 바꾼 테두리/배경 정의를 이웃에 준다. 이웃의 다른 변과 배경은 그대로다. 한컴처럼, 맞닿은 변이 바꾼 칸의 변보다 긴 이웃(한 칸 옆의 병합 칸)은 바꾸지 않는다. 칸 하나가 가리킬 정의를 정하는set_cell_border_fill()은 전처럼 그 칸만 바꾼다.apply_paragraph_format(alignment=...)가 한컴의 나눔 정렬DISTRIBUTE_SPACE를 받는다. 전에는 배분 정렬DISTRIBUTE만 받고DISTRIBUTE_SPACE는 알 수 없는 정렬이라며 거부했다(문서를 읽을 때는 이 값을 그대로 둔다).add_heading()이 제목 문단을 그 개요 스타일의 문단 모양·글자 모양에서 만든다. 전에는 문단 모양 0(바탕글)에 개요 수준만 더하고 글자 모양도 0을 써서, 한컴에서 개요 번호는 붙지만 스타일의 들여쓰기·간격·글자 모양이 빠진 제목이 됐다. 한컴은 문단을 스타일이 아니라 문단에 달린 모양으로 그린다.char_pr_id_ref를 주면 그 글자 모양을 쓴다.수식 상자 크기(
hp:sz)와 기준선(baseLine)을 수식 구조로 잰다(add_equation,estimate_equation_size). 한컴은 문서를 열 때 수식을 다시 재지 않고 저장된 상자로 줄을 배치한다. 이전 추정(보이는 글자 수 × 0.45, 높이는 기준 크기의 1.6~2.5배)은 한 줄짜리 수식도 상자를 크게 잡아 수식 뒤에 빈틈이 생기고 줄이 높아졌으며, 좁으면 뒤 글자와 겹쳤다. 기준선도 기준 크기에서 계산한 값이라 수식이 위아래로 어긋났다. 이제 글자 종류별 너비, 분수(over), 위·아래 첨자, 근호, 큰 연산자와 그 범위,lim아래 범위, 행렬과pile, 줄 나눔(#)을 상자로 쌓아 크기를 재고, 기준선은 상자 높이에서 기준선 위 부분의 비율(한 줄 수식 약 86)로 쓴다. 설명의 ‘한컴이 열 때 다시 잰다’도 바로잡았다.구역에 XML 주석이나 처리 명령이 있는 문서를 편집한 뒤 저장하면
TypeError: cannot serialize <cyfunction Comment>로 멈추던 것을 고친다(6.5.0부터 있던 결함). 실문서 가운데 표 행 안에 주석을 둔 문서가 있었고, 편집하지 않고 저장하면 원본 바이트를 그대로 써서 드러나지 않았다. 이제 편집한 파트를 쓸 때 주석과 처리 명령은 내용이 아니므로 빼고, 그 뒤의 글은 남긴다. 주석이 없는 문서의 출력은 그대로다.doc.text.replace(..., everywhere=True)가hp:t안 XML 주석의 글까지 찾아 바꾸던 것을 고친다. 주석은 건너뛰고, 주석 양쪽의 글은 이어진 글로 찾는다.doc.text.plain()·markdown()·html()(hwpx.tools.exporter)이 표·그림·도형의 캡션과 덧말을 내보내지 않던 것을 고친다. 한/글의 텍스트 저장처럼 표 캡션은 표 뒤에, 그림·도형 캡션은 그 자리에 오고, 덧말은 본말 뒤에(덧말:<덧말 글>)로 붙는다. 칸 안 표의 캡션은 전처럼 칸 글에 한 번 들어간다. 캡션의 자동 번호는 담긴 번호로 쓴다(그림 1,표 1).hp:switch에 두 번 쓰인 개체 (차트와 그 OLE 대체본)는 한 번만 읽고,include_tables=False면 표와 함께 그 캡션도 뺀다. 메일 머지(merge_template_rows)는 자리표시자를 한/글 “모두 바꾸기”가 닿는 곳(표 칸·글상자· 캡션·머리말·꼬리말·각주·미주)과 덧말에서도 바꾼다. 전에는 내보내기로 찾기만 하고 바꾸지 못해 그 행을 실패로 보고했다.글자 모양을 바꾸는 API가 기준 글자 모양의 나머지 서식을 지키게 고친다. 런의
bold·italic·underline을 바꾸면 글자 크기·색·글꼴이 첫 글자 모양의 것으로 돌아갔다.styles.ensure_run()과add_run(size=...)같은 글자 서식 인자는 요청한 값만 같은 아무 글자 모양이나 돌려줘, 새 문서에서add_run("글", size=16)이 파란 제목 글자가 되고base_char_pr_id를 주어도 다른 글자 모양이 나왔다. 양식 칸에 맞춰 글자를 줄이면 굵게·기울임·밑줄이 풀렸고, 새로 만든 글자 모양에서는 기준의 취소선이 빠졌다. 이제 요청한 글자 모양은 기준(base_char_pr_id, 없으면 첫 글자 모양)에서 요청한 값만 바꾼 것이고, 내용이 같은 글자 모양이 있을 때만 그것을 다시 쓴다.ensure_run()에서 주지 않은bold·italic·underline은 기준의 것을 따른다(기준을 주지 않으면 끔).끝이 아닌 구역을
remove_section()으로 지운 문서를 한/글이 열지 못하고,add_section(after=...)로 가운데 넣은 구역이 한/글에서 맨 뒤에 나오던 것을 고친다. 한/글은 구역을content.hpf항목 idsection0,section1, …의 번호 순서로 찾고(spine 순서나 파일 이름이 아니라), 번호가 하나라도 빠지면 문서를 열지 않는다. 이제 구역을 넣거나 지우거나 문서를 저장할 때 구역 항목의 id를 문서 순서대로 다시 매긴다(파일 이름은 그대로). 그래서 id가 어긋난 채 저장된 파일도 다시 저장하면 바로잡힌다. 새 구역은 다른 구역 파일이나 항목이 쓰는 번호를 받지 않는다.doc.text.replace()(과run.replace_text()를 쓰는 메일 병합)가hp:t안의 탭·줄 바꿈을 사이에 둔 글을 이어 읽어,사⇥과를사과로 찾아 바꾸던 것을 고친다(탭은 남고 글자만 합쳐졌다). 한/글처럼 탭·줄 바꿈 같은 글자 요소와 컨트롤은 말을 끊는다. 형광펜 표시는 전처럼 끊지 않는다.표 셀·머리말·꼬리말 문단의
remove()가 아무 일도 하지 않던 것을 고친다. 문단을 구역 바로 아래에서만 찾아, 셀 문단(cell.paragraphs[i].remove())은 오류 없이 그대로 남았다. 이제 문단을 담은 구역이나hp:subList에서 지운다. 담은 곳의 마지막 문단은 지우지 않고ValueError를 낸다(문단이 없는 셀·머리말·꼬리말은 한/글이 열지 못한다). 이미 지운 문단의remove()는 조용히 넘어간다. 같은 까닭으로 셀 문단의apply_model()이ValueError를 내던 것도 고친다.그림 같은 이진 항목이 많은 문서를 여는 데 오래 걸리던 것을 고친다.
content.hpf의 항목마다 패키지의 모든 파트 이름을 다시 정규화해서, 항목·파트 수의 제곱에 비례했다 (파트 1,400개 문서에서 열기 1분 넘게). 이제 목록을 읽을 때 파트 이름을 한 번만 정규화한다.resolve_part_name()의 동작은 그대로다.저장이 한컴이 쓴 문단 줄 배치 캐시(
hp:linesegarray)를 멀쩡한데도 지우던 것을 고친다. 저장 때 캐시가 글보다 뒤를 가리키는지 보는 검사가hp:t안의 줄 바꿈·고정 폭 빈칸·탭을 글자 수에서 빼고 셌다. 한컴의 줄 시작 위치(textpos)는 이것들을 센다(탭 8, 나머지 1). 그래서 구역을 다시 쓸 때(그 구역의 다른 문단만 고쳐도) 이런 문단의 캐시가 사라져, 한컴이 그 문단을 새로 배치하면서 쪽 수가 바뀔 수 있었다. 이제 한컴의 글자 위치로 센다.doc.text.markdown(rich=True)(hwpx.tools.markdown_export)가 도형(사각형·타원· 다각형)을 품은 문단의 글을 잃던 것을 고친다.도형을 품은 문단은 제 글을 통째로 버렸다(도형 글이 흘러나온 것으로 보았다). 이제 문단 자신의 글이 도형 안의 글과 같을 때만 뺀다.
도형 안 문단을 이미 쓴 것인지
id()로 가렸다. 풀린 lxml 요소 프록시의 번호를 다른 문단이 다시 받으면, 처음 보는 도형 문단을 건너뛰었다(칸 안 도형도 같음). 이제 요소 자체로 가린다.
hwpx.table_patch.apply_table_ops의delete_table·clone_table·split_table·merge_table이 표를 담은 문단을 잘못 찾던 것을 고친다. 문단 안에서 표 앞에hp:pagePr·hp:pageBorderFill·hp:pic처럼 이름이p로 시작하는 요소가 있으면 (구역 설정이 든 구역 첫 문단의 표 등) 그 요소를 문단 시작으로 알아, 잘린 XML이 저장 전 검사에 걸려ValueError로 멈추거나merge_table이 두 표 사이에 글이 있다고 잘못 거부했다. 이제 표를 감싸는 가장 안쪽 문단을 찾는다. 그 문단에 구역 설정·글·다른 표가 함께 있으면 문단 대신 표만 다룬다.delete_table은 표만 지우고,clone_table·split_table의 새 표는 그 표만 담은 새 문단(같은 문단 모양, 쪽·단 나눔 없음)에 들어간다. 한 문단에 든 두 표를merge_table하면 표만 합치고, 두 표 사이에 글이 있으면 거부한다.autofit_columns가 표 안에 표가 있는 표에서KeyError를 내던 것을, 다른 구조 편집처럼TableStructureError로 거부하게 한다.delete_column이 한 칸짜리 칸만 있는 행이 표의 모든 열을 덮지 않을 때(오른쪽 열이 윗행에서 내려온 합친 칸에 덮인 행) 그 행을 열 폭의 근거로 써서KeyError를 내던 것을 고친다. 이런 행은 건너뛰고, 없으면 합친 칸 격자에서 폭을 구한다.delete_row가 세로로 합친 칸의 첫 행을 지우면 합친 칸까지 지워 표에 빈 자리가 생겨 거부되던 것을 고친다. 이제 합친 칸은 다음 행으로 내려가 한 행 줄어들고, 글과 서식은 그대로다(한컴 편집기에서 그 행을 지운 결과와 같다).doc.media.images가content.hpf매니페스트에만 있는 이진 항목을 보지 못하던 것을 고친다. 한컴이 저장한 파일은 보통 header에binDataList가 없어 그림이 있어도 빈 목록이 나왔다. 이제 header 항목 뒤에 매니페스트에만 있는 항목(href가BinData/아래이거나 media-type이image/*)을 붙인다.isEmbeded="0"으로 바깥 파일을 잇는 항목은 넣지 않고, 파트가 없는 내장 항목은size=0으로 넣는다.doc.media.remove_image()는 매니페스트 id·파트 경로 ("BinData/image1.png")·BinaryItem을 모두 받아 이런 항목도 지운다.doc.media.remove_image("image1")이 header에image10.png가 먼저 있으면 그binItem과 파트를 대신 지우던 것을 고친다. header 항목을 파일 이름 앞부분으로 맞췄기 때문이다. 이제 확장자를 뺀 파일 이름(또는 파일 이름 전체)이 같아야 맞는다.doc.media.replace_picture()가 바꾼 그림의 옛 이진 항목을 header의 채우기 그림이나 바탕쪽 같은 다른 곳이 아직 쓰는데도 지우던 것을 고친다. 본문 그림만 보고 고아로 판단했기 때문이다. 이제 문서 어디서도 가리키지 않을 때만 지우고, 아니면 남긴다(removed_orphans가 빈다).HwpxPackage.remove_manifest_item()에 파트 경로를 넘기면False만 돌려주고 항목을 남기던 것을 고친다. 이 인자는 매니페스트id다. 그 id의 항목이 없고 값에/가 있으면 href가 같은 파트를 가리키는 항목을 지운다.HWP 5.0으로 저장(
to_bytes(format="hwp")·save_to_path("*.hwp"))할 때 원본 구역에 XML 주석이 있으면ValueError: Invalid input tag로 멈추던 것을 고친다. 실문서 가운데 표 행 안에 주석을 둔 문서가 있었다. 이제 주석과 처리 명령은 내용이 아니므로 건너뛴다.머리말·꼬리말 객체로 고친 내용이 한/글에 나타나지 않던 것을 고친다. python-hwpx가 만든 머리말·꼬리말은 구역 설정(
hp:secPr) 안과 본문hp:ctrl안에 두 벌로 쓰이고, 한/글은hp:ctrl쪽만 읽는다.set_header()·set_footer()가 돌려준 객체의text설정,add_run(),add_paragraph(),add_page_number_field(),set_content(),clear_content()와 그 문단을 고친 내용은 구역 설정 쪽에만 들어가, 한/글에서는 처음 글이 그대로 보였다. 이제 고친 구역을 저장할 때 두 벌을 맞춘다. 두 벌이 마지막으로 같았던 때(문서를 열 때, 머리말·꼬리말을 설정할 때, 저장할 때) 뒤에 바뀐 쪽을 다른 쪽에 옮기고, 알 수 없거나 둘 다 바뀌었으면 구역 설정 쪽을 따른다. 두 요소는 제자리에 남아서 저장한 뒤에도 머리말 객체를 계속 쓸 수 있다. 두 벌로 쓰인 머리말·꼬리말의 누름틀은doc.fields에 한 번만 나온다.id·apply_page_type을 바꾸면hp:ctrl쪽도 함께 바꾸고(홀수 쪽으로 바꾼 머리말이 모든 쪽에 보이던 것),BOTH가 되면 홀수·짝수 쪽 것보다 앞에 둔다(hp:ctrl쪽만 있는 머리말·꼬리말도 같다). 한/글이 저장한 문서처럼hp:ctrl쪽만 있는 머리말·꼬리말의 내용은 저장할 때 건드리지 않는다.clear_content()와 빈set_content([])는 빈 문단 하나를 남긴다. 전에는hp:subList까지 지웠는데, 실제 문서의 머리말·꼬리말은 모두hp:subList와 문단을 하나 이상 가진다.칸·테두리 그림 채우기(
set_cell_fill_image(mode=),ensure_border_fill(fill_image={"mode": ...}))가LEFT_TOP·LEFT_BOTTOM·RIGHT_CENTER·RIGHT_TOP도 받는다. 한/글이 쓰는 그림 위치인데 OWPML 스키마의 목록(12개)에 없어ValueError를 냈다.TextExtractor.extract_text()가 안쪽 문단을 두 번 쓰던 것을 고친다.include_nested=True(기본)에서 각주를footnote="inline"으로, 컨트롤을control="nested"로, 개체를object_behavior="nested"로 글에 넣으면 그 안의 문단이 따로 한 번 더 나왔다.object_behavior="nested"는 칸 안의 표처럼 개체 안의 개체 글을 문단 하나 안에서도 거듭 썼다. 이제 앞 문단의 글에 이미 들어간 문단은 따로 쓰지 않고, 개체는 자기 칸·글상자의 문단만 돌며 그 안의 개체는 그 문단이 쓴다.평문·HTML·Markdown 내보내기(
doc.text.plain()·html()·markdown(),hwpx.tools.exporter)의 표 글을 고친다. 칸 안의 표는 바깥 칸의 글에 들어 있는데도 따로 한 번 더 나왔다. 칸에 단 각주·미주·메모의 본문이 칸 글에 섞였다(본문 문단에 단 것은 빠졌다). 머리말·꼬리말 안의 표가 본문 첫 문단 자리에 나왔다. 이제 표는 바깥 표만 한 번 나오고, 각주·미주·메모·숨은 설명·머리말·꼬리말의 글은 본문 내보내기에 넣지 않는다. Markdown 표 칸은 문단 나눔을<br>로,|를\|로 써서 한 줄에 둔다(전에는 칸 안의 줄 나눔이 표 행을 깨뜨렸다).doc.text.markdown()이 첫 행보다 칸이 많은 행의 뒤쪽 칸을 버리던 것을 고친다. 첫 행이 합친 칸(제목 행 등)이면 그 아래 행은 첫 칸만 남았다. 이제 칸을hp:cellAddr자리에 놓고 가장 넓은 행만큼 열을 두며, 합친 칸이 덮는 자리는 비운다.doc.tracking.delete(문단)로 글만 있는 문단을 통째로 지우면, 한컴에서 그 자리에 빈 줄이 남던 것을 고친다. 문단 나눔은 삭제로 표시되지 않았다. 이제 뒤에 문단이 이어지면 마지막 삭제 표시에paraend="1"을 써서 문단 나눔도 지운다. 구역 설정·컨트롤·개체가 있는 문단과 마지막 문단은 전처럼 나눔을 남긴다.append_document/insert_document가 원본 첫 문단의 단 설정(hp:colPr)을 뺄 때, 같은hp:ctrl안에 함께 있던 다른 컨트롤(누름틀 시작, 쪽 번호 새로 시작 등)까지 지우던 것을 고친다. 누름틀 끝만 남아 짝이 끊긴 문서는 한컴에서 열리지 않았다. 이제hp:colPr만 빼고,hp:ctrl은 비었을 때만 지운다.insert_document(after_paragraph_index=-1)가 대상의 구역 설정을 새 첫 문단으로 옮길 때도hp:colPr만 옮긴다.문서를 저장할 때 같은 패키지 바이트에 열기 안전 검사(
validate_editor_open_safety)를 두 번 돌리던 것을 한 번으로 줄인다. 패키지 저장이 검사를 통과시킨 바이트의 SHA-256을 기억하고, 문서 쪽 검사는 같은 바이트면 건너뛴다. 패키지가 검사하지 않은 바이트는 전처럼 검사한다. 긴 문서의 저장이 빨라진다.styles.ensure_run(font=...)가 머리말에 없는 글꼴을 조용히 무시하던 것을 고친다(글자는 기본 글꼴로 그려졌다). 이제 한컴처럼 그 글꼴을 일곱 언어 모두에 선언하고 적용한다(ensure_font의 기본값과 같다).일부 언어에만 선언된 글꼴을
ensure_run(font=...)로 쓰면, 선언되지 않은 언어의fontRef에 다른 언어의 글꼴 번호가 들어가던 것을 고친다.fontRef는 언어마다 번호를 따로 매겨서, 그 언어에 글꼴이 더 있으면 엉뚱한 글꼴이 됐다. 이제 글꼴이 선언된 언어만 바꾸고, 나머지 언어는 바탕 글자 모양의 글꼴을 그대로 둔다(font_ref_for_face는 선언된 언어만 돌려준다).긴 문서를 열고 저장하는 시간을 줄인다. 네임스페이스 정규화(
normalize_hwpml_namespaces)가 XML 파트마다 모든 태그와 속성을 파이썬 콜백으로 다시 훑었는데, 이제 2016 네임스페이스 URI가 든 태그만 찾아 고친다. 결과 바이트는 같다. 저장은 열기 안전 검사에서 패키지를 다시 읽으므로 함께 빨라진다.page.set_page_number(format_type=...)로 고른 쪽 번호 모양(로마 숫자, 원 숫자 등)이 한컴에서 늘 아라비아 숫자로 그려지던 것을 고친다. 한컴은 머리말·꼬리말의 쪽 번호를hp:autoNum으로 그리고 그 모양을 자식hp:autoNumFormat에서 읽는데, 모양은 옆의hp:pageNum@formatType에만 적혀 있었다. 이제hp:autoNum이 한컴처럼 모양을 가진다. “쪽/전체 쪽”(format="page/total")의 전체 쪽 번호도 같은 모양을 쓴다.표 셀에 넣은 차트(
shapes.add_chart(..., paragraph=셀 문단))가 셀보다 넓게 만들어져 한컴에서 셀 경계에서 잘리던 것을 고친다.size를 주지 않으면 기본 크기(32250×18750)를 넣을 곳(표 셀이나 본문)의 쓸 수 있는 폭에 맞게 같은 비율로 줄인다. 중첩 표의 기본 폭과 같은 기준이다. 본문의 기본 크기와size로 준 크기는 그대로다.tools.toc_author.add_native_toc()가 만든 차례 항목에서 쪽 번호가 제목 바로 뒤에 붙던 것을 고친다. 한컴은 탭을 문단의 탭 정지로 배치하고hp:tab속성은 그 결과의 캐시로만 쓰는데, 항목 문단(기본 문단 모양)에는 탭 정지가 없었다. 이제 항목 문단은 첫 구역 본문 오른쪽 끝(쪽 폭에서 왼쪽·오른쪽·제본 여백을 뺀 곳)에leader채움의 오른쪽 탭 정지를 가진다. 기본값 3은 한컴 차례와 같은 점선이다.leader는 탭 채움 코드 0–11만 받고, 그 밖의 값은paragraph-tab-leader-invalid로 거부한다.탭이 든 문단의 멀쩡한 줄 배치 캐시를 오래됐다고 보고 지우던 것을 고친다. 그래서 한컴 문서를 편집 없이 저장하기만 해도 쪽 경계에서 줄이 옮겨 갈 수 있었다. 캐시의 줄 시작 위치 (
hp:lineseg@textpos)는hp:t안의 인라인 요소도 센다. 탭은 8칸, 줄바꿈·하이픈·고정 빈칸은 1칸이다. 저장 때 캐시 정리와 편집 안전 검사의 “줄 시작이 글 길이를 넘는 캐시” 규칙이 이 길이 (oxml.utils.hancom_text_length)를 쓴다. 글을 넘어서 시작하는 캐시는 전처럼 지운다.문서에 이미 들어 있던 줄 배치 캐시가 문단 글을 다 담지 못하면(여러 줄 글에 한 줄 캐시) python-hwpx가 편집하지 않은 문서도 저장하지 못하던 것을 고친다. 편집 안전 검사는 이런 캐시를 거부하는데(한컴이 꼬리 글을 겹쳐 그린다), 저장 때 모든 구역에 도는 캐시 정리(
HwpxOxmlSection.remove_stale_layout_caches())는 글 길이를 넘는 줄 시작만 지웠다. 이제 그 검사가 거부할 캐시도 지운다. 한컴은 그 문단을 다시 배치한다.머리말·꼬리말 글(
page.set_header(text=...)·set_footer(text=...), 머리말·꼬리말 객체의text와add_run())과 각주·미주 글(notes.add_footnote()등, 주석 객체의text)이 탭을 지우던 것을 고친다. 이제 탭을hp:t안의hp:tab으로 쓴다 (page.set_header(text="학교명\t날짜")). 두text는hp:t안 요소 뒤의 글과 탭까지 읽는다. 머리말·꼬리말의set_simple_text_preserving()은 전처럼 탭을 받지 않는다.셀의
set_text()(Table.set_cell_text())와run.text = ...가 옛 글 일부를 남기던 것을 고친다. 한컴이 쓴 셀과 run에는hp:t안에 줄바꿈·탭·공백 요소와 형광펜 표시가 있고, 그 뒤에도 글이 있다. 두 설정자는hp:t의 앞 글만 바꿔서 요소와 그 뒤 옛 글이 새 값 뒤에 남았다(run.text는 새 값을 옛 글 뒤에 붙였다). 이제paragraph.text처럼 옛 글을 요소까지 모두 지우고 새 값을 쓴다.run.text는 첫hp:t자리에 쓴다.같은 두 설정자가 값의 탭을 지우던 것을 고친다. 이제 탭을
hp:t안의hp:tab으로 쓴다(split_paragraphs=True도 같다).탭 문자가 든 글을 쓴 문서를 한컴이 끝내 열지 못하던 것을 고친다.
paragraph.add_run("이름\t홍길동"),doc.text.replace(),fill_cells(),paragraph_patch(),apply_body_ops()의replace_text와 삽입 op는 탭을 문자 그대로hp:t에 넣었다. 한컴은 탭을hp:t안의hp:tab요소로만 읽고, 탭 문자가 있으면 문단 배치를 끝내지 못한다. 이제 모든 쓰기 경로가 탭을hp:tab요소로 쓴다. 메모리의 문서 트리는 그대로이고, 저장하는 XML만 바뀐다.라이브러리 안의 코드가 6.0에서 옮긴
HwpxDocument이름을 불러, 지금 API만 쓰는 사용자에게도DeprecationWarning이 나던 것을 고친다. 셀 맞춤(set_cell_text(fit=...), 메일 머지)의 글자·문단 모양 읽기와 글자 줄이기,lint_layout(required_fields=...), 변경 추적 점검(inspect_redline_structure), HWPX→Markdown 수집기가 이제 새 이름 (doc.fields.all,doc.tracking.*,doc.parts.headers,doc.text.markdown(rich=True))이나 문서 루트를 부른다.shapes.add_chart()가 계열 축이 없는 3D 차트(세 번째c:axId가0)를 축이 없다고 거부하던 것을 고친다.0은 축이 없다는 표시라, 이제 나머지 두 축 id만 정의돼 있으면 받아들인다. 한컴은 이런 차트를 축 id 두 개짜리와 같게 그린다.shapes.add_drop_cap(paragraph=...)과 문단의add_drop_cap()이 문단 첫 글자 장식을 문단 텍스트 뒤에 붙여, 한컴이 장식을 문단 마지막 줄에 그리던 것을 고친다. 이제 장식은 한컴처럼 문단 첫 글이 든 run 안, 그 글(hp:t) 바로 앞(앞선 컨트롤 뒤)에 들어가 첫 줄부터 그려진다. 구역 첫 문단의 구역 설정은 그대로 맨 앞에 남는다. 장식을 담은 run은 첫 글자의 글자 모양(char_pr_id_ref) 대신 문단 글의 글자 모양을 쓴다. 큰 글자 모양이 그 run에 있으면 한컴이 첫 줄을 그 크기로 잡아 글이 장식을 감싸지 못했다.shapes.add_polygon()과 그룹 멤버ContainerMember.polygon()이 만든 다각형이 한컴에서 마지막 변 없이 열린 선으로 그려지던 것을 고친다. 한컴은 첫 꼭짓점을 끝에 한 번 더 써서 다각형을 닫는다. 이제 두 API도 그렇게 쓴다. 열린 선이 필요하면closed=False를 넘긴다.문단 글에 넣은 탭이 한컴에서 사라지던 것을 고친다.
add_paragraph("이름\t홍길동")같은 탭을hp:t와 나란한 run 자식hp:tab으로 썼는데, 한컴은 이런 탭을 열 때 버려서 글이 붙고 탭 정지도 효과가 없었다. 이제 한컴처럼 탭을hp:t안에 쓴다(<hp:t>이름<hp:tab/>홍길동</hp:t>).shapes.add_line()로 그린 가로선과 세로선이 한컴에서 보이지 않던 것을 고친다. 선의 외접 상자(orgSz·curSz)에 0인 변이 있으면 한컴이 선을 그리지 않는다. 이제 한컴처럼 두 크기는 각 변을 최소 1로 쓰고(가로선은 폭 × 1),sz와 시작·끝점은 그대로 둔다.Shape.resize()도 같게 쓴다.add_picture(align="CENTER")(와"LEFT"·"RIGHT")로 넣은 그림이 한컴에서 늘 왼쪽에 놓이던 것을 고친다. 글자처럼 취급하는 그림은 문단 정렬을 따르는데,hp:pos@horzAlign만 바꾸고 그림 문단은 양쪽 정렬로 두었다. 이제 그림 문단의 정렬도 같은 값으로 맞춘다.hwpx.tools.read_fidelity.resolve_run_spans()(와 이를 쓰는 판독 표면)가 위·아래 첨자를offset부호만 보고 판정하던 것을 고친다. 부호가 거꾸로여서(음수가 위로 올린다, DEV-028) 예전 python-hwpx 위첨자를 아래첨자로 보고했고,hh:supscript/hh:subscript요소를 보지 않아 한컴 자신의 첨자(offset 0)와 지금ensure_run(script=...)이 만드는 첨자는 아예 첨자로 보지 않았다. 이제CharProperty.is_superscript()/is_subscript()처럼 요소로 판정한다. 요소 없이offset만 있는 글자는 한컴의 글자 위치(올림·내림) 설정이라 첨자로 보지 않는다.hwpx.tools.toc_author.add_native_toc(headings=...)로 제목을 직접 준 목차가 한컴에서 열 때 항목과 링크를 잃던 것을 고친다.dirty기본값이 늘True라, 한컴이 목차를 다시 만들면서 개요 문단만 모았다. 이제dirty의 기본값은 제목을 자동으로 찾을 때True,headings를 직접 줄 때False다. 직접 넘기면 그 값을 쓴다.page.setup(columns=N)과page.set_columns()가 섹션의 단 정의는 그대로 두고 섹션 끝에 빈 문단과 단 컨트롤을 덧붙여, 이미 있는 본문이 1단으로 남던 것을 고친다. 이제hp:secPr옆의 섹션 단 정의(hp:colPr)를 제자리에서 고쳐 섹션 전체가 N단이 된다. 구분선(separator_type등)도 이 정의에 들어가고, 빠진 값은 한컴 기본값(SOLID,0.12 mm,#000000)으로 채운다. 특정 문단부터 단을 바꾸려면page.set_columns(paragraph=...)를 쓴다.page.setup(columns=...)은 같은 폭의 단 N개와 간격만 쓴다. 있던 구분선은 지운다.page.set_columns는 1~255 밖의 단 수를page-columns-invalid로 거부한다.문단에 넣는 단 컨트롤도 한컴 표기대로
id=""와sameSz="1"/"0"을 쓴다.
용지 방향을 한컴 표기로 쓴다.
page.setup(orientation="PORTRAIT")는 스키마 밖 값landscape="PORTRAIT"를 써서 한컴이 가로로 그렸고,set_page_size(orientation= "LANDSCAPE")에 가로 치수를 주면 세로로 그려졌다. 이제 세로는WIDELY, 가로는NARROWLY이고, 치수는 두 방향 모두 용지의 세로 치수(너비 ≤ 높이)로 저장한다 (NARROWLY는 한컴이 돌려서 그린다).page.setup,page.set_size,section.properties.set_page_size가 모두 같다.WIDELY/NARROWLY를 직접 넘기면 한컴 뜻 그대로(WIDELY가 세로) 읽는다. 예전에는WIDELY를 가로로 읽었다.page.set_size는 모르는 방향 값을page-orientation-unsupported로 거부한다.landscape가 없으면page_size.orientation은 스키마 기본값NARROWLY를 돌려준다. 한컴도 그렇게 읽는다.새
PageSize.drawn_width/drawn_height는 한컴이 그리는 쪽 크기다. 표 기본 폭, 머리말·꼬리말 폭,template_analyzer의 쪽·본문 폭,layout_preview의 쪽 상자가 이 크기를 쓴다. 그래서NARROWLY와 세로 치수로 된 가로 문서도 가로 폭으로 계산한다.
styles.ensure_run(script="sup"/"sub")가 만든 위·아래 첨자가 한컴에서 두 번 줄어들던 것을 고친다.hh:supscript/hh:subscript요소와 함께relSz 67·offset -30/+30도 썼는데, 한컴은 요소만으로 글자를 줄이고 올리거나 내린다. 이제 한컴 자신의 첨자처럼 요소만 쓴다(relSz 100·offset 0). 예전 모양의 글자 모양은 다시 쓰지 않고, 기준 글자 모양으로 받으면 기본값으로 되돌린다.한컴이
hp:t안에 넣는 탭·줄 바꿈·특수 공백(<hp:t>성<hp:fwSpace/>명<hp:tab/>홍길동</hp:t>) 뒤의 글자를paragraph.text·run.text·doc.text.plain()·Markdown 내보내기· 표 이름표 찾기가 버리던 것을 고친다. 이들은hp:t의 첫 글자 묶음만 읽어 위 예에서 “성”만 돌려줬다. 이제 모두hwpx.tools.text_extractor와 같은 규칙으로 읽는다: 탭\t, 줄 바꿈\n, 줄 안 공백 U+00A0, 전각 공백 U+3000, 하이픈 U+00AD, 그 밖의 자식 요소는 제 글자와 뒤 글자(형광펜·변경 추적 표시는 빈 요소라 뒤 글자만). 텍스트 추출기도hp:t안의 탭을 버리던 것을 고친다(목차 항목의 점선 탭 뒤 쪽 번호가 붙어 나왔다). 변경 추적으로 삽입한 글(hp:insertBegin뒤 글자)도 이제paragraph.text와 평문에 나온다.doc.styles.ensure_run()이 만든 글자 모양(hh:charPr)의 자식 순서가 OWPML 스키마(CharShapeType)를 어기던 것을 고친다.bold·italic·underline·strikeout을outline·shadow뒤에 덧붙였고,bold를italic보다 먼저 썼다. 이제 서식을 적용한 뒤 자식을 스키마 순서(fontRef, ratio, spacing, relSz, offset, italic, bold, underline, strikeout, outline, shadow, emboss, engrave, supscript, subscript)로 맞춘다. 한컴이 쓰는 순서와 같다.doc.refs.add_hyperlink()로 만든 링크가 한컴에서 아무 데도 가지 않던 것을 고친다. 대상 주소를fieldBegin@name에만 썼는데, 한컴은 링크 대상을 필드 매개변수에서 읽는다. 한컴에서 다시 저장하면 링크는 남지만Category=HWPHYPERLINK_TYPE_HWP만 붙고Command가 없는(대상 없는) 문서 안 링크가 됐다. 이제 한컴이 쓰는 모양 그대로Command(: ? ; #백슬래시 이스케이프 +;1;0;0;, 메일;2;0;0, 책갈피?이름;0;0;0;)·Path·Category·TargetType·DocOpenType을 쓰고,fieldid는 한컴 하이퍼링크 컨트롤 id(627600491)로 둔다.#이름을 주면 그 책갈피로 가는 링크가 된다. 옛 판독기를 위해@name에도 주소를 그대로 둔다.링크 대상을 읽는 곳이 서로 달랐던 것을 맞춘다.
paragraph.hyperlinks와 Markdown 내보내기는@name만 읽어 한컴이 만든 링크의 주소가 빈 값이었고, 주석 달린 텍스트 추출은Command를 이스케이프와;1;0;0;꼬리가 붙은 채로 돌려줬다. 이제 셋 다Path→Command(꼬리·툴팁 제거, 이스케이프 풀기) →@name순으로 같은 값을 돌려준다.doc.page.set_page_number(format="page/total")이 “쪽/전체 쪽수” 대신 “쪽/쪽”을 그리던 것을 고친다. 두 번째 번호도 현재 쪽(numType="PAGE")으로 써서, 3쪽 문서가 1/1, 2/2, 3/3으로 나왔다. 이제 한컴 문서의 쪽/전체 머리말·꼬리말처럼/뒤에hp:autoNum numType="TOTAL_PAGE"를 쓰고(1/3, 2/3, 3/3), 쪽 번호 위치 컨트롤(hp:pageNum)은 한 번만 넣는다.hwpx.tools.toc_author.add_native_toc()를 기본값(at_index=0)으로 부르면 목차가 구역 설정(hp:secPr)을 가진 첫 문단 앞에 들어가, 한컴이 목차를 별도 구역으로 읽던 것을 고친다(목차 뒤에 쪽 나눔이 생겼다). 이제hp:secPr와 구역 처음부터 적용되는 조판 부호(단·머리말·꼬리말·쪽 번호)는 새 첫 문단의 맨 앞 run으로 옮겨 가고, 목차는 그대로 문서 맨 앞에 선다.doc.styles.apply_paragraph_format()·apply_list_format()처럼 문단 모양 (paraPrIDRef)을 바꾸는 편집이 그 문단의 줄배치 캐시(hp:linesegarray)를 남기던 것을 고친다. 한컴은 줄 높이를 이 캐시에서 가져오므로, 행간을 130%로 바꿔도 예전 160% 줄 높이로 그려졌다. 이제 문단 모양이 바뀐 문단의 캐시만 지우고, 글자 모양을 바꿀 때처럼 다른 문단의 캐시는 그대로 둔다.add_chart가 축(c:axId·c:catAx·c:valAx)이 필요한 차트 종류(막대·꺾은선· 영역·분산형·방사형·거품형, 3D·주식형·표면형 포함)에 축이 없으면HwpxValueError(shape-chart-axes-missing)로 거부하고 축을 넣는 방법을 안내한다. 한컴은 축 없는 막대 차트를 막대 없이 빈 차트로 그리고, 나머지 종류는 렌더하거나 저장하다 멈췄다. 같은 차트에 축만 넣으면 정상이었다. 축이 없는 원형·도넛 차트는 전처럼 받는다.암호가 걸린 HWPX를 열면
Start tag expected, '<' not found같은 파일 손상처럼 보이는 lxml 오류만 나오던 것을 고친다.META-INF/manifest.xml이 파트를encryption-data로 암호화 선언한 경우 예외 타입(XMLSyntaxError)은 그대로 두고 메시지가 문서 암호 해제 후 재저장을 안내하며, 원래 lxml 오류는__cause__로 남는다(HWP v5 안내와 같은 방식). 계기: HWPX 1,395건(실업무 문서· 공개 픽스처·저작 산출) 열기 기준선에서 유일하게 열리지 않던 파일이 한컴오피스 한글 13.0.0.711이 저장한 암호 문서였다.쪽 종류가 다른 머리말·꼬리말을 함께 쓰면 한컴에서 일부가 사라지던 문제를 고친다. 머리말·꼬리말을 설정하면 한컴이 읽는
hp:ctrl사본을 같은 쪽 종류만 바꾸도록 했다. 예전에는 그 태그의 사본을 모두 지웠다. 그래서 홀수 쪽 꼬리말 뒤에set_page_number(양쪽 꼬리말)를 부르면 홀수 쪽 글자가 한컴에서 사라졌다. python-hwpx만 읽는hp:secPr사본에는 글자가 남아 있었다. 또BOTH사본을ODD·EVEN보다 앞에 둔다. 한컴은 쪽마다 문서 순서상 마지막으로 해당하는 컨트롤을 그려서, 양쪽 꼬리말이 뒤에 있으면 홀수 쪽 꼬리말은 한 번도 그려지지 않았다.remove_header·remove_footer도 이제 지정한 쪽 종류의 사본만 지운다.메모 필드가 한컴에서 저장된 뒤 범위 끝과 작성 시각을 잃던 문제를 고친다.
attach_memo_field는 MEMOfieldBegin에 메모마다 양의zorder를 주고,CreateDateTime을 한컴과 같은 UTC ISO 8601(2024-12-02T09:00:00Z)로 쓴다. 시간대 없는 값은 로컬 시각으로 보고 UTC로 바꾼다. 한컴에서는zorder가 없거나-1이면 저장 때fieldEnd가 빠졌고,2024-12-02 09:00:00형식은 열 때 1601년 값으로 바뀌었다. 매개변수 개수 속성도 다른 필드처럼 한컴 표기cnt로 쓴다(한컴은 저장하며count를cnt로 바꿔 썼다).insert_document(..., after_paragraph_index=-1)는 대상 절의hp:secPr을 둘째 이후 문단에 남겼다. 한컴은 이를 새 절의 시작으로 읽어, 끼운 문단을 기본 쪽 설정의 별도 절로 열고 쪽을 넘겼다. 이제 절 설정(hp:secPr,hp:ctrl/hp:colPr)을 새 첫 문단으로 옮기고, 병합 보고서에sectionPropertiesRelocated를 남긴다.문서 병합은 여러 문단에 걸친 필드(한컴 양식의 누름틀 등)의
fieldEnd를 옛 id에 남겨 짝을 끊었다. 이런 병합 결과는 한컴이 열지 못하거나 저장할 때fieldEnd를 버렸다. 이제 id 대응을 복사한 문단 전체에서 맞추고,fieldEnd의fieldid는 자기fieldBegin을 따른다.
[6.5.0] - 2026-09-21
기존 문서 편집과 저작 표의 보존 범위를 넓힌 릴리스입니다. 저장 성공만으로 시각 품질을 보증하지 않으며, 과거 셀 채움 페이지 흐름 사례 두 건의 글자 가림은 이번 버전에도 남아 있습니다.
추가
표 높이와 텍스트 흐름 설정을 공개해 긴 저작 표가 다음 페이지로 이어지도록 한다.
혼합 run·필드·여러 story의 요청 범위를 보존하면서 편집한다.
고침
EqEdit의 공식
TRIANGLE토큰과 실문서에서 관측된 소문자triangle토큰을\triangle로 변환한다. 미리보기 MathML에서도 삼각형을 식별자 문자열이 아닌 수학 연산자 기호로 보존하며, 혼합 대소문자나 더 긴 식별자는 해석하지 않는다. 따옴표 리터럴(\text{...}) 안의\triangle은 그대로 문자로 남기고, 저작 방향(latex_to_eqedit)은 실한컴 검증 전까지 문서화된 대문자TRIANGLE만 낸다. (@kilomanyo, #93)
[6.4.0] - 2026-09-09
기존 문서 편집 보존 트레인. 구조 검증은 한컴 화면의 잘림·겹침·페이지 수 보존을 뜻하지 않는다.
고침
네이티브 머리글/바닥글과 빈 필드, 복제 행 문단 ID, XML 네임스페이스 정규화, 상속 셀 여백을 보존하도록 수정했다.
표 라벨 탐색에서 병합 셀을 물리 셀 하나로 계산하고, 방향 이동이 병합 영역을 건너뛰도록 수정했다. 실제로 다른 셀에 반복된 라벨은 계속 모호한 대상으로 처리한다.
주요 사용 문서와 AI 참조 문서를 현재 네임스페이스 API에 맞췄다. 저장 성공, 요청한 내용의 반영, 화면 검증의 의미를 구분한다.
바꿈
ChatGPT 안내를 wheel 업로드 경로로 교체 — ChatGPT 채팅의 파이썬 환경은 PyPI 접근이 막혀
pip install python-hwpx프롬프트가 더 이상 동작하지 않는다. README(한/영)의 따라 하기 프롬프트와 “어디서 쓰나” 표를 GitHub Release에 첨부된py3-none-anywheel을 문서와 함께 올려 오프라인 설치하는 경로로 바꾸고,docs/ai-assistants.md(사람용 3단계·에이전트용 지시문·lxml 의존성·최소 예제)를 신설했다.docs/installation.md에 wheel 설치 절을,llms.txt에 PyPI 없는 샌드박스의 설치 문장을 추가했다. Release 자산 첨부는 기존release.yml이 이미 수행하므로 CI 변경은 없다.에이전트 학습 표면을 6.0 API로 현행화 —
llms.txt와 llms-full 원천 (quickstart·recipes-traversal·mutation-semantics)이 6.0에서 이동돼DeprecationWarning을 내고 7.0에서 제거되는 5.x 평면 이름 (replace_text_in_runs·iter_runs·add_memo_with_anchor·add_footnote·remove_paragraph·list_form_fields·add_form_field·fill_form_field·add_equation·find_runs_by_style·memos·memo_shapes)을 안내하고 있었다.doc.text/doc.notes/doc.fields/doc.shapes네임스페이스와paragraph.remove()로 바꾸고,add_heading을 python-docx 습관으로 오기한 문장을 정정했다. 문서 예제 원장과 게이트 해시를 갱신했다(블록 수 117 불변). 동봉 계약 문서(src/hwpx/data/contract_docs/)도 같이 재동기화했다.
더함
Shape.set_position과Table.set_cell_borders를 안정 API에 추가했다. 기존 개체 속성·셀 배경·테두리 굵기를 보존하며 모호한 구조를 거부한다.기존 양식을 임시 파일에 편집한 뒤 재개봉·내용 확인 후 출력하는
examples/edit_existing_form.py와 외부 문서 편집 회귀 검증. 기존 값 사전조건으로 잘못된 대상이나 변경된 양식을 거부할 수 있다.wheel을 GitHub Actions artifact로도 유지 — ChatGPT의 GitHub 커넥터가 Release 자산 바이너리는 못 받고 Actions artifact는 받을 수 있는 것으로 확인되어, 릴리스 워크플로가 wheel과
SHA256SUMS를 artifactpython-hwpx-wheel로 올리고, 신설wheel-artifact.yml이 매달·릴리스마다 최신 Release의 wheel을 해시 검증 후 같은 이름으로 다시 올린다(artifact 90일 만료 대응). 빌드하지 않고 발행된 bytes만 재게시하며, 채팅 런타임까지의 전 과정 실측은 아직이라 안내에 실험 경로로 표시했다.
[6.3.0] - 2026-08-19
더함
왕복 충실도 공개 지표 (
docs/corpus-metrics.md신규 절 +docs/roundtrip/영수증) — 실한컴 저장본 76건(provenance 심사, 정직 제외 3건) 무편집 재직렬화에서 실질 구조 변화 0(byte-identical 22 · zip-container-only 54), 실한컴(Mac 12.30.0 build 6446) 재개봉 판정 가능 73/73 무손상, 음성 대조 2/2 정상 거부. 분모 루트를tests/datagold pair·패키지 동봉 Skeleton까지 확장 (scripts/roundtrip_fidelity.py). 상주 회귀tests/test_roundtrip_fidelity_corpus.py가 “substantive 0”을 매 스위트 게이트로 강제한다.stale lineseg 꼬리 커버리지 판정 — 기존 범위 검사(textpos>len)가 못 보던 방향(편집으로 문단이 캐시 줄 수 너머로 자란 경우 = 변경추적 겹침 렌더의 실물 방향)을 layout lint/패키지 검증기가 검출한다. 꼬리 폭을 overflow lint와 같은 보수 추정으로 재고 줄 폭 2배 초과만 error(실한컴 저장본 76건 캘리브레이션 오검출 0). 실한컴 렌더 겹침 재검은 opt-in 스모크
tests/test_tracked_overlap_render_smoke.py(HWPX_MAC_ORACLE_SMOKE=1).reorder_rows표 구조 op (apply_table_ops) — 물리 행 재배열(완전 순열rowAddr 재기입). 편집기 [표>정렬…] 역매핑 갭의 엔진 프리미티브. 수직 병합(rowSpan>1) 표는 typed refuse(바이트 무변경). 정렬 키 비교는 호출자 몫.
고침
instid 속성명 카멜케이스 불일치 (#88) — 스키마·실한컴 산출물의 정본은 소문자
instid(픽스처 전수 744 vs 0)인데 코드 6곳이instId를 읽거나 썼다. 문단 복제 시 인스턴스 ID 재발급 분기가 영원히 안 타던 사문 수리(중복 instid 복제 해소), 각주/미주 저작이 스키마에 없는 속성명을 방출하던 것을 정본으로 교정, 리더 4곳은instid우선 + 과거 자사 산출물(instId) 폴백. JSON 투영 키(instId)는 출력 계약이라 불변.hp:audio인라인 분류 정리 (#89) — 실한컴(Windows 한글 2024)의 소리 삽입 실물은hp:ole(EMBEDDED/ICON)이고hp:audio는 생성되지 않으며 실코퍼스 표본 0건. 빈도 0 요소는 읽기측 불투명 보존만 한다는 원칙에 따라INLINE_OBJECT_NAMES에서 제외(GenericElement 보존, 무손실 불변).
[6.2.1] - 2026-08-19
고침
v6.2.0은 보존된 실패 태그입니다 — 워크스페이스 편의용
work심볼릭 링크(정본 체크아웃의work/를 가리키는 상대 링크)가 릴리스 트레인에 추적돼 들어갔고, CI 러너의 경로 구조에서는 그 상대 경로가 자기 자신을 가리키는 순환 링크가 되어test_emit_loss_inventory가OSError: Too many levels of symbolic links로 실패했다(1 failed/3107 — prepublish 게이트가 발행을 정상 차단)..gitignore의work/패턴은 디렉터리만 매칭해 링크 파일을 못 막던 것이 근본 원인 — 링크를 언트랙하고 패턴에work(슬래시 없음)를 보강했다. 태그는 불변 원칙대로 보존한다(v2.29.0 전례). 6.2.1은 그 외 6.2.0과 동일하다.
[6.2.0] - 2026-08-19 (보존된 실패 태그 — PyPI 미발행)
더함
HwpxOxmlParagraph.add_index_mark(first, second=)— 색인 표시 (hp:indexmark) 저작. 실한컴 GUI 프로브 gold 2건 역설계.add_title_mark와 타겟팅 계약은 같으나(호출자가 대상 문단을 직접 지정 = 편집기의 캐럿 문단) 배치가 다르다 — titleMark는hp:t안, indexmark는 같은 run 안의hp:ctrl형제로 텍스트 앞. 스키마는firstKey/secondKey를 둘 다 필수 시퀀스로 선언하지만 실물은 1단계 색인에서secondKey를 생략하므로 실측을 따랐다(add_new_num의autoNumFormat생략과 같은 부류).HwpxOxmlParagraph.add_mail_merge_field(name, cached_text=)— 메일머지 표시 필드(hp:fieldBegin type="MAILMERGE") 저작. 기존hwpx.tools.mail_merge.merge_template_rows가 기존 텍스트를 치환하는 Edit인 것과 달리 필드 컨트롤 자체를 만드는 Create다. 파라미터 이름Fiexde는 실물·한컴 공식 문서 공통의 오타 철자라 그대로 쓴다. 캐시 텍스트 기본값{{이름}}은 그 배치 생성기가 인식하는 플레이스홀더 문법이라 이 필드로 저작한 템플릿이 곧바로 물린다.doc.parts.set_license_mark(...)/.remove_license_mark()— 문서 수준 라이선스 레코드(hh:licensemark) 저작. “입력 > CCL 넣기…”가 남기는 그 레코드이며, 눈에 보이는 배지는 별개(라이선스 증서 URL을href로 단 그림).openrate v22 (
docs/openrate/report-v22.json) — 위 세 표면의 실한컴 렌더 배치: 3 스트라텀 × 5건, macOS Hancom GUI 오라클 15/15 render_checked·0 failed, 음성 대조 3/3 정상 거부. 각 스트라텀에 관측 밖 경계 프로브 1건씩(한 문단 색인 표식 2개·한글 필드명·미관측 라이선스 type 문자열"KOGL")을 일부러 실었고 전부 수용됐다 — 실한컴의 수용 경계가 관측 분포보다 넓다는 기존 v10/v11 관찰의 재확인. 원장은hp:indexmark/hp:firstKey/hp:secondKey/hh:licensemark를by-openrate-corpus로 승격했고,hp:fieldBegin은 공유 저수준 요소 원칙(누름틀 v15 전례)대로 매트릭스 산문 근거만 갱신했다.
고침
LicenseMark.type이int→str— 스키마(Header XML schema.xml의DocOptionType)가xs:unsignedInt use="required"로 선언해 그대로 믿었으나 실한컴이 실제로 쓰는 값은 문자열"CCL"이다. 그래서 실한컴이 만든 CCL 문서를to_model()로 읽으면ValueError: Invalid integer value: 'CCL'로 터졌다 — 위 저작 표면을 열면서 실측으로 드러났다.flag/lang은 관측값이 정수라 그대로다.
[6.1.0] - 2026-08-15
15개 작업 사이클(6.1~6.15)을 하나의 트레인으로 묶어 발행한다. 완전성 감사 (2026-08-04)가 지목한 갭을 순서대로 닫아나가면서, 그 과정에서 두 개의 새 계측기(편집기 표면 인벤토리·편집기 메뉴 역방향 지도)를 만들어 남은 갭을 스스로 찾아내는 체제로 전환했다. 저작 표면 하나하나는 실코퍼스 리버스가 먼저이고, 실한컴 오라클(Windows COM 또는 macOS GUI) 렌더 검증이 뒤따르는 원칙을 전 트레인에서 유지했다 — 아래 각 항목은 그 순서를 따라 서술한다. 이 트레인은 이 브랜치가 갈라져 나온 뒤 별도로 발행된 6.0.3의 보안 수정 (GHSA-8g8m-xpm4-wxvx, 아래 [6.0.3] 항목)을 그대로 포함한다 — 병합으로 합류했을 뿐 내용은 손대지 않았다.
더함
doc.styles.ensure_font— 폰트 선언·치환 저작. 완전성 감사가 지목한 최대 갭(#1): 모든 실문서가hh:fontfaces를 갖는데도 이제까지 그 블록은 frozen 스켈레톤 출력이었다. 언어 블록 7종을 기본 등록하고ensure_style과 같은 dedupe 관용구를 따르며,substFont는 실코퍼스 그대로 — 임베딩이 아니면binaryItemIDRef속성 자체를 쓰지 않고(1682/1682 관측)substFont값은 항상 빈 문자열(284/284),isEmbedded는 “0”/”1” 스펠링 (6741 관측).fontfaceid 번호가 언어 블록마다 독립적으로 매겨진다는 실측도 고정했다.탭 정지 저작·읽기 —
apply_paragraph_format(tab_stops=...). 감사 갭 #2. 스키마는tabPr당tabItem최대 1개를 암시하지만 실 정부 문서는 위치정렬 최대 4개를 한tabPr에 담는다 — 코퍼스가 스키마를 이겼고 저작은 문서를 따른다. auto-tab 불리언도 같은 “0”/”1” 스펠링.layoutCompatibility·compatibleDocument·settings.xml읽기 표면 — 감사의 R1 반박(모든 실문서에 있는데도 코드가 전혀 못 읽던hh: layoutCompatibility)을 닫는다.settings.xml은 벤더드 스키마 어디에도 선언이 없어 177개 실문서로 구조를 역설계했고(config:config-item어휘는 OASIS ODF 1.0을 그대로 재사용),layoutCompatibility는 스키마가 48개 플래그를 선언하지만 실문서 전부 비어 있어 관찰된 자식 이름 집합만 보존한다. 의도적으로 읽기 전용 — 쓰기 API가 없으므로 OPC 계층의 무손실 바이트 보존이 그대로 적용된다(3개 실픽스처로 확인).도형 텍스트(draw-text)·개체 캡션 — 감사 갭 #3·#4.
.draw_text/.set_draw_text(rect·ellipse 호스트, 스키마가 도형 개체로만 제한)와 표·그림·도형이 공유하는.caption/.set_caption/.remove_caption. 실코퍼스는 스키마와 반대로shadow가drawText보다 먼저 오고, 캡션 배치는 호스트에 관계없이 “outMargin 다음”으로 일관됐다.하이라이트(형광펜) —
doc.text.highlight/.highlights.markpenBegin/End를 LIFO로 페어링해hp:t내부에 삽입한다. 벤더드 코퍼스의 유일한 실 예시가 스키마상 잘못된 위치(hwpxlib 오류-회귀 사례)이므로 그 기형 원본은 “읽기-비어있음”으로 그대로 두고 신규 저작 경로만 정상 계약으로 검증했다.이미지·그라디언트 채우기 —
ensure_border_fill이 스키마의fillBrush선택지(winBrush/gradation/imgBrush) 전부를 커버하게 됐다.fill_image=(doc.media경유, 실측 전량TOTAL모드)·fill_gradient=(LINEAR기본, alpha “0” 관측)가fill_color=와 상호배타 옵션으로 합류했고, 표 셀 배경set_cell_fill_image/set_cell_fill_gradient까지 실제 소비 경로가 이어진다.메모 도형 저작 —
ensure_memo_shape.hh:memoPr을 find-or-create dedupe로 등록한다. 실코퍼스 다수 기본값(폭 15591·SOLID·공유 3색 프로필)을 따르고, id는 1부터 시작(borderFill의 0과 다름),memoType은 “NOMAL” 스펠링을 스키마·실문서 그대로 유지한다.페이지 번호 재시작·페이지별 요소 숨기기 —
restart_page_number(hp:newNum)·hide_page_elements(hp:pageHiding).newNum은 스키마가 요구하는autoNumFormat자식 없이 자기닫힘으로 실코퍼스 그대로 방출한다(편차 등재).위·아래 첨자 실요소, 양각·음각, 외곽선 —
ensure_run확장. hwpxlib 실코퍼스(오류 문서 charPr id=513)에서 실한컴이 위첨자를relSz/offset수치가 아니라hh:supscript플래그 요소만으로 판정함을 확인해, 기존 offset 부호 계약(실한컴 렌더 검증으로 이미 확정됨)은 그대로 두고 실요소를 병행 방출한다. emboss·engrave·outline은 스키마 근거로 추가.필드 매개변수 일반 모델(
ParameterList)·타입 있는 콤보박스listItem—hp:parameters(필드 클릭 액션)와hp:parameterset(도형 확장 속성)가 스키마상 같은 재사용 타입임을 실코퍼스로 확인하고 범용 파서·직렬화기로 승격했다(불리언·정수·실수·문자열·리스트 매개변수 재귀 포함). 처음엔 읽기 모델만 있고 실제 문서 dispatch에 연결이 안 돼 있던 진짜 갭이었음이 이후 사이클에서 드러나 바로 이어붙였다(아래 고침 참조).hp:compose(글자 겹치기·원문자)·재귀InlineObject승격 —ComposedCharacter가GenericElement대신 타입 있는 필드로 노출된다. 실코퍼스로 위치가 스키마와 다름을 확정했고(hp:t자식이 아니라hp:run직속), 컨테이너 등 내부에 중첩된 도형도 재귀 깊이와 무관하게InlineObject로 인식되도록 확장했다.doc.shapes.add_polygon— 다각형 저작. 실코퍼스(hwpxlib_corpus/ reader_writer__SimplePolygon.hwpx) 리버스: 꼭짓점은hc:pt(core 네임스페이스, rect·ellipse와 같은 기하 네임스페이스 계약)이고 자기 bbox 좌상단 원점 로컬 좌표계에 산다(정점 목록이 그 자기orgSz와 정확히 일치, 실측) —points_mm로 받은 페이지-스페이스 좌표를 그 로컬 좌표계로 평행이동한다. 기존resize()는 이미 범용(pt로컬명 스캔)이라 변경 없이 다각형에도 적용된다. curve(hp:curve/hp:seg)는 정직 보류: 유일한 실 예시에서 곡선의orgSz가 앵커점 bbox보다 뚜렷이 크다(스플라인이 앵커점 밖으로 부풀어 오르는 실측) — 한컴의 정확한 곡선 적합 알고리즘 근거 없이 bbox를 추정하면 침묵 오류가 되므로 미룬다.doc.shapes.add_arc— 사분원(호) 저작. 실코퍼스(hwpxlib_corpus/ reader_writer__SimpleArc.hwpx) 리버스: 스키마상hp:arc는 좌표 3점 (center/ax1/ax2)뿐 각도 필드가 없다. 유일한 실 예시는center가 자기 bbox 모서리에 앉고ax1이 바로 아래,ax2가 바로 오른쪽인 사분원 하나뿐이라 그 배치만 점 단위로 검증됐고, 나머지 세 모서리는 다른 도형이 이미 쓰는hp:flip미러링으로 얻는다(corner인자 —TOP_LEFT만 실측, 나머지 3개는 유도).arc_type(NORMAL/PIE/CHORD)은 스키마 열거값 그대로 통과한다. connectLine은 정직 보류: 유일한 정본 예시(SimpleConnectLine. hwpx)는 자유선이 아니라subjectIDRef로 다른 두 도형을 잇는 “스마트 연결선”이고,offset이 음수·curSz≠orgSz·scaMatrix가 평행이동까지 얹은 비항등 행렬이라 관계식을 재현할 근거가 없다.파트 계층 읽기 모델 —
version.xml(HcfVersion)·masterpage.xml(MasterPage)·history.xml(History) 읽기 승격(감사 갭 #15).settings.xml관용구 그대로:doc.parts.*가 돌려주는HwpxOxml {Version,MasterPage,History}에.to_model()추가. 실 산출물 47/47(version)·다수(masterpage, 서로 다른 두 문서 계열 110건) 전수가 벤더드 2024 초안 스키마와 루트 이름·네임스페이스가 다르다는 걸 재확인했다(스키마가 아니라 실코퍼스가 진실 원천 —version.xml루트는hv:HCFVersion이고 오탈자tagetApplication을 그대로 쓴다,masterpage.xml루트masterPage는 네임스페이스가 없다).history.xml은 실 예시가 하나도 없어(코퍼스+개인 실문서 6,262건 전수) 스키마 전용으로 표기 — 평평한 리비전 메타데이터만 타입 있는 필드로 옮기고, 재귀 중첩되는 diff 본문은DiffNode로 원문 구조 그대로 보존한다.그룹 개체(컨테이너) 저작 —
doc.shapes.add_container. 실코퍼스 74개 컨테이너(벤더드 3개 + 오류-회귀 픽스처 71개) 리버스: 멤버는 독립 도형과 동일한 offset/orgSz/curSz/flip/renderingInfo 계약을 갖되AbstractShapeObjectType꼬리(sz/pos/outMargin/shapeComment)를 그룹이 대신 갖고groupLevel="1"이 된다. 컨테이너 자신의orgSz는 멤버들의 합집합 bbox. 알려진 한계도 그대로 문서화했다:resize()가 컨테이너 자신의 크기만 갱신하고 멤버 좌표는 안 건드린다.특수 인라인 텍스트 원자(줄바꿈·전각공백·고정폭공백) —
add_run(expand_special_characters=True). 세 마커 모두hp:t내부 혼합 콘텐츠로 중첩되는 실코퍼스 관용구를 그대로 재현한다(스키마가 허용하는hp:run형제 배치는 실사용 0건). 저작과 별개로 읽기 쪽 실버그도 같은 트레인에서 발견·수리했다(아래 고침 참조).hp:switch/case/default읽기 모델 — 스키마 선언이 전혀 없는데도 실코퍼스 236/237이 쓰는 버전-호환 래퍼.paraPr의margin/lineSpacing이 이 래퍼 안에 있으면None으로 읽히던 실버그를hp:case-우선/hp:default- 폴백 읽기로 수리했다(아래 고침 참조).tabPr쪽은 두 분기가 서로 다른 값(정확히 2배 관계)을 가져 정반대로hp:default를 우선해야 한다는 것도 별도로 확정했다.저수준 도형·컨트롤 이스케이프 해치의 정직한 검증 신호 —
add_shape/add_control로 필수 자식이 빠진 도형이나 빈hp:ctrl을 만들면 실한컴이 열지 못하는데도validate_package/validate_editor_open_safety둘 다 통과시키던 갭. 경고 레벨 신호를 추가했다(오류로 만들지 않음 — 여러 호출에 걸친 점진적 조립이라는 이 이스케이프 해치의 문서화된 사용법을 깨지 않기 위해서다). 컨테이너 멤버는 이 5개 자식이 없는 게 정상이라 스캔에서 제외한다.문서 옵션·호환성 설정 저작 —
hh:compatibleDocument/@targetProgram(실측 47/47 “HWP201X” 고정)·layoutCompatibility플래그·hh:docOption/ linkinfo·hh:paraPr/autoSpacing까지 쓰기 경로를 열었다. 모든 불리언은 “0”/”1” 관용구(다른 OWPML 불리언 계열과 동일).hp:label(양식 라벨·명패) 읽기+쓰기 — 개인 실문서(학교 행정서식) 75건 리버스: 항상hp:tbl의 마지막 자식, 스키마 11개 속성 전부 사용, 실측은 정확히 2가지 조합(2×9 소형 라벨시트 325건/1×2 대형 명패 111건)으로 수렴하지만 저작은 그 두 조합에 값을 제한하지 않는다(실증 없는 값을 기계적으로 금지하지 않는다는 원칙).문서 삽입·병합(
append_document/insert_document) — 다른 HWPX 문서의 본문을 열린 문서에 복사하면서 헤더 소유 공유 자원(charPr/paraPr/ style/borderFill/tabPr/numbering/bullet/memoPr/fontfaces)마다 새 대상 id로 재매핑해, 대상이 이미 그 번호에 갖고 있던 값에 조용히 앨리어싱되지 않도록 한다. v2에서 실측된 한컴 자신의 “문서 끼워 넣기” 4축 정책(글자 모양·스타일·문단 모양·쪽 모양 유지)을 named parameter로 노출한다 (기본값=v1의 이미 실한컴 검증된 동작, 비기본값은 타입 오류로 거부) — KeepStyle 축이 동일-이름 스타일 충돌 해소 규칙임을, KeepSection 축이 별도 섹션 파트 생성 여부임을 실 골드 2라운드로 확정했다. MEMO 병합 지원도 추가됐다(hp:memogroup이 문단이 아니라 섹션의 형제임을 확인 후). 이 저작 표면을 만드는 과정에서 여러 실결함을 발견해 고쳤다(아래 고침 참조).덧말·글자 겹치기(
add_dutmal/add_composed_character) 정식 완결 — 구현 자체는 앞서 들어와 있었고, 이번에 capability 영역 등록·편차 등재· 정식 테스트로 마무리했다.문서정보(document metadata) —
doc.parts.set_document_metadata/document_metadata(). 실문서 67픽스처 전수 조사: title/creator/subject/ keyword/lastsaveby는 요소는 있지만 대개 비어 있고,CreatedDate/ModifiedDate는 65/65 단일 ISO-8601 포맷(저작 대상)인 반면 자유형식date필드는 한컴 버전·로캘에 따라 5가지 이상 서로 다른 포맷이 관측돼 정직하게 저작을 보류한다(불투명 문자열 보존만, curve·connectLine과 같은 원칙).드롭캡 —
doc.shapes.add_drop_cap.dropcapstyle이hh:paraPr이 아니라AbstractShapeObjectType(모든 임베드 가능 도형의 공유 속성)에 있다는 걸 스키마 대조로 발견했다. 67개 픽스처 중 유일한 실사용 예시 (TripleLine)를 구조까지 리버스했고(투명hp:rect가 확대 글자를 감싼drawText/subList,horzRelTo=PARA/flowWithText=1,curSz가 항상 0/0인 센티널), DoubleLine·Margin은 표본이 없어 타입 오류로 거부한다.글자 방향(세로쓰기) —
doc.page.text_direction/set_text_direction.hp:secPr의textDirection(HORIZONTAL/VERTICAL/VERTICALALL)·textVerticalWidthHead를 노출한다. 67픽스처 74개secPr전부 HORIZONTAL이라 VERTICAL 계열은 실사용 전례가 없지만, 이 프로젝트 최초로 VERTICAL/VERTICALALL을 실제로 실한컴 렌더 검증까지 통과시켰다.단 나누기 —
apply_paragraph_format(column_break=...).hp:p자신의columnBreak속성으로, 기존page_break_before(hh:breakSetting이라는 공유 스타일 속성)와는 메커니즘이 다른 별개의 문단-인스턴스 속성임을 확인한 뒤 저작했다(실 73건pageBreak="1"계열로 동일 어휘 계약 확인).표 나누기·붙이기 —
apply_table_ops의split_table·merge_table. 전용 OWPML 어휘가 없어hp:tr/hp:tc/cellAddr/cellSpan순수 구조 편집으로 구현했고, 병합 셀이 분할 경계를 가로지르면 실패 폐쇄로 거부한다. 표 뒤집기는 정의가 불가능하다는 판단으로(병합 셀이 있을 때 어느 쪽이 내용을 갖는지 정할 근거가 스키마·코퍼스 어디에도 없음) 정직 보류한다.셀 균등화(행 높이·열 너비) —
equalize_column_widths()/equalize_row_heights(). 이미 있던set_column_widths/셀별set_size를 “균등화”라는 이름 있는 연산으로 노출했다. 병합 셀은 자신이 걸친 행·열의 합을 받는다.개요 번호매기기 —
ensure_numbering/apply_list_format의 세 번째 kind,"outline".hh:heading type="OUTLINE"이 리스트 서식과 같은hh:numbering/hh:paraHeadid-공간을 공유한다는 사실을 활용해 커스텀 번호 형식·시작값을 지정할 수 있게 했다.바탕쪽(master page) 쓰기 경로 —
doc.parts.add_master_page+doc.page.set_master_page/.master_page_refs. 유일한 실 샘플에서 파트 파일명·매니페스트opf:itemid·masterPage루트 자신의 id·섹션의hp:masterPage/@idRef가 모두 같은 문자열(“masterpageN”)을 공유함을 직접 확인해 재현했다. 마스터 페이지는opf:item은 받지만 spineitemref는 받지 않는다(읽기-순서 파트가 아니므로).날짜·교정 부호 필드 —
add_date_field(type="DATE")·add_proofreading_mark(type="PROOFREADING_MARKS_SIGN")(DEV-043). 실한컴 macOS GUI 프로브 골드(date_and_proofreading_mark.hwpx) 리버스. 스키마는PROOFREADING_MARKS를 선언하지만 실측은 열거형에 아예 없는 값PROOFREADING_MARKS_SIGN이다.PATH 필드 —
add_path_field(type="PATH"). GUI 프로브 없이 기존 실코퍼스 샘플(파일 이름 필드,Command=Format="$F")만으로 계약을 확보했다. 이 저작을 붙이며fieldEnd의@fieldid갱신 누락이라는 실결함을 함께 발견해 DATE·교정 부호·PATH 세 필드 전부 소급 수리했다 (아래 고침 참조).titleMark(차례 숨기기·제목 차례 표시) —
add_title_mark(*, in_toc: bool)(DEV-044). macOS GUI 자동화로는 캐럿을 임의 문단에 놓을 수 없어 한 사이클 넘게 저작이 보류돼 있었는데, Windows 박스 COMSetPos3- variant 프로브로 캐럿-문단 타겟팅 규칙이 확정되며 열렸다.in_toc=True→ignore="1",False→ignore="0"(이름의 직관과 반대인 극성을 macOS GUI·Windows COM 양쪽에서 독립적으로 확인). 필드 래퍼가 전혀 없는 유일한 마커 계열이라(DATE/교정 부호/PATH의ctrl/fieldBegin메커니즘과 다름) 새 run을 만들지 않고 기존 run의 첫hp:t안에 바로 삽입한다.
고침
문서 병합의
linkListIDRef과잉 거부 + 저장 경로 무결성 훼손 —hp:subList가 관용적으로 갖는 센티널 값(“0”, 벤더드 코퍼스 5,891/5,891) 을 실제 연결된 텍스트박스 체인으로 오판해, 표를 가진 모든 문서(이 라이브러리 자신이 생성한 문서 포함)를 병합 불가로 만들던 결함. 더 심각한 두 번째 결함이 같은 트레인에서 함께 드러났다: 병합이 대상 헤더 트리를 직접 변형하면서도target_header.mark_dirty()를 호출하지 않아, 그림이 껴 있지 않은 모든 병합이 메모리상 참조 무결성 검사는 통과하면서 실제로는 손상된 파일을 저장하고 있었다(재오픈 전까지 안 보임). 세 번째:hp:secPr제거 로직이 같은 run에 얹혀 있던 표·텍스트 까지 통째로 삭제하던 결함(빈 문서 스켈레톤으로만 테스트돼 있었다).문서 병합의
fieldEnd/@fieldid미갱신 —hp:fieldBegin·hp:fieldEnd둘 다 생성 시 같은fieldid를 갖지만, 병합 리프레시가fieldBegin쪽 id/fieldid와fieldEnd의beginIDRef만 재발급하고fieldEnd자신의fieldid는 건드리지 않아 원본uuid4값이 복사된 콘텐츠에 그대로 남아있던 결함. DATE·교정 부호·PATH 필드 저작에도 같은 결함이 있어 함께 소급 수리했다.문서 병합의 속성-클론 중첩 참조 앨리어싱 —
hh:paraPr내부 테두리의borderFillIDRef/tabPrIDRef,hh:charPr의 글자-테두리borderFillIDRef가 본문이 아니라 방금 복사된 헤더 항목 안에 살아있어 임포트 스캔에 안 잡히던 결함(참조가 매달린 상태가 아니라서 참조 무결성 검사도 통과했다). 무테두리 문서를 표 스타일(SOLID) 대상에 병합하면 표지 전체가 박스로 렌더되는 것으로 실증(실한컴 A/B 대조)한 뒤 수리했다.변경추적(추적된 삽입·삭제·교체) 줄 겹침 렌더 — run 교체 경로 (
apply_model)가 문단의 lineseg 캐시를 지우지 않아 한컴이 옛 줄배치를 재사용, 추가된 텍스트가 기존 줄 위에 겹쳐 렌더되던 실사용 제보를 재현·수리했다. 실한컴 오라클로 수리 전후 렌더를 직접 대조했다. 후속 감사로 문단 복제 경로 7종을 전수 지도화해 무방비 2종(document-merge·공개insert_paragraphs/copy_paragraph_range)의 lineseg 캐시도 클론 시점에 제거하도록 정리했다(항상 새 위치의 새 내용이므로 원본 절대좌표를 들고 있을 이유가 없다).hh:tabPr탭 정지가hp:switch로 감싸이면 통째로 안 읽히던 결함 (DEV-022) —parse_tab_definition이 직계 자식만 스캔해hp:switch안의hh:tabItem(실코퍼스 449건)을 전부 놓치던 결함.hp:case/hp:default두 분기가 실제로는 다른 값(정확히 2배 관계)을 갖는다는 걸 확인해hp:default를 우선하는 읽기 모델을 세웠다(같은 값을 공유하는paraPr의 case-우선 규칙과는 정반대). 저작 쪽의 자매 결함(ensure_ tab_definition의 dedupe 비교가 같은 맹점으로 중복tabPr을 만들던 문제)도 같은 커밋에서 함께 수리했다.add_section()이 메모가 앵커된 첫 문단에서 깨지던 결함 —hp:secPr이 항상 첫 문단의 물리적으로 첫 run에 있다고 가정하던 코드가, 메모(나 다른 필드)가 앞에 붙으면 실제로 존재하는secPr을 못 찾고 “양수 페이지 크기를 가진 섹션이 없다”는 오류를 내던 결함.paraPr비중복화 —ensure_paragraph_format이 호출마다 동일 내용의paraPr을 새 id로 계속 발급하던 결함(실한컴은 저장 시점에 중복을 자체 병합하지만 이 라이브러리는 하지 않고 있었다). 구조 비교 기반 find-or-existing으로 수리했다.특수 인라인 텍스트 원자 읽기 버그 —
TextExtractor가lineBreak/nbSpace/fwSpace를 재귀 순회에서 건너뛰기만 하고 대체 문자를 넣지 않아, 줄바꿈이 조용히 사라지고 앞뒤 텍스트가 그대로 붙어버리던 결함. 각 마커를 유니코드 대응(줄바꿈은 개행, 전각·고정폭 공백은 각각의 전용 공백 문자, 하이픈은 소프트 하이픈)으로 치환하도록 고쳤다.커버리지 원장(coverage ledger) 계측기 자체의 오분류 4종 — 독립 완전성 감사(2026-08-04)가 판정한 오분류(주석·문서화 문자열을 코드로 오인, 함수 인자로 전달된 태그를 못 따라감, 런타임 조립 마크에 근거 없는 화이트리스트 등)를 tokenize+ast 기반 스캐너·고정점 인자 추적기· 근거-필수 화이트리스트로 수리했다. 감사가 제시한 4개 오분류 사례 전부 수리 전/후 재현으로 확인했다.
정리 (측정 인프라)
census 모집단 재구성 — 커버리지 원장의 census를 재현 불가능한 옛 166파일 모집단에서 물러나, 벤더드 hwpxlib 코퍼스(47, 누구나 재현 가능) + 관리자 개인 실문서 집계(190, 경로·이름·내용 없이 개수만) = 237건으로 재구성했다. 두 모집단의 비대칭성을 census 문서 자체에 명시한다.
편집기 표면 인벤토리(신규 계측기) — coverage ledger가 재는 “요소 축”과 별개로 “기능 축”(사용자가 실제로 에디터에서 클릭하는 모든 기능)을 재는 새 문서(
docs/editor-surface-inventory.md). capabilities 등록 영역과 support-matrix 근거를 자동 교차해[엔진 상태]×[증거]× [실한컴 검증]을 도출한다. 이 인벤토리 자체가 자기 스캔으로 8개 실동작·미등록 기능(doc.page의 19개 메서드 전체 등)을 찾아냈고, 사이클 진행에 따라 미실측 행을 하나씩 닫아 이번 릴리스 시점에는 구조적으로 검증 불가능한shape-escape-hatch한 줄만 남았다(실한컴이 설계상 그 입력을 거부하므로 “렌더 검증”이라는 개념 자체가 성립하지 않는다).편집기 메뉴 역방향 지도(신규 계측기) — “한컴 메뉴 항목 → 우리 엔진 대응”이라는 반대 방향 질문에 답하는 새 문서(
docs/editor-menu-reverse- map.md). macOS 9개 메뉴 128개 항목을 전수 판정했다([대응 영역]/ [부분 대응]/[대응 없음=신규 갭]/[스코프 밖]/[미확인]). 여기서 나온 “대응 없음” 목록이 이번 릴리스의 신규 저작 표면(문서정보·드롭캡· 글자방향·단나누기·표나누기/붙이기·개요·바탕쪽·날짜/교정/PATH 필드· titleMark 등) 대다수의 최초 입력이 됐다.openrate 코퍼스 v5~v21 — 사이클마다 새로 연 저작 표면을 실한컴 오라클로(초기엔 Windows COM, v6부터는 macOS GUI) 배치 측정하는 시리즈를 17회 더 이어갔다. 매 배치마다 결정론(독립 재생성 2회 바이트 동일)· 정적 오픈-세이프티 사전필터·부정 대조군 거부를 확인했고, 6.11 사이클 종료 시점에 인벤토리의 미실측 행을 한 차례 0으로 닫았다(이후 신규 저작마다 다시 쌓이고 다시 닫히는 순환이 이어졌다).
편차 등재 DEV-002~044 — 스키마-대-실측 괴리를 재실행 가능한 프로브와 함께 43건 추가 기록했다(예:
tabItem카디널리티, connectLine의subjectIDRef가id가 아닌instid로 해석되는 점,hp:label의 실측 2-클러스터 수렴,hp:switch/case/default의 스키마 완전 부재, titleMark가 스키마에는 선언돼 있으나 문서화가 전무한 점). 별도로, 이전 조사 회차에서 미병합 상태로 남아 있던 편차 16건도 재검증을 거쳐 정식 등재했다.
[6.0.3] - 2026-08-11
보안
신뢰할 수 없는 HWPX를 읽을 때의 자원 고갈을 수정합니다(GHSA-8g8m-xpm4-wxvx, HIGH). 405 KB짜리 조작 파일 하나로
HwpxDocument.open()이 830 MB를 할당할 수 있었고, 비율은 공격자가 정합니다. 원인은 두 가지였습니다 — 멤버를 읽는 대부분의 경로가guard_zip_file()을 아예 호출하지 않았고, 가드가 도는 자리에서도 중앙 디렉터리에 적힌 크기만 검사해 실제 할당량을 제한하지 못했습니다.read_member()/read_zip_members()를 도입해 적힌 크기가 아니라 실제로 읽힌 바이트를 64 KB 단위로 세며 한도를 넘으면 중단합니다. 이제 할당량이 저장량이 아니라 선언 크기에 비례합니다.압축 데이터가 적힌 크기보다 큰 멤버(위조 크기), 데이터를 실은 디렉터리 엔트리, 드라이브 경로(
C:/·D:\·//server/share), STORED·DEFLATED 외 압축 방식 (bzip2·lzma는 CPython이 청크 읽기로 bound하지 못함)을 거부합니다.패치 계열·아카이브 CLI·진단 도구 등 신뢰할 수 없는 아카이브를 읽는 모든 경로가 첫 멤버를 읽기 전에
guard_zip_file()을 통과하도록 배선했습니다.
동작 변경: 위 경로들에는 지금까지 크기 제한이 없었습니다. 그래서
HwpxDocument.open()이 이미 거부하던 문서(멤버 128 MB 초과, 멤버 4096개 초과, 압축비 1000:1 초과)가 이제paragraph_patch()·hwpx-unpack등에서도 거부됩니다. 128 MB가 넘는 동영상·이미지를 담은 문서를 다루던 사용자는 영향을 받을 수 있으며,guard_zip_file(limits=...)로 조정할 수 있습니다.신고 및 수정: @Nekonic.
[6.0.2] - 2026-08-04
v6.0.1도 보존된 실패 태그입니다 — 아무것도 게시되지 않았습니다. prepublish의
mypy 게이트가 Q3b 구역 서식 setter의 루프 변수 재사용 타입 충돌 4건을 적발해
업로드 전에 중단했습니다(로컬 태그-전 점검이 core에서 타입체커를 생략한 것이
원인 — 체크리스트에 core mypy+pyright를 명문화). 변수 분리로 고친 동일 내용이
6.0.2입니다. 삭제·이동·재사용하지 않습니다.
[6.0.1] - 2026-08-04 (preserved failed tag — nothing published)
v6.0.0은 보존된 실패 태그입니다 — 아무것도 게시되지 않았습니다. prepublish의
공개 위생 게이트가 이번 트레인 신규 파일 3개(코퍼스 v4 생성기·왕복 하니스·
감사 판정문)에 유입된 내부 작업 코드네임을 적발해 업로드 전에 트레인을
중단했습니다. 코드네임을 공개 서술로 치환하고 동결 인벤토리를 75→74로 전진
(6.0 표면 재편으로 삭제된 파일의 역사 항목 1건 소멸)한 동일 내용이
6.0.1입니다. 삭제·이동·재사용하지 않습니다.
[6.0.0] - 2026-08-04 (preserved failed tag — nothing published)
엔진 완전성 트레인의 major 경계입니다 — 표면을 도메인 네임스페이스로 재편하고,
완전성을 측정할 구조물(커버리지 원장·편차 레지스트리·왕복 하니스·코퍼스 v4)을
세웁니다. 독립 감사 판정: “완전성에 도달한 버전”이 아니라 “완전성을 측정하고
채워 나갈 구조물”이 정확한 서사입니다(docs/2026-08-04-completeness-audit-verdict.md).
바뀜 (파괴적 — major 근거)
루트 표면 102 → 34. 이동한 79개 이름은 도메인 네임스페이스로:
doc.notes(각주·미주·메모) ·doc.fields(누름틀·체크박스·하이퍼링크) ·doc.shapes(도형·그림·수식·차트) ·doc.styles(문자·문단 서식, 스타일) ·doc.page(용지·구역) ·doc.tracking(변경추적) ·doc.text(검색·치환) ·doc.toc·doc.plan·doc.media·doc.parts. 5.x 루트 이름 전부가 행선지를 안내하는DeprecationWarningshim으로 7.0까지 동작합니다.반환 규약 단일화: 저작 메서드는 라이브 도메인 객체를, 결과 페이로드는
frozen dataclass(+to_dict())를 반환합니다 — dict/tuple/스칼라 반환 0.typed error: 공개 경로 100%가 kebab
code를 가진HwpxValueError/TypeError/LookupError/StateError로 던집니다(기존 builtin except 절과 이중상속 호환). 스타일 이름 오타는 호출 시점에style-not-found(+근접 제안)로, 없는 숫자 id도 저장 전에 거부됩니다.
추가됨
add_paragraph(style="개요 1")스타일 이름 해석과add_heading(level=)(styleIDRef +hh:headingOUTLINE 이중 방출).Q3b 요소 개방:
pageBorderFill(BOTH/EVEN/ODD 질의·저작), footnote/endnote 모양 5블록 부분 갱신,ensure_style(이름 기반 신규 스타일),set_visibility/set_line_numbers/set_grid.커버리지 원장(
docs/coverage-ledger.md, 345 요소 기계 재산출 — ⚠알려진 측정 오차 절 필독) · OWPML 편차 레지스트리 17항목 (specs/063-owpml-deviations/) · 왕복 충실도 하니스 · 코퍼스 v4 (실한컴 12.0.0.3288에서 170/170 개봉·170/170 렌더 검증,docs/openrate/report-v4.json).실측 비교표
docs/comparison-python-docx.md(대조군 리플렉션 실측, 지는 칸 5행 포함) · 이주 가이드docs/migration-6.0.md· 문서 예제 자립 실행 71/117.
제거 예고
legacy shim 79종과
section_index=파라미터는 7.0.0에서 제거됩니다.python -m hwpx.capabilities의surfaceShape가 shim 수와 제거 시점을 기계 판독 가능하게 노출합니다.
[5.8.0] - 2026-08-03
정직성 트레인입니다 — 새 저작 표면 없이, 라이브러리가 하는 말을 전부 참으로 되돌립니다.
고쳐짐 (영수증 무결성)
SavePipeline의 레이아웃 게이트가 꺼져 있거나 내부 예외로 못 돌았을 때passed를 돌려주던 것을 중단합니다.LayoutReport에 명시적status(passed/warned/failed/unverified)와unverified_reason이 추가되어, 끈 게이트·터진 게이트·진짜 통과가 영수증에서 구분됩니다.ok의 의미(저장 차단 여부)는 그대로라 동작은 바뀌지 않습니다.ID/참조 무결성 검사가 내부 예외를 삼킨 채 통과로 남던 것을 수리했습니다.
require_reference_integrity=True인데 검사가 실행되지 못하면 이제 실패입니다 — “확인 못 했음”을 “확인했고 정상”으로 세탁하지 않습니다.paragraph_patch가 전량 폐기된 편집을applied에 싣던 것을 수리했습니다. 이 계열은 all-or-nothing이므로, 매칭됐지만 버려진 편집은 신설된discarded로 보고되고applied는 비웁니다.output_path가 원본 바이트 사본을 받는 문서화된 경우는 신설outputIsSourceCopy가 명시합니다(두 키 모두 additive, 기본값 빈/false).
고쳐짐 (자기서술)
동봉 지원 매트릭스가 이미 출하된 기능을 부정하던 3곳을 정정했습니다: 차트(“생성 API 없음” →
add_chart는 5.3.0부터 실재), 표 기본값(“수리 예정” → 5.4.0에서 수리 완료), 체크박스(행 부재 → 실한컴 계약과 함께 신설). 이 문서는 휠에 동봉되고 MCP 리소스로 서빙되므로, 이를 읽는 에이전트가 실재하는 기능을 회피하고 있었습니다.능력 레지스트리 드리프트 가드를 문서↔문서 대조에서 레지스트리↔실코드 대조로 뒤집었습니다.
HwpxDocument의 모든add_*메서드는 정확히 한 능력 영역에 귀속되어야 하며, 등재 없이는 새 저작 메서드를 출하할 수 없습니다 (직전 릴리스에서 체크박스가 양쪽 문서에 다 없어 옛 가드를 통과한 실패의 구조적 차단).
추가됨
hwpx.capabilities.verify_self_description()과python -m hwpx.capabilities --verify— 설치된 휠에서 자기서술이 실표면과 일치하는지 누구나 직접 검사할 수 있습니다. 선언 대신 검증기를 동봉합니다.실측 코퍼스 v3 발행: 현행 스택이 만든 120문서(기준 스트라텀 + 각주·누름틀· 수식·차트·체크박스·편집계획 6표면)를 실한컴 12.0.0.3288이 전건 개봉·렌더 (120/120, rule-of-three 하한 97.5%). 영수증(
docs/openrate/verdicts_v3.jsonl) 은 행마다bucket을 가져 분모 분해가jq한 줄로 재현됩니다. 축소 범위 (497 전수 아님)는 매트릭스·README에 명시합니다.
문서
README 헤드라인 수치에 측정 스택·일자를 병기합니다(측정 없는 “continuously verified” 문구 폐기).
NOTICE에 한컴 파일 형식 공개 문서가 요구하는 고지 문구를 원문 그대로 추가했습니다. 낡은 사내 라이선스 메타데이터 정책 문서(재라이선스 이전 잔재)를 제거했습니다.
[5.7.0] - 2026-08-03
추가
체크박스 양식개체 저작(experimental):
add_check_box(caption, checked=…)·list_check_boxes()·set_check_box(checked, index=|name=). 방출 형상은 실한컴 실측 계약을 따릅니다 —value="CHECKED"가 ☑,UNCHECKED가 □로 그려지고 caption은 렌더 텍스트 레이어에 나옵니다.<hp:formCharPr>는 필수 자식이며(없으면 한컴이 문서를 거부합니다 — 단일 변인 프로브로 확정)<hp:checkBtn>은 누름틀과 달리<hp:ctrl>래핑 없이 run 직속입니다. 표 셀 안 배치도 지원하며, 선택자 없는/모호한set_check_box와 빈 caption은 typed 거부입니다.참고: 한국 정부 공문서 서식은 이 양식개체가 아니라 텍스트
[ ]+√ 관례를 규정합니다(시행규칙 별표 4 제10호). 이 프리미티브는 실제로 한컴 체크박스를 쓰는 서식용입니다.
[5.6.0] - 2026-08-03
추가
hwpx.plan편집 계획 실행기 (experimental): 바이트-스플라이스 편집 op 7종(paragraph_patch·fill_cells·apply_table_ops·apply_body_ops·recolor_runs_by_color·strip_runs_by_color·strip_trailing_table_captions) 을 선언적 계획 1파일(hwpx.edit-plan/v1)로 합성해 정적 선검증 → 전 체인 인메모리 실행 → 최종 open-safety 검증 → 단 1회 원자 쓰기로 실행합니다. 중간 step이 실패하면 output·source가 바이트 불변임이 테스트로 증명되는 all-or-nothing 계약이며, 결과는 step별 + 원본→최종 실측hwpx.mutation-report/v1사영을 실은hwpx.plan-report/v1입니다. dryRun은 동일 체인을 전부 실행하되 쓰기만 생략하고,journalPath지정 시 JSONL 저널(진단용, resume 계약 아님)을 남깁니다.hwpx.capabilities기계가독 자기서술 (experimental):describe_capabilities()가 설치 버전·extras 실측 프로브·라이브 표면 census(stable/experimental)·편집 계획 op 어휘·능력 영역 레지스트리를 보고합니다.contract_document()는 패키지 동봉 계약 문서 4종 (support-matrix·recipes-traversal·mutation-semantics·known-traps 신규 저작) 을,contract_json_schema()는 계약 JSON Schema 4종(edit-plan·plan-report· mutation-report·capabilities)을 서빙합니다. 드리프트 가드 테스트가 레지스트리 진입점 해석·op 어휘 3자 일치·support-matrix 행 대조를 강제합니다(core는 렌더 오라클 가용성을 주장하지 않습니다 — 그 보고는 automation 계층 소유).
수정
support-matrix 각주/미주 행의 낡은 서술 정정: 5.5.0이 각주 방출 계약을 수리하고도 매트릭스 행은
Render-unverified·honest-defer(2026-08-01 문구) 로 남아 출하됐습니다. 행을 실상태(Render-verified, 5.5.0 수리 근거)로 갱신했고, 같은 부류의 드리프트를hwpx.capabilities가드 테스트가 이제 구조적으로 막습니다.docs/stable-api.md의 experimental 목록도 5.2.0 수식 3종 누락을 함께 정정(12→23).
[5.5.0] - 2026-08-02
수정
각주/미주가 실한컴에서 렌더되도록 방출 계약 수리 (실한컴 gold 리버스): 각주는 본문 run 안
<hp:ctrl>래핑으로 삽입되고number(유형별 연속 번호)·suffixChar를 실으며, 각주 본문 문단은 각주/미주 스타일 (헤더 이름 조회, 기본 15/16·paraPr 10·charPr 3)과 선행<hp:autoNum>(FOOTNOTE/ENDNOTE)을 갖습니다 — 기존 방출(run 직속·번호 없음)은 실한컴이 각주를 그리지 않던 실결함(감사 실결함 3번). 리더 (markdown [^fn] 부록·텍스트 추출 주석)는 실한컴 ctrl-래핑 형상과 구식 자사 형상을 모두 읽습니다 — 실한컴산 문서의 진짜 각주를 그동안 리더가 놓치고 있던 갭도 함께 수리.note.textsetter는 gold 본문(autoNum· 스타일)을 보존합니다.
[5.4.0] - 2026-08-01
추가
ensure_border_fill(border_type=…): OWPML 선 종류 어휘(SOLID·DASH· DOT·DASH_DOT 등)를 검증해 테두리 모양을 지정합니다. 어휘 밖 값은 typed 거부(ValueError).HwpxOxmlTable.set_cell_border_fill(row, col, border_fill_id_ref): 개별 셀의 테두리/배경 참조를 교체하는 표면(저작 충실도 감사에서 확인된 B 표면갭 수리).ensure_run_style확장 7종:underline_shape/underline_color(물결 등 밑줄 모양·색),strike_shape(취소선 모양),ratio(장평 10–400),letter_spacing(자간 −50–100),shadow(그림자 색),script(sup/sub위·아래 첨자 — 실한컴 계약 relSz 67·offset ±30). 전부 감사에서 실한컴 렌더로 검증된 charPr 자식 어휘이며, 범위·어휘 밖 값은 typed 거부.
수정
add_hyperlink표시 텍스트가 실한컴 관례를 따름: 파랑(#0000FF) 텍스트 + 파랑 BOTTOM 밑줄(실코퍼스 하이퍼링크 최빈 서식). 서식은 표시 런에만 실리며(fieldBegin/fieldEnd 런은 주변 서식 유지 — gold 계약) 다음 문단으로 전염되지 않습니다.char_pr_id_ref=로 override 가능.첨자 offset 부호 정정: 실한컴 렌더 실측 결과 offset 양수=아래· 음수=위 —
script="sup"가 위로,"sub"가 아래로 정확히 그려지도록 부호를 맞췄습니다.밑줄 type 어휘 gold 일치:
underline=True가 방출하던type="SOLID"(비표준)를 실한컴 관례 위치 어휘BOTTOM으로 수정.
변경
add_table기본값이 실한컴 계약과 일치: 셀 안여백 기본 510/510/141/141(기존 0 — 한컴에서 만든 표와 여백이 달랐음), 기본 표 폭은 본문 폭(용지 − 여백)으로, 셀 안에 만드는 중첩 표는 부모 셀 사용 폭에 맞춤(기존 고정 7200/셀 기본값이 부모 셀보다 넓어 내용이 소리 없이 잘려 보이던 감사 실결함 수리). 명시width=지정 시 동작 불변.목록 문단 비상속: 글머리표/번호 문단 뒤에
add_paragraph로 추가하는 일반 문단이 목록 paraPr를 상속하지 않습니다(실한컴에서 프로그램적 추가 문단은 본문 — 감사에서 모든 후속 문단이 목록화되던 실결함 수리). 명시para_pr_id_ref지정 시 목록 계속 사용 가능.
[5.3.0] - 2026-07-31
추가
차트 저작
HwpxDocument.add_chart(experimental 계약): ECMA-376 chartML(c:chartSpace)을Chart/chartN.xml파트로 저장하고 실한컴<hp:chart chartIDRef=…>앵커를 방출합니다 — 실한컴 계약 그대로 파트는 어느 manifest에도 등록하지 않으며(실측), 한컴은 chartML만으로 차트를 그립니다(OLE 폴백·사전렌더 이미지 불요, 실한컴 렌더 픽셀 실측: 막대· 꺾은선·원). chartML은 파싱·루트 검증 후에만 기록(typed 거부), 표 셀 배치·인라인 배치 지원, 생성 직후 표준 섹션 스캔 재인식 실패 시 즉시 실패합니다. 기존 차트 파트와의 경로 충돌 없이 순차 할당하며 무관 파트는 바이트 보존됩니다.
[5.2.0] - 2026-07-31
추가
수식 저작
HwpxDocument.add_equation(experimental 계약): 실한컴이 만드는<hp:equation>형상 그대로(EqEdit script는<hp:script>자식,treatAsChar="1"인라인, lineseg 캐시 없이 — 한컴이 열 때 재조판) 수식을 삽입합니다. 표 셀 내부 삽입을 지원하고, 생성 직후 표준 섹션 스캔으로 재인식되지 않으면 즉시 실패합니다(특수분기 0). 계약은 실한컴 gold 리버스(수식 계약 문서) 기준입니다.LaTeX → EqEdit 변환기
hwpx.equation.latex_to_eqedit(experimental): 리더 방향(EqEdit → LaTeX)과 같은 토큰맵의 역방향입니다. 분수·근호/n제곱근· 첨자·그리스·관계/이항연산·합/적분/극한 상하한·행렬(pmatrix계열·cases)·\left/\right·accent·\text리터럴·예약어 따옴표 보호(T_{int}→T _{"int"})를 지원하며, 검증된 토큰셋 밖의 LaTeX는UnsupportedLatexError로 typed 거부합니다(무음 근사 없음). 왕복 property 테스트가 저작 EqEdit를 기존 리더로 복원해 고정점을 증명합니다.estimate_equation_size휴리스틱이<hp:sz>자리표시 크기를 계산합니다 (한컴이 열 때 실측 재계산).
[5.1.1]
v5.1.0은 보존된 실패 태그입니다 — 아무것도 게시되지 않았습니다. 태그
워크플로의 공개 위생 게이트가 실한컴 gold 픽스처 2종의 OPF 메타데이터에
남은 사적 출처 마커(creator/lastsaveby)를 적발해 중단했고, 마커를 제거한
동일 내용이 5.1.1로 복구되었습니다. v5.1.0은 삭제·이동·재사용하지 않습니다.
[5.1.0]
추가
누름틀 필드 저작
HwpxDocument.add_form_field(experimental 계약): 실한컴이 만드는 CLICKHERE 형상 그대로(필드 속성·Prop/Command/Direction/HelpState파라미터·화면 전용 안내문 런·fieldEnd쌍) 필드를 생성합니다. 안내문 길이 직렬화는 문자 수 기준이며, 만든 필드는 기존list_form_fields/fill_form_field가 특수분기 없이 그대로 소비하고 실제 한컴오피스가 열거·채움을 수행합니다(실한컴 gold pair 리버스 계약). 표 셀 내부(중첩 포함) 삽입을 지원합니다.필드 페이로드 확장:
list_form_fields결과에memo(HelpState)·dirty·is_placeholder가 추가되고, 실한컴 파라미터 이름Direction/HelpState가prompt/memo로 매핑됩니다.dirty != "1"인 동안 보이는 값은 사용자 값이 아니라 안내문입니다.
수정
채움이 한컴과 같은 흔적을 남깁니다:
fill_form_field가 값 기록 시dirty="1"을 설정하고, 안내문(placeholder) 상태의 필드를 채울 때 안내문 전용 스타일(빨강·이탤릭)을 주변 스타일로 교체합니다. 종전에는 값이 안내문 스타일을 그대로 물려받아 빨간 이탤릭으로 남는 무음 시각 결함이 있었습니다.
[5.0.2]
수정
첫 실행이 조용해졌습니다: 기본 템플릿으로
new()→save_to_path()만 해도manifest에서 masterPage/history/version …경고가 15줄 출력되던 문제를 고쳤습니다. 빈 문서에 masterPage/history가 없는 것과 version.xml이 manifest 선언 없이 고정 경로에 있는 것은 실제 한컴 산출물과 동일한 정상 상태입니다(실한컴 gold fixture 6종 대조로 확인). 이제 manifest가 실재 파일을 놓친 경우에만 경고하며, 반환값은 변하지 않습니다.릴리스 해시 검증기가 태그에서 버전을 유도합니다: 종전에는 PyPI 조회 URL의 버전이 스크립트 상수로 고정되어, v5.0.1 릴리스에서 존재할 수 없는 5.0.0 JSON을 조회하다 404로 빨간 표시를 냈습니다(아티팩트는 건전, 독립 readback으로 종결했던 그 건입니다). 이제
--tag에서 버전을 유도하고, 매니페스트 파일명이 태그 버전을 담는지 교차 검증하며, 인덱스 전파 지연 대비 재시도 예산을 60초에서 300초로 늘렸습니다.
추가
5분 퀵스타트 개편: 읽기(텍스트 추출)와 저장 영수증(
MutationReport) 단계를 추가하고, 편집 예제를 복붙만으로 이어지는 완결 스크립트로 재구성했습니다. 문서 예제 ledger 재생성 스크립트 (scripts/regenerate_example_ledger.py)도 함께 추가했습니다.과업 축 매뉴얼 2종: 순회 레시피(문단·중첩 표·각주·런·메모/누름틀)와 편집 의미론(반환형· 실패 모드·재실행 성질·저장 보증 — 전부 실측 확인) — 실행 ledger 게이트에 편입.
llms.txt 발행: 훈련 데이터에 이 라이브러리가 없는 AI 도구가 정확한 API를 배우도록
https://airmang.github.io/python-hwpx/llms.txt(+ 매뉴얼 병합본llms-full.txt, 빌드 시 자동 생성)를 사이트 루트에 제공합니다. 내용 계약은 테스트로 고정(버전 문자열 금지 포함).채택·응답 지표 공개: 채택 지표 페이지와 기계 판독 이력(
adoption-metrics-history.json, 사이트 루트)을 추가했습니다. 수집은scripts/snapshot_adoption_metrics.py(멱등 — 같은 날 재실행은 교체)이며, 각 지표에 “이 숫자가 말해주지 않는 것” 캐비앗을 함께 둡니다.Python 3.13·3.14 공식 지원: CI 매트릭스와 trove classifier에 3.13/3.14를 추가했습니다(전체 스위트 1376 passed를 양 버전에서 확인한 뒤 반영). 지원 정책은 설치 가이드에 명문화했습니다.
[5.0.1]
v5.0.0 is a preserved failed tag: its release run stopped in prepublish
(the installed-wheel docs gate requires uv, which the workflow never
installed) and nothing was published to PyPI or GitHub. 5.0.1 is the same
train content plus the workflow fixes — uv is now bootstrapped in both
the test and release jobs, and the test job’s tee pipe no longer masks
pytest’s exit code. Never delete, move, or reuse v5.0.0.
[5.0.0]
Removed — BREAKING
python-hwpx is now the HWPX object model, OPC/OXML, and the format-native
primitives built on them. The application workflows that had grown inside the
library moved to python-hwpx-automation, which has owned their canonical
implementation since the 4.x line. Nothing is discontinued — every removed
import has a named replacement in
the migration guide, and 4.x keeps all of it.
hwpx.agentand thehwpxconsole command →hwpx_automation.office.agent. The automation package declares thehwpxname in the train that raises its core floor to 5.0, so no valid install ever has two declarers of it.hwpx.authoring,hwpx.builder,hwpx.design,hwpx.presets→hwpx_automation.office.authoringhwpx.exam→hwpx_automation.office.examhwpx.evalplan_fill→hwpx_automation.office.evalplanhwpx.form_fill,hwpx.formfill_quality,hwpx.fill_residue,hwpx.guidance_scan,hwpx.template_formfit→hwpx_automation.office.form_fillhwpx.tools.official_lint,hwpx.tools.pii,hwpx.tools.table_compute,hwpx.tools.style_profile,hwpx.tools.advanced_generators,hwpx.tools.report_parser→hwpx_automation.office.compliance/office.quality/office.utilities/office.authoringhwpx.tools.mail_merge.mail_merge→merge_template_rows, which is now public. The removed wrapper masked by default and core no longer carries the detection rules; the generic function takes avalue_sanitizerso the caller decides, and the decision is visible at the call site instead of implied by an omitted argument.hwpx.tools.doc_diff.build_comparison_table_plan→hwpx_automation.office.document_ops. Generic diff and reference-consistency stay here.The four
template_formfitnames that 4.x warned would go “in the next major” are gone. That was this major.hwpx-conformanceconsole script: its package is repository QA and no longer ships, and a command that cannot start is worse than no command.
Changed
HwpxDocument.add_table()now creates a neutral table-anchor paragraph by default, so a preceding numbered heading/list no longer renders a stray number beside the table in Hancom. Passinherit_style=Trueor explicit paragraph/style references when anchor-style inheritance is intentional.HwpxDocument.add_tracked_replace()now writes the inserted replacement at the deleted text’s source position, preserves that run’s character style, and leaves later tracked inserts in their original order.The product-boundary lazy-loader fingerprint now canonicalizes parser-only empty AST fields, so the same guarded source passes consistently on Python 3.10–3.13 while real syntax changes still fail closed.
verify_redlineandverify_filltake an injectedhwpx.quality.rendering.RenderBackend. Core does not look for a Hancom installation any more; without a backend the report isrender_checked=Falserather than a visual verdict it never earned.toc_fidelity.heading_rendered_pagestakes a word-box extractor, andheading_pages_from_word_boxesis public for callers that already have boxes. Reading a PDF needs an imaging stack; matching headings does not.hwpx.oxml.color.color_familyis public. Both core’s run rewriting and the application-side guidance scanner classify colour the same way, so there is one implementation of what counts as red.
Packaging
hwpx.benchmarkandhwpx.conformanceare excluded from the wheel. They are things this project runs on itself, not things a library user installs.The fuzz harness moved to
scripts/fuzz/, outside the package, because it builds documents through the MCP owner’s builder and core must never import a companion layer.
Migration
pip install python-hwpx-automation and follow docs/migration-5.0.md.
pip install "python-hwpx<5" rolls back; the 4.x line is not a dead end.
Documentation
4.x compatibility/deprecation 관찰 정책을 공개했습니다. 8개 runtime family, 3개 CLI, 공개 스키마/리포트 projection은 2026-10-31까지 모두
extend하며 제거는 0건입니다. 신규 코드를 위한 MCP canonical 경로, side-by-side 이행, rollback, 별도 next-major 승인 조건을 4.x 호환 표면 관찰 정책에 기록했습니다.
[4.2.0] - 2026-07-22
Added — 평가계획(교수학습운영·평가계획) 실채움 엔진 확장
fill_evalplan에phase="clean"을 추가했습니다 — 기존"all"(채움) 뒤에 core의 결정론적 양식 정리(제목·교사·정의적 표 채움, 양식 지시문·외래 샘플 소제목·고아 헤딩 prune, 빨강 지시 run 제거, 슬롯-파랑→본문 검정 재색, 표 꼬리 캡션 strip)를 한 경로로 수행해, 별도 정리 스크립트 없이 실제 도교육청 양식을 잔존물 없이 채웁니다. 기본값"all"은 기존 동작 그대로입니다(비파괴).finalize_evalplan(위 정리 오케스트레이션)과 프리미티브 2종 (table_patch.strip_trailing_table_captions,guidance_scan.is_form_instruction)을 추가했습니다. 전부 패턴·구조 기반이며 과목·학년 문자열 하드코딩이 없습니다.
Fixed — 평가계획 표 파싱·채움
성취기준별 §4가 성취수준 표(A~E 또는 상/중/하)를 파싱·채우지 못하던 문제를 고쳤습니다. 콘텐츠의 성취수준 단계 수를 읽어 표 구조에 맞춰 채웁니다.
도너 스케줄 표의 병합이 일부 주차 행을 흡수하던 문제를 고쳤습니다(병합 분리).
§7 수행평가 세부기준 상세 배점 루브릭(평가요소·수행수준·배점, 세부 영역 가/나/다)을 파싱·채우도록 확장했습니다.
[4.1.1] - 2026-07-21
Fixed
4.1.0 태그의 발행이 공개 위생 게이트(워크스테이션 경로 검사)에 걸려 중단됐습니다 — 내부 개발용 rhwp 트리아지 스크립트가 공개 레포에 포함돼 있었고, 해당 도구는 공개 표면이 아니므로 저장소에서 제거했습니다. 라이브러리 코드는 4.1.0과 동일합니다. (
v4.1.0은 보존된 실패 태그이며 PyPI 산출물이 없습니다.)
[4.1.0] - 2026-07-21
Fixed — form-fill 차등 판정기 교정 (verify 신호 신뢰성)
hwpx.form_fit.wordbox의 표 구조 지문(extract_layout_signature)과 overflow 클립(extract_cell_clips)이 fitzfind_tables()기본 전략(글리프 스냅) 대신 그려진 테두리 전용(lines_strict)을 쓰도록 교정했습니다. 종전에는 빈 셀을 채우면 그려진 격자가 그대로인데도 유령 표·허위 overflow가 검출되어verify_form_fill계열 게이트가 허위 실패를 냈습니다. wild 코퍼스 실측: 허위 shape 실패 6건·허위 overflow 3건 해소, 회귀 0, 산출분 pass 17/28→23/28. 제품 산출물(채움 바이트)은 변경되지 않았습니다 — 판정만 정확해졌습니다.
Docs — 정직 실측 갱신
실측 코퍼스 메트릭에 「구조결함 2차 실측」 추가: 잔존은 페이지 리플 5건(4건 typed 경고 동반·완전 무음 1건)이며, typed 거부 35건 전수 감별 결과 과잉거부 0. 지원 매트릭스 양식 채움 행 동기화.
[4.0.0] - 2026-07-21
Removed — deprecation window 준수 정리 (major 경계)
HwpxDocument.save()제거: v2.6(2026-02-19)부터 5개월간DeprecationWarning을 달고 있던 호환 래퍼를 제거했습니다. 목적지별 명시 메서드를 쓰세요 — 경로save_to_path(path)· 스트림save_to_stream(stream)· 바이트to_bytes(). 이 셋은 안전한 쓰기 계약(mode/fallback등급 +return_report)을 지원하며, 제거된save()에는 없던 기능입니다.hwpx.package모듈(→hwpx.opc.package)은 경고 이력이 있지만 stableHwpxPackage의 역사적 import 경로라 유지합니다(shim, 비용 0). 전체 표·이유는 4.0.0 마이그레이션.
Added — 구조화 예외 베이스 (오류 계약 통일)
hwpx.errors.HwpxError(최상위hwpx.HwpxError로도 import) 도입 — fail-closed 공개 경로 예외의 베이스. 사람용str(exc)는 그대로 두고 기계가 읽는code(kebab 안정 식별자)·context(실측 값 dict)·suggestion(다음 행동)을 얹으며to_dict()로 봉투를 냅니다. 공개 계약 경로부터 이행:PreservationDowngradeError(preservation-downgrade), 신규SaveError(대표 저장 경로의 사전검증·open-safety· 품질 게이트 실패),TableStructureError(table-structure),RenderCheckRequired(render-check-required). 기존except타입(ValueError/RuntimeError/Exception)은 상속으로 그대로 동작합니다. 전체 표는 stable-api.md 오류 계약.HwpxError가 stable 표면에 추가되어hwpx.__all__은 stable 67개가 됩니다.
Changed — 스키마 동결 + mutation 반환형 통일
스키마 동결:
hwpx.mutation-report/v1·hwpx.document_plan.v1/v2·hwpx.agent-batch/v1·hwpx.mixed-form-plan/v1의 required 필드 집합을 동결하고 계약 테스트(tests/test_schema_freeze.py)로 고정했습니다. 정책은 additive-only — 신규 필드는 Optional, 파괴 변경은 새 major + 새 스키마 버전 문자열 (schema-freeze.md).mutation 반환형 통일: 공개 mutation-write 경로가 전부
hwpx.mutation-report/v1로 사영 가능함을 계약 테스트(tests/test_mutation_contract_unification.py)로 고정 했습니다(byte-write 결과모델 4종 + 네이티브save_to_path영수증). 사영 없는 신규 byte-write 모델이 추가되면 구조 가드가 실패합니다.save_to_path/save_to_stream/to_bytes이름을 장기 확정으로 명문화(개명 재론 종결, safe-write-contract.md).
Changed — 최상위 API 표면 3계층화 (major 경계 준비)
from hwpx import ...표면을 stable / experimental / deprecated 3계층으로 분류했습니다.hwpx.__all__에는 stable 67개만 남깁니다(P1의 66 + P2HwpxError). 계층·정책 전수 목록은docs/stable-api.md.experimental(12) — ingestion 프레임워크·레이아웃 프리뷰·문서 프리뷰 뷰어.
from hwpx.experimental import ...로 사용하세요. 최상위 재내보내기는 하위 호환을 위해 유지하되 접근 시DeprecationWarning이 나며 다음 major에서 최상위 경로가 제거될 예정입니다(구현 모듈·hwpx.experimental경로는 유지).deprecated(4) —
analyze_template_formfit/apply_template_formfit와TEMPLATE_FORMFIT_*_SCHEMA_VERSION상수 2개. 대체 = 구조적 form-fill 경로 (hwpx.table_patch.fill_cells계열 + MCPanalyze_form_fill/apply_form_fill/verify_form_fill).최상위에서 제거된 이름 0개: 기존 최상위 이름 82개는 전부 계속 import 가능합니다 (최소 deprecation window 준수 — 경고 없는 즉시 제거 금지).
HwpxDocument.save()는 최상위 표면 이름이 아니라 메서드로, 위 Removed 절에 따라 제거됐습니다.
[3.8.0] - 2026-07-21
Added — 문서 프리뷰 뷰어
render_document_viewer: 한컴 없이 문서를 스크롤 통독하는 self-contained HTML 뷰어(상단바·현재 페이지 표시·키보드 탐색·외부 리소스 0). 충실도 배지가 한계를 정직하게 표시합니다(텍스트 근사·페이지네이션은 한컴과 다를 수 있음).수식 실제 렌더:
hwpx.equation—<hp:equation>의 EqEdit 스크립트를 clean-room 토큰맵으로 LaTeX로 변환해 MathML로 렌더합니다(선택 extrapython-hwpx[preview]= latex2mathml). 실한컴 ground-truth와 시각 대조로 검증(specs 증거). 변환 불가/라이브러리 부재 시 빈칸 대신 원문·LaTeX 코드블록으로 정직 표시하고, 그림·도형은 자리표시 마커로 보입니다 — 기존 프리뷰가 수식을 조용히 빈 문단으로 떨구던 동작은 제거됐습니다.
Internal
MCP 경계 타이핑 정밀화를 위한 evalplan 경로 Path/str 유니온(순수 어노테이션).
복잡도 3물결: 최상위 15개 함수 분해(C901 115→100), characterization 39건 추가.
[3.7.0] - 2026-07-21
Added — Safe Write Contract
일반 저장 경로가 명시적 쓰기 모드를 받습니다:
save_to_path(path, mode="patch"|"rebuild"|"auto", fallback="error"|"rebuild", return_report=True). 반환 기본값은 기존과 동일(경로)이며return_report=True일 때만 스키마버전드hwpx.mutation-report/v1영수증을 반환합니다 — 요청/실제 모드, 변경 part 목록(+가능한 경우 실제 범위, coordinate space 명시), 보존 보증 3계층(미수정 part payload / zip local record / whole package), 수행한 검증의 3값 기록(passed/failed/not_performed).무음 강등 없음:
mode="patch"에서 요청 보존 등급을 만족하지 못하면 출력 파일을 쓰지 않고 typedPreservationDowngradeError를 던집니다.fallback="rebuild"로 명시 동의한 경우에만 진행하며 영수증에fallbackUsed: true가 남습니다. 보존은 단언이 아니라 open-시점 기준선 대비 실측입니다(발행 성공 시 기준선 전진).기존 쓰기 결과 4종(BytePreservingPatchResult·CellFillResult·BodyOpsResult· AgentBatchResult)에
as_mutation_report()사영 추가 — byte-splice 계열은source=(bytes/str/Path) 제공 시 보존 3계층과 실제 스플라이스 범위를 실측 보고, 미제공 시 정직 강등. 기존 필드·to_dict 출력은 불변(additive).
Docs
README 포지셔닝 개정(§안전 자동화 계층+검증된 저작), 지원 매트릭스 공개(docs/support-matrix.md — Parse/Preserve/Edit/Create/Render-verified/ Unsupported-but-preserved/Unsupported-and-rejected, 셀별 증거 링크), docs/safe-write-contract.md 신설, 헤드라인 지표에 corpus·분모·측정일· assurance 병기(오픈 수용률 하한 표기를 rule-of-three 99.37%로 정밀화).
[3.6.0] - 2026-07-20
Fixed
양식 채움 무음 서식파괴의 지배 원인 픽스: fit 슬롯이 셀 안 인라인 treat-as-char 객체(체크박스·폼컨트롤·그림)의 선언 폭(
hp:sz/@width)을 가용폭에서 차감합니다. 이전에는 이를 비모델링해 “맞음”으로 오판한 채움이 실한컴에서 줄바꿈·행 성장을 일으켜 다중 페이지 양식 전체를 밀었습니다 (실측: 3글자 채움이 10페이지 양식을 11페이지로). 이제 그런 채움은 typed FIELD_OVERFLOW 거부(컨트롤 동거 경고 포함)가 됩니다. 실한컴 재측정에서 판정 조합 전체의 무음 서식파괴가 47%→16.7%로 감소했습니다.레이아웃 캐시 무효화를 편집 스코프로 축소: 편집한 문단의 캐시만 제거하고 저장 시 전량 제거(2개 레이어) 대신 증명 가능한 stale만 걷어냅니다. 채움 바이트 델타가 −133,651자에서 −170자로 줄어 바이트 보존 계열과 정합합니다.
Added
SlotMetrics.inline_object_width/inline_object_count— 슬롯 진단 표면.
[3.5.0] - 2026-07-20
Added
양식 채움 fit 판정에 수직(행 높이) 예산을 도입합니다. 이전에는 셀의 가로 폭만 측정해 세로로 100줄까지 “맞음”으로 판정, 축소도 거부도 발동하지 않고 행이 조용히 자라 페이지를 밀었습니다. 이제
available_height(셀 높이 − 상하 마진)와 글꼴별 라인하이트로 세로 예산을 재서,wrap_then_shrink는 값을 예산 안으로 축소하고, 최소 글꼴에서도 안 들어가는 과대 입력은overflow="fail"에서 typed 거부(FIELD_OVERFLOW)로 돌려줍니다.allow_row_expand/expand_row는 명시적 opt-out입니다.FitPolicy.keep()과 폭-only 경로는 바이트 불변입니다.
Measured (정직 발견)
wild 공개 양식 전수 재측정(실한컴): 양식 채움 차등이 fit-on 32/63 = 50.8% (fit-off 31/63 = 49.2%). 기대-통과 층(short+medium)은 61.4%로 이동 없음 — fit은 wild 실패의 지배 레버가 아니며, 지배 원인은 구조적 3부류(채움-겹침·다중 페이지 경계 밀림·표 구조 민감도)임이 측정됐습니다. 상세는
docs/corpus-metrics.md및 leap 데모demo/S-085-wild-formfill/.
[3.4.1] - 2026-07-19
Note
복구 릴리스.
v3.4.0태그는 prepublish 공개 위생 게이트에서 실패했고 (테스트 픽스처의 워크스테이션형 경로 문자열 —/home/...패턴), PyPI 아티팩트나 GitHub Release는 만들어지지 않았습니다. 실패 태그는 이력으로 보존하며 3.4.1이 실제 공개 릴리스입니다. 기능 내용은 아래 3.4.0 항목과 동일합니다.
[3.4.0] - 2026-07-19 (tag preserved; not published)
Added
선언형 문서 계획(plan-v2)에 네이티브 자동 목차 옵션(
native: true)을 추가합니다. 정적 목차를 내려쓴 뒤 한컴이 열기 시점에 재계산하는 TABLEOFCONTENTS 필드로 승격하며, 본문 스타일 수집 가드(바탕글-수집 함정)를 포함합니다.M9 출판 코퍼스 도구를 추가합니다: 코퍼스 v2 additive 생성기, 무인 실한컴 박스 판정(오픈/파싱·스케일 렌더 배치·redline InitScan 프로브), 축별 검증 드라이버 (byte-identity·PII 0-leak·저작 품질·양식 채움 차등·TOC 검증)와 결합 집계기 (provenance 이중 발행·redline-aware parsed·렌더 티어).
실측 결과를 문서로 발행합니다:
docs/corpus-metrics.md(축 주석 포함)와 릴리스별 기계 판독 히스토리docs/corpus-metrics-history.json.
Fixed
오픈레이트 박스 러너의 재개 키를 basename에서 전체 경로로 바꿔, 중복 파일명을 가진 코퍼스에서 파일이 조용히 건너뛰어지던 문제를 고칩니다.
Windows PowerShell 5.1에서 렌더 잡 배열이 1개 객체로 접히던 열거 함정을 고칩니다.
Internal
HwpxDocumentfacade를 도메인 owner 8모듈로 행동 보존 분해합니다 (2,961→1,777줄; 공개 표면 97멤버 characterization 스냅샷으로 동결).복잡도 상위 함수 5종+1을 분해해 C901 초과를 120→114로 낮추고, owner 모듈을 mypy/pyright 점진 게이트에 편입합니다(40파일 clean).
[3.3.1] - 2026-07-18
Internal
최악 복잡도 검증기 2종을 행동 보존 분해합니다:
validate_blueprint_manifest(C901 60→1, 헬퍼 14개)와validate_package(53→10, 헬퍼 12개). 에러 문자열·검사 순서·manifest 불변성은 기준선과 verbatim 동일하며 테스트 델타 0으로 실증했습니다.공개 표면·계약 변화는 없습니다. S-083 릴리스 트레인(hwpx-mcp-server 4.3.0 · hwpx-plugin 0.6.0)과 좌표를 맞추는 릴리스입니다.
[3.3.0] - 2026-07-18
추가
선택적 Mac GUI 오라클(
MacHancomOracle)에 도달성 프로브를 추가했습니다. 한컴 앱이 설치돼 있어도 GUI 세션·Automation(TCC) 권한이 없으면 5초 이내에available() == False로 정직하게 강등되며(프로세스 수명 캐시), 기존 구조 검증 경로가 그대로 동작합니다.렌더 오라클에 단일 외부 예산 전파를 추가했습니다.
budget_seconds(생성자·resolve_oracle)가 지정되면 내부의 모든 subprocess 타임아웃이 남은 예산으로 clamp되고, 예산 소진 시 subprocess를 생성하지 않고 즉시 강등합니다.HWPX_ORACLE_STRUCTURAL_ONLY환경변수를 추가했습니다. 설정 시resolve_oracle()은NullOracle을 반환하고 Mac GUI 백엔드는 어떤 경로로도 GUI 자동화에 진입하지 않습니다(구조 판정 전용 모드).HWPX_ORACLE_BUDGET_SECONDS환경변수를 추가했습니다. 호스팅 프로세스가 한 번 선언한 외부 deadline이resolve_oracle()의 모든 호출 지점(코어 verify·MCP 핸들러)에 자동 전파됩니다. 명시적budget_seconds파라미터가 env보다 우선합니다.
변경
src/hwpx/visual/oracle.py를 mypy·pyright 점진적 게이트에 편입하고 기존 타입 오류 2건(textLength 협소화, 검증 항목 변수 재사용)을 수정했습니다.
[3.2.0] - 2026-07-17
추가
기존 섹션 머리글을 네이티브 ID 또는 페이지 유형으로 지정해 본문·표 셀과 같은
hwpx.agent-batch/v1트랜잭션에서 편집하는 타입드 story 경로를 추가했습니다. dry-run, revision 및 idempotency 검사, 오류 시 rollback, 저장 후 story identity·구조 보존 확인을 동일한 단일 직렬화 경로에서 수행합니다.
변경
비대해진 OXML 문서 구현을 문서 프리미티브, 패키지/구역 관리, 구역 서식과 story 등 책임별 런타임 모듈로 분리했습니다. 기존 공개 facade와 import 경로는 유지하면서 수정된 소유 모듈 전부를 Ruff·mypy·pyright 점진적 게이트에 포함했습니다.
수정
add_section()이 인접 구역의 렌더 가능한 페이지·단 설정을 복제하되 머리글·바닥글 story는 복제하지 않고, manifest/spine 순서와hh:head/@secCnt를 함께 갱신하도록 수정했습니다. 음수after인덱스, 범위 오류, 불완전 패키지, 상대 manifest href를 원자적으로 처리하며remove_section()과 패키지 열기 안전성 검증도 같은 구역 수 불변식을 확인합니다.
검증
2개 구역 합성 fixture의 결정적 재생성, 저장·재열기, 패키지 바이트 보존, 오류 주입 rollback 및 한컴오피스 2/2쪽·2/2구역 경고 없는 열기 회귀를 고정했습니다.
[3.1.0] - 2026-07-16
추가
타입드 혼합 양식 계획기:
hwpx.mixed-form-plan/v1이 네이티브 필드, 고유 라벨 셀, revision-bound canonical path, 본문 직접 단일-run anchor를 하나의 엄격한 계획으로 받습니다. 모든 대상을 먼저 canonical path로 해석한 뒤 기존hwpx.agent-batch/v1한 건으로 컴파일하며,apply_document_commands만 실행기로 사용해 dry-run·rollback·idempotency·단일 저장 게이트를 그대로 보장합니다.병합 셀의 논리 좌표를 실제
cellAddr앵커로 정규화하는 비변형resolve_cell_target계획 프리미티브와 공개 plan/compiled-plan JSON Schema를 추가했습니다.
변경
에이전트 batch JSON Schema를 정본 카탈로그에 추가하고 quality 객체의 enum·boolean 필드를 엄격하게 검증해 알 수 없는 값이 실행 단계까지 전달되지 않도록 했습니다.
혼합 양식 출력이 입력과 동일한 resolved path·symlink·hardlink인 경우 계획과 적용 직전에 거부하고, 셀 라벨은 정규화된 정확 일치만 허용합니다. 컴파일 계획은 locator별 node/path/ section/좌표 불변식을 검증하며, 멱등성 식별자에 공개 locator 요청 hash를 포함합니다.
검증
합성 1쪽 한국어 혼합 양식으로 네 locator 동시 적용, 드라이런 무출력, 주입 실패 rollback, idempotent replay/conflict, 미변경 OPC member 바이트 보존, 재열기와
openSafety.ok를 고정했습니다.evalplan회귀는 유지하며exam모듈은 혼합 양식 경로에 가져오지 않습니다.
[3.0.0] - 2026-07-16
변경
공개 배포에서 내부 품질 검증용
hwpx.practice런타임과 관련 Python API를 제거했습니다. 문서 작성·편집·검증, 시험지, 평가계획, 범용 양식 채움 기능과 공개 conformance 흐름은 그대로 유지됩니다.
수정
높이가 서로 다른 물리 행을 삭제할 때 병합 셀 높이를 평균값으로 줄이던 문제를 수정했습니다. 이제 삭제 행의 실제 최대 높이를 사용해 평가계획 표를 다시 배치해도 병합 높이 합과 한컴 편집기 열기 안전성이 유지됩니다.
보안
소스·wheel·sdist·import 표면에 내부 품질 검증 런타임이 다시 포함되지 않도록 공개 위생과 패키징 회귀 게이트를 추가했습니다.
[2.29.2] - 2026-07-15
수정
공개 저장소의 운영 기록·생성 산출물·workstation 경로를 제거하고, 실제 회귀 입력은 명시적인 합성 fixture 디렉터리로 이동했습니다. 패키지에 포함되는 HWPX 예제와 conformance corpus의 작성자 메타데이터도 합성 값으로 정규화했습니다.
치명적 정적 오류를 차단하는 Ruff
E9,F및 텍스트/HWPX/wheel 공개 위생 게이트를 추가하고, 기존에 이름이 겹쳐 실행되지 않던 builder 회귀 테스트를 고유 이름으로 복구했습니다.
보안
GitHub Actions를 불변 커밋으로 고정하고 CodeQL, dependency review, Dependabot, CycloneDX SBOM, SECURITY/CODEOWNERS 정책을 릴리스 표면에 추가했습니다.
[2.29.1] - 2026-07-15
수정
릴리스 prepublish가 시각 fixture 테스트를 실행하면서도 Pillow와 NumPy를 설치하지 않아
v2.29.0태그의 게시 작업이 중단된 문제를 수정했습니다.testextra에 두 의존성을 포함해 clean CI에서도 동일한 테스트 계약을 결정적으로 재현합니다.
비고
v2.29.0태그는 prepublish 실패 이력으로 보존되며 PyPI 패키지와 GitHub Release는 생성되지 않았습니다. 기능 내용은 아래 2.29.0 항목과 동일하고, 실제 공개 패키지는 2.29.1입니다.
[2.29.0] - 2026-07-15
추가
타입드 에이전트 문서 인터페이스와 블루프린트 재생: 안정적인 semantic path/query, revision-bound atomic command, 통합
hwpxCLI, deterministic.hwpxbpdump와 strict portable/source-bound replay를 추가했습니다. 스타일·번호·리소스·참조는 typed semantic signature로 매핑하고, raw XML 없이 fidelity/identity/dependency/lossless/openSafety 영수증을 반환합니다.내구성 렌더·시각 QA: supervised Hancom render worker, resumable queue/poison-session 처리와 fixture 기반 page QA·blind evaluation 계약을 추가했습니다.
수정
블루프린트 replay가 병합 표 grid와 한컴 네이티브 control을 보존하도록 보강했습니다.
공개 2.24.1의 안전 동작을 유지해, 실제로 변경된 비어 있지 않은
lineWrap="SQUEEZE"셀만BREAK로 전환하고 no-op·지우기·미편집 셀은 원래 모드를 보존합니다.
비고
2.25.0–2.28.0은 공개 배포가 아니라 단계별 로컬 후보였으며, 그 누적 변경을 이 2.29.0 공개 항목으로 통합합니다.
[2.24.1] - 2026-07-14
수정
표 셀의
lineWrap="SQUEEZE"가 긴 신규 값을 한 줄 폭에 강제 압축해 글자가 포개지던 문제를 수정했습니다. 바이트보존fill_cells/apply_table_ops(fill_cell)와 일반set_cell_text모두 실제로 변경된 비어 있지 않은 셀만BREAK로 전환하고, 미편집 셀·no-op·지우기 작업의 원래 모드는 보존합니다.
[2.24.0] - 2026-07-08
추가
Stage 3 범용 form-fill 프리미티브 (universal form-fill goal): 임의 양식을 제출본급으로 채우는 동적 파이프라인의 손.
hwpx.guidance_scan.scan_form_guidance(비변형 정찰: 셀·캡션 포함 색 신호/범례/placeholder/빈 셀 후보).hwpx.body_patch(표 밖 문단 바이트보존 op: replace_text·delete_paragraph·insert_paragraph_by_clone·reorder_paragraphs·restyle_text·set_paragraph_text + 문서전체strip_runs_by_color(범례 “이 색=삭제” 구동)·recolor_runs_by_color(슬롯색→본문색)).hwpx.table_patch신규 op:split_cell_vertical(병합 셀 N그룹 분할)·clone_table(표 복제)·set_row_heights·set_cell_line_spacing+apply_table_ops(dry_run=)transcript.hwpx.fill_residue.inspect_fill_residue(채움본 잔존물 zero-체크 게이트).
비고
평가계획 3학년 실양식을 처음부터 끝까지(삭제·재구성·채움·청소·recolor) 범용 프리미티브만으로 완성, 실한컴 렌더 + 오너 실물 검수 PASS로 검증(도메인 전용 코드 0줄).
[2.23.0] - 2026-07-03
추가
폰트 shrink-to-fit (M10 후속, S-064):
hwpx.table_patch.fill_cells에fit_max_lines(+ 셀별max_lines) — 셀 텍스트가 템플릿 폰트로 목표 줄수를 넘겨 wrap되면form_fitFitEngine이 확신을 갖고 들어가는 가장 큰 폰트(≥min_font_pt)를 골라 실제<hh:charPr>로 재료화(base charPr 복제·height 변경)하고 셀 run을 그 charPr로 재지정. byte-preserving(header.xml의 새 charPr + 해당 섹션만 변경, opt-in이라 목표 없는 채움은 바이트 동일). FitEngine 정직 게이트가 borderline shrink는 거부(확실히 들어갈 때만 축소).
비고
오라클 실증: 실제 3학년 양식 성취기준 셀을 긴 텍스트 +
max_lines=4로 채우니 9pt→6.5pt 축소, 실한컴 clean 렌더(나머지 표는 9pt 유지). 정직: 도교육청 폼은 base 9pt라 축소 여지(→8pt)가 작아autofit_columns(가로)가 주력이고 폰트 축소는 보조; base 폰트 큰 폼엔 효과적. README 3스택 정비(python-hwpx 425→171·mcp 599→184·skill 471→178줄) 동반.
[2.22.0] - 2026-07-03
추가
열 너비 조정 (M10 후속, S-064):
hwpx.table_patch.apply_table_ops새 op 2종 —set_column_widths(table_index, widths)(명시적 논리 열너비; 각 셀 cellSz.width = 걸친 열들의 합, 병합 인식)·autofit_columns(table_index)(내용에 맞춰 열너비 재균형: demand = 최장 단일-span 셀 텍스트폭[form_fit어드밴스 모델], sqrt-damped로 문단 열 폭주 방지, 열별 최소폭 floor, 표 총폭 보존). 둘 다 byte-preserving(cellSz만 편집, charPr/header 불변)이며 grid 검증. 배경: 텍스트가 길어지면 한컴이 행 높이를 자동으로 늘려 넘침은 없으나 좁은 열은 촘촘히 wrap됨 — autofit이 내용 많은 열을 넓혀 완화한다(오라클 실증: 운영계획 성취기준 열 14186→16441, wrap 약 16→9줄, 총폭 보존).
[2.21.0] - 2026-07-03
추가
M10 바이트보존 구조적 양식채움 (S-064):
hwpx.table_patch— 2026-07-03 실전 실패(도교육청 평가계획 양식을 재생성으로 채워 서식 파괴)를 드라이버로, S-052 바이트 코어 위에 “양식 채움 층”을 완성.fill_cells(source, cells)—(table_index, row, col)주소로 셀 텍스트를 바이트보존 splice(빈/self-closing 셀 삽입, 다중 문단 셀 전체 교체, 병합 앵커 해석). 미변경 셀·표·섹션은 바이트 동일(원칙 VII), no-op=바이트동일, 미해결 주소는 mutate 없이skipped.표 구조 프리미티브
apply_table_ops(source, ops):delete_column(자유폭 재분배 + 열삭제로 빈 행 생기면 캐스케이드 삭제·rowSpan 붕괴)·delete_row·delete_table·insert_row_by_clone(rowSpan==1 참조행 복제, 서식보존·문단 id 리프레시 — 균등 재생성 금지). 각 편집 후build_grid검증(overlap/hole/oob)으로 무효면 거부(fail-closed, 원칙 VI). 중첩표 거부.실한컴 오라클 게이트
verify_fill(before, after, require=):resolve_oracle+visual_check로 before/after를 실제 한컴 렌더 대조 →render_checked·overflow·overlap(글자겹침)·page_count. 오라클 없으면 정직 degrade(render_checked=False),require=True면 fail-closed. open-safety/HTML 프리뷰를 한컴 수용으로 오인 금지.
비고
오라클 실증: 실제 3학년 양식에서
delete_column(반영비율 7→5열 캐스케이드)·insert_row_by_clone(세부기준 +행, 85병합 표)·content-complete 운영계획 채움이 실한컴에서 서식보존·clean 렌더. MCP 표면(apply_table_ops·verify_form_fill)은 hwpx-mcp-server 2.13.0에서 합류.
[2.20.0] - 2026-07-02
추가
M7 네이티브 자동 차례·상호참조 (S-062):
hwpx.tools.toc_author—add_native_toc(한컴 네이티브TABLEOFCONTENTS필드영역 + Command DSL,dirty=1기본 = 한컴이 처음 여는 순간 항목·차례 스타일·쪽번호를 재계산),add_page_crossref(쪽 번호CROSSREF필드 + 캐시 결과런 — 한컴이 편집/저장 시 자동 재계산),mark_toc_dirty(편집 후 재번호 재트리거),ensure_paragraph_anchor_id/outline_heading_paragraphs. 계약은 실제 한컴 저작 gold pair에서 리버스엔지니어링(tests/fixtures/m7_toc_gold/).차례 충실도 하니스:
hwpx.tools.toc_fidelity—parse_toc_model(하이퍼링크·평문 재생성 항목 모두),structural_report(오라클 없이도 CROSSREF↔차례 캐시 모순으로 stale 탐지),toc_verify(한컴 렌더 대조toc_correctness_ratio, 무오라클 시 정직unverified),grow_paragraph.Mac 오라클 새로고침 레그:
MacHancomOracle.refresh_document(+_refresh_hwpx_mac.applescript) — 열기→dirty 필드 재생성→제자리 저장→닫기. dirty-재생성 직후 같은 세션 PDF export가 이 한컴 빌드를 크래시시키는 실측 때문에 refresh와 render는 의도적으로 별도 세션.
수정
Mac 렌더 스크립트
waitForFile이%%EOF트레일러를 요구 — size>0만으로는 비동기 export 도중의 잘린 PDF를 캡처했다(실측).
비고
E2E 오라클 증명: 저작→새로고침→ratio 1.0(2/5/8쪽) → 재페이지네이션+
mark_toc_dirty→새로고침→ratio 1.0 + 페이지 SHIFT(2/7/10). 실측 수집 규칙:ContentsStyles:0:이 바탕글(스타일 0) 문단도 차례 항목으로 수집 — 본문은 본문(스타일 1) 등 비수집 스타일 권장. MCP 표면(add_toc·add_cross_reference·verify_toc)은 hwpx-mcp-server 2.12.0에서 합류.
[2.19.0] - 2026-07-02
추가
M6 런서식 충실 읽기 하니스 (S-060):
hwpx.tools.read_fidelity—resolve_run_spans(런별 bold/italic/underline/strikeout/color/size_pt/font/super-subscript를 charPr+fontface 해석),collect_notes(각주/미주 본문 + 본문 서식),roundtrip_fidelity/corpus_fidelity(콘텐츠-레벨 라운드트립 충실도),spans_fidelity/notes_fidelity비교기, 공개fontface_maps/run_span. 요소-카운트만 재던roundtrip_diff와 달리 charPr-해석 런-스팬 및 각주 본문의 무손실을 측정한다.strikeout은 shape 속성으로 정규화(항상 존재하는<hh:strikeout shape="NONE"/>가 상시-on으로 오독되던 문제 회피),underlinetypeNONE→None정규화.
비고
코퍼스 런서식 라운드트립 충실도 1.0(4075 런 / hwpxlib 47편). reading 차원 4→5(구조적 corpus-scale, 오라클 불요). 설치 MCP 표면 노출은 hwpx-mcp-server 2.11.0에서 합류.
[2.18.0] - 2026-07-01
추가
M5 개인정보(PII) 마스킹 엔진 (S-059):
hwpx.tools.pii—detect_pii/mask_pii/mask_value/PIIPolicy. 기계검증 세트(주민등록번호·휴대폰·이메일·카드+Luhn)는 항상-on high-confidence, 맥락형(계좌·주소·이름)은 라벨 게이트 low-confidence(과마스킹 방지). 필드 최소화minimize_fields, 가명Pseudonymizer(결정적 토큰맵), 비식별deidentify(불가역 salted-SHA256), 로그 위생PiiLogFilter/scrub_exception_message.메일머지·추출 경로 마스킹:
mail_merge(masking_policy=DEFAULT_POLICY)기본 ON — 명부 산출물의 기계검증 PII 자동 마스킹(마스킹 길이로 FitPolicy 재측정).export_text/export_html/export_markdown(masking_policy=...)opt-in 추출 마스킹(기본None= 내부 placeholder 탐지 보존).
비고
폼필(form-fill) 경로 마스킹·
scan_personal_info·전 경로 0-누출 게이트는 MCP 표면(hwpx-mcp-server) 단계에서 합류합니다.
[2.17.0] - 2026-06-30
추가
M4 변경추적(redline) 저작 (S-058):
HwpxDocument.add_tracked_insert/add_tracked_delete/add_tracked_replace— 에이전트가 변경추적(삽입/삭제/치환)을 작성자·일자와 함께 저작하고, 사람이 한컴 검토 리본에서 개별 수락/거부할 수 있습니다. 헤더trackChanges/trackChangeAuthorssurgical splice(작성자 dedup·표시 플래그) + 본문insertBegin/End·deleteBegin/End마크(charPrIDRef 상속, paraend=0). 한컴 수용성은 measure-first 스파이크로 입증(실 Windows 한컴 COMIsTrackChange=1·opens-clean·roundtrip + 검토 리본 수락→반영/거부→취소 확인).hwpx.tools.redline.verify_redline(before, after, *, oracle=None)— 구조 검증(변경 수·TcId 마크 연결·표시 플래그·opens-clean) +visual_checkrender_checked를 정직하게 fold(오라클 없으면unverified, 거짓 통과 없음).
수정
메모(코멘트) 본문이 숫자로 표시되던 버그:
attach_memo_field가 MEMO 필드 subList에 코멘트 내용 대신 메모 ID(숫자)를 넣어, 한컴이 메모 박스에 숫자를 렌더했습니다. 한컴 오라클 구조에 맞춰 subList에 코멘트 텍스트를 넣고MemoShapeIDRef(기본 65535)로 박스를 연결하도록 수정했습니다(실 Windows 한컴 검증).
비고
수락/거부는 사람이 한컴 검토 리본에서 수행합니다(COM accept 액션 미노출 — 정석 워크플로).
byte-identity: 미수정 part(ZIP 엔트리)는 byte-identical. 수정 섹션 내부의 문단단위 완전 byte-identical(surgical splice)은 stretch로 연기(한컴 렌더·수용엔 무영향).
[2.16.0] - 2026-06-29
추가
M3 문서 작성 (S-057):
create_document_from_plan이document_type(공문/보고서/가정통신문)을 보고 실제 한컴-harvest 프로파일(hwpx.design.compose)로 라우팅합니다. 미매칭 유형은 기존 제로베이스 경로를 유지하고-> HwpxDocument반환 계약을 보존합니다. 공문은 결문 메타document_plan.gyeolmun = {issuer, productionNumber, enforcementDate, disclosure}를 지원합니다.hwpx.design.profiles.home_notice— 실제 가정통신문에서 harvest한 디자인 프로파일.공문 구조 hard-gate:
inspect_official_document_style(source, *, document_type="공문")이 시행문 척추(수신·발신명의·시행·공개구분·끝.)를 ERROR 심각도로 검사하고structure_pass를 반환합니다. 표 셀까지 읽는 table-aware 텍스트 추출(실 시행문의 두문/결문은 표 안에 있음)을 추가했고, 진짜 시행문(tests/fixtures/m3_gongmun_gold/seoul_sihaengmun.hwpx)을 앵커로 삼습니다.inspect_document_authoring_quality에korean_proofing_status(정직unverified/llm_proofed_not_oracle_verified, 거짓 통과 없음)와verify_render=True시 실제 한컴 렌더 영수증render_checked/visual_complete를 추가했습니다.
비고
각주(footnote) 작성은 한컴 렌더가 확인되지 않아 honest-deferred(
unverified) 상태입니다.
[2.15.0] - 2026-06-27
추가
HwpxDocument.set_paragraph_format(keep_with_next=, keep_lines=, page_break_before=)— 문단 keep-together 플래그를 엔진ensure_paragraph_format(break_setting=)로 전달한다(새 paraPr 발행, 기존 paraPr 미수정 = 무손실). 시험지 조판 등에서 한 문항이 단/쪽 경계에서 잘리지 않게 묶을 때 쓴다.hwpx.exam: re-typeset an authored exam (Markdown) into a school form.hwpx— Exam IR + strict md parser, form profiler (role→existing form style), keep-together body composition (insert into the form’s body region, never append; 관리박스 + footer preserved byte-identical), and an oracle convergence drivercompose_exam_into_form. The driver renders via Hancom and, when the composed 문항 are in the extractable text layer, verifies 문항-split / overflow / placeholder integrity (inserting column/page breaks to converge); when they are not (forms whose body Hancom exports as vector curves) or no oracle is available, it returnsrender_checked/splits=None+needs_reviewrather than a silent pass (Constitution V — honest unverified).find_seal_anchor— 발신명의가 좁은 표 셀에서 여러 줄로 wrap된 경우도 앵커를 찾는 fallback(연속 줄 윈도우, 최대 3줄). 단일 줄 매칭이 우선이라 기존 동작 불변; spurious 다중줄 매칭은 윈도우·동일페이지로 차단.
수정
paragraph.add_picture—treat_as_char=True(inline)인데pos_overrides(PAPER relTo/offset)를 주면 모순된 inline/floating<hp:pos>를 방출하던 것을ValueError로 fail-fast. floating 배치는treat_as_char=False에서만.
[2.14.0] - 2026-06-25
추가
hwpx.form_fit.seal— 직인/관인 배치 + 규정 검사(M2 P3).find_seal_anchor(발신명의 줄의 끝글자=도장 중심),check_seal_placement(중심 tol·가림 글자 차별 pass/fail),seal_pos_offsets(PDF pt 앵커→PAPER HWPUNIT offset),place_seal(발신명의 소스 문단—표 셀까지 탐색—에 직인을 floating 스탬프; 오라클 검증 0.12pt, fail-closed, page/clamp 정직신호).hwpx.form_fit.wordbox.extract_image_boxes— 렌더된 PDF에서 임베디드 이미지(직인) rect 추출. 직인은 글자가 아니라 그림이라get_text로 안 잡힘.add_picture(treat_as_char=False, pos_overrides=, text_wrap=)— floating 그림 경로. PAPER 상대<hp:pos>(offset은 xs:nonNegativeInteger로 coerce) +textWrap(직인은IN_FRONT_OF_TEXT로 텍스트 안 밀고 위에 스탬프).mail_merge(fit_policy=, max_lines=)— fit-aware 배치(M2 P4 / FR-004). 각 placeholder 슬롯을 템플릿에서 한 번 측정(template-once-measure, advance-model·오라클 불필요)하고 레코드별로 fit. 넘침/결측 행을needsReview[]/skipped[](reason 코드 + retry advice)로 격리—자동 truncate 없음.[xlsx]extra(openpyxl)로 Excel/명부(.xlsx/.xlsm) 수용.
수정
임베디드 이미지 manifest
<opf:item>에isEmbeded="1"(OWPML 단일-d 철자) 방출 — 없으면 한컴이add_picture로 넣은 모든 그림을 렌더 드롭하던 잠복 버그(한컴 GUI 렌더로 확정).mail_merge가 표 셀 안 placeholder도 치환 —replace_text_in_runs(본문 전용)가 셀 런에 안 닿아 발신·결재/안내 표 안{{토큰}}이 미치환으로 남던 버그.
[2.13.0] - 2026-06-24
추가
hwpx.conformance— VisualComplete 적합성 코퍼스 + 배지 등급(plan §2 Phase G).hwpx-conformance run이 코퍼스를 4개 배지 등급(Open-Safe/Semantic-Safe/Form-Safe/VisualComplete)으로 채점하고 등급별 통과율을 산출합니다. 임계값은 엄격 기본값(구조 등급 100%, 폼셋 overflow 0%, VisualComplete ≥95%). golden 베이스라인(tests/conformance/golden/structural.json) 대비 회귀를 숫자로 감지하며(--check), CI가 구조 등급을 추적합니다. 어슈어런스 등급은 절대 섞지 않습니다(§0.0): 한컴이 없는 구조 실행은 VisualComplete를unverified로 보고하고, 오라클 실행(도달 가능한 한컴 백엔드)만 VisualComplete를 검증합니다. 케이스에before(+선택적editMask)를 선언하면 VisualComplete가 오라클의 before/after diff 경로로 게이트됩니다(마스크 밖 변경·글자 겹침을 잡음).expectVisualDefect는 일부러 깨뜨린 쌍을 positive control로 삼아 게이트가 결함을 실제로 잡는지 검증합니다. (실측: 실제 한컴-저장 코퍼스에서 clean 쌍은 통과, out-of-slot 변경은 catch.)
[2.12.0] - 2026-06-24
추가
hwpx.quality— 단일 저장 게이트SavePipeline,QualityPolicy,VisualCompleteReport. 모든 직렬화 출력이 이 게이트를 통과합니다(무결성·XML·OPC/ID·열림안전·시각 오라클 → 단일 리포트).HwpxDocument.save_report(...)로 노출.hwpx.form_fit— FormFit 엔진(FitPolicy/FitResult). 폼 값이 셀/필드 박스에 맞는지 측정(한글=1.0em, 한컴 실측 보정)해 wrap/shrink/truncate/fail 처리.set_cell_text(fit=...)/fill_form_field(fit_policy=...)로 연결.hwpx.layout— 렌더러 없는 구조적 시각 스모크lint_layout(stale lineseg·dirty/lineseg·overflow risk·표 구조).QualityPolicy.layout_lint로 SavePipeline 하드 게이트로 연결.hwpx.design— 검증된 한컴 저장 템플릿 + harvest 프래그먼트로 새 문서를 생성하는compose/DocumentPlan/profile 빌더.official_notice/report/application_form프로파일 동봉.시각 오라클
hwpx.visual에 Mac 한컴 백엔드(MacHancomOracle) 추가.
[2.11.1] - 2026-06-12
수정
create_document_from_plan()의headingblock과 builderHeading이 기본 템플릿의개요 N/Outline N문단 스타일을 실제로 적용하도록 수정했습니다. 생성 문서가 한컴 개요/문서 탐색과 MCP outline readback에서 구조화된 제목으로 인식됩니다.document-plan 기본 스타일 preset에 제목 18pt, 부제 12pt, 장 제목 14pt 글자 크기와 함초롬바탕 폰트를 적용해 보고서 생성 시 제목/본문 시각 위계가 명확하게 보이도록 했습니다.
[2.11.0] - 2026-06-12
추가
시드 결정적 퍼징 수렴 루프
hwpx.tools.fuzz(시나리오 카탈로그·생성기·3중 오라클 러너·최소화)와tests/fixtures/fuzz_regressions회귀 박제 수트를 추가했습니다.레이아웃 근사 프리뷰 렌더러
hwpx.tools.layout_preview를 추가했습니다(페이지 박스·표·여백 근사 HTML/PNG — 에이전트 자기검증용).section XML 바이트 splice 기반 문단 패치 경로
hwpx.patch를 추가했습니다(미수정 영역 바이트 보존).그림 자산 안전 삽입·치환 API(
add_picture및 치환 워크플로)와 manifest 검증을 추가했습니다.기존 문서 서식 편집 API를 추가했습니다: 문단 정렬·줄간격·들여쓰기·문단 간격, 용지·여백·방향, 머리말/꼬리말·쪽번호, 불릿/번호 형식.
누름틀(클릭히어 필드) 1급 조회·채움 API를 추가했습니다.
공문서 작성규정 lint
hwpx.tools.official_lint(항목기호 위계·”끝.” 표시·붙임·날짜 표기)와 결재란 프리셋을 추가했습니다.고급 생성기
hwpx.tools.advanced_generators를 추가했습니다: 사진대지(build_image_grid)·회의 명패(build_meeting_nameplates)·표 기반 조직도.신구대조 문단 diff와 참조 정합 lint
hwpx.tools.doc_diff를 추가했습니다.메일머지 대량 생성과 표 합계·평균 계산 유틸
hwpx.tools.mail_merge를 추가했습니다.참조 문서 서식 프로파일 추출·적용과 템플릿 레지스트리
hwpx.tools.style_profile을 추가했습니다.template analyzer 리포트를 강화했습니다(열너비 재구성·cell margin·vertAlign).
변경
hwpx.oxml.document모놀리스(5,700여 줄)를 요소별 모듈(_document_impl외 18개)로 분할했습니다. 공개 API는 변하지 않습니다.
수정
신뢰할 수 없는 입력 파싱을 강건화했습니다(
hwpx.opc.security): XML entity 선언 거부와 깊이/크기 한도, ZIP 압축비·멤버 수 한도를 적용해 entity 폭탄·압축 폭탄 입력을 안전하게 거부합니다.
[2.10.3] - 2026-06-09
추가
hwpx.tools.validate_editor_open_safety()와EditorOpenSafetyReport를 추가해 package validation, document validation, 재오픈 검증을 한 곳에서 확인할 수 있게 했습니다.
수정
텍스트를 줄이는 저수준 편집 뒤 stale
hp:linesegarray가 남아 한컴 편집기에서 열리지 않을 수 있는 문제를 막기 위해, 저장 직전 plain-text 문단의 무효한 layout cache를 제거합니다.편집된 section과 public 저수준 section write 경로는 모든
hp:lineSegArraylayout cache를 제거해, 복합 문단처럼 stale 여부를 안전하게 계산하기 어려운 경우도 편집기가 다시 계산하도록 했습니다.public 저수준 section/header XML write 경로도 Hancom-compatible root namespace 선언과
standalone="yes"XML declaration을 보정해 generic XML serializer 출력이 그대로 저장되지 않도록 했습니다.HwpxDocument.to_bytes(),save_to_path(),save_to_stream()이 생성된 패키지의 editor-open safety를 확인한 뒤에만 결과를 반환하거나 쓰도록 보강했습니다.save_to_path()는 safety 실패 시 기존 대상 파일을 교체하지 않습니다.HwpxPackage.save()도 editor-open safety를 기본 검증해 저수준 package 직접 편집이 unsafe HWPX를 bytes/path/stream으로 내보내지 않도록 막습니다.public
HwpxPackage.save()에서 editor-open safety 검증을 우회하는 파라미터를 제공하지 않도록 정리했습니다. 검증 실패 상태의 bytes snapshot은 package 내부 진단 토큰이 있는 경로에서만 생성하며, unchecked 경로는 caller-provided file path/stream에 직접 쓸 수 없습니다.HwpxDocument._to_bytes_raw()의 open-safety bypass 인자를 제거해 document 객체에서 unchecked bytes를 얻는 실수성 우회 경로를 더 좁혔습니다.private archive writer도 save 내부 컨텍스트에서만 동작하게 해,
_write_archive()/_write_zip_entry()직접 호출로 editor-open safety 검증을 건너뛴 ZIP을 만드는 실수성 우회 경로를 막았습니다.문서/package 저장 중 open-safety, 실제 파일 쓰기, stream short write가 실패하면 dirty 상태를 성공처럼 정리하지 않도록 보강했습니다. seek 가능하고 안전하게 복원 가능한 stream은 쓰기 실패 시 원래 내용으로 rollback합니다.
archive pack CLI가 재패킹 결과를 editor-open safety 리포트로 재검증하고, 실패 시 기존 output을 보존합니다. 성공 시
PackResult.open_safety와 CLIopen_safety_ok=true출력으로 handoff evidence를 제공합니다.repair/recover 출력도 CRC와 package validation 뒤에 editor-open safety를 재검증하고, section의
hp:lineSegArraylayout cache 제거와 section/header root namespace 및standalone="yes"보정을 적용합니다. 실패 시 기존 output은 보존하고, 성공 시RepairResult.open_safety로 handoff evidence를 제공합니다.template form-fit apply가 최종 목적지에 먼저 복사하지 않고 temp 파일에서 저장 및 editor-open safety 검증을 끝낸 뒤에만 교체하도록 보강했습니다.
builder
Document.save_to_path()리포트에editor_open_safetyhard gate와 세부 리포트를 포함합니다.template form-fit paragraph clone 경로가 텍스트를 직접 바꿀 때도 layout cache를 제거합니다.
package validator가 실제 텍스트 길이를 넘어서는
lineseg/@textpos를 hard error로 보고하도록 보강했습니다.EditorOpenSafetyReport.ok가 package/reopen뿐 아니라 document validation 실행 실패와 hard error도 반영하도록 보강했습니다.저장 직전 paragraph의
styleIDRef가Normal/본문처럼 header style 이름으로 잘못 들어간 경우, 일치하는 numeric style id로 정규화해 저수준 편집 산출물이 document validation에서 차단되거나 편집기 오픈 리스크를 만들지 않도록 했습니다.HwpxPackage.save(updates=...)같은 순수 package 저수준 저장 경로도 header style 이름으로 된 paragraphstyleIDRef를 numeric id로 정규화해, MCP를 거치지 않는 직접 ZIP/XML 편집 산출물도 같은 safety 보정을 받도록 했습니다.
[2.10.2] - 2026-06-06
추가
hwpx.tools.markdown_export.export_markdown()와HwpxDocument.export_rich_markdown()을 추가해 풍부한 Markdown 변환을 지원합니다. 인라인 서식(굵게/기울임/취소선/색상/하이라이트), 표 병합 셀(colspan/rowspan HTML), 중첩 표 재귀,rect/ellipse/polygon도형 내부 paragraph, BinData 이미지 추출,Ⅰ./1.패턴 기반 헤딩 감지(#/##), 각주·미주(정확 위치 마커 +fn1/en1일련번호 + 본문 인라인 서식), 하이퍼링크([text](url)) 보존을 한 번에 처리합니다. 기존HwpxDocument.export_markdown()은 그대로 유지됩니다.HwpxOxmlNote에 본문 paragraph 접근/편집 helper를 추가했습니다:body_paragraphproperty,add_run(text, *, char_pr_id_ref=..., bold=..., italic=..., underline=..., color=..., font=..., size=..., highlight=..., strike=..., attributes=...),add_hyperlink(url, display_text, *, char_pr_id_ref=...). XML 직접 조작 없이 각주 본문에 혼합 서식 run과 하이퍼링크를 추가할 수 있습니다.get_table_map()결과에 본문 표 anchorlocation, 셀 문단별table_cell_paragraphlocation,caption_text,preceding_paragraph_text를 추가했습니다.새 컨버터와 helper에 대한 회귀 테스트를
tests/test_markdown_export.py에 추가했습니다.
변경
HwpxOxmlTableCell.text가 셀 내부 여러 문단을 줄바꿈으로 보존하고,set_text(..., preserve_format=True, split_paragraphs=True)경로에서 기존 runcharPrIDRef를 유지하도록 개선했습니다.
수정
HwpxOxmlParagraph.add_footnote()/add_endnote()의char_pr_id_ref인자가 외부 호스팅 run에만 적용되고 각주 본문 run은 항상charPrIDRef="0"으로 하드코딩되던 문제를 수정했습니다. 인자가 사용자 의도대로 본문 run에도 적용됩니다.
[2.10.1] - 2026-06-04
추가
document_planauthoring을 builder lowering 중심으로 확장하고 v2 builder node, TOC, government_report preset을 지원합니다.정부보고서 계산/파싱 유틸리티(
hwpx.tools.report_utils,hwpx.tools.report_parser)와 computed field 치환을 추가했습니다.generic element coverage inventory, table cleanup, table profile/caption/unit preservation, id reference integrity checker를 추가했습니다.
linesegarray,transMatrix,scaMatrix,rotMatrix, edit/combo box control을 first-class OXML 모델로 승격했습니다.
변경
builder save report의 hard gate가 id integrity를 실제 검사 결과로 반영하도록 강화했습니다.
패키지 rewrite 시
mimetype엔트리를 보존하도록 OPC 저장 경로를 정리했습니다.
[2.10.0] - 2026-06-02
추가
hwpx.builder공개 패키지를 추가했습니다.Document,Section,Paragraph,Run,Heading,Bullet,NumberedList,Table,Image,Header,Footer,PageNumber,PageBreak,Metadata,PageSize,Margins노드로 조립형 HWPX 생성을 지원합니다.BuilderSaveReport와ReopenReport를 추가해 builder 저장 후 package validation, document error/lint, reopen, feature flags, visual review 필요 여부를 확인할 수 있게 했습니다.머리글/바닥글 리치 content, 자동 쪽번호, 리치 런 서식(color/font/size/highlight/strike), 다단계 목록, 표 병합/음영/열너비, 이미지 배치를 위한
HwpxDocumentfacade 및 OXML wrapper 메서드를 추가했습니다.hwpx.document_plan.v1, 운영 계획서 품질 프로필, template form-fit authoring, proposal/form-fill 품질 검증 흐름을 강화했습니다.hwpxlib sample corpus 기반 oracle fixture와 builder vertical slice 통합 테스트를 추가했습니다.
src/hwpx/tools/_schemas/owpml/에 2011 Hancom 네임스페이스용 subset XSD 번들을 추가했습니다 (header.xsd,body.xsd,paralist.xsd,core.xsd,xml.xsd,NOTICE).hwpx.oxml.load_compound_schema()와SchemaImportError를 추가해 offline compound XSD 로딩을 지원합니다.fixture matrix 기반 Phase 1 validation 리포트(
shared/hwpx/HWPX_STACK_VALIDATION_2026-04-20_pre-phase1.md,..._post-phase1.md)와 회귀 테스트를 추가했습니다.
변경
validate_document().ok는 error 기준으로 유지하고 schema warning은 lint/warning으로 분리해 가시화합니다.HwpxDocument.save_to_path()기반 저장/재오픈 검증 경로를 builder와 authoring workflow에서 일관되게 사용하도록 정리했습니다.hwpx-validate는 이제 기본 strict 모드로 Phase 1 subset schema bundle을 사용합니다.--no-strict로 warning-only 분류를 지원합니다.HwpxDocument.validate()는 기본strict=False로 동작하며,validate_on_save_strict옵션으로 저장 시 strict 검증을 제어할 수 있습니다.패키지 배포물(sdist/wheel)에 OWPML subset schema bundle이 포함되도록 package-data를 확장했습니다.
수정
split-run placeholder, template form-fit, proposal/document-plan 생성 경로의 회귀를 보강했습니다.
builder vertical slice에서 Hancom Office HWP 재오픈과 구조 hard gate가 통과하도록 머리글/바닥글 lowering과 page number control 배치를 정렬했습니다.
[2.9.1] - 2026-04-27
상호운용성(interop) 버그 묶음 릴리즈입니다. 외부 기여자들이 보고하고 수정한 세 가지 문제를 정리합니다.
수정
HwpxOxmlTableCell._ensure_text_element와ensure_run_style내 modifier가 lxml 엘리먼트 상에서 또한ET.SubElement를 호출해TypeError를 발생시키던 경로를 기본 헬퍼_append_child로 정리했습니다. 이제cell.text = ...와paragraph.add_run(..., bold=True)가 monkey-patch 없이 정상 동작합니다 (#30, @hhy827)._paragraph_id/_object_id/_memo_id가uuid4().int & 0xFFFFFFFF로부터 signed int32 범위를 벗어나는 값을 약 50% 확률로 생성하던 문제를 수정했습니다. id 값을 signed 32-bit 양수 범위(0 <= x < 2^31)로 클램프해 downstream 소비자와의 상호운용성을 확보했습니다 (#34, @seonghoony).HwpxDocument.new()의 seed로 쓰이는 번들Skeleton.hwpx에 signed int32 범위를 벗어나는<hp:p id="3121190098">가 포함돼 있던 문제를 수정했습니다 (#35, @seonghoony).pyproject.toml에 PEP 639licenseexpression과 같이 남아 있던 legacyLicense :: OSI Approved :: Apache Software Licenseclassifier를 제거해setuptools>=77에서의 소스 설치/바이너리 빌드 실패를 해소했습니다.
추가
위 세 버그에 대한 회귀 테스트를 추가했습니다 (
tests/test_document_formatting.py,tests/test_id_generator_range.py,tests/test_skeleton_template_ids.py).머지된 기여를 인정하는
CONTRIBUTORS.md를 추가하고README.md/CONTRIBUTING.md에서 연결했습니다.
변경
License relicensed to Apache-2.0 (sole author, full consent). Previous license terms no longer apply to future releases.
[2.9.0] - 2026-04-02
추가
HwpxDocument.get_table_map(),find_cell_by_label(),fill_by_path()를 추가해 HWPX 양식/템플릿 표를 문서 순서 기반으로 탐색하고 채울 수 있게 했습니다.hwpx.tools.table_navigation모듈을 추가해 엔진 레벨에서 재사용 가능한 표 탐색, 라벨 정규화, 방향 이동, 배치 채우기 helper를 공개했습니다.
변경
라벨 매칭이 공백 축약, 대소문자 무시, 후행 콜론 허용 규칙을 따르도록 정규화 로직을 추가했습니다.
표 자동화 API에 대한 회귀 테스트와 README/API 레퍼런스 문서를 추가했습니다.
[2.8.3] - 2026-03-10
변경
저장소와 배포 메타데이터의 라이선스 표기를 실제
LICENSE파일과 일치하도록 정렬했습니다.pyproject.toml을 PEP 639 방식의LicenseRef-python-hwpx-NonCommercial+license-files구성으로 갱신하고, 잘못된 MIT 분류자를 제거했습니다.README 라이선스 배지/섹션을 커스텀 비상업적 라이선스 기준으로 수정하고, wheel/sdist 산출물의 라이선스 메타데이터를 검증하는 회귀 테스트를 추가했습니다.
[2.8.2] - 2026-03-08
변경
README를 현재 공개 API와 CLI 범위에 맞춰 정리했습니다. Quick start, 텍스트 추출, 객체 검색 예시를 실제 호출 방식 기준으로 수정했습니다.
add_memo()/add_memo_with_anchor()가HwpxDocument.new()로 만든 실제lxml기반 문서에서도 동작하도록 memo XML 생성 경로를 엔진 호환 방식으로 정리했습니다.실제 빈 문서 템플릿에서 메모 추가 후 roundtrip 되는 회귀 테스트를 추가했습니다.
[2.8.1] - 2026-03-08
추가
템플릿 자동화 회귀 스위트를 추가했습니다 (
tests/template_automation/). 단순 토큰, 반복 토큰, split-run, 공백 정규화, 표/머리글/바닥글/다중 섹션, 체크박스 토글, extract-repack, 비표준 rootfile 패턴을 대표 fixture + 시나리오 계약으로 점검합니다.DevDoc/template-automation-regression-suite.md를 추가해 스위트의 보장 범위, 한계, fixture 추가 절차를 문서화했습니다.
변경
실제
lxml기반 문서에서set_header_text()/set_footer_text()가 동작하도록 header/footer 생성 경로를 XML 엔진 호환 방식으로 정리했습니다.섹션 속성(
secPr)이 비어 있을 때 보강 생성하는 경로를 XML 엔진 호환 방식으로 정리했습니다.add_section()이 새 섹션을 잘못된 네임스페이스로 만들던 문제를 수정했습니다.mypy/pyright gradual scope에 이번에 추가한 template automation helper/generator 모듈을 포함했습니다.
[2.8] - 2026-03-08
변경
HwpxPackage와 OXML 로딩/저장이 rootfile/manifest-relative 경로를 실제로 따르도록 정렬했습니다.hwpx-analyze-template --extract-dir가 재구성에 바로 쓸 수 있는 작업 디렉터리와.hwpx-pack-metadata.json을 생성하도록 확장했습니다.hwpx-validate-package를 엔진 정합 기준으로 재작성해 dynamic rootfile/manifest 관계, CRC, fallback warning을 구분하도록 했습니다.hwpx-unpack기본값을 raw-byte preserving으로 바꾸고--pretty-xmlopt-in을 추가했습니다.tooling/OPC 회귀 테스트를 확대하고, coverage threshold를 60으로 올렸으며, pyright는 touched OPC/tooling 범위에서
basic으로 상향했습니다.
[2.7.1] - 2026-03-08
변경
공개 저장소와 배포 산출물에서 내부 감사 문서를 제거했습니다.
[2.7] - 2026-03-08
추가
hwpx-unpack,hwpx-pack,hwpx-analyze-templateCLI를 추가했습니다.src/hwpx/tools/archive_cli.py를 추가해 unpack/pack 워크플로를 패키지 레벨 도구로 승격했습니다.unpack 시
.hwpx-pack-metadata.json을 기록하고, pack 시 이를 사용해 원본 ZIP 엔트리 순서/압축 방식을 가능한 범위에서 보존하도록 했습니다.src/hwpx/tools/template_analyzer.py를 추가했습니다.
변경
scripts/office/unpack.py,scripts/office/pack.py,scripts/analyze_template.py를 패키지 도구 래퍼로 정리했습니다.page_guard에 shape/control count 및 히스토그램 비교를 추가하고, 실제 페이지 수 계산기가 아니라 구조 변화 징후 점검 도구임을 문서와 CLI 설명에 명시했습니다.README와
docs/usage.md에 새 CLI 사용 예시를 추가했습니다.새 tooling에 대한 CLI/추출/overwrite/page-guard 회귀 테스트를 강화했습니다.
[2.6] - 2026-03-08
추가
hwpx-validate-packageCLI와hwpx.tools.package_validator를 추가해 ZIP/OPC/HWPX 패키지 구조,mimetype,container.xml, manifest/spine 참조, XML well-formedness를 점검할 수 있게 했습니다.hwpx-page-guardCLI와hwpx.tools.page_guard를 추가해 섹션 수, 단락 수, page/column break, 표 구조, 텍스트 길이 변화량을 기준으로 문서 드리프트를 비교할 수 있게 했습니다.hwpx-text-extractCLI를 추가해 기존TextExtractor기능을 plain/markdown 형태로 바로 사용할 수 있게 했습니다.scripts/office/unpack.py,scripts/office/pack.py,scripts/analyze_template.py를 추가해 XML-first HWPX 작업 흐름을 지원합니다.gap-closure 반영분에 대한 테스트를 추가했습니다 (
tests/test_gap_closure_tools.py).
수정
HwpxDocument.validate()가 내부 직렬화 과정에서 dirty 상태를 지워 버리던 부작용을 제거해, 검증 이후에도 저장 필요 상태가 유지되도록 수정했습니다.
[2.3.1] - 2026-02-28
추가
단락 삭제 API:
paragraph.remove(),section.remove_paragraph(),document.remove_paragraph()메서드를 추가했습니다. 마지막 단락 삭제 시ValueError가 발생합니다.섹션 추가/삭제 API:
document.add_section(after=),document.remove_section()메서드를 추가했습니다. 새 섹션은 manifest/spine에 자동 등록되며, 마지막 섹션 삭제 시ValueError가 발생합니다.네임스페이스 상수 모듈:
hwpx.oxml.namespaces모듈을 추가하여 HP, HH, HC 등 공유 네임스페이스 상수를 제공합니다.새 API에 대한 16개 테스트 케이스를 추가했습니다 (
test_paragraph_section_management.py).
수정
import hwpx만으로DeprecationWarning이 발생하던 문제를 수정했습니다.hwpx.package경고는 이제 사용자가 직접 해당 모듈을 import할 때만 표시됩니다.HwpxOxmlTableCell.text가 셀에 여러 단락이 있을 때 첫 번째 텍스트만 반환하던 버그를 수정했습니다. 모든<hp:t>요소의 텍스트를 결합하여 반환합니다.add_hyperlink()메서드에서 사용되지 않는field_inst_id변수를 제거했습니다.deprecated
save()호출을 사용하던 테스트 코드를save_to_path()/save_to_stream()으로 업데이트했습니다.
[1.9] - 2026-02-18
변경
hwpx.__version__하드코딩 값을 제거하고importlib.metadata.version("python-hwpx")기반으로 노출하도록 정리했습니다.editable/로컬 소스 실행처럼 배포 메타데이터가 없는 환경에서도 동작하도록
PackageNotFoundErrorfallback(0+unknown)을 추가했습니다.
[0.1.0] - 2025-09-17
추가
hwpx.opc.package.HwpxPackage와hwpx.document.HwpxDocument를 포함한 핵심 API를 공개했습니다.텍스트 추출, 객체 탐색, 문서 유효성 검사 등 도구 모듈과
hwpx-validateCLI를 제공합니다.HWPX 스키마 리소스와 예제 스크립트를 번들링해 바로 사용할 수 있도록 했습니다.
설치 가이드, 사용 예제, 스키마 개요 등 배포 문서를 정리했습니다.