From 5e2969671d4800aa928cb2b13c2b22b0c1250520 Mon Sep 17 00:00:00 2001 From: wolfg1969 Date: Thu, 19 Feb 2015 15:36:20 +0800 Subject: [PATCH] update zh-cn translations to ea4fc85 --- README.zh-cn.md | 483 +++++++++++++++++++++++++++--------------------- 1 file changed, 274 insertions(+), 209 deletions(-) diff --git a/README.zh-cn.md b/README.zh-cn.md index 366f735..8d83553 100644 --- a/README.zh-cn.md +++ b/README.zh-cn.md @@ -1,98 +1,103 @@ # GitHub秘籍 -本秘籍收录了一些Git和Github非常酷同时又少有人知的功能。灵感来自于[Zach Holman](https://github.com/holman)在2012年Aloha Ruby Conference和2013年WDCNZ上所做的演讲：[Git and GitHub Secrets](http://www.confreaks.com/videos/1229-aloharuby2012-git-and-github-secrets)([slides](https://speakerdeck.com/holman/git-and-github-secrets))和[More Git and GitHub Secrets](https://vimeo.com/72955426)([slides](https://speakerdeck.com/holman/more-git-and-github-secrets))。 +Git 和 Github 秘籍，灵感来自于 [Zach Holman](https://github.com/holman) 在 2012 年 Aloha Ruby Conference 和 2013 年 WDCNZ 上所做的演讲：[Git and GitHub Secrets](http://www.confreaks.com/videos/1229-aloharuby2012-git-and-github-secrets)([slides](https://speakerdeck.com/holman/git-and-github-secrets)) 和 [More Git and GitHub Secrets](https://vimeo.com/72955426)([slides](https://speakerdeck.com/holman/more-git-and-github-secrets))。 -*Read this in other languages: [English](README.md), [한국어](README.ko.md), [日本語](README.ja.md), [简体中文](README.zh-cn.md).* +*其他语言版本: [English](README.md), [한국어](README.ko.md), [日本語](README.ja.md), [简体中文](README.zh-cn.md).* # 目录 - - [GitHub](#github) - - [忽略空白字符变化](#%E8%B0%83%E6%95%B4tab%E5%AD%97%E7%AC%A6%E6%89%80%E4%BB%A3%E8%A1%A8%E7%9A%84%E7%A9%BA%E6%A0%BC%E6%95%B0) - - [调整Tab字符所代表的空格数](#%E8%B0%83%E6%95%B4tab%E5%AD%97%E7%AC%A6%E6%89%80%E4%BB%A3%E8%A1%A8%E7%9A%84%E7%A9%BA%E6%A0%BC%E6%95%B0) - - [查看某个用户的Commit历史](#%E6%9F%A5%E7%9C%8B%E6%9F%90%E4%B8%AA%E7%94%A8%E6%88%B7%E7%9A%84commit%E5%8E%86%E5%8F%B2) - - [克隆某个仓库](#%E5%85%8B%E9%9A%86%E6%9F%90%E4%B8%AA%E4%BB%93%E5%BA%93) - - [分支](#%E5%88%86%E6%94%AF) - - [将某个分支与其他所有分支进行对比](#%E5%B0%86%E6%9F%90%E4%B8%AA%E5%88%86%E6%94%AF%E4%B8%8E%E5%85%B6%E4%BB%96%E6%89%80%E6%9C%89%E5%88%86%E6%94%AF%E8%BF%9B%E8%A1%8C%E5%AF%B9%E6%AF%94) - - [比较分支](#%E6%AF%94%E8%BE%83%E5%88%86%E6%94%AF) - - [比较不同派生库的分支](#%E6%AF%94%E8%BE%83%E4%B8%8D%E5%90%8C%E6%B4%BE%E7%94%9F%E5%BA%93%E7%9A%84%E5%88%86%E6%94%AF) - - [Gists](#gists) - - [Git.io](#gitio) - - [键盘快捷键](#%E9%94%AE%E7%9B%98%E5%BF%AB%E6%8D%B7%E9%94%AE) - - [整行高亮](#%E6%95%B4%E8%A1%8C%E9%AB%98%E4%BA%AE) - - [用commit信息关闭Issue](#%E7%94%A8commit%E4%BF%A1%E6%81%AF%E5%85%B3%E9%97%ADissue) - - [链接其他仓库的Issue](#%E9%93%BE%E6%8E%A5%E5%85%B6%E4%BB%96%E4%BB%93%E5%BA%93%E7%9A%84issue) - - [设置CI对每条Pull Request都进行构建](#%E8%AE%BE%E7%BD%AEci%E5%AF%B9%E6%AF%8F%E6%9D%A1pull-request%E9%83%BD%E8%BF%9B%E8%A1%8C%E6%9E%84%E5%BB%BA) - - [Markdown文件高亮语法](#markdown%E6%96%87%E4%BB%B6%E9%AB%98%E4%BA%AE%E8%AF%AD%E6%B3%95) - - [表情符](#%E8%A1%A8%E6%83%85%E7%AC%A6) - - [静态与动态图片](#%E9%9D%99%E6%80%81%E4%B8%8E%E5%8A%A8%E6%80%81%E5%9B%BE%E7%89%87) - - [在GitHub Wiki中嵌入图片](#%E5%9C%A8github-wiki%E4%B8%AD%E5%B5%8C%E5%85%A5%E5%9B%BE%E7%89%87) - - [快速引用](#%E5%BF%AB%E9%80%9F%E5%BC%95%E7%94%A8) - - [快速添加许可证](#%E5%BF%AB%E9%80%9F%E6%B7%BB%E5%8A%A0%E8%AE%B8%E5%8F%AF%E8%AF%81) - - [任务列表](#%E4%BB%BB%E5%8A%A1%E5%88%97%E8%A1%A8) - - [Markdown文件中的任务列表](#markdown%E6%96%87%E4%BB%B6%E4%B8%AD%E7%9A%84%E4%BB%BB%E5%8A%A1%E5%88%97%E8%A1%A8) - - [相对链接](#%E7%9B%B8%E5%AF%B9%E9%93%BE%E6%8E%A5) - - [GitHub Pages的元数据与插件支持](#github-pages%E7%9A%84%E5%85%83%E6%95%B0%E6%8D%AE%E4%B8%8E%E6%8F%92%E4%BB%B6%E6%94%AF%E6%8C%81) - - [查看YAML格式的元数据](#%E6%9F%A5%E7%9C%8Byaml%E6%A0%BC%E5%BC%8F%E7%9A%84%E5%85%83%E6%95%B0%E6%8D%AE) - - [渲染表格数据](#%E6%B8%B2%E6%9F%93%E8%A1%A8%E6%A0%BC%E6%95%B0%E6%8D%AE) - - [撤销Pull Request](#%E6%92%A4%E9%94%80pull-request) - - [Diffs](#diffs) - - [可渲染文档的Diffs](#%E5%8F%AF%E6%B8%B2%E6%9F%93%E6%96%87%E6%A1%A3%E7%9A%84diffs) - - [可变化地图](#%E5%8F%AF%E5%8F%98%E5%8C%96%E5%9C%B0%E5%9B%BE) - - [在diff中折叠与扩展代码](#%E5%9C%A8diff%E4%B8%AD%E6%8A%98%E5%8F%A0%E4%B8%8E%E6%89%A9%E5%B1%95%E4%BB%A3%E7%A0%81) - - [查看Pull Request的diff和patch](#%E6%9F%A5%E7%9C%8Bpull-request%E7%9A%84diff%E5%92%8Cpatch) - - [渲染图像发生的变动](#%E6%B8%B2%E6%9F%93%E5%9B%BE%E5%83%8F%E5%8F%91%E7%94%9F%E7%9A%84%E5%8F%98%E5%8A%A8) - - [Hub](#hub) - - [贡献者指南](#%E8%B4%A1%E7%8C%AE%E8%80%85%E6%8C%87%E5%8D%97) - - [GitHub资源](#github%E8%B5%84%E6%BA%90) - - [GitHub讨论](#github%E8%AE%A8%E8%AE%BA) - - [Git](#git) - - [前一个分支](#%E5%89%8D%E4%B8%80%E4%B8%AA%E5%88%86%E6%94%AF) - - [Stripspace命令](#stripspace%E5%91%BD%E4%BB%A4) - - [检出Pull Requests](#%E6%A3%80%E5%87%BApull-requests) - - [提交空改动 :trollface:](#%E6%8F%90%E4%BA%A4%E7%A9%BA%E6%94%B9%E5%8A%A8-trollface) - - [更直观的Git Status](#%E6%9B%B4%E7%9B%B4%E8%A7%82%E7%9A%84git-status) - - [更直观的Git Log](#%E6%9B%B4%E7%9B%B4%E8%A7%82%E7%9A%84git-log) - - [Git查询](#git%E6%9F%A5%E8%AF%A2) - - [合并分支](#%E5%90%88%E5%B9%B6%E5%88%86%E6%94%AF) - - [使用网页查看本地仓库](#%E4%BD%BF%E7%94%A8%E7%BD%91%E9%A1%B5%E6%9F%A5%E7%9C%8B%E6%9C%AC%E5%9C%B0%E4%BB%93%E5%BA%93) - - [Git配置](#git%E9%85%8D%E7%BD%AE) - - [Git命令自定义别名](#git%E5%91%BD%E4%BB%A4%E8%87%AA%E5%AE%9A%E4%B9%89%E5%88%AB%E5%90%8D) - - [自动更正](#%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%AD%A3) - - [带颜色输出](#%E5%B8%A6%E9%A2%9C%E8%89%B2%E8%BE%93%E5%87%BA) - - [Git资源](#git%E8%B5%84%E6%BA%90) - - [Git参考书籍](#git%E5%8F%82%E8%80%83%E4%B9%A6%E7%B1%8D) + - [GitHub](#github) + - [不比较空白字符](#不比较空白字符) + - [调整 Tab 字符所代表的空格数](#调整-tab-字符所代表的空格数) + - [查看某个用户的 Commit 历史](#查看某个用户的-commit-历史) + - [仓库克隆](#仓库克隆) + - [分支](#分支) + - [将某个分支与其他所有分支进行对比](#将某个分支与其他所有分支进行对比) + - [比较分支](#比较分支) + - [比较不同派生库的分支](#比较不同派生库的分支) + - [Gists](#gists) + - [Git.io](#gitio) + - [键盘快捷键](#键盘快捷键) + - [整行高亮](#整行高亮) + - [用 Commit 信息关闭 Issue](#用-commit-信息关闭-issue) + - [链接其他仓库的 Issue](#链接其他仓库的-issue) + - [锁定项目对话功能](#锁定项目对话功能) + - [设置 CI 对每条 Pull Request 都进行构建](#设置-ci-对每条-pull-request-都进行构建) + - [Markdown 文件语法高亮](#markdown-文件语法高亮) + - [表情符](#表情符) + - [图片 / GIF 动画](#图片--gif-动画) + - [在 GitHub Wiki 中引用图片](#在-github-wiki-中引用图片) + - [快速引用](#快速引用) + - [粘贴剪贴板中的图片到评论](#粘贴剪贴板中的图片到评论) + - [快速添加许可证文件](#快速添加许可证文件) + - [任务列表](#任务列表) + - [Markdown 文件中的任务列表](#markdown-文件中的任务列表) + - [相对链接](#相对链接) + - [GitHub Pages 的元数据与插件支持](#github-pages-的元数据与插件支持) + - [查看 YAML 格式的元数据](#查看-yaml-格式的元数据) + - [渲染表格数据](#渲染表格数据) + - [撤销 Pull Request](#撤销-pull-request) + - [Diffs](#diffs) + - [可渲染文档的Diffs](#可渲染文档的diffs) + - [可比较的地图数据](#可比较的地图数据) + - [在 Diff 中展开查看更多的上下文](#在-diff-中展开查看更多的上下文) + - [获取 Pull Request 的 diff 或 patch 文件](#获取-pull-request-的-diff-或-patch-文件) + - [显示图片以及比较图片](#显示图片以及比较图片) + - [Hub](#hub) + - [贡献者指南](#贡献者指南) + - [Octicons](#octicons) + - [GitHub 资源](#github-资源) + - [GitHub 相关演讲视频](#github-相关演讲视频) + - [Git](#git) + - [从工作区去除大量已删除文件](#从工作区去除大量已删除文件) + - [上一个分支](#上一个分支) + - [去除空白](#去除空白) + - [检出 Pull Requests](#检出-pull-requests) + - [没有任何改动的提交](#没有任何改动的提交) + - [美化 Git Status](#美化-git-status) + - [美化 Git Log](#美化-git-log) + - [Git 查询](#git-查询) + - [合并分支](#合并分支) + - [修复有问题的提交以及自动合并](#修复有问题的提交以及自动合并) + - [以网站方式查看本地仓库](#以网站方式查看本地仓库) + - [Git 配置](#git-配置) + - [Git 命令自定义别名](#git-命令自定义别名) + - [自动更正](#自动更正) + - [颜色输出](#颜色输出) + - [Git 资源](#git-资源) + - [Git 参考书籍](#git-参考书籍) ## GitHub -### 忽略空白字符变化 +### 不比较空白字符 -在任意diff页面的URL后加上`?w=1`，可以去掉那些只是空白字符的变化，使你能更专注于代码的变化。 +在任意 diff 页面的 UR L后加上 `?w=1`，可以去掉那些只是空白字符的改动，使你能更专注于代码改动。 ![Diff without whitespace](https://camo.githubusercontent.com/797184940defadec00393e6559b835358a863eeb/68747470733a2f2f6769746875622d696d616765732e73332e616d617a6f6e6177732e636f6d2f626c6f672f323031312f736563726574732f776869746573706163652e706e67) [*详见 GitHub secrets.*](https://github.com/blog/967-github-secrets) -### 调整Tab字符所代表的空格数 -在diff或者file页面的URL后面加上`?ts=4`，这样当显示tab字符的长度时就会是4个空格的长度，不再是默认的8个空格。`ts`后面的数字还可以根据你个人的偏好进行修改。不过，这个小诀窍在Gists页面和raw file页面不起作用。 +### 调整 Tab 字符所代表的空格数 +在 diff 或文件的 URL 后面加上 `?ts=4` ，这样当显示 tab 字符的长度时就会是 4 个空格的长度，不再是默认的 8 个空格。 `ts` 后面的数字还可以根据你个人的偏好进行修改。这个技巧不适用于 Gists，或者以 Raw 格式查看文件， 但有浏览器扩展插件可以帮你自动调整: [Chrome 扩展](https://chrome.google.com/webstore/detail/github-tab-size/ofjbgncegkdemndciafljngjbdpfmbkn) ， [Opera 扩展](https://addons.opera.com/en/extensions/details/github-tab-size/)。 -下面是我们在Go语言的source file页面URL后加`?ts=4`[前](https://github.com/pengwynn/flint/blob/master/flint/flint.go)的例子： +下面以一个 Go 语言源文件为例，看看在 URL 里添加 `?ts=4` 参数的效果。添加前： ![Before, tab space example](http://i.imgur.com/GIT1Fr0.png) -然后是我们添加`?ts=4`[后](https://github.com/pengwynn/flint/blob/master/flint/flint.go?ts=4)的例子： +... 添加后的样子： ![After, tab space example](http://i.imgur.com/70FL4H9.png) -### 查看某个用户的Commit历史 -查看某个用户的所有提交历史，只需在commits页面URL后加上`?author={user}`。 +### 查看某个用户的 Commit 历史 +在 Commits 页面 URL 后加上 `?author={user}` 查看某个用户的所有提交。 ``` https://github.com/rails/rails/commits/master?author=dhh ``` -![DHH commit history](http://i.imgur.com/mDWwuaY.png) +![DHH commit history](http://i.imgur.com/S7AE29b.png) [*深入了解提交视图之间的区别*](https://help.github.com/articles/differences-between-commit-views) -### 克隆某个仓库 -当我们克隆某一资源时，可以不要那个`.git`后缀。 +### 仓库克隆 +当克隆仓库时可以不要那个`.git`后缀。 ```bash $ git clone https://github.com/tiimgreen/github-cheat-sheet @@ -103,40 +108,26 @@ $ git clone https://github.com/tiimgreen/github-cheat-sheet ###分支 ####将某个分支与其他所有分支进行对比 -当你点击某个仓库的分支（Branches）选项卡时 +当你查看某个仓库的分支（Branches）页面（紧挨着 Commits 链接）时 ``` https://github.com/{user}/{repo}/branches ``` 你会看到一个包含所有未合并的分支的列表。 -你可以在这里查看比较（Compare）页面或点击删除某个分支。 +在这里你可以访问分支比较页面或删除某个分支。 -![Compare branches not merged into master in jquery/jquery repo - https://github.com/jquery/jquery/branches](http://i.imgur.com/gKWPe8a.png) - -有的时候我们需要将多个分支与一个非主分支（master）进行对比，此时可以通过在URL后加入要比较的分支名来实现： - -``` -https://github.com/{user}/{repo}/branches/{branch} -``` - -![Compare branches not merged into `1.x-master` in jquery/jquery repo - https://github.com/jquery/jquery/branches/1.x-master](http://i.imgur.com/jpc6Urb.png) - -可以在URL后加上`?merged=1`来查看已经合并了的分支。 - -![Compare branches merged in to `1.x-master` in jquery/jquery repo - https://github.com/jquery/jquery/branches/1.x-master?merged=1](http://i.imgur.com/KmYyCVh.png) - -你可以使用这个界面来替代命令行直接删除分支。 +![Compare branches not merged into master in rails/rails repo - https://github.com/rails/rails/branches](http://i.imgur.com/0FEe30z.png) #### 比较分支 -如果我们想要比较两个分支，可以像下面一样修改URL： +如果要在 GitHub 上直接比较两个分支，可以使用如下形式的 URL ： ``` https://github.com/{user}/{repo}/compare/{range} ``` -其中`{range} = master...4-1-stable` +其中 `{range} = master...4-1-stable` 例如： @@ -144,9 +135,9 @@ https://github.com/{user}/{repo}/compare/{range} https://github.com/rails/rails/compare/master...4-1-stable ``` -![Rails branch compare example](http://i.imgur.com/0Z52X5Y.png) +![Rails branch compare example](http://i.imgur.com/tIRCOsK.png) -`{range}`还可以使用下面的形式: +`{range}` 参数还可以使用下面的形式: ``` https://github.com/rails/rails/compare/master@{1.day.ago}...master @@ -157,13 +148,18 @@ https://github.com/rails/rails/compare/master@{2014-10-04}...master ![Another compare example](http://i.imgur.com/5dtzESz.png) -...这样你就能查看master分支上一段时间或者指定日期内的改动。 +在 `diff` 和 `patch` 页面里也可以比较分支： -[*了解更多关于比较跨时间段的提交记录.*](https://help.github.com/articles/comparing-commits-across-time) +``` +https://github.com/rails/rails/compare/master...4-1-stable.diff +https://github.com/rails/rails/compare/master...4-1-stable.patch +``` + +[*了解更多关于基于时间的 Commit 比较.*](https://help.github.com/articles/comparing-commits-across-time) #### 比较不同派生库的分支 -想要对派生仓库（Forked Repository）之间的分支进行比较，可以像下面这样修改URL实现： +想要对派生仓库（Forked Repository）之间的分支进行比较，可以使用如下的 URL： ``` https://github.com/user/repo/compare/{foreign-user}:{branch}...{own-branch} @@ -179,13 +175,13 @@ https://github.com/rails/rails/compare/byroot:master...master ### Gists -[Gists](https://gist.github.com/) 给我们提供了一种不需要创建一个完整的仓库，使小段代码也可以工作的简单方式。 +[Gists](https://gist.github.com/) 方便我们管理代码片段，不必使用功能齐全的仓库。 ![Gist](http://i.imgur.com/VkKI1LC.png?1) -Gist的URL后加上`.pibb`，可以得到更适合嵌入到其他网站的HTML版本。 +Gist 的 URL 后加上 `.pibb`，比如 [like this](https://gist.github.com/tiimgreen/10545817.pibb) ，方便嵌入到其他网站。 -Gists还可以像任何标准仓库一样被克隆。 +Gists 可以像任何标准仓库一样被克隆。 ```bash $ git clone https://gist.github.com/tiimgreen/10545817 @@ -197,19 +193,20 @@ $ git clone https://gist.github.com/tiimgreen/10545817 ```bash $ git commit +$ git push Username for 'https://gist.github.com': Password for 'https://tiimgreen@gist.github.com': ``` - -[*进一步了解如何创建 gists.*](https://help.github.com/articles/creating-gists) +但是， Gists 不支持目录。所有文件都必须添加在仓库的根目录下。 +[*进一步了解如何创建 Gists.*](https://help.github.com/articles/creating-gists) ### Git.io -[Git.io](http://git.io)是Github的短网址服务。 +[Git.io](http://git.io)是 Github 的短网址服务。 ![Git.io](http://i.imgur.com/6JUfbcG.png?1) -你可以通过Curl命令以普通HTTP协议使用它： +你可以通过 Curl 命令以普通 HTTP 协议使用它： ```bash $ curl -i http://git.io -F "url=https://github.com/..." @@ -225,25 +222,25 @@ Location: https://github.com/... ### 键盘快捷键 -在仓库主页上提供了快捷键方便快速导航。 +在仓库页面上提供了快捷键方便快速导航。 - - 按 `t` 键会打开一个文件浏览器。 - - 按 `w` 键会打开分支选择菜单。 - - 按 `s` 键会激活顶端的命令栏 (Command Bar)。 - - 按 `l` 键编辑Issue列表页的标签。 + - 按 `t` 键打开一个文件浏览器。 + - 按 `w` 键打开分支选择菜单。 + - 按 `s` 键聚焦光标到当前仓库的搜索框。此时按退格键就会从搜索当前仓库切换到搜索整个 Github 网站。 + - 按 `l` 键编辑 Issue 列表页的标签。 - **查看文件内容时**（如：`https://github.com/tiimgreen/github-cheat-sheet/blob/master/README.md`），按 `y` 键将会冻结这个页面，这样就算代码被修改了也不会影响你当前看到的。 按`?`查看当前页面支持的快捷键列表： ![Keyboard shortcuts](http://i.imgur.com/y5ZfNEm.png) -[*进一步了解如何使用 Command Bar.*](https://help.github.com/articles/using-the-command-bar) +[*进一步了解可用的搜索语法.*](https://help.github.com/articles/search-syntax/) ### 整行高亮 -在代码文件地址后加上`#L52`或者单击行号52都会将第52行代码高亮显示。 +在代码文件地址 URL 后加上`#L52`或者单击行号 52 都会将第 52 行代码高亮显示。 -多行高亮也可以，比如用`#L53-L60`选择范围，或者按住 `shift`键，然后再点击选择的两行。 +多行高亮也可以，比如用`#L53-L60`选择范围，或者按住 `shift` 键，然后再点击选择的两行。 ``` https://github.com/rails/rails/blob/master/activemodel/lib/active_model.rb#L53-L60 @@ -251,36 +248,47 @@ https://github.com/rails/rails/blob/master/activemodel/lib/active_model.rb#L53-L ![整行高亮](http://i.imgur.com/8AhjrCz.png) -### 用commit信息关闭Issue +### 用 Commit 信息关闭 Issue -如果某个提交修复了一个Issue，当提交到master分支时，提交信息里可以使用`fix/fixes/fixed`, `close/closes/closed` 或者 `resolve/resolves/resolved`等关键词，后面再跟上Issue号，这样就会关闭这个Issue。 +如果某个提交修复了一个 Issue，当提交到 master 分支时，提交信息里可以使用 `fix/fixes/fixed`, `close/closes/closed` 或者 `resolve/resolves/resolved` 等关键词，后面再跟上 Issue 号，这样就会关闭这个 Issue 。 ```bash $ git commit -m "Fix screwup, fixes #12" ``` -这将会关闭Issue #12，并且在Issue讨论列表里关联引用这次提交。 +这将会关闭 Issue #12，并且在 Issue 讨论列表里关联引用这次提交。 ![Closing Repo](http://i.imgur.com/Uh1gZdx.png) -[*进一步了解通过提交信息关闭Issue.*](https://help.github.com/articles/closing-issues-via-commit-messages) +[*进一步了解通过提交信息关闭 Issue.*](https://help.github.com/articles/closing-issues-via-commit-messages) -### 链接其他仓库的Issue -如果你想引用到同一个仓库中的一个Issue，只需使用井号 `#` 加上Issue号，这样就会自动创建到此Issue的链接。 +### 链接其他仓库的 Issue +如果你想引用到同一个仓库中的一个 Issue，只需使用井号 `#` 加上 Issue 号，这样就会自动创建到此 Issue 的链接。 -要链接到其他仓库的Issue，就使用`{user}/{repo}#ISSUE_NUMBER`的方式，例如`tiimgreen/toc#12`。 +要链接到其他仓库的 Issue ，就使用`{user}/{repo}#ISSUE_NUMBER`的方式，例如`tiimgreen/toc#12`。 ![Cross-Link Issues](https://camo.githubusercontent.com/447e39ab8d96b553cadc8d31799100190df230a8/68747470733a2f2f6769746875622d696d616765732e73332e616d617a6f6e6177732e636f6d2f626c6f672f323031312f736563726574732f7265666572656e6365732e706e67) -### 设置CI对每条Pull Request都进行构建 -如果配置正确，[Travis CI](https://travis-ci.org/)会为每个你收到的Pull Request执行构建，就像每次提交也会触发构建一样。想了解更多关于Travis CI的信息，请看 [Travis CI入门](http://docs.travis-ci.com/user/getting-started/)。 +### 锁定项目对话功能 +现在仓库的管理员和合作者可以将 Pull Requests 和 Issue 的评论功能关闭。 + +![Lock conversation](https://cloud.githubusercontent.com/assets/2723/3221693/bf54dd44-f00d-11e3-8eb6-bb51e825bc2c.png) + +这样，不是项目合作者的用户就不能在这个项目上使用评论功能。 + +![Comments locked](https://cloud.githubusercontent.com/assets/2723/3221775/d6e513b0-f00e-11e3-9721-2131cb37c906.png) + +[*进一步了解对话锁定功能.*](https://github.com/blog/1847-locking-conversations) + +### 设置 CI 对每条 Pull Request 都进行构建 +如果配置正确，[Travis CI](https://travis-ci.org/) 会为每个你收到的 Pull Request 执行构建，就像每次提交也会触发构建一样。想了解更多关于 Travis CI 的信息，请参考 [Travis CI入门](http://docs.travis-ci.com/user/getting-started/)。 [![Travis CI status](https://cloud.githubusercontent.com/assets/1687642/2700187/3a88838c-c410-11e3-9a46-e65e2a0458cd.png)](https://github.com/octokit/octokit.rb/pull/452) -[*进一步了解 Commit status API.*](https://github.com/blog/1227-commit-status-api) +[*进一步了解提交状态 API.*](https://github.com/blog/1227-commit-status-api) -### Markdown文件高亮语法 -例如，可以像下面这样在你的Markdown文件里为Ruby代码添加语法高亮： +### Markdown 文件语法高亮 +例如，可以像下面这样在你的 Markdown 文件里为 Ruby 代码添加语法高亮： ```ruby require 'tabbit' @@ -289,7 +297,7 @@ $ git commit -m "Fix screwup, fixes #12" puts table.to_s ``` -效果像下面这样： +效果如下： ```ruby require 'tabbit' @@ -304,7 +312,7 @@ Github使用 [Linguist](https://github.com/github/linguist) 做语言识别和 ### 表情符 -可以在Pull Requests, Issues, 提交消息, Markdown文件里加入表情符。使用方法`:name_of_emoji:` +可以在 Pull Requests, Issues, 提交消息, Markdown 文件里加入表情符。使用方法 `:name_of_emoji:` ``` :smile: @@ -313,9 +321,9 @@ Github使用 [Linguist](https://github.com/github/linguist) 做语言识别和 :smile: -Github支持的完整表情符号列表详见[emoji-cheat-sheet.com](http://www.emoji-cheat-sheet.com/) 或 [scotch-io/All-Github-Emoji-Icons](https://github.com/scotch-io/All-Github-Emoji-Icons)。 +Github 支持的完整表情符号列表详见[emoji-cheat-sheet.com](http://www.emoji-cheat-sheet.com/) 或 [scotch-io/All-Github-Emoji-Icons](https://github.com/scotch-io/All-Github-Emoji-Icons)。 -Github上使用最多的5个表情符号是： +Github 上使用最多的5个表情符号是： 1. `:shipit:` 2. `:sparkles:` @@ -323,14 +331,14 @@ Github上使用最多的5个表情符号是： 4. `:+1:` 5. `:clap:` -### 静态与动态图片 -注释和README等文件里也可以使用图片和GIF动画： +### 图片 / GIF 动画 +注释和README等文件里也可以使用图片和 GIF 动画： ``` ![Alt Text](http://www.sheawong.com/wp-content/uploads/2013/08/keephatin.gif) ``` -仓库中的原始图片可以被直接调用： +仓库中的图片可以被直接引用： ``` ![Alt Text](https://github.com/{user}/{repo}/raw/master/path/to/image.gif) @@ -338,10 +346,10 @@ Github上使用最多的5个表情符号是： ![Peter don't care](http://www.sheawong.com/wp-content/uploads/2013/08/keephatin.gif) -所有图片都缓存在Github，不用担心你的站点不能访问时就看不到图片了。 +所有图片都缓存在 Github，不用担心你的站点不能访问时就看不到图片了。 -#### 在GitHub Wiki中嵌入图片 -有多种方法可以在Wiki页面里嵌入图片。既可以像上一条里那样使用标准的Markdown语法，也可以像下面这样指定图片的高度或宽度： +#### 在 GitHub Wiki 中引用图片 +有多种方法可以在 Wiki 页面里嵌入图片。既可以像上一条里那样使用标准的 Markdown 语法，也可以像下面这样指定图片的高度或宽度： ```markdown [[ http://www.sheawong.com/wp-content/uploads/2013/08/keephatin.gif | height = 100px ]] @@ -351,27 +359,38 @@ Github上使用最多的5个表情符号是： ![Just a screenshot](http://i.imgur.com/J5bMf7S.png) ### 快速引用 -在主题评论中引用之前某个人所说的，只需选中文本，然后按 `r`键，想要的就会以引用的形式复制到你的输入框里。 +在主题评论中引用之前某个人所说的，只需选中文本，然后按 `r` 键，想要的就会以引用的形式复制到你的输入框里。 ![Quick Quote](https://f.cloud.github.com/assets/296432/124483/b0fa6204-6ef0-11e2-83c3-256c37fa7abc.gif) [*进一步了解快速引用.*](https://github.com/blog/1399-quick-quotes) -### 快速添加许可证 +### 粘贴剪贴板中的图片到评论 + +_（仅适用于 Chrome 浏览器）_ + +当截屏图片复制到剪贴板后（mac 上用 `cmd-ctrl-shift-4`），你可以用(`cmd-v / ctrl-v`)把图片粘贴到评论框里，然后它就会自动上传到 Github。 + +![Pasting Clipboard Image to Comments](https://cloud.githubusercontent.com/assets/39191/5794265/39c9b65a-9f1b-11e4-9bc7-04e41f59ea5f.png) + +[*进一步了解在 issue 中使用附件*](https://help.github.com/articles/issue-attachments) + + +### 快速添加许可证文件 创建一个仓库时，Github会为你提供一个预置的软件许可列表： ![License](http://i.imgur.com/Chqj4Fg.png) -对于已有的仓库，可以通过web界面创建文件来添加软件许可。输入`LICENSE`作为文件名后，同样可以从预置的列表中选择一个作为模板。 +对于已有的仓库，可以通过 web 界面创建文件来添加软件许可。输入`LICENSE`作为文件名后，同样可以从预置的列表中选择一个作为模板。 ![License](http://i.imgur.com/fTjQict.png) 这个技巧也适用于 `.gitignore` 文件。 -[*进一步了解 open source licensing.*](https://help.github.com/articles/open-source-licensing) +[*进一步了解开源许可证*](https://help.github.com/articles/open-source-licensing) ### 任务列表 -Issues和Pull requests里可以添加复选框，语法如下（注意空白符）： +Issues 和 Pull requests 里可以添加复选框，语法如下（注意空白符）： ``` - [ ] Be awesome @@ -384,7 +403,7 @@ Issues和Pull requests里可以添加复选框，语法如下（注意空白符 ![Task List](http://i.imgur.com/jJBXhsY.png) -当项目被选中时，它对应的Markdown源码也被更新了： +当项目被选中时，它对应的 Markdown 源码也被更新了： ``` - [x] Be awesome @@ -397,7 +416,7 @@ Issues和Pull requests里可以添加复选框，语法如下（注意空白符 [*进一步了解任务列表.*](https://help.github.com/articles/writing-on-github#task-lists) -####Markdown文件中的任务列表 +#### Markdown 文件中的任务列表 在完全适配Markdown语法的文件中可以使用以下语法加入一个**只读**的任务列表 @@ -420,7 +439,7 @@ Issues和Pull requests里可以添加复选框，语法如下（注意空白符 - [ ] Deimos - [ ] Phobos -[*进一步了解Markdown文件中的任务列表*](https://github.com/blog/1825-task-lists-in-all-markdown-documents) +[*进一步了解 Markdown 文件中的任务列表*](https://github.com/blog/1825-task-lists-in-all-markdown-documents) ### 相对链接 Markdown文件里链接到内部内容时推荐使用相对链接。 @@ -429,35 +448,36 @@ Markdown文件里链接到内部内容时推荐使用相对链接。 [Link to a header](#awesome-section) [Link to a file](docs/readme) ``` -绝对链接会在URL改变时（例如重命名仓库、用户名改变，建立分支项目）被更新。使用相对链接能够保证你的文档不受此影响。 +绝对链接会在 URL 改变时（例如重命名仓库、用户名改变，建立分支项目）被更新。使用相对链接能够保证你的文档不受此影响。 [*进一步了解相对链接.*](https://help.github.com/articles/relative-links-in-readmes) -### GitHub Pages的元数据与插件支持 -在Jekyll页面和文章里，仓库信息可在 `site.github` 命名空间下找到，也可以显示出来，例如，使用 `{{ site.github.project_title }}`显示项目标题。 +### GitHub Pages 的元数据与插件支持 +在 Jekyll 页面和文章里，仓库信息可在 `site.github` 命名空间下找到，也可以显示出来，例如，使用 `{{ site.github.project_title }}`显示项目标题。 -Jemoji和jekyll-mentions插件为你的Jekyll文章和页面增加了[emoji](#emojis)和[@mentions](https://github.com/blog/821)功能。 +Jemoji 和 jekyll-mentions 插件为你的 Jekyll 文章和页面增加了[emoji](#emojis)和[@mentions](https://github.com/blog/821)功能。 -[*了解更多 GitHub Pages的元数据和插件支持.*](https://github.com/blog/1797-repository-metadata-and-plugin-support-for-github-pages) +[*了解更多 GitHub Pages 的元数据和插件支持.*](https://github.com/blog/1797-repository-metadata-and-plugin-support-for-github-pages) -### 查看YAML格式的元数据 -许多博客站点，比如基于[Jekyll](http://jekyllrb.com/)的[GitHub Pages](http://pages.github.com/)，都依赖于一些文章头部的YAML格式的元数据。Github会将其渲染成一个水平表格，方便阅读。 +### 查看 YAML 格式的元数据 +许多博客站点，比如基于 [Jekyll](http://jekyllrb.com/)的[GitHub Pages](http://pages.github.com/) ，都依赖于一些文章头部的 YAML 格式的元数据。 Github 会将其渲染成一个水平表格，方便阅读。 ![YAML metadata](https://camo.githubusercontent.com/47245aa16728e242f74a9a324ce0d24c0b916075/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f36343035302f313232383236372f65303439643063362d323761302d313165332d396464382d6131636432323539393334342e706e67) -[*进一步了解 在文档里查看YAML元数据.*](https://github.com/blog/1647-viewing-yaml-metadata-in-your-documents) +[*进一步了解 在文档里查看 YAML 元数据.*](https://github.com/blog/1647-viewing-yaml-metadata-in-your-documents) ### 渲染表格数据 -GitHub支持将 `.csv` (逗号分隔)和`.tsv` (制表符分隔)格式的文件渲染成表格数据。 +GitHub 支持将 `.csv` (逗号分隔)和 `.tsv` (制表符分隔)格式的文件渲染成表格数据。 ![Tabular data](https://camo.githubusercontent.com/1b6dd0157ffb45d9939abf14233a0cb13b3b4dfe/68747470733a2f2f662e636c6f75642e6769746875622e636f6d2f6173736574732f3238323735392f3937363436322f33323038336463652d303638642d313165332d393262322d3566323863313061353035392e706e67) [*进一步了解渲染表格数据.*](https://github.com/blog/1601-see-your-csvs) -### 撤销Pull Request +### 撤销 Pull Request +合并一个 Pull Request 之后，你可能会反悔：要么是这次 Pull Request 没什么用处，要么是还不到合并的时候。 -可以通过Pull Request中的Revert按钮来撤销一个已合并的Pull Request中的commit。按下按钮后会自动生成一个进行逆向操作的Pull Request。 +此时可以通过 Pull Request 中的 Revert 按钮来撤销一个已合并的 Pull Request 中的 commit。按下按钮后将自动生成一个进行逆操作的 Pull Request。 ![Revert button](https://camo.githubusercontent.com/0d3350caf2bb1cba53123ffeafc00ca702b1b164/68747470733a2f2f6769746875622d696d616765732e73332e616d617a6f6e6177732e636f6d2f68656c702f70756c6c5f72657175657374732f7265766572742d70756c6c2d726571756573742d6c696e6b2e706e67) @@ -466,7 +486,7 @@ GitHub支持将 `.csv` (逗号分隔)和`.tsv` (制表符分隔)格式的文件 ### Diffs #### 可渲染文档的Diffs -提交和Pull Requests里包含有Github支持的可渲染文档（比如Markdown）会提供*source* 和 *rendered* 两个视图功能。 +Commit 和 Pull Request 里包含有 Github 支持的可渲染文档（比如 Markdown）会提供*source* 和 *rendered* 两个视图功能。 ![Source / Rendered view](https://github-images.s3.amazonaws.com/help/repository/rendered_prose_diff.png) @@ -476,22 +496,22 @@ GitHub支持将 `.csv` (逗号分隔)和`.tsv` (制表符分隔)格式的文件 [*进一步了解渲染纯文本视图Diffs.*](https://github.com/blog/1784-rendered-prose-diffs) -#### 可变化地图 -当你在GitHub上查看一个包含地理数据的提交或pull request时，Github 将以可视化的方式对比版本之间的差异。 +#### 可比较的地图数据 +当你在GitHub上查看一个包含地理数据的 commit 或 pull request时，Github 将以可视化的方式对比版本之间的差异。 [![Diffable Maps](https://f.cloud.github.com/assets/282759/2090660/63f2e45a-8e97-11e3-9d8b-d4c8078b004e.gif)](https://github.com/benbalter/congressional-districts/commit/2233c76ca5bb059582d796f053775d8859198ec5) -[*进一步了解可比较地图.*](https://github.com/blog/1772-diffable-more-customizable-maps) +[*进一步了解可比较的地图数据.*](https://github.com/blog/1772-diffable-more-customizable-maps) -#### 在diff中折叠与扩展代码 -你可以通过点击diff边栏里的 *unfold* 按钮来多显示几行上下文。你可以一直点击 *unfold* 按钮直到显示了文件的全部内容。这个功能在所有GitHub产生的diff界面都可以使用。 +#### 在 Diff 中展开查看更多的上下文 +你可以通过点击 diff 边栏里的 *unfold* 按钮来多显示几行上下文。你可以一直点击 *unfold* 按钮直到显示了文件的全部内容。这个功能在所有 GitHub 的 diff 功能中都可以使用。 ![Expanding Context in Diffs](https://f.cloud.github.com/assets/22635/1610539/863c1f64-5584-11e3-82bf-151b406a272f.gif) -[*进一步了解扩展Diff上下文.*](https://github.com/blog/1705-expanding-context-in-diffs) +[*进一步了解展开 Diff 上下文.*](https://github.com/blog/1705-expanding-context-in-diffs) -#### 查看Pull Request的diff和patch -在Pull Request的URL后面加上 `.diff` 或 `.patch` 的扩展名就可以得到它的diff或patch文件，例如： +#### 获取 Pull Request 的 diff 或 patch 文件 +在 Pull Request 的 URL 后面加上 `.diff` 或 `.patch` 的扩展名就可以得到它的 diff 或 patch 文件，例如： ``` https://github.com/tiimgreen/github-cheat-sheet/pull/15 @@ -518,43 +538,50 @@ index 88fcf69..8614873 100644 (...) ``` -#### 渲染图像发生的变动 -GitHub可以显示包括PNG、JPG、GIF、PSD在内的多种图片格式并提供了几种方式来比较这些格式的图片文件版本间的不同。 +#### 显示图片以及比较图片 +GitHub 可以显示包括 PNG、JPG、GIF、PSD 在内的多种图片格式并提供了几种方式来比较这些格式的图片文件版本间的不同。 [![Diffable PSD](https://cloud.githubusercontent.com/assets/2546/3165594/55f2798a-eb56-11e3-92e7-b79ad791a697.gif)](https://github.com/blog/1845-psd-viewing-diffing) -[*查看更多关于渲染图像变动的内容*](https://help.github.com/articles/rendering-and-diffing-images) +[*查看更多关于图片显示和比较*](https://help.github.com/articles/rendering-and-diffing-images) ### Hub -[Hub](https://github.com/github/hub)是一个对Git进行了封装的命令行工具，可以帮助你更方便的使用Github。 +[Hub](https://github.com/github/hub) 是一个对 Git 进行了封装的命令行工具，可以帮助你更方便的使用 Github。 -这使得你可以像下面这样进行克隆： +例如可以像下面这样进行克隆： ```bash $ hub clone tiimgreen/toc ``` -[*查看更多Hub提供的超酷命令.*](https://github.com/github/hub#commands) +[*查看更多 Hub 提供的超酷命令.*](https://github.com/github/hub#commands) ### 贡献者指南 -在你的仓库的根目录添加一个名为 `CONTRIBUTING` 的文件后，贡献者在新建Issue或Pull Request时会看到这个文件的链接。 +在你的仓库的根目录添加一个名为 `CONTRIBUTING` 的文件后，贡献者在新建 Issue 或 Pull Request 时会看到这个文件的链接。 ![Contributing Guidelines](https://camo.githubusercontent.com/71995d6b0e620a9ef1ded00a04498241c69dd1bf/68747470733a2f2f6769746875622d696d616765732e73332e616d617a6f6e6177732e636f6d2f736b697463682f6973737565732d32303132303931332d3136323533392e6a7067) [*进一步了解贡献者指南.*](https://github.com/blog/1184-contributing-guidelines) -### GitHub资源 -| Title | Link | -| ----- | ---- | -| GitHub Explore | https://github.com/explore | -| GitHub Blog | https://github.com/blog | -| GitHub Help | https://help.github.com/ | -| GitHub Training | http://training.github.com/ | -| GitHub Developer | https://developer.github.com/ | +### Octicons +GitHubs 图标库 (Octicons) 现已开源。 -#### GitHub讨论 -| Title | Link | +![Octicons](https://og.github.com/octicons/octicons@1200x630.png) + +[*进一步了解 GitHub 图标库*](https://octicons.github.com) + +### 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 | @@ -563,7 +590,34 @@ $ hub clone tiimgreen/toc | More Git and GitHub Secrets | https://www.youtube.com/watch?v=p50xsL-iVgU | ## Git -### 前一个分支 +### 从工作区去除大量已删除文件 +当用 `/bin/rm` 命令删除了大量文件之后，你可以用下面一条命令从工作区和索引中去除这些文件，以免一个一个的删除： + +```bash +$ git rm $(git ls-files -d) +``` + +例如: + +```bash +$ git status +On branch master +Changes not staged for commit: + deleted: a + deleted: c + +$ git rm $(git ls-files -d) +rm 'a' +rm 'c' + +$ git status +On branch master +Changes to be committed: + deleted: a + deleted: c +``` + +### 上一个分支 快速检出上一个分支： ```bash @@ -579,9 +633,9 @@ $ git checkout - [*进一步了解 Git 分支.*](http://git-scm.com/book/en/Git-Branching-Basic-Branching-and-Merging) -### Stripspace命令 +### 去除空白 -Git Stripspace命令可以: +Git Stripspace 命令可以: - 去掉行尾空白符 - 多个空行压缩成一行 @@ -595,22 +649,22 @@ $ git stripspace < README.md [*进一步了解 Git `stripspace` 命令.*](http://git-scm.com/docs/git-stripspace) -### 检出Pull Requests -Pull Request是一种GitHub上可以通过以下多种方式在本地被检索的特别分支： +### 检出 Pull Requests +对 Github 仓库来说，Pull Request 是种特殊分支， 可以通过以下多种方式取到本地： -检索某个分支并临时储存在本地的`FETCH_HEAD`中以便快速查看更改(diff)以及合并(merge)： +取出某个特定的 Pull Request 并临时作为本地的 `FETCH_HEAD` 中以便进行快速查看更改( diff )以及合并( merge )： ```bash $ git fetch origin refs/pull/[PR-Number]/head ``` -通过refspec获取所有的Pull Request为本地分支： +通过 refspec 获取所有的 Pull Request 为本地分支： ```bash $ git fetch origin '+refs/pull/*/head:refs/remotes/origin/pr/*' ``` -或在仓库的`.git/config`中加入下列设置来自动获取远程仓库中的Pull Request +或在仓库的 `.git/config` 中加入下列设置来自动获取远程仓库中的 Pull Request ``` [remote "origin"] fetch = +refs/heads/*:refs/remotes/origin/* @@ -624,32 +678,32 @@ $ git fetch origin '+refs/pull/*/head:refs/remotes/origin/pr/*' fetch = +refs/pull/*/head:refs/remotes/origin/pr/* ``` -对基于派生库的Pull Request，可以通过先`checkout`代表此Pull Request的远端分支再由此分支建立一个本地分支： +对基于派生库的 Pull Request，可以通过先 `checkout` 代表此 Pull Request 的远端分支再由此分支建立一个本地分支： ```bash $ git checkout pr/42 pr-42 ``` -操作多个仓库的时候，可以在Git中设置获取Pull Request的全局选项。 +操作多个仓库的时候，可以在 Git 中设置获取 Pull Request 的全局选项。 -``` - git config --global --add remote.origin.fetch "+refs/pull/*/head:refs/remotes/origin/pr/*" +```bash +git config --global --add remote.origin.fetch "+refs/pull/*/head:refs/remotes/origin/pr/*" ``` 此时可以在任意仓库中使用以下命令： -``` +```bash git fetch origin ``` -``` +```bash git checkout pr/42 ``` -[*进一步了解如何检出pull request到本地.*](https://help.github.com/articles/checking-out-pull-requests-locally) +[*进一步了解如何本地检出 pull request.*](https://help.github.com/articles/checking-out-pull-requests-locally) -### 提交空改动 :trollface: +### 没有任何改动的提交 可以使用`--allow-empty`选项强制创建一个没有任何改动的提交： ```bash @@ -661,9 +715,11 @@ $ git commit -m "Big-ass commit" --allow-empty - 标记新的工作或一个新功能的开始。 - 记录对项目的跟代码无关的改动。 - 跟使用你仓库的其他人交流。 - - 作为仓库的第一次提交，因为第一次提交后不能被rebase： `git commit -m "init repo" --allow-empty`. + - 作为仓库的第一次提交，因为第一次提交后不能被 rebase： `git commit -m "init repo" --allow-empty`. -### 更直观的Git Status + ![It ain't even that trolololol...](http://i.minus.com/il1jaw.gif) + +### 美化 Git Status 在命令行输入如下命令: ```bash @@ -672,7 +728,7 @@ $ git status 可以看到: -![git status](http://i.imgur.com/o3PEHAA.png) +![git status](http://i.imgur.com/qjPyvXb.png) 加上`-sb`选项: @@ -682,11 +738,11 @@ $ git status -sb 这会得到: -![git status -sb](http://i.imgur.com/xNI1bT0.png) +![git status -sb](http://i.imgur.com/K0OY3nm.png) [*进一步了解 Git `status` 命令.*](http://git-scm.com/docs/git-status) -### 更直观的Git Log +### 美化 Git Log 输入如下命令: ```bash @@ -695,16 +751,16 @@ $ git log --all --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s 可以看到: -![git log --all --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --date=relative](http://i.imgur.com/R2z8l7c.png) +![git log --all --graph --pretty=format:'%Cred%h%Creset -%C(auto)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --date=relative](http://i.imgur.com/58eOtkW.png) -这要归功于[Palesz](http://stackoverflow.com/users/88355/palesz)在stackoverflow的回答。 +这要归功于 [Palesz](http://stackoverflow.com/users/88355/palesz) 在 stackoverflow 的回答。 *这个命令可以被用作别名，详细做法见[这里](#git%E5%91%BD%E4%BB%A4%E8%87%AA%E5%AE%9A%E4%B9%89%E5%88%AB%E5%90%8D)。* [*进一步了解 Git `log` 命令.*](http://git-scm.com/docs/git-log) -### Git查询 -Git查询运行你在之前的所有提交信息里进行搜索，找到其中和搜索条件相匹配的最近的一条。 +### Git 查询 +Git 查询运行你在之前的所有提交信息里进行搜索，找到其中和搜索条件相匹配的最近的一条。 ```bash $ git show :/query @@ -738,8 +794,17 @@ $ git branch --no-merged [*进一步了解 Git `branch` 命令.*](http://git-scm.com/docs/git-branch) -### 使用网页查看本地仓库 -使用Git的 `instaweb` 可以立即在 `gitweb`中浏览你的工作仓库。这个命令是个简单的脚本，配置了`gitweb`和用来浏览本地仓库的Web服务器。*（译者注：默认需要lighttpd支持）* +### 修复有问题的提交以及自动合并 +如果上一个或多个提交包含了错误，可以在你修复问题后使用下列命令处理（假设要修复的提交版本是`abcde`）： +```bash +$ git commit --fixup=abcde +$ git rebase abcde^ --autosquash -i +``` +[*进一步了解 Git `commit` 命令.*](http://git-scm.com/docs/git-commit) +[*进一步了解 Git `rebase` 命令.*](http://git-scm.com/docs/git-rebase) + +### 以网站方式查看本地仓库 +使用 Git 的 `instaweb` 可以立即在 `gitweb` 中浏览你的工作仓库。这个命令是个简单的脚本，配置了 `gitweb` 和用来浏览本地仓库的Web服务器。*（译者注：默认需要lighttpd支持）* ```bash $ git instaweb @@ -751,11 +816,11 @@ $ git instaweb [*进一步了解 Git `instaweb` 命令.*](http://git-scm.com/docs/git-instaweb) -### Git配置 -所有Git配置都保存在你的`.gitconfig` 文件中。 +### Git 配置 +所有 Git 配置都保存在你的 `.gitconfig` 文件中。 -#### Git命令自定义别名 -别名用来帮助你定义自己的git命令。比如你可以定义 `git a` 来运行 `git add --all`。 +#### Git 命令自定义别名 +别名用来帮助你定义自己的 git 命令。比如你可以定义 `git a` 来运行 `git add --all`。 要添加一个别名， 一种方法是打开 `~/.gitconfig` 文件并添加如下内容： @@ -828,8 +893,8 @@ $ git comit -m "Message" # in 0.1 seconds automatically... ``` -#### 带颜色输出 -要在你的Git命令输出里加上颜色的话，可以用如下命令： +#### 颜色输出 +要在你的 Git 命令输出里加上颜色的话，可以用如下命令： ```bash $ git config --global color.ui 1 @@ -837,7 +902,7 @@ $ git config --global color.ui 1 [*进一步了解 Git `config` 命令.*](http://git-scm.com/docs/git-config) -### Git资源 +### Git 资源 | Title | Link | | ----- | ---- | | Official Git Site | http://git-scm.com/ | @@ -852,7 +917,7 @@ $ git config --global color.ui 1 | Git for Computer Scientists | http://eagain.net/articles/git-for-computer-scientists/ | | Git Magic | http://www-cs-students.stanford.edu/~blynn/gitmagic/ | -#### Git参考书籍 +#### Git 参考书籍 | Title | Link | | ----- | ---- | | Pragmatic Version Control Using Git | http://www.pragprog.com/titles/tsgit/pragmatic-version-control-using-git |