python mathjax_MkDocs和MathJax「终于解决」

pip install https://github.com/mitya57/python-markdown-math/archive/master.zip

然后我创建了一个新的MkDocs项目：mkdocs new test_math

接下来我编辑了test_math/docs/index.md文件如下(从MathJax documentation中借用的示例)：# MathJax Test Page

When \(a \ne 0\), there are two solutions to \(ax^2 + bx + c = 0\) and they are

$$x = {-b \pm \sqrt{b^2-4ac} \over 2a}.$$

最后，我将test_math/config.yaml文件编辑如下：site_name: Test Math

extra_javascript:

– https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML

markdown_extensions:

– mdx_math

我不确定这是否可行，但我运行了测试服务器以查看：mkdocs serve

然后我打开浏览器并加载http://127.0.0.1:8000/。显示的页面中的示例公式格式正确：

然后，我记得操作人员要求使用ReadTheDocs，所以我在配置中添加了以下行：theme: readthedocs

我的浏览器已重新加载，并显示以下(格式正确的公式)：

我应该注意到我有个奇怪的错误，关于fontawesome不加载。使用MkdDocs的主题，方程式在一分钟后消失(当错误出现在浏览器控制台中时)。但是，在ReadTheDocs主题中，即使有错误，方程式也会正确显示。不管怎样，我相信这个错误与本地机器上的其他问题有关。

最后，赏金是。。。Looking for an answer drawing from credible and/or official sources

我通常不会宣传这一点，但既然你问我，我是Python Markdown的首席开发人员，我经常与mitya57(Python Markdown Math Extension的创建者)一起工作，因为他是另外两个具有Python Markdown提交访问权限的开发人员之一，我是MkDocs的贡献者(其中一个贡献是支持Python降价扩展)。