【Chapter 5】详细解说 GitHub 的功能

5.1　键盘快捷键

在各个页面按下 shift＋ / 都可以打开键盘快捷键一览表（如图）， 查看当前页面的快捷键。

快捷键.png

5.2 工具栏

• 关于 UI

  工具栏常驻于各个页面的上端，让我们先来讲解它的相关知识

  ​

  1. Notifications

  用于提示用户是否有新的通知。用户在新建 Issue、被评论、进行 Pull Request 等时都会收到通 知。另外，按照默认设置，用户在 GitHub 收到的通知会同时发送到该 用户的注册邮箱。邮箱接收通知的相关设置在 Account settings 中进行。

  ​

  2. 搜索窗口

  在这里输入想找的用户或代码片段，就可以搜索到与之相关的 信息。

  ​

  3. Explore

  从各个角度介绍 GitHub 上的热门软件。

  ​

  4. Gist

  Gist 功能主要用于管理及发布一些没必要保存在仓库中的代码，比 如小的代码片段等。笔者就经常把一些随便编写的脚本代码等放在 Gist 中。系统会自动管理更新历史，并且提供了 Fork 功能。另外，通过 Gist 还可以很方便地为同事编写代码示例。

  ​

  5. Greate a new ...

  创建新的 Git 仓库或 Organization，向 Organization 添加成员、小组、仓库，为仓库添加 Issue 或 collaborator 等操作的菜单都聚集在这 里。显示内容会根据当前页面不同而改变。

  ​

  6. Acount settings

  点击它可以打开 账户设置页面。在这里可以进行个人信息、安全管理、付费方案的设 置，各位在使用 GitHub 时请务必浏览一遍。

5.3 控制面板

点击 GitHub 图标即可进入，也是登录 GitHub 时，最先看到的页面。

• News Feed

  显示当前已 Follow 的用户和已 Watch 的项目的活动信息，用户可以在这里查看最新动向。将右上角 RSS 标志的 URL 添加到 RSS 阅读器 中，还可以通过 RSS 查看。

• Pull Requests

  显示用户已进行过的 Pull Request。通过这里，开发者可以很方便地追踪 Pull Request 的后续情况。

• Issues

  在这里可以查看用户拥有权限的仓库或分配给自己的 Issue。当用户 同时进行多个项目时，可以在这里一并查看 Issue。

• Stars

  以列表的形式显示用户添加了 Star 的仓库。有些仓库需要经常查 找，但又不必在 Watch中频繁显示详细信息时，可以给这些仓库添加 Star，方便自己随时在这一栏中找到它们。

• Broadcast

  主要用于接收 GitHub 公司发来的通知或使用技巧的小贴士。

• Repositories you contribute to

  显示用户做过贡献的仓库。按贡献时间的先后顺序排列。

• Your Repositories

  按更新时间顺序显示用户的仓库。标有钥匙图案的是非公开仓库， 标有类似字母 Y 图案的是用户 Fork 过的仓库。

5.7 Pull Request

Pull Request 是用户修改代码后向对方仓库发送采纳请求的功能，也 是 GitHub的核心功能。

获取 diff 格式与 patch 格式的文件：

假设 Pull…Request 的 URL 如下所示。
https://github.com/用户名/仓库名/pull/28

如果想获取diff格式的文件，只要像下面这样在URL末尾 添加 .diff 即可。
https://github.com/用户名/仓库名/pull/28.diff

同理，想要patch格式的文件，只需要在URL末尾添 加 .patch 即可。
https://github.com/用户名/仓库名/pull/28.patch
想要 diff 格式与 patch 格式文件的各位请按照上述方法进行 操作。

PUll Request 详细页中有三个标签：Conversation、Commits、Files Changed。

• Conversation

  在 Conversation标签页中，可以查看与当前 Pull Request相关的所 有评论以及提交的历史记录。人们在这里添加评论互相探讨，发送提交 落实讨论内容的整个过程会按时间顺序列出，供用户查看。

  引用评论：

  在Conversation中人们通过添加评论进行对话。这里有一 个简单方法可以帮您引用某个人的评论。选中想引用的评论然 后按 是 shift + R 键，被选择的部分就会自动以评论语法写入评论文本框 。

  ​

• Commits

  在 Commits标签页中，按时间顺序列表显示了与当前 Pull Request 相关的提交。标签上的数字为提交的次数。每个提交右侧的 哈希值可以连接到该提交的代码。

• Files Changed

  Files Changed 标签页中可以查看当前 Pull Request 更改的文件内容以及前后差别。标签上的数字表示新建及被更改的文件数。

  默认情况下系统会将空格的不同也高亮显示，所以在空格有改动的情况下会难以阅读。这时只要在URL的末尾添加“?w=1”就可以不显 示空格的差别。

  将鼠标指针放到被更改行行号的左侧，指针将变成手掌，点击进去就可以在代码中插入评论。这样，评论是针对哪行代 码的就一目了然了。 这个插入评论的功能让针对代码的讨论变得十分顺畅。特别是在多 人协作的软件开发中，这个功能更加不可或缺。

  ​

5.8 Wiki

Wiki是一个使用简单的语法就能编写文档的功能，所有有权限的人都可以对文章进行修改，所以比较适合多人共同编写文章的情况。

与 Issue 和 Pull Request 相同，Wiki也支持 GFM 语法，所以可以轻 松创建表现力丰富的文档。点击页面右上角的New Page按钮便可以创建新的 Wiki页。

Wiki 功能本身的数据也在 Git 中进行管理。点击 Clone URL 按钮可以将当前 Wiki 的 Git 仓库 URL 复制到剪贴板中。用户能够通过clone 操作获取Wiki仓库，然后在本地创建、编辑页面，进行提交再push， 便可以完成对 Wiki的创建及编辑工作。

5.9 Pulse

Pulse 是体现该仓库软件开发活跃度的功能。近期该仓库创建了多少Pull Request 或 Issue，有多少人参与了这个仓库的开发等， 都可以在这里一目了然。

第五章我是真的不愿意写下来的，因为好多我也不太懂，毕竟没有实际使用过，看了也是过眼云烟，我写下来的目的就是留个印象，以后有需求再回过来看一看。