Skip to content

修复网页排版中 LaTeX 公式未渲染 - #172

Merged
Edwardxlai merged 8 commits into
Edwardxlai:mainfrom
TWwWT1:fix/web-article-math-rendering
Nov 18, 2026
Merged

Edwardxlai merged 8 commits into
Edwardxlai:mainfrom
TWwWT1:fix/web-article-math-rendering

Conversation

@TWwWT1

@TWwWT1 TWwWT1 commented Nov 17, 2026

Copy link
Copy Markdown
Contributor

关联 Issue 与改动

导入 Scaling Laws, Carefully 后,在「网页排版」中看到的公式是原始 LaTeX 源码,例如 $C \approx 6ND$。网页快照禁用原网站脚本,阅读器又用纯文本写入原文和译文,没有调用自带的 KaTeX,因此不会渲染公式。

本 PR 使用现有 KaTeX 渲染网页文字中的行内和独立公式,保留 iframe 的脚本隔离;已导入的文章无需重新翻译。普通文字会转义,代码和链接保持字面内容。

影响范围

  • 受影响的通常是将公式源码放在 HTML 正文中,并依赖客户端 MathJax、KaTeX 等脚本渲染的网页文章,例如机器学习博客、数学和统计文章、技术教程。是否触发取决于快照中公式的实际表示方式;已由服务端排版或以图片呈现的公式不一定受影响。
  • 修改 common/markup.js 中的公式解析、reader/webpage.js 中的原文与译文渲染及 iframe 样式;reader/anchor.js 对包含完整原始 TeX 的旧划线提供重新定位,离线导出复用内嵌样式和字体。
  • 跨多个 HTML 文本节点的公式、特殊宏及其他网页结构仍需更多样本验证。

验证结果

  • Windows:隔离副本中该文章渲染 158 处公式,其中 14 处为独立公式,无 KaTeX 解析错误或浏览器页面错误;安装版目视确认行内公式和符号表显示正常。
  • node --test tests/web/test_markup.cjs tests/web/test_sentences.cjs tests/web/test_reader_store.cjs:35 项通过。
  • python -m unittest tests.weblog.test_web tests.weblog.test_offline_assets:7 项通过。
  • python -m tests.e2e_web_math:在线、语言切换、旧划线、刷新及断网离线导出通过。
  • 完整 tests.e2e_web.py 在关闭笔记面板操作处超时,尚未完成全部回归,原因未确认。

@Edwardxlai
Edwardxlai merged commit 2410e35 into Edwardxlai:main Nov 18, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants