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

在我的情况下，在react中有必要选择gh-pages分支:

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

以下操作帮助了我:

webpack构建:

Webpack output.publicPath

publicPath: './'

轻快地构建:

轻快地基础

base: './'

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

> <title>
> 
> <script>

固定，去除空间后

> <title>
> <script>

由于某种原因，GitHub页面的部署今天(2020年5月05日)停止工作。以前我没有任何html，只有md文件。我尝试创建一个index.html，它立即发布了页面。在删除index.html之后，发布将继续工作。