fix(page): write a column definition ahead of its paragraph's text

[airmang]

바뀐 점

문단에서 새 단을 시작하는 단 정의(doc.page.set_columns(..., paragraph=...), HwpxOxmlParagraph.add_column_definition)를 문단의 글보다 앞에 쓴다. 전에는 글 뒤 런에 써서, 글이 있는 문단에서는 한/글이 새 단을 적용하지 않았다.

구역의 첫 문단이면 단 정의를 더하지 않고, 구역 설정 런에 있는 단 정의를 그 자리에서 고쳐 쓴다. 첫 문단에 단 정의가 하나 더 있으면 한/글이 문서를 열지 못한다.

한/글의 동작

• 한/글이 만든 문서는 문단의 단 정의를 그 문단의 첫 런에 둔다. 구역의 첫 문단이면 구역 설정 다음이다.
• 단 정의가 문단의 글 뒤에 있으면 새 영역만 열고 단은 적용하지 않는다. 그 문단과 뒤 글이 본문 폭으로 놓인다.
• 글 없는 문단이면 한/글이 단 정의를 글 런 앞으로 옮겨 저장하고 새 단을 적용한다.
• 구역의 첫 문단에 구역 설정 옆 단 정의 말고 단 정의가 하나 더 있으면, 1단 정의라도 한/글이 문서를 열지 못한다.

고치기 전

p = doc.add_paragraph("단 시작") 뒤에 doc.page.set_columns(2, paragraph=p)를 부르면 [t "단 시작"][ctrl colPr]로 썼다. 한/글은 이를 [t, ctrl, t]로 저장하고, 그 문단과 뒤 글을 1단(본문 폭)으로 놓았다.

구역의 첫 문단에 부르면 구역 설정 옆 단 정의는 그대로 두고 단 정의를 하나 더 써서, 한/글이 문서를 열지 못했다.

코드

• oxml/paragraph.py의 add_column_definition
  • 단 정의의 런을 만든 뒤, 구역 설정 런이 아닌 첫 런 앞으로 옮긴다.
  • 구역의 첫 문단이면 구역 설정 런의 단 정의를 고쳐 쓴다. 문단을 주지 않은 set_columns와 같은 길이고, 돌려주는 개체는 그 단 정의의 조판 부호다.
• 구역 설정 런의 글을 따로 떼어 내던 도우미(_paragraph_text_edit.split_section_carrier_content)는 이 경우에만 쓰였으므로 지운다.
• _document/layout.py의 set_columns 설명에 첫 문단 경우를 적는다.
• 변경 로그 항목을 더한다.

테스트

tests/test_section_columns.py에 시험을 더하고, 한/글 저장본 셋을 함께 넣는다.

• 저장본: 다섯째 문단에서 2단을 시작한 문서
  • 단 정의를 글 뒤에 쓴 것(고치기 전): 한/글은 정의를 글 뒤에 둔 채 저장했고, 뒤 줄들이 본문 폭(42520)이다.
  • 빈 문단에 쓴 것: 한/글은 정의를 글 런 앞으로 옮겨 저장했고, 뒤 줄들이 2단 폭(20660)이다.
  • 이제 쓰는 꼴(정의가 글 "단 시작" 앞): 한/글이 그대로 저장했고, 그 문단과 뒤 줄들이 2단 폭이다.
• 단 정의가 글이 있는 문단과 빈 문단 모두에서 첫 런에 쓰이는지 시험한다.
• 구역의 첫 문단이면 단 정의가 구역 설정 런의 것 하나뿐이고 새 단 수로 바뀌는지, 저장 뒤 다시 열어도 그런지 시험한다. 구역 설정 런에 글이 함께 있는 첫 문단도 시험한다.

고친 뒤 만든 문서는 한/글에서 열리고 단이 의도대로 그려지는 것을 확인했다. 구역 설정 런에 글이 있는 새 문서, 한/글이 저장한 문서, 빈 첫 문단은 첫 문단부터 2단이고, 둘째 문단에서 시작한 단은 둘째 문단부터 2단이다.

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

🤖 Generated with Claude Code