discourse-math/assets/javascripts/initializers/discourse-math-katex.js
2024-01-16 17:57:10 +01:00

86 lines
2.4 KiB
JavaScript

import $ from "jquery";
import loadScript from "discourse/lib/load-script";
import { withPluginApi } from "discourse/lib/plugin-api";
function ensureKaTeX() {
return loadScript("/plugins/discourse-math/katex/katex.min.js").then(() => {
return loadScript("/plugins/discourse-math/katex/katex.min.css", {
css: true,
})
.then(() => {
return loadScript("/plugins/discourse-math/katex/mhchem.min.js");
})
.then(() => {
return loadScript("/plugins/discourse-math/katex/copy-tex.min.js");
});
});
}
function decorate(elem, katexOpts) {
const $elem = $(elem);
katexOpts["displayMode"] = elem.tagName === "DIV";
if ($elem.data("applied-katex")) {
return;
}
$elem.data("applied-katex", true);
if ($elem.hasClass("math")) {
const tag = elem.tagName === "DIV" ? "div" : "span";
const displayClass = tag === "div" ? "block-math" : "inline-math";
const text = $elem.text();
$elem.addClass(`math-container ${displayClass} katex-math`).text("");
window.katex.render(text, elem, katexOpts);
}
}
function katex($elem) {
if (!$elem || !$elem.find) {
return;
}
const mathElems = $elem.find(".math");
if (mathElems.length > 0) {
ensureKaTeX().then(() => {
// enable persistent macros with are disabled by default: https://katex.org/docs/api.html#persistent-macros
// also enable equation labelling and referencing which are disabled by default
// both of these are enabled in mathjax by default, so now the katex implementation is (more) mathjax compatible
const katexOpts = {
trust: (context) => ["\\htmlId", "\\href"].includes(context.command),
macros: {
"\\eqref": "\\href{###1}{(\\text{#1})}",
"\\ref": "\\href{###1}{\\text{#1}}",
"\\label": "\\htmlId{#1}{}",
},
displayMode: false,
};
mathElems.each((idx, elem) => decorate(elem, katexOpts));
});
}
}
function initializeMath(api) {
api.decorateCooked(
function (elem) {
katex(elem);
},
{ id: "katex" }
);
}
export default {
name: "apply-math-katex",
initialize(container) {
const siteSettings = container.lookup("service:site-settings");
if (
siteSettings.discourse_math_enabled &&
siteSettings.discourse_math_provider === "katex"
) {
withPluginApi("0.5", function (api) {
initializeMath(api);
});
}
},
};