Linia 1:
Linia 1:
−
#PATRZ [[Konto ASP]]
+
Aby uzyskać konto svn należy napisać maila do [mailto:konta@wit.edu.pl konta@wit.edu.pl] z uzasadnieniem po co nam takie konto.
+
+
Jako klienta svn polecamy:[http://tortoisesvn.net TortoiseSVN], natomiast pod linuxa [http://subversion.tigris.org Subversion].
+
+
==Windows - TortoiseSVN==
+
Klient istnieje na platformy "32-bitowe":http://prdownloads.sourceforge.net/tortoisesvn/LanguagePack-1.4.1.7992-win32-pl.exe?download i "64-bitowe":http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.4.1.7992-x64-svn-1.4.2.msi?download.
+
Po instalacji <ins>konieczny</ins> jest restart komputera.
+
Można jeszcze dodatkowo zainstalować spolszczenie (odpowiednio do "32-bitowej":http://prdownloads.sourceforge.net/tortoisesvn/LanguagePack-1.4.1.7992-win32-pl.exe?download i "64-bitowej":http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.4.1.7992-x64-svn-1.4.2.msi?download wersji) oraz polski słownik.
+
+
===Ustalenie uprawnień===
+
Bezpośrednio po uzyskaniu konta na szkolnym serwerze svn należy sciągnąć specjalne repozytorium w którym znajdują się pliki definiujące prawa dostępu do katalogów/repozytoriów.
+
+
Utwórz katalog svn, a w nim svnaccess:
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok01.png" />
+
Kliknij prawym przyciskiem myszy w wolne miejsce w katalogu, z menu wybierz "SVN Checkout"
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok02.png" />
+
+
W oknie które się pojawi wpisz "https://svn.wsisiz.edu.pl/repos/svnaccess" i kliknij OK
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok03.png" />
+
+
Jeżeli okno dialogowe nie pokaże żadnych błędów klikamy OK.
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok04.png" />
+
+
Katalog svnaccess powinien zawierać teraz podkatalogi z nazwami wszystkich użytkowników korzystających z svn
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok05.png" />
+
+
wchodzimy do katalogu z własną nazwą użytkownika
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok06.png" />
+
+
za pomocą edytora potrafiącego prawidłowo interpretować UNIX-owe końce linii (np. EditPlus) edytujemy plik svnaccess:
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok07.png" />
+
+
oraz groups:
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok08.png" />
+
+
====Składnia pliku svnaccess====
+
Plik svnaccess jest podzielony na sekcje. Nazwa sekcji zawiera się pomiędzy nawiasami "[" i "]". Tak więc w tym pliku są dwie sekcje: "kario:/" i "kario:/projekt/".<br /> Pierwsza z nich jest obowiązkowa i opisuje prawa dostępu do katalogu głównego na serwerze svn, pozostałe są opcjonalne, ta, która znajduje się w przykładzie definiuje prawa dostępu do podkatalogu "projekt".
+
+
W każdej sekcji możemy zdefiniować użytkowników którzy będą mieć prawo zapisu i odczytu (rw), jedynie odczytu (r), lub nie będą mieć praw ( ).
+
+
Dla pokazanego pliku konfiguracyjnego użytkownik kario ma pełne prawa do katalogu głównego i podkatalogu projekt. Użytkownik mojkolega ma pełne prawa do katalogu głównego. Wszystkich pozostałych użytkowników określa się przez ' * ', tak więc wszyscy mogą czytać katalog główny, jednak nie mają dostępu do podkatalogu projekt. Nazwę grupy użytkowników poprzedzamy znakiem "@", tak więc w tym przykładzie użytkownicy w grupie "kario-projekt" mają pełne prawa do katalogu projekt.</div>
+
+
Oczywiście nazwy użytkowników muszą być zgodne z nazwami użytkownika w sieci WIT.
+
+
====Składnia pliku groups====
+
W pliku groups definiujemy grupy użytkowników po to aby móc wygodniej zarządzać prawami dostępu do swoich katalogów.
+
+
Każda linijka tego pliku określa jedną grupę użytkowników! Nie można "zawijać" wierszy enterem!
+
+
Definicja grupy składa się z twojej nazwy użytkownika, pauzy oraz dowolnego ciągu znaków alfanumerycznych (polskie ogonki są niedozwolone), spacji, znaku równości, kolejnej spacji oraz listy użytkowników (szkolnych loginów) pooddzielanych przecinkami.</div>
+
+
Aby nowe ustawienia zaczęły działać musisz przejść do katalogu nadrzędnego względem svnaccess (w naszym przykładzie do svn):
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok09.png" />
+
+
Kliknąć prawym przyciskiem myszy na katalog i z menu wybrać "SVN Commit..."
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok10.png" />
+
+
Nowa formatka w górnej części zawiera pole "Message", służące do opisywania zmian które poczyniliśmy w plikach. Dolna część zawiera listę plików które modyfikowaliśmy. Upewnij się, że pole przy "Select/Deselect All" jest zaznaczone i kliknij OK
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok11.png" />
+
+
Klient powinien poprosi o nazwę użytkownika i hasło. Wpisujesz swój szkolny login oraz hasło systemowe.
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok12.png" />
+
+
Po paru chwilach zawartość plików powinna zostać zaktualizowana, a tobie przedstawione okno podobne do tego poniżej.
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok13.png" />
+
+
===Korzystanie z repozytorium===
+
====Uaktualnianie repozytorium====
+
Utwórz katalog o nazwie zgodnej z twoją nazwą użytkownika w katalogu svn:
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok14.png" />
+
+
Kliknij na niego prawym przyciskiem myszy i wybierz opcję "SVN Checkout..."
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok15.png" />
+
+
Do paska adresu wpisz "https://svn.wsisiz.edu.pl/repos/user" zastępując "user" swoim szkolnym loginem. Kliknij OK.
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok16.png" />
+
+
W następnym okienku kliknij OK
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok17.png" />
+
+
Pozostałe kroki są nieobowiązkowe, służą jednie pokazaniu sposobu w jaki korzysta się z svn-a.
+
+
Teraz utworzymy katalog projekt, a w nim plik main.c
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok18.png" />
+
+
Aby wysłać zmiany na serwer ponownie przechodzimy do katalogu svn, klikamy prawym przyciskiem myszy na folderze i wybieramy opcję "SVN Commit..."
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok19.png" />
+
+
W oknie które się pojawi w polu message wpisujemy "Utworzenie katalogu projekt oraz pliku main.c". Oraz upewniamy się, że pole przy "Select / Deselect All" jest zaznaczone.
+
+
Jak widać tortoiseSVN podkreśla błędy ortograficzne i rozpoznaje wpisywane nazwy plików, w moim wypadku podkreśli większość słów ponieważ nie mam zainstalowanego polskiego słownika.
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok20.png" />
+
+
Jeżeli nie zaznaczyłeś(łaś) pola przy "Save authentication", program powinien się ponownie zapytać o hasło:
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok21.png" />
+
+
Po poprawnym uaktualnieniu repozytorium powiniene ujrzeć okno podobne do zamieszczonego poniżej:
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok22.png" />
+
+
====Ściąganie nowych wersji====
+
+
Przejdź do katalogu svn, kliknij prawym przyciskiem myszy na katalog z repozytorium które chcesz uaktualnić i wybierz opcję "SVN Update"
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok23.png" />
+
+
Po klikniciu powinno pojawi się okno podobne do poniższego, oznacza to, że pliki w katalogu zostały zaktualizowane do wersji znajdującej się na serwerze.
+
+
<img alt="" src="http://www.wit.edu.pl/pomoc/svnmanual/krok24.png" />
+
+
Dalsze informacje o TortoisseSVN możesz znaleźć na stronie internetowej projektu: "http://tortoisesvn.net/doc_release":http://tortoisesvn.net/doc_release
+
+
==Linux - subversion==
+
===Ustalanie uprawnień===
+
Utwórz katalog svn w folderze domowym:
+
<pre><code>cd
+
mkdir svn<
+
cd svn
+
</code>
+
</pre>
+
+
Ściągnij repozytorium svnaccess:
+
+
Jeżeli pracujesz na oceanicu wcześniej musisz wydać komendę <code>export LC_ALL=en_US</code>.
+
+
<pre><code>svn co https://svn.wsisiz.edu.pl/repos/svnaccess</code></pre>
+
+
przejdź do katalogu o nazwie zgodnej z twoim loginem:
+
+
<code>cd svnaccess/user</code>
+
+
zmień pliki svnaccess oraz groups tak aby odpowiadały twoim potrzebom.
+
+
===Składnia pliku svnaccess===
+
<pre>
+
[kario:/]
+
kario = rw
+
* = r
+
[kario:/jacob/]
+
kario = rw
+
@kario-projekt = rw
+
* =
+
</pre>
+
+
Plik svnaccess jest podzielony na sekcje. Nazwa sekcji zawiera się pomiędzy nawiasami "[" i "]". Tak więc w tym pliku s dwie sekcje: "kario:/" i "kario:/projekt/".
+
+
Pierwsza z nich jest obowiązkowa i opisuje prawa dostępu do katalogu głównego na serwerze svn, pozostałe są opcjonalne, ta, która znajduje się w przykadzie definiuje prawa dostępu do podkatalogu "projekt".
+
+
W każdej sekcji możemy zdefiniować użytkowników którzy będą mieć prawo zapisu i odczytu (rw), jedynie odczytu (r), lub nie będą mieć praw ( ).
+
+
Dla pokazanego pliku konfiguracyjnego użytkownik kario ma pełne prawa do katalogu głównego i podkatalogu projekt. Użytkownik mojkolega ma pełne prawa do katalogu głównego. Wszystkich pozostałych użytkowników określa się przez "*", tak więc wszyscy mogą czytać katalog główny, jednak nie mają dostępu do podkatalogu projekt. Nazwę grupy użytkowników poprzedzamy znakiem "@", tak więc w tym przykładzie użytkownicy w grupie "kario-projekt" mają pełne prawa do katalogu projekt.
+
+
==Wizualizacja zawartości repozytorium==
+
Zawartość repozytoriów jest także wizualizowana pod adresem: [https://svn.wsisiz.edu.pl/viewvc https://svn.wsisiz.edu.pl/viewvc].
+
+
[[category:Zasoby_sieciowe]]
+
[[category:Instrukcje]]