Блог

Главная - Вопросы по программированию - Каталог установки Sphinx readthedocs имеет другой макет, чем установка на моем собственном компьютере. Как сделать их одинаковыми?

Каталог установки Sphinx readthedocs имеет другой макет, чем установка на моем собственном компьютере. Как сделать их одинаковыми?

#python-sphinx #read-the-docs

#python-sphinx #read-the-docs

Вопрос:

Когда я запускаю Sphinx на своем компьютере, он устанавливается, например

developers/ integration.rst into developers/integration.html

но в readthedocs он устанавливает его в

developers/integration/index.html

Это приводит к сбою использования относительных ссылок в любых необработанных командах.

Есть ли способ заставить мою установку на компьютере использовать ту же структуру каталогов, что и readthedocs? Или другие решения?

Комментарии:

1. Пожалуйста, вставьте содержимое вашего conf.py . Это не должно происходить по умолчанию. Я не знаю ни одного параметра, который бы это делал. Также вы сделали make clean первый? Возможно, вы просматриваете кэшированный или ранее созданный файл.

2. Спасибо, что посмотрели на это. Я не могу подогнать conf.py в поле для комментариев, так что вот ссылка. gitlab.com/petsc/petsc/-/blob/master/src/docs/sphinx_docs /…

3. Спасибо, что посмотрели на это. Я не могу подогнать conf.py в поле для комментариев, так что вот ссылка. gitlab.com/petsc/petsc/-/blob/master/src/docs/sphinx_docs/… Я почти уверен, что это не проблема с кешем. Прочитать документы можно найти по адресу docs.petsc.org/en/barry-2020-10-14-docs-integration/developers/… архив можно найти по адресу gitlab.com/BarrySmith/test-project/-/issues/1

4. Вы должны отредактировать свой вопрос. Я не буду загружать ненадежный файл.

Ответ №1:

В этом, по сути, разница между автономным конструктором HTML и конструктором каталогов HTML. Вы можете изменить конструктор с помощью опции sphinx-builder в файле конфигурации read-the-doc или изменить свой параметр сборки в командной строке, указав его с -b помощью .