[보관] 문서 제목 자리 A·B·C

세 안과 장단점

A Title 만

경계 밖 role 이 Title 인 노드에만 싣는다. 없으면 싣지 않는다.

실리는 후보 85,719행 · 38.8%

본문 문단·각주·버튼·시각 같은 엉뚱한 자리에 제목이 들어가는 일이 없다. 렌더한 사례 중 C 에서 이상해 보인 13건 가운데 12건이 사라진다. 남는 1건은 Title role 자체가 틀린 경우다.
규칙이 가장 짧다. 규약에 「후보의 Title 자리」 한 줄로 적을 수 있다.
Subtitle·Highlight 로 태깅된 진짜 제목 자리(머리글, 리본, 허브, 헤드라인)에서 제목을 잃는다. 그 자리에는 「"강조할 내용을 입력해주세요."」 같은 임시 문구가 크게 남는다.
C 보다 6,431행(전체의 2.9%)이 제목을 못 싣는다.
Title role 이 붙었지만 실제로는 옆 카드 머리글인 자리는 못 막는다. 이건 B·C 도 같다.

B Title → Subtitle

Title 이 없으면 Subtitle 까지 본다. 둘 다 없으면 싣지 않는다.

실리는 후보 85,840행 · 38.9%

C 에서 이상해 보인 13건 가운데 11건을 피하면서 Subtitle 머리 자리는 살린다. 렌더한 Subtitle 4건 중 3건이 자연스러웠다.
데이터에서는 사실상 A 와 같다. Title 없이 Subtitle 이 있는 후보는 121행(0.05%)뿐이고, 질의 7개의 상위 50위 350건에서는 0건이었다.
A 의 단점이 그대로 남는다. Highlight 로 태깅된 제목 자리는 여전히 잃는다.
Subtitle 이 메시지 아래 작은 보조 줄이면 제목이 메시지보다 작게 들어간다(위계 역전).

C 지금 구현

Title 이 없으면 Subtitle·Description·Highlight 를 한데 모아 위치·글자 크기 점수로 고른다.

실리는 후보 92,150행 · 41.7%

제목이 가장 많이 실린다. Highlight 리본·허브·헤드라인, Description 인데 큰 말풍선 같은 실제 제목 자리를 살린다.
코드를 바꾸지 않는다. 규약에 지금 동작을 적기만 하면 된다.
Description 자리는 대개 본문·설명·각주라 제목이 작게, 항목 아래에, 또는 여러 칸 중 하나에만 들어간다. 렌더한 Description 11건 중 9건이 이상해 보였다.
Highlight 도 배지·버튼에 들어간다. 렌더한 Highlight 5건 중 2건이 그랬다.
지금 코드는 댓글의 「title → subtitle → description 순서」가 아니다. 아래 상자를 본다.

지금 구현(C)은 순서대로 내려가지 않는다. titleCandidatePool 은 경계 밖에 Title 이 하나라도 있으면 Title 중에서만 고르고, 없으면 Marker 와 비본문 role(Decoration·Separator·Annotation·Background)을 뺀 나머지 전부를 한 후보 묶음으로 본다. 그래서 Subtitle·Description·Highlight 가 같은 자격으로 위치·글자 크기 점수를 겨룬다.

Subtitle 이 다른 role 과 함께 있는 후보는 25행뿐이라 순서 차이는 거의 드러나지 않는다. 반면 Highlight 가 후보에 들어간다는 점은 크다. 질의 5개를 3000위까지 돌렸더니 Description·Highlight 만 있는 후보에서 C 가 고른 자리가 Description 253건, Highlight 80건이었다. 규약에 C 를 적는다면 Highlight 를 넣을지도 함께 정해야 한다.

근거: packages/comp-frame-shared/src/forked/titleCandidate.ts titleCandidatePool, Rust 쌍둥이 rust/comp-pass/crates/comp-frame-core/src/title_candidate.rs (miricanvas-iui origin/main 04585231b)

v2.6 데이터에서 얼마나 갈리나

스냅샷 v2.6 의 frame 행(검색 후보) 220,847행을 제목 자리로 나눴다. A·B·C 가 갈리는 건 「경계 밖 Subtitle 만」과 「경계 밖 Description·Highlight 만」 두 줄이다.

후보의 제목 자리	행	비율	A	B	C
위성 Title (정렬 rule f 가 짝짓는다)	15,962	7.2%	실음	실음	실음
경계 밖 Title 있음	69,757	31.6%	실음	실음	실음
경계 밖 Subtitle 만 (Title 없음)	121	0.05%	안 실음	실음	실음
경계 밖 Description·Highlight 만 Description 3,434 · Highlight 1,621 · 둘 다 1,255	6,310	2.9%	안 실음	안 실음	실음
제목을 넣을 후보 노드 없음	128,697	58.3%	안 실음	안 실음	안 실음

실제 검색 결과에서도 비슷하다. 손으로 쓴 질의 7개(HighlightedMessage·Cycle·Steps·List·Timeline·Versus·BigNumber)의 상위 50위 350건을 나눴더니 위성 Title 30건, 경계 밖 Title 98건, Subtitle 만 0건, Description·Highlight 만 16건, 후보 없음 206건이었다. 상위권에서 A 와 C 가 갈리는 결과는 350건 중 16건(4.6%)이다.

Subtitle 만 있는 후보는 상위권에 거의 오지 않는다. HighlightedMessage 질의를 3000위까지 늘려도 Subtitle 만 있는 결과는 5건(1183·1558·1567·1595·2409위)이었고, Description·Highlight 만 있는 결과는 169건이었다.

안별 썸네일

각 카드는 왼쪽이 템플릿 원본, 오른쪽이 그 안을 적용한 대치 결과다. 제목을 싣지 않는 안에서는 제목 자리로 골랐을 노드에 role 임시 문구가 들어간다. 같은 사례가 안마다 다른 묶음에 들어가므로, 탭을 바꿔 가며 같은 do_id 를 비교하면 된다.