From fcb53c434978e984ffe10922d26bb3305b20f66e Mon Sep 17 00:00:00 2001 From: ApsisRS contributors Date: Fri, 2 Oct 2026 12:49:46 +0800 Subject: [PATCH] docs: split the vendored MathJax readme into an English and a Chinese file The repository keeps documentation as an X.md and an X.zh.md pair, so the note that records the vendor, version and checksum follows the same shape. --- docs/vendor/mathjax/README.md | 24 ------------------------ docs/vendor/mathjax/README.zh.md | 21 +++++++++++++++++++++ 2 files changed, 21 insertions(+), 24 deletions(-) create mode 100644 docs/vendor/mathjax/README.zh.md diff --git a/docs/vendor/mathjax/README.md b/docs/vendor/mathjax/README.md index b9ba026..b722754 100644 --- a/docs/vendor/mathjax/README.md +++ b/docs/vendor/mathjax/README.md @@ -23,27 +23,3 @@ require vendoring a directory of font files. To refresh the copy, download the same URL and update the size, the SHA-256, and the version above. - ---- - -# 内置的 MathJax - -本目录保存一份 MathJax 副本，使生成的文档能够**离线**渲染数学公式，不向任何 -内容分发网络发起请求。`docs/mathjax.html` 负责加载该文件，构建文档时 -`crates/apsis-rs/build.rs` 会把它复制到 `target/doc/vendor/mathjax/`。 - -| 字段 | 值 | -| --- | --- | -| 包 | `mathjax` | -| 版本 | 3.2.2 | -| 文件 | `es5/tex-svg-full.js` | -| 来源 | `https://cdn.jsdelivr.net/npm/mathjax@3.2.2/es5/tex-svg-full.js` | -| 大小 | 2 275 113 字节 | -| SHA-256 | `a4354ff94fd868aea0cc6eaaa79a57fd`（前 32 位十六进制） | -| 许可 | Apache-2.0，见本目录的 `LICENSE` | - -`tex-svg-full.js` 是合并组件，打包了 TeX 输入、SVG 输出与字体数据，故不需要 -在线字体，也不需要第二次请求。这正是选用它而非 HTML 输出的原因——后者需要 -内置一整个字体文件目录。 - -要更新该副本，请下载同一 URL，并更新上表中的大小、SHA-256 与版本。 diff --git a/docs/vendor/mathjax/README.zh.md b/docs/vendor/mathjax/README.zh.md new file mode 100644 index 0000000..253b02d --- /dev/null +++ b/docs/vendor/mathjax/README.zh.md @@ -0,0 +1,21 @@ +# 内置的 MathJax + +本目录保存一份 MathJax 副本，使生成的文档能够**离线**渲染数学公式，不向任何 +内容分发网络发起请求。`docs/mathjax.html` 负责加载该文件，构建文档时 +`crates/apsis-rs/build.rs` 会把它复制到 `target/doc/vendor/mathjax/`。 + +| 字段 | 值 | +| --- | --- | +| 包 | `mathjax` | +| 版本 | 3.2.2 | +| 文件 | `es5/tex-svg-full.js` | +| 来源 | `https://cdn.jsdelivr.net/npm/mathjax@3.2.2/es5/tex-svg-full.js` | +| 大小 | 2 275 113 字节 | +| SHA-256 | `a4354ff94fd868aea0cc6eaaa79a57fd`（前 32 位十六进制） | +| 许可 | Apache-2.0，见本目录的 `LICENSE` | + +`tex-svg-full.js` 是合并组件，打包了 TeX 输入、SVG 输出与字体数据，故不需要 +在线字体，也不需要第二次请求。这正是选用它而非 HTML 输出的原因——后者需要 +内置一整个字体文件目录。 + +要更新该副本，请下载同一 URL，并更新上表中的大小、SHA-256 与版本。