b23042andClaude Fable 5
d38b842e8d
기존 GhiVideo 저장소 HEAD의 트래킹 소스 362개 파일을 복제. (node_modules·storage·빌드 산출물·대용량 미디어는 .gitignore 규칙대로 제외) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
29 lines
1.5 KiB
Markdown
29 lines
1.5 KiB
Markdown
# 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>` 사이에 빈 줄 금지.** 구획 구분은 빈 줄 대신 주석 한 줄로.
|