Re: [Docutils-users] MathJax

[Guenter M. <mi...@us...>]

On 2016-02-21, Alan Isaac wrote:
> If I request MathJax output from rst2html,
> it is included as an http request.
> This means the content won't display (by default)
> in browsers that care about mixed content if the
> page is securely served.  (Examples: FireFox, Edge.)

> As I understand it, MathJax recommends using https:
> http://mathjax.readthedocs.org/en/latest/misc/faq.html#how-do-i-access-the-mathjax-cdn-using-a-https-secure-connection

> Can this be changed in the source (rather than
> relying on user configuration)?

Then, the abovementioned Browsers would refuse to show the page if it is
served via "normal" html...

> I am grateful for the configuration option, but it seems
> the default is wrong?

I recommend setting the mathjax URL in the docutils configuration file.

> PS I am confused about why the documentation
> http://docutils.sourceforge.net/docs/user/config.html#math-output
> reads::

>    math-output: MathJax file:/usr/share/javascript/mathjax/MathJax.js

> instead of::

>    --math-output="MathJax file:/usr/share/javascript/mathjax/MathJax.js"

> In my experience, the quotes are essential for this to work.

The example shows the use in a config file.
The quotes are essential for command line arguments. They are not required
in the configuration file. (Also a colon will not work on the command line.)


Günter