页面构建失败:已配置相对永久链接
如果您在 _config.yml 文件中设置了相对永久链接,应会收到页面构建失败的消息,建议您从 _config.yml 文件删除 relative_permalink
选项,并将站点中的任何相对永久链接替换为绝对永久链接。
如果 GitHub 页面 站点已在 _config.yml 文件中配置用于相对永久链接,则会收到一封如下的电子邮件:
主题:页面构建失败
页面构建因以下错误而失败:
您的站点使用
relative_permalinks
配置选项。 此设置已废弃,因为已从最新版本的
Jekyll 中删除。 为确保您的站点继续按预期构建,请从
站点的配置中删除此选项,并将任何发布或页面
永久链接更新为站点根目录(而非父文件夹)的绝对永久链接。
了解相对和绝对永久链接
永久链接是引用特定 GitHub 页面 站点上特定发布或页面的永久 URL。
- 绝对永久链接是以网站根目录开始头的 URL。
- 相对永久链接是以父文件夹(包含引用的网页的文件夹)而非站点根目录开头的修改后 URL。
更多信息请参阅 Jekyll 关于永久链接的正式文档。
相对永久链接错误疑难解答
GitHub 页面 和 Jekyll 不再支持相对永久链接。 您必须从 GitHub 页面 site's _config.yml 文件中删除 relative_permalinks
配置选项,并将站点中的任何相对永久链接重新格式化为绝对永久链接。
从 config.yml 中删除 relative_permalinks:
-
在 GitHub Enterprise 上,导航到仓库的主页面。
-
在仓库中,浏览到 _config.yml。
-
在文件视图的右上角,单击 打开文件编辑器。
-
找到以
relative_permalinks:
开头的行,并删除整行。 -
在页面底部,键入简短、有意义的提交消息,描述您对文件所做的更改。您可以在提交消息中将提交归因于多个作者。更多信息请参阅“创建多个合作作者的提交."
-
在 commit message(提交消息)字段下方,决定要将提交添加到当前分支还是添加到新分支。如果当前分支为
master
,则应选择为提交创建新分支,然后创建拉取请求。 -
单击 Propose file change(提议文件更改)。
将相对永久链接替换为绝对永久链接
- 搜索站点的发布或页面中的相对永久链接。
- 将相对永久链接替换为绝对永久链接。