记忆:题级双向链接与 Gitea 锚点两条相反规则

This commit is contained in:
2026-10-23 17:24:17 +08:00
parent 2b1788bea9
commit b4f2588895
2 changed files with 40 additions and 1 deletions
+33
View File
@@ -58,3 +58,36 @@ README.md 结构说明 + 三轮读法
- 网页核验:01/06/07/10 四个文件残留 `$` 全为 0
**待定**:第 2 讲、第 4 讲仍是最早的三件套结构,等用户确认新格式后按同一套重做。
## 题级双向链接(同日,第3讲)
用户要求:双向链接不能只在每个点底部,要**嵌到每道题里**,便于随时跳转。
**做法**:24 道题每题末尾加一行
```
> **关联** · 盘点 [§2.1 判据总表](…) | 上游 [点 1 题 1](…) | 下游 [点 2 题 1 求秩](…) | 速查 [十个判据](…)
```
四向:盘点(定义定理出处)/ 上游(做这题前要先会)/ 下游(结论在哪被用)/ 速查(考前十分钟)。
24 题共 96 条出链。反向索引由同一映射自动生成:盘点 §0.4 升级为「章节 ↔ 题目」(23 节 42 条),速查「回查」升级到题目级(8 条 24 条)。
**Gitea 锚点规则实测(关键,两条方向相反)**:
| 链接 | 写法 | 结果 |
|---|---|---|
| 同文件 `[x](#测试-2-乙)` | 不加前缀 | Gitea 自动补成 `#user-content-…` ✅ |
| 同文件 `[x](#user-content-…)` | 手写前缀 | 变成双前缀 ❌ |
| 跨文件 `[x](f.md#21-判据总表)` | 不加前缀 | 原样保留,跳不到 ❌ |
| 跨文件 `[x](f.md#user-content-21-判据总表)` | 手写前缀 | 正好命中 ✅ |
标题 id = `user-content-` + 小写化(空格→`-`,其余标点全删)。`·` 两侧空格 → `--`。
含公式标题也一致:`## 问题 3 · 抽象:$AB=O$ 能推出什么` → `user-content-问题-3--抽象abo-能推出什么`。
**新增 `check_md_links.py`**:校验 md 内部链接的目标文件与锚点是否存在。本次 11 文件 235 条链接 0 异常。
**云端端到端实测**:抓 11 个页面比对 id 集合,159 条跨文件锚点链接 **0 异常**。
**踩坑**:① 插入 `---` 前必须留空行,否则 `---` 被当成 setext 标题下划线;② git checkout 后工作区是 CRLF,正则 `\n---\n` 匹配不上,脚本要按 `\r\n` 兼容读写。
提交 `2b1788b`,已推送。