diff --git a/.workbuddy/memory/2026-11-22.md b/.workbuddy/memory/2026-11-22.md new file mode 100644 index 0000000..5e046ae --- /dev/null +++ b/.workbuddy/memory/2026-11-22.md @@ -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 那样的条目化——已向用户提出,等其决定是否统一。