关于

课程是一门手艺,
不是一篇文章。

页间课堂想给每个概念找到一个非动不可的画面。一屏只讲一件事,随时能停; 学习者自己控制节奏。

六条不能删的原则

  1. 一屏只讲一件事。一屏里出现两个中心概念,就拆成两屏。屏幕不是容器,是节拍。
  2. 动画要承担论证。动画用来展示关系、过程、因果和变化。删掉之后论证还完整,就不要让它动。
  3. 先直觉,后术语。先给一个具体例子,再给它名字。不用定义解释定义。
  4. 每一屏都能停下来读。关键信息不能只存在于运动里。暂停后要看得懂,讲义里要读得到。
  5. 课程是独立作品。每门课有自己的封面、素材、播放器和 URL,不依赖网站存在。
  6. 网站退后,课程向前。网站是封面和索引,进入课程之后,界面应该安静下来。

一门课怎么做出来

  1. 01

    先写脚本

    学习者是誰、学完能做什么、每屏一句话论题、看见什么、动画如何论证。没有脚本,不写 HTML。

  2. 02

    再做动画

    一屏一个 scene,逐屏做、逐屏检查。每屏看 0%、50%、90% 三个时间点,确认最后停在稳定帧。

  3. 03

    最后构建和验收

    构建成独立静态包,在站点和普通静态服务器上各走一遍;键盘、讲义、深链、减少动态效果都要过。

技术骨架

站点是 FastAPI + Jinja2,服务端渲染;课程是独立的静态包,用 HyperFrames 播放 GSAP 时间轴。 课程内容在文件里,用户与会话在 SQLite;课程包不依赖数据库也能完整播放。 运行时不引用 CDN,字体、播放器、动画库全部随课程分发。

课程页可以脱离网站单独部署。这意味着它不能被锁进某个平台,也不会因为网站改版而失效。

致谢

课程内容参考了公开的论文、官方博客和产品文档;事实口径与来源随课程记录。