页面构建失败:文件未正确进行 UTF-8 编码
如果 GitHub 页面仓库包含未正确进行 UTF-8 编码的文件,GitHub 页面站点将无法构建。
如果 GitHub 页面 站点因编码错误而构建失败,将会收到一封如下的电子邮件:
主题:页面构建失败
页面构建因以下错误而失败:
文件
example.html
未正确进行 UTF-8 编码。
只有在 Enterprise 实例上启用了出站电子邮件支持时,您才会收到电子邮件。有关详细信息,请联系您的站点管理员。
UTF-8 编码错误疑难排解
提示:我们强烈建议本地运行 Jekyll,以便在推送到 您的 GitHub Enterprise Server 实例 之前能够轻松调试和修复构建错误。要详细了解故障排除选项,请参阅“GitHub Pages 构建故障排除。”
计算机预期文本显示为拉丁字符。 使用非拉丁字符(如 日本語
)而未告知计算机预期这些字符时,就会发生编码错误。
要强制 UTF-8 编码,请在 _config.yml 文件中添加以下行: encoding: UTF-8
在进行此更改后,您需要提交更改并推送到 您的 GitHub Enterprise Server 实例 上的页面仓库,以在服务器上触发另一次构建。
如需 Jekyll 配置的更多帮助,请参阅 Jekyll 文档。