页面构建失败:子模块无效
如果 GitHub 页面包含对无效子模块的引用,GitHub 页面站点将无法构建。
如果 GitHub 页面 站点因子模块无效而构建失败,将会收到一封包含以下消息的电子邮件:
主题:页面构建失败
页面构建因以下错误而失败:
“为
./EXAMPLE_SUBMODULE
注册的子模块无法克隆。 确保其使用的 https://,并且是公共仓库。
只有在 Enterprise 实例上启用了出站电子邮件支持时,您才会收到电子邮件。有关详细信息,请联系您的站点管理员。
无效的子模块错误故障排除
提示:我们强烈建议本地运行 Jekyll,以便在推送到 您的 GitHub Enterprise Server 实例 之前能够轻松调试和修复构建错误。要详细了解故障排除选项,请参阅“GitHub Pages 构建故障排除。”
检查构建失败电子邮件中引用的子模块。 确保:
- 在引用子模块时使用
https://
,而不使用http://
。 - 子模块在公共仓库中。 GitHub 页面 服务器无法从私有仓库中的子模块构建。
在修复所有无效的子模块错误后,需要提交更改并再次推送到 GitHub 页面 仓库,以在服务器上触发另一次构建。