fix(translate): 이미지 마크다운 전체를 placeholder로 보호 [skip-notion]

DeepL(tag_handling=html)이 self-closing 태그 뒤 닫는 괄호를 다음 줄로
밀어내 이미지 구문이 깨지는 문제. URL만 감추던 방식을 ![alt](url) 전체를
감추는 방식으로 변경하고 _protect_images/_restore_images로 분리.

테스트 3건 추가.

Author: sungbin1015

scripts/tests/test_translate_to_en.py

@@ -0,0 +1,42 @@
+import os
+import re
+import sys
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+import translate_to_en as T
+
+
+def test_protect_images_hides_parens_from_translation():
+    """이미지 마크다운 전체가 placeholder로 치환되어 DeepL이 괄호를 못 본다."""
+    body = "본문\n\n:::\n\n![image](/img/blog/x/img-00.png)\n\n뒷 문장"
+    protected, store = T._protect_images(body)
+    assert "![image](" not in protected          # 괄호가 노출되지 않음
+    assert "/img/blog/x/img-00.png" not in protected
+    assert len(store) == 1
+
+
+def test_restore_images_survives_deepl_paren_relocation():
+    """DeepL이 self-closing placeholder 앞뒤로 빈 줄을 삽입해도(실제 버그 재현)
+    복원 후 이미지 마크다운이 한 줄로 온전히 살아난다."""
+    body = "본문\n\n:::\n\n![image](/img/blog/x/img-00.png)\n\n뒷 문장"
+    protected, store = T._protect_images(body)
+    key = next(iter(store))
+    # DeepL이 태그를 다른 줄로 밀어낸 상황 시뮬레이션
+    deepl_out = protected.replace(key, f"\n\n{key}\n\n")
+    restored = T._restore_images(deepl_out, store)
+    assert "![image](/img/blog/x/img-00.png)" in restored
+    # 닫는 괄호 없이 끊긴 이미지 라인이 없어야 함
+    assert not re.search(r"!\[[^\]]*\]\([^)\n]*$", restored, re.MULTILINE)
+
+
+def test_protect_images_multiple_and_korean_path():
+    """여러 이미지 + 한글 경로 보존."""
+    body = (
+        "![image](/img/blog/09-맥락-기반/img-00.png)\n\n"
+        "가운데\n\n"
+        "![image](/img/blog/09-맥락-기반/img-01.png)"
+    )
+    protected, store = T._protect_images(body)
+    assert len(store) == 2
+    restored = T._restore_images(protected, store)
+    assert restored == body

scripts/translate_to_en.py

@@ -65,6 +65,27 @@ def _restore_code_blocks(body, store):
     return body
 
 
+def _protect_images(body):
+    """이미지 마크다운 전체(![alt](/url))를 placeholder 태그로 보호.
+    URL만 보호하면 DeepL(tag_handling=html)이 self-closing 태그 뒤 ) 를
+    다음 줄로 밀어내 이미지 구문을 깨뜨린다 — 구문 전체를 감춰 괄호를 못 보게 한다."""
+    store = {}
+
+    def _sub(m):
+        key = f'<x id="IMG{len(store)}"/>'
+        store[key] = m.group(0)
+        return key
+
+    protected = re.sub(r'!\[[^\]]*\]\((/[^)]+)\)', _sub, body)
+    return protected, store
+
+
+def _restore_images(body, store):
+    for key, val in store.items():
+        body = body.replace(key, val)
+    return body
+
+
 def _protect_inline_code(body):
     store = {}
     result = []
@@ -384,15 +405,9 @@ def _protect_ol(m: re.Match) -> str:
         return f'{m.group(1)}{key}. '        # group 1 = leading spaces
 
     body_protected = re.sub(r'(?m)^( *)(\d+)\. ', _protect_ol, body_protected)
-    # Protect image URLs — DeepL translates Korean path segments (e.g. /img/milvus-설치-.../)
-    _img_store: dict[str, str] = {}
-
-    def _protect_img(m: re.Match) -> str:
-        key = f'<x id="IMG{len(_img_store)}"/>'
-        _img_store[key] = m.group(2)
-        return f'![{m.group(1)}]({key})'
-
-    body_protected = re.sub(r'!\[([^\]]*)\]\((/[^)]+)\)', _protect_img, body_protected)
+    # Protect images — hide the whole ![alt](/url) so DeepL can't translate Korean
+    # path segments nor relocate the closing ) onto a new line (breaks the image)
+    body_protected, _img_store = _protect_images(body_protected)
     translated = translate_with_deepl(body_protected) if body_no_inline.strip() else body_protected
     for key, num in _ol_store.items():
         translated = translated.replace(key, num)
@@ -431,8 +446,7 @@ def _protect_img(m: re.Match) -> str:
     en_body = _restore_code_blocks(en_body, code_store)
     for key, val in _bq_store.items():
         en_body = en_body.replace(key, val)
-    for key, url in _img_store.items():
-        en_body = en_body.replace(key, url)
+    en_body = _restore_images(en_body, _img_store)
     # Safety net: DeepL relocates blockquote '> ' marker mid-sentence
     # e.g. "If an>  `code` ..." → "> If an `code` ..."
     en_body = re.sub(r'^([A-Za-z][^>\n]*\S)(> +)(\S)', r'> \1 \3', en_body, flags=re.MULTILINE)