Dokumentacja Moodle : Jak korzystać z CVS

## Wykorzystanie CVS w celu pozyskania i uaktualniania kodu źródłowego Moodle

> CVS jest skrótem od Current Versioning System (System uaktualniania). Jest to powszechnie stosowana metoda przechowywania kodu źródłowego, jako że zachowuje wszystkie wersje plików w taki sposób, że nic nigdy nie znika, a aktywność różnych ludzi jest monitorowana. Umożliwia również scalenie kodu, jeśli dwie lub więcej osób pracuje jednocześnie nad jednym plikiem. Cały kod źródłowy, oraz wszystkie wersje są przechowywane na centralnym serwerze (w tym wypadku na Sourceforge).

> Jeśli chcesz po prostu otrzymać dostęp do aktualnej wersji Moodle zamieszczonej na serwerze CVS, z prawami tylko-do-odczytu nie potrzebujesz tej strony. Po prostu podążaj zgodnie z instrukcjami CVS zawartymi na stronie Moodle - pobierz.

> By móc wykorzystać archiwum CVS Moodle (jako programista z prawem do zapisu), w pierwszej kolejności musisz mieć konto na serwerze Sourceforge. Na tej stronie zakładamy przykładowo, iż posiadasz nazwę użytkownika myusername wraz z hasłem mypassword. Zwróć uwagę na instrukcje sourceforge dotyczące utworzenia katalogu domowego CVS. Jest tam opisane coś, co musisz zrobić z każdym nowym kontem, aby umożliwić jego współpracę z CVS. W skrócie : musisz skorzystać z ssh, aby interaktywnie połączyć się z cvs.sourceforge.net.

> Gdy już będziesz miał konto na serwerze Sourceforge'a skontaktuj się z (Martin'em Dougiamas'em), żeby mógł przekazać Ci prawa zapisu do poszczególnych katalogów.

> Aby nie być pytanym o mypassword za każdym razem gdy uruchamiasz polecenia CVS, przeczytaj Wskazówki Sourceforge jak wykorzystywać klucze autoryzacji. Ten krok jest nieobowiązkowym, ale może znacznie ułatwić Ci pracę z CVS.

> W tym momencie masz już wszystkie uprawnienia, które są CI potrzebne, więc po prostu ściągnij aktualny kod źródłowy i zaczynaj pracę. Poniżej zamieszczono instrukcje zarówno dla systemu Unix jak i Windows

> ### 1. Wykorzystanie CVS w środowisku Unix

> > CVS na Sourceforge wykorzystuje ze względów bezpieczeństwa warstwę transportową ssh, więc będziesz musiał ustawić odpowiednią zmienną środowiskową CVS_RSH w powłoce twojego Uniksa:

> > >     setenv CVS_RSH ssh (dla csh, tcsh etc)

> > >     export CVS_RSH=ssh (dla sh, bash etc)

> > Najlepiej umieścić to w .bashrc lub .cshrc, byś nie musiał cały czas tego wpisywać. Następnie sprawdź Moodle wpisując następujące polecenie (całość w jednej linii)

> > >     cvs -z3 -d:ext:myusername@cvs.sourceforge.net:/cvsroot/moodle co moodle

> > Nie próbuj wywołać tej pierwszej komendy CVS w istniejącym katalogu Moodel. Zamiast tego zacznij w nowym katalogu. Pamiętaj, że przy każdym kroku będziesz pytany o hasło (mypassword), chyba, że ustawisz klucze autoryzacji

> > Teraz powinieneś nowy katalog : 'moodle'. Możesz zmienić mu nazwę, lub przenieść go w inne miejsce, jeśli masz ochotę. Wejdź do niego :

> > >     cd moodle

> > Powinny się tu znajdować wszystkie najnowsze pliki Moodle. Możesz teraz zmieniać pliki w swojej kopii. Aby porównać swoje pliki z główną kopią na serwerze CVS skorzystaj z komendy cvs diff, np.:

> > >     cvs diff -c config-dist.php
> > >     cvs diff -c lang

> > By ściągnąć najnowsze uaktualnienia z serwera użyj:

> > >     cvs update -dP

> > By przesłać twoje nowe pliki z powrotem na serwer będziesz musiał wpisać coś podobnego do :

> > >     cd lang/ca
> > >     cvs commit

> > Zostaniesz poproszony o umieszczenie komentarza (w zależności od twojego domyślnego edytora tekstu) ... dodaj znaczący komentarz i zamknij edytor ... pliki zostaną przesłane do Sourceforge i zapisane. To wszystko.

> > Aby zaoszczędzić czasu możesz umieścić domyślne parametry w pliku .cvsrc, w twoim katalogu domowym. Mój przykładowo zawiera :

> > >     diff -c
> > >     update -dP

> > Wpisz 'cvs help' by dowiedzieć się więcej ...

> ### 2. Wykorzystanie CVS w środowisku Windows

> > Po pierwsze musisz ściągnąć świeżą kopię platformy Moodle, wykorzystując swoje konto programisty

> > > 1. Ściągnij TortoiseCVS z tortoisecvs.org. Zainstaluj go, a następnie uruchom ponownie twój komputer.
> > > 2. Zlokalizuj lub utwórz nowy folder do którego będziesz chciał ściągnąć Moodle.
> > > 3. Kliknij prawym klawiszem myszy na tym folderze i wybierz "CVS Checkout" z menu. Powinno ukazać się okno dialogowe.
> > > 4. Skopiuj ten tekst do pola CVSROOT :

> > > >      :ext:myusername@cvs.sourceforge.net:/cvsroot/moodle

> > > 5. Kliknij na: "Fetch list...".
> > > 6. Po prawej stronie przycisku powinieneś zobaczyć listę modułów: wybierz "moodle" z tej listy.
> > > 7. Kliknij na "OK" .Powinien rozpocząć się proces ściągania Moodle

> > W oknie dialogowym powinny pokazać się nazwy ściągniętych plików, a po chwili powinieneś mieć już kompletną wersję Moodle. Później możesz ściągać najnowsze pliki z serwera CVS :

> > > 1. Kliknij prawym klawiszem myszy na folderze Moodle (lub na wybranym pliku) i wybierz "CVS Update".

> > Gdy zakończysz modyfikację plików (zauważysz, że ich kolor zmienia się z zielonego na czerwony!) możesz je dostarczyć z powrotem na serwer w następujący sposób :

> > > 1. Kliknij prawym klawiszem myszy na folderze Moodle (lub na wybranym pliku) i wybierz "CVS Commit...".
> > > 2. W oknie dialogowym opisz wprowadzone przez Ciebie zmiany.
> > > 3. Kliknij "OK". Twoje zmiany zostaną wprowadzone na serwer.

> Powodzenia!

Dokumentacja Moodle

Version: $Id: features.html,v 1.2 2001/12/09 10:34:19 martin Exp $