Для нашего проекта с открытым исходным кодом на Python demand_acep
документация размещена в Интернете на сайте read-the-docs здесь , который использует Makefile Sphinx для сборки. Когда изображения, отображаемые в документации, помещаются в папку _static
, они отображаются нормально и открываются при щелчке (рабочий пример - изображение на странице ). Однако, когда изображения находятся за пределами _static
, как в папке forecast_files/figure-html
, как показано здесь , они отображаются нормально, но не открываются при щелчке (пример не работает - изображения на этой странице )
Изображения находятся в этих папках (не _static), так как они генерируются из сценария уценки R и связаны с документами уценки, которые отображаются как часть документации.
Я добавил указанные пути к переменной html_static_path
в conf.py
следующим образом:
html_static_path = ['_static', 'charge_files', 'plots_files', 'forecast_files']
. Тем не менее, нажатие на изображения в «read-the-docs» по-прежнему приводит к 404. Я предполагаю, что файлы изображений вне папки _static
не расположены в правильном месте внутри папки удаленной сборки.
* 1024. Нужно ли мне определять какой-то специальный флаг в файле конфигурации для чтения документов?