docs(memory): 记 front matter 不过 markdown 的新坑与全库 3706 处待修存量
This commit is contained in:
@@ -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` 目录树分支。
|
||||
|
||||
工作区还留着 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,等用户确认后分批做。
|
||||
|
||||
Reference in New Issue
Block a user