2.3 KiB
2.3 KiB
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 处「加粗以公式收尾」。
教训(重要):
- "看着像排版问题"先跑
verify_gitea_math,别先改结构。这次多花了一遍重排。 - 公式没渲染的视觉特征就是「源码挤在一起」——
\frac、\lim一串字符直接摊在汉字里。 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 那样的条目化——已向用户提出,等其决定是否统一。