docs(memory): 记 front matter 不过 markdown 的新坑与全库 3706 处待修存量

This commit is contained in:
2026-10-26 13:05:41 +08:00
parent 64a2ca0321
commit 035ae4d8b2
2 changed files with 15 additions and 2 deletions
+12
View File
@@ -51,3 +51,15 @@ fix_gitea_math.py → 先 --check 报 138 处,--apply 修完,复查 0 处
`719748b`(14 文件 / +2287 / -6)已推 `origin/main`,`rev-list --left-right --count` 得 `0 0`。同步带入 `总览.md` 目录树分支。 `719748b`(14 文件 / +2287 / -6)已推 `origin/main`,`rev-list --left-right --count` 得 `0 0`。同步带入 `总览.md` 目录树分支。
工作区还留着 5 个无用的向量章节临时脚本(`.workbuddy/check_vector_exam_sample.py`、`check_vector_learning.py`、`inspect_vector_exam_sample.py`、`rewrite_vector_learning.py`、`vector_learning_checks.json`),本次未提交,也未删除——待用户确认后再清。 工作区还留着 5 个无用的向量章节临时脚本(`.workbuddy/check_vector_exam_sample.py`、`check_vector_learning.py`、`inspect_vector_exam_sample.py`、`rewrite_vector_learning.py`、`vector_learning_checks.json`),本次未提交,也未删除——待用户确认后再清。
## 补充:网页端抓取发现 front matter 不过 markdown(新坑,第 5 条)
推送后用 `verify_gitea_math.py` 逐页抓取,12 个文件里 **4 个残留 `$`**(README 1 / 01 1 / 01b 1 / 速查卡 2),但本地 `fix_gitea_math.py --check` 报 0 —— 说明本地这套规则漏了一类。
**根因**:残留全在文件头 YAML front matter 的 `状态:` 字段里(如 `状态: 知识点盘点 $+$ 八点分册`)。Gitea 把 front matter 渲染成表格时**不解析 markdown**,所以 `$+$` 与反引号原样露出。本地 md 预览、PDF 都正常,只有网页端能看见。
**修法**:信息块内一律用纯文字,`+` 就是 `+`,不要包反引号。四个文件已改(`b795fa7`)。
**工具升级**(`64a2ca0`):`fix_gitea_math.py` 新增 `fix_frontmatter()`,把 `$+$`/`$=$`/`$\to$` 等转纯字符并剥掉残留 `$` 与反引号,纳入 `--check` 统计。以后这类问题本地就能拦住。
**顺带暴露的大坑**:全库跑 `--check` 得 **60 个文件 / 3706 处待修**(`基于考研的学习` 内 39 文件 / 2441 处;`多元函数积分学` 6 文件 445 处;`试卷/…题干与题型.md` 20 份各 44—78 处)。这些是**从没跑过修复的历史文件**,网页端大概率在露 `$`。尚未执行 `--apply`——一次性改 3700 处会做出巨大 diff,等用户确认后分批做。
+3 -2
View File
@@ -51,8 +51,9 @@
- 行内 `$...$`:收尾 `$` 的后一个字符必须是**半角空白**(空格/换行);紧贴中文或全角标点 → 整对 `$` 不渲染。开头 `$` 的左邻若是 ASCII 字母/数字或 `. ! ? , ; :` 也不渲染 - 行内 `$...$`:收尾 `$` 的后一个字符必须是**半角空白**(空格/换行);紧贴中文或全角标点 → 整对 `$` 不渲染。开头 `$` 的左邻若是 ASCII 字母/数字或 `. ! ? , ; :` 也不渲染
- 多行 `$$...$$`:同一行上 `$$` 后面若还有内容,整个块被拒绝(Gitea `block_parser.Open()` 的 `idx=-1` 分支缺陷) - 多行 `$$...$$`:同一行上 `$$` 后面若还有内容,整个块被拒绝(Gitea `block_parser.Open()` 的 `idx=-1` 分支缺陷)
- `**加粗**`:收尾 `**` 前是标点、后紧贴汉字 → 不生效(CommonMark right-flanking),星号外露 - `**加粗**`:收尾 `**` 前是标点、后紧贴汉字 → 不生效(CommonMark right-flanking),星号外露
- 一键检测/修复:`python .workbuddy/tools/md2pdf/fix_gitea_math.py --check|--apply [--scope=prob]` - **front matter(`---` 包住的信息块)不过 markdown**(2026-10-26 发现):Gitea 把 `key: value` 渲染成表格,里面的 `$+$`、反引号会**原样露出**。信息块里只写纯文字(`+` 就写 `+`)。此问题本地 md 预览与 PDF 都看不出来,**只有抓网页才暴露**
- 网页核验(抓页面数残留 `$`):`python .workbuddy/tools/md2pdf/verify_gitea_math.py` - 一键检测/修复:`python .workbuddy/tools/md2pdf/fix_gitea_math.py --check|--apply [--scope=目录]`(已含 front matter 规则)
- 网页核验(抓页面数残留 `$`):`python .workbuddy/tools/md2pdf/verify_gitea_math.py [仓库相对路径…]`,**交付前对新写文件跑一遍**,本地 0 处不代表网页 0 处
- 批量重生成概率论 PDF:`bash .workbuddy/tools/md2pdf/rebuild_prob_pdfs.sh` - 批量重生成概率论 PDF:`bash .workbuddy/tools/md2pdf/rebuild_prob_pdfs.sh`
- 上述三类修复 KaTeX 输出不变(会 trim),故 PDF 可不必重生成 - 上述三类修复 KaTeX 输出不变(会 trim),故 PDF 可不必重生成