学习站点 是做什么的?
构建交互式、单文件 HTML 学习页面,作为“制品”发布(或在无法使用“制品”的地方保存为 .html 文件)。每个页面都从 assets/template.html 开始,因此永远不会遗漏标准功能。
0. 设置 — 根据自身情况编辑
| 设置项 | 值 |
|---|---|
| 主索引 URL(连接所有课程的枢纽) | none — 设置为你自己的枢纽 URL,或保留 none 以跳过索引更新 |
| 默认主题 | light(始终包含暗色切换按钮) |
| 章节导航 | 仅返回课程索引的链接 — 不包含上一页/下一页链接 |
| 索引卡片样式 | 极简:图标、课程代码、课程名称 — 无统计数据 |
1. 先提问(一轮问题)
仅询问请求中尚未明确的点:
- 这是针对某门课程的吗? 如果是:哪门课程、哪个章节或哪部分内容。课程页面会在标准功能基础上增加考试模式和复习工具;非课程页面(通用主题、一次性讲解)则跳过这些功能。
- 它应该被列在哪里? 直接在主索引上、在某个课程的学习索引内(哪个索引)、或者不列入任何地方。如果主索引设置为
none,则跳过此问题。 - 如果不知道课程学习索引的 URL,请询问 — 页面的“返回”链接需要它。
如果用户保存了关于他们希望如何教授某门课程的笔记(备忘录、项目说明、之前的信息),请阅读并遵循它们,覆盖下述默认设置。
2. 在构建前收集材料
- 完整阅读每个附件:幻灯片、笔记、历年试卷、练习题。
- 收集属于每个主题的历年试题(PYQ)和练习题。
- 静默修正原始材料中的错误;除非被要求,否则不要指出它们。
- 只有在此之后,再规划主题列表:每个逻辑主题一个
<section class="topic">,足够小以便一口气完成。
3. 教学规则(所有学科)
- 假设无先验知识。从基础开始构建,首次使用时定义每个术语,细化而非压缩。
- 每个主题内的顺序:讲解 → 紧跟其图解 → 图解说明 → 示例 → PYQ/练习题 → 练习选择题。 切勿将图解批量放在末尾。
- 每个图解都必须配有说明。绝不发布没有说明的图解。
- 使用
.callout.imp标记考试重点,使用.callout.mistake标记常见陷阱。 - 题目: 完整写出每道题目,然后给出解答,切勿缩写。回答所有题目;不留任何未解答的题目。用来源、年份和分值标记 PYQ(例如
PYQ 2024 期中 · 5分)。 - 每个主题至少 3 道练习选择题,包含似是而非的干扰项和
.why解释。 - 图解使用内联 SVG,绝不用 ASCII。对于逐步演进的内容,使用
.stepper(每个状态一个figure.fig.step)。 - 除非被要求,否则不制定学习计划或日程安排。
4. 按学科调整
| 学科类型 | 重点 |
|---|---|
| 理论 / 证明(计算理论、离散数学、算法) | 每个自动机的状态图;追踪输入字符串的步进器;证明模板(泵引理、归约、归纳法)作为填空步骤;许多小例子 |
| 系统(操作系统、计算机体系结构、网络) | 视觉优先;流水线、调度甘特图、页面置换、缓存查找的步进器;逐步求解的数值题;教科书章节末习题 |
| 语言 / 形式化符号(程序设计语言、编译器) | 干净的 SVG 树形图的 BNF/EBNF、语法分析树和属性文法;逐步构建正则表达式;内联解答的练习题 |
| 数学密集型(机器学习、统计学、信号) | 先直觉,然后逐行推导,每一步都要有理由;SVG 绘图;带有解答的教科书习题 |
| 描述性(生物学、管理学、人文学科) | 以历年试卷为驱动:按主题分组 PYQ,以考试长度提供模型答案,使用流程图和比较表进行流程讲解 |
对于未列出的学科,选择最接近的一行。用户自己的课程笔记优先于本表。
5. 页面功能(内置于模板中)
| 功能 | 工作原理 | 你的职责 |
|---|---|---|
| 浅色主题 + 暗色切换 | 默认为浅色;🌙 切换;记住选择 | 仅使用 CSS 变量 — 不要硬编码颜色 |
| 滚动位置恢复 | 保存并在重新打开时恢复滚动位置 | 无需操作 |
| 进度跟踪 | 每个主题“标记为已完成”,进度条,目录中的 ✓ | 每个主题部分设置唯一的 id |
| 搜索 | 过滤主题并高亮匹配项 | 无需操作 |
| 复制图像 | 每个 figure.fig 上的悬停按钮可复制 PNG(触摸设备上始终可见) | 将每个图解或图像包裹在 figure.fig 中 |
| 移动端友好 | 响应式;表格横向滚动 | 保持基于 viewBox 的 SVG;不使用固定宽度 |
| 练习选择题 | 即时反馈;记住答案 | data-answer = 正确选项的 0 基索引 |
| 显示答案 | details.answer | 用于每个长形式解答 |
| 返回链接 | 页眉链接到课程学习索引 | 填写 {{COURSE_INDEX_URL}} |
| 仅课程页面: 复习工具 | 速查表(.cheatsheet)+ 闪卡(.flashdeck) | 公式、定义、关键图表的单页摘要;10 张以上闪卡 |
| 仅课程页面: 考试模式 | 模糊显示直到点击开始;计时器;提交时批改选择题;显示模型答案 | 混合使用带 data-marks 的选择题和仿照课程历年试卷风格的长问题;设置 data-minutes |
进度和分数存储在浏览者的浏览器中,每个页面独立 — 索引页面无法显示章节进度,并且无法跨设备同步。
6. 设计规则
- 极简且平静。正文使用衬线字体以便长时间阅读,UI 使用无衬线字体。内容宽度约 820px。
- 避免 AI 生成内容的俗套:无紫色渐变、英雄横幅、全居中布局、Inter 字体或表情符号五彩纸屑。
- 颜色承载含义:蓝色 = 信息,金色 = 考试重要,红色 = 错误,绿色 = 正确/完成。
- SVG 图解:标注所有元素;使用
var(--text)、var(--accent)等作为描边和填充;文本在移动端宽度下 ≥ 12px。
7. 课程学习索引页面
对于课程索引或枢纽:极简卡片(见设置),相同页眉(搜索 + 主题切换),滚动恢复,浅色默认主题。
8. 构建、发布、检查
- 复制
assets/template.html,填写{{占位符}},对于非课程页面删除课程专属区块(对于课程页面则取消注释)。 - 作为“制品”发布(或保存为
.html)。先展示页面;发布后检查。 - 在桌面端和约 390px 宽度下检查,并在两种主题下检查:每个图形都有复制按钮,每个选择题都有正确的
data-answer,每个问题都有答案,没有剩余的{{占位符}}。 - 按照步骤 1 中选择的位置,将页面链接添加到主索引或课程索引中。不要重新设计索引页面。