为什么Sphinx/pythonhosted.org中没有显示数学公式?

为什么Sphinx/pythonhosted.org中没有显示数学公式?,python,python-sphinx,mathjax,restructuredtext,pypi,Python,Python Sphinx,Mathjax,Restructuredtext,Pypi,我不确定问题到底出在哪里 我开发了一个名为Python的Python包,它在pythonhosted.org(setuputils自动放置它的官方网站)上托管它的文档 我让Sphinx自动从docstring生成文档。某些模块docstring包含数学,如以下来自的docstring: 但是当我转到它时,它不会显示mathjax的数学。为什么会这样?我该如何解决 Sphinx的Myconf.py extensions = [ 'sphinx.ext.autodoc', 'sphi

我不确定问题到底出在哪里

我开发了一个名为Python的Python包,它在pythonhosted.org(setuputils自动放置它的官方网站)上托管它的文档

我让Sphinx自动从docstring生成文档。某些模块docstring包含数学,如以下来自的docstring:

但是当我转到它时,它不会显示mathjax的数学。为什么会这样?我该如何解决

Sphinx的My
conf.py

extensions = [
    'sphinx.ext.autodoc',
    'sphinx.ext.intersphinx',
    'sphinx.ext.todo',
    'sphinx.ext.coverage',
    'sphinx.ext.mathjax'
]
有关以下句子,请参见:

请记住,在PythonDocstrings中放置数学标记时,请阅读 通过autodoc,您要么必须将所有反斜杠加倍,要么使用Python 原始字符串(r“raw”)

按照这个建议,你必须把你的第一个数学句子改成

:math:`2 \\cdot \\text{points\\_per\\_stroke} \\cdot \\text{strokes}`

更新

您的问题是通过
https
访问
pythonhosted
,但尝试通过
http
加载mathjax文件,默认情况下,该文件被阻止。请参阅Chrome控制台中的错误消息

页面位于 '' 已通过HTTPS加载,但从运行不安全的内容 '': 此内容也应通过HTTPS加载

试着换成 所有的东西都展示得很好

解决方案是,您不必硬编码,而是省略导入的javascript库的协议。而不是使用
http://cdn.mathjax.org/...
仅使用
//cdn.mathjax.org/…

有关详细信息,请参阅和


另一个能准确解决您的问题的来源是未来的注释:cdn.mathjax.org即将终结,请查看迁移提示。另一个来自未来的注释:pythonhosted.org现在显然是只读的,如两年前所述,已被弃用
:math:`2 \\cdot \\text{points\\_per\\_stroke} \\cdot \\text{strokes}`