具有静态html的gh-pages在存在时无法访问文件

Question

index.html主页显示正常，但任何链接都会抛出404。

静态网站上有html文件夹，索引链接到这些带有正确路径的html，但显示的是404。

点击this link时，我得到了404。

但是文件以can see here的形式存在。

我真的在一个简单的html pb上敲我的头，令人沮丧。

Answer 1

我自己遇到了这个问题，最后发现了一个更简单的解决方案。问题是Jekyll ignores all files that start with _。简单的解决方案是在您的docs目录中添加.nojekyll文件。

我的文档脚本如下所示： "rimraf ./docs && typedoc src/ --out docs --mode modules --module commonjs --target es6 --excludePrivate && touch ./docs/.nojekyll && gh-pages -d docs -t"

touch是一个创建文件的npm模块，-t上的gh-pages标志是上传该点文件所必需的。

Answer 2

好吧，我可以在这里回答我自己的问题。

Github Page不允许使用多个静态HTML文件。

对于他们的文档说实话并不是很清楚，但解决方案很简单：

假设您的本地静态文档正常运行，请按以下步骤操作：

安装jekyll

gem install jekyll bundler

添加文件_config.yml

在您的docs或gh-pages分支的根目录中

：

auto: true

执行jekyll serve

并测试你的控制台输出的网址是否正常

在.gitignore

中添加_site

推和宾果！

如果你像我一样使用typedoc将打字稿编译成精美的文档，你就会遇到麻烦。

因为Jekyll自动从构建中排除任何以_开头的文件，并且只生成了typedoc，所以我写了一个simple yeoman generator来替换你。