Zespół Pomiaru Dydaktycznego

Ta strona jest tylko do odczytu. Możesz wyświetlić źródła tej strony ale nie możesz ich zmienić.
======Repozytoria Git======

Kod pakietów używanych do wyliczania wskaźników EWD utrzymywany jest w repozytoriach Git. Referencyjne kopie repozytoriów znajdują się na [[odra|Odrze]] lub na serwerze [[https://github.com/tzoltak|GitHub]].

=====Instalacja Gita=====


**Pod Windowsami czy na Macu** najprościej zainstalować aplikację GitHuba (Git zainstaluje się z nią automatycznie i co więcej, zostanie też automatycznie rozsądnie skonfigurowany):
  * [[https://windows.github.com]]
  * [[https://mac.github.com]]

Następnie trzeba otworzyć RStudio i wskazać mu lokalizację Gita wpisując w pole: //Tools -> Global Options... -> Git/SVN -> Git executable// ścieżkę: //C:/Users/twoja nazwa użytkownika/AppData/Local/GitHub/PortableGit_(...)/bin/git.exe//

Przy tym należy oczywiście podmienić //twoja nazwa użytkownika// i sprawdzić, co należy wstawić zamiast //(...)// (to jest dłuższy ciąg znaków, który wygląda na sumę kontrolną i zapewne nie musi być taki sam dla różnych instalacji).

**Pod Linuksem** należy Gita zainstalować z paczek (np. pod Debianem/Ubuntu: //sudo apt-get install git//).

====Wersja „na twardziela” dla użytkowników Windows:====

Gita wraz z kilkoma potrzebnymi nakładkami można pobrać np. z: [[http://gitextensions.github.io]]. Należy zainstalować sobie wszystko, o co będzie się pytał (chyba że wiesz, że już to masz, albo masz coś, co to dobrze zastępuje), jako to:
  - gitextensions (GUI do Gita),
  - Gita (jako takiego),
  - Kdiff (narzędzie do rozstrzygania konfliktów wersji).

Podczas instalacji zostanie zadanych kilka podchwytliwych pytań, ale to, jak na nie odpowiecie nie ma na szczęście większego znaczenia.

Kwestie związane z kluczami SSH zostały pokrótce opisane na odpowiedniej [[https://help.github.com/articles/generating-ssh-keys/|stronie GitHub-a]].

=====Podłączanie się do repozytoriów na GitHubie=====

Postępuj zgodnie z instrukcją: [[r_pakiet_howto&#zakladanie_projektu_rstudio_dla_pakietu|Zakładanie projektu RStudio dla pakietu]].

====Istniejące repozytoria (pakiety):====

  * [[https://github.com/tzoltak/EWDogolny|EWDogolny]]
  * [[https://github.com/tzoltak/EWDdan|EWDdane]]
  * [[https://github.com/tzoltak/EWDskale|EWDskale]]
  * [[https://github.com/tzoltak/EWDskalowanie|EWDskalowanie]]
  * [[https://github.com/tzoltak/EWDwskaznik|EWDwskazniki]]
  * [[https://github.com/tzoltak/EWDraport|EWDraport]]
  * [[https://github.com/tzoltak/EWDrspo|EWDrspo]]
  * [[https://github.com/zozlak/ZPD|ZPD]]
  * [[https://github.com/zozlak/ZPDzapis|ZPDzapis]]
=====Podłączanie się do repozytoriów na Odrze=====

  - W RStudio wybierz: <html><span style="color: darkblue; font-family: monospace;">File->New Project...->Version Control->Git</span></html>.
  - Jako adres repozytorium podaj: <html><span style="color: darkblue; font-family: monospace;">ssh://wewd@ibe.edu.pl:7122/home/wewd/nazwa_repozytorium_do_którego_chcę_się_podłączyć</span></html>
  - W pole z nazwą projektu najlepiej wpisać: <html><span style="color: darkblue; font-family: monospace;">nazwa_repozytorium_do_którego_chcę_się_podłączyć</span></html>
  - Ścieżkę, gdzie to ma być u Ciebie na komputerze przechowywane wybierz wedle własnego uznania.

Przeczytaj też: [[r_pakiet_howto&#zakladanie_projektu_rstudio_dla_pakietu|Zakładanie projektu RStudio dla pakietu]].

====Istniejące repozytoria:====

  * [[ewdrepozytoria|skalowanieEgzaminow]]
  * [[ewdrepozytoria|wskGimnJednorocz]]
  * [[ewdrepozytoria|wskGimnTrzyletn]]
  * [[ewdrepozytoria|wskMaturaJednorocz]]
  * [[ewdrepozytoria|wskMaturaTrzyletn]]
  * wewd
=====Używanie Gita z Rstudio=====

[[http://nicercode.github.io/git/rstudio.html]]

====Kilka rzeczy, do których trzeba wywołać konsolę====

  * Czasem GUI RStudio zacina się i nie pozwala dodać (zaznaczyć) niektórych plików do commitu. W takiej sytuacji należy wywołać konsolę Gita i posłużyć się poleceniem (względnie zamiast '.' nazwa konkretnego pliku):<code>git add .</code>
  * Jeśli coś namieszałeś i zacommitowałeś rzeczy, które zacommitowane być nie powinny, a teraz chcesz wrócić do któregoś ze wcześniejszych stanów repozytorium, musisz:
    - Wywołać konsolę Gita i przejrzeć historię commitów przy pomocy polecenia<code>git log</code>aby namierzyć commit, do którego chcesz przywrócić repozytorium (enterem lub spacją każesz wyświetlać kolejne informacje; gdy dojdziesz do interesującego cię commitu naciśnij 'q' aby móc wpisać dalsze polecenia).
    - Cofnąć "początek" do odpowiedniego commitu, a następnie popchnąć zmiany na serwer, z zaznaczeniem, że wiesz, że chcesz dokonać cofnięcia:<code>git reset --hard <"numer" commitu>
git push -f</code>

====Wykorzystywanie gałęzi====

Tzw. gałęzie to świetny wynalazek, który pozwala nam nie narażać końcowych użytkowników pakietu na obcowanie z nanoszonymi przez nas w kodzie zmianami (np. dodawaniem nowych funkcji) tak długo, jak długo nie zostaną one doprowadzone do etapu produkcyjnego, jednocześnie umożliwiając wspólną pracę na rozwijanym kodzie.

Z filozofią używania gałęzi można zapoznać się np. tutaj: http://nvie.com/posts/a-successful-git-branching-model

A sposób używania gałęzi w RStudio opisany został np. na stronie [[http://christianlemp.com/blog/2014/02/13/How-I-Manage-Data-Projects-with-RStudio-and-Git-Part-2.html|Christiana Lempa]].

====Gałęzie w RStudio====

GUI RStudio oferuje bardzo ograniczone wsparcie dla działania na gałęziach. Przy jego pomocy możliwe jest jedynie przełączanie się pomiędzy już istniejącymi gałęziami oraz dokonanie commitu w aktywnej gałęzi. W związku z tym dużą część operacji trzeba wykonywać z konsoli. W szczególności:

  * Zaciągnięcie nowej gałęzi z serwera, kiedy jeszcze nie ma jej na naszym komputerze:<code git>
git fetch
git checkout [nazwa_zdalnej_gałęzi]
</code>
  * Utworzenie nowej gałęzi:<code git>
git checkout -b [nazwa_gałęzi]
</code>
  * Pobieranie danych z innego repozytorium (//pull//) **do aktywnej gałęzi**:<code git>
git pull [nazwa_innego_repozytorium] [nazwa_gałęzi_na_innym_repozytorium] 
</code>
  * Wysyłanie danych **z aktywnej gałęzi** do innego repozytorium (//push//):<code git>
git push [nazwa_innego_repozytorium] [nazwa_gałęzi_na_innym_repozytorium]
</code>
  * Połączenia **aktywnej gałęzi z inną gałęzią z tego samego repozytorium** (//merge//):<code git>
git merge --no-ff [nazwa_gałęzi]
</code>Argument //--no-ff// zapewnia, że w historii zmian aktywnej gałęzi zachowana zostanie informacja o dokonanym połączeniu (//merge//) i historia zmian obu gałęzi, które są łączone.\\

Jeśli pracę mamy zorganizowaną w systemie z repozytorium źródłowym - w szczególności na GitHubie - to jako //nazwa_innego_repozytorium// typowo używamy //origin//. W ogólności może to być adres serwera, albo reprezentująca go skrótowa nazwa, tzw. //remote//, o ile została wcześniej zarejestrowana w Gicie (//origin// jest właśnie //remotem//).
=====Tworzenie nowego repozytorium (projektu) na Odrze=====

  - Zaloguj się przez ssh na Odrze, na koncie wewd (z użyciem swojego klucza prywatnego).
  - Utwórz katalog na nowy projekt: <html><span style="color: darkblue; font-family: monospace;">mkdir nazwa_projektu</span></html>.
  - Przejdź do tego katalogu: <html><span style="color: darkblue; font-family: monospace;">cd nazwa_projektu</span></html>.
  - Utwórz nowe repozytorium: <html><span style="color: darkblue; font-family: monospace;">git init</span></html>.
  - I przestaw je w tryb "bare": <html><span style="color: darkblue; font-family: monospace;">git config --bool core.bare true</span></html>.
  - Podłącz się do repozytorium przy pomocy RStudio, jak opisano w jednej z [[ewdgit#podlaczanie_sie_do_istniejacego_repozytorium_projektu_przez_rstudio|wcześniejszych sekcji]].
Zespół Pomiaru Dydaktycznego

Narzędzia użytkownika

Narzędzia witryny

Narzędzia strony
