我的情况是2017年8月8日

如果您的用户页面为https://github.com/mgravell，则您的回购名称必须为 mgravell.github.io 在根目录下，创建一个index.html文件 在根目录下，创建一个文件夹docs，创建一个文件 文档下的CNAME(注意:没有像.txt这样的扩展名，确保你的文件 系统显示扩展) Gh-pages分支是可选的，master分支就足够了

更多信息:查看官方文档:https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/

在这个问题出现之前，我绑定了我的域。我提交并推送了分支gh-pages，它解决了我的问题。新提交迫使jekyll重新构建页面。

我也遇到了这个问题，我的页面得到404。 然后我添加了README。Md在我的存储库上，404消失了。

只要等十分钟到一小时。如果还是不行，联系github。通常是他们的问题。 但是，如果你赶时间，你可以试着在URL的末尾加上“?”问号来打开。它强制查询资源。是这样的:

http://roine.github.com/p1?

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

还有另一种情况:

使用组织页(不是项目页)，该组织页有一个名为<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分支按预期发布。