온라인 읽기 사이트로 배포하는 가장 짧은 길은?

[Jupyter Book](https://jupyterbook.org)로 정적 산출물을 만든 뒤 정적 호스팅에 배포하라. 배포를 CI에 넣어 머지마다 접근 가능한 버전을 자동 생성하라.

여럿이 쓰면 충돌을 어떻게 줄이나?

장을 더 작은 파일로 쪼개고 네이밍/구조를 표준화한다. 모든 변경은 PR 리뷰를 거치고 이미지·데이터·레퍼런스 규칙을 통일해 충돌을 줄인다.

가능하다. 정적 사이트와 오프라인 아티팩트(HTML/PDF)를 함께 운영하고, 릴리스나 고정 다운로드 경로로 산출물을 아카이브해 배포한다.

✕기존 문제점	✓혁신적 솔루션
강의 자료가 편집기/드라이브/채팅에 흩어지면 버전 혼란, 리뷰 부재, 롤백 불가로 유지비가 급증한다.	cs249r_book는 교재를 리포지토리로 고정해 장/자산/예제를 하나의 Git 워크플로로 관리하고, 변경을 리뷰·비교·회귀 가능하게 만든다.
빌드·배포 파이프라인 없이 문서로만 남기면 포맷 드리프트, 링크 깨짐, 플랫폼별 읽기 경험 차이가 커진다.	Jupyter Book로 빌드·테마를 표준화하고 정적 배포로 ‘작성→빌드→배포’를 자동화 가능한 파이프라인으로 만든다.

bash

1git clone https://github.com/harvard-edge/cs249r_book.git && cd cs249r_book && python -m venv .venv

bash

1source .venv/bin/activate && pip install -U pip && pip install -r requirements.txt

bash

1jupyter-book build .

bash

1# _build/html/index.html 열기 또는 로컬 정적 서버로 확인

bash

1# CI로 _build/html 을 pages 브랜치/설정된 폴더로 배포

핵심 시나리오	대상 고객	솔루션	최종 결과
강의팀을 위한 유지보수 가능한 교재 사이트	강사/조교	장·과제·정오표를 저장소로 협업 관리	리뷰·롤백이 가능해 배포가 안정된다
사내 교육을 위한 버전 관리 강의 노트	교육 담당자	노트·예제·학습 경로를 사이트로 고정	기수별 추적과 일관성이 좋아진다
자기주도 학습용 오프라인 자료	학습자/스터디	클론 후 로컬 빌드로 오프라인 열람	플랫폼 의존을 줄이고 자료를 오래 보관한다