带有 Sphinx 生成的文档的 Github 页面无法正确显示 HTML

Question

我一直在尝试在 Github 页面上为我们的存储库发布 Sphinx 生成的文档，主题由 readthedocs.org 提供。 .
经过几次尝试，我设法通过将 Sphinx 生成的 HTML 文件上传到存储库的 gh-pages 分支中使其在线。
获得这个:
https://takeqontrol.github.io/qontrol_api/
这看起来很糟糕，通过阅读文档删除了主题的所有自定义。
以下是打开链接时看到的示例:

但是如果我在我的计算机上打开这些 HTML 文件，页面看起来正是我想要的样子。
下面是一个示例，说明完全相同的 HTML 在本地的外观:

有人知道发生了什么吗？或者甚至指出我可以找到解释的地方？
所有代码都可以在这里找到:https://github.com/takeqontrol/qontrol_api
在两个分支。

Answer 1

在弄清楚 之前，我与此斗争了 9 个小时。下划线 在 _static文件夹导致了问题。
您需要by pass Jekyll on github pages .
为此，添加一个空的 .nojekyll给您的 gh-pages分支。 (见 example)