第3讲:每道题嵌题目级双向链接

之前只有点末一张「本点关联」表,做题时想回查某一节、或跳到别处同类题,
得先滚到文件底部。现在 24 道题每题末尾都有一行:

> **关联** · 盘点 §2.1 判据总表 [§1.3 定义] | 上游 — |
> 下游 [点 2 题 1 求秩] | 速查 [十个判据]

四个方向:盘点(定义定理出处)、上游(做这题前要先会)、
下游(这个结论在哪被用)、速查(考前十分钟)。24 题共 96 条出链。

反向索引由同一份映射自动生成,保证对称不漏:
- 盘点 §0.4 从「章节 ↔ 练习文件」升级为「章节 ↔ 题目」,23 节 42 条
- 速查卡「回查」同样升级到题目级,8 条 24 条

锚点规则(实测 Gitea,两条方向相反,容易踩):
  标题 id = user-content- + 小写化(空格→-,其余标点全删)
  同文件 #anchor            → Gitea 自动补前缀
  跨文件 file.md#user-content-anchor → Gitea 不补,必须手写
含公式的标题也核过:`## 问题 3 · 抽象:$AB=O$ 能推出什么`
→ user-content-问题-3--抽象abo-能推出什么($ 与 = 都被删)。

新增 check_md_links.py:校验 md 内部链接的目标文件与锚点是否存在。
本次 11 个文件 235 条链接全部命中,0 异常。
README 补「文件之间怎么跳」「锚点怎么写」两节。
This commit is contained in:
2026-10-23 17:23:23 +08:00
parent 5c51bab7d4
commit 2b1788bea9
13 changed files with 210 additions and 44 deletions
@@ -57,18 +57,42 @@ tags: [数学一, 在学练习, 线性代数, 向量, README]
## 文件之间怎么跳
每个点文件底部都有一张「本点关联」表,四个方向:
跳转做了三级,粒度从粗到细:
| 粒度 | 在哪儿 | 什么时候用 |
|---|---|---|
| **册** | 每个点文件底部「本点关联」表 | 判断这个点在知识体系里的位置 |
| **题** | **每道题末尾的「关联」行** | 做这道题卡住时,缺什么立刻跳走 |
| **节** | 盘点 §0.4、速查卡「回查」表 | 从某个知识点反查"它在哪几道题里练过" |
每道题末尾的关联行长这样:
> **关联** · 盘点 §2.1 判据总表、§1.3 定义 | 上游 — | 下游 点 2 题 1 求秩 | 速查 十个判据
四个方向:
| 关系 | 作用 |
|---|---|
| **盘点** | 回查这个点的定义、定理全表 |
| **上游** | 读这个点之前应该已经会什么 |
| **下游** | 这个点的结论在哪儿被用到(含后面几讲) |
| **速查** | 跳到 `10-速查卡` |
| **盘点** | 这道题用到的定义、定理在哪一节 |
| **上游** | 做这道题之前应该先会哪道题 |
| **下游** | 这道题的结论在哪儿被用到(含后面几讲) |
| **速查** | 考前十分钟要背的那一条 |
反方向也通:`01-知识点盘点` 的 §0.4 有一张「章节 ↔ 练习」对照表,用来回答"这个知识点在哪个文件里练";`10-速查卡` 末尾有「回查」表,用来回答"这条判据的完整出处在哪"。
所以每道题**既有出链也有入链**:盘点 §0.4 和速查「回查」两张表,是按每道题的关联行**反向生成**的,不会漏题也不会错挂。全部用相对路径链接,Gitea 网页里可以直接点,Obsidian / Logseq 里会进反向链接面板。
全部用相对路径链接:**Gitea 网页里可以直接点,Obsidian / Logseq 里会进反向链接面板**。所以"盘点 ↔ 点 ↔ 速查"三者构成一个闭环,不是单向目录。
## 锚点怎么写(Gitea 两条方向相反的规则)
跳到某一节或某一题要手写锚点,规则是实测出来的,两条例外方向相反,很容易踩:
标题 id $=$ `user-content-` $+$ 标题原文小写化(保留字母数字汉字与下划线,空格变 `-`,**其余标点全部删除**)。
| 链接类型 | 写法 | 原因 |
|---|---|---|
| 同文件 | `#问题-2--变换后的向量组` | Gitea 渲染时**会自动**补 `user-content-` |
| 跨文件 | `03-点2-秩与极大无关组.md#user-content-问题-1--…` | Gitea **不会**补,必须手写 |
`·` 两侧各有一个空格,所以锚点里是两个连字符 `--`。写完用
`python .workbuddy/tools/md2pdf/check_md_links.py <目录>` 校验,锚点对不上会逐条报出来。
## 与其他讲的接口