python-sphinx - 如何在 sphinx 中更改 HTML Builder 的“_target”输出目录？

Question

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

似乎 github pages 集成不喜欢以 开头的目录_，并使_static目录隐藏。我的网站看起来没有风格（很像我自己）。

有什么方法可以将 Sphinx 配置为使用static/而不是_static/在其生成的页面中使用？我试过html_static_path但没有骰子。

谢谢！

Answer 1

这是一个已知问题。请参阅此 Google 网上论坛主题。github-tools项目在sphinx.py中有一个解决方法。

另请参阅https://stackoverflow.com/a/6398875/407651。