├── CNAME
├── .gitignore
├── images
    └── snapshots.png
├── about.html
├── cookbook.html
├── README.md
├── css
    ├── ie6.css
    ├── ie.css
    ├── reset.css
    ├── text.css
    ├── nav.css
    ├── 960.css
    ├── grid.css
    └── layout.css
├── NOTES
├── index.html
├── creating
    └── index.html
├── js
    ├── action.js
    └── jquery-ui.min.js
├── _layouts
    └── zh_reference.html
├── remotes
    └── index.html
├── inspect
    └── index.html
├── LICENSE.md
├── basic
    └── index.html
└── branching
    └── index.html


/CNAME:
--------------------------------------------------------------------------------
1 | gitref.justjavac.com
2 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | _site
2 | *~
3 | .*.swp
4 | .DS_Store
5 | 


--------------------------------------------------------------------------------
/images/snapshots.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/justjavac/git-reference/HEAD/images/snapshots.png


--------------------------------------------------------------------------------
/about.html:
--------------------------------------------------------------------------------
 1 | ---
 2 | layout: zh_reference
 3 | ---
 4 | <div class="box">
 5 |   <h2>谁的作品？</h2>
 6 |   <br/> 
 7 |   <p>Git 参考手册是 Github 项目组的成果。</p>
 8 |   <p><a href="http://cyj.me">逸才</a>在 <a href="http://gitref.org">Git Reference</a> 的基础上做了中文翻译。</p>
 9 | </div>
10 | 


--------------------------------------------------------------------------------
/cookbook.html:
--------------------------------------------------------------------------------
 1 | ---
 2 | layout: zh_reference
 3 | ---
 4 | <div class="box">
 5 |   <h2>Git Cookbook</h2>
 6 |   <ul>
 7 |     <li>Revert a file</li>
 8 |     <li>Recover a lost branch</li>
 9 |     <li>Contribute to a project on GitHub</li>
10 |     <li>Undo a merge</li>
11 |   </ul>
12 | </div>
13 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # 在线 Git 命令参考
 2 | 
 3 | 本站为 Git 参考手册。
 4 | 
 5 | 目的是为学习与记忆 Git 使用中最重要、最普遍的命令提供快速翻阅。 
 6 | 这些命令以你可能需要的操作类型划分，并且将提供日常使用中需要的一些常用的命令以及参数。
 7 | 
 8 | 每个章节都有到下一个章节的链接，所以本手册也可以当作一个入门指导。 
 9 | 
