我想把它部署成在线阅读站点，最短路径是什么？

用 [Jupyter Book](https://jupyterbook.org) 本地 build 出静态产物，然后用静态托管发布；把发布动作放进CI，确保每次合并都能自动生成可访问版本。

如何让多人协作写教材时不互相踩文件？

把章节切成更小的文件单元，约定命名与目录结构，并要求所有改动走PR评审；对图片、数据与引用建立统一规范，减少合并冲突。

可以。典型做法是同时保留静态站点与离线工件（HTML/PDF），并在发布时将工件归档到release或固定下载入口，方便教学场景分发。

✕传统痛点	✓创新方案
课程资料常散落在在线编辑器/网盘/聊天记录里：版本混乱、难审阅、难回滚，长期维护成本爆炸。	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 分支或指定目录