Skip to content
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
Closed

Update mathjax link in documentation #922

asmaier opened this issue Jan 7, 2018 · 3 comments

Comments

@asmaier
Copy link

@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
Copy link
Collaborator

@dginev 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
Copy link
Owner

@brucemiller brucemiller commented Jan 7, 2018

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

@brucemiller
Copy link
Owner

@brucemiller 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
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
3 participants