当我将 Hugo 站点部署为 Github Pages 项目时出现链接问题

Links issue when I deploy my Hugo site as a Github Pages project

我创建了一个在本地运行良好的 Hugo 站点。我通过 master 分支上的 /docs 文件夹将我的 Hugo 站点部署为 Github Pages 项目。 所以现在,我有了我的 Github 页面项目,我的 URL 看起来像这样:

https://myname.github.io/myrepository/myHugoSite.

我的 link 有问题。我所有的 link 都重定向到 https://myname.github.io/ but not https://myname.github.io/myrepository/,因为我的 link 是 /next-page/。这些 link 正在本地工作,因为我没有存储库。

我的问题是:我是否必须将 /myrepository/ 添加到我的所有 link 中,还是有其他解决方案?

您需要将站点前缀添加到 config 文件中的 baseUrl 参数。在您的情况下,前缀是 myrepository/

如果您在配置文件中使用 TOML 格式,它将如下所示:

baseUrl = "https://myname.github.io/myrepository/"

请注意,使用 Higo 0.62.1(及更新版本),您可以拥有可移植链接。

bep/portable-hugo-links为例。

truly portable Markdown links and images. No shortcodes used.

This page 包含以下链接,这些链接将在 GitHub 和 Hugi 生成的页面上正确呈现:

* [Blog Link1](../blog/p1/index.md)
* [Blog Link2](../blog/p2.md)
* [Home Page](/README.md)
* [Local Anchor](#et-illis-ossaque-loqui-ille)