python - GitHub 中如何对小项目进行组织和分类？

Question

我是开发新手，正在尝试将我从事过的小型项目上传到我的 GitHub 个人资料。这些项目彼此不依赖。

我的问题是其中一些是小型单文件项目。有点像我已经解决的小挑战。因此，我正在考虑将它们组合在一个名为“Python 编程”的存储库下，例如。

这是一个好的做法吗？

• 如果是，我应该如何在 Git 中处理它，以及我怎样才能让每个迷你项目都显示一个 README 文件。

• 如果不是，您会推荐做什么？

Answer 1

GitHub 将为您访问的每个文件夹呈现一个 README 文件，因此当只使用一个存储库时，一种解决方案仍然是为每个“子项目”创建一个子文件夹，这样可以有自己的 README 文件。

但在走那条路之前，您应该考虑一下这些小项目是否真的属于一起。这最终应该决定您是要将它们全部放在同一个存储库中，还是要将其拆分为多个存储库。

该决定需要考虑的一些事项:

• 如果项目不依赖于另一个，它们是否仍然与相关？例如，这些项目是否是像 Project Euler 这样更大的编程挑战的一部分，而您只是在收集所有解决方案？那么单个存储库可能更有意义。
• 单个项目发展壮大的机会有多大？许多事情开始时都很小，但最终会发展成真实的东西，证明他们自己的存储库是合理的。到那时，您甚至可以让其他人做出贡献。
• 那些单独的文件共享历史是否有意义？一旦“完成”，文件是否还要进行编辑？ IE。这只是成品的集合，还是实际上正在进行的实验？

最终，这取决于您的个人选择。但是 GitHub，作为存储库托管者，不应该 push 你的决定。您应该在本地创建 Git 存储库，因为这对您有意义。如果这意味着您只有一个，那很好。如果这意味着您创建了很多，那也没关系。

不幸的是，GitHub UI 并不是真正为小型一次性项目设计的。存储库列表只是为了无组织。如果您决定使用小型项目，我建议您在 GitHub 配置文件中添加一些分类前缀，这样您就知道这是关于什么的。

一次性项目的一个很好的选择，特别是当它只是一个(或几个)文件时 Gists . Gist 是作为一种共享代码片段的方式而诞生的，但在幕后，每个 Gist 实际上都是一个完整的 Git 存储库。当然，Gists 不提供 GitHub 上普通存储库所具有的工具(例如问题、 pull 请求、wiki)。但对于你所描述的，你可能不需要这些。然后，Gists 是一种很好的方式来共享简单的东西，而无需将完整的存储库添加到您的个人资料中。您仍然可以克隆它们(远程 URL 是 git@gist.github.com:/<gist-id>.git )并拥有完整的历史记录并支持多个文件(如果需要的话)。