离线下载
PDF版 ePub版

Tim Green · 更新于 2018-11-28 11:00:43

Github 秘籍三

GitHub Pages 的元数据与插件支持

在 Jekyll 页面和文章里,仓库信息可在 site.github 命名空间下找到,也可以显示出来,例如,使用 {{ site.github.project_title }}显示项目标题。

Jemoji 和 jekyll-mentions 插件为你的 Jekyll 文章和页面增加了 emoji@mentions功能。

了解更多 GitHub Pages 的元数据和插件支持

查看 YAML 格式的元数据

许多博客站点,比如基于 JekyllGitHub Pages ,都依赖于一些文章头部的 YAML 格式的元数据。 Github 会将其渲染成一个水平表格,方便阅读。

进一步了解 在文档里查看 YAML 元数据

渲染表格数据

GitHub 支持将.csv(逗号分隔)和.tsv(制表符分隔)格式的文件渲染成表格数据。

进一步了解渲染表格数据

撤销 Pull Request

合并一个 Pull Request 之后,你可能会反悔:要么是这次 Pull Request 没什么用处,要么是还不到合并的时候。

此时可以通过 Pull Request 中的 Revert 按钮来撤销一个已合并的 Pull Request 中的 commit。按下按钮后将自动生成一个进行逆操作的 Pull Request。

进一步了解“撤销”按钮

Diffs

可渲染文档的 Diffs

Commit 和 Pull Request 里包含有 Github 支持的可渲染文档(比如 Markdown)会提供 source 和 rendered 两个视图功能。

点击 "rendered" 按钮,看看改动在渲染后的显示效果。当你添加、删除或修改文本时,渲染纯文本视图非常方便。

进一步了解渲染纯文本视图 Diffs

可比较的地图数据

当你在 GitHub 上查看一个包含地理数据的 commit 或 pull request时,Github 将以可视化的方式对比版本之间的差异。

进一步了解可比较的地图数据

在 Diff 中展开查看更多的上下文

你可以通过点击 diff 边栏里的 unfold 按钮来多显示几行上下文。你可以一直点击 unfold 按钮直到显示了文件的全部内容。这个功能在所有 GitHub 的 diff 功能中都可以使用。

进一步了解展开 Diff 上下文

获取 Pull Request 的 diff 或 patch 文件

在 Pull Request 的 URL 后面加上.diff.patch的扩展名就可以得到它的 diff 或 patch 文件,例如:

https://github.com/tiimgreen/github-cheat-sheet/pull/15
https://github.com/tiimgreen/github-cheat-sheet/pull/15.diff
https://github.com/tiimgreen/github-cheat-sheet/pull/15.patch

.diff扩展会使用普通文本格式显示如下内容:

diff --git a/README.md b/README.md
index 88fcf69..8614873 100644
--- a/README.md
+++ b/README.md
@@ -28,6 +28,7 @@ All the hidden and not hidden features of Git and GitHub. This cheat sheet was i
 - [Merged Branches](#merged-branches)
 - [Quick Licensing](#quick-licensing)
 - [TODO Lists](#todo-lists)
+- [Relative Links](#relative-links)
 - [.gitconfig Recommendations](#gitconfig-recommendations)
     - [Aliases](#aliases)
     - [Auto-correct](#auto-correct)
@@ -381,6 +382,19 @@ When they are clicked, they will be updated in the pure Markdown:
 - [ ] Sleep

(...)

显示图片以及比较图片

GitHub 可以显示包括 PNG、JPG、GIF、PSD 在内的多种图片格式并提供了几种方式来比较这些格式的图片文件版本间的不同。

查看更多关于图片显示和比较

Hub

Hub 是一个对 Git 进行了封装的命令行工具,可以帮助你更方便的使用 Github。

例如可以像下面这样进行克隆:

$ hub clone tiimgreen/toc

查看更多 Hub 提供的超酷命令

贡献者指南

在仓库的根目录添加一个名为 CONTRIBUTING 的文件后,贡献者在新建 Issue 或 Pull Request 时会看到一个指向这个文件的链接。

进一步了解贡献者指南

Octicons

GitHubs 图标库 (Octicons) 现已开源。

进一步了解 GitHub 图标库

GitHub 资源

内容 链接
探索 GitHub https://github.com/explore
GitHub 博客 https://github.com/blog
GitHub 帮助 https://help.github.com/
GitHub 培训 http://training.github.com/
GitHub 开发者 https://developer.github.com/

GitHub 相关演讲视频

内容 链接
How GitHub Uses GitHub to Build GitHub https://www.youtube.com/watch?v=qyz3jkOBbQY
Introduction to Git with Scott Chacon of GitHub https://www.youtube.com/watch?v=ZDR433b0HJY
How GitHub No Longer Works https://www.youtube.com/watch?v=gXD1ITW7iZI
Git and GitHub Secrets https://www.youtube.com/watch?v=Foz9yvMkvlA
More Git and GitHub Secrets https://www.youtube.com/watch?v=p50xsL-iVgU
上一篇: Github 秘籍二 下一篇: Git 实用功能