Files
MathNotesVersion2/.workbuddy/memory/2026-11-22.md
T

2.3 KiB
Raw Blame History

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 那样的条目化——已向用户提出,等其决定是否统一。