Files
GhiVideo_v4/docs/history/2026-07-03_1250_SVG빈줄-그림깨짐-수정.md
b23042andClaude Fable 5 d38b842e8d GhiVideo 소스 복제 — v4 작업 시작 기준
기존 GhiVideo 저장소 HEAD의 트래킹 소스 362개 파일을 복제.
(node_modules·storage·빌드 산출물·대용량 미디어는 .gitignore 규칙대로 제외)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-09 14:32:51 +09:00

1.5 KiB

SVG 내부 빈 줄로 인한 그림 깨짐(빈 화면) 수정

소요 시간: 약 10분 Context 사용량: input ~125k / output ~6k tokens

증상

  • 「쉬운설명_프레임기반에서_측점기반_플레이어」 3절 새 그림이 HTML/PDF에서 빈 상자로 나오고, 그림 속 글자들이 그림 밖 본문에 줄글로 쏟아짐 (사용자 스크린샷 제보).

원인

  • pandoc(gfm)은 raw HTML 블록을 빈 줄에서 종료함 → <svg> 내부에 빈 줄이 있으면 블록이 쪼개져 이후 <text> 등의 내용이 마크다운 본문으로 처리됨.
  • 직전 작업(3절 그림 개선)에서 가독성용 빈 줄 4개를 SVG 안에 넣은 것이 직접 원인. 추가로 1절 기존 그림(41행)에도 동일 문제 잠재.

수정

  1. docs/쉬운설명_프레임기반에서_측점기반_플레이어.md — SVG 내부 빈 줄 5곳 제거 (41, 72, 86, 91, 113행). 주석(<!-- -->)은 빈 줄 없이는 무해하므로 유지.
  2. 전수 검사(awk, docs/*.md 전체)로 동일 문제 추가 발견: 발표_GhiVideo_좌표투영과_측점기반재생.md 117행 → 제거.
  3. 두 문서 md2docs.sh 재변환.

검증

  • md 전수 검사: SVG 내부 빈 줄 0건.
  • 생성 HTML 파이썬 검사: svg 블록 제거 후 본문에 그림 전용 문구 누출 없음 (두 문서 모두), 3절 svg에 text 25개 정상 포함.

재발 방지 메모

  • SVG를 md에 인라인할 때 <svg>...</svg> 사이에 빈 줄 금지. 구획 구분은 빈 줄 대신 주석 한 줄로.