相关疑难解决方法(0)

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

我一直在尝试在 Github 页面上为我们的存储库发布 Sphinx 生成的文档,主题由readthedocs.org提供。

经过几次尝试,我设法通过将 Sphinx 生成的 HTML 文件上传到存储库的 gh-pages 分支中使其在线。

获得这个:

https://takeqontrol.github.io/qontrol_api/

这看起来很糟糕,通过阅读文档删除了主题的所有自定义。

以下是打开链接时看到的示例:

出现在 githubpages 中的 html - 缺少所有自定义

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

HTML 显示在浏览器本地,具有所有必需的自定义

有人知道发生了什么吗?或者甚至指出我可以找到解释的地方?

所有代码都可以在这里找到:https : //github.com/takeqontrol/qontrol_api 在两个分支中。

github python-sphinx github-pages read-the-docs

12
推荐指数
1
解决办法
1034
查看次数

忽略GitHub页面网站上的/ path?

我在GitHub页面上托管一个静态应用程序.我的应用程序结构是这样的 - 我有一些面向前端的文件,以及一些定期运行以获取前端数据的Python文件,但不应该面向用户:

index.html
/js
    index.js
    vendor/
/css
/data
    get_data.py
Run Code Online (Sandbox Code Playgroud)

如何阻止在data/网站上公开发布的所有内容?

hosting github path github-pages

2
推荐指数
1
解决办法
1074
查看次数