在PULL_REQUEST_TEMPLATE.md中使用GitHub相对内部仓库链接

11
在PULL_REQUEST_TEMPLATE.md中按照指示使用相对链接(https://help.github.com/articles/about-readmes/#relative-links-and-image-paths-in-readme-files)时,链接不正确。在实际的PR中查看时:
  • [CONTRIBUTING.md](/.github/CONTRIBUTING.md)
路由到:https://github.com/.github/CONTRIBUTING.md
  • [CONTRIBUTING.md](.github/CONTRIBUTING.md)
  • [CONTRIBUTING.md](./.github/CONTRIBUTING.md)
路由到:https://github.com/owner/repo/compare/.github/CONTRIBUTING.md,而不是https://github.com/owner/repo/.github/CONTRIBUTING.md
将链接更改为../以向上跳一级可用于PR,但在GitHub UI中查看时会使链接断开。
在GitHub上查看链接是有效的:https://github.com/fs-webdev/fs-dialog/blob/master/.github/PULL_REQUEST_TEMPLATE.md,但在PR中则不行。
(我觉得这在2017年曾经有效过)
有什么正确的方法可以使相对链接在两种情况下都按预期工作?

相对链接从不以 / 开头。尝试删除链接开头的 /。实际上,链接的文档建议使用 ./(点在斜杠之前而不是之后),而您使用了 /. - Waylan
1
去掉斜杠前面的点或在其前面添加一个点会导致 GitHub 比较链接:https://github.com/owner/repo/compare/.github/CONTRIBUTING.md,因为这是 PR 起源的路径。 - Clif
我怀疑你需要做 github/CONTRIBUTING.md 或者 ./github/CONTRIBUTING.md - Waylan
1个回答

2

背景

不幸的是,给定的实现似乎只考虑了当前URL而非仓库中实际文件路径

创建问题时(例如通过:https://github.com/owner/repo/issues/new),同样存在这种限制:

[CONTRIBUTING.md](.github/CONTRIBUTING.md)

->

https://github.com/owner/repo/issues/.github/CONTRIBUTING.md

解决方法

我只能通过指定完整的URL路径(包括前导/)来使相对链接起作用:

[CONTRIBUTING.md](/owner/repo/.github/CONTRIBUTING.md)

->

https://github.com/owner/repo/.github/CONTRIBUTING.md

说了这么多,抽象化只能到达URL主机(即:https://github.com)。

网页内容由stack overflow 提供, 点击上面的
可以查看英文原文,
原文链接