Как изменить выходной каталог _target для HTML Builder в sphinx?

Я пытаюсь использовать Sphinx для создания документации для отправки на страницы github. Я использую конструктор html по умолчанию для создания справочной документации и помещаю ее в ветку gh-pages (см. https://github.com/sbt/sbt-native-packager/tree/gh-pages).

Похоже, что интеграция страниц github не любит каталоги, начинающиеся с _, и делает каталог _static скрытым. Мой сайт отображается без стиля (очень похоже на меня).

Есть ли способ настроить Sphinx для использования static/ вместо _static/ на сгенерированных страницах? Я попробовал html_static_path, но не в кости.

Спасибо!


person jsuereth    schedule 16.01.2012    source источник


Ответы (1)


Это известная проблема. См. эту тему Групп Google. В проекте github-tools есть обходной путь в sphinx.py.

См. также https://stackoverflow.com/a/6398875/407651.

person mzjn    schedule 16.01.2012
comment
Ссылка на ответ, который предлагает использовать .nojekyll пустой файл, была убийственной. БЛАГОДАРНОСТЬ! - person jsuereth; 17.01.2012