在一次私人回购中，当我第一次添加并将我的gh-pages分支推到github时，github页面的设置自动更改为指示将发布gh-pages分支，但github没有绿色或蓝色条。IO url，没有自定义域选项。

直到我将源代码切换到master，并快速将源代码切换回gh-pages，它才真正更新了包含已发布url的绿色条。

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

就我而言，上面的建议都是正确的。我有大多数页面工作，除了少数返回404，即使降价文件在那里，他们似乎是正确的。以下是我在这几页上看到的东西:

在一个页面上，有一些特殊字符不是UTF-8的一部分，我想这就是为什么GitHub页面无法呈现它们的原因。更新/删除这些字符并提交新的提交可以修复它。 在另一个页面上，我发现标题周围有撇号，我删除了它们，页面内容开始显示正常

我在使用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"
      },

在我的情况下，浏览器有我的应用程序以前的缓存版本。为了避免获得缓存版本，访问你的url使用一个随机查询字符串:

https://{{your-username}}.github.io/{{your-repository}}?randomquery

在我的例子中，我的存储库是私有的。将存储库设为公共并再次执行所有步骤。