fix(layout): keep an empty paragraph's line above its object offset down

[airmang]

바뀐 점

쪽 수 추정(실험, estimate_pages)에서, 개체 하나만 든 빈 문단에 그 개체가 위아래 배치로 문단 위에서 아래로 띄워져 있을 때 한/글처럼 놓는다. 전에는 그 문단을 '띄운 거리 + 개체 높이'만큼 높은 한 줄로 세어, 뒤의 모든 줄을 개체 아래로 보냈다.

한/글의 동작

• 빈 문단의 줄은 개체가 어디 있든 제자리에 있다. 개체의 띠가 그 줄의 아래끝보다 위에서 시작하면, 그 줄은 폭 0인 빈 조각이 된다.
• 뒤 줄은 보통 간격으로 놓이다가, 띠와 겹치는 첫 줄부터 띠 아래끝으로 간다.
  • 겹침은 줄 위쪽이 띠 아래끝보다 위이고, 줄 아래끝(줄 간격은 빼고)이 띠 위쪽보다 아래인 경우다.
  • 띠 아래로 간 첫 줄은 띠 아래끝에 놓이고, 그 뒤는 보통 간격으로 이어진다.
• 표와 그림이 같다.
• 공백 하나라도 든 문단은 글 문단이라 그 줄 자체가 띠와 겹치면 띠 아래로 간다(전과 같음).

고치기 전

빈 문단 위에서 3000·10000·18196 아래에 둔 6000 높이의 표나 그림 뒤에서는, 띠 위에 들어갈 줄들까지 개체 아래로 갔다. 띄운 거리가 줄 하나보다 작으면 뒤 줄이 어차피 띠에 닿아, 결과가 한/글과 같았다.

코드

layout/pages.py

• _pushing_object가 개체 하나만 든 빈 문단(글·부호·각주·머리 번호 없음)도 받는다(bare). 띄운 거리 0인 개체는 전처럼 문단의 줄이다.
• 이 규칙은 개체의 띠가 그 문단 줄의 간격(줄 높이 + 줄 간격) 아래에서 시작할 때만 쓴다(_clear_of_its_band). 그보다 위에서 시작하면 다음 줄이 어차피 띠에 닿아, 전처럼 개체를 문단의 줄로 놓아도 결과가 같다.
  • 그런 문단은 쪽을 넘는 흐르는 표처럼 전 방식이 이미 다루는 경우를 그대로 둔다.
• _Para.bare: 그런 문단의 빈 줄은 자기 개체의 띠에 닿아도 제자리에 둔다. _push(그림 등)와 _Paginator._banded(흐르는 표)가 그 줄을 띠에서 뺀다.
• 흐르는 표는 홀로 둔 표처럼 문단의 앞 간격 위 문단 위쪽부터 띄운 거리를 잰다.
• 모듈 설명과 변경 로그를 고친다.

테스트

tests/test_layout_page_estimate.py의 HANCOM_PAGES에 한/글 저장본 열아홉을 더한다. 캐시가 있을 때와 없을 때 모든 줄 위치와 쪽 수를 시험한다.

• 공통 꼴: 10pt 160% 글 3줄, 넷째 줄인 빈 문단에 6000 높이의 표나 그림을 d 아래에 둠, 뒤에 글 30줄
• 빈 문단: 표·그림 각각 d = 0, 500, 1000, 1600, 3000, 10000, 18196. 표 18196에 글 60줄로 쪽을 넘는 판도 있다.
• 공백 문단(대조): 표 0·500·3000, 그림 3000

고치기 전에는 d = 3000·10000·18196인 일곱 판이 두 모드에서 틀렸다. 나머지는 고치기 전에도 맞고, 규칙의 경계를 지킨다.

이 PR은 #414 위에 쌓았다. #414가 병합되면 그 커밋들은 이 PR의 diff에서 빠진다.

🤖 Generated with Claude Code