From 035ae4d8b20d3ab354e89d04c150e46e71381867 Mon Sep 17 00:00:00 2001 From: NFC666 <2954834129@qq.com> Date: Mon, 26 Oct 2026 13:05:41 +0800 Subject: [PATCH] =?UTF-8?q?docs(memory):=20=E8=AE=B0=20front=20matter=20?= =?UTF-8?q?=E4=B8=8D=E8=BF=87=20markdown=20=E7=9A=84=E6=96=B0=E5=9D=91?= =?UTF-8?q?=E4=B8=8E=E5=85=A8=E5=BA=93=203706=20=E5=A4=84=E5=BE=85?= =?UTF-8?q?=E4=BF=AE=E5=AD=98=E9=87=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .workbuddy/memory/2026-10-26.md | 12 ++++++++++++ .workbuddy/memory/MEMORY.md | 5 +++-- 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/.workbuddy/memory/2026-10-26.md b/.workbuddy/memory/2026-10-26.md index 146ed5b..7f42c86 100644 --- a/.workbuddy/memory/2026-10-26.md +++ b/.workbuddy/memory/2026-10-26.md @@ -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,等用户确认后分批做。 diff --git a/.workbuddy/memory/MEMORY.md b/.workbuddy/memory/MEMORY.md index f8896ae..4d3530a 100644 --- a/.workbuddy/memory/MEMORY.md +++ b/.workbuddy/memory/MEMORY.md @@ -51,8 +51,9 @@ - 行内 `$...$`:收尾 `$` 的后一个字符必须是**半角空白**(空格/换行);紧贴中文或全角标点 → 整对 `$` 不渲染。开头 `$` 的左邻若是 ASCII 字母/数字或 `. ! ? , ; :` 也不渲染 - 多行 `$$...$$`:同一行上 `$$` 后面若还有内容,整个块被拒绝(Gitea `block_parser.Open()` 的 `idx=-1` 分支缺陷) - `**加粗**`:收尾 `**` 前是标点、后紧贴汉字 → 不生效(CommonMark right-flanking),星号外露 - - 一键检测/修复:`python .workbuddy/tools/md2pdf/fix_gitea_math.py --check|--apply [--scope=prob]` - - 网页核验(抓页面数残留 `$`):`python .workbuddy/tools/md2pdf/verify_gitea_math.py` + - **front matter(`---` 包住的信息块)不过 markdown**(2026-10-26 发现):Gitea 把 `key: value` 渲染成表格,里面的 `$+$`、反引号会**原样露出**。信息块里只写纯文字(`+` 就写 `+`)。此问题本地 md 预览与 PDF 都看不出来,**只有抓网页才暴露** + - 一键检测/修复:`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` - 上述三类修复 KaTeX 输出不变(会 trim),故 PDF 可不必重生成