如何看懂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”可查看成员列表图