moodle/lang/pl/docs/cvs.html
2003-08-19 08:08:42 +00:00

134 lines
7.6 KiB
HTML

<html>
<head>
<title>Dokumentacja Moodle : Jak korzystać z CVS</title>
<link rel="stylesheet" href="../theme/standard/styles.php" type="TEXT/CSS">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-2">
<style type="text/css">
<!--
.sectionheading {
font-size: medium;
font-weight: bold;
font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;
border: 1px dotted;
padding: 10px;
background-color: #EEEEEE;
}
-->
</style>
</head>
<body bgcolor="#ffffff">
<h2>Wykorzystanie CVS w celu pozyskania i uaktualniania kodu źródłowego Moodle</h2>
<blockquote>
<p>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 <a href="http://www.sf.net/">Sourceforge</a>).
</p>
<p>By móc wykorzystać <a href="http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/moodle/moodle/"> archiwum CVS Moodle
</a> (jako <a href="http://sourceforge.net/project/memberlist.php?group_id=30935">programista
z prawem do zapisu</a>), w pierwszej kolejności musisz mieć <a href="http://sourceforge.net/account/register.php">konto na serwerze Sourceforge</a>. Na tej stronie zakładamy przykładowo, iż posiadasz nazwę użytkownika
<strong><font color="#990000">myusername</font></strong> wraz z hasłem
<strong><font color="#990000">mypassword</font></strong>.Gdy już będziesz miał konto na serwerze Sourceforge'a skontaktuj się za mną (<a
href="http://dougiamas.com/">Martin Dougiamas</a>), żebym mógł przekazać Ci prawa zapisu do poszczególnych katalogów.</p>
<p>Aby nie być pytanym o <strong><font color="#990000">mypassword</font></strong>
za każdym razem gdy uruchamiasz polecenia CVS, przeczytaj <a href="http://sourceforge.net/account/editsshkeys.php">Wskazówki Sourceforge
jak wykorzystywać klucze autoryzacji</a>. Ten krok jest nieobowiązkowym, ale może znacznie ułatwić Ci pracę z CVS.</p>
<p>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</p>
<h3 class="sectionheading">1. Wykorzystanie CVS w środowisku Unix</h3>
<blockquote>
<p>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:</p>
<blockquote>
<pre><strong>setenv CVS_RSH ssh</strong> (dla csh, tcsh etc)</pre>
<pre><strong>export CVS_RSH=ssh</strong> (dla sh, bash etc)</pre>
</blockquote>
<p> 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)</p>
<blockquote>
<pre><strong>cvs -z3 -d:ext:myusername@cvs.moodle.sourceforge.net:/cvsroot/moodle co moodle</strong></pre>
</blockquote>
<p>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 (<strong><font color="#990000">mypassword</font></strong>), chyba, że ustawisz <a href="http://sourceforge.net/account/editsshkeys.php">klucze autoryzacji</a></p>
<p>Teraz powinieneś nowy katalog : 'moodle'. Możesz zmienić mu nazwę, lub przenieść go w inne miejsce, jeśli masz ochotę. Wejdź do niego : </p>
<blockquote>
<pre><strong>cd moodle </strong></pre>
</blockquote>
<p>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.:</p>
<blockquote>
<pre><strong>cvs diff -c config-dist.php
cvs diff -c lang</strong></pre>
</blockquote>
<p>By ściągnąć najnowsze uaktualnienia z serwera użyj: </p>
<blockquote>
<pre><strong>cvs update -dP</strong> </pre>
</blockquote>
<p>By przesłać twoje nowe pliki z powrotem na serwer będziesz musiał wpisać coś podobnego do :
</p>
<blockquote>
<pre><strong>cd lang/ca
cvs commit</strong> </pre>
</blockquote>
<p>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. </p>
<p> Aby zaoszczędzić czasu możesz umieścić domyślne parametry w pliku .cvsrc, w twoim katalogu domowym. Mój przykładowo zawiera :
</p>
<blockquote>
<pre><strong>diff -c
update -dP</strong> </pre>
</blockquote>
<p>Wpisz 'cvs help' by dowiedzieć się więcej ... </p>
<p>&nbsp;</p>
</blockquote>
<h3 class="sectionheading">2. Wykorzystanie CVS w środowisku Windows</h3>
<blockquote>
<p>Po pierwsze musisz ściągnąć świeżą kopię platformy Moodle, wykorzystując swoje konto programisty</p>
<blockquote>
<p> 1. Ściągnij TortoiseCVS z <a href="http://www.tortoisecvs.org/">tortoisecvs.org</a>.
Zainstaluj go, a następnie uruchom ponownie twój komputer.<br>
<br>
2. Zlokalizuj lub utwórz nowy folder do którego będziesz chciał ściągnąć Moodle.<br>
<br>
3. Kliknij prawym klawiszem myszy na tym folderze i wybierz &quot;<strong>CVS Checkout</strong>&quot; z menu. Powinno ukazać się okno dialogowe.<br>
<br>
4. Skopiuj ten tekst do pola CVSROOT :</p>
<blockquote>
<pre> :ext:<font color="#990000">myusername</font>@cvs.moodle.sourceforge.net:/cvsroot/moodle</pre>
</blockquote>
<p><br>
5. Kliknij na: &quot;<strong>Fetch list...</strong>&quot;.<br>
<br>
6. Po prawej stronie przycisku powinieneś zobaczyć listę modułów: wybierz &quot;<strong>moodle</strong>&quot; z tej listy.<br>
<br>
7. Kliknij na &quot;<strong>OK</strong>&quot; .Powinien rozpocząć się proces ściągania Moodle<br>
</p>
</blockquote>
<p> 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 :</p>
<blockquote>
<p> 1. Kliknij prawym klawiszem myszy na folderze Moodle (lub na wybranym pliku) i wybierz &quot;<strong>CVS Update</strong>&quot;. <br>
</p>
</blockquote>
<p>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 : </p>
<blockquote>
<p> 1. Kliknij prawym klawiszem myszy na folderze Moodle (lub na wybranym pliku) i wybierz
&quot;<strong>CVS Commit...</strong>&quot;.<br>
<br>
2. W oknie dialogowym opisz wprowadzone przez Ciebie zmiany.<br>
<br>
3. Kliknij &quot;OK&quot;. Twoje zmiany zostaną wprowadzone na serwer.<br>
</p>
</blockquote>
</blockquote>
<p>&nbsp;</p>
<p align="center">Powodzenia!</p>
<p>&nbsp;</p>
</blockquote>
<p align="CENTER"><font size="1"><a href="." target="_top">Dokumentacja Moodle</a></font></p>
<p align="CENTER"><font size="1">Version: $Id: features.html,v 1.2 2001/12/09
10:34:19 martin Exp $</font></p>
</body>
</html>