SciBook — 대학 인터랙티브 과학 교과서

science.euiyun.com — 대학 강의 과목 하나가 교과서 한 권이 되는 한국어 인터랙티브 과학 교과서 플랫폼입니다. 읽고, 수식을 따라가고, 시뮬레이터로 직접 실험하며 이해합니다. books.euiyun.com 시리즈의 자매 사이트입니다.

교과서	주소	상태
일반화학 (General Chemistry)	/general-chemistry/	초판 — 6부 20장 + 부록 3
일반물리학 · 유기화학 · 유체역학	—	예정 (로드맵)

구조

engine/                 공통 교과서 엔진 (과목 무관)
  js/scibook.js         레이아웃·검색·테마·자동 번호·자동 채점 연습문제·드릴·진도·시뮬레이터 헬퍼
  css/scibook.css       디자인 토큰(라이트/다크)과 컴포넌트
  lib/elements.js       원소 118종 자료 (화학·물리 공용)
  lib/chem.js           화학 라이브러리: 화학식·몰 질량·반응식 균형·주기율표·VSEPR·3D 분자
general-chemistry/      과목 = 교과서 한 권
  course.json           매니페스트(부·장 목록, 색) ← 사람이 고침
  course.js             생성 파일
  index.html            과목 홈(목차·강의 계획)
  chapters/*.html       장 본문
catalog.json            플랫폼의 과목 목록
index.html              플랫폼 홈(서가·대표 실험·읽는 순서)
home.css, home.js       플랫폼 홈 전용 스타일·책장 필터·표지 그림
img/sims/               홈의 대표 실험 카드 스크린샷
tools/build.py          매니페스트 → 생성 파일·SEO·sitemap, 콘텐츠 규칙 검사
tools/smoke.mjs         Playwright 스모크 테스트
tools/new_course.py     새 과목 뼈대 만들기
docs/                   ARCHITECTURE · CONTENT-GUIDE · ROADMAP

설계 원칙은 docs/ARCHITECTURE.md, 장 작성 규칙은 docs/CONTENT-GUIDE.md를 보세요.

실행

빌드 없는 정적 사이트입니다. 저장소 루트에서:

python3 -m http.server 8000      # → http://localhost:8000/general-chemistry/

KaTeX·three.js·폰트는 CDN에서 불러오므로 인터넷 연결이 필요합니다.

수정 후

python3 tools/build.py           # course.js·catalog.js·목차 카드·SEO 태그·sitemap 갱신 + 규칙 검사
npm i --no-save playwright [email protected] [email protected] && npx playwright install chromium
node tools/smoke.mjs http://localhost:8000          # 전 페이지 검사 (특정 장만: 두 번째 인자에 slug)

CI(.github/workflows/check.yml)가 같은 검사를 실행합니다.

용어집과 본문 뜻풀이

본문의 .term과 정의 문단을 수정하고 python3 tools/build.py를 실행하면 용어집과 course.js의 glossary 데이터를 함께 갱신합니다. 본문에서 용어에 마우스를 올리거나 키보드로 포커스하거나 모바일에서 탭하면 같은 정의를 확인할 수 있습니다. 공통 동작과 스타일은 engine/js/glossary-tooltips.js, engine/css/glossary-tooltips.css입니다. 데이터 형식은 시리즈 공통 v1이며, 각 항목은 ko(이름), en(영문명), abbr(약어), def(정의), chapters(관련 장 목록)를 갖습니다. 이름이 반복되면 한 번만 표시하고, 묶음 항목은 가리킨 이름을 제목에 표시하며 구분에 필요한 비교 설명을 함께 제공합니다.

라이선스

코드는 MIT, 교재 콘텐츠는 CC BY 4.0. 적용 범위는 라이선스 안내를 참고하세요.