Merge git://github.com/damianmichna/gitmagic
[gitmagic.git] / pl / basic.txt
blob1f3f7da55b241aa8afe3c299b4c6f27dc10dcd8c
1 == Pierwsze kroki ==
3 Zanim utoniemy w morzu poleceń Gita, przyjrzyjmy się najpierw kilku prostym poleceniom. Pomimo ich prostoty, wszystkie jednak są ważne i pożyteczne. W rzeczywistości, podczas pierwszych miesięcy pracy z Git nie wychodziłem poza zakres opisany w tym rozdziale
5 === Zabezpieczenie obecnego stanu ===
7 Zamierzasz przeprowadzić jakieś drastyczne zmiany? Zanim to zrobisz, zabezpiecz najpierw dane w aktualnym katalogu.
9  $ git init
10  $ git add .
11  $ git commit -m "Mój pierwszy commit"
13 Teraz, jeśli cokolwiek stałoby się z twymi plikami podczas edycji, możesz przywrócić pierwotną wersję:
15  $ git reset --hard
17 Aby zapisać nową wersję:
19  $ git commit -a -m "Mój następny commit"
21 === Dodanie, kasowanie i zmiana nazwy ===
23 Powyższa komenda zatrzyma jedynie pliki, które już istniały podczas gdy po raz pierwszy wykonałaś polecenie *git add*. Jeśli w międzyczasie dodałaś jakieś nowe pliki, Git musi zostać o tym poinformowany:
25  $ git add readme.txt Dokumentacja
27 To samo, gdy zechcesz by Git zapomniał o wybranych plikach:
29  $ git rm ramsch.h archaiczne.c
30  $ git rm -r obciążający/materiał/
32 Jeśli sam tego jeszcze nie zrobiłaś, to Git usunie pliki za ciebie.
34 Zmiana nazwy pliku, to jak jego skasowanie i ponowne utworzenie z nową nazwą. Git wykorzystuje do tego skrót *git mv*, który posiada tą samą składnię co polecenie *mv*. Na przykład:
36  $ git mv bug.c feature.c
38 === Zaawansowane anulowanie/przywracanie ===
40 Czasami zechcesz po prostu cofnąć się w czasie, zapominając o wszystkich wprowadzonych od tego punktu zmianach. Wtedy:
42  $ git log
44 pokaże ci listę dotychczasowych 'commits' i ich sum kontrolnych SHA1:
46 ----------------------------------
47 commit 766f9881690d240ba334153047649b8b8f11c664 Author: Bob <bob@example.com>
48 Date: Tue Mar 14 01:59:26 2000 -0800
50     Zamień printf() na write().
52 commit 82f5ea346a2e651544956a8653c0f58dc151275c
53 Author: Alicja <alicja@example.com>
54 Date: Thu Jan 1 00:00:00 1970 +0000
56     Initial commit.
57 ----------------------------------
59 Kilka początkowych znaków sumy kontrolnej SHA1 wystarcza by jednoznacznie zidentyfikować 'commit', alternatywnie możesz skopiować i wkleić cały hash. Wpisując:
61  $ git reset --hard 766f
63 przywrócisz stan do wersji żądanego 'commit', a wszystkie późniejsze zmiany zostaną bezpowrotnie skasowane.
65 Innym razem chcesz tylko na moment przejść do jednej z poprzednich wersji. W tym wypadku użyj komendy:
67  $ git checkout 82f5
69 Tym poleceniem wrócisz się w czasie zachowując nowsze zmiany. Ale, tak samo jak w podróżach w czasie z filmów science-fiction - jeśli teraz dokonasz zmian i zapamiętasz je poleceniem 'commit', zostaniesz przeniesiona do alternatywnej rzeczywistości, ponieważ twoje zmiany różnią się od już dokonanych w późniejszych punktach czasu.
71 Tą alternatywną rzeczywistość nazywamy 'branch', a <<branch,zajmiemy się tym w późniejszym czasie>>. Na razie, zapamiętaj tylko, że:
73  $ git checkout master
75 sprowadzi cię znów do teraźniejszości. Również, aby uprzedzić narzekanie Gita, powinnaś przed każdym 'checkout' wykonać 'commit' lub 'reset'.
77 Korzystając ponownie z analogii do gier komputerowych:
79 - *`git reset --hard`*: załaduj jakiś starszy stan gry i skasuj wszystkie nowsze niż właśnie ładowany.
81 - *`git checkout`*:  Załaduj stary stan, grając dalej, twój stan będzie się różnił od nowszych zapamiętanych. Każdy stan, który zapamiętasz od teraz, powstanie jako osobna gałęź ('branch'), reprezentującym alternatywną rzeczywistość. <<branch,Wrócimy do tego później>>
83 Jeśli chcesz, możesz przywrócić jedynie wybrane pliki lub katalogi poprzez dodanie ich nazw do polecenia:
85  $ git checkout 82f5 jeden.plik inny.plik
87 Bądź ostrożna, ten sposób użycia komendy *checkout* może bez uprzedzenia skasować pliki. Aby zabezpieczyć się przed takimi wypadkami powinnaś zawsze zrobić 'commit' zanim wpiszesz 'checkout', szczególnie w okresie poznawania Gita. Jeśli czujesz się niepewnie przed wykonaniem jakiejś operacji Gita, generalną zasadą powinno stać się dla ciebie uprzednie wykonanie *git commit -a*.
89 Nie lubisz kopiować i wklejać hashów SHA1? Możesz w tym wypadku skorzystać z:
91  $ git checkout :/"Mój pierwszy c"
93 by przenieś się do 'commit', którego opis rozpoczyna się jak zawarta wiadomość. Możesz również cofnąć się do piątego z ostatnio zapamiętanych 'commit':
95  $ git checkout master~5
97 === Przywracanie ===
99 W sali sądowej pewne zdarzenia mogą zostać wykreślone z akt. Podobnie możesz zaznaczyć pewne 'commits' do wykreślenia.
101  $ git commit -a
102  $ git revert 1b6d
104 To polecenie wymaże 'commit' o wybranym hashu. Ten rewers zostanie zapamiętany jednak jako nowy 'commit', co można sprawdzić poleceniem *git log*.
106 === Generowanie listy zmian ===
108 Niektóre projekty wymagają http://en.wikipedia.org/wiki/Changelog[pliku changelog]. Wygenerujesz go poleceniem:
110  $ git log > changelog
112 === Ładowanie plików ===
114 Kopię projektu zarządzanego za pomocą Gita uzyskasz poleceniem:
116  $ git clone git://ścieżka/do/projektu
118 By na przykład zładować wszystkie dane, których użyłem do stworzenia tej strony skorzystaj z:
120  $ git clone git://git.or.cz/gitmagic.git
122 Do polecenia 'clone' wrócimy niebawem.
124 === Najnowszy stan ===
126 Jeśli posiadasz już kopię projektu wykonaną za pomocą *git clone*, możesz ją zaktualizować poleceniem:
128  $ git pull
130 === Szybka publikacja ===
132 Przypuśćmy, że napisałaś skrypt i chcesz go udostępnić innym. Mogłabyś poprosić ich, by zładowali go bezpośrednio z twojego komputera. Jeśli jednak zrobią to podczas gdy ty jeszcze wprowadzasz poprawki lub eksperymentujesz ze zmianami, mogłabyś przysporzyć im nieprzyjemności. Z tego powodu istnieje coś takiego jak cykl wydawniczy. Programiści regularnie pracują nad projektem, upubliczniają kod jednak dopiero, jeśli uznają, że nadaje się już do pokazania.
134 Aby wykonać to za pomocą GIT, wejdź do katalogu w którym znajduje się twój skrypt:
136  $ git init
137  $ git add .
138  $ git commit -m "Pierwsze wydanie"
140 Następnie poproś twych użytkowników o wykonanie:
142  $ git clone twój.komputer:/ścieżka/do/skryptu
144 by zładować twój skrypt. Zakładamy tu posiadanie przez nich klucza SSH do twojego komputera. Jeśli go nie mają, uruchom *git daemon* i podaj im następujący link:
146  $ git clone git://twój.komputer/ścieżka/do/skryptu
148 Od teraz, zawsze gdy uznasz, że wersja nadaje się do opublikowania, wykonaj polecenie:
150  $ git commit -a -m "Następna wersja"
152 a twoi użytkownicy, po wejściu do katalogu zawierającego twój skrypt, będą go mogli zaktualizować poprzez:
154  $ git pull
156 Twoi użytkownicy nigdy nie wejdą w posiadanie wersji, których nie chcesz im udostępniać.
158 === A co robiłem ostatnio? ===
160 Jeśli chcesz zobaczyć zmiany, które wprowadziłaś od ostatniego 'commit', wpisz:
162  $ git diff
164 Albo tylko zmiany od wczoraj:
166  $ git diff "@{yesterday}"
168 Albo miedzy określoną wersją i dwoma poprzedzającymi:
170  $ git diff 1b6d "master~2"
172 Za każdym razem uzyskane informacje są równocześnie patchem, który poprzez *git apply* może być zastosowany. Spróbuj również:
174  $ git whatchanged --since="2 weeks ago"
176 Jeśli chcę sprawdzić listę zmian jakiegoś repozytorium, często korzystam z http://sourceforge.net/projects/qgit[qgit], ze względu na jego fotogeniczny interfejs, albo z http://jonas.nitro.dk/tig/[tig], tekstowy interfejs, działający zadowalająco gdy mamy do czynienia z wolnym łączem internetowym. Alternatywnie, zainstaluj serwer HTTP, uruchom *git instaweb* i odpal dowolną przeglądarkę internetową.
178 === Ćwiczenie ===
180 Niech A, B, C i D będą 4 następującymi po sobie 'commits', gdzie B różni się od A, jedynie tym, iż usunięto kilka plików. Chcemy teraz te usunięte pliki zrekonstruować do D. Jak to można zrobić?
182 Istnieją przynajmniej 3 rozwiązania. Załóżmy że znajdujemy się obecnie w D:
184 1. Różnica pomiędzy A i B, to skasowane pliki. Możemy utworzyć patch, który pokaże te różnice i następnie zastosować go:
186  $ git diff B A | git apply
188 2. Ponieważ pliki zostały już raz zapamiętane w A, możemy je przywrócić:
190  $ git checkout A foo.c bar.h
192 3. Możemy też widzieć przejście z A na B jako zmianę, którą można zrewertować:
194  $ git revert B
196 A które z tych rozwiązań jest najlepsze? To, które najbardziej tobie odpowiada. Korzystając z Git łatwo osiągnąć cel, czasami prowadzi do niego wiele dróg.