New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[render_math] Should we allow KaTeX as an alternative rendering option to MathJAX? #625

Open
danmackinlay opened this Issue Dec 6, 2015 · 6 comments

Comments

Projects
None yet
5 participants
@danmackinlay
Copy link
Contributor

danmackinlay commented Dec 6, 2015

MathJax is huge and slow. katex is a similar but faster smaller more fashionable rendering backend that promises to have fewer dependencies for offline development.
Should we include it as an alternative renderer backend, folks? Or is it not worth the effort?
CC @barrysteyn @ariddell, @fbeutel

@barrysteyn

This comment has been minimized.

Copy link
Contributor

barrysteyn commented Dec 7, 2015

Hi, when Katex first came out, I thought about integrating it. I think Katex looks (and performs) amazingly, but it only renders a subset of what mathjax will render. So we would need to build something that would fall back to mathjax for things that Katex struggles with. Any thoughts?

@danmackinlay

This comment has been minimized.

Copy link
Contributor

danmackinlay commented Dec 8, 2015

I think implementing our own LaTeX parser to choose between the other two LaTeX parsers might be overkill. Far easier, and what the users would probably expect from e.g. Sphinx, would be to provide a setting to choose your render site-wide depending on individual needs. Users are already accustomed to slightly different subsets depending on settings choices and this would not be surprising - e.g in Sphinx, pngmath supports a superset of the markup supported by mathjax, but there is no fallback option. And for that matter, LaTeX itself supports different things based on version numbers and site-specific installation details...

@barrysteyn

This comment has been minimized.

Copy link
Contributor

barrysteyn commented Dec 16, 2015

It's actually not too difficult to implement what I suggested above. But I will look into adding it to the plugin...

@danmackinlay danmackinlay changed the title Should we allow KaTeX as an alternative rendering option to MathJAX? [render_math] Should we allow KaTeX as an alternative rendering option to MathJAX? Jan 3, 2017

@iKevinY

This comment has been minimized.

Copy link
Member

iKevinY commented Apr 12, 2017

I'd be interested in having the option of using KaTeX rather than MathJax; most of the math that I want to render is quite basic, so it would be nice to be able to go with something more lightweight.

@svenkreiss

This comment has been minimized.

Copy link
Contributor

svenkreiss commented Feb 4, 2018

I also wanted to try KaTeX and made the pelican-jsmath plugin. It doesn't do any rendering or code injection but just preserves the equations so they can be rendered with JS. I am curious whether you have any comments/suggestions.

@justinmayer

This comment has been minimized.

Copy link
Member

justinmayer commented Mar 23, 2018

Anyone want to act to some of the suggestions proposed here?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment