Я столкнулся со странной проблемой. Я добавил последние файлы sphinx_rtd_theme в свой проект и сделал необходимые переопределения темы (включая известный перенос текста в таблицах).
Локальная сборка работает абсолютно нормально. Но это было передано мастеру, тема возвращается к очень простой и не применяется. Я пробовал ручные сборки, но так и не смог отследить основную причину и обходной путь.
Под мастером я подразумеваю сборки, которые создаются на сайте ReadTheDocs (аккаунт).
Согласно вашим версиям RTD, "последняя" указывает на главную ветвь вашего проекта. документация. Я просмотрел источник conf.py в основной ветке, и для нее задана тема ra. Таким образом, все, что вы делаете локально, не передается в ту же ветку, которую RTD использует для создания документации.
Прежде чем делать что-либо еще, убедитесь, что все изменения, которые вы вносите локально, отправляете в репозиторий вашей организации и что RTD извлекает из них для сборки документов, находятся в одной и той же ветке.
Как только вы разберетесь с этим и предположите, что хотите использовать rtd_sphinx_theme как в RTD, так и локально, и что вы также хотите, чтобы другие разработчики могли воспроизводить документы, следуйте sphinx_rtd_theme установка методом пакета.
ra в качестве набора тем. Это потому, что я вернулся к старой версии. Я меняю conf.py на sphinx_rtd_theme в ветке, а затем объединяю ее с основной веткой. После того, как я вношу изменения, запускается сборка. Но это не новая тема. Вывод, который я получаю с помощью sphinx_rtd_theme, даже не имеет установленной темы ra. Он восходит к простому списку тем html (очень простой). В этом проблема.
- person veenamj; 26.04.2017
conf.py не обновлялся 2 дня и по-прежнему использует тему ra. RTD использует этот файл для настройки сборки ваших документов. RTD будет продолжать использовать тему ra, пока вы не настроите ее на использование другой, как я ответил выше.
- person Steve Piercy; 27.04.2017
ra.
- person veenamj; 27.04.2017
pip install sphinx_rtd_theme туда не добавлено. Должен ли я добавить его в файл?
- person veenamj; 02.05.2017
pip install foo в файл требований. См. формат файла требований. Затем вам нужно отправить коммит вашего файла requirements.txt в ветку вашего репозитория, из которой RTD создаст документы. Я не вижу ни одного bitbucket.org/qubole/docs/ src/ Это правильная ветка?
- person Steve Piercy; 02.05.2017
docs/sphinx/dependencies.pip. Тем не менее, вы пропустили rtd_sphinx_theme в своем dependencies.pip, и вам нужно включить его. Если это не сработает, закомментируйте в conf.py: html_static_path = ['_static']. В журнале сборки есть предупреждение о том, что не удается найти файлы из темы RTD.
- person Steve Piercy; 03.05.2017
sphinx-rtd-theme без номера версии. pip установит последнюю версию. Номер версии следует указывать только тогда, когда вашему пакету требуется определенная версия.
- person Steve Piercy; 03.05.2017
html_static_path = ['_static']. Тем не менее, ничего не помогло, и я получил тот же результат. Почти все обходные пути возвращаются к исходной точке. (Немного утомительно....)
- person veenamj; 04.05.2017
html_context. Мне пришлось создать _templates/layout.html и добавить свойство def add для переноса текста в таблицы, а theme_override.css, как описано в Ошибка 117 Вот Правильная тема Большое спасибо за все обходные пути!
- person veenamj; 05.05.2017
ReadTheDocs не очищает каталог сборки при каждой новой сборке. Я исправил это вручную очистив все временные файлы из ReadTheDocs:
После этого для новых билдов использовалась моя модифицированная тема RTD.
Для этого я добавил обнаружение тегов в conf.py. Если мой тег установлен, он выполняет очистку. Вы можете установить пользовательские теги в веб-интерфейсе ReadTheDocs.
sphinx_rtd_themeв RTD. Вы должны следовать методу пакета для RTD, а не методу git/download. Затем убедитесь, что вы настроили свою учетную запись RTD и свои веб-хуки, как я изначально сказал. - person Steve Piercy schedule 25.04.2017