xaringan：联网主力、断网容灾与教室包

js/xaringan-dual 目录索引

xaringan

MathJax

Quarto

Author

Harness 技术文档

Published

October 19, 2026

本目录存放 xaringan 幻灯片的三份输出所用文件：联网 Knit 仍走 CDN，离线稿改用本地 remark.js 与 MathJax 4，教室包把离线 HTML 和运行时收成可拷贝目录。

MathJax 2 的 beforeInit 与 display-math hook 仍在 js/mathjax-xaringan/。MathJax 4 运行时仍在 js/mathjax-quarto/runtime/。本目录不复制这两套文件。

可交付文件

路径	落到业务项目	说明
`remark-latest.min.js`	`assets-remarkjs/remark-latest.min.js`	离线稿的 remark.js
`fonts/`	`assets-remarkjs/fonts/`	`Ma Shan Zheng` 与 `Source Code Pro` 的本地 woff2
`xaringan-math-spacing.css`	`assets-remarkjs/xaringan-math-spacing.css`	MathJax 2 与 MathJax 4 各一条行距规则
`render-slide.R`	`assets-remarkjs/render-slide.R`	`render_xaringan_slide()`
`pack-offline.R`	`assets-remarkjs/pack-offline.R`	`pack_remark_offline()`
`decks.example.csv`	`assets-remarkjs/decks.example.csv`	课件清单样例，不覆盖 `decks.csv`
`snippets/`	`assets-remarkjs/snippets/`	YAML、gitignore、字体 `@import`，由课程自行合并

安装时另外从 js/mathjax-xaringan/ 复制 mathjax-config.js 与 wrap-display-math.R 到 assets-remarkjs/。

先有 MathJax 4 运行时，再装本 profile。两者目标路径不同，可以同一次调用：

cd D:\github\harness
.\scripts\powershell\Install-Harness.ps1 `
  -InstallProfile mathjax-quarto,xaringan-dual `
  -ProjectRoot "D:\path\to\course"

然后把 assets-remarkjs/decks.example.csv 抄成 decks.csv，按该课的 part,section,title,stem 填写。part 是含 slide-xaringan/、mycss/、pic/ 的目录。