Link 到特定的分支、标记或提交，或其中的特定文件，或该文件中的特定行？

Question

我创建了一个教程，我想在其中介绍一些测试框架，如 Mockito、WireMock 和 EasyMock。我想一步步解释。此外，我想提供示例，本教程的 reader 可以尝试重新创建这些示例。因此，我想给他们机会查看我的源代码，并在他们无法重新创建测试时使用它。然后他们可以使用实际版本继续，然后再一次，当他们无法创建下一个测试时，我想让他们有可能在新测试中使用我的新版本。

我的想法是使用不同的提交并将它们 link 用于教程。我该怎么做，或者有没有更好的方法来实现我刚才解释的内容？

Answer 1

轻松愉快！

基本方法是：在 GitHub 上浏览到您想要的内容，然后共享 URL。 GitHub URLs 是稳定的 permalinks，即使你导航到旧版本或另一个分支。

1. 打开 Github 中的存储库。
2. 浏览到您想要的分支、标记或提交。
   • 对于 branch/tag，文件列表的左上角有一个下拉菜单。
   • 对于特定的提交：
     1. 单击文件列表顶部的 Commits。这将带您进入显示所有差异的页面。 （如果你愿意，可以分享这个URL。否则继续下一步。）
     2. Clink on Browse files 右上角。
3. 您现在正在查看与您开始时一样的存储库视图，只是此视图属于特定分支、标记或提交。这就像一个 GitHub 时间机器。
   • 如果你想 link 到这个 branch/tag/commit 的整个仓库，现在就复制 URL。
   • 如果您想 link 到此 branch/tag/commit 中的特定文件，请导航到列表中的文件，然后复制 that URL.
   • 如果要 link 到文件中的特定行，请单击行号，然后单击出现在它旁边的 ... 按钮，然后单击 Copy permalink
   • 如果要link到文件中的某一行范围，请按住shift键并在行范围的另一端按clink。线条将突出显示。单击旁边出现的 ... 按钮，然后单击 Copy permalink

---

综上所述，除非您引导他们完成代码的多次迭代，否则我不确定将 link 提供给 git 历史版本是否可行。假设他们想克隆您的存储库。然后他们必须 git checkout example-2-version-3 什么的。

更典型的方法是将不同的版本放在一个目录层次结构中，使其更容易浏览，无论是在 GitHub 上还是在您的存储库的本地克隆上。