我正在使用Sphinx为my python project编写文档。
我的conf.py
数学在本地主机上呈现得很好,但当部署在github.io上时,它似乎不起作用。
本机x1c 0d1x
github.io
注意:我添加了空的.nojekyll文件,以便能够使用Sphinx模板。
我不知道是什么原因导致githubpages
不呈现mathjax
,即使它在本地机器上呈现find。
有什么想法吗?
更新:当我在chrome
浏览器中允许insecure content
时,我得到了数学渲染。
有什么问题吗?!!
2条答案
按热度按时间mcvgt66p1#
在
conf.py
中,试试这个:和
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.html
将github.io
定向到docs/build/html
中的真实的index.html
时,数学现在渲染得很好。