这是我的GitHub仓库在gh-pages分支。 一切看起来都很好,我有index.html, CSS, JS和图片文件夹。

但是当我访问http://roine.github.com/p1时,我得到HTTP 404没有找到。

有什么解释和解决方案吗?


当前回答

如果还没有,请在GitHub Pages设置选项卡中选择Jekyll主题。显然,即使您的Pages站点没有使用Jekyll,这也是必需的。

其他回答

我也遇到了这个问题(404),根本原因是我的文件名为INDEX.md。我在Windows上开发,我的本地Jekyll网站工作正常(因为Windows默认不区分文件名大小写)。当推送到Github时,它不起作用。有一次我重命名了INDEX。Md到索引。Md,一切都很顺利。

在index.html文件的开头添加以下内容

<!DOCTYPE html>

我在使用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页面可以在http://roine.github.io/p1而不是http://roine.github.com/p1。

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

此外,GitHub页面目前不支持Git LFS。因此,如果你在GitHub页面中有图像(或其他二进制资产)使用Git LFS提交,你将得到404不对这些文件。

这对于用Doxygen或类似工具生成的文档来说是很常见的。

这种情况下的解决方案就是不使用Git LFS提交这些文件。