From 0ff060bdfa29da213a69f4c119b8695301a0e394 Mon Sep 17 00:00:00 2001 From: Przemyslaw Szulczynski Date: Mon, 28 Apr 2014 21:18:24 +0200 Subject: [PATCH 1/8] Until Being Committed --- 03s-using-github.md.erb | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/03s-using-github.md.erb b/03s-using-github.md.erb index 76c2a71..41dffb4 100644 --- a/03s-using-github.md.erb +++ b/03s-using-github.md.erb @@ -1,16 +1,16 @@ --- -title: Using Git & GitHub +title: Używanie Git & GitHub slug: github date: 0003/01/02 number: 3.5 sidebar: true -contents: Learn how to use GitHub to follow along with the book. +contents: Jak używać GitHub pracując z książką. paragraphs: 32 --- -//// +[GitHub](https://github.com/) jest społecznościowym repozytorium dla projektów open-source bazujących na systemie kontroli wersji [Git](http://git-scm.com/) i jego podstawową funkcją jest ułatwienie współdzielenia kodu i współpracy przy pracy nad projektami. -//// +Ten rozdział zakłada, że nie jesteś zaznajomiony z Git i GitHub. Jeżeli znasz oba, możesz przeskoczyć do następnego rozdziału! ### Being Committed From 06bf222954bda6567fc17e499b84b1246f94b0ad Mon Sep 17 00:00:00 2001 From: Przemyslaw Szulczynski Date: Mon, 28 Apr 2014 21:25:32 +0200 Subject: [PATCH 2/8] Until Modifying code --- 03s-using-github.md.erb | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/03s-using-github.md.erb b/03s-using-github.md.erb index 41dffb4..ca24e9b 100644 --- a/03s-using-github.md.erb +++ b/03s-using-github.md.erb @@ -12,19 +12,19 @@ paragraphs: 32 Ten rozdział zakłada, że nie jesteś zaznajomiony z Git i GitHub. Jeżeli znasz oba, możesz przeskoczyć do następnego rozdziału! -### Being Committed +### Praca z commitami -//// +Podstawowym narzędziem, zmianą części pliku jest *commit*. Możesz myślić o commit jak o zrzucie stanu bazy plików w danym momencie czasu. -//// +Zamiast dostarczenia całego kodu Microcope, robiliśmy takie zrzuty w trakcie pisania książki i możesz je zobaczyć online na GitHub. -//// +Przykładowo, tak wygląda [ostatni commit poprzedniego rozdziału](https://github.com/DiscoverMeteor/Microscope/commit/chapter3-2): -<%= screenshot "s3-1", "A Git commit as shown on GitHub." %> +<%= screenshot "s3-1", "Commit Git wyświetlany na GitHub." %> -//// +Możesz tutaj zobaczć "diff" (skrót z ang. difference) pliku `post_item.js`, innymi słowy zmiany, jakie zostały dokonane w danym `commicie`. W tym przypadku, stworzyliśmy od postaw plik `posts_item.js`, zatem cała jego zawartość jest podświetlona na zielono. -//// +Porównajmy ten przykład z przykładem z [dalszej części książki](https://github.com/DiscoverMeteor/Microscope/commit/chapter13-1): <%= screenshot "s3-2", "Modifying code." %> From bf8a0125164b33dcf49aa4e4e77306f91b2f41b2 Mon Sep 17 00:00:00 2001 From: Przemyslaw Szulczynski Date: Mon, 28 Apr 2014 21:40:39 +0200 Subject: [PATCH 3/8] Until The repository at commit 3-2 --- 03s-using-github.md.erb | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/03s-using-github.md.erb b/03s-using-github.md.erb index ca24e9b..637df6a 100644 --- a/03s-using-github.md.erb +++ b/03s-using-github.md.erb @@ -26,27 +26,27 @@ Możesz tutaj zobaczć "diff" (skrót z ang. difference) pliku `post_item.js`, i Porównajmy ten przykład z przykładem z [dalszej części książki](https://github.com/DiscoverMeteor/Microscope/commit/chapter13-1): -<%= screenshot "s3-2", "Modifying code." %> +<%= screenshot "s3-2", "Wprowadzanie zmian kodu." %> -//// +Tym razem wyłącznie zmienione linie zostały podświetlone na zielono. -//// +Oczywiście czasami ani nie dodajesz ani zmieniasz linie kody, ale [je usuwasz](https://github.com/DiscoverMeteor/Microscope/commit/chapter12-2): -<%= screenshot "s3-3", "Deleting code." %> +<%= screenshot "s3-3", "Usuwanie kodu." %> -//// +Pierwszy raz użyliśmy GitHub: zmiany są widoczne natychmiastowo. -### Browsing A Commit's Code +### Przeglądanie kodu commita -//// +Okno przeglądania commita Gita pokazuje zmiany zawarte w danym commicie, ale czasem chciałbyś spojrzeć na pliki, które *nie uległy zmianie*, aby się upewnić, że ich zawartość jest poprawna w danym momencie czasu. -//// +Ponownie GitHub okazuje się pomocny. Gdy jesteś na stronie commita, kliknij na przycisk **Browse code**: -<%= screenshot "s3-5", "The Browse code button." %> +<%= screenshot "s3-5", "Przycisk `Browse code`." %> -//// +Będziesz miał teraz dostęp do całego repozytorium *w momencie danego commita*. -<%= screenshot "s3-6", "The repository at commit 3-2." %> +<%= screenshot "s3-6", "Repozytorium podczas commita 3-2." %> //// From 0da4c5257727ab4e7dc9c8fb111ded0432469807 Mon Sep 17 00:00:00 2001 From: Przemyslaw Szulczynski Date: Mon, 28 Apr 2014 23:26:09 +0200 Subject: [PATCH 4/8] Until cd github_microscope --- 03s-using-github.md.erb | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/03s-using-github.md.erb b/03s-using-github.md.erb index 637df6a..3937bb2 100644 --- a/03s-using-github.md.erb +++ b/03s-using-github.md.erb @@ -48,23 +48,23 @@ Będziesz miał teraz dostęp do całego repozytorium *w momencie danego commita <%= screenshot "s3-6", "Repozytorium podczas commita 3-2." %> -//// +GitHub nie pokazuje wielu wizualizacji tego, co obserwujemy patrząc na commit, ale możesz go porównać z ""normalnym" widokiem brancha `master` i zerknąć na różnice w strukturze pliku: -<%= screenshot "s3-7", "The repository at commit 14-2." %> +<%= screenshot "s3-7", "Repozytorium podczas commita 14-2." %> -### Accessing A Commit Locally +### Lokalny dostęp do commita -//// +Zobaczyliśmy przed chwilą, jak przeglądać kod danego commita online na GitHub. Ale co jeśli chciałbyć osiągnąć to samo lokalnie? Przykładowo, mógłbyś mieć ochotę na uruchomienie aplikacji lokalnie na danym commicie, aby zobaczyć jak ma się zachowywać w danym momencie czasu. -//// +Aby to osiągnąć, przejdziemy przez pierwsze kroki (przynajmniej w tej książce) z konsolową aplikacją `git`. Dla początkujących, [upewnij się, że zainstalowałeś Git](http://git-scm.com/downloads). Następnie **sklonuj** (inaczej mówiąc, pobierz z serwera kopię) repozytorium Microscope za pomocą: ~~~bash $ git clone git@github.com:DiscoverMeteor/Microscope.git github_microscope ~~~ -//// +Ostatni parametr `github_microscope` jest lokalną nazwą repozytorium, do którego będziesz klonował aplikację. Zakładając, że już posiadasz folder `microscope`, wybierz dowolną nazwę (nie musi być taka sama, jak repozytorium na GitHub). -//// +Następnie przejdźmy do tego folderu używając `cd` i zacznijmy używać konsolową aplikację `git`: ~~~bash $ cd github_microscope From cf3eee898cb1e20d238f14d88739529e2710ae79 Mon Sep 17 00:00:00 2001 From: Przemyslaw Szulczynski Date: Mon, 28 Apr 2014 23:37:51 +0200 Subject: [PATCH 5/8] Until Historical Perspective --- 03s-using-github.md.erb | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/03s-using-github.md.erb b/03s-using-github.md.erb index 3937bb2..a514816 100644 --- a/03s-using-github.md.erb +++ b/03s-using-github.md.erb @@ -70,9 +70,9 @@ Następnie przejdźmy do tego folderu używając `cd` i zacznijmy używać konso $ cd github_microscope ~~~ -//// +Teraz gdy sklonowaliśmy respozytorium z GitHub, pobraliśmy *cały* kod aplikacji, co oznacza że mamy dostęp do najnowszego commita. -//// +Na szczęście jest możliwość wrócenia do dowolnego miejsca w czasie i pobranie (ang. "check out") danego commita bez wpływania na pozostałe. Wypróbujmy to teraz: ~~~bash $ git checkout chapter3-1 @@ -90,17 +90,17 @@ do so (now or later) by using -b with the checkout command again. Example: HEAD is now at a004b56... Added basic posts list template and static data. ~~~ -//// +Git poinformował, że jesteśmy obecnie w stanie “detached HEAD”, co oznacza, że możemy obserwować poprzednie commity, ale nie możemy ich modyfikować. Możesz wyobrazić sobie w tym momencie wróżkę patrzącą w szklaną kulę. -//// +(Uwaga: Git posiada w swoim arsenale również komendy pozwalające na *zmianę* poprzednich commitów. Tu mógłbyś wyobrazić sobie podróżnika w czasie zmieniającego przeszłość, ale jest to poza zakresem tego krótkiego wstępu do Gita). -//// +Powodem, dla którego mogłeś wpisać `chapter3-1` jest to, że otagowaliśmy wszystkie commity Microscope poprawnym znacznikiem rozdziału. Gdybyśmy tego nie zrobili, konieczne byłoby odnalezienie **hasha** lub mówiąc inaczej unikalnego idetyikatora danego commita. -//// +Ponownie w takim przypadku GitHub ułatwia pracę. Można znaleźć tag commita w dolnym prawym rogu niebieskiego przycisku nagłówka, jak pokazano poniżej: -<%= screenshot "s3-4", "Finding a commit hash." %> +<%= screenshot "s3-4", "Znajdowanie hasha commita." %> -//// +Wypróbujmy zatem użyć hash zamiast taga: ~~~bash $ git checkout c7af59e425cd4e17c20cf99e51c8cd78f82c9932 @@ -108,7 +108,7 @@ Previous HEAD position was a004b56... Added basic posts list template and static HEAD is now at c7af59e... Augmented the postsList route to take a limit ~~~ -//// +A co, jeżeli znudzi nam się patrzenie w szklaną kulę i chcemy wrócić do stanu początkowego? W takim przypadku nakazujemy Git, aby pobrał branch **master**: ~~~bash $ git checkout master From 2ef3084b73af304b6ba4064152e25e8846c7225f Mon Sep 17 00:00:00 2001 From: Przemyslaw Szulczynski Date: Mon, 28 Apr 2014 23:46:38 +0200 Subject: [PATCH 6/8] Until GitHub's History button --- 03s-using-github.md.erb | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/03s-using-github.md.erb b/03s-using-github.md.erb index a514816..f3a2363 100644 --- a/03s-using-github.md.erb +++ b/03s-using-github.md.erb @@ -114,11 +114,13 @@ A co, jeżeli znudzi nam się patrzenie w szklaną kulę i chcemy wrócić do st $ git checkout master ~~~ -### Historical Perspective +Zanotuj, że możesz również uruchomić aplikację za pomocą komendy `meteor` w dowolnym momencie tego procesu, nawet w stanie "detached HEAD". Może zaistnieć konieczność zawołania `mrt update` jeżeli Meteor wyświetli komunikat błędu o brakującym pakiecie, ponieważ kod pakietów nie jest dołączony do repozytorium Git dla Microscope. -//// +### Oglądanie historii zmian -//// +Często napotkasz następujący scenariusz: patrzysz na plik i zauważasz zmiany, których wcześniej nie widziałeś. Nie pamiętasz *kiedy* plik uległ zmianie. Możesz sprawdzić każdy commit po kolei, aż nie znajdziesz prawidłowego, ale istnieje łatwiejszy sposób aby to odnaleźć dzięki funkcji **Historia** (ang. History) w GitHub. + +Po pierwsze, znajdź dany plik w repozytorium w GitHub, następnie odszukaj przycisk "History. <%= screenshot "s3-8", "GitHub's History button." %> From 1e3829f86f5cb049403faae9f840d16733afd492 Mon Sep 17 00:00:00 2001 From: Przemyslaw Szulczynski Date: Mon, 28 Apr 2014 23:48:45 +0200 Subject: [PATCH 7/8] Until The Blame Game --- 03s-using-github.md.erb | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/03s-using-github.md.erb b/03s-using-github.md.erb index f3a2363..b5ab2e9 100644 --- a/03s-using-github.md.erb +++ b/03s-using-github.md.erb @@ -122,13 +122,13 @@ Często napotkasz następujący scenariusz: patrzysz na plik i zauważasz zmiany Po pierwsze, znajdź dany plik w repozytorium w GitHub, następnie odszukaj przycisk "History. -<%= screenshot "s3-8", "GitHub's History button." %> +<%= screenshot "s3-8", "Przycisk History w GitHub." %> -//// +Widzimy teraz uporządkowaną listę commitów, które zmieniły dany plik: -<%= screenshot "s3-9", "Displaying a file's history." %> +<%= screenshot "s3-9", "Wyświetlenie historii plików." %> -### The Blame Game +### Znajdowanie osoby odpowiedzialnej za dokonane zmiany //// From 96710b7c9108d391e5852f6be08267250c3edfea Mon Sep 17 00:00:00 2001 From: Przemyslaw Szulczynski Date: Mon, 28 Apr 2014 23:53:11 +0200 Subject: [PATCH 8/8] Finished 03s --- 03s-using-github.md.erb | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/03s-using-github.md.erb b/03s-using-github.md.erb index b5ab2e9..8513b72 100644 --- a/03s-using-github.md.erb +++ b/03s-using-github.md.erb @@ -130,12 +130,12 @@ Widzimy teraz uporządkowaną listę commitów, które zmieniły dany plik: ### Znajdowanie osoby odpowiedzialnej za dokonane zmiany -//// +Aby zebrać wszystkie informacje, przyjrzymy się bliżej **Blame**. -<%= screenshot "s3-10", "GitHub's Blame button." %> +<%= screenshot "s3-10", "Przycisk Blame w GitHub." %> -//// +Uporządkowany widok informuje kto i w jakim commicie modyfikował dany plik (innymi słowo, kogo winić za popełnione czyny, jeżeli coś nie chce działać). -<%= screenshot "s3-11", "GitHub's Blame view." %> +<%= screenshot "s3-11", "Widok Blame w GitHub." %> -//// +Ponieważ Git oraz GitHub są całkiem skomplikowanymi narzędziami, nie mamy zamiaru przedstawić wszystkich informacji na ich temat w pojedyńczym rozdziale. Tak naprawdę dotknęliśmy tylko czubka góry lodowej, ale mamy nadzieję, że przedstawiona wiedza okaże się przydatna podczas dalszego czytania tej książki.