关于
一个用交互实验台讲乐理的静态站:每个概念都配一个能拖、能听、能看见结果的台子。
它解决什么问题。乐理书上的话大多是对的,但读起来像在背条文: "纯五度是 3:2"——然后呢?这个站的做法是把每一句话做成一个能动手的东西: 泛音列可以一个一个关掉听,五度的音分可以拖着看整圈会不会合上, 卡农的四个声部可以看着它们依次进来。
怎么用。从第 0 节顺着走最省力, 因为后面的每一节都假设你听过前面那些声音。找正文里的某个说法用搜索, 想查某个词就翻术语表, 想看某个作品怎么拆就跳到课程地图的第三部分。
四个部分。
关于声音。全站没有任何音频文件: 声音都是浏览器里当场合成的(加法合成 + Karplus-Strong 拨弦 + 噪声打点)。 所以站点很小、加载很快,代价是音色不像真乐器。 谱例图是用 MuseScore 命令行渲染的,也没有外部字体依赖。
许可与引用。这个站是开源的:代码 MIT,教学内容 CC BY-SA 4.0。 转载、改编、拿去上课都可以,署名并以相同方式共享即可。
这个项目按"正规维护"来跑:main 不直接提交,每个改动一条分支 + 一个 PR,
合并前必须过 CI(跑数据审计)。三条底线写在
仓库的
CONTRIBUTING.md 里:
一 · 数据可核对。页面里的速度、调性、拍号、时长、署名、日期, 要么有出处,要么变成审计里的一条断言。凭记忆写下来的数字不收。
二 · 页面要快。单图不超过 400KB,不引入外部依赖, 能不用二进制的就不用。
三 · 交互必须有反馈。点了要看得见它在响、在走、还是结束了。
作品分析是会长大的模块。第三、四部分不编号——
插一首曲子只要在课程表里加一行,不用动别人。完整流程见
docs/新增一首曲子.md:
codex/<主题>,定它放在哪一层;去仓库开 issue,三类模板随你挑: 交互问题(按钮、滑块、播放)、内容错误(乐理说法、数字、出处)、 新曲目提案。内容错误最好带上"你认为正确的是什么", 我们会把这条错误变成审计里的一条防线。
python3 scripts/serve.py 5200 # 本地预览,禁缓存 node scripts/audit-music.mjs # 数据审计(乐理数字、页面、编号、实验台注册) node scripts/check-links.mjs # 外链体检(需代理的站加 --proxy)
维护历史记着每个版本加了什么,也是这个项目怎么长起来的流水账。