在`_static`文件夹之外时,如何确保图像包含在文档的内部?

时间:2019-06-25 02:40:38

标签: python-sphinx restructuredtext read-the-docs

对于我们的python开源项目demand_acep,该文档在线托管在使用Sphinx Makefile构建的阅读文档here上。将文档中显示的图像放置在_static文件夹中后,它们将显示正常并在单击时打开(工作示例-page上的图像)。但是,如here所示,图像位于_static文件夹中的forecast_files/figure-html外部时,它们可以正常显示,但单击后无法打开(不起作用的示例-此{{3 }})

图像是从R markdown脚本生成的,位于这些文件夹(不是_static)中,并链接到作为文档一部分显示的markdown文档。

我已将上述路径添加到html_static_path中的conf.py变量中,如下所示: html_static_path = ['_static', 'charge_files', 'plots_files', 'forecast_files']。但是,单击文档中的图像仍会显示404。我的猜测是_static文件夹之外的图像文件未放置在远程构建文件夹内的正确位置。

任何调试/解决此问题的建议将不胜感激。我需要在read-the-docs配置文件中定义一些特殊标志吗?

0 个答案:

没有答案