我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们
文章版本: GitHub.com

页面构建失败:未知标记错误

如果 GitHub 页面代码无法识别的 Liquid 标记,GitHub 页面站点将无法构建。

如果 GitHub 页面 站点因无法识别的 Liquid 标记而构建失败,将会收到一封如下的电子邮件:

主题:页面构建失败

页面构建因以下错误而失败:

index.html 中的标记 fake_tag 不是已识别的 Liquid 标记。

无法识别的标记错误疑难解答

提示:我们强烈建议本地运行 Jekyll,以便在推送到 GitHub 之前能够轻松调试和修复构建错误。要详细了解故障排除选项,请参阅“GitHub Pages 构建故障排除。”

检查插件输出是否有无法识别的标记

插件是无法识别的标记的常见来源。 由于 GitHub 不支持大多数插件,因此常见的解决方法是本地构建并在页面仓库中包含其结果。 但有时此解决方法包含不在 Jekyll 默认变量中的标记,从而构建无法剖析。 有关支持的插件列表,请参阅“添加 Jekyll 插件到 GitHub 页面 站点”。

在修复所有标记错误后,需要提交更改并再次推送到 GitHub 页面 仓库,以在服务器上触发另一次构建。

问问别人

找不到要找的内容?

联系我们