记忆:记录 Gitea 网页端公式渲染三条硬规则与配套工具
This commit is contained in:
@@ -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 可不必重生成
|
||||
|
||||
## 云仓库
|
||||
|
||||
|
||||
Reference in New Issue
Block a user