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