我不得不将我的回购重命名为一个随机的名字，然后重命名为它原来的名字，让它工作。

看起来可能是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"
      },

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

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

我的页数也保持在404页。联系了技术支持，他们指出url是区分大小写的;解决了我的问题。

我通过删除“用户名。github”来让网站正常工作。在我的电脑上重新执行这些步骤，包括更改index/html文件。

我的错误(我认为)是我最初克隆了“https://github.com/username/username.github.io.git”而不是https://github.com/username/username.github.io(没有“。git”)

我的情况是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/