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

页面构建失败:已配置相对永久链接

如果您在 _config.yml 文件中设置了相对永久链接,应会收到页面构建失败的消息,建议您从 _config.yml 文件删除 relative_permalink 选项,并将站点中的任何相对永久链接替换为绝对永久链接。

如果 GitHub 页面 站点已在 _config.yml 文件中配置用于相对永久链接,则会收到一封如下的电子邮件:

主题:页面构建失败

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

您的站点使用 relative_permalinks 配置选项。 此

设置已废弃,因为已从最新版本的

Jekyll 中删除。 为确保您的站点继续按预期构建,请从

站点的配置中删除此选项,并将任何发布或页面

永久链接更新为站点根目录(而非父文件夹)的绝对永久链接。

永久链接是引用特定 GitHub 页面 站点上特定发布或页面的永久 URL。

更多信息请参阅 Jekyll 关于永久链接的正式文档

GitHub 页面 和 Jekyll 不再支持相对永久链接。 您必须从 GitHub 页面 site's _config.yml 文件中删除 relative_permalinks 配置选项,并将站点中的任何相对永久链接重新格式化为绝对永久链接。

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

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

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

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

  4. 找到以 relative_permalinks: 开头的行,并删除整行。

    config.yml 中的 relative-permalinks-value

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

    关于更改的提交消息

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

    提交分支选项

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

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

  1. 搜索站点的发布或页面中的相对永久链接。
  2. 将相对永久链接替换为绝对永久链接。

问问别人

找不到要找的内容?

联系我们