如何在GitHub中对小项目进行组织和分类?

poo*_*deh 7 python git development-environment github organization

我是开发新手,正在尝试将我开发的小项目上传到我的 GitHub 个人资料中。这些项目并不相互依赖。

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

这是一个好的做法吗?

  • 如果是,我应该如何在 Git 中进行操作,以及如何才能为每个迷你项目显示 README 文件。

  • 如果不是,您建议做什么?

pok*_*oke 5

GitHub 将为您访问的每个文件夹呈现一个 README 文件,因此当仅使用单个存储库时,一种解决方案是仍然为每个 \xe2\x80\x9csubproject\xe2\x80\x9d 创建一个子文件夹,因此可以拥有其自己的自述文件。

\n\n

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

\n\n

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

\n\n
    \n
  • 如果这些项目不依赖于另一个项目,它们仍然相关吗与另一个项目例如,这些项目是像欧拉项目这样更大的编程挑战的一部分,而您\xe2\x80\x99只是收集所有解决方案吗?那么单个存储库可能更有意义。
  • \n
  • 单个项目发展成为更大项目的机会有多大?许多事情一开始都很小,但最终可以成长为真正的东西,证明自己的存储库是合理的。到那时,您甚至可能会让其他人做出贡献。
  • \n
  • 这些单独的文件共享历史记录有意义吗?文件一旦变成 \xe2\x80\x9cdone\xe2\x80\x9d 后还会被编辑吗?也就是说,这只是完成品的集合,或者它们实际上是正在进行的实验?
  • \n
\n\n

最终,这取决于您的个人选择。但 GitHub 作为存储库托管商,不应该左右你的决定。您应该在本地创建 Git 存储库,因为这对您有意义。如果这意味着您只有一个,那么 \xe2\x80\x99 就可以了。如果这意味着您创建了很多它们,那么 \xe2\x80\x99s 也可以。

\n\n

不幸的是,GitHub UI 并不是真正为小型一次性项目设计的。存储库列表只是杂乱无章。如果您决定使用小型项目,我建议您在 GitHub 个人资料中添加一些用于分类的前缀,这样您就知道这是关于什么的。

\n\n

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

\n