在gh-pages上托管的sphinx html中的散景图JS路径

问题描述 投票:0回答:1

我试图在RST文件中使用散景图扩展使用散景图扩展来在gh-pages上托管一些基于sphinx的文档。我能够提供生成的html和相关的JS,以使交互式图能够与本地主机烧瓶服务器一起正常工作。

我的问题是当在gh-pages上托管时,为剧情生成的脚本放在顶级'scripts'文件夹(build / html / scripts)中,然后生成的html src被设置为'/ scripts'。问题似乎在于此路径不是相对路径,然后解析为顶级gh-pages url / scripts而不是完整的存储库url / scripts。当我手动编辑html作为正确的相对路径时,图表在gh页面上正常工作。解决此问题的最佳方法是在我的文档中包含交互式散点图?

html python-sphinx bokeh github-pages
1个回答
0
投票

通过相对路径访问绘图脚本是still an open issue不幸的是它也是一大堆工作,并且有很多问题和很少的核心开发人员,所以我怀疑它将很快被优先考虑。

您知道在部署的GH页面站点上可以使用的绝对路径吗?如果是这样(似乎必须有?)那么我最好的建议就是在生成输出之前编辑本地安装的bokeh指向该位置,而不是硬编码的"/scripts"值:

https://github.com/bokeh/bokeh/blob/master/bokeh/sphinxext/bokeh_plot.py#L142

稍微好一点的解决方案是提交PR以使此路径可配置,或使相对路径起作用。如果您有兴趣从事这些工作,请联系GitHub项目

© www.soinside.com 2019 - 2024. All rights reserved.