uk/basic.txt

   1 == Базові операції ==
   2
   3 Перш ніж занурюватися в нетрі численних команд Git, спробуйте скористатися наведеними нижче простими прикладами, щоб трохи освоїтися. Кожен із них корисний, незважаючи на свою простоту. Насправді перші місяці використання Git я не виходив за рамки матеріалу цього розділу.
   4
   5 === Збереження стану ===
   6
   7 Збираєтеся спробувати внести якісь радикальні зміни? Попередньо створіть знімок всіх файлів у поточному каталозі за допомогою команд
   8
   9  $ git init
  10  $ git add .
  11  $ git commit -m "Моя перша резервна копія"
  12
  13 Тепер, якщо нові правки все зіпсували, можна відновити початкову версію:
  14
  15  $ git reset --hard
  16
  17 Щоб зберегти стан знову:
  18
  19  $ git commit -a -m "Друга резервна копія"
  20
  21 === Додавання, видалення, перейменування ===
  22
  23 Наведений вище приклад відстежує лише ті файли, які існували при першому запуску *git add*. Якщо ви створили нові файли або підкаталоги, доведеться сказати Git'у:
  24
  25  $ git add readme.txt Documentation
  26
  27 Аналогічно, якщо хочете, щоб Git забув про деякі файли:
  28
  29  $ git rm kludge.h obsolete.c
  30  $ git rm -r incriminating/evidence/
  31
  32 Git видалить ці файли, якщо ви не видалили їх самі.
  33
  34 Перейменування файлу - це те ж саме, що й видалення старого імені та додавання нового. Для цього є *git mv*, яка має той же синтаксис, що і команда *mv*. наприклад:
  35
  36  $ git mv bug.c feature.c
  37
  38 === Розширені скасування/повернення ===
  39
  40 Іноді просто хочеться повернутися назад і забути всі зміни до певного моменту, тому що всі вони були неправильними. У такому випадку
  41
  42  $ git log
  43
  44 покаже список останніх коммітов і їх хеші SHA1:
  45
  46 ----------------------------------
  47 commit 766f9881690d240ba334153047649b8b8f11c664
  48 Author: Bob <bob@example.com>
  49 Date:   Tue Mar 14 01:59:26 2000 -0800
  50
  51     Замінив printf() на write().
  52
  53 commit 82f5ea346a2e651544956a8653c0f58dc151275c
  54 Author: Alice <alice@example.com>
  55 Date:   Thu Jan 1 00:00:00 1970 +0000
  56
  57     Початковий комміт.
  58 ----------------------------------
  59
  60 Для вказівки комміта достатньо перших декількох символів його хешу, але можете скопіювати і весь хеш. Наберіть:
  61
  62  $ git reset --hard 766f
  63
  64 для відновлення стану до зазначеного комміта і видалення всіх наступних безповоротно.
  65
  66 Можливо, іншим разом ви захочете швидко перескочити до старого стану. У цьому випадку наберіть
  67
  68  $ git checkout 82f5
  69
  70 Ця команда перенесе вас назад у часі, зберігши при цьому більш нові комміти. Однак, як і у фантастичних фільмах про подорожі в часі, якщо тепер ви відредагуєте і закоммітите код, то потрапите в альтернативну реальність, тому що ваші дії відрізняються від тих, що були минулого разу.
  71
  72 Ця альтернативна реальність називається «гілкою» (branch, прим. пер.) і <<branch,трохи пізніше ми поговоримо про це докладніше>>. А зараз просто запам'ятайте, що команда
  73
  74  $ git checkout master
  75
  76 поверне вас назад у теперішнє. Крім того, щоб не отримувати попереджень від Git, завжди робіть commit або скидайте зміни перед запуском checkout.
  77
  78 Ще раз скористаємося аналогією з комп'ютерними іграми:
  79
  80 - *git reset --hard*: завантажує раніше збережену гру і видаляє всі версії, збережені після тількищо завантаженої.
  81
  82 - *git checkout*: завантажує стару гру, але якщо ви продовжуєте грати, стан гри буде відрізнятися від більш нових збережень, які ви зробили в перший раз. Будь-яка гра, яку ви тепер зберігаєте, потрапляє в окрему гілку, що представляє альтернативну реальність, в яку ви потрапили. <<branch,Ми обговоримо це пізніше>>.
  83
  84 Можна також відновити тільки певні файли і підкаталоги, перерахувавши їх імена після команди:
  85
  86  $ git checkout 82f5 якийсь.файл інший.файл
  87
  88 Будьте уважні: така форма *checkout* може мовчки перезаписати файли. Щоб уникнути неприємних несподіванок, виконуйте commit перед checkout, особливо якщо ви тільки вивчаєте Git. Взагалі, якщо ви не впевнені у якісь операції, чи то команда Git чи ні, виконайте попередньо *git commit -a*.
  89
  90 Не любите копіювати і вставляти хеші? Використовуйте
  91
  92  $ git checkout :/"Моя перша р"
  93
  94 для переходу на комміт, опис якого починається з наведеного рядка.
  95
  96 Можна також запитати 5-й з кінця збережений стан:
  97
  98  $ git checkout master~5
  99
 100 === Повернення ===
 101
 102 У залі суду пункти протоколу можуть викреслювати прямо під час слухання. Подібним чином і ви можете вибирати комміти для скасування.
 103
 104  $ git commit -a
 105  $ git revert 1b6d
 106
 107 скасує комміт із заданим хешем. Повернення буде збережене у вигляді нового комміта. Можете запустити *git log*, щоб переконатися в цьому.
 108
 109 === Створення списку змін ===
 110
 111 Деяким проектам потрібен http://en.wikipedia.org/wiki/Changelog[списку змін] (changelog, прим. пер.). Створіть його такою командою:
 112
 113  $ git log > ChangeLog
 114
 115 === Скачування файлів ===
 116
 117 Отримати копію проекту під управлінням Git можна, набравши
 118
 119  $ git clone git://сервер/шлях/до/файлів
 120
 121 Наприклад, щоб отримати всі файли, які я використав для створення цього документу,
 122
 123  $ git clone git://git.or.cz/gitmagic.git
 124
 125 Пізніше ми поговоримо про команду *clone* докладніше.
 126
 127 === Тримаючи руку на пульсі ===
 128
 129 Якщо ви вже завантажили копію проекту за допомогою *git clone*, можете оновити її до останньої версії, використовуючи
 130
 131  $ git pull
 132
 133 === Невідкладна публікація ===
 134
 135 Припустимо, ви написали скрипт, яким хочете поділитися з іншими. Можна просто запропонувати їм скачувати його з вашого комп'ютера, але якщо вони будуть робити це коли ви допрацьовуєте його або додаєте експериментальну функціональність, у них можуть виникнути проблеми. Очевидно, тому й існують цикли розробки. Розробники можуть постійно працювати над проектом, але загальнодоступним вони роблять свій код лише після того, як приведуть його у пристойний вигляд.
 136
 137 Щоб зробити це за допомогою Git, виконайте в каталозі, де лежить ваш скрипт,
 138
 139  $ git init
 140  $ git add .
 141  $ git commit -m "Перший реліз"
 142
 143 Потім скажіть вашим користувачам запустити
 144
 145  $ git clone ваш.комп’ютер:/шлях/до/скрипту
 146
 147 щоб завантажити ваш скрипт. Тут мається на увазі, що у них є доступ по ssh. Якщо ні, запустіть *git daemon* і скажіть користувачам запустити цю команду замість вищенаведеної:
 148
 149  $ git clone git://ваш.комп’ютер/шлях/до/скрипту
 150
 151 З цих пір щоразу, коли ваш скрипт готовий до релізу, виконуйте
 152
 153  $ git commit -a -m "Наступний реліз"
 154
 155 і ваші користувачі зможуть оновити свої версії, перейшовши в каталог з вашим скриптом і набравши
 156
 157  $ git pull
 158
 159 Ваші користувачі ніколи не наткнуться на версію скрипта, яку ви не хочете їм показувати.
 160
 161 === Що я зробив? ===
 162
 163 З'ясуйте, які зміни ви зробили з часу останнього комміта:
 164
 165  $ git diff
 166
 167 Чи з вчорашнього дня:
 168
 169  $ git diff "@{yesterday}"
 170
 171 Чи між певною версією і версією, зробленою 2 комміти назад:
 172
 173  $ git diff 1b6d "master~2"
 174
 175 У кожному разі на виході буде патч, який може бути застосований за допомогою *git apply*. Спробуйте також:
 176
 177  $ git whatchanged --since="2 weeks ago"
 178
 179 Часто замість цього я використовую для перегляду історії http://sourceforge.net/projects/qgit[qgit], через приємний інтерфейс, або http://jonas.nitro.dk/tig[tig] з текстовим інтерфейсом, який добре працює через повільне з'єднання. Як варіант, встановіть веб-сервер, введіть *git instaweb* і запустіть будь-який веб-браузер.
 180
 181 === Вправа ===
 182
 183 Нехай A, B, C, D - чотири послідовні комміти, де В відрізняється від A лише кількома видаленими файлами. Ми хочемо повернути ці файли в D. Як ми можемо це зробити?
 184
 185 Існує як мінімум три розв’язки. Припустимо, що ми знаходимося на D.
 186
 187   1. Різниця між A і B - видалені файли. Ми можемо створити патч, що відображає ці зміни, і застосувати його:
 188
 189    $ git diff B A | git apply
 190
 191   2. Оскільки в комміті A ми зберегли файли, то можемо відновити їх:
 192
 193    $ git checkout A foo.c bar.h
 194
 195   3. Ми можемо розглядати перехід від A до B як зміни, які хочемо скасувати:
 196
 197    $ git revert B
 198
 199 Який спосіб найкращий? Той, який вам більше подобається. За допомогою Git легко отримати бажане і часто існує багато способів це зробити.