源代码归档后,有很多方法可以在文章中引用它。三种常见的用例是
- 将链接添加到完整存储库在Software Heritage中存档
- 将链接添加到软件项目的精确版本
- 将链接添加到源代码文件的精确版本,一直到代码行的级别。
完整存储库
通过在用于请求存档的URL前面加上前缀,可以获得到Software Heritage中存档的完整存储库(及其所有开发历史)的链接https://archive.softwareheritage.org/browse/origin。例如,如果您保存的存储库是https://github.com/rdicomoso/parmap,则指向Software Heritage中保存的版本的链接将为
https://archive.softwareheritage.org/browse/origin/https://github.com/rdicomoso/parmap/
通过此链接,您的读者可以广泛浏览存储库的内容深入研究其开发历史和/或目录结构,直至每个文件。
使用软件遗产固有标识符(SWHID)
软件遗产提供了完全文档化的标准标识符模式,已调用斯威德,为任何软件工件配备内在的标识符。可以找到使SWHID成为再现性标识符选择的特性的完整讨论在一篇专门的研究文章中,你可以在一篇专门的博客文章中了解更多关于其日益普及的信息.
SWHID可以配备一套丰富的限定符这可以精确地确定要查看给定工件的上下文。
这里我们只举几个例子说明如何使用它们。
项目的具体版本
以下SWHID标识了精确版本Parmap源代码的:
swh:1:版本:0064fbd0ad69de205ea6ec6999f3d3895e9442c2;原产地=https://github.com/rdicomoso/parmap
通过在SWHID前面添加前缀,可以将其转换为可点击的URLhttps://archive.softwareheritage.org/。因此,以下(超)链接将您直接带到Software Heritage中的一个页面,该页面正在浏览精确的版本(试试看!)
https://archive.softwareheritage.org/swh:1:rev:0064fbd0ad69de205ea6ec6999f3d3895e9442c2;原产地=https://github.com/rdicomoso/parmap
获得正确SWHID的一个非常简单的方法是浏览Software Heritage中的存档代码,并导航到您感兴趣的修订版。然后单击永久链接垂直红色标签它出现在存档的所有页面上,在打开的选项卡中选择修订标识符
SWHID的版本1使用git-compatible散列,因此,如果您使用git作为版本控制系统,则只需在前面加上前缀即可创建正确的SWHIDswh:1:转速:到提交哈希。
代码片段
Software Heritage支持的SWHID允许您更进一步,通过使用行=限定符可用于指向文件的标识符。例如,以下SWHID展示了内容SWHID的所有可用限定符,它指向Parmap源代码中的核心映射算法,如2012年描述Parmap的一篇研究文章所示:
交换机:1:cnt:d5214ff9562a1fe78db51944506ba48c20de3379;原产地=https://gitorious.org/parmap/parmap.git;访问=swh:1:snp:78209702559384ee1b5586df13eca84a5123aa82;锚=swh:1:版本:0064fbd0ad69de205ea6ec6999f3d3895e9442c2;路径=/parmap.ml;行=101-143
点击测试这个链接:您将被无缝地带到Software Heritage存档中的一个页面上,该页面显示了相应的源代码,并突出显示了相关行。

在这里,您也可以通过导航到您对存档感兴趣的代码片段,单击片段第一行的行号,按住shift键并单击最后一行,然后打开permalinks选项卡来获得准确的链接。
软件的书目条目
最后但并非最不重要,biblatex软件,一种充分利用SWHID的书目风格是现在可从CTAN向BibLaTeX用户提供。请参阅文档在那里可以了解更多!