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

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

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

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

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

这个错误的另一种变体:

我在一个教程之后建立了我的第一个Github页面，但给了文件自述。Md，在我看来，更有意义的名字:欢迎。Md。

这是一个致命的错误:

我们将使用您的README文件作为网站的索引，如果您没有 索引。Md(或index.html)，与您浏览到一个 GitHub上的存储库。

从发布GitHub页面，现在像1,2,3一样简单

然后，我可以使用Repository / Settings / GitHub Pages下指定的published at链接访问我的网站页面，后面跟着welcome.html或更短的欢迎。

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

我在看YT的视频。因此，当我在终端上运行该命令时，它已经将代码推到了gh-pages分支。然后我推到主分支。它给了我404错误。

然后我将分支切换到master，然后再次恢复到gh-pages，现在错误消失了。它指向index.html，即使它不在URL中。