== 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?