wiki:OurTutorial

Version 5 (modified by pfusik, 7 years ago) (diff)

formatowanie

Język

Zaczynamy od wyłączenia polskich komunikatów Traca. Po prostu te tłumaczenia są niepełne, więc zamiast operować pokracznymi terminami wolę operować angielskimi.

Klikamy na górze Ustawienia, Język i np. English (United States), Zapisz zmiany.

Nawigacja w Tracu

Na górnej belce:

  • Wiki - wiadomo
  • Timeline - historia Traca + SVNa, np.
    • edycja strony wiki - wiadomo
    • Ticket - błędy i pomysły, np. jhusak zgłosił pomysł wrzucenia ASMA, a ja to zrobiłem
    • Changeset to zmiana w SVN (np. w changeset 4 wrzuciłem ASMA)
  • Roadmap - na razie nie używamy
  • Browse Source - widok na SVN tylko do odczytu
  • View Tickets - tickety
  • New Ticket - tworzenie ticketa
  • Search - wiadomo

Podstawy SVN

Jak widać na zakładce Browse Source, mamy trzy katalogi w SVN:

  • branches - to dla bardziej zaawansowanych, na razie nie będziemy używać
  • tags - tutaj są oznaczone wersje, np. wrzuciłem tutaj ASMA 3.4, można tu wrzucić wszystkie releasy i bety, po wrzuceniu nic tu nie zmieniamy
  • trunk - to jest główne miejsce pracy, możemy je przeglądać z Traca, ale znacznie wygodniej mieć jego kopię u siebie, o czym niżej

Każdy zapis do SVN jest rejestrowany w historii - widać to w Timeline. Zapis to changeset. Changeset ma:

  • kolejny numerek
  • login autora
  • datę wykonania zmiany
  • opis zmiany - krótki tekst wpisany przez autora, jak w wiki
  • zmiany (dodane/zmienione/usunięte pliki lub katalogi)

Przeglądać SVN możemy z Traca. Aby wprowadzać zmiany, potrzebujemy zainstalować u siebie klienta SVN. Pod Windows najpopularniejszy jest TortoiseSVN.

Instalacja TortoiseSVN

http://tortoisesvn.net/downloads.html Wybieramy 32-bit lub 64-bit zgodnie z naszymi Windowsami. Każda instalacja będzie dobra, jak kto woli można powyłączać wszystkie pierdoły typu dodatkowe ikony, narzędzia command-line i słowniki. Od teraz pod prawo-klikiem w Windows Explorer mamy dodatkowe menu TortoiseSVN.

Pobranie lokalnej kopii

Tworzymy na swoim dysku zwykły pusty katalog, gdzie będzie nasza kopia SVN. Dla ustalenia uwagi nazwę go asma-trunk (nazwa i położenie mogą być dowolne). Wchodzimy do tego katalogu, klikamy puste miejsce i TortoiseSVN / Checkout. W URL of repository wklejamy: svn://84.201.216.109/test/trunk Upewniamy się, że Checkout directory to dokładnie nasz pusty katalog. OK. Czekamy, aż się ściągnie.

Możemy normalnie używać ściągniętych plików - otwierać w playerach i edytować. Z kasowaniem, zmianą nazwy i przenoszeniem trzeba ostrożnie (patrz niżej).

Podstawowe operacje SVN

Prawo-klik na naszym katalogu daje następujące operacje:

  • SVN Update - ściągnięcie nowych zmian, jeśli jakieś były
  • SVN Show Log - historia (to samo co w Tracu, tylko tutaj same zmiany w SVN)
  • SVN Commit - wrzucenie naszych zmian na serwer

Jest jeszcze mnóstwo innych poleceń, ale są one używane dużo rzadziej.

Wprowadzanie zmian

Potraktujcie to, co jest jako piaskownicę. Po oswojeniu się wszystkich zrobimy porządek i będziemy wprowadzać zmiany na poważnie.

Najprościej jest zmienić plik, który jest już w SVN. Zmieniamy pliki normalnie - np. możecie przeedytować pliki tekstowe w notatniku. Następnie wybieramy SVN Commit - wyświetli się lista zmienionych plików. Wpisujemy na górze opis i zatwierdzamy. Wpisujemy swój login i hasło. Po chwili zmiany są widoczne dla wszystkich.

Aby dodać plik, normalnie umieszczamy go w katalogu, prawo-klik na nim i TortoiseSVN / Add. Następnie, aby wysłać dodane pliki, używamy SVN Commit jak wyżej.

Aby usunąć plik, nie usuwamy go normalnie. Zamiast tego TortoiseSVN / Delete, potem SVN Commit.

Aby zmienić nazwę pliku, TortoiseSVN / Rename, potem SVN Commit.

Aby skopiować/przenieść plik, przesuwamy go prawym klawiszem - pojawi się menu z możliwością kopiowania, przenoszenia i ew. zmiany nazwy przy tej okazji. Potem SVN Commit.

Tylko SVN Commit powoduje wysłanie naszych zmian na serwer. Inne operacje działają lokalnie na naszym komputerze.

Na początek to wystarczy. Są pytania?