页面构建失败:包含目录中不存在文件
如果 GitHub 页面代码引用 _includes 目录中不存在的文件,GitHub 页面站点将无法构建。
如果引用 _includes 目录中不存在的文件,您将会收到一封如下的电子邮件:
主题:页面构建失败
页面构建因以下错误而失败:
文件包含在
_includes
目录下不存在的example.html
中
只有在 Enterprise 实例上启用了出站电子邮件支持时,您才会收到电子邮件。有关详细信息,请联系您的站点管理员。
文件不存在错误疑难排解
提示:我们强烈建议本地运行 Jekyll,以便在推送到 您的 GitHub Enterprise Server 实例 之前能够轻松调试和修复构建错误。要详细了解故障排除选项,请参阅“GitHub Pages 构建故障排除。”
- 使用您常用的文本编辑器打开在构建失败电子邮件中提及的文件。
- 搜索
include
标记,查看引用其他文件的位置。 例如:{% include example_header.html %}
. - 如果引用了不在 GitHub 页面 仓库的 _includes 目录中的任何文件,则需要将这些文件复制或移入 _includes 目录。 如果文件根本不存在,则需要创建。
- 提交更改并推送到 GitHub 页面 仓库以在服务器上触发另一次构建。