页面构建失败:未知标记错误
如果 GitHub 页面代码无法识别的 Liquid 标记,GitHub 页面站点将无法构建。
如果 GitHub 页面 站点因无法识别的 Liquid 标记而构建失败,将会收到一封如下的电子邮件:
主题:页面构建失败
页面构建因以下错误而失败:
index.html
中的标记fake_tag
不是已识别的 Liquid 标记。
只有在 Enterprise 实例上启用了出站电子邮件支持时,您才会收到电子邮件。有关详细信息,请联系您的站点管理员。
无法识别的标记错误疑难解答
提示:我们强烈建议本地运行 Jekyll,以便在推送到 您的 GitHub Enterprise Server 实例 之前能够轻松调试和修复构建错误。要详细了解故障排除选项,请参阅“GitHub Pages 构建故障排除。”
- 检查引用的文件中的标记。 它们应与 Jekyll 默认变量中的标记匹配。 确保标记名称没有输错。
检查插件输出是否有无法识别的标记
插件是无法识别的标记的常见来源。 由于 GitHub Enterprise 不支持大多数插件,因此常见的解决方法是本地构建并在页面仓库中包含其结果。 但有时此解决方法包含不在 Jekyll 默认变量中的标记,从而构建无法剖析。 有关支持的插件列表,请参阅“添加 Jekyll 插件到 GitHub 页面 站点”。
在修复所有标记错误后,需要提交更改并再次推送到 GitHub 页面 仓库,以在服务器上触发另一次构建。