aktualizacja pliku using_cvs.wml

#use wml::debian::template title="Korzystanie z CVS"
#use wml::debian::translation-check translation="1.27"

<p>CVS jest programem, który pomaga w zarządzaniu pracą ekipy osób pracujących
równocześnie nad tym samym materiałem. Każdy z użytkowników tworzy lokalną
kopię repozytorium dokumentów. Kopie mogą być tworzone na tej samej maszynie,
albo rozsiane po całym świecie. Użytkownicy mogą modyfikować lokalne kopie plików,
a gdy zmiany są gotowe, wysłać je z powrotem na serwer.</p>

<p>Dostęp tylko do odczytu jest możliwy przez
<a href="http://anonscm.debian.org/viewvc/webwml/webwml/">stronę www</a>.
Istnieje również wiele graficznych klientów CVS, takich jak
<a href="http://packages.debian.org/cervisia">cervisia</a>, pochodząca
z KDE. Ten dokument opisuje sposób pracy poleceniem wiersza poleceń
<code>cvs</code>, inne programy funkcjonują analogicznie.</p>

<p>CVS nie pozwoli Ci wysłać pliku, jeśli kopia w głównym repozytorium
została zmodyfikowana od czasu Twojej ostatniej aktualizacji (update).
Przeważnie nie jest to problem i możesz nadal aktualizować swoją lokalną kopię.
Jeśli zmiany dotyczą innej części pliku niż ta, nad którą pracowałeś,
zmiany są po cichu łączone. Jeżeli zaś zmiany dotyczą tego samego obszaru,
zostaniesz ostrzeżony o konflikcie. W takim przypadku musisz przeedytować
plik, aby naprawić problem przed wysyłką.</p>

<p>W poniższym przypadku konto anonymous będzie użyte dla przykładu. Jeśli masz dostęp 
do innego konta, które Ci daje prawo do zapisu, to powinieneś korzystać z tamtego konta. 
Jeżeli planujesz coś zmieniać, powinieneś zdobyć konto z prawami do zapisu. 
Korzystając z konta anonymous użytkownicy nie mogą wysyłać zmian. 
Zobacz <a href="#write-access">rozdział o dostępie z prawem do zapisu</a>, aby 
uzyskać więcej informacji.</p>

<p>Aby rozpocząć pracę z CVS, musisz najpierw się <code>zalogować</code> do serwera CVS</p>

<pre>
   cvs -d :pserver:[email protected]:/cvs/webwml login
</pre>

<p>(naciśnij Enter, gdy zapyta o hasło)</p>

<p>Aby pobrać kopię plików na swój komputer, użyj polecenia:</p>

<pre>
   cvs -d :pserver:[email protected]:/cvs/webwml checkout webwml
</pre>

<p>Możesz pobrać jedynie podzbiór stron przy pomocy:</p>

<pre>
   cvs -d :pserver:[email protected]:/cvs/webwml checkout -l \\
          webwml webwml/&lt;<var>kod języka</var>&gt;
   cvs -d :pserver:[email protected]:/cvs/webwml checkout \\
          webwml/Perl webwml/english/template webwml/&lt;<var>kod języka</var>&gt;/Pics
   cvs -d :pserver:[email protected]:/cvs/webwml checkout \\
          webwml/&lt;<var>język</var>&gt;/&lt;<var>ścieżka do plików</var>&gt;
</pre>

<p>Polecenia powtarzaj dla wszystkich katalogów lub plików, które chcesz 
pobrać. Druga linia pobiera wszystkie pliki, które będziesz potrzebował, aby
stworzyć pliki HTML z WML. Tego typu pobieranie częściowe nie jest tak na
prawdę wspierane, więc powyższe instrukcje mogą nie zadziałać.</p>

<p>Jeśli posiadasz konto Alioth z powiązanym <a
href="https://alioth.debian.org/account/editsshkeys.php">kluczem publicznym
SSH</a>, możesz go użyć zamiast konta anonymous w następujący sposób:</p>

<pre>
   cvs -d :ext:uż[email protected]:/cvs/webwml checkout webwml/english/doc
</pre>

