关于
课程是一门手艺,
不是一篇文章。
页间课堂想给每个概念找到一个非动不可的画面。一屏只讲一件事,随时能停; 学习者自己控制节奏。
六条不能删的原则
- 一屏只讲一件事。一屏里出现两个中心概念,就拆成两屏。屏幕不是容器,是节拍。
- 动画要承担论证。动画用来展示关系、过程、因果和变化。删掉之后论证还完整,就不要让它动。
- 先直觉,后术语。先给一个具体例子,再给它名字。不用定义解释定义。
- 每一屏都能停下来读。关键信息不能只存在于运动里。暂停后要看得懂,讲义里要读得到。
- 课程是独立作品。每门课有自己的封面、素材、播放器和 URL,不依赖网站存在。
- 网站退后,课程向前。网站是封面和索引,进入课程之后,界面应该安静下来。
一门课怎么做出来
-
01
先写脚本
学习者是誰、学完能做什么、每屏一句话论题、看见什么、动画如何论证。没有脚本,不写 HTML。
-
02
再做动画
一屏一个 scene,逐屏做、逐屏检查。每屏看 0%、50%、90% 三个时间点,确认最后停在稳定帧。
-
03
最后构建和验收
构建成独立静态包,在站点和普通静态服务器上各走一遍;键盘、讲义、深链、减少动态效果都要过。
技术骨架
站点是 FastAPI + Jinja2,服务端渲染;课程是独立的静态包,用 HyperFrames 播放 GSAP 时间轴。 课程内容在文件里,用户与会话在 SQLite;课程包不依赖数据库也能完整播放。 运行时不引用 CDN,字体、播放器、动画库全部随课程分发。
课程页可以脱离网站单独部署。这意味着它不能被锁进某个平台,也不会因为网站改版而失效。
致谢
- HyperFrames:HTML 动画与浏览器内播放器,Apache-2.0。
- GSAP:动画时间轴。
- Noto Sans SC:中文正文字体,SIL Open Font License。
- FastAPI 与 Jinja2:站点后端与模板。
课程内容参考了公开的论文、官方博客和产品文档;事实口径与来源随课程记录。