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

页面构建失败:配置文件错误

如果 GitHub 页面仓库中的 _config.yml 文件有语法错误,将无法构建 GitHub 页面站点。

如果 GitHub 页面 站点因 _config.yml 文件包含语法错误而构建失败,我们会向您发送一封如下的电子邮件:

主题:页面构建失败

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

_config.yml 文件的第 1 行有错误。

_config.yml 语法错误疑难排解

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

检查构建失败电子邮件引用的行上的 _config.yml 文件。 确保:

使用 YAML 语法检查(如 http://codebeautify.org/yaml-validator)验证 YAML 代码。 如果 _config.yml 文件发生剖析错误,请尝试复制并粘贴文件内容到此类工具以了解更多详情。

在修复 _config.yml 文件中的任何语法错误后,需要提交更改并再次推送到 GitHub 页面 仓库,以在服务器上触发另一次构建。

修复高亮错误

如果尝试在具有 Jekyll 的 GitHub 页面 站点上使用 Rouge 以外的语法高亮插件,您将会收到页面构建警告。 GitHub 页面 不支持其他高亮插件,将自动使用默认的 Rouge。 更多信息请参阅“在 GitHub 页面 上使用语法高亮插件”。

要修复页面构建警告,必须将 _config.yml 文件中的 highlighter 值改为 rouge

  1. 在 GitHub 上,导航到仓库的主页面。

  2. 在仓库中,浏览到 _config.yml

  3. 在文件视图的右上角,单击 打开文件编辑器。

    使用编辑图标打开文件编辑器

  4. 找到以 highlighter: 开头的行,将值更改为 rouge

    config.yml 中的 Rouge highlighter 值

  5. 在页面底部,键入简短、有意义的提交消息,描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。更多信息请参阅“创建多个合作作者的提交."

    关于更改的提交消息

  6. 在 commit message(提交消息)字段下方,决定要将提交添加到当前分支还是添加到新分支。如果当前分支为 master,则应选择为提交创建新分支,然后创建拉取请求

    提交分支选项

  7. 单击 Propose file change(提议文件更改)

    Propose file change(提议文件更改)按钮

延伸阅读

问问别人

找不到要找的内容?

联系我们