页面构建失败:数据文件中的 YAML 无效
如果 GitHub Enterprise 页面站点的 _data
文件夹中的一个或多个文件包含无效的 YAML,GitHub Enterprise 页面将无法构建。
如果 GitHub Enterprise 页面站点因 YAML 剖析错误而构建失败,将会收到一封如下的电子邮件:
主题:页面构建失败
页面构建因以下错误而失败:
filename
中的第line_number
columncolumn_number
行有 YAML 语法错误:syntax_error
。
只有在 Enterprise 实例上启用了出站电子邮件支持时,您才会收到电子邮件。有关详细信息,请联系您的站点管理员。
YAML 剖析错误故障排除
提示:我们强烈建议本地运行 Jekyll,以便在推送到 您的 GitHub Enterprise Server 实例 之前能够轻松调试和修复构建错误。要详细了解故障排除选项,请参阅“GitHub Pages 构建故障排除。”
对 _data
文件夹中的 YAML文件进行以下检查:
-
检查 YAML 文件中的标识,并删除任何制表位字符,因为这些字符不符合对 YAML 文件提议的间距。
-
确保键值与其前面的冒号之间有一个空格。
正确示例:
key: value
构建失败示例:
key:value
-
检查条目是否有多行值。 包含
|
会为值中的每一行创建换行符,而包含>
会忽略换行符而将所有内容放于一行。 -
确保使用适当的引号。 可能需要用引号括住 URL,以及以 YAML 特殊字符开头或在冒号后包含 YAML特殊字符的变量或字符串。
提示:您可以使用 YAML Lint 等工具帮助诊断和修复 YAML 错误。
在修复所有 YAML 错误后,需要提交更改并再次推送到 GitHub 页面仓库,以在服务器上触发另一次构建。
如需 Jekyll 数据文件的更多帮助,请参阅 Jekyll 文档。