python 在Sphinx生成的github.io页面中运行Mathjax时出现问题

uidvcgyl  于 2023-09-29  发布在  Python
关注(0)|答案(2)|浏览(121)

我正在使用Sphinxmy python project编写文档。
我的conf.py
数学在本地主机上呈现得很好,但当部署在github.io上时,它似乎不起作用。

本机x1c 0d1x
github.io

注意:我添加了空的.nojekyll文件,以便能够使用Sphinx模板。
我不知道是什么原因导致githubpages不呈现mathjax,即使它在本地机器上呈现find。
有什么想法吗?
更新:当我在chrome浏览器中允许insecure content时,我得到了数学渲染。

有什么问题吗?!!

mcvgt66p

mcvgt66p1#

conf.py中,试试这个:

extensions = [
    'sphinx.ext.mathjax',
    ]

mathjax_path = 'https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML'
ffscu2ro

ffscu2ro2#

我想我在the answer to this question的帮助下解决了这个问题。
问题是当你需要使用sphinx部署一个github.io页面时,github.com的部署会直接在docs/下查找index.html文件。通常情况下,sphinx中的主index.html文件位于docs/build/html/下。
因此,根据一些教程的建议,我将conf.py更改为直接在docs/下构建index.html,这似乎是阻止mathjax工作的问题。
当我恢复build/文件夹并使用虚拟index.htmlgithub.io定向到docs/build/html中的真实的index.html时,数学现在渲染得很好。

相关问题