【Chapter 5】详细解说 GitHub 的功能
5.1 键盘快捷键
在各个页面按下 shift+ /
都可以打开键盘快捷键一览表(如图), 查看当前页面的快捷键。
快捷键.png
5.2 工具栏
-
关于 UI
工具栏常驻于各个页面的上端,让我们先来讲解它的相关知识
- Notifications
用于提示用户是否有新的通知。用户在新建 Issue、被评论、进行 Pull Request 等时都会收到通 知。另外,按照默认设置,用户在 GitHub 收到的通知会同时发送到该 用户的注册邮箱。邮箱接收通知的相关设置在 Account settings 中进行。
- 搜索窗口
在这里输入想找的用户或代码片段,就可以搜索到与之相关的 信息。
- Explore
从各个角度介绍 GitHub 上的热门软件。
- Gist
Gist 功能主要用于管理及发布一些没必要保存在仓库中的代码,比 如小的代码片段等。笔者就经常把一些随便编写的脚本代码等放在 Gist 中。系统会自动管理更新历史,并且提供了 Fork 功能。另外,通过 Gist 还可以很方便地为同事编写代码示例。
- Greate a new ...
创建新的 Git 仓库或 Organization,向 Organization 添加成员、小组、仓库,为仓库添加 Issue 或 collaborator 等操作的菜单都聚集在这 里。显示内容会根据当前页面不同而改变。
- 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,有多少人参与了这个仓库的开发等, 都可以在这里一目了然。
第五章我是真的不愿意写下来的,因为好多我也不太懂,毕竟没有实际使用过,看了也是过眼云烟,我写下来的目的就是留个印象,以后有需求再回过来看一看。