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

转到存储库的设置部分，在源部分选择主分支，并在刷新页面后单击保存按钮，您将能够看到页面的链接!

在我的例子中，我有名称以_开头的文件夹(如_css和_js)， GH Pages根据Jekyll处理规则忽略这些文件夹。如果不使用Jekyll，解决方法是在根目录中放置一个名为.nojekyll的文件。否则，您可以从这些文件夹中删除下划线

你的GitHub页面可以在http://roine.github.io/p1而不是http://roine.github.com/p1。

顺便说一下，您可以修改项目的描述。

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

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