-
Notifications
You must be signed in to change notification settings - Fork 0
/
index-ru.html
383 lines (300 loc) · 26.1 KB
/
index-ru.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
<!DOCTYPE html>
<html lang="ru">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Git: наглядная справка</title>
<link rel='stylesheet' type='text/css' href='visual-git-guide.css'>
<link rel="icon" href="./img/favicon.ico" type="image/x-icon">
<script type="text/javascript" src='visual-git-guide.js'></script>
<script data-goatcounter="https://apotitech.goatcounter.com/count"
async src="goatcounter.js"></script>
</head>
<body onload="replace_all_PNGs();">
<button id="dark-mode-toggle">Toggle Dark Mode</button>
<h1 id="top">Git: наглядная справка</h1>
<div id="language-box">
<a>На других языках:</a>
<ul>
<li><a href='index-de.html'>Deutsch</a></li>
<li><a href='index-en.html'>English</a></li>
<li><a href='index-es.html'>Español</a></li>
<li><a href='index-fr.html'>Français</a></li>
<li><a href='index-it.html'>Italiano</a></li>
<li><a href='index-ja.html'>日本語</a></li>
<li><a href='index-ko.html'>한국어</a></li>
<li><a href='index-pl.html'>Polski</a></li>
<li><a href='index-pt.html'>Português</a></li>
<li class="selected">Русский</li>
<li><a href='index-sk.html'>Slovenčina</a></li>
<li><a href='index-vi.html'>Tiếng Việt</a></li>
<li><a href='index-zh-cn.html'>简体中文</a></li>
<li><a href='index-zh-tw.html'>正體中文</a></li>
</ul>
</div>
<p id="link-to-png">Если вы не видите иллюстраций, попробуйте переключиться
на версию со <a href="?no-svg">стандартными картинками</a> (без SVG).</p>
<p id="link-to-svg">SVG изображения были отключены.
<a href="index.html">(Включить SVG изображения)</a></p>
<p>На этой странице представлена краткая наглядная справка для наиболее часто
используемых команд git. Если у вас уже есть небольшой опыт работы с git,
эта страница поможет вам закрепить ваши знания. Если вам интересно, как был
создан этот сайт, загляните на мой
<a href='http://github.com/apotitech/visual-git-guide'>репозиторий на
GitHub</a>.</p>
<h2 id="contents">Содержание</h2>
<ol>
<li><a href="#basic-usage">Основные команды</a></li>
<li><a href="#conventions">Соглашения</a></li>
<li><a href="#commands-in-detail">Подробно о командах</a>
<ol>
<li><a href="#diff">Diff</a></li>
<li><a href="#commit">Commit</a></li>
<li><a href="#checkout">Checkout</a></li>
<li><a href="#detached">Коммит из состояния «Detached HEAD»</a></li>
<li><a href="#reset">Reset</a></li>
<li><a href="#merge">Merge</a></li>
<li><a href="#cherry-pick">Cherry Pick</a></li>
<li><a href="#rebase">Rebase</a></li>
</ol>
</li>
<li><a href="#technical-notes">Технические заметки</a></li>
</ol>
<h2 id="basic-usage">Основные команды</h2>
<div class="center"><img src='basic-usage.svg.png'></div>
<p>Следующие четыре команды предназначены для копирования файлов между
рабочей директорией, сценой, также известной как «индекс», и историей,
представленной в форме коммитов.</p>
<ul>
<li><code>git add <em>файлы</em></code> копирует <em>файлы</em> в их
текущем состоянии на сцену.</li>
<li><code>git commit</code> сохраняет снимок сцены в виде коммита.</li>
<li><code>git reset -- <em>файлы</em></code> восстанавливает файлы на
сцене, а именно копирует <em>файлы</em> из последнего коммита на сцену.
Используйте эту команду для отмены изменений, внесённых командой
<code>git add <em>файлы</em></code>. Вы также можете выполнить
<code>git reset</code>, чтобы восстановить все файлы на сцене.</li>
<li><code>git checkout -- <em>файлы</em></code> копирует <em>файлы</em> со
сцены в рабочую директорию. Эту команду удобно использовать, чтобы
сбросить нежелательные изменения в рабочей директории.</li>
</ul>
<p>Вы можете использовать <code>git reset -p</code>,
<code>git checkout -p</code>, и <code>git add -p</code> вместо имён файлов
или вместе с ними, чтобы в интерактивном режиме выбирать, какие именно
изменения будут скопированы.</p>
<p>Также можно перепрыгнуть через сцену и сразу же получить файлы из истории
прямо в рабочую директорию или сделать коммит, минуя сцену.</p>
<div class="center"><img src='basic-usage-2.svg.png'></div>
<ul>
<li><code>git commit -a </code> аналогичен запуску двух команд:
<tt>git add</tt> для всех файлов, которые существовали в предыдущем
коммите, и <tt>git commit</tt>.</li>
<li><code>git commit <em>файлы</em></code> создаёт новый коммит, в основе
которого лежат уже существующие файлы, добавляя изменения только для
указанных <em>файлов</em>. Одновременно, указанные <em>файлы</em> будут
скопированы на сцену.</li>
<li><code>git checkout HEAD -- <em>файлы</em></code> копирует
<em>файлы</em> из текущего коммита и на сцену, и в рабочую
директорию.</li>
</ul>
<h2 id="conventions">Соглашения</h2>
<p>Иллюстрации в этой справке выдержаны в единой цветовой схеме.</p>
<div class="center"><img src='conventions.svg.png'></div>
<p>Коммиты раскрашены зелёным цветом и подписаны 5-ти буквенными
идентификаторами. Каждый коммит указывает на своего родителя зелёной
стрелочкой. Ветки раскрашены оранжевым цветом; ветки указывают на коммиты.
Специальная ссылка <em>HEAD</em> указывает на текущую ветку. На иллюстрации
вы можете увидеть последние пять коммитов. Самый последний коммит имеет хеш
<em>ed489</em>. <em>main</em> (текущая ветка) указывает на этот коммит,
<em>stable</em> (другая ветка) указывает на предка <em>main</em>-ового
коммита.</p>
<h2 id="commands-in-detail">Подробно о командах</h2>
<h3 id="diff">Diff</h3>
<p>Есть много способов посмотреть изменения между коммитами. Ниже вы
увидите несколько простых примеров. К каждой из этих команд можно добавить
имена файлов в качестве дополнительного аргумента. Так мы выведем
информацию об изменениях только для перечисленных файлов.</p>
<div class="center"><img src='diff.svg.png'></div>
<h3 id="commit">Commit</h3>
<p>Когда вы делаете коммит, git создаёт новый объект коммита, используя файлы
со сцены, а текущей коммит становится родителем для нового. После этого
указатель текущей ветки перемещается на новый коммит. Вы это видите на
картинке, где <em>main</em> — это текущая ветка. До совершения коммита
<em>main</em> указывал на коммит <em>ed489</em>. После добавления нового
коммита <em>f0cec</em>, родителем которого стал <em>ed489</em>, указатель
ветки <em>main</em> был перемещён на новый коммит.</p>
<div class="center"><img src='commit-main.svg.png'></div>
<p>То же самое происходит, если одна ветка является предком другой ветки.
Ниже показан пример нового коммита <em>1800b</em> в ветке <em>stable</em>,
которая является предком ветки <em>main</em>. После этого ветка
<em>stable</em> уже больше не является предком ветки <em>main</em>. И в
случае необходимости объединения работы, проделанной в этих разделённых
ветках, вам следует воспользоваться командой <a href='#merge'>merge</a> (что
более предпочтительно) или <a href='#rebase'>rebase</a>.</p>
<div class="center"><img src='commit-stable.svg.png'></div>
<p>Если вы сделали ошибку в последнем коммите, её легко исправить с помощью
команды <code>git commit --amend</code>. Эта команда создаёт новый коммит,
родителем которого будет родитель ошибочного коммита. Старый ошибочный
коммит будет отброшен, конечно же если только на него не будет ещё
каких-либо других ссылок, что маловероятно.</p>
<div class="center"><img src='commit-amend.svg.png'></div>
<p>Четвертый случай коммита из состояния «<a href="#detached">detached
HEAD</a>» будет рассмотрен далее.</p>
<h3 id="checkout">Checkout</h3>
<p>Команда checkout используется для копирования файлов из истории или сцены
в рабочую директорию. Также она может использоваться для переключения между
ветками.</p>
<p>Когда вы указываете имя файла (и/или ключ <code>-p</code>), git копирует
эти файлы из указанного коммита на сцену и в рабочую директорию. Например,
<code>git checkout HEAD~ foo.c</code> копирует файл <code>foo.c</code>
из коммита <em>HEAD~</em> (предка текущего коммита) в рабочую директорию и на
сцену. Если имя коммита не указано, то файл будет скопирован со сцены в
рабочую директорию. Обратите внимание на то, что при выполнении команды
<code>checkout</code> позиция указателя текущей ветки (HEAD) остаётся
прежней, указатель никуда не перемещается.</p>
<div class="center"><img src='checkout-files.svg.png'></div>
<p>В том случае, если мы <em>не указываем</em> имя файла, но указываем имя
локальной ветки, то указатель <em>HEAD</em> будет перемещён на эту ветку, то
есть мы переключимся на эту ветку. При этом сцена и рабочая директория будут
приведены в соответствие с этим коммитом. Любой файл, который присутствует в
новом коммите (<em>a47c3</em> ниже), будет скопирован из истории; любой файл,
который был в старом коммите (<em>ed489</em>), но отсутствует в новом, будет
удалён; любой файл, который не записан ни в одном коммите, будет
проигнорирован.</p>
<div class="center"><img src='checkout-branch.svg.png'></div>
<p>В том случае, если мы <em>не указываем</em> имя файла, и
<em>не указываем</em> имя локальной ветки, а указываем тег, дистанционную
(remote) ветку, SHA-1 хеш коммита или что-то вроде <em>main~3</em>, то мы
получаем безымянную ветку, называемую «<em>Detached HEAD</em>» (оторванная
голова). Это очень полезная штука, если нам надо осмотреться в истории
коммитов. К примеру, вам захочется скомпилировать git версии 1.6.6.1. Вы
можете набрать <code>git checkout v1.6.6.1</code> (это тег, не ветка),
скомпилировать, установить, а затем вернуться в другую ветку, скажем
<code>git checkout main</code>. Тем не менее, коммиты из состояния
«Detached HEAD» происходят по своим особым важным правилам, и мы рассмотрим
их <a href="#detached">ниже</a>.</p>
<div class="center"><img src='checkout-detached.svg.png'></div>
<h3 id="detached">Коммит из состояния «Detached HEAD»</h3>
<p>Когда мы находимся в состоянии оторванной головы
(<em>Detached HEAD</em>), коммит совершается по тем же правилам, что и
обычно, за исключением одной маленькой особенности: ни один указатель ветки
не будет изменён или добавлен к новому коммиту. Вы можете представить эту
ситуацию как работу с анонимной веткой.</p>
<div class="center"><img src='commit-detached.svg.png'></div>
<p>Если после такого коммита вы переключитесь в ветку <em>main</em>,
то коммит <em>2eecb</em>, совершённый из состояния «Detached HEAD»,
потеряется и попросту будет уничтожен очередной сборкой мусора только потому,
что нет ни одного объекта, который бы на него ссылался: ни ветки, ни
тега.</p>
<div class="center"><img src='checkout-after-detached.svg.png'></div>
<p>В том случае, если вы хотите сохранить этот коммит на будущее, вы можете
создать на основе него новую ветку командой
<code>git checkout -b <em>new</em></code>.</p>
<div class="center"><img src='checkout-b-detached.svg.png'></div>
<h3 id="reset">Reset</h3>
<p>Команда reset перемещает указатель текущей ветки в другую позицию и
дополнительно может обновить сцену и рабочую директорию. Эту команду можно
также использовать для того, чтобы скопировать файл из истории на сцену, не
задевая рабочую директорию.</p>
<p>Если коммит указан без имён файлов, указатель ветки будет перемещён на
этот коммит, а затем сцена приведётся в соответствие с этим коммитом. Если
мы используем ключ <code>--soft</code>, то сцена не будет изменена. Если мы
используем ключ <code>--hard</code>, то будет обновлена и сцена, и рабочая
директория.</p>
<div class="center"><img src='reset-commit.svg.png'></div>
<p>Если имя коммита не будет указано, по умолчанию оно будет <em>HEAD</em>.
В этом случае указатель ветки не будет перемещён, но сцена (а также и
рабочая директория, если был использован ключ <code>--hard</code>) будет
приведена к состоянию последнего коммита.</p>
<div class="center"><img src='reset.svg.png'></div>
<p>Если в команде указано имя файла (и/или ключ <code>-p</code>), то команда
работает так же, как <a href='#checkout'>checkout</a> с именем файла, за
исключением того, что только сцена (но не рабочая директория) будет
изменена. Если вы подставите имя коммита на место двойной черты, вы сможете
получить состояние файла из этого коммита, тогда как в случае с двойной
чертой вы получите состояние файла из коммита, на который указывает
<em>HEAD</em>.</p>
<div class="center"><img src='reset-files.svg.png'></div>
<h3 id="merge">Merge</h3>
<p>Команда merge (слияние) создает новый коммит на основе текущего коммита,
применяя изменения других коммитов. Перед слиянием сцена должна быть
приведена в соответствие с текущим коммитом. Самый простой случай слияния —
это когда другой коммит является предком текущего коммита: в этом случае
ничего не происходит. Другой простой случай слияния — когда текущий коммит
является предком другого коммита: в этом случае происходит <em>быстрая
перемотка</em> (<em>fast-forward</em>). Ссылка текущей ветки будет просто
перемещена на новый коммит, а сцена и рабочая директория будут приведены в
соответствие с новым коммитом.</p>
<div class="center"><img src='merge-ff.svg.png'></div>
<p>Во всех других случаях выполняется «настоящее» слияние. Вы можете
изменить стратегию слияния, но по умолчанию будет выполнено «рекурсивное»
слияние, для которого будет взят текущий коммит (<em>ed489</em> ниже на
схеме), другой коммит (<em>33104</em>) и их общий предок (<em>b325c</em>); и
для этих трех коммитов будет выполнено
<a href='http://en.wikipedia.org/wiki/Three-way_merge'>трёхстороннее
слияние</a>. Результат этого слияния будет записан в рабочую директорию и на
сцену, и будет добавлен результирующий коммит со вторым родителем
(<em>33104</em>).</p>
<div class="center"><img src='merge.svg.png'></div>
<h3 id="cherry-pick">Cherry Pick</h3>
<p>Команда cherry-pick («вишенка в тортике») создаёт новый коммит на основе
только одного сладкого «коммита-вишенки», применив все его изменения
и сообщение.</p>
<div class="center"><img src='cherry-pick.svg.png'></div>
<h3 id="rebase">Rebase</h3>
<p>Перебазирование (rebase) — это альтернатива <a href='#merge'>слиянию</a>
для задач объединения нескольких веток. Если слияние создаёт новый коммит с
двумя родителями, оставляя нелинейную историю, то перебазирование применяет
все коммиты один за одним из одной ветки в другую, оставляя за собой
линейную историю коммитов. По сути это автоматическое выполнение нескольких
команд <a href='#cherry-pick'>cherry-pick</a> подряд.</p>
<div class="center"><img src='rebase.svg.png'></div>
<p>На схеме выше вы видите как команда берёт все коммиты, которые есть в
ветке <em>topic</em>, но отсутствуют в ветке <em>main</em> (коммиты
<em>169a6</em> and <em>2c33a</em>), и воспроизводит их в ветке
<em>main</em>. Затем указатель ветки перемещается на новое место. Следует
заметить, что старые коммиты будут уничтожены сборщиком мусора, если на них
уже ничего не будет ссылаться.</p>
<p>Используйте ключ <code>--onto</code> чтобы ограничить глубину захвата
объединяемой ветки. На следующей схеме вы можете увидеть как в ветку
<em>main</em> приходят лишь последние коммиты из текущей ветки, а именно
коммиты после (но не включая) <em>169a6</em>, т. е. <em>2c33a</em>.</p>
<div class="center"><img src='rebase-onto.svg.png'></div>
<p>Есть также интерактивный режим перебазирования <code>git rebase
--interactive</code>, с помощью которого вы сможете сделать вещи похитрее
простого линейного применения коммитов, а именно сбрасывание (dropping),
изменение порядка (reordering), правка (modifying) и выдавливание
(squashing) коммитов. Нет наглядной схемы, чтобы показать эти возможности;
за описанием лучше обратиться к справке по <a
href='http://www.kernel.org/pub/software/scm/git/docs/git-rebase.html#_interactive_mode'>git-rebase(1)</a>.</p>
<h2 id="technical-notes">Технические заметки</h2>
<p>Содержание файлов не хранится в индексе (<em>.git/index</em>) или в
объектах коммитов. Правильнее было бы сказать, что каждый файл хранится в
базе данных объектов (<em>.git/objects</em>) в <em>двоичном
представлении</em>; найти этот файл можно по его SHA-1 хешу. В файле индекса
записаны имена файлов, их хеши и дополнительная информация. В информации о
коммитах вы встретите тип данных <em>дерево</em>, для идентификации которого
также используется SHA-1 хеш. Деревья описывают директории в рабочей
директории, а также содержат информацию о других деревьях и файлах,
принадлежащих обозначенному дереву. Каждый коммит хранит идентификатор
своего верхнего дерева, которое содержит все файлы и другие деревья,
изменённые в этом коммите.</p>
<p>Если вы делаете коммит из состояния «оторванной головы» (detached HEAD),
то на этот коммит будет ссылаться ссылка истории HEAD. Но рано или поздно
время хранения этой ссылки истечёт, и этот коммит будет уничтожен сборщиком
мусора точно так же, как это делается при выполнении команд
<code>git commit --amend</code> и <code>git rebase</code>.</p>
<hr>
<p>Copyright © 2010,
<a href='mailto:[email protected]'>Lionel Tchami</a>.
Russian translation © 2012,
<a href='mailto:[email protected]'>Alex Sychev</a>.
</p>
<p><a rel="license"
href="https://creativecommons.org/licenses/by-nc-sa/3.0/us/deed.ru"><img
alt="" src="https://i.creativecommons.org/l/by-nc-sa/3.0/us/80x15.png"></a>
Это произведение доступно по <a rel="license"
href="https://creativecommons.org/licenses/by-nc-sa/3.0/us/deed.ru">лицензии
Creative Commons Attribution-NonCommercial-ShareAlike (Атрибуция —
Некоммерческое использование — С сохранением условий) 3.0 США</a>.</p>
</body>
</html>