10 | 每个页面还有一个深度 Git 文档阅读的链接，比如官方的使用手册页面或者《[Pro Git](http://git-scm.com/book)》书中的相关章节，
11 | 以便于你学习了解更多的 Git 命令。
12 | 
13 | ## 贡献
14 | 
15 | 你可以使用 fork-pull 的方式来参与到手册的撰写或翻译工作中。
16 | 


--------------------------------------------------------------------------------
/css/ie6.css:
--------------------------------------------------------------------------------
 1 | /*
 2 | 	Fluid 960 Grid System - IE6 Fixes
 3 | 	Learn more ~ http://www.designinfluences.com/
 4 | 
 5 | 	Licensed under GPL and MIT.
 6 | */
 7 | 
 8 | /* =Grid >> Global
 9 | --------------------------------------------------------------------------------*/
10 | 
11 | .grid_1,
12 | .grid_2,
13 | .grid_3,
14 | .grid_4,
15 | .grid_5,
16 | .grid_6,
17 | .grid_7,
18 | .grid_8,
19 | .grid_9,
20 | .grid_10,
21 | .grid_11,
22 | .grid_12,
23 | .grid_13,
24 | .grid_14,
25 | .grid_15,
26 | .grid_16
27 | {
28 | 	margin-left: .8%;
29 | 	margin-right: .8%;
30 | }
31 | 
32 | 


--------------------------------------------------------------------------------
/css/ie.css:
--------------------------------------------------------------------------------
 1 | /*
 2 | 	Fluid 960 Grid System - IE Fixes (IE7 and greater)
 3 | 	Learn more ~ http://www.designinfluences.com/
 4 | 
 5 | 	Licensed under GPL and MIT.
 6 | */
 7 | 
 8 | /* =Grid >> Global
 9 | --------------------------------------------------------------------------------*/
10 | 
11 | .grid_1,
12 | .grid_2,
13 | .grid_3,
14 | .grid_4,
15 | .grid_5,
16 | .grid_6,
17 | .grid_7,
18 | .grid_8,
19 | .grid_9,
20 | .grid_10,
21 | .grid_11,
22 | .grid_12,
23 | .grid_13,
24 | .grid_14,
25 | .grid_15,
26 | .grid_16
27 | {
28 | 	margin-left: .92%;
29 | 	margin-right: .92%;
30 | }
31 | 
32 | 


--------------------------------------------------------------------------------
/NOTES:
--------------------------------------------------------------------------------
 1 | Introduction
 2 | (how git is different)
 3 | 
 4 | Getting & Creating Projects 
 5 | * init
 6 | * clone
 7 | 
 8 | Basic Snapshotting
 9 | * add
10 | * status
11 | * diff
12 | * commit
13 | * rm, mv
14 | * reset
15 | 
16 | Branching and Merging Contexts
17 | * branch
18 | * merge
19 | * cherry-pick
20 | * log
21 | 
22 | Sharing and Updating Projects
23 | * fetch, pull
24 | * push
25 | 
26 | Inspection, Comparison and History 
27 | * log
28 | * diff
29 | 
30 | Fixing History
31 | * rebase
32 | * revert
33 | 
34 | 
35 |     <div class="note">
36 |       <h3>My Note</h3>
37 |       this note is pretty cool.
38 |       this note is pretty cool.
39 |     </div>
40 | 


--------------------------------------------------------------------------------
/css/reset.css:
--------------------------------------------------------------------------------
 1 | /* http://meyerweb.com/eric/tools/css/reset/ */
 2 | /* v1.0 | 20080212 */
 3 | 
 4 | html, body, div, span, applet, object, iframe,
 5 | h1, h2, h3, h4, h5, h6, p, blockquote, pre,
 6 | a, abbr, acronym, address, big, cite, code,
 7 | del, dfn, em, font, img, ins, kbd, q, s, samp,
 8 | small, strike, strong, sub, sup, tt, var,
 9 | b, u, i, center,
10 | dl, dt, dd, ol, ul, li,
11 | fieldset, form, label, legend,
12 | table, caption, tbody, tfoot, thead, tr, th, td {
13 | 	margin: 0;
14 | 	padding: 0;
15 | 	border: 0;
16 | 	outline: 0;
17 | 	font-size: 100%;
18 | 	vertical-align: baseline;
19 | 	background: transparent;
20 | }
21 | body {
22 | 	line-height: 1;
23 | }
24 | ol, ul {
25 | 	list-style: none;
26 | }
27 | blockquote, q {
28 | 	quotes: none;
29 | }
30 | blockquote:before, blockquote:after,
31 | q:before, q:after {
32 | 	content: '';
33 | 	content: none;
34 | }
35 | 
36 | /* remember to define focus styles! */
37 | :focus {
38 | 	outline: 0;
39 | }
40 | 
41 | /* remember to highlight inserts somehow! */
42 | ins {
43 | 	text-decoration: none;
44 | }
45 | del {
46 | 	text-decoration: line-through;
47 | }
48 | 
49 | /* tables still need 'cellspacing="0"' in the markup */
50 | table {
51 | 	border-collapse: collapse;
52 | 	border-spacing: 0;
53 | }


--------------------------------------------------------------------------------
/css/text.css:
--------------------------------------------------------------------------------
 1 | /*
 2 | 	960 Grid System ~ Text CSS.
 3 | 	Learn more ~ http://960.gs/
 4 | 
 5 | 	Licensed under GPL and MIT.
 6 | */
 7 | 
 8 | /* =Basic HTML
 9 | --------------------------------------------------------------------------------*/
10 | 
11 | body
12 | {
13 | 	font: 13px/1.5 Helvetica, Arial, 'Liberation Sans', FreeSans, sans-serif;
14 | }
15 | 
16 | a:focus
17 | {
18 | 	outline: 1px dotted invert;
19 | }
20 | 
21 | hr
22 | {
23 | 	border-color: #ccc;
24 | 	border-style: solid;
25 | 	border-width: 1px 0 0;
26 | 	clear: both;
27 | 	height: 0;
28 | }
29 | 
30 | /* =Headings
31 | --------------------------------------------------------------------------------*/
32 | 
33 | h1
34 | {
35 | 	font-size: 25px;
36 | }
37 | 
38 | h2
39 | {
40 | 	font-size: 23px;
41 | }
42 | 
43 | h3
44 | {
45 | 	font-size: 21px;
46 | }
47 | 
48 | h4
49 | {
50 | 	font-size: 19px;
51 | }
52 | 
53 | h5
54 | {
55 | 	font-size: 17px;
56 | }
57 | 
58 | h6
59 | {
60 | 	font-size: 15px;
61 | }
62 | 
63 | /* =Spacing
64 | --------------------------------------------------------------------------------*/
65 | 
66 | ol
67 | {
68 | 	list-style: decimal;
69 | }
70 | 
71 | ul
72 | {
73 | 	list-style: square;
74 | }
75 | 
76 | li
77 | {
78 | 	margin-left: 30px;
79 | }
80 | 
81 | p,
82 | dl,
83 | hr,
84 | h1,
85 | h2,
86 | h3,
87 | h4,
88 | h5,
89 | h6,
90 | ol,
91 | ul,
92 | pre,
93 | table,
94 | address,
95 | fieldset
96 | {
97 | 	margin-bottom: 20px;
98 | }


--------------------------------------------------------------------------------
/index.html:
--------------------------------------------------------------------------------
 1 | ---
 2 | layout: zh_reference
 3 | ---
 4 | <div class="box">
 5 |   <h2>Git 手册简介</h2>
 6 |   <div class="block">
 7 |     <p>
 8 |       本站为 Git 参考手册。目的是为学习与记忆 Git 使用中最重要、最普遍的命令提供快速翻阅。
 9 |       这些命令以你可能需要的操作类型划分，并且将提供日常使用中需要的一些常用的命令以及参数。
10 |     </p>
11 |     <p>
12 |       每个章节都有到下一个章节的链接，所以本手册也可以当作一个入门指导。
13 |       每个页面还有一个深度 Git 文档阅读的链接，比如官方的使用手册页面或者 <a href="http://git-scm.com/book">《Pro Git》</a>
14 |       书中的相关章节，以便于你学习了解更多的 Git 命令。首先，我们要从如何以 Git 的思维方式管理源代码开始。
15 |     </p>
16 |   </div>
17 | </div>
18 | 
19 | <div class="box">
20 |   <h2>如何以 Git 的方式思考</h2>
21 |   <div class="block">
22 |     <p>
23 |       懂得 Git，第一件重要的事情就是要知道它与 Subversion、Perforce 或者任何你用过的版本控制工具都有着很大的差别。
24 |       通常，忘掉你预想的版本控制方式，改以 Git 的方式思考，能够帮助你更好地学习 Git。
25 |     </p>
26 | 
27 |     <p>
28 |       让我们从头开始。假设你正在设计一个新的源代码管理系统。在你使用某个工具之前，是如何完成基本的源码版本控制工作的呢？
29 |       十有八九，你只是在项目到达某些阶段的时候，对项目做一份拷贝。
30 |     </p>
31 | 
32 |     <pre> $ cp -R project project.bak </pre>
33 | 
34 |     <p>
35 |       这样，你就可以在事情变得一团糟的时候很方便的返回到之前的状态，或者通过对比当前的项目与之前的拷贝，看看自己在之后的工作中，都做了哪些修改。
36 |     </p>
37 | 
38 |     <p>
39 |       如果你有点偏执，你可能会经常作上面说的事情，或许还会给项目拷贝加个日期：
40 |     </p>
41 | 
42 |     <pre> $ cp -R project project.2010-06-01.bak </pre>
43 | 
44 |     <p>
45 |       如此，你就有了一堆项目在各个阶段的快照，来作比较、查看。使用这种模式，你还可以有效地与人分享项目变更。
46 |       如果你会在项目到达一定阶段的时候给它打个包，丢到自己的网站上，那其他的开发者们，就能很方便地下载它，做点改动，并给你补丁回馈。
47 |     </p>
48 | 
49 |     <pre>
50 |  $ wget http://example.com/project.2010-06-01.zip
51 |  $ unzip project.2010-06-01.zip
52 |  $ cp -R project.2010-06-01 project-my-copy
53 |  $ cd project-my-copy
54 |  $ (做了某些修改)
55 |  $ diff project-my-copy project.2010-06-01 > change.patch
56 |  $ (通过E-mail发送修改补丁)</pre>
57 | 
58 |     <p>
59 |       以此方式，原先的开发者就能将其他人的改动应用到他的项目中去，其他开发者也能了解你做的变更。其实这便是许多开源项目采用过多年的协作方式。
60 |     </p>
61 | 
62 |     <p>
63 |       这办法其实很好使，所以假设我们现在想要写个工具，让这个办法更快、更简单。
64 |       我们与其实现一个工具以记录每个文件的版本，可能不如去实现个工具以使创建、储存项目的快照更加方便，不用每次都去人肉作整个项目的拷贝。
65 |     </p>
66 | 
67 |     <p>
68 |       这就是 Git 的精要所在。你通过 <code>git commit</code>告诉 Git 你想保存一份项目快照，
69 |       Git 就会为你的项目中的各个文件的当前状态存一份记录。之后，绝大部分的 Git 命令都围绕这些记录展开。
70 |       比如查看它们的区别（diff），提取它们的内容，等等。
71 |     </p>
72 | 
73 |     <center><img src="./images/snapshots.png"/></center>
74 | 
75 |     <p>
76 |       如果你将 Git 看作一个排序、对比以及合并项目更新的工具，那就容易理解状况和正确做事了。
77 |     </p>
78 | 
79 |   </div>
80 | </div>
81 | 
82 | <p><a href="/creating">接下来：获取与创建项目&#187;</a></p>
83 | 


--------------------------------------------------------------------------------
/creating/index.html:
--------------------------------------------------------------------------------
  1 | ---
  2 | layout: zh_reference
  3 | ---
  4 | 
  5 | <div class="box">
  6 |   <h2>获取与创建项目</h2>
  7 |   <div class="block">
  8 |     <p>
  9 |       你得先有一个 Git 仓库，才能用它进行操作。仓库是 Git 存放你要保存的快照的数据的地方。
 10 |     </p>
 11 | 
 12 |     <p>拥有一个 Git 仓库的途径有两种。在已有的目录中，初始化一个新的，其一。
 13 |       比如一个新的项目，或者一个已存在的项目，但该项目尚未有版本控制。如果你想要复制一份别人的项目，
 14 |       或者与别人合作某个项目，也可以从一个公开的 Git 仓库克隆，其二。本章将对两者都做介绍。
 15 |     </p>
 16 |   </div>
 17 | </div>
 18 | 
 19 | <div class="box">
 20 |   <h2>
 21 |     <span class="docs">
 22 |       <a target="new" href="http://git-scm.com/docs/git-init">文档</a> &nbsp;
 23 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Getting-a-Git-Repository#Initializing-a-Repository-in-an-Existing-Directory">书</a>
 24 |     </span>
 25 |     <a name="init">git init</a>
 26 |     <span class="desc">将一个目录初始化为 Git 仓库</span>
 27 |   </h2>
 28 | 
 29 |   <div class="block">
 30 |   <p>在目录中执行 <code>git init</code>，就可以创建一个 Git 仓库了。比如，我们恰好有个目录，里头有些许文件，如下：
 31 |   </p>
 32 | <pre>
 33 | <b>$ cd konichiwa</b>
 34 | <b>$ ls</b>
 35 | README   hello.rb
 36 | </pre>
 37 | 
 38 |     <p>
 39 |       在这个项目里头，我们会用各种编程语言写 "Hello World" 实例。
 40 |       到目前为止，我们只有 Ruby 的，不过，这才刚上路嘛。为了开始用 Git 对这个项目作版本控制，我们执行一下 <code>git init</code>。
 41 |     </p>
 42 | 
 43 | <pre>
 44 | <b>$ git init</b>
 45 | Initialized empty Git repository in /opt/konichiwa/.git/
 46 | # 在 /opt/konichiwa/.git 目录初始化空 Git 仓库完毕。
 47 | </pre>
 48 | 
 49 |     <p>现在你可以看到在你的项目目录中有个 <code>.git</code> 的子目录。
 50 |       这就是你的 Git 仓库了，所有有关你的此项目的快照数据都存放在这里。
 51 |     </p>
 52 | 
 53 | <pre>
 54 | <b>$ ls -a</b>
 55 | .        ..       .git     README   hello.rb
 56 | </pre>
 57 | 
 58 |   <p>恭喜，现在你就有了一个 Git 仓库的架子，可以开始快照你的项目了。
 59 |   </p>
 60 | 
 61 |     <p class="nutshell">
 62 |       <strong>简而言之</strong>，用 <code>git init</code> 来在目录中创建新的 Git 仓库。
 63 |       你可以在任何时候、任何目录中这么做，完全是本地化的。
 64 |     </p>
 65 | 
 66 |   </div>
 67 | </div>
 68 | 
 69 | <div class="box">
 70 |   <h2>
 71 |     <span class="docs">
 72 |       <a target="new" href="http://git-scm.com/docs/git-clone">文档 </a> &nbsp;
 73 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Getting-a-Git-Repository#Cloning-an-Existing-Repository">书</a>
 74 |     </span>
 75 |     <a name="clone">git clone</a>
 76 |     <span class="desc">复制一个 Git 仓库，以上下其手</span>
 77 |   </h2>
 78 |   <div class="block">
 79 |     <p>如果你需要与他人合作一个项目，或者想要复制一个项目，看看代码，你就可以克隆那个项目。
 80 |       执行 <code>git clone [url]</code>，[url] 为你想要复制的项目，就可以了。
 81 |     </p>
 82 | 
 83 | <pre>
 84 | <b>$ git clone git://github.com/schacon/simplegit.git</b>
 85 | Initialized empty Git repository in /private/tmp/simplegit/.git/
 86 | remote: Counting objects: 100, done.
 87 | remote: Compressing objects: 100% (86/86), done.
 88 | remote: Total 100 (delta 35), reused 0 (delta 0)
 89 | Receiving objects: 100% (100/100), 9.51 KiB, done.
 90 | Resolving deltas: 100% (35/35), done.
 91 | <b>$ cd simplegit/</b>
 92 | <b>$ ls</b>
 93 | README   Rakefile <span class="blue">lib</span>
 94 | </pre>
 95 | 
 96 |     <p>上述操作将复制该项目的全部记录，让你本地拥有这些。并且该操作将拷贝该项目的主分支，
 97 |       使你能够查看代码，或编辑、修改。进到该目录中，你会看到 <code>.git</code> 子目录。
 98 |       所有的项目数据都存在那里。
 99 |     </p>
100 | 
101 | <pre>
102 | <b>$ ls -a</b>
103 | .        ..       <span class="blue">.git</span>     README   Rakefile <span class="blue">lib</span>
104 | <b>$ cd .git</b>
105 | <b>$ ls</b>
106 | HEAD        description <span class="blue">info</span>        packed-refs
107 | <span class="blue">branches    hooks       logs        refs</span>
108 | config      index       <span class="blue">objects</span>
109 | </pre>
110 | 
111 |     <p>默认情况下，Git 会按照你提供的 URL 所指示的项目的名称创建你的本地项目目录。
112 |       通常就是该 URL 最后一个 <code>/</code> 之后的任何东西。如果你想要一个不一样的名字，
113 |       你可以在该命令后加上它，就在那个 URL 后面。
114 |     </p>
115 | 
116 |     <p class="nutshell">
117 |     <strong>简而言之</strong>，使用 <code>git clone</code> 拷贝一个 Git 仓库到本地，让自己能够查看该项目，或者进行修改。
118 |     </p>
119 | 
120 |   </div>
121 | </div>
122 | 
123 | <p><a href="/basic">接下来：基本快照 &#187;</a></p>
124 | 


--------------------------------------------------------------------------------
/js/action.js:
--------------------------------------------------------------------------------
  1 | jQuery.githubUser = function(username, callback) {
  2 |   jQuery.getJSON("http://github.com/api/v1/json/" + username + "?callback=?", callback);
  3 | }
  4 | 
  5 | var nicknames = ["Dragon", "Gizzard", "The Enforcer", 
  6 |                  "Mizungu", "The Hammer"]
  7 | var phrases = ["also feels that specialization is for insects",
  8 |                 "my dogs named tater tooooo",
  9 |                 "every movie should have a cast dance scene at the end",
 10 |                 "honey, you're a tool of the masses",
 11 |                 "my life is kinda like the Matrix, really",
 12 |                 "too fat to fit into Japanese pants",
 13 |                 "it's like the finger of God!"]
 14 | function changeBlurb() {
 15 |   var phrase = phrases[Math.floor(Math.random()*phrases.length)]
 16 |   $('#page-heading').text(phrase)
 17 |   t=setTimeout("changeBlurb()",30000);
 18 | }
 19 | 
 20 | function changeNickname() {
 21 |   var nickname = nicknames[Math.floor(Math.random()*nicknames.length)]
 22 |   $('#nickname').text(nickname)
 23 |   t=setTimeout("changeNickname()",30000);
 24 | }
 25 | 
 26 | function showHome() {
 27 |   $('#break').show()
 28 |   $('.non_home_box').hide('scale')
 29 |   $('.home_box').show('scale')
 30 | }
 31 | 
 32 | function showTalks() {
 33 |   $('#break').hide()
 34 |   $('#info_box').show()
 35 |   $("#info_box").load("talks.html", null, function() {
 36 |     window.location.hash = 'talks'
 37 |   });
 38 | }
 39 | 
 40 | function showScribbles() {
 41 |   $('#break').hide()
 42 |   $('#info_box').show()
 43 |   $("#info_box").load("scribbles.html", null, function() {
 44 |     window.location.hash = 'scribbles'
 45 |   });
 46 | }
 47 | 
 48 | function showAbout() {
 49 |   $('#break').hide()
 50 |   $('#info_box').show()
 51 |   $("#info_box").load("about.html", null, function() {
 52 |     window.location.hash = 'about'    
 53 |     $("a#menu_talks").click(function(event){
 54 |       hideAll()
 55 |       showTalks()
 56 |     })
 57 |   });
 58 | }
 59 | 
 60 | function showCode() {
 61 |   $('#break').hide()
 62 |   $('#info_box').show()
 63 |   $("#info_box").load("code.html", null, function() {
 64 |       $.githubUser('schacon', function(data) {
 65 |         $('#github-projects').text('')
 66 |         var repos = data.user.repositories;
 67 |         repos.sort(function(a,b) {
 68 |           return b.watchers - a.watchers;
 69 |         });
 70 | 
 71 |         $(repos).each(function() {
 72 |           if((!this.fork) && (!this.private)) {
 73 |           $('#github-projects').append("\
 74 |     <div class='repo'>\
 75 |       <h3><a href='" + this.url + "'>" + this.name + "</a></h3>\
 76 |       <span class='desc'>"+this.description+"</span>\
 77 |       <span class='watchers'>" + this.watchers + " </span>\
 78 |       <span class='forks'>" + this.forks + "</span>\
 79 |     </div>");
 80 |           }
 81 |         });
 82 |       });
 83 |       window.location.hash = 'code'  
 84 |   });
 85 | }
 86 | 
 87 | function hideAll() {
 88 |   $('.non_home_box').hide()
 89 |   $('.home_box').hide()
 90 | }
 91 | 
 92 | $(document).ready(function(){
 93 |   changeBlurb()
 94 |   changeNickname()
 95 |   if(window.location.hash != "") {
 96 |     page = window.location.hash
 97 |     if(page == '#talks') {
 98 |       hideAll()
 99 |       showTalks()
100 |     }
101 |     if(page == '#code') {
102 |       hideAll()
103 |       showCode()      
104 |     }
105 |     if(page == '#about') {
106 |       hideAll()
107 |       showAbout()      
108 |     }
109 |     if(page == '#scribbles') {
110 |       hideAll()
111 |       showScribbles()      
112 |     }
113 |   }
114 | 
115 |   $("a#menu_home").click(function(event){
116 |     showHome()
117 |   })
118 | 
119 |   $("a#menu_talks").click(function(event){
120 |     hideAll()
121 |     showTalks()
122 |   })
123 | 
124 |   $("a#menu_code").click(function(event){
125 |     hideAll()
126 |     showCode()
127 |   })
128 | 
129 |   $("a#menu_about").click(function(event){
130 |     hideAll()
131 |     showAbout()
132 |   })
133 | 
134 |   $("a#menu_scribbles").click(function(event){
135 |     hideAll()
136 |     showScribbles()
137 |   })
138 | 
139 | })
140 | 


--------------------------------------------------------------------------------
/_layouts/zh_reference.html:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html>
  3 | 	<head>
  4 | 		<meta charset="utf-8" />
  5 | 		<title>Git 参考手册</title>
  6 | 		<link rel="stylesheet" type="text/css" href="/css/reset.css" media="screen" />
  7 | 		<link rel="stylesheet" type="text/css" href="/css/text.css" media="screen" />
  8 | 		<link rel="stylesheet" type="text/css" href="/css/grid.css" media="screen" />
  9 | 		<link rel="stylesheet" type="text/css" href="/css/layout.css" media="screen" />
 10 | 		<link rel="stylesheet" type="text/css" href="/css/nav.css" media="screen" />
 11 | 		<!--[if IE 6]><link rel="stylesheet" type="text/css" href="/css/ie6.css" media="screen" /><![endif]-->
 12 | 		<!--[if IE 7]><link rel="stylesheet" type="text/css" href="/css/ie.css" media="screen" /><![endif]-->
 13 | 		<script type="text/javascript" src="/js/jquery-1.4.1.min.js"></script>
 14 | 		<script type="text/javascript" src="/js/jquery-ui.min.js"></script>
 15 | 		<script type="text/javascript" src="/js/action.js"></script>
 16 | 	</head>
 17 | 	<body>
 18 |     <div class="container_12">
 19 | 
 20 | 			<div class="grid_12">
 21 | 				<span id="branding">Git 参考手册</span>
 22 |       </div>
 23 | 
 24 | 			<div class="grid_12">
 25 | 				<ul id="menu">
 26 | 					<li><a id="menu_home" href="/index.html">参考手册</a></li>
 27 |           <!-- <li><a id="menu_cookbook" href="/cookbook.html">Cookbook</a></li> -->
 28 | 					<li><a id="menu_about" href="/about.html">关于</a></li>
 29 | 					<li>&#167;</li>
 30 | 					<li><a target="_blank" href="https://github.com/justjavac/git-reference">网站源码</a></li>
 31 |         </ul>
 32 |         <br/>
 33 |         &nbsp;
 34 | 			</div>
 35 | 
 36 | 			<div class="grid_2" id="reflist">
 37 |           <div class="block">
 38 |             <h3><a href="/creating">获取与创建项目</a></h3>
 39 |             <ul>
 40 |               <li><a href="/creating/#init">init</a></li>
 41 |               <li><a href="/creating/#clone">clone</a></li>
 42 |             </ul>
 43 | 					</div>
 44 | 
 45 |           <div class="block">
 46 |             <h3><a href="/basic">基本的快照</a></h3>
 47 |             <ul>
 48 |               <li><a href="/basic/#add">add</a></li>
 49 |               <li><a href="/basic/#status">status</a></li>
 50 |               <li><a href="/basic/#diff">diff</a></li>
 51 |               <li><a href="/basic/#commit">commit</a></li>
 52 |               <li><a href="/basic/#reset">reset</a></li>
 53 |               <li><a href="/basic/#rm-mv">rm, mv</a></li>
 54 |             </ul>
 55 |           </div>
 56 | 
 57 |           <div class="block">
 58 |             <h3><a href="/branching">分支与合并</a></h3>
 59 |             <ul>
 60 |               <li><a href="/branching/#branch">branch</a></li>
 61 |               <li><a href="/branching/#branch">checkout</a></li>
 62 |               <li><a href="/branching/#merge">merge</a></li>
 63 |               <li><a href="/branching/#log">log</a></li>
 64 |               <li><a href="/branching/#tag">tag</a></li>
 65 |             </ul>
 66 |           </div>
 67 | 
 68 |           <div class="block">
 69 |             <h3><a href="/remotes">分享与更新项目</a></h3>
 70 |             <ul>
 71 |               <li><a href="/remotes/#fetch">fetch, pull</a></li>
 72 |               <li><a href="/remotes/#push">push</a></li>
 73 |               <li><a href="/remotes/#remote">remote</a></li>
 74 |             </ul>
 75 |           </div>
 76 | 
 77 |           <div class="block">
 78 |             <h3><a href="/inspect">检查与比较</a></h3>
 79 |             <ul>
 80 |               <li><a href="/inspect/#log">log</a></li>
 81 |               <li><a href="/inspect/#diff">diff</a></li>
 82 |             </ul>
 83 |           </div>
 84 | 
 85 |           <!--
 86 |           <div class="block">
 87 |             <h3><a href="/fixing">Fixing and Changing History</a></h3>
 88 |             <ul>
 89 |               <li><a href="/fixing/rebase.html">rebase</a></li>
 90 |               <li><a href="/fixing/revert.html">revert</a></li>
 91 |               <li><a href="/fixing/checkout.html">checkout</a></li>
 92 |               <li><a href="/fixing/reset.html">reset</a></li>
 93 |               <li><a href="/fixing/cherry-pick.html">cherry-pick</a></li>
 94 |             </ul>
 95 |           </div>
 96 |           -->
 97 | 			</div>
 98 | 
 99 |       <div class="grid_10 home_box" id="content_box">
100 |         {{ content }}
101 |       </div>
102 | 
103 | 			<div class="clear"></div>
104 | 		</div>
105 |   </body>
106 | </html>
107 | 


--------------------------------------------------------------------------------
/css/nav.css:
--------------------------------------------------------------------------------
  1 | /*
  2 | -----------------------------------------------
  3 | Navigation
  4 | ----------------------------------------------- */
  5 | 
  6 | /* navigation (horizontal subnavigation)
  7 | ----------------------------------------------- */
  8 | ul.nav,
  9 | ul.nav * { margin:0;padding:0;}
 10 | ul.nav {
 11 |   position:relative;
 12 |   background:#666;
 13 |   max-width:100%;
 14 |   height:2.5em;
 15 |   }
 16 | ul.nav li {
 17 | 	cursor:pointer;
 18 | 	float:left;
 19 | 	text-align:center;
 20 | 	list-style-type:none;
 21 | 	font-weight:normal;
 22 | }
 23 | ul.nav li ul {
 24 | 	cursor:default;
 25 | 	width:100%;
 26 | 	max-width:100%;
 27 | 	position:absolute;
 28 | 	height:auto;
 29 | 	top:2.5em;
 30 | 	background-position:0 0 !important;
 31 | 	left:-9000px;
 32 | }
 33 | ul.nav li ul li {
 34 | 	padding:0;
 35 | 	border:none;
 36 | 	width:auto;
 37 | 	max-width:none;
 38 | }
 39 | ul.nav li a {
 40 | 	color:#fff;
 41 | 	background:#666;
 42 | 	font-weight:bold;
 43 | 	text-decoration:none;
 44 | 	display:block;
 45 | 	float:left;
 46 | 	padding:0 1em;
 47 | 	height:2.4em;
 48 | 	line-height:2.5em;
 49 | }
 50 | ul.nav li ul li a {
 51 | 	position:relative !important; /* ie Mac */
 52 | 	cursor:pointer !important;
 53 | 	white-space:nowrap;
 54 | 	line-height:2em;
 55 | 	height:2em;
 56 | 	font-weight:normal;
 57 | 	color:#666;
 58 | 	background-position:0 50% !important;
 59 | }
 60 | 
 61 | ul.nav li:hover a,
 62 | ul.nav li a:hover,
 63 | ul.nav li a:focus {color:#000; background:#ccc;}
 64 | ul.nav li a:active {color:#666; background:#fff;}
 65 | ul.nav li:hover ul {left:0;z-index:10}
 66 | ul.nav li ul,
 67 | ul.nav li {background:#ccc !important}
 68 | ul.nav li:hover ul li a {color:#444;}
 69 | ul.nav li:hover ul li a:hover {color:#000; background:#fff;}
 70 | ul.nav li:hover ul li a:active {color:#666; background:#fff;}
 71 | 
 72 | ul.nav li.current a {color:#666; background:#fff; cursor:default; font-weight:bold;}
 73 | ul.nav li.current ul {left:0;z-index:5}
 74 | ul.nav li.current ul,
 75 | ul.nav li.current {background:#ccc !important}
 76 | ul.nav li.current ul li a {color:#444; background:#ccc; font-weight:normal;}
 77 | ul.nav li.current ul li a:hover {color:#000; background:#fff;}
 78 | ul.nav li ul li.current a,
 79 | ul.nav li ul li.current a:hover,
 80 | ul.nav li.current:hover ul li a:active {color:#666; background:#fff;}
 81 | 
 82 | 
 83 | /* navigation (vertical subnavigation)
 84 | ----------------------------------------------- */
 85 | ul.nav {
 86 |   background:#666;
 87 | }
 88 | ul.main li {
 89 |   position:relative;
 90 |   top:0;
 91 |   left:0;
 92 | }
 93 | ul.main li ul {
 94 |   border-top:0;
 95 | }
 96 | ul.main li ul li {
 97 |   float:left;
 98 | }
 99 | ul.main li a {
100 | 	height:2.5em;
101 | 	line-height:2.5em;
102 | 	border:0;
103 | 	color:#fff;
104 | 	background:#666;
105 | }
106 | ul.main li ul li a {
107 |   width:12em;
108 |   line-height:2em;
109 |   height:2em;
110 |   text-align:left;
111 |   color:#fff;
112 |   border-top:1px solid #444;
113 |   background:#444;
114 | }
115 | ul.main li a:focus {color:#fff; background:#666;}
116 | ul.main li ul li a:hover {
117 |   color:#fff;
118 |   background:#555;
119 | }
120 | ul.main li:hover a {
121 |   color:#fff;
122 |   background:#555;
123 | }
124 | ul.main li:hover ul li a {color:#fff;}
125 | ul.main li:hover ul li a:hover {color:#fff; background:#444;}
126 | ul.main li:hover a:active {background:#444;}
127 | ul.main li:hover ul li a:active {color:#fff; background:#222;}
128 | 
129 | 
130 | /* secondary list
131 | ----------------------------------------------- */
132 | ul.nav li.secondary {
133 | 	float:right;
134 | 	color:#cde;
135 | 	background:transparent !important;
136 | }
137 | ul.nav li.secondary span.status {
138 | 	float:left;
139 | 	padding:0 1em;
140 | 	line-height:2.77em;
141 | 	height:2.77em;
142 |   font-size:0.9em;
143 | }
144 | ul.nav li.secondary span.status a {
145 | 	float:none;
146 | 	display:inline;
147 | 	padding:0;
148 | 	height:auto;
149 | 	line-height:auto;
150 | 	color:#cde;
151 | 	background:transparent;
152 | }
153 | ul.nav li.secondary span.status a:hover {
154 | 	color:#fff;
155 | 	background:transparent;
156 | }
157 | ul.nav li.secondary span.status span {
158 | 	text-transform:capitalize;
159 | }
160 | ul.nav li.secondary:hover a {
161 | 	color:#fff;
162 | 	background:#666;
163 | }
164 | ul.nav li.secondary:hover a:hover {
165 | 	background:#555;
166 | }
167 | ul.nav li.secondary:hover a:active {background:#444;}
168 | 


--------------------------------------------------------------------------------
/css/960.css:
--------------------------------------------------------------------------------
  1 | /*
  2 | 	960 Grid System ~ Core CSS.
  3 | 	Learn more ~ http://960.gs/
  4 | 
  5 | 	Licensed under GPL and MIT.
  6 | */
  7 | 
  8 | /* =Containers
  9 | --------------------------------------------------------------------------------*/
 10 | 
 11 | .container_12,
 12 | .container_16
 13 | {
 14 | 	margin-left: auto;
 15 | 	margin-right: auto;
 16 | 	width: 960px;
 17 | }
 18 | 
 19 | /* =Grid >> Global
 20 | --------------------------------------------------------------------------------*/
 21 | 
 22 | .grid_1,
 23 | .grid_2,
 24 | .grid_3,
 25 | .grid_4,
 26 | .grid_5,
 27 | .grid_6,
 28 | .grid_7,
 29 | .grid_8,
 30 | .grid_9,
 31 | .grid_10,
 32 | .grid_11,
 33 | .grid_12,
 34 | .grid_13,
 35 | .grid_14,
 36 | .grid_15,
 37 | .grid_16
 38 | {
 39 | 	display: inline;
 40 | 	float: left;
 41 | 	margin-left: 10px;
 42 | 	margin-right: 10px;
 43 | }
 44 | 
 45 | .container_12 .grid_3,
 46 | .container_16 .grid_4
 47 | {
 48 | 	width: 220px;
 49 | }
 50 | 
 51 | .container_12 .grid_6,
 52 | .container_16 .grid_8
 53 | {
 54 | 	width: 460px;
 55 | }
 56 | 
 57 | .container_12 .grid_9,
 58 | .container_16 .grid_12
 59 | {
 60 | 	width: 700px;
 61 | }
 62 | 
 63 | .container_12 .grid_12,
 64 | .container_16 .grid_16
 65 | {
 66 | 	width: 940px;
 67 | }
 68 | 
 69 | /* =Grid >> Children (Alpha ~ First, Omega ~ Last)
 70 | --------------------------------------------------------------------------------*/
 71 | 
 72 | .alpha
 73 | {
 74 | 	margin-left: 0;
 75 | }
 76 | 
 77 | .omega
 78 | {
 79 | 	margin-right: 0;
 80 | }
 81 | 
 82 | /* =Grid >> 12 Columns
 83 | --------------------------------------------------------------------------------*/
 84 | 
 85 | .container_12 .grid_1
 86 | {
 87 | 	width: 60px;
 88 | }
 89 | 
 90 | .container_12 .grid_2
 91 | {
 92 | 	width: 140px;
 93 | }
 94 | 
 95 | .container_12 .grid_4
 96 | {
 97 | 	width: 300px;
 98 | }
 99 | 
100 | .container_12 .grid_5
101 | {
102 | 	width: 380px;
103 | }
104 | 
105 | .container_12 .grid_7
106 | {
107 | 	width: 540px;
108 | }
109 | 
110 | .container_12 .grid_8
111 | {
112 | 	width: 620px;
113 | }
114 | 
115 | .container_12 .grid_10
116 | {
117 | 	width: 780px;
118 | }
119 | 
120 | .container_12 .grid_11
121 | {
122 | 	width: 860px;
123 | }
124 | 
125 | /* =Grid >> 16 Columns
126 | --------------------------------------------------------------------------------*/
127 | 
128 | .container_16 .grid_1
129 | {
130 | 	width: 40px;
131 | }
132 | 
133 | .container_16 .grid_2
134 | {
135 | 	width: 100px;
136 | }
137 | 
138 | .container_16 .grid_3
139 | {
140 | 	width: 160px;
141 | }
142 | 
143 | .container_16 .grid_5
144 | {
145 | 	width: 280px;
146 | }
147 | 
148 | .container_16 .grid_6
149 | {
150 | 	width: 340px;
151 | }
152 | 
153 | .container_16 .grid_7
154 | {
155 | 	width: 400px;
156 | }
157 | 
158 | .container_16 .grid_9
159 | {
160 | 	width: 520px;
161 | }
162 | 
163 | .container_16 .grid_10
164 | {
165 | 	width: 580px;
166 | }
167 | 
168 | .container_16 .grid_11
169 | {
170 | 	width: 640px;
171 | }
172 | 
173 | .container_16 .grid_13
174 | {
175 | 	width: 760px;
176 | }
177 | 
178 | .container_16 .grid_14
179 | {
180 | 	width: 820px;
181 | }
182 | 
183 | .container_16 .grid_15
184 | {
185 | 	width: 880px;
186 | }
187 | 
188 | /* =Prefix Extra Space >> Global
189 | --------------------------------------------------------------------------------*/
190 | 
191 | .container_12 .prefix_3,
192 | .container_16 .prefix_4
193 | {
194 | 	padding-left: 240px;
195 | }
196 | 
197 | .container_12 .prefix_6,
198 | .container_16 .prefix_8
199 | {
200 | 	padding-left: 480px;
201 | }
202 | 
203 | .container_12 .prefix_9,
204 | .container_16 .prefix_12
205 | {
206 | 	padding-left: 720px;
207 | }
208 | 
209 | /* =Prefix Extra Space >> 12 Columns
210 | --------------------------------------------------------------------------------*/
211 | 
212 | .container_12 .prefix_1
213 | {
214 | 	padding-left: 80px;
215 | }
216 | 
217 | .container_12 .prefix_2
218 | {
219 | 	padding-left: 160px;
220 | }
221 | 
222 | .container_12 .prefix_4
223 | {
224 | 	padding-left: 320px;
225 | }
226 | 
227 | .container_12 .prefix_5
228 | {
229 | 	padding-left: 400px;
230 | }
231 | 
232 | .container_12 .prefix_7
233 | {
234 | 	padding-left: 560px;
235 | }
236 | 
237 | .container_12 .prefix_8
238 | {
239 | 	padding-left: 640px;
240 | }
241 | 
242 | .container_12 .prefix_10
243 | {
244 | 	padding-left: 800px;
245 | }
246 | 
247 | .container_12 .prefix_11
248 | {
249 | 	padding-left: 880px;
250 | }
251 | 
252 | /* =Prefix Extra Space >> 16 Columns
253 | --------------------------------------------------------------------------------*/
254 | 
255 | .container_16 .prefix_1
256 | {
257 | 	padding-left: 60px;
258 | }
259 | 
260 | .container_16 .prefix_2
261 | {
262 | 	padding-left: 120px;
263 | }
264 | 
265 | .container_16 .prefix_3
266 | {
267 | 	padding-left: 180px;
268 | }
269 | 
270 | .container_16 .prefix_5
271 | {
272 | 	padding-left: 300px;
273 | }
274 | 
275 | .container_16 .prefix_6
276 | {
277 | 	padding-left: 360px;
278 | }
279 | 
280 | .container_16 .prefix_7
281 | {
282 | 	padding-left: 420px;
283 | }
284 | 
285 | .container_16 .prefix_9
286 | {
287 | 	padding-left: 540px;
288 | }
289 | 
290 | .container_16 .prefix_10
291 | {
292 | 	padding-left: 600px;
293 | }
294 | 
295 | .container_16 .prefix_11
296 | {
297 | 	padding-left: 660px;
298 | }
299 | 
300 | .container_16 .prefix_13
301 | {
302 | 	padding-left: 780px;
303 | }
304 | 
305 | .container_16 .prefix_14
306 | {
307 | 	padding-left: 840px;
308 | }
309 | 
310 | .container_16 .prefix_15
311 | {
312 | 	padding-left: 900px;
313 | }
314 | 
315 | /* =Suffix Extra Space >> Global
316 | --------------------------------------------------------------------------------*/
317 | 
318 | .container_12 .suffix_3,
319 | .container_16 .suffix_4
320 | {
321 | 	padding-right: 240px;
322 | }
323 | 
324 | .container_12 .suffix_6,
325 | .container_16 .suffix_8
326 | {
327 | 	padding-right: 480px;
328 | }
329 | 
330 | .container_12 .suffix_9,
331 | .container_16 .suffix_12
332 | {
333 | 	padding-right: 720px;
334 | }
335 | 
336 | /* =Suffix Extra Space >> 12 Columns
337 | --------------------------------------------------------------------------------*/
338 | 
339 | .container_12 .suffix_1
340 | {
341 | 	padding-right: 80px;
342 | }
343 | 
344 | .container_12 .suffix_2
345 | {
346 | 	padding-right: 160px;
347 | }
348 | 
349 | .container_12 .suffix_4
350 | {
351 | 	padding-right: 320px;
352 | }
353 | 
354 | .container_12 .suffix_5
355 | {
356 | 	padding-right: 400px;
357 | }
358 | 
359 | .container_12 .suffix_7
360 | {
361 | 	padding-right: 560px;
362 | }
363 | 
364 | .container_12 .suffix_8
365 | {
366 | 	padding-right: 640px;
367 | }
368 | 
369 | .container_12 .suffix_10
370 | {
371 | 	padding-right: 800px;
372 | }
373 | 
374 | .container_12 .suffix_11
375 | {
376 | 	padding-right: 880px;
377 | }
378 | 
379 | /* =Suffix Extra Space >> 16 Columns
380 | --------------------------------------------------------------------------------*/
381 | 
382 | .container_16 .suffix_1
383 | {
384 | 	padding-right: 60px;
385 | }
386 | 
387 | .container_16 .suffix_2
388 | {
389 | 	padding-right: 120px;
390 | }
391 | 
392 | .container_16 .suffix_3
393 | {
394 | 	padding-right: 180px;
395 | }
396 | 
397 | .container_16 .suffix_5
398 | {
399 | 	padding-right: 300px;
400 | }
401 | 
402 | .container_16 .suffix_6
403 | {
404 | 	padding-right: 360px;
405 | }
406 | 
407 | .container_16 .suffix_7
408 | {
409 | 	padding-right: 420px;
410 | }
411 | 
412 | .container_16 .suffix_9
413 | {
414 | 	padding-right: 540px;
415 | }
416 | 
417 | .container_16 .suffix_10
418 | {
419 | 	padding-right: 600px;
420 | }
421 | 
422 | .container_16 .suffix_11
423 | {
424 | 	padding-right: 660px;
425 | }
426 | 
427 | .container_16 .suffix_13
428 | {
429 | 	padding-right: 780px;
430 | }
431 | 
432 | .container_16 .suffix_14
433 | {
434 | 	padding-right: 840px;
435 | }
436 | 
437 | .container_16 .suffix_15
438 | {
439 | 	padding-right: 900px;
440 | }
441 | 
442 | /* =Clear Floated Elements
443 | --------------------------------------------------------------------------------*/
444 | 
445 | /* http://sonspring.com/journal/clearing-floats */
446 | 
447 | html body * span.clear,
448 | html body * div.clear,
449 | html body * li.clear,
450 | html body * dd.clear
451 | {
452 | 	background: none;
453 | 	border: 0;
454 | 	clear: both;
455 | 	display: block;
456 | 	float: none;
457 | 	font-size: 0;
458 | 	list-style: none;
459 | 	margin: 0;
460 | 	padding: 0;
461 | 	overflow: hidden;
462 | 	visibility: hidden;
463 | 	width: 0;
464 | 	height: 0;
465 | }
466 | 
467 | /* http://www.positioniseverything.net/easyclearing.html */
468 | 
469 | .clearfix:after
470 | {
471 | 	clear: both;
472 | 	content: '.';
473 | 	display: block;
474 | 	visibility: hidden;
475 | 	height: 0;
476 | }
477 | 
478 | .clearfix
479 | {
480 | 	display: inline-block;
481 | }
482 | 
483 | * html .clearfix
484 | {
485 | 	height: 1%;
486 | }
487 | 
488 | .clearfix
489 | {
490 | 	display: block;
491 | }


--------------------------------------------------------------------------------
/css/grid.css:
--------------------------------------------------------------------------------
  1 | /*
  2 | 	960 Grid System ~ Core CSS.
  3 | 	Learn more ~ http://960.gs/
  4 | 
  5 | 	Licensed under GPL and MIT.
  6 | */
  7 | 
  8 | /* =Containers
  9 | --------------------------------------------------------------------------------*/
 10 | 
 11 | .container_12,
 12 | .container_16
 13 | {
 14 | 	width: 92%;
 15 | 	margin-left: 4%;
 16 | 	margin-right: 4%;
 17 | }
 18 | 
 19 | /* =Grid >> Global
 20 | --------------------------------------------------------------------------------*/
 21 | 
 22 | .grid_1,
 23 | .grid_2,
 24 | .grid_3,
 25 | .grid_4,
 26 | .grid_5,
 27 | .grid_6,
 28 | .grid_7,
 29 | .grid_8,
 30 | .grid_9,
 31 | .grid_10,
 32 | .grid_11,
 33 | .grid_12,
 34 | .grid_13,
 35 | .grid_14,
 36 | .grid_15,
 37 | .grid_16
 38 | {
 39 | 	display: inline;
 40 | 	float: left;
 41 | 	margin-left: 1%;
 42 | 	margin-right: 1%;
 43 | }
 44 | 
 45 | .container_12 .grid_3,
 46 | .container_16 .grid_4
 47 | {
 48 | 	width: 23%;
 49 | }
 50 | 
 51 | .container_12 .grid_6,
 52 | .container_16 .grid_8
 53 | {
 54 | 	width: 48%;
 55 | }
 56 | 
 57 | .container_12 .grid_9,
 58 | .container_16 .grid_12
 59 | {
 60 | 	width: 73%;
 61 | }
 62 | 
 63 | .container_12 .grid_12,
 64 | .container_16 .grid_16
 65 | {
 66 | 	width: 98%;
 67 | }
 68 | 
 69 | /* =Grid >> Children (Alpha ~ First, Omega ~ Last)
 70 | --------------------------------------------------------------------------------*/
 71 | 
 72 | .alpha
 73 | {
 74 | 	margin-left: 0;
 75 | }
 76 | 
 77 | .omega
 78 | {
 79 | 	margin-right: 0;
 80 | }
 81 | 
 82 | /* =Grid >> 12 Columns
 83 | --------------------------------------------------------------------------------*/
 84 | 
 85 | .container_12 .grid_1
 86 | {
 87 | 	width: 6.333%;
 88 | }
 89 | 
 90 | .container_12 .grid_2
 91 | {
 92 | 	width: 14.666%;
 93 | }
 94 | 
 95 | .container_12 .grid_4
 96 | {
 97 | 	width: 31.333%;
 98 | }
 99 | 
100 | .container_12 .grid_5
101 | {
102 | 	width: 39.666%;
103 | }
104 | 
105 | .container_12 .grid_7
106 | {
107 | 	width: 56.333%;
108 | }
109 | 
110 | .container_12 .grid_8
111 | {
112 | 	width: 64.666%;
113 | }
114 | 
115 | .container_12 .grid_10
116 | {
117 | 	width: 81.333%;
118 | }
119 | 
120 | .container_12 .grid_11
121 | {
122 | 	width: 89.666%;
123 | }
124 | 
125 | /* =Grid >> 16 Columns
126 | --------------------------------------------------------------------------------*/
127 | 
128 | .container_16 .grid_1
129 | {
130 | 	width: 4.25%;
131 | }
132 | 
133 | .container_16 .grid_2
134 | {
135 | 	width: 10.5%;
136 | }
137 | 
138 | .container_16 .grid_3
139 | {
140 | 	width: 16.75%;
141 | }
142 | 
143 | .container_16 .grid_5
144 | {
145 | 	width: 29.25%;
146 | }
147 | 
148 | .container_16 .grid_6
149 | {
150 | 	width: 35.5%;
151 | }
152 | 
153 | .container_16 .grid_7
154 | {
155 | 	width: 41.75%;
156 | }
157 | 
158 | .container_16 .grid_9
159 | {
160 | 	width: 54.25%;
161 | }
162 | 
163 | .container_16 .grid_10
164 | {
165 | 	width: 60.5%;
166 | }
167 | 
168 | .container_16 .grid_11
169 | {
170 | 	width: 66.75%;
171 | }
172 | 
173 | .container_16 .grid_13
174 | {
175 | 	width: 79.25%;
176 | }
177 | 
178 | .container_16 .grid_14
179 | {
180 | 	width: 85.5%;
181 | }
182 | 
183 | .container_16 .grid_15
184 | {
185 | 	width: 91.75%;
186 | }
187 | 
188 | /* =Prefix Extra Space >> Global
189 | --------------------------------------------------------------------------------*/
190 | 
191 | .container_12 .prefix_3,
192 | .container_16 .prefix_4
193 | {
194 | 	padding-left: 25%;
195 | }
196 | 
197 | .container_12 .prefix_6,
198 | .container_16 .prefix_8
199 | {
200 | 	padding-left: 50%;
201 | }
202 | 
203 | .container_12 .prefix_9,
204 | .container_16 .prefix_12
205 | {
206 | 	padding-left: 75%;
207 | }
208 | 
209 | /* =Prefix Extra Space >> 12 Columns
210 | --------------------------------------------------------------------------------*/
211 | 
212 | .container_12 .prefix_1
213 | {
214 | 	padding-left: 8.333%;
215 | }
216 | 
217 | .container_12 .prefix_2
218 | {
219 | 	padding-left: 16.666%;
220 | }
221 | 
222 | .container_12 .prefix_4
223 | {
224 | 	padding-left: 33.333%;
225 | }
226 | 
227 | .container_12 .prefix_5
228 | {
229 | 	padding-left: 41.666%;
230 | }
231 | 
232 | .container_12 .prefix_7
233 | {
234 | 	padding-left: 58.333%;
235 | }
236 | 
237 | .container_12 .prefix_8
238 | {
239 | 	padding-left: 66.666%;
240 | }
241 | 
242 | .container_12 .prefix_10
243 | {
244 | 	padding-left: 83.333%;
245 | }
246 | 
247 | .container_12 .prefix_11
248 | {
249 | 	padding-left: 91.666%;
250 | }
251 | 
252 | /* =Prefix Extra Space >> 16 Columns
253 | --------------------------------------------------------------------------------*/
254 | 
255 | .container_16 .prefix_1
256 | {
257 | 	padding-left: 6.25%;
258 | }
259 | 
260 | .container_16 .prefix_2
261 | {
262 | 	padding-left: 12.5%;
263 | }
264 | 
265 | .container_16 .prefix_3
266 | {
267 | 	padding-left: 18.75%;
268 | }
269 | 
270 | .container_16 .prefix_5
271 | {
272 | 	padding-left: 31.25%;
273 | }
274 | 
275 | .container_16 .prefix_6
276 | {
277 | 	padding-left: 37.5%;
278 | }
279 | 
280 | .container_16 .prefix_7
281 | {
282 | 	padding-left: 43.75%;
283 | }
284 | 
285 | .container_16 .prefix_9
286 | {
287 | 	padding-left: 56.25%;
288 | }
289 | 
290 | .container_16 .prefix_10
291 | {
292 | 	padding-left: 62.5%;
293 | }
294 | 
295 | .container_16 .prefix_11
296 | {
297 | 	padding-left: 68.75%;
298 | }
299 | 
300 | .container_16 .prefix_13
301 | {
302 | 	padding-left: 81.25%;
303 | }
304 | 
305 | .container_16 .prefix_14
306 | {
307 | 	padding-left: 87.5%;
308 | }
309 | 
310 | .container_16 .prefix_15
311 | {
312 | 	padding-left: 93.75%;
313 | }
314 | 
315 | /* =Suffix Extra Space >> Global
316 | --------------------------------------------------------------------------------*/
317 | 
318 | .container_12 .suffix_3,
319 | .container_16 .suffix_4
320 | {
321 | 	padding-right: 25%;
322 | }
323 | 
324 | .container_12 .suffix_6,
325 | .container_16 .suffix_8
326 | {
327 | 	padding-right: 50%;
328 | }
329 | 
330 | .container_12 .suffix_9,
331 | .container_16 .suffix_12
332 | {
333 | 	padding-right: 75%;
334 | }
335 | 
336 | /* =Suffix Extra Space >> 12 Columns
337 | --------------------------------------------------------------------------------*/
338 | 
339 | .container_12 .suffix_1
340 | {
341 | 	padding-right: 8.333%;
342 | }
343 | 
344 | .container_12 .suffix_2
345 | {
346 | 	padding-right: 16.666%;
347 | }
348 | 
349 | .container_12 .suffix_4
350 | {
351 | 	padding-right: 33.333%;
352 | }
353 | 
354 | .container_12 .suffix_5
355 | {
356 | 	padding-right: 41.666%;
357 | }
358 | 
359 | .container_12 .suffix_7
360 | {
361 | 	padding-right: 58.333%;
362 | }
363 | 
364 | .container_12 .suffix_8
365 | {
366 | 	padding-right: 66.666%;
367 | }
368 | 
369 | .container_12 .suffix_10
370 | {
371 | 	padding-right: 83.333%;
372 | }
373 | 
374 | .container_12 .suffix_11
375 | {
376 | 	padding-right: 91.666%;
377 | }
378 | 
379 | /* =Suffix Extra Space >> 16 Columns
380 | --------------------------------------------------------------------------------*/
381 | 
382 | .container_16 .suffix_1
383 | {
384 | 	padding-right: 6.25%;
385 | }
386 | 
387 | .container_16 .suffix_2
388 | {
389 | 	padding-right: 16.5%;
390 | }
391 | 
392 | .container_16 .suffix_3
393 | {
394 | 	padding-right: 18.75%;
395 | }
396 | 
397 | .container_16 .suffix_5
398 | {
399 | 	padding-right: 31.25%;
400 | }
401 | 
402 | .container_16 .suffix_6
403 | {
404 | 	padding-right: 37.5%;
405 | }
406 | 
407 | .container_16 .suffix_7
408 | {
409 | 	padding-right: 43.75%;
410 | }
411 | 
412 | .container_16 .suffix_9
413 | {
414 | 	padding-right: 56.25%;
415 | }
416 | 
417 | .container_16 .suffix_10
418 | {
419 | 	padding-right: 62.5%;
420 | }
421 | 
422 | .container_16 .suffix_11
423 | {
424 | 	padding-right: 68.75%;
425 | }
426 | 
427 | .container_16 .suffix_13
428 | {
429 | 	padding-right: 81.25%;
430 | }
431 | 
432 | .container_16 .suffix_14
433 | {
434 | 	padding-right: 87.5%;
435 | }
436 | 
437 | .container_16 .suffix_15
438 | {
439 | 	padding-right: 93.75%;
440 | }
441 | 
442 | /* =Clear Floated Elements
443 | --------------------------------------------------------------------------------*/
444 | 
445 | /* http://sonspring.com/journal/clearing-floats */
446 | 
447 | html body * span.clear,
448 | html body * div.clear,
449 | html body * li.clear,
450 | html body * dd.clear
451 | {
452 | 	background: none;
453 | 	border: 0;
454 | 	clear: both;
455 | 	display: block;
456 | 	float: none;
457 | 	font-size: 0;
458 | 	list-style: none;
459 | 	margin: 0;
460 | 	padding: 0;
461 | 	overflow: hidden;
462 | 	visibility: hidden;
463 | 	width: 0;
464 | 	height: 0;
465 | }
466 | 
467 | /* http://www.positioniseverything.net/easyclearing.html */
468 | 
469 | .clearfix:after
470 | {
471 | 	clear: both;
472 | 	content: '.';
473 | 	display: block;
474 | 	visibility: hidden;
475 | 	height: 0;
476 | }
477 | 
478 | .clearfix
479 | {
480 | 	display: inline-block;
481 | }
482 | 
483 | * html .clearfix
484 | {
485 | 	height: 1%;
486 | }
487 | 
488 | .clearfix
489 | {
490 | 	display: block;
491 | }


--------------------------------------------------------------------------------
/remotes/index.html:
--------------------------------------------------------------------------------
  1 | ---
  2 | layout: zh_reference
  3 | ---
  4 | 
  5 | <div class="box">
  6 |   <h2>
  7 |     <span class="docs">
  8 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Working-with-Remotes">书</a>
  9 |     </span>
 10 |     分享与更新项目
 11 |   </h2>
 12 |   <div class="block">
 13 |     <p>
 14 |       Git 并不像 Subversion 那样有个中心服务器。
 15 |       目前为止所有的命令都是本地执行的，更新的知识本地的数据库。
 16 |       要通过 Git 与其他开发者合作，你需要将数据放到一台其他开发者能够连接的服务器上。
 17 |       Git 实现此流程的方式是将你的数据与另一个仓库同步。在服务器与客户端之间并没有实质的区别 ——
 18 |       Git 仓库就是 Git 仓库，你可以很容易地在两者之间同步。
 19 |     </p>
 20 | 
 21 |     <p>
 22 |       一旦你有了个 Git 仓库，不管它是在你自己的服务器上，或者是由 GitHub 之类的地方提供，
 23 |       你都可以告诉 Git 推送你拥有的远端仓库还没有的数据，或者叫 Git 从别的仓库把差别取过来。
 24 |     </p>
 25 | 
 26 |     <p>
 27 |       联网的时候你可以随时做这个，它并不需要对应一个 <code>commit</code> 或者别的什么。
 28 |       一般你会本地提交几次，然后从你的项目克隆自的线上的共享仓库提取数据以保持最新，将新完成的合并到你完成的工作中去，然后推送你的改动会服务器。
 29 |     </p>
 30 | 
 31 |     <p class="nutshell">
 32 |       <b>简而言之</b> 使用 <code>git fetch</code> 更新你的项目，使用 <code>git push</code> 分享你的改动。
 33 |       你可以用 <code>git remote</code> 管理你的远程仓库。
 34 |     </p>
 35 |   </div>
 36 | </div>
 37 | 
 38 | <div class="box">
 39 |   <h2>
 40 |     <span class="docs">
 41 |       <a target="new" href="http://git-scm.com/docs/git-remote">文档</a> &nbsp;
 42 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Working-with-Remotes#Showing-Your-Remotes">书</a>
 43 |     </span>
 44 |     <a name="remote">git remote</a>
 45 |     <span class="desc">罗列、添加和删除远端仓库别名</span>
 46 |   </h2>
 47 | 
 48 |   <div class="block">
 49 | 
 50 |     <p>不像中心化的版本控制系统（客户端与服务端很不一样），Git 仓库基本上都是一致的，并且并可以同步他们。
 51 |       这使得拥有多个远端仓库变得容易 —— 你可以拥有一些只读的仓库，另外的一些也可写的仓库。
 52 |     </p>
 53 | 
 54 |     <p>
 55 |       当你需要与远端仓库同步的时候，不需要使用它详细的链接。Git 储存了你感兴趣的远端仓库的链接的别名或者昵称。
 56 |       你可以使用 <code>git remote</code> 命令管理这个远端仓库列表。
 57 |     </p>
 58 | 
 59 |     <h4>
 60 |       git remote
 61 |       <small>列出远端别名</small>
 62 |     </h4>
 63 | 
 64 |     <p>
 65 |       如果没有任何参数，Git 会列出它存储的远端仓库别名了事。默认情况下，如果你的项目是克隆的（与本地创建一个新的相反），
 66 |       Git 会自动将你的项目克隆自的仓库添加到列表中，并取名“origin”。
 67 |       如果你执行时加上 <code>-v</code> 参数，你还可以看到每个别名的实际链接地址。
 68 |     </p>
 69 | 
 70 | <pre>
 71 | <b>$ git remote</b>
 72 | origin
 73 | <b>$ git remote -v</b>
 74 | origin	git@github.com:github/git-reference.git (fetch)
 75 | origin	git@github.com:github/git-reference.git (push)
 76 | </pre>
 77 | 
 78 |     <p>在此你看到了该链接两次，是因为 Git 允许你为每个远端仓库添加不同的推送与获取的链接，以备你读写时希望使用不同的协议。
 79 |     </p>
 80 | 
 81 |     <h4>
 82 |       git remote add
 83 |       <small>为你的项目添加一个新的远端仓库</small>
 84 |     </h4>
 85 | 
 86 |     <p>
 87 |       如果你希望分享一个本地创建的仓库，或者你想要获取别人的仓库中的贡献 ——
 88 |       如果你想要以任何方式与一个新仓库沟通，最简单的方式通常就是把它添加为一个远端仓库。
 89 |       执行 <code>git remote add [alias] [url]</code> 就可以。
 90 |       此命令将 <code>[url]</code> 以 <code>[alias]</code> 的别名添加为本地的远端仓库。
 91 |     </p>
 92 | 
 93 |     <p>
 94 |       例如，假设我们想要与整个世界分享我们的 Hello World 程序。
 95 |       我们可以在一台服务器上创建一个新仓库（我以 GitHub 为例子）。
 96 |       它应该会给你一个链接，在这里就是“git@github.com:schacon/hw.git”。
 97 |       要把它添加到我们的项目以便我们推送以及获取更新，我们可以这样：
 98 |     </p>
 99 | 
100 | <pre>
101 | <b>$ git remote</b>
102 | <b>$ git remote add github git@github.com:schacon/hw.git</b>
103 | <b>$ git remote -v</b>
104 | github	git@github.com:schacon/hw.git (fetch)
105 | github	git@github.com:schacon/hw.git (push)
106 | </pre>
107 | 
108 |     <p>
109 |       像分支的命名一样，远端仓库的别名是强制的 —— 就像“master”，没有特别意义，但它广为使用，
110 |       因为 <code>git init</code> 默认用它；“origin”经常被用作远端仓库别名，就因为 <code>git clone</code>
111 |       默认用它作为克隆自的链接的别名。此例中，我决定给我的远端仓库取名“github”，但我叫它随便什么都可以。
112 |     </p>
113 | 
114 |     <h4>
115 |       git remote rm
116 |       <small>删除现存的某个别名</small>
117 |     </h4>
118 | 
119 |     <p>
120 |       Git addeth and Git taketh away. 如果你需要删除一个远端 —— 不再需要它了、项目已经没了，等等 —— 你可以使用 <code>git remote rm [alias]</code> 把它删掉。
121 |     </p>
122 | 
123 | <pre>
124 | <b>$ git remote -v</b>
125 | github	git@github.com:schacon/hw.git (fetch)
126 | github	git@github.com:schacon/hw.git (push)
127 | <b>$ git remote add origin git://github.com/pjhyett/hw.git</b>
128 | <b>$ git remote -v</b>
129 | github	git@github.com:schacon/hw.git (fetch)
130 | github	git@github.com:schacon/hw.git (push)
131 | origin	git://github.com/pjhyett/hw.git (fetch)
132 | origin	git://github.com/pjhyett/hw.git (push)
133 | <b>$ git remote rm origin</b>
134 | <b>$ git remote -v</b>
135 | github	git@github.com:schacon/hw.git (fetch)
136 | github	git@github.com:schacon/hw.git (push)
137 | </pre>
138 | 
139 |     <p class="nutshell">
140 |       <b>简而言之</b> 你可以用 <code>git remote</code> 列出你的远端仓库和那些仓库的链接。
141 |       你可以使用 <code>git remote add</code> 添加新的远端仓库，用 <code>git remote rm</code> 删掉已存在的那些。
142 |     </p>
143 | 
144 |   </div>
145 | </div>
146 | 
147 | <div class="box">
148 |   <h2>
149 |     <span class="docs">
150 |       <a target="new" href="http://git-scm.com/docs/git-fetch">文档</a> &nbsp;
151 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Working-with-Remotes#Fetching-and-Pulling-from-Your-Remotes">书</a>
152 |     </span>
153 |     <a name="fetch">git fetch</a>
154 |     <span class="desc">从远端仓库下载新分支与数据</span>
155 |   </h2>
156 | 
157 |   <br/>
158 | 
159 |   <h2>
160 |     <span class="docs">
161 |       <a target="new" href="http://git-scm.com/docs/git-pull">文档</a> &nbsp;
162 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Working-with-Remotes#Fetching-and-Pulling-from-Your-Remotes">书</a>
163 |     </span>
164 |     <a name="pull">git pull</a>
165 |     <span class="desc">从远端仓库提取数据并尝试合并到当前分支</span>
166 |   </h2>
167 | 
168 |   <div class="block">
169 | 
170 |     <p>
171 |       Git 有两个命令用来从某一远端仓库更新。
172 |       <code>git fetch</code> 会使你与另一仓库同步，提取你本地所没有的数据，为你在同步时的该远端的每一分支提供书签。
173 |       这些分支被叫做“远端分支”，除了 Git 不允许你检出（切换到该分支）之外，跟本地分支没区别 ——
174 |       你可以将它们合并到当前分支，与其他分支作比较差异，查看那些分支的历史日志，等等。同步之后你就可以在本地操作这些。
175 |     </p>
176 | 
177 |     <p>
178 |       第二个会从远端服务器提取新数据的命令是 <code>git pull</code>。
179 |       基本上，该命令就是在 <code>git fetch</code> 之后紧接着 <code>git merge</code> 远端分支到你所在的任意分支。
180 |       我个人不太喜欢这命令 —— 我更喜欢 <code>fetch</code> 和 <code>merge</code> 分开来做。少点魔法，少点问题。
181 |       不过，如果你喜欢这主意，你可以看一下 <code>git pull</code> 的
182 |       <a target="new" href="http://git-scm.com/docs/git-pull">官方文档</a>。
183 |     </p>
184 | 
185 |     <p>
186 |       假设你配置好了一个远端，并且你想要提取更新，你可以首先执行 <code>git fetch [alias]</code>
187 |       告诉 Git 去获取它有你没有的数据，然后你可以执行 <code>git merge [alias]/[branch]</code>
188 |       以将服务器上的任何更新（假设有人这时候推送到服务器了）合并到你的当前分支。
189 |       那么，如果我是与两三个其他人合作 Hello World 项目，并且想要将我最近连接之后的所有改动拿过来，我可以这么做：
190 |     </p>
191 | 
192 | <pre>
193 | <b>$ git fetch github</b>
194 | remote: Counting objects: 4006, done.
195 | remote: Compressing objects: 100% (1322/1322), done.
196 | remote: Total 2783 (delta 1526), reused 2587 (delta 1387)
197 | Receiving objects: 100% (2783/2783), 1.23 MiB | 10 KiB/s, done.
198 | Resolving deltas: 100% (1526/1526), completed with 387 local objects.
199 | From github.com:schacon/hw
200 |    8e29b09..c7c5a10  master     -> github/master
201 |    0709fdc..d4ccf73  c-langs    -> github/c-langs
202 |    6684f82..ae06d2b  java       -> github/java
203 |  * [new branch]      ada        -> github/ada
204 |  * [new branch]      lisp       -> github/lisp
205 | </pre>
206 | 
207 |     <p>
208 |       可以看到自从上一次与远端仓库同步以后，又新赠或更新了五个分支。
209 |       “ada”与“lisp”分支是新的，而“master”、“clang”与“java”分支则被更新了。
210 |       在此例中，我的团队在合并入主分支之前，将提议的更新推送到远端分支以审核。
211 |     </p>
212 | 
213 |     <p>
214 |       你可以看到 Git 做的映射。远端仓库的主分支成为了本地的一个叫做“github/master”的分支。
215 |       这样我就可以执行 <code>git merge github/master</code> 将远端的主分支和并入我的本地主分支。
216 |       或者，我可以 <code>git log github/master ^master</code> 看看该分支上的新提交。
217 |       如果你的远端仓库叫做“origin”，那远端主分支就会叫做 <code>origin/master</code>。几乎所有能在本地分支上执行的命令都可以在远端分支上用。
218 |     </p>
219 | 
220 |     <p>
221 |       如果你有多个远端仓库，你可以执行 <code>git fetch [alias]</code> 提取特定的远端仓库，
222 |       或者执行 <code>git fetch --all</code> 告诉 Git 同步所有的远端仓库。
223 |     </p>
224 | 
225 |     <p class="nutshell">
226 |       <b>简而言之</b> 执行 <code>git fetch [alias]</code> 来将你的仓库与远端仓库同步，提取所有它独有的数据到本地分支以合并或者怎样。
227 |     </p>
228 | 
229 |   </div>
230 | 
231 | </div>
232 | 
233 | <div class="box">
234 |   <h2>
235 |     <span class="docs">
236 |       <a target="new" href="http://git-scm.com/docs/git-push">文档</a> &nbsp;
237 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Working-with-Remotes#Pushing-to-Your-Remotes">书</a>
238 |     </span>
239 |     <a name="push">git push</a>
240 |     <span class="desc">推送你的新分支与数据到某个远端仓库</span>
241 |   </h2>
242 | 
243 |   <div class="block">
244 |     <p>
245 |       想要与他人分享你牛鼻的提交，你需要将改动推送到远端仓库。
246 |       执行 <code>git push [alias] [branch]</code>，就会将你的 [branch] 分支推送成为 [alias] 远端上的 [branch] 分支。
247 |       让我们试试推送我们的主分支到先前添加的“github”远端仓库上去。
248 |     </p>
249 | 
250 | <pre>
251 | <b>$ git push github master</b>
252 | Counting objects: 25, done.
253 | Delta compression using up to 2 threads.
254 | Compressing objects: 100% (25/25), done.
255 | Writing objects: 100% (25/25), 2.43 KiB, done.
256 | Total 25 (delta 4), reused 0 (delta 0)
257 | To git@github.com:schacon/hw.git
258 |  * [new branch]      master -> master
259 | </pre>
260 | 
261 |     <p>
262 |       挺简单。现在如果有人从该仓库克隆，他会得到我提交的完完全全的一份历史记录了。
263 |     </p>
264 | 
265 |     <p>
266 |       如果有个像之前创建的“erlang”分支那样的主题分支，想只分享这个，该怎么办呢？你可以相应的只推送该分支。
267 |     </p>
268 | 
269 | <pre>
270 | <b>$ git push github erlang</b>
271 | Counting objects: 7, done.
272 | Delta compression using up to 2 threads.
273 | Compressing objects: 100% (6/6), done.
274 | Writing objects: 100% (6/6), 652 bytes, done.
275 | Total 6 (delta 1), reused 0 (delta 0)
276 | To git@github.com:schacon/hw.git
277 |  * [new branch]      erlang -> erlang
278 | </pre>
279 | 
280 |     <p>
281 |       现在当人们从该仓库克隆时，他们就会得到一个“erlang”分支以查阅、合并。
282 |       用这种方式，你可以推送任何分支到任何你有写权限的仓库。
283 |       如果你的分支已经在该仓库中了，它会试着去更新，如果它不再，Git 会把它加上。
284 |     </p>
285 | 
286 |     <p>
287 |       最后一个当你推送到远端分支时会碰到的主要问题是，其他人在此期间也推送了的情况。
288 |       如果你和另一个开发者同时克隆了，又都有提交，那么当她推送后你也想推送时，默认情况下 Git 不会让你覆盖她的改动。
289 |       相反的，它会在你试图推送的分支上执行 <code>git log</code>，确定它能够在你的推送分支的历史记录中看到服务器分支的当前进度。
290 |       如果它在在你的历史记录中看不到，它就会下结论说你过时了，并打回你的推送。
291 |       你需要正式提取、合并，然后再次推送 —— 以确定你把她的改动也考虑在内了。
292 |     </p>
293 | 
294 |     <p>
295 |       当你试图推送到某个以被更新的远端分支时，会出现下面这种情况：
296 |     </p>
297 | 
298 | <pre>
299 | <b>$ git push github master</b>
300 | To git@github.com:schacon/hw.git
301 |  ! [rejected]        master -> master (non-fast-forward)
302 | error: failed to push some refs to 'git@github.com:schacon/hw.git'
303 | To prevent you from losing history, non-fast-forward updates were rejected
304 | Merge the remote changes before pushing again.  See the 'Note about
305 | fast-forwards' section of 'git push --help' for details.
306 | </pre>
307 | 
308 |     <p>
309 |     你可以修正这个问题。执行 <code>git fetch github; git merge github/master</code>，然后再推送
310 |     </p>
311 | 
312 |     <p class="nutshell">
313 |       <b>简而言之</b> 执行 <code>git push [alias] [branch]</code> 将你的本地改动推送到远端仓库。
314 |       如果可以的话，它会依据你的 [branch] 的样子，推送到远端的 [branch] 去。
315 |       如果在你上次提取、合并之后，另有人推送了，Git 服务器会拒绝你的推送，知道你是最新的为止。
316 |     </p>
317 | 
318 |   </div>
319 | </div>
320 | 
321 | <p><a href="/inspect">到 检查与比较&#187;</a></p>
322 | 


--------------------------------------------------------------------------------
/css/layout.css:
--------------------------------------------------------------------------------
  1 | /*
  2 | -----------------------------------------------
  3 | Grey Box Method - Layout CSS
  4 | ----------------------------------------------- */
  5 | 
  6 | html, body {
  7 | 	border-top: 5px solid #000;
  8 | 	color: #333;
  9 | 	padding: 0 0 40px;
 10 | 	font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
 11 | }
 12 | 
 13 | #about_me img { border: 5px solid #333; margin: 3px; }
 14 | 
 15 | .info { background: #fff; padding: 10px;}
 16 | 
 17 | .article { border-bottom: 5px solid rgb(20,120,200); padding-bottom: 10px; margin-bottom: 15px;}
 18 | 
 19 | .non_home_box {
 20 |     display: none;
 21 | }
 22 | 
 23 | #reflist h3 { 
 24 |   font-size: 1.1em; 
 25 |   background: #fff; 
 26 | }
 27 | #reflist h3 a { 
 28 |  color: rgb(20,120,200);
 29 | }
 30 | #reflist h4 { font-size: 0.9em; }
 31 | #reflist .block { margin: 0; padding: 0; }
 32 | 
 33 | code { background: #ffe; padding: 2px 5px; }
 34 | 
 35 | p.nutshell {
 36 |   background: #ddd;
 37 |   padding: 5px;
 38 | }
 39 | 
 40 | .box pre { 
 41 |   margin-top: 10px;
 42 |   padding: 8px;
 43 |   background: #ffe; 
 44 |   color: #555;
 45 | }
 46 | 
 47 | .box code.code {
 48 |   white-space:pre;
 49 |   font-family: Consolas, 'Liberation Mono', Courier, monospace;
 50 |   padding: 8px;
 51 |   background: #ffe;
 52 |   display: block;
 53 |   margin: 10px;
 54 |   color: #555;
 55 | }
 56 | pre b { color: #111; }
 57 | .red { color: #d33; }
 58 | .green { color: #383; }
 59 | .umber { color: #8A3324; }
 60 | .lblue { color: #55a; }
 61 | .blue { color: #447; }
 62 | .yellow { color: #993; }
 63 | .hl { background: #eea; }
 64 | 
 65 | .box h4 { 
 66 |   font-family: Consolas, 'Liberation Mono', Courier, monospace;
 67 |   margin-top: 20px;
 68 |   color: #833;
 69 | }
 70 | .box h4 small { 
 71 |   color: #888;
 72 |   font-size: 0.8em;
 73 |   margin-left: 10px;
 74 |   font-weight: normal;
 75 | }
 76 | 
 77 | .note { 
 78 |   float: right; 
 79 |   border: 10px; 
 80 |   padding: 8px; 
 81 |   background: #dfd;
 82 |   border: 1px solid #8a8;
 83 |   width: 120px;
 84 | }
 85 | .note h3 {
 86 |   font-size: 1.1em;
 87 |   color: #353;
 88 | }
 89 | 
 90 | ul#menu { 
 91 |     background: rgb(20,120,200);
 92 |     padding: .5em;
 93 |     display: inline;
 94 |     color: #fff;
 95 | }
 96 | ul#menu li {
 97 |     border: 0;
 98 |     margin: 0;
 99 |     padding: 0;
100 |     padding-right: 10px;
101 |     padding-left: 10px;
102 |     display:inline;
103 |     font-size: 1.1em;
104 | }
105 | 
106 | ul#menu li a { color: #fff; }
107 | 
108 | .scribble-preview { 
109 |     background: #ff9; 
110 |     padding: 8px;
111 |     border: 1px solid #ee6;
112 | }
113 | 
114 | img#me { border: 8px solid #333; }
115 | 
116 | /* anchors
117 | ----------------------------------------------- */
118 | a {
119 | 	color: #000;
120 | 	font-weight:bold;
121 | 	text-decoration: none;
122 | }
123 | a:hover {
124 | 	color:#333;
125 | }
126 | a.page-button {
127 | 	background: #e4eafa none 0 0 repeat-x;
128 | 	border: solid 1px #c9172e;
129 | 	color: #c9172e;
130 | 	cursor: pointer;
131 | 	display: inline-block;
132 | 	font-weight: bold;
133 | 	font-size: 12px;
134 | 	line-height: 100%;
135 | 	margin: 1px;
136 | 	padding: 0.8em 1em;
137 | 	position: relative;
138 | 	text-decoration: none;
139 | 	text-shadow: #fff 0 1px 0;
140 | 	vertical-align: middle;
141 | 	white-space: nowrap;
142 | 	float:right;
143 | 	background-image: -moz-linear-gradient(-90deg,
144 | 		#eeeeee 1%,
145 | 		#fdf6f7 5%,
146 | 		#fae9eb 70%,
147 | 		#f7dcdf 100%);
148 | 	background-image: -webkit-gradient(linear,left top,left bottom,
149 | 		color-stop(0.01, #eee),
150 | 		color-stop(0.05, #fdf6f7),
151 | 		color-stop(0.70, #fae9eb),
152 | 		color-stop(1, #f7dcdf));
153 | }
154 | a.next-page {
155 | 	border-right: none;
156 | 	margin-right: 26px;
157 | 	padding-right: 0;
158 | }
159 | a.next-page:after, a.prev-page:after {
160 | 	border: solid 1px #c9172e;
161 | 	content: '';
162 | 	display: block;
163 | 	position: absolute;
164 | 	top: .37em;
165 | 	width: 1.7em;
166 | 	height: 1.7em;
167 | 	text-shadow: none;
168 | 	z-index: -1;
169 | }
170 | a.next-page:after {
171 | 	right: -.97em;
172 | 	-moz-transform: rotate(-45deg);
173 | 	background-image: -moz-linear-gradient(-135deg,
174 | 		#eeeeee 1%,
175 | 		#fdf6f7 5%,
176 | 		#fae9eb 70%,
177 | 		#f7dcdf 100%);
178 | 	-webkit-transform:rotate(-45deg);
179 | 	background-image: -webkit-gradient(linear,100% 0%, 0% 100%,
180 | 		color-stop(0.01, #eee),
181 | 		color-stop(0.05, #fdf6f7),
182 | 		color-stop(0.70, #fae9eb),
183 | 		color-stop(1, #f7dcdf));
184 | }
185 | 
186 | /* headings
187 | ----------------------------------------------- */
188 | h1, h2, h3, h4, h5, h6 {line-height:1.2em; margin-bottom:.3em;}
189 | h2 {margin-top:1em; }
190 | h5 {font-size:1.2em;}
191 | h6 {font-size:1em; text-transform:uppercase;}
192 | h3 { color: rgb(20,120,200); }
193 | 
194 | h1 a {
195 | 	font-weight:normal;
196 | }
197 | 
198 | 
199 | /* branding
200 | ----------------------------------------------- */
201 | #branding {
202 | 	font-weight:normal;
203 | 	font-size:4em;
204 | 	text-align:left;
205 | 	padding:8px;
206 | 	margin-bottom:0;
207 | 	color: #333;
208 | 	background: #fff;
209 | }
210 | 
211 | 
212 | /* page heading
213 | ----------------------------------------------- */
214 | #page-heading {
215 | 	padding: 5px;
216 | 	background: #000;
217 | 	color: #eee;
218 | 	font-size:2em;
219 | 	letter-spacing: 8px;
220 | }
221 | 
222 | 
223 | /* boxes
224 | ----------------------------------------------- */
225 | .box {
226 | 	background:#eee;
227 | 	margin-bottom:20px;
228 | 	padding:10px 10px 1px 10px;
229 | 	font-size: 1.1em;
230 | }
231 | .box h2 {
232 | 	font-size:1em;
233 | 	font-weight:normal;
234 | 	text-transform:uppercase;
235 | 	color:#fff;
236 | 	background:#333;
237 | 	margin:-10px -10px 0 -10px;
238 | 	padding:6px 12px;
239 | }
240 | .box h2 .desc {
241 |   margin-left: 20px;
242 | 	text-transform:none;
243 |   color: #aaa;
244 | }
245 | .box h2 a,
246 | .box h2 a.visible {
247 | 	background-color:#111;
248 | 	color:#fff;
249 | 	display:inline;
250 | 	padding:6px 12px;
251 | 	margin:-6px -12px;
252 | 	border:none;
253 | 	text-transform:none;
254 | }
255 | .box h2 .docs {
256 |   color: #999;
257 | 	display:inline;
258 |   float: right;
259 | 	background-color:#333;
260 | }
261 | .box h2 .docs a {
262 | 	background-color:#333;
263 | 	padding:0;
264 | 	margin:0;
265 | }
266 | 
267 | .grid_4 .box h2 a {
268 | 	background-position: 97% 50%;
269 | }
270 | .grid_5 .box h2 a {
271 | 	background-position: 98% 50%;
272 | }
273 | .grid_12 .box h2 a {
274 | 	background-position: 99% 50%;
275 | }
276 | 
277 | 
278 | .box h2 a:hover {
279 | 	background-color:#111;
280 | }
281 | .block {
282 | 	padding-top:10px;
283 | }
284 | div.menu {
285 | 	padding:0;
286 | }
287 | div.menu h2 {
288 | 	margin:0;
289 | }
290 | div.menu .block {
291 | 	padding-top:0;
292 | }
293 | 
294 | 
295 | /* paragraphs, quotes and lists
296 | ----------------------------------------------- */
297 | p {
298 | 	margin-bottom:1em;
299 | }
300 | blockquote {
301 |   font-family: Consolas, 'Liberation Mono', Courier, monospace;
302 |   padding-left:1em;
303 |   border-left:4px solid #ccc;
304 | }
305 | blockquote cite {
306 | 	font-size:.9em;
307 | }
308 | ul, ol {
309 | 	padding-top:0;
310 | }
311 | 
312 | 
313 | /* menus
314 | ----------------------------------------------- */
315 | ul.menu {
316 | 	list-style:none;
317 | 	border-top:1px solid #bbb;
318 | }
319 | ul.menu li {
320 | 	margin:0;
321 | }
322 | ul.menu li a {
323 | 	display:block;
324 | 	padding:4px 10px;
325 | 	border-bottom:1px solid #ccc;
326 | }
327 | ul.menu li a:hover {
328 | 	background:#eee;
329 | }
330 | ul.menu li a:active {
331 | 	background:#ccc;
332 | }
333 | 
334 | 
335 | /* submenus
336 | ----------------------------------------------- */
337 | ul.menu ul {
338 | 	list-style:none;
339 | 	margin:0;
340 | }
341 | ul.menu ul li a {
342 | 	padding-left:30px;
343 | }
344 | 
345 | 
346 | /* section menus
347 | ----------------------------------------------- */
348 | ul.section {
349 | 	border-top:0;
350 | 	margin-bottom:0;
351 | }
352 | ul.section li {
353 | 	text-transform:uppercase;
354 | }
355 | ul.section li a {
356 | 	background:#bbb;
357 | }
358 | ul.section li a:hover {
359 | 	background:#aaa;
360 | }
361 | ul.section li a:active {
362 | 	color:#fff;
363 | 	background:#666;
364 | }
365 | ul.section li li a {
366 | 	background:#ddd;
367 | 	border-bottom:1px solid #eee;
368 | }
369 | ul.section li li a:hover {
370 | 	background:#ccc;
371 | }
372 | ul.section li li a:active {
373 | 	color:#000;
374 | 	background:#fff;
375 | }
376 | ul.section ul li {
377 | 	text-transform:none;
378 | }
379 | ul.section ul.current li a {
380 | 	background:#eee;
381 | 	border-bottom:1px solid #fff;
382 | }
383 | ul.section ul.current li a:hover {
384 | 	background:#ddd;
385 | }
386 | ul.section ul.current li a:active {
387 | 	background:#fff;
388 | }
389 | ul.section li a.current {
390 | 	color:#fff;
391 | 	background:#666;
392 | }
393 | ul.section li a.current:hover {
394 | 	background:#555;
395 | }
396 | ul.section li a.current:active {
397 | 	background:#444;
398 | }
399 | ul.section li a.active {
400 | 	background:#fff;
401 | 	cursor:default;
402 | }
403 | ul.section li.current > a.active,
404 | ul.section li.current > a.active:hover {
405 | 	color:#fff;
406 | 	background:#666;
407 | 	cursor:default;
408 | }
409 | 
410 | 
411 | /* table
412 | ----------------------------------------------- */
413 | table {
414 | 	width:100%;
415 | 	border:1px solid #bbb;
416 | 	margin-bottom:10px;
417 | }
418 | col.colC {
419 | 	width:8em;
420 | }
421 | th, td {
422 | 	padding:.2em 1em;
423 | 	text-align:left;
424 | }
425 | thead th {
426 | 	border-bottom:2px solid #888;
427 | 	background:#bbb;
428 | 	padding:.4em 1em .2em;
429 | }
430 | thead th.table-head {
431 | 	font-size:1em;
432 | 	font-weight:normal;
433 | 	text-transform:uppercase;
434 | 	color:#fff;
435 | 	background:#555;
436 | 	border:1px solid #555;
437 | }
438 | tbody th,
439 | tbody td {
440 | 	border-top:1px solid #bbb;
441 | 	border-bottom:1px solid #bbb;
442 | 	background:#eee;
443 | }
444 | tbody tr.odd th,
445 | tbody tr.odd td {
446 | 	background:#fff;
447 | }
448 | tfoot th,
449 | tfoot td {
450 | 	border-top:2px solid #666;
451 | 	background:#eee;
452 | }
453 | tfoot tr.total th,
454 | tfoot tr.total td {
455 | 	border-top:6px double #666;
456 | }
457 | tfoot tr.total th {
458 | 	text-transform:uppercase;
459 | }
460 | th.currency,
461 | td.currency {
462 | 	text-align:right;
463 | }
464 | 
465 | 
466 | /* forms
467 | ----------------------------------------------- */
468 | form {
469 | 	overflow:hidden;
470 | }
471 | fieldset {
472 | 	border:1px solid #bbb;
473 | 	padding:10px;
474 | 	position:relative;
475 | 	background:#e9e9e9;
476 | 	margin-bottom:10px;
477 | }
478 | legend {
479 | 	font-size:1.1em;
480 | 	padding:.4em .8em;
481 | 	background:#fff;
482 | 	border:1px solid #bbb;
483 | }
484 | fieldset.login p {
485 | 	margin-bottom:1em;
486 | 	margin-top:0pt;
487 | }
488 | fieldset p label {
489 | 	width:98%;
490 | }
491 | fieldset p input {
492 | 	width:98%;
493 | }
494 | fieldset p select {
495 | 	width:99%;
496 | }
497 | fieldset.login p label {
498 | 	float:left;
499 | 	line-height:2em;
500 | 	margin-right:3%;
501 | 	text-align:right;
502 | 	width:32%;
503 | }
504 | fieldset.login p input {
505 | 	width:60%;
506 | }
507 | fieldset.login input.button {
508 | 	margin-left:35%;
509 | }
510 | form p.notice {
511 | 	font-weight:bold;
512 | }
513 | input.search.text {
514 | 	width:66%;
515 | }
516 | input.search.button {
517 | 	width:28%;
518 | 	margin-left:2%;
519 | }
520 | 
521 | 
522 | /* articles
523 | ----------------------------------------------- */
524 | .articles {
525 | 	padding:0;
526 | }
527 | .articles h2 {
528 | 	margin:0;
529 | }
530 | #articles {
531 | 	padding-top:0;
532 | }
533 | .article {
534 | 	border-top:1px solid #666;
535 | 	padding-top:.5em;
536 | }
537 | .box .article {
538 | 	border-top:3px solid #fff;
539 | 	padding:13px 10px 0 10px;
540 | 	background: #fff;
541 | }
542 | .article h2 {
543 | 	font-size:2em;
544 | 	font-weight:normal;
545 | 	text-transform:none;
546 | 	color:#333;
547 | 	background:transparent;
548 | 	padding:0;
549 | 	margin:0;
550 | 	border:none;
551 | }
552 | .article h3 {
553 | 	margin-bottom:.2em;
554 | 	font-size:1.6em;
555 | }
556 | .box .first {
557 | 	border-top:none;
558 | }
559 | .article h4 {
560 | 	font-size:1.2em;
561 | 	text-transform:uppercase;
562 | 	margin-bottom:.5em;
563 | }
564 | .article a.image {
565 | 	float:left; 
566 | 	margin:3px 10px 3px 0; 
567 | 	padding:4px;
568 | 	border:1px solid #bbb;
569 | 	background:#fff;
570 | }
571 | .article a.image:hover {
572 | 	border:1px solid #666;
573 | }
574 | .article a.image img {
575 | 	float:left; 
576 | }
577 | .article p.meta {
578 | 	color:#666;
579 | 	border-top:1px dotted #999;
580 | 	border-bottom:1px dotted #999;
581 | 	padding:.3em 0;
582 | 	margin-bottom:.8em;
583 | }
584 | 
585 | 
586 | /* site information
587 | ----------------------------------------------- */
588 | #site_info .box {
589 | 	color:#ccc;
590 | 	background:#666;
591 | 	margin-bottom:10px;
592 | }
593 | #site_info a {
594 | 	color:#fff;
595 | }
596 | #site_info a:hover {
597 | 	color:#000;
598 | }
599 | 
600 | 
601 | /* AJAX sliding shelf
602 | ----------------------------------------------- */
603 | #loading {float:right; margin-right:14px; margin-top:-2px;}
604 | .block {padding-bottom:1px;}
605 | 
606 | 
607 | /* Accordian
608 | ----------------------------------------------- */
609 | .toggler {
610 | 	color: #222;
611 | 	margin: 0;
612 | 	padding: 2px 5px;
613 | 	background: #eee;
614 | 	border-bottom: 1px solid #ddd;
615 | 	border-right: 1px solid #ddd;
616 | 	border-top: 1px solid #f5f5f5;
617 | 	border-left: 1px solid #f5f5f5;
618 | 	font-size:1.1em;
619 | 	font-weight: normal;
620 | }
621 | .element h4 {
622 | 	margin: 0;
623 | 	padding:4px;
624 | 	line-height:1.2em;
625 | }
626 | .element p {
627 | 	margin: 0;
628 | 	padding: 4px;
629 | }
630 | .float-right {
631 | 	padding:10px 20px;
632 | 	float:right;
633 | }
634 | 
635 | #accordian-block {
636 | 	padding-bottom:10px;
637 | }
638 | 
639 | 
640 | /* Mootools Kwicks
641 | ----------------------------------------------- */
642 | #kwick-box { 
643 | 	padding:0;
644 | 	overflow:hidden;
645 | }
646 | #kwick-box h2 { 
647 | 	margin:0;
648 | }
649 | #kwick {
650 | 	position: relative;
651 | }
652 | #kwick .kwicks {
653 | 	display: block;
654 | 	background: #999;
655 | 	height: 120px;
656 | 	list-style:none;
657 | 	margin:0;
658 | 	overflow:hidden;
659 | }
660 | #kwick li {
661 | 	float: left;
662 | 	margin:0;
663 | 	padding:0;
664 | }
665 | #kwick .kwick {
666 | 	display: block;
667 | 	cursor: pointer;
668 | 	overflow: hidden;
669 | 	height: 100px;
670 | 	width: 215px;
671 | 	padding: 10px;
672 | 	background: #fff;
673 | }
674 | #kwick .kwick span {
675 | 	color:#fff;
676 | }
677 | #kwick .one {
678 | 	background: #666;
679 | }
680 | #kwick .two {
681 | 	background: #777;
682 | }
683 | #kwick .three {
684 | 	background: #888;
685 | }
686 | #kwick .four {
687 | 	background: #999;
688 | }
689 | 


--------------------------------------------------------------------------------
/inspect/index.html:
--------------------------------------------------------------------------------
  1 | ---
  2 | layout: zh_reference
  3 | ---
  4 | 
  5 | <div class="box">
  6 |   <h2>
  7 |     <span class="docs">
  8 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History">书</a>
  9 |     </span>
 10 |     检查与比较
 11 |   </h2>
 12 |   <div class="block">
 13 |     <p>
 14 |       现在你有了一堆分支，短期的主题、长期的特性或者其它。怎样追踪他们呢？
 15 |       Git 有一组工具，可以帮助你弄明白工作是在哪儿完成的，两个分支间的区别是啥，等等。
 16 |     </p>
 17 | 
 18 |     <p class="nutshell">
 19 |       <b>简而言之</b> 执行 <code>git log</code> 找到你的项目历史中的特定提交 ——
 20 |       按作者、日期、内容或者历史记录。执行 <code>git diff</code> 比较历史记录中的两个不同的点 ——
 21 |       通常是为了看看两个分支有啥区别，或者从某个版本到另一个版本，你的软件都有啥变化。
 22 |     </p>
 23 |   </div>
 24 | </div>
 25 | 
 26 | <div class="box">
 27 |   <h2>
 28 |     <span class="docs">
 29 |       <a target="new" href="http://git-scm.com/docs/git-log">文档</a> &nbsp;
 30 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Viewing-the-Commit-History#Limiting-Log-Output">书k</a>
 31 |     </span>
 32 |     <a name="log">git log</a>
 33 |     <span class="desc">过滤你的提交历史记录</span>
 34 |   </h2>
 35 | 
 36 |   <div class="block">
 37 |     <p>
 38 |       通过查看分支中另一分支看不到的提交记录，我们已经看到如何用 <code>git log</code> 来比较分支。
 39 |       （如果你不记得了，它看起来是这样的：<code>git log branchA ^branchB</code>）。
 40 |       而且，你也可以用 <code>git log</code> 去寻找特定的提交。
 41 |       在此，我们会看到一些更广为使用的 <code>git log</code> 选项，不过哪有很多。
 42 |       完整的清单可以看看官方文档。
 43 |     </p>
 44 | 
 45 |     <h4>
 46 |       git log --author
 47 |       <small>只寻找某个特定作者的提交</small>
 48 |     </h4>
 49 | 
 50 |     <p>
 51 |       要过滤你的提交历史，只寻找某个特定作者的提交，你可以使用 <code>--author</code> 选项。
 52 |       例如，比方说我们要找 Git 源码中 Linus 提交的部分。
 53 |       我们可以执行类似 <code>git log --author=Linus</code> 的命令。
 54 |       这个查找是大小写敏感的，并且也会检索电子邮箱地址。
 55 |       我在此例中使用 <code>-[number]</code> 选项，以限制结果为最近 [number] 次的提交。
 56 |     </p>
 57 | 
 58 | <pre>
 59 | <b>$ git log --author=Linus --oneline -5</b>
 60 | 81b50f3 Move 'builtin-*' into a 'builtin/' subdirectory
 61 | 3bb7256 make "index-pack" a built-in
 62 | 377d027 make "git pack-redundant" a built-in
 63 | b532581 make "git unpack-file" a built-in
 64 | 112dd51 make "mktag" a built-in
 65 | </pre>
 66 | 
 67 |     <h4>
 68 |       git log --since --before
 69 |       <small>根据日期过滤提交记录</small>
 70 |     </h4>
 71 | 
 72 |     <p>
 73 |       如果你要指定一个你感兴趣的日期范围以过滤你的提交，可以执行几个选项 ——
 74 |       我用 <code>--since</code> 和 <code>--before</code>，但是你也可以用 <code>--until</code> 和 <code>--after</code>。
 75 |       例如，如果我要看 Git 项目中三周前且在四月十八日之后的所有提交，我可以执行这个（我还用了 <code>--no-merges</code> 选项以隐藏合并提交）：
 76 |     </p>
 77 | 
 78 | <pre>
 79 | <b>$ git log --oneline --before={3.weeks.ago} --after={2010-04-18} --no-merges</b>
 80 | 5469e2d Git 1.7.1-rc2
 81 | d43427d Documentation/remote-helpers: Fix typos and improve language
 82 | 272a36b Fixup: Second argument may be any arbitrary string
 83 | b6c8d2d Documentation/remote-helpers: Add invocation section
 84 | 5ce4f4e Documentation/urls: Rewrite to accomodate transport::address
 85 | 00b84e9 Documentation/remote-helpers: Rewrite description
 86 | 03aa87e Documentation: Describe other situations where -z affects git diff
 87 | 77bc694 rebase-interactive: silence warning when no commits rewritten
 88 | 636db2c t3301: add tests to use --format="%N"
 89 | </pre>
 90 | 
 91 |     <h4>
 92 |       git log --grep
 93 |       <small>根据提交注释过滤提交记录</small>
 94 |     </h4>
 95 | 
 96 |     <p>
 97 |       你或许还想根据提交注释中的某个特定短语查找提交记录。可以用 <code>--grep</code> 选项。
 98 |       比如说我知道有个提交是有关使用 P4EDITOR 环境变量，又想回忆起那个改动是啥样子的 —— 我可以用 <code>--grep</code> 选项找到该提交。
 99 |     </p>
100 | 
101 | <pre>
102 | <b>$ git log --grep=P4EDITOR --no-merges</b>
103 | <span class="yellow">commit 82cea9ffb1c4677155e3e2996d76542502611370</span>
104 | Author: Shawn Bohrer
105 | Date:   Wed Mar 12 19:03:24 2008 -0500
106 | 
107 |     git-p4: Use P4EDITOR environment variable when set
108 | 
109 |     Perforce allows you to set the P4EDITOR environment variable to your
110 |     preferred editor for use in perforce.  Since we are displaying a
111 |     perforce changelog to the user we should use it when it is defined.
112 | 
113 |     Signed-off-by: Shawn Bohrer &lt;shawn.bohrer@gmail.com>
114 |     Signed-off-by: Simon Hausmann &lt;simon@lst.de>
115 | </pre>
116 | 
117 |     <p>
118 |       Git 会对所有的 <code>--grep</code> 和 <code>--author</code> 参数作逻辑或。
119 |       如果你用 <code>--grep</code> 和 <code>--author</code> 时，想看的是某人写作的并且有某个特殊的注释内容的提交记录，
120 |       你需要加上 <code>--all-match</code> 选项。
121 |       在这些例子中，我会用上 <code>--format</code> 选项，这样我们就可以看到每个提交的作者是谁了。
122 |     </p>
123 | 
124 |     <p>
125 |       如果我查找注释内容含有 “p4 depo”的提交，我得到了三个提交：
126 |     </p>
127 | 
128 | <pre>
129 | <b>$ git log --grep="p4 depo" --format="%h %an %s"</b>
130 | ee4fd1a Junio C Hamano Merge branch 'master' of git://repo.or.cz/git/fastimport
131 | da4a660 Benjamin Sergeant git-p4 fails when cloning a p4 depo.
132 | 1cd5738 Simon Hausmann Make incremental imports easier to use by storing the p4 d
133 | </pre>
134 | 
135 |     <p>
136 |       如果我加上 <code>--author=Hausmann</code> 参数，与进一步过滤上述结果到 Simon 的唯一提交相反，
137 |       它会告诉我所有 Simon 的提交，或者注释中有“p4 demo”的提交：
138 |     </p>
139 | 
140 | <pre>
141 | <b>$ git log --grep="p4 depo" --format="%h %an %s" --author="Hausmann"</b>
142 | cdc7e38 Simon Hausmann Make it possible to abort the submission of a change to Pe
143 | f5f7e4a Simon Hausmann Clean up the git-p4 documentation
144 | 30b5940 Simon Hausmann git-p4: Fix import of changesets with file deletions
145 | 4c750c0 Simon Hausmann git-p4: git-p4 submit cleanups.
146 | 0e36f2d Simon Hausmann git-p4: Removed git-p4 submit --direct.
147 | edae1e2 Simon Hausmann git-p4: Clean up git-p4 submit's log message handling.
148 | 4b61b5c Simon Hausmann git-p4: Remove --log-substitutions feature.
149 | 36ee4ee Simon Hausmann git-p4: Ensure the working directory and the index are cle
150 | e96e400 Simon Hausmann git-p4: Fix submit user-interface.
151 | 38f9f5e Simon Hausmann git-p4: Fix direct import from perforce after fetching cha
152 | 2094714 Simon Hausmann git-p4: When skipping a patch as part of "git-p4 submit" m
153 | 1ca3d71 Simon Hausmann git-p4: Added support for automatically importing newly ap
154 | ...
155 | </pre>
156 | 
157 |     <p>
158 |       不过，如果加上 <code>--all-match</code>，结果就是我想要的了：
159 |     </p>
160 | 
161 | <pre>
162 | <b>$ git log --grep="p4 depo" --format="%h %an %s" --author="Hausmann" --all-match</b>
163 | 1cd5738 Simon Hausmann Make incremental imports easier to use by storing the p4 d
164 | </pre>
165 | 
166 |     <h4>
167 |       git log -S
168 |       <small>依据所引入的差值过滤</small>
169 |     </h4>
170 | 
171 |     <p>
172 |       如果你写的提交注释都极度糟糕怎么办？或者，如果你要找某个函数是何时引入的，某些变量是在哪里开始被使用的？
173 |       你可以告诉 Git 在每个提交之间的差值中查找特定字符串。
174 |       例如，如果我们想要找出哪个提交修改出了类似函数名“userformat_find_requirements”，
175 |       我们可以执行（注意在“-S”与你要找的东东之间没有“=”）：
176 |     </p>
177 | 
178 | <pre>
179 | <b>$ git log -Suserformat_find_requirements</b>
180 | <span class="yellow">commit 5b16360330822527eac1fa84131d185ff784c9fb</span>
181 | Author: Johannes Gilger
182 | Date:   Tue Apr 13 22:31:12 2010 +0200
183 | 
184 |     pretty: Initialize notes if %N is used
185 | 
186 |     When using git log --pretty='%N' without an explicit --show-notes, git
187 |     would segfault. This patches fixes this behaviour by loading the needed
188 |     notes datastructures if --pretty is used and the format contains %N.
189 |     When --pretty='%N' is used together with --no-notes, %N won't be
190 |     expanded.
191 | 
192 |     This is an extension to a proposed patch by Jeff King.
193 | 
194 |     Signed-off-by: Johannes Gilger
195 |     Signed-off-by: Junio C Hamano
196 | </pre>
197 | 
198 |     <h4>
199 |       git log -p
200 |       <small>显示每个提交引入的补丁</small>
201 |     </h4>
202 | 
203 |     <p>
204 |       每个提交都是项目的一个快照。由于每个提交都记录它所基于的快照，Git 能够经常对它们求差值，并以补丁形式向你展示。
205 |       这意味着，对任意提交，你都可以获取该提交给项目引入补丁。
206 |       你可以用 <code>git show [SHA]</code> 加上某个特定的提交 SHA 获取，或者执行 <code>git log -p</code>，
207 |       它会告诉 Git 输出每个提交之后的补丁。这是个总结某一分支或者两个提交之间都发生了神马的好途径。
208 |     </p>
209 | 
210 | <pre>
211 | <b>$ git log -p --no-merges -2</b>
212 | <span class="yellow">commit 594f90bdee4faf063ad07a4a6f503fdead3ef606</span>
213 | Author: Scott Chacon &lt;schacon@gmail.com>
214 | Date:   Fri Jun 4 15:46:55 2010 +0200
215 | 
216 |     reverted to old class name
217 | 
218 | <span class="umber">diff --git a/ruby.rb b/ruby.rb
219 | index bb86f00..192151c 100644
220 | --- a/ruby.rb
221 | +++ b/ruby.rb</span>
222 | <span class="lblue">@@ -1,7 +1,7 @@</span>
223 | <span class="red">-class HiWorld</span>
224 | <span class="green">+class HelloWorld</span>
225 |    def self.hello
226 |      puts "Hello World from Ruby"
227 |    end
228 |  end
229 | 
230 | <span class="red">-HiWorld.hello</span>
231 | <span class="green">+HelloWorld.hello</span>
232 | 
233 | <span class="yellow">commit 3cbb6aae5c0cbd711c098e113ae436801371c95e</span>
234 | Author: Scott Chacon &lt;schacon@gmail.com>
235 | Date:   Fri Jun 4 12:58:53 2010 +0200
236 | 
237 |     fixed readme title differently
238 | 
239 | <span class="umber">diff --git a/README b/README
240 | index d053cc8..9103e27 100644
241 | --- a/README
242 | +++ b/README</span>
243 | <span class="lblue">@@ -1,4 +1,4 @@</span>
244 | <span class="red">-Hello World Examples</span>
245 | <span class="green">+Many Hello World Examples</span>
246 |  ======================
247 | 
248 |  This project has examples of hello world in
249 | </pre>
250 | 
251 |     <p>
252 |       这是个总结改动，以及合并或发布之前重审一系列提交的好方式。
253 |     </p>
254 | 
255 |     <h4>
256 |       git log --stat
257 |       <small>显示每个提交引入的改动的差值统计</small>
258 |     </h4>
259 | 
260 |     <p>
261 |       如果 <code>-p</code> 选项对你来说太详细了，你可以用 <code>--stat</code> 总结这些改动。
262 |       这是不用 <code>-p</code>，而用 <code>--stat</code> 选项时，同一份日志的输出。
263 |     </p>
264 | 
265 | <pre>
266 | <b>$ git log --stat --no-merges -2</b>
267 | <span class="yellow">commit 594f90bdee4faf063ad07a4a6f503fdead3ef606</span>
268 | Author: Scott Chacon &lt;schacon@gmail.com>
269 | Date:   Fri Jun 4 15:46:55 2010 +0200
270 | 
271 |     reverted to old class name
272 | 
273 |  ruby.rb |    4 <span class="green">++</span><span class="red">--</span>
274 |  1 files changed, 2 insertions(+), 2 deletions(-)
275 | 
276 | <span class="yellow">commit 3cbb6aae5c0cbd711c098e113ae436801371c95e</span>
277 | Author: Scott Chacon &lt;schacon@gmail.com>
278 | Date:   Fri Jun 4 12:58:53 2010 +0200
279 | 
280 |     fixed readme title differently
281 | 
282 |  README |    2 <span class="green">+</span><span class="red">-</span>
283 |  1 files changed, 1 insertions(+), 1 deletions(-)
284 | </pre>
285 | 
286 |   <p>
287 |   同样的基本信息，但更紧凑 —— 它仍然让你看到相对改动，和改动了哪些文件。
288 |     </p>
289 | 
290 |   </div>
291 | </div>
292 | 
293 | <div class="box">
294 |   <h2>
295 |     <span class="docs">
296 |       <a target="new" href="http://git-scm.com/docs/git-diff">文档</a> &nbsp;
297 |       <a target="new" href="http://git-scm.com/book/en/Distributed-Git-Maintaining-a-Project#Determining-What-Is-Introduced">书</a>
298 |     </span>
299 |     <a name="diff">git diff</a>
300 |     <span class="desc"></span>
301 |   </h2>
302 | 
303 |   <div class="block">
304 | 
305 |     <p>
306 |       最后，要查看两个提交快照的绝对改动，你可以用 <code>git diff</code> 命令。
307 |       这在两个主要情况中广为使用 —— 查看两个分支彼此之间的差值，和查看自发布或者某个旧历史点之后都有啥变了。让我们看看这俩情况。
308 |     </p>
309 | 
310 |     <p>
311 |       你仅需执行 <code>git diff [version]</code>（或者你给该发布打的任何标签）就可以查看自最近发布之后的改动。
312 |       例如，如果我们想要看看自 v0.9 发布之后我们的项目改变了啥，我们可以执行 <code>git diff v0.9</code>
313 |     </p>
314 | 
315 | <pre>
316 | <b>$ git diff v0.9</b>
317 | <span class="umber">diff --git a/README b/README
318 | index d053cc8..d4173d5 100644
319 | --- a/README
320 | +++ b/README</span>
321 | <span class="lblue">@@ -1,4 +1,4 @@</span>
322 | <span class="red">-Hello World Examples</span>
323 | <span class="green">+Many Hello World Lang Examples</span>
324 |  ======================
325 | 
326 |  This project has examples of hello world in
327 | <span class="umber">diff --git a/ruby.rb b/ruby.rb
328 | index bb86f00..192151c 100644
329 | --- a/ruby.rb
330 | +++ b/ruby.rb</span>
331 | <span class="lblue">@@ -1,7 +1,7 @@</span>
332 | <span class="red">-class HiWorld</span>
333 | <span class="green">+class HelloWorld</span>
334 |    def self.hello
335 |      puts "Hello World from Ruby"
336 |    end
337 |  end
338 | 
339 | <span class="red">-HiWorld.hello</span>
340 | <span class="green">+HelloWorld.hello</span>
341 | </pre>
342 | 
343 |     <p>
344 |       正如 <code>git log</code>，你可以给它加上 <code>--stat</code> 参数。
345 |     </p>
346 | 
347 | <pre>
348 | <b>$ git diff v0.9 --stat</b>
349 |  README  |    2 +-
350 |  ruby.rb |    4 ++--
351 |  2 files changed, 3 insertions(+), 3 deletions(-)
352 | </pre>
353 | 
354 |     <p>
355 |       要比较两个不同的分支，你可以执行类似 <code>git diff branchA branchB</code> 的命令。
356 |       不过它的问题在于它会完完全全按你说的作 —— 它会直接给你个补丁文件，该补丁能够将甲分支的最新快照变成乙分支的最新快照的样子。
357 |       这意味着如果两个分支已经产生分歧 —— 奔往两个不同方向了 —— 它会移除甲分支中引入的所有工作，然后累加乙分支中的所有工作。
358 |       这大概不是你要的吧 —— 你想要不在甲分支中的乙分支的改动。所以你真的需要的是两个分支叉开去时，和最新的乙分支的差别。
359 |       所以，如果我们的历史记录看起来像这样：
360 |     </p>
361 | 
362 | <pre>
363 | <b>$ git log --graph --oneline --decorate --all</b>
364 | * 594f90b (HEAD, tag: v1.0, master) reverted to old class name
365 | | * 1834130 (erlang) added haskell
366 | | * ab5ab4c added erlang
367 | |/
368 | *   8d585ea Merge branch 'fix_readme'
369 | ...
370 | </pre>
371 | 
372 |   <p>
373 |   并且，我们想要看“erlang”分支与主分支相比的查别。执行 <code>git diff master erlang</code> 会给我们错误的结果。
374 |   </p>
375 | 
376 | <pre>
377 | <b>$ git diff --stat master erlang</b>
378 |  erlang_hw.erl |    5 +++++
379 |  haskell.hs    |    4 ++++
380 |  ruby.rb       |    4 ++--
381 |  3 files changed, 11 insertions(+), 2 deletions(-)
382 | </pre>
383 | 
384 |     <p>
385 |       你可以看到，它加上了 erlang 和 haskell 文件，这确实是我们在该分支中做的，
386 |       但是它同时恢复了我们在主分支中改动的 ruby 文件。我们真心想要的只是“erlang”分支中的改动（添加两个文件）。
387 |       我们可以通过求两个分支分歧时的共同提交与该分支的差值得到想要的结果：
388 |     </p>
389 | 
390 | <pre>
391 | <b>$ git diff --stat 8d585ea erlang</b>
392 |  erlang_hw.erl |    5 +++++
393 |  haskell.hs    |    4 ++++
394 |  2 files changed, 9 insertions(+), 0 deletions(-)
395 | </pre>
396 | 
397 |     <p>
398 |       这才是我们在找的，但是我们可不想要每次都要找出两个分支分歧时的那次提交。
399 |       幸运的是，Git 为此提供了一个快捷方式。
400 |       如果你执行 <code>git diff master...erlang</code>（在分支名之间有三个半角的点），
401 |       Git 就会自动找出两个分支的共同提交（也被成为合并基础），并求差值。
402 |     </p>
403 | 
404 | <pre>
405 | <b>$ git diff --stat master erlang</b>
406 |  erlang_hw.erl |    5 +++++
407 |  haskell.hs    |    4 ++++
408 |  ruby.rb       |    4 ++--
409 |  3 files changed, 11 insertions(+), 2 deletions(-)
410 | <b>$ git diff --stat master...erlang</b>
411 |  erlang_hw.erl |    5 +++++
412 |  haskell.hs    |    4 ++++
413 |  2 files changed, 9 insertions(+), 0 deletions(-)
414 | </pre>
415 | 
416 |     <p>
417 |       几乎每一次你要对比两个分支的时候，你都会想用三个点的语法，因为它通常会给你你想要的。
418 |     </p>
419 | 
420 |     <p>
421 |       顺带提一句，你还可以让 Git 手工计算两次提交的合并基础（第一个共同的祖提交），即 <code>git merge-base</code> 命令：
422 |     </p>
423 | 
424 | <pre>
425 | <b>$ git merge-base master erlang</b>
426 | 8d585ea6faf99facd39b55d6f6a3b3f481ad0d3d
427 | </pre>
428 | 
429 |     <p>
430 |       所以你执行下面这个也跟 <code>git diff master...erlang</code> 一样：
431 |     </p>
432 | 
433 | <pre>
434 | <b>$ git diff --stat $(git merge-base master erlang) erlang</b>
435 |  erlang_hw.erl |    5 +++++
436 |  haskell.hs    |    4 ++++
437 |  2 files changed, 9 insertions(+), 0 deletions(-)
438 | </pre>
439 | 
440 |     <p>当然，我会推荐简单点的那个。</p>
441 | 
442 | 
443 |     <p class="nutshell">
444 |       <b>简而言之</b> 使用 <code>git diff</code> 查看某一分支自它偏离出来起与过去某一点之间项目的改动。
445 |       总是使用 <code>git diff branchA...branchB</code> 来查看 branchB 与 branchA 的相对差值，这会让事情简单点。
446 |     </p>
447 | 
448 |   </div>
449 | </div>
450 | 
451 | <p>就是这样了！ 请阅读
452 | <a href="http://git-scm.com/book/">《Pro Git》</a> 以获得更多信息。</p>
453 | 


--------------------------------------------------------------------------------
/LICENSE.md:
--------------------------------------------------------------------------------
  1 | # License
  2 | The prose, course text, slide layouts, class outlines, diagrams, HTML, CSS, and Markdown code in the set of educational materials located in this repository are licensed as _CC BY 3.0_. The Octocat, GitHub logo and other already-copyrighted and already-reserved trademarks and images are not covered by this license.
  3 | 
  4 | ------------------------
  5 | 
  6 | # Attribution 3.0 Unported (CC BY 3.0)
  7 | This is a [human-readable summary](http://creativecommons.org/licenses/by/3.0/deed.en_US) of the [Legal Code (the full license)](http://creativecommons.org/licenses/by/3.0/legalcode).
  8 | 
  9 | 
 10 | ## You are free:
 11 | 
 12 | * to Share — to copy, distribute and transmit the work
 13 | * to Remix — to adapt the work
 14 | to make commercial use of the work
 15 | 
 16 | 
 17 | ## Under the following conditions:
 18 | 
 19 | * Attribution — You must attribute the work in the manner specified by the author or licensor (but not in any way that suggests that they endorse you or your use of the work).
 20 | 
 21 | ## With the understanding that:
 22 | 
 23 | * Waiver — Any of the above conditions can be waived if you get permission from the copyright holder.
 24 | * Public Domain — Where the work or any of its elements is in the public domain under applicable law, that status is in no way affected by the license.
 25 | * Other Rights — In no way are any of the following rights affected by the license:
 26 |     * Your fair dealing or fair use rights, or other applicable copyright exceptions and limitations;
 27 |     * The author's moral rights;
 28 |     * Rights other persons may have either in the work itself or in how the work is used, such as publicity or privacy rights.
 29 | 
 30 | Notice — For any reuse or distribution, you must make clear to others the license terms of this work. The best way to do this is with a link to this web page.
 31 | 
 32 | --------------------------------
 33 | 
 34 | # Attribution 3.0 Unported (CC BY 3.0)
 35 | 
 36 | http://creativecommons.org/licenses/by/3.0/legalcode
 37 | 
 38 | CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE LEGAL SERVICES. DISTRIBUTION OF THIS LICENSE DOES NOT CREATE AN ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES REGARDING THE INFORMATION PROVIDED, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM ITS USE.
 39 | 
 40 | License
 41 | 
 42 | THE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CREATIVE COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
 43 | 
 44 | BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. TO THE EXTENT THIS LICENSE MAY BE CONSIDERED TO BE A CONTRACT, THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.
 45 | 
 46 | 1. Definitions
 47 | 
 48 | "Adaptation" means a work based upon the Work, or upon the Work and other pre-existing works, such as a translation, adaptation, derivative work, arrangement of music or other alterations of a literary or artistic work, or phonogram or performance and includes cinematographic adaptations or any other form in which the Work may be recast, transformed, or adapted including in any form recognizably derived from the original, except that a work that constitutes a Collection will not be considered an Adaptation for the purpose of this License. For the avoidance of doubt, where the Work is a musical work, performance or phonogram, the synchronization of the Work in timed-relation with a moving image ("synching") will be considered an Adaptation for the purpose of this License.
 49 | "Collection" means a collection of literary or artistic works, such as encyclopedias and anthologies, or performances, phonograms or broadcasts, or other works or subject matter other than works listed in Section 1(f) below, which, by reason of the selection and arrangement of their contents, constitute intellectual creations, in which the Work is included in its entirety in unmodified form along with one or more other contributions, each constituting separate and independent works in themselves, which together are assembled into a collective whole. A work that constitutes a Collection will not be considered an Adaptation (as defined above) for the purposes of this License.
 50 | "Distribute" means to make available to the public the original and copies of the Work or Adaptation, as appropriate, through sale or other transfer of ownership.
 51 | "Licensor" means the individual, individuals, entity or entities that offer(s) the Work under the terms of this License.
 52 | "Original Author" means, in the case of a literary or artistic work, the individual, individuals, entity or entities who created the Work or if no individual or entity can be identified, the publisher; and in addition (i) in the case of a performance the actors, singers, musicians, dancers, and other persons who act, sing, deliver, declaim, play in, interpret or otherwise perform literary or artistic works or expressions of folklore; (ii) in the case of a phonogram the producer being the person or legal entity who first fixes the sounds of a performance or other sounds; and, (iii) in the case of broadcasts, the organization that transmits the broadcast.
 53 | "Work" means the literary and/or artistic work offered under the terms of this License including without limitation any production in the literary, scientific and artistic domain, whatever may be the mode or form of its expression including digital form, such as a book, pamphlet and other writing; a lecture, address, sermon or other work of the same nature; a dramatic or dramatico-musical work; a choreographic work or entertainment in dumb show; a musical composition with or without words; a cinematographic work to which are assimilated works expressed by a process analogous to cinematography; a work of drawing, painting, architecture, sculpture, engraving or lithography; a photographic work to which are assimilated works expressed by a process analogous to photography; a work of applied art; an illustration, map, plan, sketch or three-dimensional work relative to geography, topography, architecture or science; a performance; a broadcast; a phonogram; a compilation of data to the extent it is protected as a copyrightable work; or a work performed by a variety or circus performer to the extent it is not otherwise considered a literary or artistic work.
 54 | "You" means an individual or entity exercising rights under this License who has not previously violated the terms of this License with respect to the Work, or who has received express permission from the Licensor to exercise rights under this License despite a previous violation.
 55 | "Publicly Perform" means to perform public recitations of the Work and to communicate to the public those public recitations, by any means or process, including by wire or wireless means or public digital performances; to make available to the public Works in such a way that members of the public may access these Works from a place and at a place individually chosen by them; to perform the Work to the public by any means or process and the communication to the public of the performances of the Work, including by public digital performance; to broadcast and rebroadcast the Work by any means including signs, sounds or images.
 56 | "Reproduce" means to make copies of the Work by any means including without limitation by sound or visual recordings and the right of fixation and reproducing fixations of the Work, including storage of a protected performance or phonogram in digital form or other electronic medium.
 57 | 2. Fair Dealing Rights. Nothing in this License is intended to reduce, limit, or restrict any uses free from copyright or rights arising from limitations or exceptions that are provided for in connection with the copyright protection under copyright law or other applicable laws.
 58 | 
 59 | 3. Subject to the terms and conditions of this License, Licensor hereby grants You a worldwide, royalty-free, non-exclusive, perpetual (for the duration of the applicable copyright) license to exercise the rights in the Work as stated below:
 60 | 
 61 | to Reproduce the Work, to incorporate the Work into one or more Collections, and to Reproduce the Work as incorporated in the Collections;
 62 | to create and Reproduce Adaptations provided that any such Adaptation, including any translation in any medium, takes reasonable steps to clearly label, demarcate or otherwise identify that changes were made to the original Work. For example, a translation could be marked "The original work was translated from English to Spanish," or a modification could indicate "The original work has been modified.";
 63 | to Distribute and Publicly Perform the Work including as incorporated in Collections; and,
 64 | to Distribute and Publicly Perform Adaptations.
 65 | 
 66 | For the avoidance of doubt:
 67 |   Non-waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme cannot be waived, the Licensor reserves the exclusive right to collect such royalties for any exercise by You of the rights granted under this License;
 68 |   Waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme can be waived, the Licensor waives the exclusive right to collect such royalties for any exercise by You of the rights granted under this License; and,
 69 |   Voluntary License Schemes. The Licensor waives the right to collect royalties, whether individually or, in the event that the Licensor is a member of a collecting society that administers voluntary licensing schemes, via that society, from any exercise by You of the rights granted under this License.
 70 | 
 71 | The above rights may be exercised in all media and formats whether now known or hereafter devised. The above rights include the right to make such modifications as are technically necessary to exercise the rights in other media and formats. Subject to Section 8(f), all rights not expressly granted by Licensor are hereby reserved.
 72 | 
 73 | 4. Restrictions. The license granted in Section 3 above is expressly made subject to and limited by the following restrictions:
 74 | 
 75 | You may Distribute or Publicly Perform the Work only under the terms of this License. You must include a copy of, or the Uniform Resource Identifier (URI) for, this License with every copy of the Work You Distribute or Publicly Perform. You may not offer or impose any terms on the Work that restrict the terms of this License or the ability of the recipient of the Work to exercise the rights granted to that recipient under the terms of the License. You may not sublicense the Work. You must keep intact all notices that refer to this License and to the disclaimer of warranties with every copy of the Work You Distribute or Publicly Perform. When You Distribute or Publicly Perform the Work, You may not impose any effective technological measures on the Work that restrict the ability of a recipient of the Work from You to exercise the rights granted to that recipient under the terms of the License. This Section 4(a) applies to the Work as incorporated in a Collection, but this does not require the Collection apart from the Work itself to be made subject to the terms of this License. If You create a Collection, upon notice from any Licensor You must, to the extent practicable, remove from the Collection any credit as required by Section 4(b), as requested. If You create an Adaptation, upon notice from any Licensor You must, to the extent practicable, remove from the Adaptation any credit as required by Section 4(b), as requested.
 76 | If You Distribute, or Publicly Perform the Work or any Adaptations or Collections, You must, unless a request has been made pursuant to Section 4(a), keep intact all copyright notices for the Work and provide, reasonable to the medium or means You are utilizing: (i) the name of the Original Author (or pseudonym, if applicable) if supplied, and/or if the Original Author and/or Licensor designate another party or parties (e.g., a sponsor institute, publishing entity, journal) for attribution ("Attribution Parties") in Licensor's copyright notice, terms of service or by other reasonable means, the name of such party or parties; (ii) the title of the Work if supplied; (iii) to the extent reasonably practicable, the URI, if any, that Licensor specifies to be associated with the Work, unless such URI does not refer to the copyright notice or licensing information for the Work; and (iv) , consistent with Section 3(b), in the case of an Adaptation, a credit identifying the use of the Work in the Adaptation (e.g., "French translation of the Work by Original Author," or "Screenplay based on original Work by Original Author"). The credit required by this Section 4 (b) may be implemented in any reasonable manner; provided, however, that in the case of a Adaptation or Collection, at a minimum such credit will appear, if a credit for all contributing authors of the Adaptation or Collection appears, then as part of these credits and in a manner at least as prominent as the credits for the other contributing authors. For the avoidance of doubt, You may only use the credit required by this Section for the purpose of attribution in the manner set out above and, by exercising Your rights under this License, You may not implicitly or explicitly assert or imply any connection with, sponsorship or endorsement by the Original Author, Licensor and/or Attribution Parties, as appropriate, of You or Your use of the Work, without the separate, express prior written permission of the Original Author, Licensor and/or Attribution Parties.
 77 | Except as otherwise agreed in writing by the Licensor or as may be otherwise permitted by applicable law, if You Reproduce, Distribute or Publicly Perform the Work either by itself or as part of any Adaptations or Collections, You must not distort, mutilate, modify or take other derogatory action in relation to the Work which would be prejudicial to the Original Author's honor or reputation. Licensor agrees that in those jurisdictions (e.g. Japan), in which any exercise of the right granted in Section 3(b) of this License (the right to make Adaptations) would be deemed to be a distortion, mutilation, modification or other derogatory action prejudicial to the Original Author's honor and reputation, the Licensor will waive or not assert, as appropriate, this Section, to the fullest extent permitted by the applicable national law, to enable You to reasonably exercise Your right under Section 3(b) of this License (right to make Adaptations) but not otherwise.
 78 | 
 79 | 5. Representations, Warranties and Disclaimer
 80 | 
 81 | UNLESS OTHERWISE MUTUALLY AGREED TO BY THE PARTIES IN WRITING, LICENSOR OFFERS THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE WORK, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT DISCOVERABLE. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO SUCH EXCLUSION MAY NOT APPLY TO YOU.
 82 | 
 83 | 6. Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
 84 | 
 85 | 7. Termination
 86 | 
 87 | This License and the rights granted hereunder will terminate automatically upon any breach by You of the terms of this License. Individuals or entities who have received Adaptations or Collections from You under this License, however, will not have their licenses terminated provided such individuals or entities remain in full compliance with those licenses. Sections 1, 2, 5, 6, 7, and 8 will survive any termination of this License.
 88 | Subject to the above terms and conditions, the license granted here is perpetual (for the duration of the applicable copyright in the Work). Notwithstanding the above, Licensor reserves the right to release the Work under different license terms or to stop distributing the Work at any time; provided, however that any such election will not serve to withdraw this License (or any other license that has been, or is required to be, granted under the terms of this License), and this License will continue in full force and effect unless terminated as stated above.
 89 | 8. Miscellaneous
 90 | 
 91 | Each time You Distribute or Publicly Perform the Work or a Collection, the Licensor offers to the recipient a license to the Work on the same terms and conditions as the license granted to You under this License.
 92 | Each time You Distribute or Publicly Perform an Adaptation, Licensor offers to the recipient a license to the original Work on the same terms and conditions as the license granted to You under this License.
 93 | If any provision of this License is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this License, and without further action by the parties to this agreement, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.
 94 | No term or provision of this License shall be deemed waived and no breach consented to unless such waiver or consent shall be in writing and signed by the party to be charged with such waiver or consent.
 95 | This License constitutes the entire agreement between the parties with respect to the Work licensed here. There are no understandings, agreements or representations with respect to the Work not specified here. Licensor shall not be bound by any additional provisions that may appear in any communication from You. This License may not be modified without the mutual written agreement of the Licensor and You.
 96 | The rights granted under, and the subject matter referenced, in this License were drafted utilizing the terminology of the Berne Convention for the Protection of Literary and Artistic Works (as amended on September 28, 1979), the Rome Convention of 1961, the WIPO Copyright Treaty of 1996, the WIPO Performances and Phonograms Treaty of 1996 and the Universal Copyright Convention (as revised on July 24, 1971). These rights and subject matter take effect in the relevant jurisdiction in which the License terms are sought to be enforced according to the corresponding provisions of the implementation of those treaty provisions in the applicable national law. If the standard suite of rights granted under applicable copyright law includes additional rights not granted under this License, such additional rights are deemed to be included in the License; this License is not intended to restrict the license of any rights under applicable law.
 97 | 
 98 | Creative Commons Notice
 99 | 
100 | Creative Commons is not a party to this License, and makes no warranty whatsoever in connection with the Work. Creative Commons will not be liable to You or any party on any legal theory for any damages whatsoever, including without limitation any general, special, incidental or consequential damages arising in connection to this license. Notwithstanding the foregoing two (2) sentences, if Creative Commons has expressly identified itself as the Licensor hereunder, it shall have all rights and obligations of Licensor.
101 | Except for the limited purpose of indicating to the public that the Work is licensed under the CCPL, Creative Commons does not authorize the use by either party of the trademark "Creative Commons" or any related trademark or logo of Creative Commons without the prior written consent of Creative Commons. Any permitted use will be in compliance with Creative Commons' then-current trademark usage guidelines, as may be published on its website or otherwise made available upon request from time to time. For the avoidance of doubt, this trademark restriction does not form part of this License.
102 | 
103 | Creative Commons may be contacted at http://creativecommons.org/.
104 | 


--------------------------------------------------------------------------------
/basic/index.html:
--------------------------------------------------------------------------------
  1 | ---
  2 | layout: zh_reference
  3 | ---
  4 | 
  5 | <div class="box">
  6 |   <h2>
  7 |     <span class="docs">
  8 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Recording-Changes-to-the-Repository">书</a>
  9 |     </span>
 10 |     基本快照
 11 |   </h2>
 12 |   <div class="block">
 13 |     <p>
 14 |       Git 的工作就是创建和保存你的项目的快照及与之后的快照进行对比。本章将对有关创建与提交你的项目的快照的命令作介绍。
 15 |     </p>
 16 | 
 17 |     <p>
 18 |       这里有个重要的概念，Git 有一个叫做“索引”的东东，有点像是你的快照的缓存区。这就使你能够从更改的文件中创建出一系列组织良好的快照，而不是一次提交所有的更改。
 19 |     </p>
 20 | 
 21 |     <p class="nutshell">
 22 |       <strong>简而言之</strong>，使用 <code>git add</code> 添加需要追踪的新文件和待提交的更改，
 23 |       然后使用 <code>git status</code> 和 <code>git diff</code> 查看有何改动，
 24 |       最后用 <code>git commit</code> 将你的快照记录。这就是你要用的基本流程，绝大部分时候都是这样的。
 25 |     </p>
 26 | 
 27 |   </div>
 28 | </div>
 29 | 
 30 | <div class="box">
 31 |   <h2>
 32 |     <span class="docs">
 33 |       <a target="new" href="http://git-scm.com/docs/git-add">文档</a> &nbsp;
 34 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Recording-Changes-to-the-Repository#Tracking-New-Files">书</a>
 35 |     </span>
 36 |     <a name="add">git add</a>
 37 |     <span class="desc">添加文件到缓存</span>
 38 |   </h2>
 39 | 
 40 |   <div class="block">
 41 |     <p>
 42 |       在 Git 中，在提交你修改的文件之前，你需要把它们添加到缓存。如果该文件是新创建的，你可以执行
 43 |       <code>git add</code> 将该文件添加到缓存，但是，即使该文件已经被追踪了 —— 也就是说，曾经提交过了 ——
 44 |       你仍然需要执行 <cpde>git add</code> 将新更改的文件添加到缓存去。让我们看几个例子：
 45 |     </p>
 46 | 
 47 |     <p>回到我们的 Hello World 示例，初始化该项目之后，我们就要用 <code>git add</code> 将我们的文件添加进去了。
 48 |       我们可以用 <code>git status</code> 看看我们的项目的当前状态。
 49 |     </p>
 50 | 
 51 | <pre>
 52 | <b>$ git status -s</b>
 53 | <span class="red">??</span> README
 54 | <span class="red">??</span> hello.rb
 55 | </pre>
 56 | 
 57 |     <p>我们有俩尚未被追踪的文件，得添加一下。</p>
 58 | 
 59 | <pre>
 60 | <b>$ git add README hello.rb</b>
 61 | </pre>
 62 | 
 63 |     <p>现在我们再执行 <code>git status</code>，就可以看到这俩文件已经加上去了。</p>
 64 | 
 65 | <pre>
 66 | <b>$ git status -s</b>
 67 | <span class="green">A</span>  README
 68 | <span class="green">A</span>  hello.rb
 69 | </pre>
 70 | 
 71 |     <p class="aside">
 72 |       新项目中，添加所有文件很普遍，可以在当前工作目录执行命令：<code>git add .</code>。
 73 |       因为 Git 会递归地将你执行命令时所在的目录中的所有文件添加上去，所以如果你将当前的工作目录作为参数，
 74 |       它就会追踪那儿的所有文件了。如此，<code>git add .</code> 就和 <code>git add README hello.rb</code>
 75 |       有一样的效果。
 76 |       此外，效果一致的还有 <code>git add *</code>，不过那只是因为我们这还木有子目录，不需要递归地添加新文件。
 77 |     </p>
 78 | 
 79 |     <p>好了，现在我们改个文件，再跑一下 <code>git status</code>，有点古怪。</p>
 80 | <pre>
 81 | <b>$ vim README</b>
 82 | <b>$ git status -s</b>
 83 | <span class="green">A</span><span class="red">M</span> README
 84 | <span class="green">A</span>  hello.rb
 85 | </pre>
 86 | 
 87 |     <p>“AM” 状态的意思是，这个文件在我们将它添加到缓存之后又有改动。这意味着如果我们现在提交快照，
 88 |       我们记录的将是上次跑 <code>git add</code> 的时候的文件版本，而不是现在在磁盘中的这个。
 89 |       Git 并不认为磁盘中的文件与你想快照的文件必须是一致的 —— （如果你需要它们一致，）得用 <code>git add</code> 命令告诉它。
 90 |     </p>
 91 | 
 92 |     <p class="nutshell">
 93 |       <strong>一言以蔽之</strong>，
 94 |       当你要将你的修改包含在即将提交的快照里的时候，执行 <code>git add</code>。
 95 |       任何你没有添加的改动都不会被包含在内 —— 这意味着你可以比绝大多数其他源代码版本控制系统更精确地归置你的快照。
 96 |     </p>
 97 | 
 98 |   <p>请查看《Pro Git》中 <code>git add</code> 的 “-p” 参数，以了解更多关于提交文件的灵活性的例子。
 99 |   </p>
100 | 
101 |   </div>
102 | 
103 | </div>
104 | 
105 | <div class="box">
106 |   <h2>
107 |     <span class="docs">
108 |       <a target="new" href="http://git-scm.com/docs/git-status">文档</a> &nbsp;
109 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Recording-Changes-to-the-Repository#Checking-the-Status-of-Your-Files">书</a>
110 |     </span>
111 |     <a name="status">git status</a>
112 |     <span class="desc">查看你的文件在工作目录与缓存的状态</span>
113 |   </h2>
114 | 
115 |   <div class="block">
116 |     <p>正如你在 <code>git add</code> 小节中所看到的，你可以执行 <code>git status</code>
117 |       命令查看你的代码在缓存与当前工作目录的状态。我演示该命令的时候加了 <code>-s</code> 参数，以获得简短的结果输出。
118 |       若没有这个标记，命令 <code>git status</code> 将告诉你更多的提示与上下文欣喜。
119 |       以下便是同样状态下，有跟没有 <code>-s</code> 参数的输出对比。简短的输出如下：
120 |     </p>
121 | 
122 | <pre>
123 | <b>$ git status -s</b>
124 | <span class="green">A</span><span class="red">M</span> README
125 | <span class="green">A</span>  hello.rb
126 | </pre>
127 | 
128 |     <p>而同样的状态，详细的输出看起来是这样的：</p>
129 | 
130 | <pre>
131 | <b>$ git status</b>
132 | # On branch master
133 | #
134 | # Initial commit
135 | #
136 | # Changes to be committed:
137 | #   (use "git rm --cached &lt;file>..." to unstage)
138 | #
139 | # <span class="green">new file:   README</span>
140 | # <span class="green">new file:   hello.rb</span>
141 | #
142 | # Changed but not updated:
143 | #   (use "git add &lt;file>..." to update what will be committed)
144 | #   (use "git checkout -- &lt;file>..." to discard changes in working directory)
145 | #
146 | # <span class="red">modified:   README</span>
147 | #
148 | </pre>
149 | 
150 |     <p>你很容易发现简短的输出看起来很紧凑。而详细输出则很有帮助，提示你可以用何种命令完成你接下来可能要做的事情。
151 |     </p>
152 | 
153 |     <p>Git 还会告诉你在你上次提交之后，有哪些文件被删除、修改或者存入缓存了。</p>
154 | 
155 | <pre>
156 | <b>$ git status -s</b>
157 | <span class="green">M</span>  README
158 |  <span class="red">D</span> hello.rb
159 | </pre>
160 | 
161 |     <p>你可以看到，在简短输出中，有两栏。第一栏是缓存的，第二栏则是工作目录的。
162 |       所以假设你临时提交了 README 文件，然后又改了些，并且没有执行 <code>git add</code>，你会看到这个：</p>
163 | 
164 | <pre>
165 | <b>$ git status -s</b>
166 | <span class="green">M</span><span class="red">M</span> README
167 |  <span class="red">D</span> hello.rb
168 | </pre>
169 | 
170 |     <p class="nutshell">
171 |       <strong>一言以蔽之</strong>，执行 <code>git status</code> 以查看在你上次提交之后有啥被修改或者临时提交了，
172 |       从而决定自己是否需要提交一次快照，同时也能知道有什么改变被记录进去了。
173 |     </p>
174 | 
175 |   </div>
176 | </div>
177 | 
178 | <div class="box">
179 |   <h2>
180 |     <span class="docs">
181 |       <a target="new" href="http://git-scm.com/docs/git-diff">文档</a> &nbsp;
182 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Recording-Changes-to-the-Repository#Viewing-Your-Staged-and-Unstaged-Changes">书</a>
183 |     </span>
184 |     <a name="diff">git diff</a>
185 |     <span class="desc">显示已写入缓存与已修改但尚未写入缓存的改动的区别</span>
186 |   </h2>
187 | 
188 |   <div class="block">
189 |     <p><code>git diff</code> 有两个主要的应用场景。我们将在此介绍其一，
190 |       在 <a href="/inspect">检阅与对照</a> 一章中，我们将介绍其二。
191 |       我们这里介绍的方式是用此命令描述已临时提交的或者已修改但尚未提交的改动。
192 |     </p>
193 | 
194 |     <h4>
195 |       git diff
196 |       <small>#尚未缓存的改动</small>
197 |     </h4>
198 | 
199 |     <p>如果没有其他参数，<code>git diff</code> 会以规范化的 diff 格式（一个补丁）显示自从你上次提交快照之后尚未缓存的所有更改。
200 |     </p>
201 | 
202 | <pre>
203 | <b>$ vim hello.rb</b>
204 | <b>$ git status -s</b>
205 |  <span class="red">M</span> hello.rb
206 | <b>$ git diff</b>
207 | <span class="umber">diff --git a/hello.rb b/hello.rb
208 | index d62ac43..8d15d50 100644
209 | --- a/hello.rb
210 | +++ b/hello.rb</span>
211 | <span class="lblue">@@ -1,7 +1,7 @@</span>
212 |  class HelloWorld
213 | 
214 |    def self.hello
215 | <span class="red">-    puts "hello world"</span>
216 | <span class="green">+    puts "hola mundo"</span>
217 |    end
218 | 
219 |  end
220 | </pre>
221 | 
222 |     <p>所以，<code>git status</code>显示你上次提交更新至后所更改或者写入缓存的改动，
223 |       而 <code>git diff</code> 一行一行地显示这些改动具体是啥。
224 |       通常执行完 <code>git status</code> 之后接着跑一下 <code>git diff</code> 是个好习惯。
225 |     </p>
226 | 
227 |     <h4>
228 |       git diff --cached
229 |       <small>#查看已缓存的改动</small>
230 |     </h4>
231 | 
232 |     <p><code>git diff --cached</code> 命令会告诉你有哪些内容已经写入缓存了。
233 |       也就是说，此命令显示的是接下来要写入快照的内容。所以，如果你将上述示例中的 <code>hello.rb</code>
234 |       写入缓存，因为 <code>git diff</code> 显示的是尚未缓存的改动，所以在此执行它不会显示任何信息。
235 |     </p>
236 | 
237 | <pre>
238 | <b>$ git status -s</b>
239 |  <span class="red">M</span> hello.rb
240 | <b>$ git add hello.rb </b>
241 | <b>$ git status -s</b>
242 | <span class="green">M</span>  hello.rb
243 | <b>$ git diff</b>
244 | <b>$ </b>
245 | </pre>
246 | 
247 |     <p>如果你想看看已缓存的改动，你需要执行的是
248 |     <code>git diff --cached</code>。</p>
249 | 
250 | <pre>
251 | <b>$ git status -s</b>
252 | <span class="green">M</span>  hello.rb
253 | <b>$ git diff</b>
254 | <b>$ </b>
255 | <b>$ git diff --cached</b>
256 | <span class="umber">diff --git a/hello.rb b/hello.rb
257 | index d62ac43..8d15d50 100644
258 | --- a/hello.rb
259 | +++ b/hello.rb</span>
260 | <span class="lblue">@@ -1,7 +1,7 @@</span>
261 |  class HelloWorld
262 | 
263 |    def self.hello
264 | <span class="red">-    puts "hello world"</span>
265 | <span class="green">+    puts "hola mundo"</span>
266 |    end
267 | 
268 |  end
269 | </pre>
270 | 
271 |     <h4>
272 |       git diff HEAD
273 |       <small>查看已缓存的与未缓存的所有改动</small>
274 |     </h4>
275 | 
276 |     <p>如果你想一并查看已缓存的与未缓存的改动，可以执行 <code>git diff HEAD</code> ——
277 |       也就是说你要看到的是工作目录与上一次提交的更新的区别，无视缓存。
278 |       假设我们又改了些 <code>ruby.rb</code> 的内容，那缓存的与未缓存的改动我们就都有了。
279 |       以上三个 <code>diff</code> 命令的结果如下：
280 |     </p>
281 | <pre>
282 | <b>$ vim hello.rb </b>
283 | <b>$ git diff</b>
284 | <span class="umber">diff --git a/hello.rb b/hello.rb
285 | index 4f40006..2ae9ba4 100644
286 | --- a/hello.rb
287 | +++ b/hello.rb</span>
288 | <span class="lblue">@@ -1,7 +1,7 @@</span>
289 |  class HelloWorld
290 | 
291 | <span class="green">+  # says hello</span>
292 |    def self.hello
293 |      puts "hola mundo"
294 |    end
295 | 
296 |  end
297 | <b>$ git diff --cached</b>
298 | <span class="umber">diff --git a/hello.rb b/hello.rb
299 | index 2aabb6e..4f40006 100644
300 | --- a/hello.rb
301 | +++ b/hello.rb</span>
302 | <span class="lblue">@@ -1,7 +1,7 @@</span>
303 |  class HelloWorld
304 | 
305 |    def self.hello
306 | <span class="red">-    puts "hello world"</span>
307 | <span class="green">+    puts "hola mundo"</span>
308 |    end
309 | 
310 |  end
311 | <b>$ git diff HEAD</b>
312 | <span class="umber">diff --git a/hello.rb b/hello.rb
313 | index 2aabb6e..2ae9ba4 100644
314 | --- a/hello.rb
315 | +++ b/hello.rb</span>
316 | <span class="lblue">@@ -1,7 +1,8 @@</span>
317 |  class HelloWorld
318 | 
319 | <span class="green">+  # says hello</span>
320 |    def self.hello
321 | <span class="red">-    puts "hello world"</span>
322 | <span class="green">+    puts "hola mundo"</span>
323 |    end
324 | 
325 |  end
326 | </pre>
327 | 
328 |     <h4>
329 |       git diff --stat
330 |       <small>显示摘要而非整个 diff</small>
331 |     </h4>
332 | 
333 |     <p>如果我们不想要看整个 diff 输出，但是又想比 <code>git status</code> 详细点，
334 |       就可以用 <code>--stat</code> 选项。该选项使它显示摘要而非全文。上文示例在使用 <code>--stat</code> 选项时，输出如下：
335 |     </p>
336 | 
337 | <pre>
338 | <b>$ git status -s</b>
339 | <span class="green">M</span><span class="red">M</span> hello.rb
340 | <b>$ git diff --stat</b>
341 |  hello.rb |    1 <span class="green">+</span>
342 |  1 files changed, 1 insertions(+), 0 deletions(-)
343 | <b>$ git diff --cached --stat</b>
344 |  hello.rb |    2 <span class="green">+</span><span class="red">-</span>
345 |  1 files changed, 1 insertions(+), 1 deletions(-)
346 | <b>$ git diff HEAD --stat</b>
347 |  hello.rb |    3 <span class="green">++</span><span class="red">-</span>
348 |  1 files changed, 2 insertions(+), 1 deletions(-)
349 | </pre>
350 | 
351 |     <p>你还可以在上述命令后面制定一个目录，从而只查看特定文件或子目录的 <code>diff</code> 输出。
352 |     </p>
353 | 
354 | 
355 |     <p class="nutshell">
356 |       <strong>简而言之</strong>，
357 |       执行 <code>git diff</code> 来查看执行 <code>git status</code> 的结果的详细信息 ——
358 |       一行一行地显示这些文件是如何被修改或写入缓存的。
359 |     </p>
360 | 
361 |   </div>
362 | </div>
363 | 
364 | <div class="box">
365 |   <h2>
366 |     <span class="docs">
367 |       <a target="new" href="http://git-scm.com/docs/git-commit">文档</a> &nbsp;
368 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Recording-Changes-to-the-Repository#Committing-Your-Changes">书</a>
369 |     </span>
370 |     <a name="commit">git commit</a>
371 |     <span class="desc">记录缓存内容的快照</span>
372 |   </h2>
373 | 
374 |   <div class="block">
375 | 
376 |     <p>现在你使用 <code>git add</code> 命令将想要快照的内容写入了缓存，
377 |       执行 <code> git commit</code> 就将它实际存储快照了。
378 |       Git 为你的每一个提交都记录你的名字与电子邮箱地址，所以第一步是告诉 Git 这些都是啥。
379 |     </p>
380 | 
381 | <pre>
382 | <b>$ git config --global user.name 'Your Name'</b>
383 | <b>$ git config --global user.email you@somedomain.com</b>
384 | </pre>
385 | 
386 |   <p>让我们写入缓存，并提交对 <code>hello.rb</code> 的所有改动。在首个例子中，我们使用 <code>-m</code> 选项以在命令行中提供提交注释。
387 |     </p>
388 | 
389 | <pre>
390 | <b>$ git add hello.rb </b>
391 | <b>$ git status -s</b>
392 | <span class="green">M</span>  hello.rb
393 | <b>$ git commit -m 'my hola mundo changes'</b>
394 | [master 68aa034] my hola mundo changes
395 |  1 files changed, 2 insertions(+), 1 deletions(-)
396 | </pre>
397 | 
398 |     <p>现在我们已经记录了快照。如果我们再执行 <code>git status</code>，会看到我们有一个“干净的工作目录”。
399 |       这意味着我们在最近一次提交之后，没有做任何改动 —— 在我们的项目中没有未快照的工作。
400 |     </p>
401 | 
402 | <pre>
403 | <b>$ git status</b>
404 | # On branch master
405 | nothing to commit (working directory clean)
406 | </pre>
407 | 
408 |     <p>如果你漏掉了 <code>-m</code> 选项，Git 会尝试为你打开一个编辑器以填写提交信息。
409 |     如果 Git 在你对它的配置中找不到相关信息，默认会打开 <code>vim</code>。屏幕会像这样：
410 |     </p>
411 | 
412 | <pre>
413 | 
414 | # Please enter the commit message for your changes. Lines starting
415 | # with '#' will be ignored, and an empty message aborts the commit.
416 | # On branch master
417 | # Changes to be committed:
418 | #   (use "git reset HEAD &lt;file>..." to unstage)
419 | #
420 | # modified:   hello.rb
421 | #
422 | ~
423 | ~
424 | ".git/COMMIT_EDITMSG" 9L, 257C
425 | </pre>
426 | 
427 |   <p>在此，你在文件头部添加实际的提交信息。以“#”开头的行都会被无视 ——Git 将 <code> git status</code> 的输出结果放在那儿以提示你都改了、缓存了啥。
428 |     </p>
429 | 
430 |   <p>通常，撰写良好的提交信息是很重要的。以开放源代码项目为例，多多少少以以下格式写你的提示消息是个不成文的规定：
431 |     </p>
432 | 
433 | <pre>
434 | 简短的关于改动的总结（25个字或者更少）
435 | 
436 | 如果有必要，更详细的解释文字。约 36 字时换行。在某些情况下，
437 | 第一行会被作为电子邮件的开头，而剩余的则会作为邮件内容。
438 | 将小结从内容隔开的空行是至关重要的（除非你没有内容）；
439 | 如果这两个待在一起，有些 git 工具会犯迷糊。
440 | 
441 | 空行之后是更多的段落。
442 | 
443 |  - 列表也可以
444 | 
445 |  - 通常使用连字符（-）或者星号（*）来标记列表，前面有个空格，
446 |    在列表项之间有空行，不过这些约定也会有些变化。
447 | 
448 | # Please enter the commit message for your changes. Lines starting
449 | # with '#' will be ignored, and an empty message aborts the commit.
450 | # On branch master
451 | # Changes to be committed:
452 | #   (use "git reset HEAD &lt;file>..." to unstage)
453 | #
454 | # modified:   hello.rb
455 | #
456 | ~
457 | ~
458 | ~
459 | ".git/COMMIT_EDITMSG" 25L, 884C written
460 | </pre>
461 | 
462 |     <p class="aside">
463 |     提交注解是很重要的。因为 Git 很大一部分能耐就是它在组织本地提交和与他人分享的弹性，
464 |     它很给力地能够让你为逻辑独立的改变写三到四条提交注解，以便你的工作被同仁审阅。因为提交与推送改动是有区别的，
465 |     请务必花时间将各个逻辑独立的改动放到另外一个提交，并附上一份良好的提交注解，
466 |     以使与你合作的人能够方便地了解你所做的，以及你为何要这么做。
467 |     </p>
468 | 
469 |     <h4>
470 |       git commit -a
471 |       <small>自动将在提交前将已记录、修改的文件放入缓存区</small>
472 |     </h4>
473 | 
474 |     <p>如果你觉得 <code>git add</code> 提交缓存的流程太过繁琐，Git 也允许你用 <code>-a</code> 选项跳过这一步。
475 |       基本上这句话的意思就是，为任何已有记录的文件执行 <code>git add</code> ——
476 |       也就是说，任何在你最近的提交中已经存在，并且之后被修改的文件。
477 |       这让你能够用更 Subversion 方式的流程，修改些文件，然后想要快照所有所做的改动的时候执行 <code>git commit -a</code>。
478 |       不过你仍然需要执行 <code>git add</code> 来添加新文件，就像 Subversion 一样。
479 |     </p>
480 | 
481 | <pre>
482 | <b>$ vim hello.rb</b>
483 | <b>$ git status -s</b>
484 |  <span class="red">M</span>  hello.rb
485 | <b>$ git commit -m 'changes to hello file'</b>
486 | # On branch master
487 | # Changed but not updated:
488 | #   (use "git add &lt;file>..." to update what will be committed)
489 | #   (use "git checkout -- &lt;file>..." to discard changes in working directory)
490 | #
491 | # modified:   hello.rb
492 | #
493 | <span class="hl">no changes added to commit (use "git add" and/or "git commit -a")</span>
494 | <b>$ git commit -am 'changes to hello file'</b>
495 | [master 78b2670] changes to hello file
496 |  1 files changed, 2 insertions(+), 1 deletions(-)
497 | </pre>
498 | 
499 |     <p>注意，如果你不缓存改动，直接执行 <code>git commit</code>，Git 会直接给出 <code>git status</code>
500 |      命令的输出，提醒你啥也没缓存。我已将该消息中的重要部分高亮，它说没有添加需要提交的缓存。
501 |      如果你使用 <code>-a</code>，它会缓存并提交每个改动（不含新文件）。
502 |     </p>
503 | 
504 |     <p>
505 |     现在你就完成了整个快照的流程 ——改些文件，然后用 <code>git add</code> 将要提交的改动提交到缓存，
506 |     用 <code>git status</code> 和 <code>git diff</code> 看看你都改了啥，最后 <code>git commit</code> 永久地保存快照。
507 |     </p>
508 | 
509 |     <p class="nutshell">
510 |   <strong>简而言之</strong>，执行 <code>git commit</code> 记录缓存区的快照。如果需要的话，这个快照可以用来做比较、共享以及恢复。
511 |     </p>
512 | 
513 |   </div>
514 | </div>
515 | 
516 | <div class="box">
517 |   <h2>
518 |     <span class="docs">
519 |       <a target="new" href="http://git-scm.com/docs/git-reset">文档</a> &nbsp;
520 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Undoing-Things#Unstaging-a-Staged-File">书</a>
521 |     </span>
522 |     <a name="reset">git reset HEAD</a>
523 |     <span class="desc">取消缓存已缓存的内容</span>
524 |   </h2>
525 | 
526 |   <div class="block">
527 |     <p><code>git reset</code> 可能是人类写的最费解的命令了。
528 |       我用 Git 有些年头了，甚至还写了本书，但有的时候还是会搞不清它会做什么。
529 |       所以，我只说三个明确的，通常有用的调用。请你跟我一样尽管用它 —— 因为它可以很有用。
530 |     </p>
531 | 
532 |     <p>在此例中，我们可以用它来将不小心缓存的东东取消缓存。假设你修改了两个文件，想要将它们记录到两个不同的提交中去。
533 |       你应该缓存并提交一个，再缓存并提交另外一个。如果你不小心两个都缓存了，那要如何才能<i>取消</i>缓存呢？
534 |       你可以用 <code>git reset HEAD -- file</code>。
535 |       技术上说，在这里你不需要使用 <code>--</code> —— 它用来告诉 Git 这时你已经不再列选项，剩下的是文件路径了。
536 |       不过养成使用它分隔选项与路径的习惯很重要，即使在你可能并不需要的时候。
537 |     </p>
538 | 
539 |     <p>好，让我们看看取消缓存是什么样子的。这里我们有两个最近提交之后又有所改动的文件。我们将两个都缓存，并取消缓存其中一个。</p>
540 | 
541 | <pre>
542 | <b>$ git status -s</b>
543 |  <span class="red">M</span> README
544 |  <span class="red">M</span> hello.rb
545 | <b>$ git add .</b>
546 | <b>$ git status -s</b>
547 | <span class="green">M</span>  README
548 | <span class="green">M</span>  hello.rb
549 | <b>$ git reset HEAD -- hello.rb </b>
550 | Unstaged changes after reset:
551 | M hello.rb
552 | <b>$ git status -s</b>
553 | <span class="green">M</span>  README
554 |  <span class="red">M</span> hello.rb
555 | </pre>
556 | 
557 |     <p>
558 |     现在你执行 <code>git commit</code> 将只记录 <code>README</code> 文件的改动，并不含现在并不在缓存中的 <code>hello.rb</code>。
559 |     </p>
560 | 
561 |     <p class="aside">
562 |     如果你好奇，它实际的操作是将该文件在“索引”中的校验和重置为最近一次提交中的值。
563 |     <code>git add</code> 会计算一个文件的校验和，将它添加到“索引”中，
564 |     而 <code>git reset HEAD</code> 将它改写回原先的，从而取消缓存操作。
565 |     </p>
566 | 
567 |     <p class="tip">
568 |     如果你想直接执行 <code>git unstage</code>，你可以在 Git 中配置个别名。
569 |     执行 <code>git config --global alias.unstage "reset HEAD"</code> 即可。
570 |     一旦执行完它，你就可以直接用 <code>git unstage [file]</code> 作为代替了。
571 |     </p>
572 | 
573 |     <p>如果你忘了取消缓存的命令，Git 的常规 <code>git status</code> 输出的提示会很有帮助。
574 |       例如，在你有已缓存的文件时，如果你不带 <code>-s</code> 执行 <code>git status</code>，它将告诉你怎样取消缓存：
575 |     </p>
576 | 
577 | <pre>
578 | <b>$ git status</b>
579 | # On branch master
580 | # Changes to be committed:
581 | #   <span class="hl">(use "git reset HEAD &lt;file>..." to unstage)</span>
582 | #
583 | #   <span class="green">modified:   README</span>
584 | #   <span class="green">modified:   hello.rb</span>
585 | #
586 | </pre>
587 | 
588 |     <p class="nutshell">
589 |   <strong>简而言之</strong>，执行 <code>git reset HEAD</code> 以取消之前 <code>git add</code> 添加，但不希望包含在下一提交快照中的缓存。
590 |     </p>
591 | 
592 |   </div>
593 | </div>
594 | 
595 | <div class="box">
596 |   <h2>
597 |     <span class="docs">
598 |       <a href="http://git-scm.com/docs/git-rm">文档</a> &nbsp;
599 |       <a href="http://git-scm.com/book/en/Git-Basics-Recording-Changes-to-the-Repository#Removing-Files">书</a>
600 |     </span>
601 |     <a name="rm-mv">git rm</a>
602 |     <span class="desc">将文件从缓存区移除</span>
603 |   </h2>
604 | 
605 |   <div class="block">
606 | 
607 |     <p>
608 |     <code>git rm</code> 会将条目从缓存区中移除。这与 <code>git reset HEAD</code> 将条目取消缓存是有区别的。
609 |     “取消缓存”的意思就是将缓存区恢复为我们做出修改之前的样子。
610 |     在另一方面，<code>git rm</code> 则将该文件彻底从缓存区踢出，因此它不再下一个提交快照之内，进而有效地删除它。
611 |     </p>
612 | 
613 |     <p>
614 |     默认情况下，<code>git rm file</code> 会将文件从缓存区和你的硬盘中（工作目录）删除。
615 |     如果要在工作目录中留着该文件，可以使用 <code>git rm --cached</code>
616 |     </p>
617 | 
618 |     <h4>
619 |       git mv
620 |       <small>git rm --cached orig; mv orig new; git add new</small>
621 |     </h4>
622 | 
623 |     <p>
624 |     不像绝大多数其他版本控制系统，Git 并不记录记录文件重命名。它反而只记录快照，并对比快照以找到有啥文件可能被重命名了。
625 |     如果一个文件从更新中删除了，而在下次快照中新添加的另一个文件的内容与它很相似，Git 就知道这极有可能是个重命名。
626 |     因此，虽然有 <code>git mv</code> 命令，但它有点多余 —— 它做得所有事情就是 <code>git rm --cached</code>，
627 |     重命名磁盘上的文件，然后再执行 <code>git add</code> 把新文件添加到缓存区。
628 |     你并不需要用它，不过如果觉得这样容易些，尽管用吧。
629 |     </p>
630 | 
631 |     <p class="aside">
632 |     我自己并不使用此命令的普通形式 —— 删除文件。通常直接从硬盘删除文件，然后执行 <code>git commit -a</code> 会简单些。
633 |     它会自动将删除的文件从索引中移除。
634 |     </p>
635 | 
636 |     <p class="nutshell">
637 |     <strong>简而言之</strong>，
638 |     执行 <code>git rm</code> 来删除 Git 追踪的文件。它还会删除你的工作目录中的相应文件。
639 |     </p>
640 | 
641 |   </div>
642 | </div>
643 | 
644 | <p><a href="/branching">到 分支与合并 &#187;</a></p>
645 | 
646 | 


--------------------------------------------------------------------------------
/branching/index.html:
--------------------------------------------------------------------------------
  1 | ---
  2 | layout: zh_reference
  3 | ---
  4 | 
  5 | <div class="box">
  6 |   <h2>
  7 |     <span class="docs">
  8 |       <a target="new" href="http://git-scm.com/book/en/Git-Branching">书</a>
  9 |     </span>
 10 |     分支与合并
 11 |   </h2>
 12 |   <div class="block">
 13 |     <p>分支是我最喜欢的 Git 特性之一。如果你用过其他版本控制系统，把你所知的分支给忘记，倒可能更有帮助些 ——
 14 |       事实上，以我们使用分支的方式，把 Git 的分支看作 <i>上下文</i> 反而更合适。
 15 |       当你检出分支时，你可以在两三个不同的分支之间来回切换。
 16 |     </p>
 17 | 
 18 |     <p class="nutshell">
 19 |       <b>简而言之</b>，你可以执行 <code>git branch (branchname)</code> 来创建分支，
 20 |       使用 <code>git checkout (branchname)</code> 命令切换到该分支，在该分支的上下文环境中，
 21 |       提交快照等，之后可以很容易地来回切换。当你切换分支的时候，Git 会用该分支的最后提交的快照替换你的工作目录的内容，
 22 |       所以多个分支不需要多个目录。使用 <code>git merge</code> 来合并分支。你可以多次合并到统一分支，
 23 |       也可以选择在合并之后直接删除被并入的分支。
 24 |     </p>
 25 | 
 26 |   </div>
 27 | </div>
 28 | 
 29 | <div class="box">
 30 |   <h2>
 31 |     <span class="docs">
 32 |       <a target="new" href="http://git-scm.com/docs/git-branch">文档</a> &nbsp;
 33 |       <a target="new" href="http://git-scm.com/book/en/Git-Branching-What-a-Branch-Is">书</a>
 34 |     </span>
 35 |     <a name="branch">git branch</a>
 36 |     <span class="desc">列出、创建与管理工作上下文</span>
 37 |   </h2>
 38 | 
 39 |   <br/>
 40 | 
 41 |   <h2>
 42 |     <span class="docs">
 43 |       <a target="new" href="http://git-scm.com/docs/git-checkout">文档</a> &nbsp;
 44 |       <a target="new" href="http://git-scm.com/book/en/Git-Branching-Basic-Branching-and-Merging">书</a>
 45 |     </span>
 46 |     <a name="checkout">git checkout</a>
 47 |     <span class="desc">切换到新的分支上下文</span>
 48 |   </h2>
 49 | 
 50 |   <div class="block">
 51 |     <p><code>git branch</code> 命令是 Git 中的通用分支管理工具，可以通过它完成多项任务。
 52 |       我们先说你会用到的最多的命令 —— 列出分支、创建分支和删除分支。
 53 |       我们还会介绍用来切换分支的 <code>git checkout</code> 命令。
 54 |     </p>
 55 | 
 56 |     <h4>
 57 |       git branch
 58 |       <small>列出可用的分支</small>
 59 |     </h4>
 60 | 
 61 |     <p>没有参数时，<code>git branch</code> 会列出你在本地的分支。你所在的分支的行首会有个星号作标记。
 62 |       如果你开启了<a href="http://git-scm.com/book/en/Customizing-Git-Git-Configuration#Colors-in-Git">彩色模式</a>，当前分支会用绿色显示。
 63 |     </p>
 64 | 
 65 | <pre>
 66 | $ git branch
 67 | * <span class="green">master</span>
 68 | </pre>
 69 | 
 70 |     <p>此例的意思就是，我们有一个叫做“master”的分支，并且该分支是当前分支。
 71 |       当你执行 <code>git init</code> 的时候，缺省情况下 Git 就会为你创建“master”分支。
 72 |       但是这名字一点特殊意味都没有 —— 事实上你并不非得要一个叫做“master”的分支。
 73 |       不过由于它是缺省分支名的缘故，绝大部分项目都有这个分支。
 74 |     </p>
 75 | 
 76 |     <h4>
 77 |       git branch (branchname)
 78 |       <small>创建新分支</small>
 79 |     </h4>
 80 | 
 81 |     <p>我们动手创建一个分支，并切换过去。执行 <code>git branch (branchname)</code> 即可。
 82 | 	</p>
 83 | 
 84 | <pre>
 85 | $ git branch testing
 86 | $ git branch
 87 | * <span class="green">master</span>
 88 |   testing
 89 | </pre>
 90 | 
 91 |     <p>现在我们可以看到，有了一个新分支。当你以此方式在上次提交更新之后创建了新分支，如果后来又有更新提交，
 92 |       然后又切换到了“testing”分支，Git 将还原你的工作目录到你创建分支时候的样子 ——
 93 |       你可以把它看作一个记录你当前进度的书签。让我们实际运用看看 ——
 94 |       我们用 <code>git checkout (branch)</code> 切换到我们要修改的分支。
 95 |     </p>
 96 | 
 97 | <pre>
 98 | <b>$ ls</b>
 99 | README   hello.rb
100 | <b>$ echo 'test content' > test.txt</b>
101 | <b>$ echo 'more content' > more.txt</b>
102 | <b>$ git add *.txt</b>
103 | <b>$ git commit -m 'added two files'</b>
104 | [master 8bd6d8b] added two files
105 |  2 files changed, 2 insertions(+), 0 deletions(-)
106 |  create mode 100644 more.txt
107 |  create mode 100644 test.txt
108 | <b>$ ls</b>
109 | README   hello.rb more.txt test.txt
110 | <b>$ git checkout testing</b>
111 | Switched to branch 'testing'
112 | <b>$ ls</b>
113 | README   hello.rb
114 | </pre>
115 | 
116 |     <p>当我们切换到“测试”分支的时候，我们添加的新文件被移除了。切换回“master”分支的时候，它们又重新出现了。
117 |     </p>
118 | 
119 | <pre>
120 | <b>$ ls</b>
121 | README   hello.rb
122 | <b>$ git checkout master</b>
123 | Switched to branch 'master'
124 | <b>$ ls</b>
125 | README   hello.rb more.txt test.txt
126 | </pre>
127 | 
128 |     <h4>
129 |       git checkout -b (branchname)
130 |       <small>创建新分支，并立即切换到它</small>
131 |     </h4>
132 | 
133 |     <p>
134 |       通常情况下，你会更希望立即切换到新分支，从而在该分支中操作，然后当此分支的开发日趋稳定时，
135 |       将它合并到稳定版本的分支（例如“master”）中去。
136 |       执行 <code>git branch newbranch; git checkout newbranch</code> 也很简单，
137 |       不过 Git 还为你提供了快捷方式：<code>git checkout -b newbranch</code>。
138 |     </p>
139 | 
140 | <pre>
141 | <b>$ git branch</b>
142 | * master
143 | <b>$ ls</b>
144 | README   hello.rb more.txt test.txt
145 | <b>$ git checkout -b removals</b>
146 | Switched to a new branch 'removals'
147 | <b>$ git rm more.txt </b>
148 | rm 'more.txt'
149 | <b>$ git rm test.txt </b>
150 | rm 'test.txt'
151 | <b>$ ls</b>
152 | README   hello.rb
153 | <b>$ git commit -am 'removed useless files'</b>
154 | [removals 8f7c949] removed useless files
155 |  2 files changed, 0 insertions(+), 2 deletions(-)
156 |  delete mode 100644 more.txt
157 |  delete mode 100644 test.txt
158 | <b>$ git checkout master</b>
159 | Switched to branch 'master'
160 | <b>$ ls</b>
161 | README   hello.rb more.txt test.txt
162 | </pre>
163 | 
164 |     <p>如你所见，我们创建了一个分支，在该分支的上下文中移除了一些文件，然后切换回我们的主分支，那些文件又回来了。
165 |       使用分支将工作切分开来，从而让我们能够在不同上下文中做事，并来回切换。
166 |     </p>
167 | 
168 |     <p>
169 |       创建新分支，在其中完成一部分工作，完成之后将它合并到主分支并删除。你会觉得这很方便，因为这么做很快很容易。
170 |       如此，当你觉得这部分工作并不靠谱，舍弃它很容易。并且，如果你必须回到稳定分支做些事情，
171 |       也可以很方便地这个独立分支的工作先丢在一边，完成要事之后再切换回来。
172 |     </p>
173 | 
174 |     <h4>
175 |       git branch -d (branchname)
176 |       <small>删除分支</small>
177 |     </h4>
178 | 
179 |     <p>假设我们要删除一个分支（比如上例中的“testing”分支，该分支没啥特殊的内容了），
180 |       可以执行 <code>git branch -d (branch)</code> 把它删掉。
181 |     </p>
182 | 
183 | <pre>
184 | <b>$ git branch</b>
185 | * <span class="green">master</span>
186 |   testing
187 | <b>$ git branch -d testing</b>
188 | Deleted branch testing (was 78b2670).
189 | <b>$ git branch</b>
190 | * <span class="green">master</span>
191 | </pre>
192 | 
193 |     <p class="nutshell">
194 |       <b>简而言之</b> 使用 <code>git branch</code> 列出现有的分支、创建新分支以及删除不必要或者已合并的分支。
195 |     </p>
196 | 
197 |   </div>
198 | </div>
199 | 
200 | <div class="box">
201 |   <h2>
202 |     <span class="docs">
203 |       <a target="new" href="http://git-scm.com/docs/git-merge">docs</a> &nbsp;
204 |       <a target="new" href="http://git-scm.com/book/en/Git-Branching-Basic-Branching-and-Merging#Basic-Merging">book</a>
205 |     </span>
206 |     <a name="merge">git merge</a>
207 |     <span class="desc">将分支合并到你的当前分支</span>
208 |   </h2>
209 | 
210 |   <div class="block">
211 |     <p>一旦某分支有了独立内容，你终究会希望将它合并回到你的主分支。
212 |       你可以使用 <code>git merge</code> 命令将任何分支合并到当前分支中去。
213 |       我们那上例中的“removals”分支为例。假设我们创建了一个分支，移除了一些文件，并将它提交到该分支，
214 |       其实该分支是与我们的主分支（也就是“master”）独立开来的。
215 |       要想将这些移除操作包含在主分支中，你可以将“removals”分支合并回去。
216 |     </p>
217 | 
218 | <pre>
219 | <b>$ git branch</b>
220 | * <span class="green">master</span>
221 |   removals
222 | <b>$ ls</b>
223 | README   hello.rb more.txt test.txt
224 | <b>$ git merge removals</b>
225 | Updating 8bd6d8b..8f7c949
226 | Fast-forward
227 |  more.txt |    1 -
228 |  test.txt |    1 -
229 |  2 files changed, 0 insertions(+), 2 deletions(-)
230 |  delete mode 100644 more.txt
231 |  delete mode 100644 test.txt
232 | <b>$ ls</b>
233 | <span class="hl">README   hello.rb</span>
234 | </pre>
235 | 
236 |     <h4>
237 |       更多复杂合并
238 |     </h4>
239 | 
240 |     <p>当然，合并并不仅仅是简单的文件添加、移除的操作，Git 也会合并修改 —— 事实上，它很会合并修改。
241 |       举例，我们看看在某分支中编辑某个文件，然后在另一个分支中把它的名字改掉再做些修改，
242 |       最后将这俩分支合并起来。你觉得会变成一坨 shi？我们试试看。
243 |     </p>
244 | 
245 | <pre>
246 | <b>$ git branch</b>
247 | * master
248 | <b>$ cat hello.rb </b>
249 | class HelloWorld
250 |   def self.hello
251 |     puts "Hello World"
252 |   end
253 | end
254 | 
255 | HelloWorld.hello
256 | </pre>
257 | 
258 |     <p>首先，我们创建一个叫做“change_class”的分支，切换过去，从而将重命名类等操作独立出来。我们将类名从 “HelloWorld” 改为 “HiWorld”。
259 |     </p>
260 | 
261 | <pre>
262 | <b>$ git checkout -b change_class</b>
263 | M hello.rb
264 | Switched to a new branch 'change_class'
265 | <b>$ vim hello.rb </b>
266 | <b>$ head -1 hello.rb </b>
267 | class HiWorld
268 | <b>$ git commit -am 'changed the class name'</b>
269 | [change_class 3467b0a] changed the class name
270 |  1 files changed, 2 insertions(+), 4 deletions(-)
271 | </pre>
272 | 
273 |     <p>然后，将重命名类操作提交到 “change_class” 分支中。
274 |       现在，假如切换回 “master” 分支我们可以看到类名恢复到了我们切换到 “change_class” 分支之前的样子。
275 |       现在，再做些修改（即代码中的输出），同时将文件名从 <code>hello.rb</code> 改为 <code>ruby.rb</code>。
276 |     </p>
277 | 
278 | <pre>
279 | <b>$ git checkout master</b>
280 | Switched to branch 'master'
281 | <b>$ git mv hello.rb ruby.rb</b>
282 | <b>$ vim ruby.rb </b>
283 | <b>$ git diff</b>
284 | <span class="umber">diff --git a/ruby.rb b/ruby.rb
285 | index 2aabb6e..bf64b17 100644
286 | --- a/ruby.rb
287 | +++ b/ruby.rb</span>
288 | <span class="lblue">@@ -1,7 +1,7 @@</span>
289 |  class HelloWorld
290 | 
291 |    def self.hello
292 | <span class="red">-    puts "Hello World"</span>
293 | <span class="green">+    puts "Hello World from Ruby"</span>
294 |    end
295 | 
296 |  end
297 | <b>$ git commit -am 'added from ruby'</b>
298 | [master b7ae93b] added from ruby
299 |  1 files changed, 1 insertions(+), 1 deletions(-)
300 |  rename hello.rb => ruby.rb (65%)
301 | </pre>
302 | 
303 |     <p>现在这些改变已经记录到我的 “master” 分支了。请注意，这里类名还是 “HelloWorld”，而不是 “HiWorld”。
304 |       然后我想将类名的改变合并过来，我把 “change_class” 分支合并过来就行了。
305 |       但是，我已经将文件名都改掉了，Git 知道该怎么办么？
306 |     </p>
307 | 
308 | <pre>
309 | <b>$ git branch</b>
310 |   change_class
311 | * master
312 | <b>$ git merge change_class</b>
313 | Renaming hello.rb => ruby.rb
314 | Auto-merging ruby.rb
315 | Merge made by recursive.
316 |  ruby.rb |    6 ++----
317 |  1 files changed, 2 insertions(+), 4 deletions(-)
318 | <b>$ cat ruby.rb</b>
319 | class HiWorld
320 |   def self.hello
321 |     puts "Hello World from Ruby"
322 |   end
323 | end
324 | 
325 | HiWorld.hello
326 | </pre>
327 | 
328 |     <p>不错，它就是发现了。请注意，在这部操作，我没有遇到合并冲突，并且文件已经重命名、类名也换掉了。挺酷。
329 |     </p>
330 | 
331 |     <h4>
332 |       合并冲突
333 |     </h4>
334 | 
335 |     <p>那么，Git 合并很有魔力，我们再也不用处理合并冲突了，对吗？不太确切。
336 |       不同分支中修改了相同区块的代码，电脑自己猜不透神马的情况下，冲突就摆在我们面前了。
337 |       我们看看两个分支中改了同一行代码的例子。
338 |     </p>
339 | 
340 | <pre>
341 | <b>$ git branch</b>
342 | * master
343 | <b>$ git checkout -b fix_readme</b>
344 | Switched to a new branch 'fix_readme'
345 | <b>$ vim README </b>
346 | <b>$ git commit -am 'fixed readme title'</b>
347 | [fix_readme 3ac015d] fixed readme title
348 |  1 files changed, 1 insertions(+), 1 deletions(-)
349 | </pre>
350 | 
351 |     <p>我们在某分支中修改了 README 文件中的一行，并提交了。我们再在 “master” 分支中对同个文件的同一行内容作不同的修改。
352 |     </p>
353 | 
354 | <pre>
355 | <b>$ git checkout master</b>
356 | Switched to branch 'master'
357 | <b>$ vim README </b>
358 | <b>$ git commit -am 'fixed readme title differently'</b>
359 | [master 3cbb6aa] fixed readme title differently
360 |  1 files changed, 1 insertions(+), 1 deletions(-)
361 | </pre>
362 | 
363 |     <p>有意思的来了 —— 我们将前一个分支合并到 “master” 分支，一个合并冲突就出现了。
364 |       </p>
365 | 
366 | <pre>
367 | <b>$ git merge fix_readme</b>
368 | Auto-merging README
369 | CONFLICT (content): Merge conflict in README
370 | Automatic merge failed; fix conflicts and then commit the result.
371 | <b>$ cat README </b>
372 | <<<<<<< HEAD
373 | Many Hello World Examples
374 | =======
375 | Hello World Lang Examples
376 | >>>>>>> fix_readme
377 | 
378 | This project has examples of hello world in
379 | nearly every programming language.
380 | </pre>
381 | 
382 |     <p>你可以看到，Git 在产生合并冲突的地方插入了标准的与 Subversion 很像的合并冲突标记。
383 |       轮到我们去解决这些冲突了。在这里我们就手动把它解决。如果你要 Git 打开一个图形化的合并工具，
384 |       可以看看 <a href="http://git-scm.com/docs/git-mergetool">git 合并工具</a>
385 |       （比如 kdiff3、emerge、p4merge 等）。
386 |     </p>
387 | 
388 | <pre>
389 | <b>$ vim README </b>  <span class="exp">here I'm fixing the conflict</span>
390 | <b>$ git diff</b>
391 | <span class="umber">diff --cc README
392 | index 9103e27,69cad1a..0000000
393 | --- a/README
394 | +++ b/README</span>
395 | <span class="lblue">@@@ -1,4 -1,4 +1,4 @@@</span>
396 | <span class="red">- Many Hello World Examples</span>
397 |  <span class="red">-Hello World Lang Examples</span>
398 | <span class="green">++Many Hello World Lang Examples</span>
399 | 
400 |   This project has examples of hello world in
401 | </pre>
402 | 
403 |     <p>在 Git 中，处理合并冲突的时候有个很酷的提示。
404 |       如果你执行 <code>git diff</code>，就像我演示的这样，它会告诉你冲突的两方，和你是如何解决的。
405 |       现在是时候把它标记为已解决了。在 Git 中，我们可以用 <code>git add</code> —— 要告诉 Git 文件冲突已经解决，你必须把它写入缓存区。
406 |     </p>
407 | 
408 | <pre>
409 | <b>$ git status -s</b>
410 | UU README
411 | <b>$ git add README </b>
412 | <b>$ git status -s</b>
413 | M  README
414 | <b>$ git commit </b>
415 | [master 8d585ea] Merge branch 'fix_readme'
416 | </pre>
417 | 
418 |     <p>现在我们成功解决了合并中的冲突，并提交了结果
419 |     </p>
420 | 
421 |     <p class="nutshell">
422 |       <b>简而言之</b> 使用 <code>git merge</code> 将另一个分支并入当前的分支中去。
423 |       Git 会自动以最佳方式将两个不同快照中独特的工作合并到一个新快照中去。
424 |     </p>
425 | 
426 |   </div>
427 | </div>
428 | 
429 | <div class="box">
430 |   <h2>
431 |     <span class="docs">
432 |       <a target="new" href="http://git-scm.com/docs/git-log">文档</a> &nbsp;
433 |       <a target="new" href="http://git-scm.com/book/en/Git-Tools-Revision-Selection#Commit-Ranges">书</a>
434 |     </span>
435 |     <a name="log">git log</a>
436 |     <span class="desc">显示一个分支中提交的更改记录</span>
437 |   </h2>
438 | 
439 |   <div class="block">
440 | 
441 |     <p>到目前为止，我们已经提交快照到项目中，在不同的各自分离的上下文中切换，
442 |       但假如我们忘了自己是如何到目前这一步的那该怎么办？或者假如我们想知道此分支与彼分支到底有啥区别？
443 |       Git 提供了一个告诉你使你达成当前快照的所有提交消息的工具，叫做 <code>git log</code>。
444 |     </p>
445 | 
446 |     <p>要理解日志（log）命令，你需要了解当执行 <code>git commit</code> 以存储一个快照的时候，都有啥信息被保存了。
447 |       除了文件详单、提交消息和提交者的信息，Git 还保存了你的此次提交所基于的快照。
448 |       也就是，假如你克隆了一个项目，你是在什么快照的基础上做的修改而得到新保存的快照的？
449 |       这有益于为项目进程提供上下文，使 Git 能够弄明白谁做了什么改动。
450 |       如果 Git 有你的快照所基于的快照的话，它就能自动判断你都改变了什么。而新提交所基于的提交，被称作新提交的“父亲”。
451 |     </p>
452 | 
453 |     <p>某分支的按时间排序的“父亲”列表，当你在该分支时，可以执行 <code>git log</code> 以查看。
454 |       例如，如果我们在本章中操作的 Hello World 项目中执行 <code>git log</code>，我们可以看到已提交的消息。
455 |     </p>
456 | 
457 | <pre>
458 | <b>$ git log</b>
459 | <span class="yellow">commit 8d585ea6faf99facd39b55d6f6a3b3f481ad0d3d</span>
460 | Merge: 3cbb6aa 3ac015d
461 | Author: Scott Chacon &lt;schacon@gmail.com>
462 | Date:   Fri Jun 4 12:59:47 2010 +0200
463 | 
464 |     Merge branch 'fix_readme'
465 | 
466 |     Conflicts:
467 |         README
468 | 
469 | <span class="yellow">commit 3cbb6aae5c0cbd711c098e113ae436801371c95e</span>
470 | Author: Scott Chacon &lt;schacon@gmail.com>
471 | Date:   Fri Jun 4 12:58:53 2010 +0200
472 | 
473 |     fixed readme title differently
474 | 
475 | <span class="yellow">commit 3ac015da8ade34d4c7ebeffa2053fcac33fb495b</span>
476 | Author: Scott Chacon &lt;schacon@gmail.com>
477 | Date:   Fri Jun 4 12:58:36 2010 +0200
478 | 
479 |     fixed readme title
480 | 
481 | <span class="yellow">commit 558151a95567ba4181bab5746bc8f34bd87143d6</span>
482 | Merge: b7ae93b 3467b0a
483 | Author: Scott Chacon &lt;schacon@gmail.com>
484 | Date:   Fri Jun 4 12:37:05 2010 +0200
485 | 
486 |     Merge branch 'change_class'
487 | ...
488 | </pre>
489 | 
490 |   <p>我们可以用 <code>--oneline</code> 选项来查看历史记录的紧凑简洁的版本。
491 |     </p>
492 | 
493 | <pre>
494 | <b>$ git log --oneline</b>
495 | 8d585ea Merge branch 'fix_readme'
496 | 3cbb6aa fixed readme title differently
497 | 3ac015d fixed readme title
498 | 558151a Merge branch 'change_class'
499 | b7ae93b added from ruby
500 | 3467b0a changed the class name
501 | 17f4acf first commit
502 | </pre>
503 | 
504 |     <p>
505 |       这告诉我们的是，此项目的开发历史。如果提交消息描述性很好，这就能为我们提供关于有啥改动被应用、或者影响了当前快照的状态、以及这快照里头都有啥。
506 |     </p>
507 | 
508 |     <p>我们还可以用它的十分有帮助的 <code>--graph</code> 选项，查看历史中什么时候出现了分支、合并。以下为相同的命令，开启了拓扑图选项：
509 |     </p>
510 | 
511 | <pre>
512 | <b>$ git log --oneline --graph</b>
513 | *   8d585ea Merge branch 'fix_readme'
514 | |\
515 | | * 3ac015d fixed readme title
516 | * | 3cbb6aa fixed readme title differently
517 | |/
518 | *   558151a Merge branch 'change_class'
519 | |\
520 | | * 3467b0a changed the class name
521 | * | b7ae93b added from ruby
522 | |/
523 | * 17f4acf first commit
524 | </pre>
525 | 
526 |     <p>现在我们可以更清楚明了地看到何时工作分叉、又何时归并。
527 |       这对查看发生了什么、应用了什么改变很有帮助，并且极大地帮助你管理你的分支。
528 |       让我们创建一个分支，在里头做些事情，然后切回到主分支，也做点事情，然后看看 <code>log</code>
529 |       命令是如何帮助我们理清这俩分支上都发生了啥的。
530 |     </p>
531 | 
532 |     <p>首先我们创建一个分支，来添加 Erlang 编程语言的 Hello World 示例 ——
533 |       我们想要在一个分支里头做这个，以避免让可能还不能工作的代码弄乱我们的稳定分支。
534 |       这样就可以切来切去，片叶不沾身。
535 |     </p>
536 | 
537 | <pre>
538 | <b>$ git checkout -b erlang</b>
539 | Switched to a new branch 'erlang'
540 | <b>$ vim erlang_hw.erl</b>
541 | <b>$ git add erlang_hw.erl </b>
542 | <b>$ git commit -m 'added erlang'</b>
543 | [erlang ab5ab4c] added erlang
544 |  1 files changed, 5 insertions(+), 0 deletions(-)
545 |  create mode 100644 erlang_hw.erl
546 | </pre>
547 | 
548 |     <p>由于我们玩函数式编程很开心，以至于沉迷其中，又在“erlang”分支中添加了一个 Haskell 的示例程序。
549 |     </p>
550 | 
551 | <pre>
552 | <b>$ vim haskell.hs</b>
553 | <b>$ git add haskell.hs </b>
554 | <b>$ git commit -m 'added haskell'</b>
555 | [erlang 1834130] added haskell
556 |  1 files changed, 4 insertions(+), 0 deletions(-)
557 |  create mode 100644 haskell.hs
558 | </pre>
559 | 
560 |     <p>最后，我们决定还是把 Ruby 程序的类名改回原先的样子。与其创建另一个分支，我们可以返回主分支，改变它，然后直接提交。
561 |     </p>
562 | 
563 | <pre>
564 | <b>$ git checkout master</b>
565 | Switched to branch 'master'
566 | <b>$ ls</b>
567 | README  ruby.rb
568 | <b>$ vim ruby.rb </b>
569 | <b>$ git commit -am 'reverted to old class name'</b>
570 | [master 594f90b] reverted to old class name
571 |  1 files changed, 2 insertions(+), 2 deletions(-)
572 | </pre>
573 | 
574 |     <p>现在假设我们有段时间不做这个项目了，我们做别的去了。
575 |       当我们回来的时候，我们想知道“erlang”分支都是啥，而主分支的进度又是怎样。
576 |       仅仅看分支的名字，我们是无从知道自己还在里面有 Haskell 的改动的，但是用 <code>git log</code> 我们就可以。
577 |       如果你在命令行中提供一个分支名字，它就会显示该分支历史中“可及”的提交，即从该分支创立起可追溯的影响了最终的快照的提交。
578 |     </p>
579 | 
580 | <pre>
581 | <b>$ git log --oneline erlang</b>
582 | <span class="hl">1834130 added haskell</span>
583 | ab5ab4c added erlang
584 | 8d585ea Merge branch 'fix_readme'
585 | 3cbb6aa fixed readme title differently
586 | 3ac015d fixed readme title
587 | 558151a Merge branch 'change_class'
588 | b7ae93b added from ruby
589 | 3467b0a changed the class name
590 | 17f4acf first commit
591 | </pre>
592 | 
593 |     <p>如此，我们很容易就看到分支里头还包括了 Haskell 代码（高亮显示了）。
594 |       更酷的是，我们很容易地告诉 Git，我们只对某个分支中可及的提交感兴趣。换句话说，某分支中与其他分支相比唯一的提交。
595 |     </p>
596 | 
597 |     <p>在此例中，如果我们想要合并“erlang”分支，我们需要看当合并的时候，都有啥提交会作用到我们的快照上去。
598 |       我们告诉 Git 的方式是，在不想要看到的分支前放一个 <code>^</code>。
599 |       例如，如果我们想要看“erlang”分支中但不在主分支中的提交，我们可以用 <code>erlang ^master</code>，或者反之。
600 |     </p>
601 | 
602 | <pre>
603 | <b>$ git log --oneline erlang ^master</b>
604 | 1834130 added haskell
605 | ab5ab4c added erlang
606 | <b>$ git log --oneline master ^erlang</b>
607 | 594f90b reverted to old class name
608 | </pre>
609 | 
610 |     <p>这为我们提供了一个良好的、简易的分支管理工具。它使我们能够非常容易地查看对某个分支唯一的提交，从而知道我们缺少什么，以及当我们要合并时，会有什么被合并进去。
611 |     </p>
612 | 
613 |     <p class="nutshell">
614 |       <b>简而言之</b> 使用 <code>git log</code> 列出促成当前分支目前的快照的提交历史记录。这使你能够看到项目是如何到达现在的状况的。
615 |     </p>
616 | 
617 |   </div>
618 | </div>
619 | 
620 | <div class="box">
621 |   <h2>
622 |     <span class="docs">
623 |       <a target="new" href="http://git-scm.com/docs/git-tag">文档</a> &nbsp;
624 |       <a target="new" href="http://git-scm.com/book/en/Git-Basics-Tagging">书</a>
625 |     </span>
626 |     <a name="tag">git tag</a>
627 |     <span class="desc">给历史记录中的某个重要的一点打上标签</span>
628 |   </h2>
629 | 
630 |   <div class="block">
631 | 
632 |     <p>
633 |       如果你达到一个重要的阶段，并希望永远记住那个特别的提交快照，你可以使用 <code>git tag</code> 给它打上标签。
634 |       该 <code>tag</code> 命令基本上会给该特殊提交打上永久的书签，从而使你在将来能够用它与其他提交比较。
635 |       通常，你会在切取一个发布版本或者交付一些东西的时候打个标签。
636 |     </p>
637 | 
638 |     <p>比如说，我们想为我们的 Hello World 项目发布一个“1.0”版本。
639 |       我们可以用 <code>git tag -a v1.0</code> 命令给最新一次提交打上（<code>HEAD</code>）“v1.0”的标签。
640 |       <code>-a</code> 选项意为“创建一个带注解的标签”，从而使你为标签添加注解。绝大部分时候都会这么做的。
641 |       不用 <code>-a</code> 选项也可以执行的，但它不会记录这标签是啥时候打的，谁打的，也不会让你添加个标签的注解。
642 |       我推荐一直创建带注解的标签。
643 |     </p>
644 | 
645 | <pre>
646 | <b>$ git tag -a v1.0 </b>
647 | </pre>
648 | 
649 |     <p>当你执行 <code>git tag -a</code> 命令时，Git 会打开你的编辑器，让你写一句标签注解，就像你给提交写注解一样。
650 |     </p>
651 | 
652 |     <p>现在，注意当我们执行 <code>git log --decorate</code> 时，我们可以看到我们的标签了：
653 |     </p>
654 | 
655 | <pre>
656 | <b>$ git log --oneline --decorate --graph</b>
657 | * 594f90b (HEAD, <span class="hl">tag: v1.0</span>, master) reverted to old class name
658 | *   8d585ea Merge branch 'fix_readme'
659 | |\
660 | | * 3ac015d (fix_readme) fixed readme title
661 | * | 3cbb6aa fixed readme title differently
662 | |/
663 | *   558151a Merge branch 'change_class'
664 | |\
665 | | * 3467b0a changed the class name
666 | * | b7ae93b added from ruby
667 | |/
668 | * 17f4acf first commit
669 | </pre>
670 | 
671 |     <p>如果我们有新提交，该标签依然会待在该提交的边上，所以我们已经给那个特定快照永久打上标签，并且能够将它与未来的快照做比较。
672 |     </p>
673 | 
674 |     <p>不过我们并不需要给当前提交打标签。如果我们忘了给某个提交打标签，又将它发布了，我们可以给它追加标签。
675 |       在相同的命令末尾加上提交的 SHA，执行，就可以了。
676 |       例如，假设我们发布了提交 <code>558151a</code>（几个提交之前的事情了），但是那时候忘了给它打标签。
677 |       我们现在也可以：</p>
678 | 
679 | <pre>
680 | <b>$ git tag -a v0.9 558151a</b>
681 | <b>$ git log --oneline --decorate --graph</b>
682 | * 594f90b (HEAD, tag: v1.0, master) reverted to old class name
683 | *   8d585ea Merge branch 'fix_readme'
684 | |\
685 | | * 3ac015d (fix_readme) fixed readme title
686 | * | 3cbb6aa fixed readme title differently
687 | |/
688 | *   558151a (<span class="hl">tag: v0.9</span>) Merge branch 'change_class'
689 | |\
690 | | * 3467b0a changed the class name
691 | * | b7ae93b added from ruby
692 | |/
693 | * 17f4acf first commit
694 | </pre>
695 | 
696 |   </div>
697 | </div>
698 | 
699 | <p><a href="/remotes">到 分享与更新项目 &#187;</a></p>
700 | 
701 | 


--------------------------------------------------------------------------------
/js/jquery-ui.min.js:
--------------------------------------------------------------------------------
  1 | /*!
  2 |  * jQuery UI 1.8rc1
  3 |  *
  4 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
  5 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
  6 |  * and GPL (GPL-LICENSE.txt) licenses.
  7 |  *
  8 |  * http://docs.jquery.com/UI
  9 |  */
/*
 10 |  * jQuery UI 1.8rc1
 11 |  *
 12 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
 13 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
 14 |  * and GPL (GPL-LICENSE.txt) licenses.
 15 |  *
 16 |  * http://docs.jquery.com/UI
 17 |  */
 18 | jQuery.ui||(function(b){var a=b.browser.mozilla&&(parseFloat(b.browser.version)<1.9);b.ui={version:"1.8rc1",plugin:{add:function(d,e,g){var f=b.ui[d].prototype;for(var c in g){f.plugins[c]=f.plugins[c]||[];f.plugins[c].push([e,g[c]])}},call:function(c,e,d){var g=c.plugins[e];if(!g||!c.element[0].parentNode){return}for(var f=0;f<g.length;f++){if(c.options[g[f][0]]){g[f][1].apply(c.element,d)}}}},contains:function(d,c){return document.compareDocumentPosition?d.compareDocumentPosition(c)&16:d!==c&&d.contains(c)},hasScroll:function(f,d){if(b(f).css("overflow")=="hidden"){return false}var c=(d&&d=="left")?"scrollLeft":"scrollTop",e=false;if(f[c]>0){return true}f[c]=1;e=(f[c]>0);f[c]=0;return e},isOverAxis:function(d,c,e){return(d>c)&&(d<(c+e))},isOver:function(h,d,g,f,c,e){return b.ui.isOverAxis(h,g,c)&&b.ui.isOverAxis(d,f,e)},keyCode:{BACKSPACE:8,CAPS_LOCK:20,COMMA:188,CONTROL:17,DELETE:46,DOWN:40,END:35,ENTER:13,ESCAPE:27,HOME:36,INSERT:45,LEFT:37,NUMPAD_ADD:107,NUMPAD_DECIMAL:110,NUMPAD_DIVIDE:111,NUMPAD_ENTER:108,NUMPAD_MULTIPLY:106,NUMPAD_SUBTRACT:109,PAGE_DOWN:34,PAGE_UP:33,PERIOD:190,RIGHT:39,SHIFT:16,SPACE:32,TAB:9,UP:38}};b.fn.extend({_focus:b.fn.focus,focus:function(c,d){return typeof c==="number"?this.each(function(){var e=this;setTimeout(function(){b(e).focus();(d&&d.call(e))},c)}):this._focus.apply(this,arguments)},enableSelection:function(){return this.attr("unselectable","off").css("MozUserSelect","").unbind("selectstart.ui")},disableSelection:function(){return this.attr("unselectable","on").css("MozUserSelect","none").bind("selectstart.ui",function(){return false})},scrollParent:function(){var c;if((b.browser.msie&&(/(static|relative)/).test(this.css("position")))||(/absolute/).test(this.css("position"))){c=this.parents().filter(function(){return(/(relative|absolute|fixed)/).test(b.curCSS(this,"position",1))&&(/(auto|scroll)/).test(b.curCSS(this,"overflow",1)+b.curCSS(this,"overflow-y",1)+b.curCSS(this,"overflow-x",1))}).eq(0)}else{c=this.parents().filter(function(){return(/(auto|scroll)/).test(b.curCSS(this,"overflow",1)+b.curCSS(this,"overflow-y",1)+b.curCSS(this,"overflow-x",1))}).eq(0)}return(/fixed/).test(this.css("position"))||!c.length?b(document):c},zIndex:function(d){if(d!==undefined){return this.css("zIndex",d)}var c=this[0];while(c&&c.style){if(c.style.zIndex!==""&&c.style.zIndex!==0){return +c.style.zIndex}c=c.parentNode}return 0}});b.extend(b.expr[":"],{data:function(e,d,c){return !!b.data(e,c[3])},focusable:function(d){var e=d.nodeName.toLowerCase(),c=b.attr(d,"tabindex");return(/input|select|textarea|button|object/.test(e)?!d.disabled:"a"==e||"area"==e?d.href||!isNaN(c):!isNaN(c))&&!b(d)["area"==e?"parents":"closest"](":hidden").length},tabbable:function(d){var c=b.attr(d,"tabindex");return(isNaN(c)||c>=0)&&b(d).is(":focusable")}})})(jQuery);;/*!
 19 |  * jQuery UI Widget 1.8rc1
 20 |  *
 21 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
 22 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
 23 |  * and GPL (GPL-LICENSE.txt) licenses.
 24 |  *
 25 |  * http://docs.jquery.com/UI/Widget
 26 |  */
/*
 27 |  * jQuery UI Widget 1.8rc1
 28 |  *
 29 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
 30 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
 31 |  * and GPL (GPL-LICENSE.txt) licenses.
 32 |  *
 33 |  * http://docs.jquery.com/UI/Widget
 34 |  */
 35 | (function(b){var a=b.fn.remove;b.fn.remove=function(c,d){if(!d){b("*",this).add(this).each(function(){b(this).triggerHandler("remove")})}return a.apply(this,arguments)};b.widget=function(d,f,c){var e=d.split(".")[0],h;d=d.split(".")[1];h=e+"-"+d;if(!c){c=f;f=b.Widget}b.expr[":"][h]=function(i){return !!b.data(i,d)};b[e]=b[e]||{};b[e][d]=function(i,j){if(arguments.length){this._createWidget(i,j)}};var g=new f();g.options=b.extend({},g.options);b[e][d].prototype=b.extend(true,g,{namespace:e,widgetName:d,widgetEventPrefix:b[e][d].prototype.widgetEventPrefix||d,widgetBaseClass:h},c);b.widget.bridge(d,b[e][d])};b.widget.bridge=function(d,c){b.fn[d]=function(g){var e=typeof g==="string",f=Array.prototype.slice.call(arguments,1),h=this;g=!e&&f.length?b.extend.apply(null,[true,g].concat(f)):g;if(e&&g.substring(0,1)==="_"){return h}if(e){this.each(function(){var i=b.data(this,d),j=i&&b.isFunction(i[g])?i[g].apply(i,f):i;if(j!==i&&j!==undefined){h=j;return false}})}else{this.each(function(){var i=b.data(this,d);if(i){if(g){i.option(g)}i._init()}else{b.data(this,d,new c(g,this))}})}return h}};b.Widget=function(c,d){if(arguments.length){this._createWidget(c,d)}};b.Widget.prototype={widgetName:"widget",widgetEventPrefix:"",options:{disabled:false},_createWidget:function(d,e){this.element=b(e).data(this.widgetName,this);this.options=b.extend(true,{},this.options,b.metadata&&b.metadata.get(e)[this.widgetName],d);var c=this;this.element.bind("remove."+this.widgetName,function(){c.destroy()});this._create();this._init()},_create:function(){},_init:function(){},destroy:function(){this.element.unbind("."+this.widgetName).removeData(this.widgetName);this.widget().unbind("."+this.widgetName).removeAttr("aria-disabled").removeClass(this.widgetBaseClass+"-disabled "+this.namespace+"-state-disabled")},widget:function(){return this.element},option:function(e,f){var d=e,c=this;if(arguments.length===0){return b.extend({},c.options)}if(typeof e==="string"){if(f===undefined){return this.options[e]}d={};d[e]=f}b.each(d,function(g,h){c._setOption(g,h)});return c},_setOption:function(c,d){this.options[c]=d;if(c==="disabled"){this.widget()[d?"addClass":"removeClass"](this.widgetBaseClass+"-disabled "+this.namespace+"-state-disabled").attr("aria-disabled",d)}return this},enable:function(){return this._setOption("disabled",false)},disable:function(){return this._setOption("disabled",true)},_trigger:function(d,e,f){var h=this.options[d];e=b.Event(e);e.type=(d===this.widgetEventPrefix?d:this.widgetEventPrefix+d).toLowerCase();f=f||{};if(e.originalEvent){for(var c=b.event.props.length,g;c;){g=b.event.props[--c];e[g]=e.originalEvent[g]}}this.element.trigger(e,f);return !(b.isFunction(h)&&h.call(this.element[0],e,f)===false||e.isDefaultPrevented())}}})(jQuery);;/*!
 36 |  * jQuery UI Mouse 1.8rc1
 37 |  *
 38 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
 39 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
 40 |  * and GPL (GPL-LICENSE.txt) licenses.
 41 |  *
 42 |  * http://docs.jquery.com/UI/Mouse
 43 |  *
 44 |  * Depends:
 45 |  *	jquery.ui.widget.js
 46 |  */
/*
 47 |  * jQuery UI Mouse 1.8rc1
 48 |  *
 49 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
 50 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
 51 |  * and GPL (GPL-LICENSE.txt) licenses.
 52 |  *
 53 |  * http://docs.jquery.com/UI/Mouse
 54 |  *
 55 |  * Depends:
 56 |  *	jquery.ui.widget.js
 57 |  */
 58 | (function(a){a.widget("ui.mouse",{options:{cancel:":input,option",distance:1,delay:0},_mouseInit:function(){var b=this;this.element.bind("mousedown."+this.widgetName,function(c){return b._mouseDown(c)}).bind("click."+this.widgetName,function(c){if(b._preventClickEvent){b._preventClickEvent=false;c.stopImmediatePropagation();return false}});this.started=false},_mouseDestroy:function(){this.element.unbind("."+this.widgetName)},_mouseDown:function(d){d.originalEvent=d.originalEvent||{};if(d.originalEvent.mouseHandled){return}(this._mouseStarted&&this._mouseUp(d));this._mouseDownEvent=d;var c=this,e=(d.which==1),b=(typeof this.options.cancel=="string"?a(d.target).parents().add(d.target).filter(this.options.cancel).length:false);if(!e||b||!this._mouseCapture(d)){return true}this.mouseDelayMet=!this.options.delay;if(!this.mouseDelayMet){this._mouseDelayTimer=setTimeout(function(){c.mouseDelayMet=true},this.options.delay)}if(this._mouseDistanceMet(d)&&this._mouseDelayMet(d)){this._mouseStarted=(this._mouseStart(d)!==false);if(!this._mouseStarted){d.preventDefault();return true}}this._mouseMoveDelegate=function(f){return c._mouseMove(f)};this._mouseUpDelegate=function(f){return c._mouseUp(f)};a(document).bind("mousemove."+this.widgetName,this._mouseMoveDelegate).bind("mouseup."+this.widgetName,this._mouseUpDelegate);(a.browser.safari||d.preventDefault());d.originalEvent.mouseHandled=true;return true},_mouseMove:function(b){if(a.browser.msie&&!b.button){return this._mouseUp(b)}if(this._mouseStarted){this._mouseDrag(b);return b.preventDefault()}if(this._mouseDistanceMet(b)&&this._mouseDelayMet(b)){this._mouseStarted=(this._mouseStart(this._mouseDownEvent,b)!==false);(this._mouseStarted?this._mouseDrag(b):this._mouseUp(b))}return !this._mouseStarted},_mouseUp:function(b){a(document).unbind("mousemove."+this.widgetName,this._mouseMoveDelegate).unbind("mouseup."+this.widgetName,this._mouseUpDelegate);if(this._mouseStarted){this._mouseStarted=false;this._preventClickEvent=(b.target==this._mouseDownEvent.target);this._mouseStop(b)}return false},_mouseDistanceMet:function(b){return(Math.max(Math.abs(this._mouseDownEvent.pageX-b.pageX),Math.abs(this._mouseDownEvent.pageY-b.pageY))>=this.options.distance)},_mouseDelayMet:function(b){return this.mouseDelayMet},_mouseStart:function(b){},_mouseDrag:function(b){},_mouseStop:function(b){},_mouseCapture:function(b){return true}})})(jQuery);;/*
 59 |  * jQuery UI Position 1.8rc1
 60 |  *
 61 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
 62 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
 63 |  * and GPL (GPL-LICENSE.txt) licenses.
 64 |  *
 65 |  * http://docs.jquery.com/UI/Position
 66 |  */
(function(f){f.ui=f.ui||{};var c=/left|center|right/,e="center",d=/top|center|bottom/,g="center",a=f.fn.position;f.fn.position=function(i){if(!i||!i.of){return a.apply(this,arguments)}i=f.extend({},i);var l=f(i.of),n=(i.collision||"flip").split(" "),m=i.offset?i.offset.split(" "):[0,0],k,h,j;if(i.of.nodeType===9){k=l.width();h=l.height();j={top:0,left:0}}else{if(i.of.scrollTo&&i.of.document){k=l.width();h=l.height();j={top:l.scrollTop(),left:l.scrollLeft()}}else{if(i.of.preventDefault){i.at="left top";k=h=0;j={top:i.of.pageY,left:i.of.pageX}}else{k=l.outerWidth();h=l.outerHeight();j=l.offset()}}}f.each(["my","at"],function(){var o=(i[this]||"").split(" ");o=o.length==1?c.test(o[0])?o.concat([g]):d.test(o[0])?[e].concat(o):[e,g]:o;o[0]=c.test(o[0])?o[0]:e;o[1]=d.test(o[1])?o[1]:g;i[this]=o});if(n.length==1){n[1]=n[0]}m[0]=parseInt(m[0],10)||0;if(m.length==1){m[1]=m[0]}m[1]=parseInt(m[1],10)||0;switch(i.at[0]){case"right":j.left+=k;break;case e:j.left+=k/2;break}switch(i.at[1]){case"bottom":j.top+=h;break;case g:j.top+=h/2;break}j.left+=m[0];j.top+=m[1];return this.each(function(){var t=f(this),s=t.outerWidth(),r=t.outerHeight(),p=f.extend({},j),u,o,q;switch(i.my[0]){case"right":p.left-=s;break;case e:p.left-=s/2;break}switch(i.my[1]){case"bottom":p.top-=r;break;case g:p.top-=r/2;break}f.each(["left","top"],function(w,v){(f.ui.position[n[w]]&&f.ui.position[n[w]][v](p,{targetWidth:k,targetHeight:h,elemWidth:s,elemHeight:r,offset:m,my:i.my,at:i.at}))});(f.fn.bgiframe&&t.bgiframe());t.offset(f.extend(p,{using:i.using}))})};f.ui.position={fit:{left:function(h,i){var j=h.left+i.elemWidth-f(window).width()-f(window).scrollLeft();h.left=j>0?h.left-j:Math.max(0,h.left)},top:function(h,i){var j=h.top+i.elemHeight-f(window).height()-f(window).scrollTop();h.top=j>0?h.top-j:Math.max(0,h.top)}},flip:{left:function(i,j){if(j.at[0]=="center"){return}var k=i.left+j.elemWidth-f(window).width()-f(window).scrollLeft(),h=j.my[0]=="left"?-j.elemWidth:j.my[0]=="right"?j.elemWidth:0,l=-2*j.offset[0];i.left+=i.left<0?h+j.targetWidth+l:k>0?h-j.targetWidth+l:0},top:function(i,k){if(k.at[1]=="center"){return}var l=i.top+k.elemHeight-f(window).height()-f(window).scrollTop(),h=k.my[1]=="top"?-k.elemHeight:k.my[1]=="bottom"?k.elemHeight:0,j=k.at[1]=="top"?k.targetHeight:-k.targetHeight,m=-2*k.offset[1];i.top+=i.top<0?h+k.targetHeight+m:l>0?h+j+m:0}}};if(!f.offset.setOffset){f.offset.setOffset=function(l,i){if(/static/.test(jQuery.curCSS(l,"position"))){l.style.position="relative"}var k=jQuery(l),n=k.offset(),h=parseInt(jQuery.curCSS(l,"top",true),10)||0,m=parseInt(jQuery.curCSS(l,"left",true),10)||0,j={top:(i.top-n.top)+h,left:(i.left-n.left)+m};if("using" in i){i.using.call(l,j)}else{k.css(j)}};var b=f.fn.offset;f.fn.offset=function(h){var i=this[0];if(!i||!i.ownerDocument){return null}if(h){return this.each(function(){f.offset.setOffset(this,h)})}return b.call(this)}}})(jQuery);;/*
 67 |  * jQuery UI Effects 1.8rc1
 68 |  *
 69 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
 70 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
 71 |  * and GPL (GPL-LICENSE.txt) licenses.
 72 |  *
 73 |  * http://docs.jquery.com/UI/Effects/
 74 |  */
jQuery.effects||(function(g){g.effects={};g.each(["backgroundColor","borderBottomColor","borderLeftColor","borderRightColor","borderTopColor","color","outlineColor"],function(l,k){g.fx.step[k]=function(m){if(!m.colorInit){m.start=j(m.elem,k);m.end=i(m.end);m.colorInit=true}m.elem.style[k]="rgb("+Math.max(Math.min(parseInt((m.pos*(m.end[0]-m.start[0]))+m.start[0],10),255),0)+","+Math.max(Math.min(parseInt((m.pos*(m.end[1]-m.start[1]))+m.start[1],10),255),0)+","+Math.max(Math.min(parseInt((m.pos*(m.end[2]-m.start[2]))+m.start[2],10),255),0)+")"}});function i(l){var k;if(l&&l.constructor==Array&&l.length==3){return l}if(k=/rgb\(\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*\)/.exec(l)){return[parseInt(k[1],10),parseInt(k[2],10),parseInt(k[3],10)]}if(k=/rgb\(\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*\)/.exec(l)){return[parseFloat(k[1])*2.55,parseFloat(k[2])*2.55,parseFloat(k[3])*2.55]}if(k=/#([a-fA-F0-9]{2})([a-fA-F0-9]{2})([a-fA-F0-9]{2})/.exec(l)){return[parseInt(k[1],16),parseInt(k[2],16),parseInt(k[3],16)]}if(k=/#([a-fA-F0-9])([a-fA-F0-9])([a-fA-F0-9])/.exec(l)){return[parseInt(k[1]+k[1],16),parseInt(k[2]+k[2],16),parseInt(k[3]+k[3],16)]}if(k=/rgba\(0, 0, 0, 0\)/.exec(l)){return a.transparent}return a[g.trim(l).toLowerCase()]}function j(m,k){var l;do{l=g.curCSS(m,k);if(l!=""&&l!="transparent"||g.nodeName(m,"body")){break}k="backgroundColor"}while(m=m.parentNode);return i(l)}var a={aqua:[0,255,255],azure:[240,255,255],beige:[245,245,220],black:[0,0,0],blue:[0,0,255],brown:[165,42,42],cyan:[0,255,255],darkblue:[0,0,139],darkcyan:[0,139,139],darkgrey:[169,169,169],darkgreen:[0,100,0],darkkhaki:[189,183,107],darkmagenta:[139,0,139],darkolivegreen:[85,107,47],darkorange:[255,140,0],darkorchid:[153,50,204],darkred:[139,0,0],darksalmon:[233,150,122],darkviolet:[148,0,211],fuchsia:[255,0,255],gold:[255,215,0],green:[0,128,0],indigo:[75,0,130],khaki:[240,230,140],lightblue:[173,216,230],lightcyan:[224,255,255],lightgreen:[144,238,144],lightgrey:[211,211,211],lightpink:[255,182,193],lightyellow:[255,255,224],lime:[0,255,0],magenta:[255,0,255],maroon:[128,0,0],navy:[0,0,128],olive:[128,128,0],orange:[255,165,0],pink:[255,192,203],purple:[128,0,128],violet:[128,0,128],red:[255,0,0],silver:[192,192,192],white:[255,255,255],yellow:[255,255,0],transparent:[255,255,255]};var e=["add","remove","toggle"],c={border:1,borderBottom:1,borderColor:1,borderLeft:1,borderRight:1,borderTop:1,borderWidth:1,margin:1,padding:1};function f(){var n=document.defaultView?document.defaultView.getComputedStyle(this,null):this.currentStyle,o={},l,m;if(n&&n.length&&n[0]&&n[n[0]]){var k=n.length;while(k--){l=n[k];if(typeof n[l]=="string"){m=l.replace(/\-(\w)/g,function(p,q){return q.toUpperCase()});o[m]=n[l]}}}else{for(l in n){if(typeof n[l]==="string"){o[l]=n[l]}}}return o}function b(l){var k,m;for(k in l){m=l[k];if(m==null||g.isFunction(m)||k in c||(/scrollbar/).test(k)||(!(/color/i).test(k)&&isNaN(parseFloat(m)))){delete l[k]}}return l}function h(k,m){var n={_:0},l;for(l in m){if(k[l]!=m[l]){n[l]=m[l]}}return n}g.effects.animateClass=function(k,l,n,m){if(g.isFunction(n)){m=n;n=null}return this.each(function(){var r=g(this),o=r.attr("style")||" ",s=b(f.call(this)),q,p=r.attr("className");g.each(e,function(t,u){if(k[u]){r[u+"Class"](k[u])}});q=b(f.call(this));r.attr("className",p);r.animate(h(s,q),l,n,function(){g.each(e,function(t,u){if(k[u]){r[u+"Class"](k[u])}});if(typeof r.attr("style")=="object"){r.attr("style").cssText="";r.attr("style").cssText=o}else{r.attr("style",o)}if(m){m.apply(this,arguments)}})})};g.fn.extend({_addClass:g.fn.addClass,addClass:function(l,k,n,m){return k?g.effects.animateClass.apply(this,[{add:l},k,n,m]):this._addClass(l)},_removeClass:g.fn.removeClass,removeClass:function(l,k,n,m){return k?g.effects.animateClass.apply(this,[{remove:l},k,n,m]):this._removeClass(l)},_toggleClass:g.fn.toggleClass,toggleClass:function(m,l,k,o,n){if(typeof l=="boolean"||l===undefined){if(!k){return this._toggleClass(m,l)}else{return g.effects.animateClass.apply(this,[(l?{add:m}:{remove:m}),k,o,n])}}else{return g.effects.animateClass.apply(this,[{toggle:m},l,k,o])}},switchClass:function(k,m,l,o,n){return g.effects.animateClass.apply(this,[{add:m,remove:k},l,o,n])}});g.extend(g.effects,{version:"1.8rc1",save:function(l,m){for(var k=0;k<m.length;k++){if(m[k]!==null){l.data("ec.storage."+m[k],l[0].style[m[k]])}}},restore:function(l,m){for(var k=0;k<m.length;k++){if(m[k]!==null){l.css(m[k],l.data("ec.storage."+m[k]))}}},setMode:function(k,l){if(l=="toggle"){l=k.is(":hidden")?"show":"hide"}return l},getBaseline:function(l,m){var n,k;switch(l[0]){case"top":n=0;break;case"middle":n=0.5;break;case"bottom":n=1;break;default:n=l[0]/m.height}switch(l[1]){case"left":k=0;break;case"center":k=0.5;break;case"right":k=1;break;default:k=l[1]/m.width}return{x:k,y:n}},createWrapper:function(k){if(k.parent().is(".ui-effects-wrapper")){return k.parent()}var l={width:k.outerWidth(true),height:k.outerHeight(true),"float":k.css("float")},m=g("<div></div>").addClass("ui-effects-wrapper").css({fontSize:"100%",background:"transparent",border:"none",margin:0,padding:0});k.wrap(m);if(k.css("position")=="static"){m.css({position:"relative"});k.css({position:"relative"})}else{g.extend(l,{position:k.css("position"),zIndex:k.css("z-index")});g.each(["top","left","bottom","right"],function(n,o){l[o]=k.css(o);if(isNaN(parseInt(l[o],10))){l[o]="auto"}});k.css({position:"relative",top:0,left:0})}return m.css(l).show()},removeWrapper:function(k){if(k.parent().is(".ui-effects-wrapper")){return k.parent().replaceWith(k)}return k},setTransition:function(l,n,k,m){m=m||{};g.each(n,function(p,o){unit=l.cssUnit(o);if(unit[0]>0){m[o]=unit[0]*k+unit[1]}});return m}});function d(l,k,m,n){if(typeof l=="object"){n=k;m=null;k=l;l=k.effect}if(g.isFunction(k)){n=k;m=null;k={}}if(typeof k=="number"){n=m;m=k;k={}}k=k||{};m=m||k.duration;m=g.fx.off?0:typeof m=="number"?m:g.fx.speeds[m]||g.fx.speeds._default;n=n||k.complete;return[l,k,m,n]}g.fn.extend({effect:function(n,m,p,q){var l=d.apply(this,arguments),o={options:l[1],duration:l[2],callback:l[3]},k=g.effects[n];return k&&!g.fx.off?k.call(this,o):this},_show:g.fn.show,show:function(l){if(!l||typeof l=="number"||g.fx.speeds[l]){return this._show.apply(this,arguments)}else{var k=d.apply(this,arguments);k[1].mode="show";return this.effect.apply(this,k)}},_hide:g.fn.hide,hide:function(l){if(!l||typeof l=="number"||g.fx.speeds[l]){return this._hide.apply(this,arguments)}else{var k=d.apply(this,arguments);k[1].mode="hide";return this.effect.apply(this,k)}},__toggle:g.fn.toggle,toggle:function(l){if(!l||typeof l=="number"||g.fx.speeds[l]||typeof l=="boolean"||g.isFunction(l)){return this.__toggle.apply(this,arguments)}else{var k=d.apply(this,arguments);k[1].mode="toggle";return this.effect.apply(this,k)}},cssUnit:function(k){var l=this.css(k),m=[];g.each(["em","px","%","pt"],function(n,o){if(l.indexOf(o)>0){m=[parseFloat(l),o]}});return m}});g.easing.jswing=g.easing.swing;g.extend(g.easing,{def:"easeOutQuad",swing:function(l,m,k,o,n){return g.easing[g.easing.def](l,m,k,o,n)},easeInQuad:function(l,m,k,o,n){return o*(m/=n)*m+k},easeOutQuad:function(l,m,k,o,n){return -o*(m/=n)*(m-2)+k},easeInOutQuad:function(l,m,k,o,n){if((m/=n/2)<1){return o/2*m*m+k}return -o/2*((--m)*(m-2)-1)+k},easeInCubic:function(l,m,k,o,n){return o*(m/=n)*m*m+k},easeOutCubic:function(l,m,k,o,n){return o*((m=m/n-1)*m*m+1)+k},easeInOutCubic:function(l,m,k,o,n){if((m/=n/2)<1){return o/2*m*m*m+k}return o/2*((m-=2)*m*m+2)+k},easeInQuart:function(l,m,k,o,n){return o*(m/=n)*m*m*m+k},easeOutQuart:function(l,m,k,o,n){return -o*((m=m/n-1)*m*m*m-1)+k},easeInOutQuart:function(l,m,k,o,n){if((m/=n/2)<1){return o/2*m*m*m*m+k}return -o/2*((m-=2)*m*m*m-2)+k},easeInQuint:function(l,m,k,o,n){return o*(m/=n)*m*m*m*m+k},easeOutQuint:function(l,m,k,o,n){return o*((m=m/n-1)*m*m*m*m+1)+k},easeInOutQuint:function(l,m,k,o,n){if((m/=n/2)<1){return o/2*m*m*m*m*m+k}return o/2*((m-=2)*m*m*m*m+2)+k},easeInSine:function(l,m,k,o,n){return -o*Math.cos(m/n*(Math.PI/2))+o+k},easeOutSine:function(l,m,k,o,n){return o*Math.sin(m/n*(Math.PI/2))+k},easeInOutSine:function(l,m,k,o,n){return -o/2*(Math.cos(Math.PI*m/n)-1)+k},easeInExpo:function(l,m,k,o,n){return(m==0)?k:o*Math.pow(2,10*(m/n-1))+k},easeOutExpo:function(l,m,k,o,n){return(m==n)?k+o:o*(-Math.pow(2,-10*m/n)+1)+k},easeInOutExpo:function(l,m,k,o,n){if(m==0){return k}if(m==n){return k+o}if((m/=n/2)<1){return o/2*Math.pow(2,10*(m-1))+k}return o/2*(-Math.pow(2,-10*--m)+2)+k},easeInCirc:function(l,m,k,o,n){return -o*(Math.sqrt(1-(m/=n)*m)-1)+k},easeOutCirc:function(l,m,k,o,n){return o*Math.sqrt(1-(m=m/n-1)*m)+k},easeInOutCirc:function(l,m,k,o,n){if((m/=n/2)<1){return -o/2*(Math.sqrt(1-m*m)-1)+k}return o/2*(Math.sqrt(1-(m-=2)*m)+1)+k},easeInElastic:function(l,n,k,u,r){var o=1.70158;var q=0;var m=u;if(n==0){return k}if((n/=r)==1){return k+u}if(!q){q=r*0.3}if(m<Math.abs(u)){m=u;var o=q/4}else{var o=q/(2*Math.PI)*Math.asin(u/m)}return -(m*Math.pow(2,10*(n-=1))*Math.sin((n*r-o)*(2*Math.PI)/q))+k},easeOutElastic:function(l,n,k,u,r){var o=1.70158;var q=0;var m=u;if(n==0){return k}if((n/=r)==1){return k+u}if(!q){q=r*0.3}if(m<Math.abs(u)){m=u;var o=q/4}else{var o=q/(2*Math.PI)*Math.asin(u/m)}return m*Math.pow(2,-10*n)*Math.sin((n*r-o)*(2*Math.PI)/q)+u+k},easeInOutElastic:function(l,n,k,u,r){var o=1.70158;var q=0;var m=u;if(n==0){return k}if((n/=r/2)==2){return k+u}if(!q){q=r*(0.3*1.5)}if(m<Math.abs(u)){m=u;var o=q/4}else{var o=q/(2*Math.PI)*Math.asin(u/m)}if(n<1){return -0.5*(m*Math.pow(2,10*(n-=1))*Math.sin((n*r-o)*(2*Math.PI)/q))+k}return m*Math.pow(2,-10*(n-=1))*Math.sin((n*r-o)*(2*Math.PI)/q)*0.5+u+k},easeInBack:function(l,m,k,p,o,n){if(n==undefined){n=1.70158}return p*(m/=o)*m*((n+1)*m-n)+k},easeOutBack:function(l,m,k,p,o,n){if(n==undefined){n=1.70158}return p*((m=m/o-1)*m*((n+1)*m+n)+1)+k},easeInOutBack:function(l,m,k,p,o,n){if(n==undefined){n=1.70158}if((m/=o/2)<1){return p/2*(m*m*(((n*=(1.525))+1)*m-n))+k}return p/2*((m-=2)*m*(((n*=(1.525))+1)*m+n)+2)+k},easeInBounce:function(l,m,k,o,n){return o-g.easing.easeOutBounce(l,n-m,0,o,n)+k},easeOutBounce:function(l,m,k,o,n){if((m/=n)<(1/2.75)){return o*(7.5625*m*m)+k}else{if(m<(2/2.75)){return o*(7.5625*(m-=(1.5/2.75))*m+0.75)+k}else{if(m<(2.5/2.75)){return o*(7.5625*(m-=(2.25/2.75))*m+0.9375)+k}else{return o*(7.5625*(m-=(2.625/2.75))*m+0.984375)+k}}}},easeInOutBounce:function(l,m,k,o,n){if(m<n/2){return g.easing.easeInBounce(l,m*2,0,o,n)*0.5+k}return g.easing.easeOutBounce(l,m*2-n,0,o,n)*0.5+o*0.5+k}})})(jQuery);;/*
 75 |  * jQuery UI Effects Drop 1.8rc1
 76 |  *
 77 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
 78 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
 79 |  * and GPL (GPL-LICENSE.txt) licenses.
 80 |  *
 81 |  * http://docs.jquery.com/UI/Effects/Drop
 82 |  *
 83 |  * Depends:
 84 |  *	jquery.effects.core.js
 85 |  */
(function(a){a.effects.drop=function(b){return this.queue(function(){var e=a(this),d=["position","top","left","opacity"];var i=a.effects.setMode(e,b.options.mode||"hide");var h=b.options.direction||"left";a.effects.save(e,d);e.show();a.effects.createWrapper(e);var f=(h=="up"||h=="down")?"top":"left";var c=(h=="up"||h=="left")?"pos":"neg";var j=b.options.distance||(f=="top"?e.outerHeight({margin:true})/2:e.outerWidth({margin:true})/2);if(i=="show"){e.css("opacity",0).css(f,c=="pos"?-j:j)}var g={opacity:i=="show"?1:0};g[f]=(i=="show"?(c=="pos"?"+=":"-="):(c=="pos"?"-=":"+="))+j;e.animate(g,{queue:false,duration:b.duration,easing:b.options.easing,complete:function(){if(i=="hide"){e.hide()}a.effects.restore(e,d);a.effects.removeWrapper(e);if(b.callback){b.callback.apply(this,arguments)}e.dequeue()}})})}})(jQuery);;/*
 86 |  * jQuery UI Effects Highlight 1.8rc1
 87 |  *
 88 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
 89 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
 90 |  * and GPL (GPL-LICENSE.txt) licenses.
 91 |  *
 92 |  * http://docs.jquery.com/UI/Effects/Highlight
 93 |  *
 94 |  * Depends:
 95 |  *	jquery.effects.core.js
 96 |  */
(function(a){a.effects.highlight=function(b){return this.queue(function(){var d=a(this),c=["backgroundImage","backgroundColor","opacity"],f=a.effects.setMode(d,b.options.mode||"show"),e={backgroundColor:d.css("backgroundColor")};if(f=="hide"){e.opacity=0}a.effects.save(d,c);d.show().css({backgroundImage:"none",backgroundColor:b.options.color||"#ffff99"}).animate(e,{queue:false,duration:b.duration,easing:b.options.easing,complete:function(){(f=="hide"&&d.hide());a.effects.restore(d,c);(f=="show"&&!a.support.opacity&&this.style.removeAttribute("filter"));(b.callback&&b.callback.apply(this,arguments));d.dequeue()}})})}})(jQuery);;/*
 97 |  * jQuery UI Effects Scale 1.8rc1
 98 |  *
 99 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
100 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
101 |  * and GPL (GPL-LICENSE.txt) licenses.
102 |  *
103 |  * http://docs.jquery.com/UI/Effects/Scale
104 |  *
105 |  * Depends:
106 |  *	jquery.effects.core.js
107 |  */
(function(a){a.effects.puff=function(b){return this.queue(function(){var f=a(this),g=a.effects.setMode(f,b.options.mode||"hide"),e=parseInt(b.options.percent,10)||150,d=e/100,c={height:f.height(),width:f.width()};a.extend(b.options,{fade:true,mode:g,percent:g=="hide"?e:100,from:g=="hide"?c:{height:c.height*d,width:c.width*d}});f.effect("scale",b.options,b.duration,b.callback);f.dequeue()})};a.effects.scale=function(b){return this.queue(function(){var g=a(this);var d=a.extend(true,{},b.options);var j=a.effects.setMode(g,b.options.mode||"effect");var h=parseInt(b.options.percent,10)||(parseInt(b.options.percent,10)==0?0:(j=="hide"?0:100));var i=b.options.direction||"both";var c=b.options.origin;if(j!="effect"){d.origin=c||["middle","center"];d.restore=true}var f={height:g.height(),width:g.width()};g.from=b.options.from||(j=="show"?{height:0,width:0}:f);var e={y:i!="horizontal"?(h/100):1,x:i!="vertical"?(h/100):1};g.to={height:f.height*e.y,width:f.width*e.x};if(b.options.fade){if(j=="show"){g.from.opacity=0;g.to.opacity=1}if(j=="hide"){g.from.opacity=1;g.to.opacity=0}}d.from=g.from;d.to=g.to;d.mode=j;g.effect("size",d,b.duration,b.callback);g.dequeue()})};a.effects.size=function(b){return this.queue(function(){var c=a(this),n=["position","top","left","width","height","overflow","opacity"];var m=["position","top","left","overflow","opacity"];var j=["width","height","overflow"];var p=["fontSize"];var k=["borderTopWidth","borderBottomWidth","paddingTop","paddingBottom"];var f=["borderLeftWidth","borderRightWidth","paddingLeft","paddingRight"];var g=a.effects.setMode(c,b.options.mode||"effect");var i=b.options.restore||false;var e=b.options.scale||"both";var o=b.options.origin;var d={height:c.height(),width:c.width()};c.from=b.options.from||d;c.to=b.options.to||d;if(o){var h=a.effects.getBaseline(o,d);c.from.top=(d.height-c.from.height)*h.y;c.from.left=(d.width-c.from.width)*h.x;c.to.top=(d.height-c.to.height)*h.y;c.to.left=(d.width-c.to.width)*h.x}var l={from:{y:c.from.height/d.height,x:c.from.width/d.width},to:{y:c.to.height/d.height,x:c.to.width/d.width}};if(e=="box"||e=="both"){if(l.from.y!=l.to.y){n=n.concat(k);c.from=a.effects.setTransition(c,k,l.from.y,c.from);c.to=a.effects.setTransition(c,k,l.to.y,c.to)}if(l.from.x!=l.to.x){n=n.concat(f);c.from=a.effects.setTransition(c,f,l.from.x,c.from);c.to=a.effects.setTransition(c,f,l.to.x,c.to)}}if(e=="content"||e=="both"){if(l.from.y!=l.to.y){n=n.concat(p);c.from=a.effects.setTransition(c,p,l.from.y,c.from);c.to=a.effects.setTransition(c,p,l.to.y,c.to)}}a.effects.save(c,i?n:m);c.show();a.effects.createWrapper(c);c.css("overflow","hidden").css(c.from);if(e=="content"||e=="both"){k=k.concat(["marginTop","marginBottom"]).concat(p);f=f.concat(["marginLeft","marginRight"]);j=n.concat(k).concat(f);c.find("*[width]").each(function(){child=a(this);if(i){a.effects.save(child,j)}var q={height:child.height(),width:child.width()};child.from={height:q.height*l.from.y,width:q.width*l.from.x};child.to={height:q.height*l.to.y,width:q.width*l.to.x};if(l.from.y!=l.to.y){child.from=a.effects.setTransition(child,k,l.from.y,child.from);child.to=a.effects.setTransition(child,k,l.to.y,child.to)}if(l.from.x!=l.to.x){child.from=a.effects.setTransition(child,f,l.from.x,child.from);child.to=a.effects.setTransition(child,f,l.to.x,child.to)}child.css(child.from);child.animate(child.to,b.duration,b.options.easing,function(){if(i){a.effects.restore(child,j)}})})}c.animate(c.to,{queue:false,duration:b.duration,easing:b.options.easing,complete:function(){if(c.to.opacity===0){c.css("opacity",c.from.opacity)}if(g=="hide"){c.hide()}a.effects.restore(c,i?n:m);a.effects.removeWrapper(c);if(b.callback){b.callback.apply(this,arguments)}c.dequeue()}})})}})(jQuery);;/*
108 |  * jQuery UI Effects Slide 1.8rc1
109 |  *
110 |  * Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
111 |  * Dual licensed under the MIT (MIT-LICENSE.txt)
112 |  * and GPL (GPL-LICENSE.txt) licenses.
113 |  *
114 |  * http://docs.jquery.com/UI/Effects/Slide
115 |  *
116 |  * Depends:
117 |  *	jquery.effects.core.js
118 |  */
(function(a){a.effects.slide=function(b){return this.queue(function(){var e=a(this),d=["position","top","left"];var i=a.effects.setMode(e,b.options.mode||"show");var h=b.options.direction||"left";a.effects.save(e,d);e.show();a.effects.createWrapper(e).css({overflow:"hidden"});var f=(h=="up"||h=="down")?"top":"left";var c=(h=="up"||h=="left")?"pos":"neg";var j=b.options.distance||(f=="top"?e.outerHeight({margin:true}):e.outerWidth({margin:true}));if(i=="show"){e.css(f,c=="pos"?-j:j)}var g={};g[f]=(i=="show"?(c=="pos"?"+=":"-="):(c=="pos"?"-=":"+="))+j;e.animate(g,{queue:false,duration:b.duration,easing:b.options.easing,complete:function(){if(i=="hide"){e.hide()}a.effects.restore(e,d);a.effects.removeWrapper(e);if(b.callback){b.callback.apply(this,arguments)}e.dequeue()}})})}})(jQuery);;


--------------------------------------------------------------------------------