记忆:标题禁含公式、gen_crosslinks 单一数据源、速查卡KP唯一归属

This commit is contained in:
2026-10-24 16:38:50 +08:00
parent 41b36b2b3c
commit 48188d921e
2 changed files with 44 additions and 1 deletions
+42
View File
@@ -0,0 +1,42 @@
# 2026-10-24
## 线性代数第4—6讲补全(知识点带题)
用户要求「线代其他章节内容补全」,明确「第一讲就不用了」(已建的半成品目录删除)。
### 产出
| 讲 | 目录 | 文件 | 题量 | 最大文件 |
|---|---|---|---|---|
| 第4讲 线性方程组 | `线性代数-第4讲-线性方程组/` | 11 | 43 | 01-知识点盘点 14027 字符 |
| 第5讲 特征值与特征向量 | `线性代数-第5讲-特征值与特征向量/` | 10 | 35 | 01-知识点盘点 11832 字符 |
| 第6讲 二次型 | `线性代数-第6讲-二次型/` | 10 | 30 | 08-点7-二次曲面 9564 字符 |
第4讲旧版(01-考点手册 / 02-试题 / 03-解析 / PDF/)整体 `mv` 进 `旧版-题点分离/`,git 记为 rename。
### 校验结果
- `check_md_links.py`:第4讲 248 条、第5讲 207 条、第6讲 184 条内部链接,**全部 0 异常**
- `fix_gitea_math.py --check`:三讲均 **0 处待修**
- 所有 md < 1.3 万字符
### 新工具:`.workbuddy/tools/md2pdf/gen_crosslinks.py`
单一数据源 = 点文件里的题目标题 `### 题 N · X.Y:短标题(★★☆)`,幂等生成三样东西:
1. 每题末尾 `> **关联** · 盘点 §X.Y | 上游 | 下游 | 速查`(四向都指向具体题目锚点)
2. 盘点 `<!-- AUTO:KP -->` 之间的 §0.4「知识点 ↔ 题目」表
3. 速查卡 `<!-- AUTO:回查 -->` 之间的回查表
`--check` 只统计不写。速查卡定位按文件名含「速查卡」搜索,不硬编码文件名。
### 踩坑(本轮新增)
- **标题里不能出现 `$...$`**:`### 题 4 · 4.1:$A^{\mathrm T}A$ 的正定性` 生成的锚点是 `题-4--41amathrm-ta-的正定性`,与 Gitea 实际渲染的标题文本可能不一致 → 全部改成纯文字(如「乘积矩阵的正定性」)。
- **速查卡 `<!-- KP: 2.2 -->` 只能出现在一个小节**:词典后写覆盖前写,把 2.2 同时挂在「四 正交变换五步」和「十一 四处最容易丢分」上,结果所有 2.2 的题都链到「十一」。
- **gen_crosslinks 的点文件正则 `^0[2-9]-` 会把 `09-速查卡.md` 也算进去**,但它没有题目标题,不影响 order 编号的正确性(只要速查卡排最后)。
### 遗留
- **第2讲(矩阵,64 题)、第3讲(向量,47 题)没有题目级关联行**,也没有 AUTO 标记。而且它们的题目标题是 `### 题 1 · 判据①:…`(不带 `X.Y` 编号),gen_crosslinks 解析不了,要升级必须改标题 + 挂知识点编号。等用户决定。
- 第3讲 点1 目录里同时存在 `02-点1-线性相关与无关.md`、`-知识点带题示范.md`、`-考研试写.md` 三个版本(仅「考研试写」有 7 条关联行),需清理。
+2 -1
View File
@@ -32,8 +32,9 @@
- **Gitea 锚点规则(两条方向相反,极易踩)**:标题 id $=$ `user-content-` $+$ 小写化(保留字母数字汉字与下划线,空格→`-`,**其余标点全删**,`·` 两侧空格 → 两个 `-`) - **Gitea 锚点规则(两条方向相反,极易踩)**:标题 id $=$ `user-content-` $+$ 小写化(保留字母数字汉字与下划线,空格→`-`,**其余标点全删**,`·` 两侧空格 → 两个 `-`)
- **同文件**写 `#问题-2--变换后的向量组` —— Gitea 渲染时**自动**补 `user-content-` - **同文件**写 `#问题-2--变换后的向量组` —— Gitea 渲染时**自动**补 `user-content-`
- **跨文件**写 `03-xxx.md#user-content-问题-1--…` —— Gitea **不补**,必须手写前缀 - **跨文件**写 `03-xxx.md#user-content-问题-1--…` —— Gitea **不补**,必须手写前缀
- 含公式的标题同样适用:`## 问题 3 · 抽象:$AB=O$ 能推出什么` → `user-content-问题-3--抽象abo-能推出什么` - **标题里禁止出现 `$...$`**(2026-10-24 定):公式会让锚点漂移、Gitea 渲染文本与源码不一致,锚点算不出来。标题一律写纯文字(`### 题 4 · 4.1:乘积矩阵的正定性`)
- 校验:`python .workbuddy/tools/md2pdf/check_md_links.py <目录>`(查目标文件与锚点是否存在) - 校验:`python .workbuddy/tools/md2pdf/check_md_links.py <目录>`(查目标文件与锚点是否存在)
- **`gen_crosslinks.py`**(2026-10-24 建):单一数据源 = 题目标题 `### 题 N · X.Y:短标题(★★☆)`,幂等生成 ①每题关联行 ②盘点 `<!-- AUTO:KP -->` 之间的 §0.4 表 ③速查卡 `<!-- AUTO:回查 -->` 之间的回查表。`--check` 只统计。**速查卡里同一个 `<!-- KP: x.y -->` 只能挂在一个小节**(后写覆盖前写)
## 工具链(本项目自建,可复用) ## 工具链(本项目自建,可复用)