如何看懂Github优秀的项目-剖析

关于如何使用Github可以查看我的文章:全网最全面的GitHub使用教程

以项目 https://github.com/twbs/bootstrap 为例。

1 项目的主页面

在这里插入图片描述
页面的左上角 twbs 为项目的拥有者,项目名称为 bootstrap 。点击twbs可看到该用户的所用项目清单。

右上角“眼睛Watch”为对这个库的关注人数,当该库有新的变化时关注用户会得到通知。

右上角“星星Star”表示这是对其表示喜欢的用户数。

右上角“分叉Fork”表示分叉这一库文件的用户数,通过分叉可制作自己的副本用于新的想法的实现。

往下看,“commit”为总的提交(修改)次数,“braches”为历史数据流数,“releases”为版本发布的次数,“contributors”为参与本项目编写的贡献者数。

再往下可看到一行对该项目最新修改的贡献者、贡献时间等信息。

再往下是项目中包含的一些主要目录及文件。

2 查看README.md文件

GitHub项目的主目录中会包含一个“README.md”文件。

该文件提供对项目的说明和其他额外信息,这对合作者非常有用,比如,如何安装软件,如何运行任何自动化测试,如何使用代码,以及如何对项目作出贡献。

3 查看历史提交

点击前文介绍的“commits”可以看到历史提交的清单。

单击任何一个提交将会展示提交的信息,解释作出修改的原因,以及具体的添加、删除和修改的操作。(其中删除的内容是红色表示,添加的内容是绿色表示)在这里插入图片描述

4 查看拉请求

点击主页面的“Pull requests”可以看到拉请求列表,这些是人们正在使用的优秀功能或修复。

单击其中一个拉请求,将会看到描述拉请求的简短标题。

所提的修改对应有一个或多个提交,可能还有一些正在讨论的评论。

查看拉请求可了解人们正在做什么以及每个修改所处的当前状态,是修改缺陷还是功能建议。

5 查看问题

单击“issues”可查看问题的列表,它展示了当前项目仍然存在的问题以及相关的评论。

拉请求通常与一个问题相连接,但通常还有一些问题还没有人开始做,因此这些问题没有拉请求。

如果任何一项工作已经完成并推送到GitHub上,同时提交信息与问题有关,那么它将在问题页面上显示。

6 查看脉冲

单击“Insights”查看脉冲,脉冲是了解一个项目近期活跃的很好的方式。

脉冲页显示拉请求预览,包括已经合并的拉请求数量以及提出提出的拉请求数量,还有关闭的和新提出的问题。

下一部分显示了最近变化的简明摘要,包括作者的数量、向主分支的提交数、所有分支的提交数、在主分支上增加、删除或修改的文件的数量,还有添加或删除的评论行数。

右边的柱状图显示了此期间最多提交的贡献者。

下面一部分显示的是合并的和建议的拉请求标题,随后是关闭的问题或开放的问题。
最后一部分是“未解决的对话”,包含已经收到其他意见但尚未关闭的所有问题和拉请求。

在这里插入图片描述

7 查看GitHub上的图表

7.1 贡献者图表

在这里插入图片描述

点击“Contributors”可查看贡献者的图表信息,包括所有贡献者数量和单个贡献者的贡献。

可拖动鼠标在图上移动选择关心的时间段的情况。

7.2 提交图

在这里插入图片描述
点击“commits”可查看当前时间周期提交的数量。

柱状图显示生命周期内的每周提交数量,下面折线图显示一周内平均每天提交的数目。

7.3 码频图

在这里插入图片描述
点击“Code frequency”显示一段时间内从项目中添加和删除的行数,帮助理解代码库的变化情况,特别可注意代码发生重大重构的时间和从而去了解重构的具体信息。

7.4 网络图

在这里插入图片描述
点击"Network"可查看网络图,它显示了分支数量以及贯穿整个项目历史分支上的提交数量,以及贡献者创建的分叉数量。

它可以帮助查看一个分支到底进展有多远,或者查看某些人在自己分支内正在做哪些类型的工作。

当这些提交通过一个拉请求撤回到原来存储库的主分支时,我们将看到图中有一个箭头和一个合并提交,可以将鼠标移动到这些提交上查看是谁写的及提交的信息是什么。

7.5 成员列表图

在这里插入图片描述
点击“Fork”可查看成员列表图

猜你喜欢

转载自blog.csdn.net/weixin_40535588/article/details/111933197