如何在sphinx中更改HTML Builder的`_target`输出目录？

Question

我正在尝试使用Sphinx构建docuemntation以推送到github页面.我正在使用默认的html构建器生成帮助文档并将其推送到gh-pages分支(请参阅https://github.com/sbt/sbt-native-packager/tree/gh-pages).

看起来像github页面集成不喜欢以目录开头_,并使_static目录隐藏.我的网站没有风格(很像我自己).

有没有办法配置Sphinx static/而不是_static/在其生成的页面中使用？我试过html_static_path但没有骰子.

谢谢!

Answer 1

这是一个众所周知的问题.查看此Google网上论坛帖子.在GitHub的工具项目有一种变通方法sphinx.py.