记忆:知识点构建排版问题真因是公式未渲染;fix_math 空格落进 ** 内侧的坑
This commit is contained in:
@@ -0,0 +1,33 @@
|
|||||||
|
# 2026-11-22
|
||||||
|
|
||||||
|
## 知识点构建 01「排版全缩在一起」——根因是公式没渲染,不是缩进
|
||||||
|
|
||||||
|
**用户反馈**:`知识点构建/01-背诵版-高等数学-函数与极限.md` 排版全缩在一起。
|
||||||
|
|
||||||
|
**第一次误判**:以为是「加粗标签 + 300 字长段」的结构问题,先做了条目化重排。
|
||||||
|
重排本身没错(101 条、286 行、读起来确实疏朗),但**不是用户看到的那个问题**。
|
||||||
|
|
||||||
|
**真因**:跑 `verify_gitea_math` 一测——01 线上**残留 `$` 243 个**(行内只渲染了 144 处)。
|
||||||
|
10-27 那一批 20 份背诵版是按「收尾 `$` 后紧跟中文标点」写的,Gitea 整对不渲染,
|
||||||
|
正文里直接露出 `$\lim_{x\to0}...$` 源码,所以整页糊成一片、看着像挤在一起。
|
||||||
|
`01—20` 全部中招,合计约 2500 处;`21—27` 另有 24 处「加粗以公式收尾」。
|
||||||
|
|
||||||
|
**教训(重要)**:
|
||||||
|
1. **"看着像排版问题"先跑 `verify_gitea_math`,别先改结构**。这次多花了一遍重排。
|
||||||
|
2. 公式没渲染的视觉特征就是「源码挤在一起」——`\frac`、`\lim` 一串字符直接摊在汉字里。
|
||||||
|
3. `fix_gitea_math --check --scope=<单个 md>` **静默失效**(会扫全仓库),
|
||||||
|
单文件只能用脚本直接调 `F.fix_text(txt)`,返回 `(new_text, inserts)`。
|
||||||
|
|
||||||
|
**批量修复的两个坑**:
|
||||||
|
- `fix_math` 给收尾 `$` 补的空格,若 `$` 后面紧跟 `**`,空格会落在 `**` 内侧
|
||||||
|
→ 加粗失效、星号原样露出。必须把公式**移出**加粗范围:
|
||||||
|
`**…$f$ **` → `**…** $f$ `(公式不进加粗,视觉上无差别)。
|
||||||
|
- 一个加粗里可能连着两个公式(`**独立 $\iff$ $\rho=0$ **`),要**迭代剥两次**才干净。
|
||||||
|
- 首尾都是公式(`**$|kA|=k^n|A|$ **`)时配对下标会退到 0,`k<=0` 的判据要放行。
|
||||||
|
|
||||||
|
**结果**:`01` 重排 + 244 处空格;`02—20` 插入 2550 处;`21—27` 24 处改句式。
|
||||||
|
27 份全部 `fix_text` 幂等(二次插入 0),网页核验残留 `$` 全 0。
|
||||||
|
提交 `da4c938`(01 重排)、`26e91c4`(02—27 批量),已推送,`origin/main...main` 归零。
|
||||||
|
|
||||||
|
**遗留**:01 是 15306 字符(超 1.3 万上限,属存量);02—20 仍是「段落式」结构,
|
||||||
|
没有做 01 那样的条目化——已向用户提出,等其决定是否统一。
|
||||||
Reference in New Issue
Block a user