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

Update mathjax link in documentation #922

Closed
asmaier opened this Issue Jan 7, 2018 · 3 comments

Comments

Projects
None yet
3 participants
@asmaier

asmaier commented Jan 7, 2018

The documentation on http://dlmf.nist.gov/LaTeXML/manual/usage/usage.single.html states to use

latexmlpost --format=html5 \
--javascript='http://cdn.mathjax.org/mathjax/latest/MathJax.js \
--destination=somewhere/doc.html doc

but this doesn't work anymore since April 2017 (see https://www.mathjax.org/cdn-shutting-down/). The correct call is

latexmlpost --format=html5 \
--javascript='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/MathJax.js?config=MML_CHTML' \
--destination=somewhere/doc.html doc

The option config=MML_CHTML selects the MathML to CommonHTML rendering engine of MathJax (see http://docs.mathjax.org/en/latest/config-files.html#the-mml-chtml-configuration-file), which generated very good results in all browsers I tried (Firefox, Chrome, Safari).
Maybe it should also be mentioned in the documentation that a lot of browser don't support MathML and therefore using MathJax is the only option to generate a HTML with math formulas, which works in all browsers.

@dginev

This comment has been minimized.

Collaborator

dginev commented Jan 7, 2018

Yep, had a PR for the actual JS link in the code #834 when it was announced, but apparently no one remembered there is a similar link in the documentation. Good catch!

@dginev dginev added this to the LaTeXML-0.8.3 milestone Jan 7, 2018

@brucemiller

This comment has been minimized.

Owner

brucemiller commented Jan 7, 2018

Actually, for the manual, it'd probably be better to point to the maybeMathjax javascript.

@brucemiller

This comment has been minimized.

Owner

brucemiller commented Feb 2, 2018

Fixed; Thanks for the report!

@brucemiller brucemiller closed this Feb 2, 2018

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