Merge develop: 블로그 truncate 배치 개선 [skip-notion]

Author: sungbin1015

scripts/notion_to_md.py

@@ -675,6 +675,28 @@ def save_sync_map(mapping):
         json.dump(mapping, f, ensure_ascii=False, indent=2)
 
 
+def _insert_truncate_marker(body):
+    """블로그 excerpt 경계용 <!--truncate--> 삽입.
+
+    선행 제목(#...)은 excerpt에 남기고, 첫 실제 콘텐츠 블록이 끝나는 지점 뒤에
+    마커를 넣는다. 콘텐츠 블록이 없으면(제목/빈 줄만) 원본을 그대로 반환한다.
+    section-break 구분선을 excerpt 경계로 오인하지 않는다.
+    """
+    if "<!--truncate-->" in body:
+        return body
+    lines = body.split("\n")
+    i = 0
+    while i < len(lines) and (lines[i].strip() == "" or re.match(r"#{1,6}\s", lines[i])):
+        i += 1
+    if i >= len(lines):
+        return body
+    j = i
+    while j < len(lines) and lines[j].strip() != "":
+        j += 1
+    head = "\n".join(lines[:j])
+    tail = "\n".join(lines[j:]).lstrip("\n")
+    return head + "\n\n<!--truncate-->\n\n" + tail
+
 
 def save_doc_page(page, position, existing_map, parent_slug=None, is_parent=False):
     """Notion 페이지를 Markdown 파일로 저장한다.
@@ -763,16 +785,8 @@ def save_doc_page(page, position, existing_map, parent_slug=None, is_parent=Fals
     safe_title = title.replace('"', '\\"')
 
     if BLOG_MODE:
-        # truncate 마커 삽입: Notion 구분선 우선, 없으면 첫 단락 뒤에 자동 삽입
-        if "\n---\n" in body:
-            body = body.replace("\n---\n", "\n\n<!--truncate-->\n\n", 1)
-        else:
-            stripped = body.lstrip("\n")
-            match = re.search(r"\n\n", stripped)
-            if match:
-                offset = len(body) - len(stripped)
-                pos = offset + match.end()
-                body = body[:pos] + "<!--truncate-->\n\n" + body[pos:]
+        # truncate 마커 삽입: 선행 제목은 excerpt에 남기고 첫 콘텐츠 블록 뒤에 삽입
+        body = _insert_truncate_marker(body)
 
         authors_list = read_multi_select(props, NOTION_PROPERTY_AUTHORS)
         if not authors_list:

scripts/tests/test_notion_to_md.py

@@ -759,3 +759,75 @@ def test_link_preview_empty_url(self):
         }
         result = self._render(block)
         assert result == ""
+
+
+# ── 블로그 truncate 마커 배치 (_insert_truncate_marker) ──────────────────────
+
+class TestInsertTruncateMarker:
+    """BLOG_MODE excerpt 경계용 <!--truncate--> 삽입 규칙.
+
+    규칙: 선행 제목(#...)은 excerpt에 남기고, 첫 실제 콘텐츠 블록 뒤에 삽입.
+    """
+
+    def _split(self, body):
+        result = n._insert_truncate_marker(body)
+        assert result.count("<!--truncate-->") == 1
+        excerpt, rest = result.split("<!--truncate-->", 1)
+        return excerpt, rest
+
+    def test_leading_heading_then_paragraph(self):
+        # 05번 글 케이스: 빈 제목 뒤 첫 문단이 excerpt에 포함되어야 함
+        body = "### **개요**\n\n개발 과정에서 달마다 글을 작성하기로 했다.\n\n다음 문단.\n"
+        excerpt, rest = self._split(body)
+        assert "### **개요**" in excerpt
+        assert "개발 과정에서 달마다 글을 작성하기로 했다." in excerpt
+        assert "다음 문단." not in excerpt
+        assert "다음 문단." in rest
+
+    def test_leading_list_block(self):
+        # 06번 글 케이스: 선행 제목 없이 불릿 리스트가 첫 콘텐츠 → 리스트 전체가 excerpt
+        body = "- 프로젝트 소개\n- Qwen3.6 VLM 적용기\n\n### 프로젝트 소개\n본문\n"
+        excerpt, rest = self._split(body)
+        assert "- 프로젝트 소개" in excerpt
+        assert "- Qwen3.6 VLM 적용기" in excerpt
+        assert "### 프로젝트 소개" not in excerpt
+        assert "### 프로젝트 소개" in rest
+
+    def test_multiple_leading_headings(self):
+        body = "# 제목\n\n## 소제목\n\n첫 문단.\n\n둘째 문단.\n"
+        excerpt, rest = self._split(body)
+        assert "# 제목" in excerpt
+        assert "## 소제목" in excerpt
+        assert "첫 문단." in excerpt
+        assert "둘째 문단." not in excerpt
+
+    def test_paragraph_first_no_heading(self):
+        body = "첫 문단.\n\n둘째 문단.\n"
+        excerpt, rest = self._split(body)
+        assert "첫 문단." in excerpt
+        assert "둘째 문단." not in excerpt
+
+    def test_image_as_first_content_block(self):
+        body = "### 개요\n\n![image](/img/x.png)\n\n본문 텍스트.\n"
+        excerpt, rest = self._split(body)
+        assert "### 개요" in excerpt
+        assert "![image](/img/x.png)" in excerpt
+        assert "본문 텍스트." not in excerpt
+
+    def test_divider_not_treated_as_boundary(self):
+        # section-break 구분선이 첫 문단보다 뒤에 있으면 excerpt는 첫 문단까지만
+        body = "### 개요\n\n첫 문단.\n\n---\n\n### 다음 섹션\n내용\n"
+        excerpt, rest = self._split(body)
+        assert "첫 문단." in excerpt
+        assert "다음 섹션" not in excerpt
+
+    def test_already_has_truncate_unchanged(self):
+        body = "### 개요\n\n<!--truncate-->\n\n본문\n"
+        assert n._insert_truncate_marker(body) == body
+
+    def test_only_headings_no_content(self):
+        # 콘텐츠 블록이 없으면 마커 삽입하지 않음
+        body = "### 개요\n\n### 다른 제목\n"
+        result = n._insert_truncate_marker(body)
+        assert "<!--truncate-->" not in result
+        assert result == body