<p>Od tego momentu nie jest konieczne dopisywanie za każdym razem do polecenia części 
<code>'-d :ext:...'</code>. Co kilka dni powinieneś wykonać aktualizację</p>

<pre>
   cvs update -d
</pre>

<p>aby pobrać zmienione pliki z serwera. Opcja <code>-d</code> sprawdza również, czy na 
serwerze nie zostały utworzone nowe katalogi; jeśli zostały utworzone - tworzy je również
w lokalnej kopii.
Z tą opcją nowe katalogi zostaną także utworzone jeśli wykonałeś częściowe
pobieranie &mdash; w takim przypadku może przydać Ci się skrypt
<code>cvsup.py</code>.</p>

<p>
Można również utworzyć plik <code>~/.cvsrc</code> , który zawiera opcje dla programu CVS.
Wtedy nie będzie trzeba wypisywać opcji za każdym razem. Przykładowo plik ten może
zawierać:</p>

<pre>
cvs -z9
update -d -P
diff -u
</pre>

<p>Powyższe opcje są dla osób, które mają prawo zapisu do głównego magazynu.
Gdy skończyłeś zmieniać stronę, możesz wysłać swoje zmiany na serwer korzystając 
z polecenia:</p>

<pre>
   cvs commit &lt;plik&gt;.wml
</pre>

<p>lub</p>

<pre>
   cvs commit &lt;katalog&gt;    (aby wysłać wszystkie zmiany z katalogu &lt;katalog&gt;)
</pre>

<p>lub</p>

<pre>
   cvs commit          (aby wysłać wszystkie zmiany z katalogu, w którym aktualnie jesteś)
</pre>

<p>Jeśli jesteś pierwszą osobą tłumaczącą stronę, powinieneś wykonać polecenie</p>

<pre>
   cvs add &lt;plik&gt;.wml
</pre>

<p>przed jego wysłaniem. Zauważ, że polecenie <code>cvs add</code> nie działa rekursywnie.
Musisz najpierw dodać katalog, a dopiero potem jego zawartość.</p>

<p>Aby uzyskać więcej informacji na temat programu CVS, skorzystaj z polecenia <code>info cvs</code>.</p>

<p>
Jeżeli dołączysz <code>Closes: #</code><var>nnnnnn</var> w wysłanym opisie zmian
wtedy automatycznie zostanie zamknięty błąd o numerze <code>#</code><var>nnnnnn</var>. 
Dokładny format numeru jest taki sam jak <a href="$(DOC)/debian-policy/footnotes.html#f17">w polityce Debiana</a>.
</p>
 
<p>
Proszę nie dołączać linków HTTPS do stron Debiana, DebConf lub SPI. 
Obecnie certyfikaty SSL do tych stron są podpisane przez Centrum Autoryzacji SPI,
które jest zaufane dla maszyn uruchmionych pod Debianem, ale 
nie dla przeglądarek na innych platformach. Używanie linków HTTPS na stronach 
Debiana może powodować, że odwiedzający mogą mieć obawy widząc błędy certyfikatów SSL
w przeglądarce i obwiniać o to Debiana. Repozytorium CVS będzie odrzucać wysyłki zawierające 
linki HTTPS do tych stron Debiana, o których wiadomo, że nie potrzebują SSL.</p>

<h3><a name="write-access">Dostęp do CVS z prawem do zapisu</a></h3>

<p>Jeśli już wiesz <a href="$(DEVEL)/website/desc#help">jak pomóc</a> i
przygotowałeś wystarczającą ilość zaakceptowanych łatek, możesz uzyskać dostęp
do zapisu w repozytorium: <a
href="https://alioth.debian.org/project/request.php?group_id=1135">poproś o
członkostwo w projekcie <code>webwml</code> na Alioth</a> (konieczne będzie <a
href="https://alioth.debian.org/account/register.php">utworzenie konta
Alioth</a> jeśli jeszcze go nie posiadasz).
Prosimy napisać coś użytecznego w swej prośbie: nad którym językiem lub częścią
witryny planujesz pracować, i kto może za Ciebie poręczyć.</p>