Github Pages - 包含的文件是符号链接或不存在

Question

我在GitHub页面上构建我的网站时遇到了问题。我收到以下消息：

  

您的网页在构建时出现问题：docs/samples/widgets/custom_services.html中包含的文件是符号链接或_includes目录中不存在。

可以在https://github.com/igrejaadventista/iasd-bootstrap/tree/master/docs

查看所有文件

包含的文件确实存在且不是符号链接。 在本地我没有任何问题构建页面或在浏览器上查看它们。

有关正在发生的事情的任何建议？

Answer 1

您似乎正在使用custom source。 您不允许在GitHub页面上的Jekyll网站中使用自定义来源。他们override it to your repo's top directory。因此，它正在寻找./_includes/...而不是./docs/_includes。

Answer 2

看来你正在使用Jekyll，这个答案是2岁，但对于其他有类似问题的人：检查你是否需要Jekyll。如果不这样做，将名为.nojekyll的空文件添加到存储库的根目录应该可以修复它。

Answer 3

我在GitHub上部署了一个由Bulma于2017年构建的旧网站时遇到了类似的问题。更新所有依赖项后，我仍然遇到与Filipiz相同的错误。我删除了/ docs文件夹，使用git status重新部​​署，添加，提交和推送，它起作用了！

Answer 4

对我来说，问题是我正在使用Jekyll，并且有一个RubyGem不受Github Pages支持。

如果您遇到上述错误并使用Jekyll，我建议尝试以下方法：

1. 尝试在本地进行构建（在终端或bash中运行bundle exec jekyll serve），并检查是否可以找到根本原因。您需要为此安装Ruby和Bundler。

2. 如果站点在本地构建时没有任何问题，则Github中的构建问题可能是由于Gem版本不同所致。您可以检查Github页面here使用的Gems版本。尝试将本地使用的Gems更改为Github页面使用的Gems，以在本地重现问题。

3. 如果您仍然想使用已安装的Gems，并且不需要通过Github页面完成构建，则可以通过执行jekyll serve并在本地生成静态站点来生成静态站点“ _site ”文件夹中的内容添加到存储库的主分支。这样可以更好地控制我们要使用的宝石

Answer 5

只需创建并添加一个文件名为＃34; .nojekyll＆＃34;的新文件。这应该解决它