Latex math?

[hdgarrood]

It might be nice to have the ability to put math equations into documentation, probably via latex. I don't really like the way MathJax works but AFAIK there aren't any other good options :(

One example where this might be useful: http://pursuit.purescript.org/packages/purescript-isomorphisms/0.1.0/docs/Data.Iso

[paf31]

Sounds good. I've used MathJAX on my blog before, it's pretty simple. Another option might be to render the images on the server and cache them.

[hdgarrood]

My initial reaction is that I'd rather use MathJax than render images on the server, as more things will be able to understand text and/or the output of MathJax than will be able to understand images (ie, from an accessibility perspective). The only thing that bothers me about MathJax is that it looks over the whole page for pairs of $, which seems wasteful (why not something like document.querySelectorAll('.mathjax')) and prone to false positives (eg, "I owe $20 to somebody and $10 to somebody else"). Although I suppose it does get the job done fairly easily, so these objections are perhaps a bit academic.

[no-longer-on-githu-b]

You can call MathJax yourself, and have it run on only the things you want it to run on. An example is in an old version of my computer algebra system:

First, configure MathJax:

<script type="text/x-mathjax-config">
    MathJax.Hub.Config({
        skipStartupTypeset: true,
    });
</script>

Then call MathJax when you are ready to render the text:

const el = document.getElementById('dyel');
MathJax.Hub.Queue(['Typeset', MathJax.Hub, el]);

[Profpatsch]

There seems to be a new player in the game that is a lot faster than MathJax: https://khan.github.io/KaTeX/