feat: 接入 KaTeX 渲染,完成 Sätteri 迁移(Phase 3)
方案:用现成的 satteri-katex(MDAST 插件,40 行,是 rehype-katex 的移植), 而不是自己写。它跑在 MDAST 阶段,天然绕开下面这个坑。 为什么不能用 HAST 阶段做 Sätteri 把块级公式输出成 <pre><code class="language-math math-display">, 而 expressive-code 过滤所有 <pre>,会把它当成未知语言渲染成带行号的 plaintext 代码块 —— 实测 10 个块级公式全部被吃掉(math-display: 0)。 unified 时期没这问题,是因为 rehype-katex 排在 rehypePlugins 第一位, 先把 <pre><code> 换掉了。satteri-katex 的源码注释里记录的是同一个坑。 插件顺序 satteriKatex() 放在 mdastPlugins 最后:它把 math 节点换成 KaTeX 的 html 节点,若排在 reading-time / excerpt 之前,字数统计会把 KaTeX 标记也算进去。 顺带修掉一个之前漏掉的回归 reading-time / excerpt 原本用 ctx.textContent(),但它只拼接纯 text 节点, 会漏掉代码块、行内代码、公式、图片 alt。实测 LaTeX 那篇字数 830 → 488。 改用 mdast-util-to-string 的 toString()(与迁移前的实现一致),字数完全复原。 之前没发现是因为我的对比脚本只截取了 <article> 区域,而字数在它外面的 header 里。 现改为整页对比。 清理依赖(10 个,已确认无引用) remark-math / rehype-katex / remark-directive / remark-github-admonitions-to-directives / remark-sectionize / rehype-slug / rehype-components / rehype-autolink-headings / @astrojs/markdown-remark / hastscript / unist-util-visit 验证(与 unified() 基线整页对比,41 页) - 39 页语义完全一致;2 页只剩智能标点在中文/emoji 旁的引号方向差异 (Sätteri 的结果更正确:把开引号排成 “ 而不是 ”)。 - LaTeX 页:class="katex" 76、katex-display 10,与基线完全一致; 块级公式不再被 expressive-code 吞掉。 - 字数/阅读时长与基线逐篇一致(830/4、1042/5、416/2)。 - pnpm build 41 页 + pagefind 通过;astro check 仍是 1 error/0 warnings (原有 footer.astro 报错,与本次无关)。
This commit is contained in:
@@ -14,6 +14,7 @@ import { sectionize } from "./src/plugins/satteri/sectionize.mjs"
|
||||
import { shiftHeadings } from "./src/plugins/satteri/shift-headings.mjs"
|
||||
import { autolinkHeadings } from "./src/plugins/satteri/autolink-headings.mjs"
|
||||
import { imageLightbox } from "./src/plugins/satteri/image-lightbox.mjs"
|
||||
import { satteriKatex } from "satteri-katex"
|
||||
import { site } from "./src/data/site"
|
||||
|
||||
export default defineConfig({
|
||||
@@ -88,6 +89,9 @@ export default defineConfig({
|
||||
excerpt,
|
||||
shiftHeadings(),
|
||||
sectionize(),
|
||||
// KaTeX 必须排在 reading-time / excerpt 之后:它把 math 节点换成 KaTeX 的
|
||||
// HTML,先换的话 ctx.textContent() 会把 KaTeX 标记也算进字数。
|
||||
satteriKatex(),
|
||||
],
|
||||
hastPlugins: [
|
||||
satteriHeadingIdsPlugin(),
|
||||
|
||||
Reference in New Issue
Block a user