记忆:标题禁含公式、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
+2 -1
View File
@@ -32,8 +32,9 @@
- **Gitea 锚点规则(两条方向相反,极易踩)**:标题 id $=$ `user-content-` $+$ 小写化(保留字母数字汉字与下划线,空格→`-`,**其余标点全删**,`·` 两侧空格 → 两个 `-`)
- **同文件**写 `#问题-2--变换后的向量组` —— Gitea 渲染时**自动**补 `user-content-`
- **跨文件**写 `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 <目录>`(查目标文件与锚点是否存在)
- **`gen_crosslinks.py`**(2026-10-24 建):单一数据源 = 题目标题 `### 题 N · X.Y:短标题(★★☆)`,幂等生成 ①每题关联行 ②盘点 `<!-- AUTO:KP -->` 之间的 §0.4 表 ③速查卡 `<!-- AUTO:回查 -->` 之间的回查表。`--check` 只统计。**速查卡里同一个 `<!-- KP: x.y -->` 只能挂在一个小节**(后写覆盖前写)
## 工具链(本项目自建,可复用)