Как убедиться, что изображения включены в сборку read-the-docs вне папки `_static`? - PullRequest
0 голосов
/ 25 июня 2019

Для нашего проекта с открытым исходным кодом на 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. Нужно ли мне определять какой-то специальный флаг в файле конфигурации для чтения документов?
...