Index
2026-09-06 — Progress

강의 노트북 마크다운 미니멀화 (KO/EN) + 배포 커널 이름 버그

AI899 | 01_robot_loop_and_vla 마크다운 41셀 → 제목 + 불렛 + 그림 · 빌더 --keep-outputs · kernelspec 고정

TL;DR

55 %
KO 마크다운 (28.2k → 15.5k 자)
51 %
EN 마크다운 (41.8k → 21.5k 자)
33/33
outputs 보존, 에러 0
74 / 6
cells / 문제 (변화 없음)
1
배포 버그 (kernelspec)

1 배경 / 목적

완성본을 읽은 사용자의 요구: "처음엔 제목, 밑에 불렛으로 데이터셋: 로보카사, 모델: 파이0.5 …, 다룰 목차 리스트. 그 뒤 소제목 딱, 밑에 핵심만 불렛이나 짧은 문장, 그림." 1시간 수업에서 강사가 말하며 넘기는 자료이므로 읽는 문단이 오히려 방해.

이전에 열려 있던 질문 "마크다운을 원문 유지로 되돌릴까" 는 이 결정으로 닫힘 — 원문도 재작성본도 아닌 미니멀.

2 작업 내용

마크다운 재작성 규칙

도구

tmp/md_ko_v2.py, tmp/md_en_v2.py # BLOCKS 41개 tmp/patch_md.py builder.py blocks.py # md(r"""...""") 를 순서대로 교체 (개수·""" 검사) python scripts/build_notebook.py --keep-outputs # 기존 실행본 outputs 이식 (code 셀 소스 불일치 시 중단) python scripts/make_student_nb.py ... ; bash scripts/make_code_zip.sh

kernelspec 버그

nbconvert 실행에 쓴 로그인 전용 커널(vla-lecture-wrapper)의 이름이 실행본 metadata 에 남았고, 빈칸본 생성기는 metadata 를 그대로 복사하므로 배포 zip 까지 그 이름으로 나갔다. 빌더 조립 단계에서 {"name": "vla-lecture", "display_name": "VLA (강의)"} 로 항상 덮어쓰도록 고정. EN 빌더는 원래 리터럴로 고정돼 있어 영향 없음.

3 결과

KOEN
마크다운 글자 수28,190 → 15,461 (55 %)41,807 → 21,504 (51 %)
셀 / 문제74 (md 41 / code 33) / 6동일
outputs 보존 · 에러33/33 · 033/33 · 0
그림 참조 / 에셋8 / 7 모두 존재8 / 7
kernelspecvla-lecture-wrapper → vla-lecturevla-lecture
zip3,168,614 B3,164,250 B
EN 마크다운 한글 0셀. 백업: tmp/build_notebook_{ko,en}_prev.py, tmp/01_{ko,en}_solution_prev.ipynb.

4 Takeaway

5 Next