近年来,将徽章添加到存储库的README文件中的趋势变得非常流行。存在许多可能性;许可证、持续集成、通过测试、同行评审、聊天、发布日期等等…
我们很高兴介绍Software Heritage徽章(swh-badges),您可以使用它链接到存档的源代码。
徽章有三种类型:
- 存档存储库:指向在Software Heritage中存档的存储库位置的链接。
其中包含SWH访问的所有快照,并经常更新,此处是存档的链接Unipisa公司/CMM公司
- 发布:指向特定发布的持久位置的链接。
徽章显示了用于发布的标记,这里是CMM存储库的1.9版本。
- 源代码工件(例如快照、版本、目录或文件):使用SWH-ID指向工件持久位置的链接
这里是1.9 CMM版本的目标版本。
Software Heritage支持的SWH-ID允许您更进一步,通过使用行=限定符可用于指向文件的标识符。
例如,以下SWH-ID指向Parmap源代码中的核心映射算法,如2012年描述Parmap的一篇研究文章所示:
此功能也可用于源代码工件swh-badge:尝试单击下图,然后查看!
如果您想了解更多关于SWH-ID的信息,这是一个有完整文档记录的标准标识符模式,请参阅文档.
获取您想要的徽章的一个非常简单的方法是浏览Software Heritage中的存档代码,并导航到您感兴趣的位置。然后单击存档所有页面上的永久链接垂直红色选项卡,并在打开的选项卡中选择您需要徽章的工件。存档存储库徽章始终可用:
然后,您可以单击徽章本身,您将找到用于在HTML、Markdown或reStructuredText中插入徽章的文本。
就是这样!
我们邀请您使用这些新徽章,以便轻松访问源代码的存档版本。