GitHub Pages 的元数据与插件支持
在 Jekyll 页面和文章里,仓库信息可在 site.github 命名空间下找到,也可以显示出来,例如,使用 {{ site.github.project_title }}
显示项目标题。
Jemoji 和 jekyll-mentions 插件为你的 Jekyll 文章和页面增加了 emoji 和 @mentions功能。
了解更多 GitHub Pages 的元数据和插件支持
查看 YAML 格式的元数据
许多博客站点,比如基于 Jekyll 的 GitHub 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 图标库