fix(page): write unequal column widths as shares of 32768

[airmang]

바뀐 점

너비가 다른 단(doc.page.set_columns(same_size=False, column_widths=...))의 너비와 간격을 한/글이 읽는 꼴로 쓴다. 쪽 수 추정(실험, estimate_pages)도 같은 규칙으로 단 너비를 센다.

한/글의 동작

• hp:colSz의 width와 gap은 HWPUNIT이 아니라 본문 폭을 32768로 나눈 몫이다.
• 한/글은 단을 width × 본문 폭 / 32768 폭으로 놓는다. 값들의 합이 얼마든 그렇게 놓고, 합으로 나누지 않는다.
• 한/글이 만든 문서는 합이 늘 32768이다. 그래서 단과 간격이 본문을 꼭 채운다.

고치기 전

• column_widths를 받은 그대로 썼다.
• 본문 폭(A4에서 42520)에 맞춰 HWPUNIT으로 준 [(20000, 1000), (21520, 0)]은 한/글에서 단이 약 1.3배 넓게 놓였다(25952, 27925). 둘째 단은 종이 밖까지 나갔다.
• 쪽 추정은 단 너비를 값들의 합으로 나눠 셌다. 한/글이 만든 문서에서는 결과가 같았고, 합이 32768이 아닌 문서에서만 달랐다.

코드

• oxml/section_format.py: column_shares와 COLUMN_SHARES(32768)를 더한다.
  • column_widths를 비율로 받아, 같은 비율로 합이 32768이 되는 몫으로 바꾼다. 몫의 경계마다 반올림해서 합이 늘 32768이다.
  • 본문 폭에 맞춘 HWPUNIT 값은 그 너비 그대로 나온다. 합이 이미 32768인 값은 바뀌지 않는다.
  • 값이 0 이상의 int가 아니거나, 모두 0이거나, 쌍이 두 값이 아니면 거부한다. 오류 코드는 page-column-widths-value다.
• 구역의 단(set_columns), 문단의 새 단(add_column_definition), 퍼사드(doc.page.set_columns)가 무엇도 바꾸기 전에 몫을 구한다.
• layout/pages.py의 _columns는 단 너비를 width × 본문 폭 / 32768로 센다.
• errors.py와 docs/error-codes.md에 코드를 등록하고, 변경 로그 항목을 더한다.

테스트

• tests/test_column_widths_as_shares.py를 더하고, 한/글 저장본 셋을 함께 넣는다.
  • 둘은 같은 두 단을 고치기 전처럼 [(20000, 1000), (21520, 0)](합이 본문 폭)과 [(16000, 768), (16000, 0)](합 32768)로 쓴 것이다. 한/글이 그 단들의 줄을 width × 42520 / 32768 폭으로 놓았는지, 쪽 추정이 같은 폭을 내는지 시험한다.
  • 하나는 [(20000, 1000), (21520, 0)]을 이제 쓰는 몫 [(15413, 771), (16584, 0)]으로 쓴 것이다. 한/글이 줄을 20000과 21520 폭으로 놓았는지 시험한다.
  • HWPUNIT 값이 몫으로 쓰이고, 쪽 추정으로 준 너비 그대로 나오는지 시험한다. 구역의 단과 문단의 새 단을 모두 본다.
  • 이미 몫인 값과 단순 비율이 합 32768로 쓰이는지 시험한다.
  • 잘못된 값이 오류 코드와 함께 거부되고 문서가 그대로인지 시험한다.
• tests/test_section_columns.py: 너비가 다른 단의 기대값을 몫(15413, 771, 16584, 0)으로 바꾼다.

이 PR은 #415, #416, #417 위에 쌓았다. 앞 PR이 병합되면 그 커밋들은 이 PR의 diff에서 빠진다.

🤖 Generated with Claude Code