还有另一种情况:

使用组织页(不是项目页)，该组织页有一个名为<orgname>.github.io的存储库 源文档作为主分支中的标记(asciidoc) 特拉维斯CI拉源文档文件从主和推动生成的html文件到gh-pages分支

gh-pages分支使用生成的html页面进行更新。GitHub Environment选项卡提供了到组织页面的链接。点击它会出现404。

根据 https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/

具有这种类型存储库名称的用户页和组织页为 只从主分支发布

如果我理解正确的话，如果你创建的是用户或组织网站而不是项目网站，GitHub页面将不会从gh-pages分支发布。

我重命名了我的repo，使其成为Project站点而不是Organization站点，然后gh-pages分支按预期发布。

我在使用typedocs时遇到了这个问题。README。md工作，但没有实际的文档由我的文档字符串显示，我只是得到了一个404 Github页面屏幕。

要解决这个问题，只需在你的/docs目录(或任何你生成文档的地方)中放置一个空文件，并将其命名为.nojekyll

为了确认，你的文件结构现在应该看起来像:

./docs/.nojekyll  # plus all your generated docs

把这个推到你的远程Github回购和你的链接等现在应该工作。

同时确保你在你的Github设置中选择了:

Settings -> Github Pages -> Source -> master brach /docs folder

根据你的文档框架，你可能必须在每次更新你的文档时重新创建这个文件，这是一个使用typedocs和每次在包中创建.nojekyll文件的例子。json文件:

# package.json

      "scripts": {
        "typedoc": "typedoc --out docs src && touch docs/.nojekyll"
      },

昨天我遇到了同样的问题(在一个新建立的GitHub页面网站上出现404)。我尝试了很多方法，比如切换一个新的主题等。但它似乎对我的案子仍然不起作用。我最终通过将GitHub页面网站的分支切换到另一个分支来解决这个问题，单击保存。等一会儿再换回去。然后问题突然解决了。

我所有的文件只有一次提交。我推送了一个空提交，刷新了页面，它工作了。

git commit --allow-empty -m "Trigger rebuild"
git push

如果这不起作用，正如@Hendrikto在评论中指出的那样，检查Github状态页面，并确保Github页面是可操作的。

在我的例子中，URL相当长。所以，我想这是有限度的。我把它放在我的自定义子域，它工作。

我也有同样的问题。非常奇怪的问题。 我的HTML标题后面有空格

> <title>
> 
> <script>

固定，去除空间后

> <title>
> <script>