Merge pull request #362 from lumynou5/change-author

Add method to change authors for multiple commits

.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+package-lock.json

.travis.yml

@@ -0,0 +1,11 @@
+language: ruby
+rvm:
+  - 2.2
+before_script:
+  - gem install awesome_bot
+  - npm install
+script:
+- awesome_bot README.md --allow-dupe --allow-redirect --allow-ssl
+- awesome_bot README_*.md --allow-dupe --allow-redirect --allow-ssl
+- npm run toc
+- npm run diff

CONTRIBUTE.md

@@ -26,3 +26,21 @@ This is a community built document. Dive in and help out!
         ```sh
         (relevant branch)$ git blah blah
         ```
+
+## Translation
+
+We use a translation tool called [GitLocalize][gl]. Please follow these steps to get started with your contributions:
+
+1. Go to [GitLocalize's k88hudson/git-flight-rules repository][gl-repo].
+1. Sign up using your GitHub account :octocat:.
+1. Find the document you are going to translate.
+1. Happy translating :sparkles: .
+1. When you are done, send the translation for reviews.
+1. The reviewed translation will be sent as a Pull Request to GitHub by the language moderator in the community.
+
+To learn more about how GitLocalize works, visit their [help page][gl-help]. If you find any issues or feature requests, please file them in [GitLocalize's issue tracker][gl-issue-tracker].
+
+[gl]: https://gitlocalize.com
+[gl-help]: https://docs.gitlocalize.com/
+[gl-issue-tracker]: https://github.com/gitlocalize/feedback
+[gl-repo]: https://gitlocalize.com/repo/598

README_zh-CN.md

@@ -1,7 +1,7 @@
 # Git飞行规则(Flight Rules)
 
 🌍
-*[English](README.md) ∙ [Русский](README_ru.md) ∙ [简体中文](README_zh-cn.md)*
+*[English](README.md) ∙ [Español](README_es.md)  ∙  [Русский](README_ru.md) ∙ [繁體中文](README_zh-TW.md) ∙ [简体中文](README_zh-CN.md) ∙ [한국어](README_kr.md)  ∙  [Tiếng Việt](README_vi.md) ∙ [Français](README_fr.md) ∙ [日本語](README_ja.md)*
 
 #### 前言
 
@@ -10,7 +10,7 @@
 
 #### 什么是"飞行规则"?
 
-一个 [宇航员指南](http://www.jsc.nasa.gov/news/columbia/fr_generic.pdf) (现在, 程序员们都在使用GIT) 是关于出现问题过后应该怎么操作。
+这是一篇给宇航员（这里就是指使用Git的程序员们）的指南，用来指导问题出现后的应对之法。
 
 >  *飞行规则(Flight Rules)* 是记录在手册上的来之不易的一系列知识，记录了某个事情发生的原因，以及怎样一步一步的进行处理。本质上, 它们是特定场景的非常详细的标准处理流程。 [...]
 
@@ -32,7 +32,7 @@
     - [我的提交信息(commit message)写错了](#%E6%88%91%E7%9A%84%E6%8F%90%E4%BA%A4%E4%BF%A1%E6%81%AFcommit-message%E5%86%99%E9%94%99%E4%BA%86)
     - [我提交(commit)里的用户名和邮箱不对](#%E6%88%91%E6%8F%90%E4%BA%A4commit%E9%87%8C%E7%9A%84%E7%94%A8%E6%88%B7%E5%90%8D%E5%92%8C%E9%82%AE%E7%AE%B1%E4%B8%8D%E5%AF%B9)
     - [我想从一个提交(commit)里移除一个文件](#%E6%88%91%E6%83%B3%E4%BB%8E%E4%B8%80%E4%B8%AA%E6%8F%90%E4%BA%A4commit%E9%87%8C%E7%A7%BB%E9%99%A4%E4%B8%80%E4%B8%AA%E6%96%87%E4%BB%B6)
-    - [我想删除我的的最后一次提交(commit)](#%E6%88%91%E6%83%B3%E5%88%A0%E9%99%A4%E6%88%91%E7%9A%84%E7%9A%84%E6%9C%80%E5%90%8E%E4%B8%80%E6%AC%A1%E6%8F%90%E4%BA%A4commit)
+    - [我想删除我的最后一次提交(commit)](#%E6%88%91%E6%83%B3%E5%88%A0%E9%99%A4%E6%88%91%E7%9A%84%E7%9A%84%E6%9C%80%E5%90%8E%E4%B8%80%E6%AC%A1%E6%8F%90%E4%BA%A4commit)
     - [删除任意提交(commit)](#%E5%88%A0%E9%99%A4%E4%BB%BB%E6%84%8F%E6%8F%90%E4%BA%A4commit)
     - [我尝试推一个修正后的提交(amended commit)到远程，但是报错：](#%E6%88%91%E5%B0%9D%E8%AF%95%E6%8E%A8%E4%B8%80%E4%B8%AA%E4%BF%AE%E6%AD%A3%E5%90%8E%E7%9A%84%E6%8F%90%E4%BA%A4amended-commit%E5%88%B0%E8%BF%9C%E7%A8%8B%E4%BD%86%E6%98%AF%E6%8A%A5%E9%94%99)
     - [我意外的做了一次硬重置(hard reset)，我想找回我的内容](#%E6%88%91%E6%84%8F%E5%A4%96%E7%9A%84%E5%81%9A%E4%BA%86%E4%B8%80%E6%AC%A1%E7%A1%AC%E9%87%8D%E7%BD%AEhard-reset%E6%88%91%E6%83%B3%E6%89%BE%E5%9B%9E%E6%88%91%E7%9A%84%E5%86%85%E5%AE%B9)
@@ -49,7 +49,7 @@
   - [分支(Branches)](#%E5%88%86%E6%94%AFbranches)
     - [我从错误的分支拉取了内容，或把内容拉取到了错误的分支](#%E6%88%91%E4%BB%8E%E9%94%99%E8%AF%AF%E7%9A%84%E5%88%86%E6%94%AF%E6%8B%89%E5%8F%96%E4%BA%86%E5%86%85%E5%AE%B9%E6%88%96%E6%8A%8A%E5%86%85%E5%AE%B9%E6%8B%89%E5%8F%96%E5%88%B0%E4%BA%86%E9%94%99%E8%AF%AF%E7%9A%84%E5%88%86%E6%94%AF)
     - [我想扔掉本地的提交(commit)，以便我的分支与远程的保持一致](#%E6%88%91%E6%83%B3%E6%89%94%E6%8E%89%E6%9C%AC%E5%9C%B0%E7%9A%84%E6%8F%90%E4%BA%A4commit%E4%BB%A5%E4%BE%BF%E6%88%91%E7%9A%84%E5%88%86%E6%94%AF%E4%B8%8E%E8%BF%9C%E7%A8%8B%E7%9A%84%E4%BF%9D%E6%8C%81%E4%B8%80%E8%87%B4)
-    - [我需要提交到一个新分支，但错误的提交到了master](#%E6%88%91%E9%9C%80%E8%A6%81%E6%8F%90%E4%BA%A4%E5%88%B0%E4%B8%80%E4%B8%AA%E6%96%B0%E5%88%86%E6%94%AF%E4%BD%86%E9%94%99%E8%AF%AF%E7%9A%84%E6%8F%90%E4%BA%A4%E5%88%B0%E4%BA%86master)
+    - [我需要提交到一个新分支，但错误的提交到了main](#%E6%88%91%E9%9C%80%E8%A6%81%E6%8F%90%E4%BA%A4%E5%88%B0%E4%B8%80%E4%B8%AA%E6%96%B0%E5%88%86%E6%94%AF%E4%BD%86%E9%94%99%E8%AF%AF%E7%9A%84%E6%8F%90%E4%BA%A4%E5%88%B0%E4%BA%86main)
     - [我想保留来自另外一个ref-ish的整个文件](#%E6%88%91%E6%83%B3%E4%BF%9D%E7%95%99%E6%9D%A5%E8%87%AA%E5%8F%A6%E5%A4%96%E4%B8%80%E4%B8%AAref-ish%E7%9A%84%E6%95%B4%E4%B8%AA%E6%96%87%E4%BB%B6)
     - [我把几个提交(commit)提交到了同一个分支，而这些提交应该分布在不同的分支里](#%E6%88%91%E6%8A%8A%E5%87%A0%E4%B8%AA%E6%8F%90%E4%BA%A4commit%E6%8F%90%E4%BA%A4%E5%88%B0%E4%BA%86%E5%90%8C%E4%B8%80%E4%B8%AA%E5%88%86%E6%94%AF%E8%80%8C%E8%BF%99%E4%BA%9B%E6%8F%90%E4%BA%A4%E5%BA%94%E8%AF%A5%E5%88%86%E5%B8%83%E5%9C%A8%E4%B8%8D%E5%90%8C%E7%9A%84%E5%88%86%E6%94%AF%E9%87%8C)
     - [我想删除上游(upstream)分支被删除了的本地分支](#%E6%88%91%E6%83%B3%E5%88%A0%E9%99%A4%E4%B8%8A%E6%B8%B8upstream%E5%88%86%E6%94%AF%E8%A2%AB%E5%88%A0%E9%99%A4%E4%BA%86%E7%9A%84%E6%9C%AC%E5%9C%B0%E5%88%86%E6%94%AF)
@@ -67,6 +67,12 @@
     - [交互式rebase(interactive rebase)可能出现的问题](#%E4%BA%A4%E4%BA%92%E5%BC%8Frebaseinteractive-rebase%E5%8F%AF%E8%83%BD%E5%87%BA%E7%8E%B0%E7%9A%84%E9%97%AE%E9%A2%98)
       - [这个rebase 编辑屏幕出现'noop'](#%E8%BF%99%E4%B8%AArebase-%E7%BC%96%E8%BE%91%E5%B1%8F%E5%B9%95%E5%87%BA%E7%8E%B0noop)
       - [有冲突的情况](#%E6%9C%89%E5%86%B2%E7%AA%81%E7%9A%84%E6%83%85%E5%86%B5)
+  - [Stash](#stash)
+    - [暂存所有改动](#%E6%9A%82%E5%AD%98%E6%89%80%E6%9C%89%E6%94%B9%E5%8A%A8)
+    - [暂存指定文件](#%E6%9A%82%E5%AD%98%E6%8C%87%E5%AE%9A%E6%96%87%E4%BB%B6)
+    - [暂存时记录消息](#%E6%9A%82%E5%AD%98%E6%97%B6%E8%AE%B0%E5%BD%95%E6%B6%88%E6%81%AF)
+    - [使用某个指定暂存](#%E4%BD%BF%E7%94%A8%E6%9F%90%E4%B8%AA%E6%8C%87%E5%AE%9A%E6%9A%82%E5%AD%98)
+    - [暂存时保留未暂存的内容](#%E6%9A%82%E5%AD%98%E6%97%B6%E4%BF%9D%E7%95%99%E6%9C%AA%E6%9A%82%E5%AD%98%E7%9A%84%E5%86%85%E5%AE%B9)
   - [杂项(Miscellaneous Objects)](#%E6%9D%82%E9%A1%B9miscellaneous-objects)
     - [克隆所有子模块](#%E5%85%8B%E9%9A%86%E6%89%80%E6%9C%89%E5%AD%90%E6%A8%A1%E5%9D%97)
     - [删除标签(tag)](#%E5%88%A0%E9%99%A4%E6%A0%87%E7%AD%BEtag)
@@ -87,7 +93,6 @@
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
-
 ## 编辑提交(editting commits)
 
 <a name="diff-last"></a>
@@ -96,7 +101,7 @@
 如果你用 `git commit -a` 提交了一次变化(changes)，而你又不确定到底这次提交了哪些内容。 你就可以用下面的命令显示当前`HEAD`上的最近一次的提交(commit):
 
 ```sh
-(master)$ git show
+(main)$ git show
 ```
 
 或者
@@ -105,18 +110,18 @@
 $ git log -n1 -p
 ```
 
-<a name="#i-wrote-the-wrong-thing-in-a-commit-message"></a>
+<a name="wrong-thing-in-commit-message"></a>
 ### 我的提交信息(commit message)写错了
 
 如果你的提交信息(commit message)写错了且这次提交(commit)还没有推(push), 你可以通过下面的方法来修改提交信息(commit message):
 
 ```sh
-$ git commit --amend
+$ git commit --amend --only
 ```
 这会打开你的默认编辑器, 在这里你可以编辑信息. 另一方面, 你也可以用一条命令一次完成:
 
 ```sh
-$ git commit --amend -m 'xxxxxxx'
+$ git commit --amend --only -m 'xxxxxxx'
 ```
 
 如果你已经推(push)了这次提交(commit), 你可以修改这次提交(commit)然后强推(force push), 但是不推荐这么做。
@@ -132,8 +137,7 @@ $ git commit --amend --author "New Authorname <authoremail@mydomain.com>"
 
 如果你需要修改所有历史, 参考 'git filter-branch'的指南页.
 
-
-<a href="#i-want-to-remove-a-file-from-a-commit"></a>
+<a name="remove-file-from-commit"></a>
 ### 我想从一个提交(commit)里移除一个文件
 
 通过下面的方法，从一个提交(commit)里移除一个文件:
@@ -159,8 +163,7 @@ $ git push -f [remote] [branch]
 如果你还没有推到远程, 把Git重置(reset)到你最后一次提交前的状态就可以了(同时保存暂存的变化):
 
 ```
-(my-branch*)$ git reset --soft HEAD@{1}
-
+(my-branch)$ git reset --soft HEAD^
 ```
 
 这只能在没有推送之前有用. 如果你已经推了, 唯一安全能做的是 `git revert SHAofBadCommit`， 那会创建一个新的提交(commit)用于撤消前一个提交的所有变化(changes)； 或者, 如果你推的这个分支是rebase-safe的 (例如： 其它开发者不会从这个分支拉), 只需要使用 `git push -f`； 更多, 请参考 [the above section](#deleteremove-last-pushed-commit)。
@@ -177,7 +180,7 @@ $ git push -f [remote] [branch]
 
 或者做一个 [交互式rebase](#interactive-rebase) 删除那些你想要删除的提交(commit)里所对应的行。
 
-<a name="#force-push"></a>
+<a name="force-push"></a>
 ### 我尝试推一个修正后的提交(amended commit)到远程，但是报错：
 
 ```sh
@@ -198,26 +201,26 @@ hint: See the 'Note about fast-forwards' in 'git push --help' for details.
 
 一般来说, **要避免强推**. 最好是创建和推(push)一个新的提交(commit)，而不是强推一个修正后的提交。后者会使那些与该分支或该分支的子分支工作的开发者，在源历史中产生冲突。
 
-<a href="undo-git-reset-hard"></a>
+<a name="undo-git-reset-hard"></a>
 ### 我意外的做了一次硬重置(hard reset)，我想找回我的内容
 
 如果你意外的做了 `git reset --hard`, 你通常能找回你的提交(commit), 因为Git对每件事都会有日志，且都会保存几天。
 
 ```sh
-(master)$ git reflog
+(main)$ git reflog
 ```
 
 你将会看到一个你过去提交(commit)的列表, 和一个重置的提交。 选择你想要回到的提交(commit)的SHA，再重置一次:
 
 ```sh
-(master)$ git reset --hard SHA1234
+(main)$ git reset --hard SHA1234
 ```
 
 这样就完成了。
 
 ## 暂存(Staging)
 
-<a href="#i-need-to-add-staged-changes-to-the-previous-commit"></a>
+<a name="add-staged-changes-to-previous-commit"></a>
 ### 我需要把暂存的内容添加到上一次的提交(commit)
 
 ```sh
@@ -242,35 +245,38 @@ $ git add -N filename.x
 
 然后, 你需要用 `e` 选项来手动选择需要添加的行，执行 `git diff --cached` 将会显示哪些行暂存了哪些行只是保存在本地了。
 
-
-<a href="stage-in-two-commits"></a>
+<a name="stage-in-two-commits"></a>
 ### 我想把在一个文件里的变化(changes)加到两个提交(commit)里
 
 `git add` 会把整个文件加入到一个提交. `git add -p` 允许交互式的选择你想要提交的部分.
 
-
-<a href="unstaging-edits-and-staging-the-unstaged"></a>
+<a name="unstaging-edits-and-staging-the-unstaged"></a>
 ### 我想把暂存的内容变成未暂存，把未暂存的内容暂存起来
 
-这个有点困难， 我能想到的最好的方法是先stash未暂存的内容， 然后重置(reset)，再pop第一步stashed的内容, 最后再add它们。
+多数情况下，你应该将所有的内容变为未暂存，然后再选择你想要的内容进行commit。
+但假定你就是想要这么做，这里你可以创建一个临时的commit来保存你已暂存的内容，然后暂存你的未暂存的内容并进行stash。然后reset最后一个commit将原本暂存的内容变为未暂存，最后stash pop回来。
 
 ```sh
-$ git stash -k
-$ git reset --hard
-$ git stash pop
-$ git add -A
+$ git commit -m "WIP"
+$ git add .
+$ git stash
+$ git reset HEAD^
+$ git stash pop --index 0
 ```
 
+注意1: 这里使用`pop`仅仅是因为想尽可能保持幂等。
+注意2: 假如你不加上`--index`你会把暂存的文件标记为为存储.这个[链接](https://stackoverflow.com/questions/31595873/git-stash-with-staged-files-does-stash-convert-staged-files-to-unstaged?answertab=active#tab-top) 解释得比较清楚。（不过是英文的，其大意是说，这是一个较为底层的问题，stash时会做2个commit，其中一个会记录index状态，staged的文件等东西，另一个记录worktree和其他的一些东西，如果你不在apply时加index，git会把两个一起销毁，所以staged里就空了）。
+
 ## 未暂存(Unstaged)的内容
 
-<a href="move-unstaged-edits-to-new-branch"></a>
+<a name="move-unstaged-edits-to-new-branch"></a>
 ### 我想把未暂存的内容移动到一个新分支
 
 ```sh
 $ git checkout -b my-branch
 ```
 
-<a href="move-unstaged-edits-to-old-branch"></a>
+<a name="move-unstaged-edits-to-old-branch"></a>
 ### 我想把未暂存的内容移动到另一个已存在的分支
 
 ```sh
@@ -279,7 +285,7 @@ $ git checkout my-branch
 $ git stash pop
 ```
 
-<a href="i-want-to-discard-my-local-uncommitted-changes"></a>
+<a name="discard-local-uncommitted-changes"></a>
 ### 我想丢弃本地未提交的变化(uncommitted changes)
 
 如果你只是想重置源(origin)和你本地(local)之间的一些提交(commit)，你可以：
@@ -292,7 +298,7 @@ $ git stash pop
 # four commits
 (my-branch)$ git reset --hard HEAD~4
 # or
-(master)$ git checkout -f
+(main)$ git checkout -f
 ```
 
 重置某个特殊的文件, 你可以用文件名做为参数:
@@ -301,7 +307,7 @@ $ git stash pop
 $ git reset filename
 ```
 
-<a href="i-want-to-discard-specific-unstaged-changes"></a>
+<a name="discard-specific-unstaged-changes"></a>
 ### 我想丢弃某些未暂存的内容
 
 如果你想丢弃工作拷贝中的一部分内容，而不是全部。
@@ -338,7 +344,7 @@ $ git stash drop
 这是另外一种使用 `git reflog` 情况，找到在这次错误拉(pull) 之前HEAD的指向。
 
 ```sh
-(master)$ git reflog
+(main)$ git reflog
 ab7555f HEAD@{0}: pull origin wrong-branch: Fast-forward
 c5bc55a HEAD@{1}: checkout: checkout message goes here
 ```
@@ -351,7 +357,7 @@ $ git reset --hard c5bc55a
 
 完成。
 
-<a href="discard-local-commits"></a>
+<a name="discard-local-commits"></a>
 ### 我想扔掉本地的提交(commit)，以便我的分支与远程的保持一致
 
 先确认你没有推(push)你的内容到远程。
@@ -369,39 +375,39 @@ $ git reset --hard c5bc55a
 一种方法是:
 
 ```sh
-(master)$ git reset --hard origin/my-branch
+(my-branch)$ git reset --hard origin/my-branch
 ```
 
 <a name="commit-wrong-branch"></a>
-### 我需要提交到一个新分支，但错误的提交到了master
+### 我需要提交到一个新分支，但错误的提交到了main
 
-在master下创建一个新分支，不切换到新分支,仍在master下:
+在main下创建一个新分支，不切换到新分支,仍在main下:
 
 ```sh
-(master)$ git branch my-branch
+(main)$ git branch my-branch
 ```
 
-把master分支重置到前一个提交:
+把main分支重置到前一个提交:
 
 ```sh
-(master)$ git reset --hard HEAD^
+(main)$ git reset --hard HEAD^
 ```
 
 `HEAD^` 是 `HEAD^1` 的简写，你可以通过指定要设置的`HEAD`来进一步重置。
 
 或者, 如果你不想使用 `HEAD^`, 找到你想重置到的提交(commit)的hash(`git log` 能够完成)， 然后重置到这个hash。 使用`git push` 同步内容到远程。
 
-例如, master分支想重置到的提交的hash为`a13b85e`:
+例如, main分支想重置到的提交的hash为`a13b85e`:
 
 ```sh
-(master)$ git reset --hard a13b85e
+(main)$ git reset --hard a13b85e
 HEAD is now at a13b85e
 ```
 
 签出(checkout)刚才新建的分支继续工作:
 
 ```sh
-(master)$ git checkout my-branch
+(main)$ git checkout my-branch
 ```
 
 <a name="keep-whole-file"></a>
@@ -444,10 +450,10 @@ Note: Spike solutions are made to analyze or solve the problem. These solutions
 <a name="cherry-pick"></a>
 ### 我把几个提交(commit)提交到了同一个分支，而这些提交应该分布在不同的分支里
 
-假设你有一个`master`分支， 执行`git log`, 你看到你做过两次提交:
+假设你有一个`main`分支， 执行`git log`, 你看到你做过两次提交:
 
 ```sh
-(master)$ git log
+(main)$ git log
 
 commit e3851e817c451cc36f2e6f3049db528415e3c114
 Author: Alex Lee <alexlee@example.com>
@@ -470,17 +476,17 @@ Date:   Tue Jul 21 01:12:48 2014 -0400
 
 让我们用提交hash(commit hash)标记bug (`e3851e8` for #21, `5ea5173` for #14).
 
-首先, 我们把`master`分支重置到正确的提交(`a13b85e`):
+首先, 我们把`main`分支重置到正确的提交(`a13b85e`):
 
 ```sh
-(master)$ git reset --hard a13b85e
+(main)$ git reset --hard a13b85e
 HEAD is now at a13b85e
 ```
 
 现在, 我们对 bug #21 创建一个新的分支:
 
 ```sh
-(master)$ git checkout -b 21
+(main)$ git checkout -b 21
 (21)$
 ```
 
@@ -492,12 +498,11 @@ HEAD is now at a13b85e
 
 这时候, 这里可能会产生冲突， 参见[交互式 rebasing 章](#interactive-rebase) [**冲突节**](#merge-conflict) 解决冲突.
 
-
-再者， 我们为bug #14 创建一个新的分支, 也基于`master`分支
+再者， 我们为bug #14 创建一个新的分支, 也基于`main`分支
 
 ```sh
-(21)$ git checkout master
-(master)$ git checkout -b 14
+(21)$ git checkout main
+(main)$ git checkout -b 14
 (14)$
 ```
 
@@ -507,7 +512,6 @@ HEAD is now at a13b85e
 (14)$ git cherry-pick 5ea5173
 ```
 
-
 <a name="delete-stale-local-branches"></a>
 ### 我想删除上游(upstream)分支被删除了的本地分支
 一旦你在github 上面合并(merge)了一个pull request, 你就可以删除你fork里被合并的分支。 如果你不准备继续在这个分支里工作, 删除这个分支的本地拷贝会更干净，使你不会陷入工作分支和一堆陈旧分支的混乱之中。
@@ -516,13 +520,13 @@ HEAD is now at a13b85e
 $ git fetch -p
 ```
 
-<a name='restore-a-deleted-branch'></a>
+<a name="restore-a-deleted-branch"></a>
 ### 我不小心删除了我的分支
 
 如果你定期推送到远程, 多数情况下应该是安全的，但有些时候还是可能删除了还没有推到远程的分支。 让我们先创建一个分支和一个新的文件:
 
 ```sh
-(master)$ git checkout -b my-branch
+(main)$ git checkout -b my-branch
 (my-branch)$ git branch
 (my-branch)$ touch foo.txt
 (my-branch)$ ls
@@ -552,31 +556,31 @@ Date:   Tue Jul 29 13:14:46 2014 -0400
     Fixes #6: Force pushing after amending commits
 ```
 
-现在我们切回到主(master)分支，‘不小心的’删除`my-branch`分支
+现在我们切回到主(main)分支，‘不小心的’删除`my-branch`分支
 
 ```sh
-(my-branch)$ git checkout master
-Switched to branch 'master'
-Your branch is up-to-date with 'origin/master'.
-(master)$ git branch -D my-branch
+(my-branch)$ git checkout main
+Switched to branch 'main'
+Your branch is up-to-date with 'origin/main'.
+(main)$ git branch -D my-branch
 Deleted branch my-branch (was 4e3cd85).
-(master)$ echo oh noes, deleted my branch!
+(main)$ echo oh noes, deleted my branch!
 oh noes, deleted my branch!
 ```
 
 在这时候你应该想起了`reflog`, 一个升级版的日志，它存储了仓库(repo)里面所有动作的历史。
 
 ```
-(master)$ git reflog
-69204cd HEAD@{0}: checkout: moving from my-branch to master
+(main)$ git reflog
+69204cd HEAD@{0}: checkout: moving from my-branch to main
 4e3cd85 HEAD@{1}: commit: foo.txt added
-69204cd HEAD@{2}: checkout: moving from master to my-branch
+69204cd HEAD@{2}: checkout: moving from main to my-branch
 ```
 
 正如你所见，我们有一个来自删除分支的提交hash(commit hash)，接下来看看是否能恢复删除了的分支。
 
 ```sh
-(master)$ git checkout -b my-branch-help
+(main)$ git checkout -b my-branch-help
 Switched to a new branch 'my-branch-help'
 (my-branch-help)$ git reset --hard 4e3cd85
 HEAD is now at 4e3cd85 foo.txt added
@@ -586,40 +590,40 @@ README.md foo.txt
 
 看! 我们把删除的文件找回来了。 Git的 `reflog` 在rebasing出错的时候也是同样有用的。
 
-<a name="i-want-to-delete-a-branch"></a>
+<a name="delete-branch"></a>
 ### 我想删除一个分支
 
 删除一个远程分支:
 
 ```sh
-(master)$ git push origin --delete my-branch
+(main)$ git push origin --delete my-branch
 ```
 
 你也可以:
 
 ```sh
-(master)$ git push origin :my-branch
+(main)$ git push origin :my-branch
 ```
 
 删除一个本地分支:
 
 ```sh
-(master)$ git branch -D my-branch
+(main)$ git branch -D my-branch
 ```
 
-<a name="i-want-to-checkout-to-a-remote-branch-that-someone-else-is-working-on"></a>
+<a name="working-on-checkout-remote-branch"></a>
 ### 我想从别人正在工作的远程分支签出(checkout)一个分支
 
 首先, 从远程拉取(fetch) 所有分支:
 
 ```sh
-(master)$ git fetch --all
+(main)$ git fetch --all
 ```
 
 假设你想要从远程的`daves`分支签出到本地的`daves`
 
 ```sh
-(master)$ git checkout --track origin/daves
+(main)$ git checkout --track origin/daves
 Branch daves set up to track remote branch daves from origin.
 Switched to a new branch 'daves'
 ```
@@ -645,10 +649,10 @@ Switched to a new branch 'daves'
 不幸的是，如果你想把这些变化(changes)反应到远程分支上，你就必须得强推(force push)。 是因你快进(Fast forward)了提交，改变了Git历史, 远程分支不会接受变化(changes)，除非强推(force push)。这就是许多人使用 merge 工作流, 而不是 rebasing 工作流的主要原因之一， 开发者的强推(force push)会使大的团队陷入麻烦。使用时需要注意，一种安全使用 rebase 的方法是，不要把你的变化(changes)反映到远程分支上, 而是按下面的做:
 
 ```sh
-(master)$ git checkout my-branch
-(my-branch)$ git rebase -i master
-(my-branch)$ git checkout master
-(master)$ git merge --ff-only my-branch
+(main)$ git checkout my-branch
+(my-branch)$ git rebase -i main
+(my-branch)$ git checkout main
+(main)$ git merge --ff-only my-branch
 ```
 
 更多, 参见 [this SO thread](http://stackoverflow.com/questions/11058312/how-can-i-use-git-rebase-without-requiring-a-forced-push).
@@ -656,23 +660,23 @@ Switched to a new branch 'daves'
 <a name="interactive-rebase"></a>
 ### 我需要组合(combine)几个提交(commit)
 
-假设你的工作分支将会做对于 `master` 的pull-request。 一般情况下你不关心提交(commit)的时间戳，只想组合 *所有* 提交(commit) 到一个单独的里面, 然后重置(reset)重提交(recommit)。 确保主(master)分支是最新的和你的变化都已经提交了, 然后:
+假设你的工作分支将会做对于 `main` 的pull-request。 一般情况下你不关心提交(commit)的时间戳，只想组合 *所有* 提交(commit) 到一个单独的里面, 然后重置(reset)重提交(recommit)。 确保主(main)分支是最新的和你的变化都已经提交了, 然后:
 
 ```sh
-(my-branch)$ git reset --soft master
+(my-branch)$ git reset --soft main
 (my-branch)$ git commit -am "New awesome feature"
 ```
 
 如果你想要更多的控制, 想要保留时间戳, 你需要做交互式rebase (interactive rebase):
 
 ```sh
-(my-branch)$ git rebase -i master
+(my-branch)$ git rebase -i main
 ```
 
 如果没有相对的其它分支， 你将不得不相对自己的`HEAD` 进行 rebase。 例如：你想组合最近的两次提交(commit), 你将相对于`HEAD~2` 进行rebase， 组合最近3次提交(commit), 相对于`HEAD~3`, 等等。
 
 ```sh
-(master)$ git rebase -i HEAD~2
+(main)$ git rebase -i HEAD~2
 ```
 
 在你执行了交互式 rebase的命令(interactive rebase command)后, 你将在你的编辑器里看到类似下面的内容:
@@ -732,7 +736,7 @@ Newer, awesomer features
 # Please enter the commit message for your changes. Lines starting
 # with '#' will be ignored, and an empty message aborts the commit.
 # rebase in progress; onto 8074d12
-# You are currently editing a commit while rebasing branch 'master' on '8074d12'.
+# You are currently editing a commit while rebasing branch 'main' on '8074d12'.
 #
 # Changes to be committed:
 #	modified:   README.md
@@ -743,20 +747,20 @@ Newer, awesomer features
 如果成功了, 你应该看到类似下面的内容:
 
 ```sh
-(master)$ Successfully rebased and updated refs/heads/master.
+(main)$ Successfully rebased and updated refs/heads/main.
 ```
 
 #### 安全合并(merging)策略
 `--no-commit` 执行合并(merge)但不自动提交, 给用户在做提交前检查和修改的机会。 `no-ff` 会为特性分支(feature branch)的存在过留下证据, 保持项目历史一致。
 
 ```sh
-(master)$ git merge --no-ff --no-commit my-branch
+(main)$ git merge --no-ff --no-commit my-branch
 ```
 
 #### 我需要将一个分支合并成一个提交(commit)
 
 ```sh
-(master)$ git merge --squash my-branch
+(main)$ git merge --squash my-branch
 ```
 
 <a name="rebase-unpushed-commits"></a>
@@ -765,7 +769,7 @@ Newer, awesomer features
 有时候，在将数据推向上游之前，你有几个正在进行的工作提交(commit)。这时候不希望把已经推(push)过的组合进来，因为其他人可能已经有提交(commit)引用它们了。
 
 ```sh
-(master)$ git rebase -i @{u}
+(main)$ git rebase -i @{u}
 ```
 
 这会产生一次交互式的rebase(interactive rebase), 只会列出没有推(push)的提交(commit)， 在这个列表时进行reorder/fix/squash 都是安全的。
@@ -776,13 +780,13 @@ Newer, awesomer features
 检查一个分支上的所有提交(commit)是否都已经合并(merge)到了其它分支, 你应该在这些分支的head(或任何 commits)之间做一次diff:
 
 ```sh
-(master)$ git log --graph --left-right --cherry-pick --oneline HEAD...feature/120-on-scroll
+(main)$ git log --graph --left-right --cherry-pick --oneline HEAD...feature/120-on-scroll
 ```
 
 这会告诉你在一个分支里有而另一个分支没有的所有提交(commit), 和分支之间不共享的提交(commit)的列表。 另一个做法可以是:
 
 ```sh
-(master)$ git log master ^feature/120-on-scroll --no-merges
+(main)$ git log main ^feature/120-on-scroll --no-merges
 ```
 
 ### 交互式rebase(interactive rebase)可能出现的问题
@@ -797,7 +801,7 @@ noop
 
 这意味着你rebase的分支和当前分支在同一个提交(commit)上, 或者 *领先(ahead)* 当前分支。 你可以尝试:
 
-* 检查确保主(master)分支没有问题
+* 检查确保主(main)分支没有问题
 * rebase  `HEAD~2` 或者更早
 
 <a name="merge-conflict"></a>
@@ -832,7 +836,7 @@ Changes not staged for commit:
 有时候这些合并非常复杂，你应该使用可视化的差异编辑器(visual diff editor):
 
 ```sh
-(master*)$ git mergetool -t opendiff
+(main*)$ git mergetool -t opendiff
 ```
 
 在你解决完所有冲突和测试过后, `git add` 变化了的(changed)文件, 然后用`git rebase --continue` 继续rebase。
@@ -850,6 +854,82 @@ Changes not staged for commit:
 (my-branch)$ git rebase --abort
 ```
 
+<a name="stashing"></a>
+## Stash
+
+### 暂存所有改动
+
+暂存你工作目录下的所有改动
+
+```sh
+$ git stash
+```
+
+你可以使用`-u`来排除一些文件
+
+```sh
+$ git stash -u
+```
+
+### 暂存指定文件
+
+假设你只想暂存某一个文件
+
+```sh
+$ git stash push working-directory-path/filename.ext
+```
+
+假设你想暂存多个文件
+
+```sh
+$ git stash push working-directory-path/filename1.ext working-directory-path/filename2.ext
+```
+
+<a name="stash-msg"></a>
+### 暂存时记录消息
+
+这样你可以在`list`时看到它
+
+```sh
+$ git stash save <message>
+```
+或
+```sh
+$ git stash push -m <message>
+```
+<a name="stash-apply-specific"></a>
+### 使用某个指定暂存
+
+首先你可以查看你的`stash`记录
+
+```sh
+$ git stash list
+```
+
+然后你可以`apply`某个`stash`
+
+```sh
+$ git stash apply "stash@{n}"
+```
+
+此处， 'n'是`stash`在栈中的位置，最上层的`stash`会是0
+
+除此之外，也可以使用时间标记(假如你能记得的话)。
+
+```sh
+$ git stash apply "stash@{2.hours.ago}"
+```
+
+<a name="stage-and-keep-unstaged"></a>
+### 暂存时保留未暂存的内容
+
+你需要手动create一个`stash commit`， 然后使用`git stash store`。
+
+```sh
+$ git stash create
+$ git stash store -m "commit-message" CREATED_SHA1
+```
+
 <a name="miscellaneous-objects"></a>
 ## 杂项(Miscellaneous Objects)
 
@@ -900,18 +980,18 @@ $ git update-ref refs/tags/<tag_name> <hash>
 
 ## 跟踪文件(Tracking Files)
 
-<a href="i-want-to-change-a-file-names-capitalization-without-changing-the-contents-of-the-file"></a>
+<a name="change-file-name-capitalization-without-changing-contents"></a>
 ### 我只想改变一个文件名字的大小写，而不修改内容
 
 ```sh
-(master)$ git mv --force myfile MyFile
+(main)$ git mv --force myfile MyFile
 ```
 
-<a href="remove-from-git"></a>
+<a name="remove-from-git"></a>
 ### 我想从Git删除一个文件，但保留该文件
 
 ```sh
-(master)$ git rm --cached log.txt
+(main)$ git rm --cached log.txt
 ```
 
 ## 配置(Configuration)
@@ -959,7 +1039,7 @@ $ git config --global credential.helper 'cache --timeout=3600'
 # Set the cache to timeout after 1 hour (setting is in seconds)
 ```
 
-<a href="#ive-no-idea-what-i-did-wrong"></a>
+<a name="ive-no-idea-what-i-did-wrong"></a>
 ## 我不知道我做错了些什么
 
 你把事情搞砸了：你 `重置(reset)` 了一些东西, 或者你合并了错误的分支, 亦或你强推了后找不到你自己的提交(commit)了。有些时候, 你一直都做得很好, 但你想回到以前的某个状态。
@@ -967,25 +1047,24 @@ $ git config --global credential.helper 'cache --timeout=3600'
 这就是 `git reflog` 的目的， `reflog` 记录对分支顶端(the tip of a branch)的任何改变, 即使那个顶端没有被任何分支或标签引用。基本上, 每次HEAD的改变, 一条新的记录就会增加到`reflog`。遗憾的是，这只对本地分支起作用，且它只跟踪动作 (例如，不会跟踪一个没有被记录的文件的任何改变)。
 
 ```sh
-(master)$ git reflog
+(main)$ git reflog
 0a2e358 HEAD@{0}: reset: moving to HEAD~2
-0254ea7 HEAD@{1}: checkout: moving from 2.2 to master
-c10f740 HEAD@{2}: checkout: moving from master to 2.2
+0254ea7 HEAD@{1}: checkout: moving from 2.2 to main
+c10f740 HEAD@{2}: checkout: moving from main to 2.2
 ```
 
-上面的reflog展示了从master分支签出(checkout)到2.2 分支，然后再签回。 那里，还有一个硬重置(hard reset)到一个较旧的提交。最新的动作出现在最上面以 `HEAD@{0}`标识.
+上面的reflog展示了从main分支签出(checkout)到2.2 分支，然后再签回。 那里，还有一个硬重置(hard reset)到一个较旧的提交。最新的动作出现在最上面以 `HEAD@{0}`标识.
 
-如果事实证明你不小心回移(move back)了提交(commit), reflog 会包含你不小心回移前master上指向的提交(0254ea7)。
+如果事实证明你不小心回移(move back)了提交(commit), reflog 会包含你不小心回移前main上指向的提交(0254ea7)。
 
 ```sh
 $ git reset --hard 0254ea7
 ```
 
-然后使用git reset就可以把master改回到之前的commit，这提供了一个在历史被意外更改情况下的安全网。
+然后使用git reset就可以把main改回到之前的commit，这提供了一个在历史被意外更改情况下的安全网。
 
 ([摘自](https://www.atlassian.com/git/tutorials/rewriting-history/git-reflog)).
 
-
 # 其它资源(Other Resources)
 
 ## 书(Books)

package.json

@@ -0,0 +1,14 @@
+{
+  "private": true,
+  "name": "git-flight-rules",
+  "version": "1.0.0",
+  "description": "Flight rules for git",
+  "scripts": {
+    "toc": "doctoc --github README.md README_*.md",
+    "diff": "test -z \"`git diff -- README.md`\" && test -z \"`git diff -- README_*.md`\""
+  },
+  "devDependencies": {
+    "doctoc": "^1.3.0",
+    "anchor-markdown-header": "thlorenz/anchor-markdown-header#master"
+  }
+}