GitHub 更新日志链接到提交

GitHub changelog links to commits

一些项目有一个 CHANGELOG.md 文件,其中每个版本 link 都在为该版本所做的提交范围内。例如,this one. It looks like these links are automatically generated somehow, because the markdown only contains [1.0.0] where the rendered document has a link to https://github.com/olivierlacan/keep-a-changelog/compare/v0.3.0...v1.0.0.

这是如何运作的?我曾尝试在我自己的项目中做这样的事情,但呈现的文档只是说 [1.0.0];没有生成 link。

大概是跟标签有关,标签也有类似的模式(v1.0.0),但是当我试图在我的项目中创建类似的标签时,它仍然没有用。

我在 GitHub 帮助或其他任何地方也找不到与此相关的参考。

这确实是 GitHub 的一个(未记录的?)功能吗?如果是,它是如何工作的?如果没有,这些项目是如何做到的?

请注意,我对像 this project 那样从提交自动生成变更日志不感兴趣。我只是对这些 hyperlinks 的机制感兴趣。

你需要深入了解 Markdown 的表面,这是他使用文件比较功能比较标签的一个简单技巧。

如果你查看 RAW 文件,你应该注意到他在底部添加了 links 到每个分配有比较 link 的版本号。

## [1.0.0] - 2017-06-20

[1.0.0]: https://github.com/olivierlacan/keep-a-changelog/compare/v0.3.0...v1.0.0

使用漂亮模式,您会在比较页面看到 link。