这是我的GitHub仓库在gh-pages分支。 一切看起来都很好,我有index.html, CSS, JS和图片文件夹。
但是当我访问http://roine.github.com/p1时,我得到HTTP 404没有找到。
有什么解释和解决方案吗?
这是我的GitHub仓库在gh-pages分支。 一切看起来都很好,我有index.html, CSS, JS和图片文件夹。
但是当我访问http://roine.github.com/p1时,我得到HTTP 404没有找到。
有什么解释和解决方案吗?
当前回答
我在使用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。 然后我添加了README。Md在我的存储库上,404消失了。
就我而言,上面的建议都是正确的。我有大多数页面工作,除了少数返回404,即使降价文件在那里,他们似乎是正确的。以下是我在这几页上看到的东西:
在一个页面上,有一些特殊字符不是UTF-8的一部分,我想这就是为什么GitHub页面无法呈现它们的原因。更新/删除这些字符并提交新的提交可以修复它。 在另一个页面上,我发现标题周围有撇号,我删除了它们,页面内容开始显示正常
此外,GitHub页面目前不支持Git LFS。因此,如果你在GitHub页面中有图像(或其他二进制资产)使用Git LFS提交,你将得到404不对这些文件。
这对于用Doxygen或类似工具生成的文档来说是很常见的。
这种情况下的解决方案就是不使用Git LFS提交这些文件。
对我来说,关键是认识到你可以通过到你的github repo中的“Actions”选项卡看到构建过程中的错误消息。点击最新的“页面构建和部署”工作流显示了阻止发布的错误消息(my _config.yml中的一个简单错误)。
我的情况是2017年8月8日
如果您的用户页面为https://github.com/mgravell,则您的回购名称必须为 mgravell.github.io 在根目录下,创建一个index.html文件 在根目录下,创建一个文件夹docs,创建一个文件 文档下的CNAME(注意:没有像.txt这样的扩展名,确保你的文件 系统显示扩展) Gh-pages分支是可选的,master分支就足够了
更多信息:查看官方文档:https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/