记忆:记录 Gitea 网页端公式渲染三条硬规则与配套工具

This commit is contained in:
2026-10-16 17:58:23 +08:00
parent 4b5c758f05
commit 50bd8a033a
2 changed files with 53 additions and 0 deletions
+11
View File
@@ -16,6 +16,9 @@
## 用户偏好
- 数学内容**必须准确渲染公式**;Markdown 用 `$…$` / `$$…$$`。
- **写 `.md` 时,行内公式 `$…$` 的收尾 `$` 后面必须紧跟半角空格**,再写中文或全角标点(云端 Gitea 的硬性要求,见工具链)。例:`若 $X_n\to X$ ,则…`
- **多行 `$$…$$` 块的开头与收尾 `$$` 必须独占一行**(Gitea 硬性要求)。
- 标题/正文里 `**加粗**` 的收尾 `**` 后若是汉字,补一个半角空格(避免 CommonMark flank 规则导致星号外露)。
- 题目要求**难度分层**(A 基础 / B 中等 / C 拔高),题量可比小练多。
- 出题**防过拟合**:数字/区域原创,只对齐考法;要标「真题骨架」锚点。
- 讲解要**从零拆解 + 指出易错点**,并配图(show_widget 用 SVG)。
@@ -29,6 +32,14 @@
- `shot.js` 用于 HTML 视觉验收截图
- 依赖装在托管 node 工作区:`C:/Users/Wang Ling/.workbuddy/binaries/node/workspace`
- 本机**无 pandoc / 无 LaTeX**,勿尝试 xelatex 路线
- **Gitea 网页端公式渲染的硬规则**(云端 `app.zhantiandoudi.cn` 走 Gitea 自己的 Goldmark 扩展,**与本地 md2pdf 的 KaTeX 链路不同**,本地正常不代表网页正常)
- 行内 `$...$`:收尾 `$` 的后一个字符必须是**半角空白**(空格/换行);紧贴中文或全角标点 → 整对 `$` 不渲染。开头 `$` 的左邻若是 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`
- 批量重生成概率论 PDF:`bash .workbuddy/tools/md2pdf/rebuild_prob_pdfs.sh`
- 上述三类修复 KaTeX 输出不变(会 trim),故 PDF 可不必重生成
## 云仓库