qubyte-codes VS KaTeX

https://qubyte.codes

I blog about things which interest me (mostly JS and creative code related), but also take Japanese language notes as I learn. Also part of the 250KB club!

It's built with my own hand-rolled static site generator, and I'm pretty proud of it's capabilities now. I've got a bunch of indieweb features integrated into it. I have no sense of style though!

Source: https://github.com/qubyte/qubyte-codes

I use server rendered SVG with mathjax as part of my static site generator. To try to make it as accessible as possible I add a title element with an ID to each SVG and use an aria-labelledby attribute to connect the two [1] (a sample for the interested, scroll about half way down [2]). The title content is the unrendered LaTeX source.

I'm very interested in the notion of using HTML and CSS rendering though! Many thanks to the author for pointing out this functionality.

[1]: https://github.com/qubyte/qubyte-codes/blob/main/lib/render....

Another static site builder author here. I found some of the same awkwardness in recreating __dirname, but after some massaging found it only remains when path.join is also used (which can't work with a file URL and can't be simply replaced with URL construction because the existing path is lost). I went the whole hog and completely replaced all CJS in my own code, and it's working well. Luckily I avoided issues with third party modules breaking.

PR with the changes: https://github.com/qubyte/qubyte-codes/pull/323

I want to resolve this KaTeX issue, so in order to test my ideas, is there some LaTeX test file with just a lot of equations, preferably inline (since this issue is related to inline math) but without fancy libraries or stuff not included in KaTeX?

> Could you elaborate on why you switched away from it?

I started using KaTeX sometime after 2015 because it promised to be fast (the fastest! [1]). I had to change the representation of a bunch of expressions because KaTeX didn't support some environments, whilst MathJax did. It was a trade-off I was willing to accept at the time.

Many years later, I started writing a personal static-site generator. I wanted comparatively lightweight pages, so rendering server-side was an option. I re-evaluated MathJax vs KaTeX again and this time I leaned towards MathJax, as speed was no longer an issue for me. It looks like KaTeX has broader support now [2].

[1] https://katex.org

[2] https://katex.org/docs/support_table.html

Another alternative: Create a WebView by using UIViewRepresentable and Webkit together with MathJax or Katex where Katex is the better option. Here is a link to katex: https://katex.org/

This isn't a LaTeX question. It's a web dev question. Probably best directed at folks who make (or use) KaTeX.

KaTeX

(1) [https://katex.org/

If you want to make it from scratch, go with https://www.slatejs.org/examples/richtext, then use something like https://katex.org/ for rendering the LaTeX, and maybe Mathjs.org for plotting.

The speed of KaTeX is great, but the lack of support for diagrams (a la tikz-cd) is what makes KaTeX unsuitable for general adoption by mathematicians (e.g., mathoverflow.net and all online mathematical wiki I know use MathJax). KaTeX has some rudimentary support for diagrams though the {CD} environment, but something more fully fledged akin to tizk-cd or xymatrix is needed. There's been some discussion on their github (https://github.com/KaTeX/KaTeX/issues/219), but I wouldn't hold my breath.

Haven't personally used it, but have heard of KaTeX