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

我在我的回购上做了所有的技巧来修复Github page (https://eq19.github.io/)上的404页，但它保持了404'ing。

最后我发现我的浏览器几乎无法保持10分钟的缓存。

只需将/index.html添加到URL的末尾，它就会出现并解决这个问题。

https://username.github.io/{repoName}/index.html

四个月前，我联系了技术支持，他们告诉我这是他们方面的问题，他们已经暂时修复了它(目前的提交)。

今天我再次尝试

我删除了github上的gh-pages分支 Git push origin——删除gh-pages 我在本地删除了gh-pages分支 git分支-D gh-pages 我重新初始化git git init 我在本地重新创建了分支 Git分支gh-pages 我把gh-pages分支推到了github上 Git推送原始gh-pages

工作正常，我终于可以在页面上更新我的文件了。

我也有同样的问题。非常奇怪的问题。 我的HTML标题后面有空格

> <title>
> 
> <script>

固定，去除空间后

> <title>
> <script>

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

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

如果你确定你的结构是正确的，只需要推送一个空的提交，或者更新index.html文件，增加一些空间，就可以了!