#use wml::debian::ddp title="CVS Projektu Dokumentacji Debiana"
#use wml::debian::toc
#use wml::debian::translation-check translation="1.20"

<p>Projekt Dokumentacji Debiana przechowuje swoje strony internetowe i
większość podręczników na serwerze CVS na <b>cvs.debian.org</b>.

<p>Każdy może pobrać źródło z serwera CVS, jednak tylko członkowie Projektu
Dokumentacji Debiana mogą aktualizować pliki.</p>

<toc-display/>

<toc-add-entry name="access">Dostęp do źródeł w CVS</toc-add-entry>
  
<p>Możesz użyć interfejsu viewCVS, aby dojść do pojedynczych plików
poprzez stronę internetową i zobaczyć wprowadzone do nich zmiany na
<url "http://cvs.debian.org/?cvsroot=debian-doc">

<p>W celu pobrania wszystkich podręczników, bezpośredni dostęp do serwera
CVS jest lepszym rozwiązaniem. Będziesz potrzebował pakietu
<tt><a href="http://packages.debian.org/cvs">cvs</a></tt> na swojej
maszynie.

<h3>Połączenie anonimowe (tylko do odczytu) z serwerem CVS </h3>

<p>By się połączyć, wpisz tę komendę:

<p style="margin-left: 2em">
  <code>cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc login</code>
</p>

<p>i naciśnij tylko enter, gdy zostaniesz zapytany o hasło.

<p>Możesz teraz używać standardowych komend CVS (zobacz strony
info CVS) do sprawdzania plików, ale nie możesz ich zmieniać, ani
aktualizować.

<p>W celu pobrania plików pierwszy raz utwórz i przejdź do katalogu, w którym wszystko 
będzie przetrzymywane. Zostaną w nim stworzone dwa podkatalogi: 
<strong>CVS</strong> i <strong>ddp</strong>

<p>Użyj tej komendy, by pobrać wszystkie pliki:

<p style="margin-left: 2em">
  <code>cvs -d :pserver:anonymous@cvs.debian.org:/cvs/debian-doc -z3 checkout ddp/manuals.sgml</code>
</p>

<p>To spowoduje rekursywne utworzenie oraz pobranie katalogów.

<p>W celu aktualizacji swojej kopii w oparciu o zmiany dokonane przez
innych ludzi, wejdź do katalogu <strong>ddp/manuals.sgml</strong> i
uruchom komendę:

<p style="margin-left: 2em">
  <code>cvs -z3 update -d -P</code>
</p>

<p>Gdy zakończysz sesję CVS, użyj tej komendy do rozłączenia się z
serwerem:

<p style="margin-left: 2em">
  <code>cvs logout</code>
</p>

<h3>Połączenie z serwerem CVS z możliwością zapisu</h3>

<p>Przed dostępem do serwera CVS z użyciem tej metody powinieneś posiadać
przydzielone prawo zapisu. Proszę, przeczytaj  
jak <a href="#obtaining">poprosić</a> o zwiększenie praw.

<p>W celu połączenia, użyj komendy:

<p style="margin-left: 2em">
  <code>cvs -d :pserver:<var>userid</var>@cvs.debian.org:/cvs/debian-doc login</code>
</p>

<p>i wpisz hasło, które uzgodniłeś z koordynatorem projektu. W powyższej
komendzie zastąp <var>userid</var> swoją nazwą użytkownika na serwerze
CVS. Niekoniecznie taką samą jak Twój login na <b>cvs.debian.org</b>,
jeśli taki posiadasz.

<p>Możesz teraz używać standardowych komend CVS (zobacz strony 
info CVS) do sprawdzenia plików i ich aktualizacji.

<p>W celu pobrania plików pierwszy raz, utwórz katalog, w którym
wszystko będzie przechowywane. Zostaną w nim stworzone dwa 
katalogi: <strong>CVS</strong> i <strong>ddp</strong>.

<p>Użyj tej komendy, by pobrać wszystkie pliki:

<p style="margin-left: 2em">
  <code>cvs -d :pserver:userid@cvs.debian.org:/cvs/debian-doc -z3 checkout ddp/manuals.sgml</code>
</p>

<p>To spowoduje rekursywne utworzenie oraz pobranie katalogów.

<p>W celu aktualizacji swojej kopii w oparciu o zmiany dokonane przez
innych ludzi, wejdź do katalogu <strong>ddp/manuals.sgml</strong> i
uruchom komendę:

<p style="margin-left: 2em">
  <code>cvs -z3 update -d -P</code>
</p>

<p>Gdy zakończysz sesję CVS, użyj tej komendy do rozłączenia się z
serwerem:

<p style="margin-left: 2em">
  <code>cvs logout</code>
</p>

<h3>Korzystanie z serwera CVS poprzez SSH z możliwością zapisu.</h3>

<p>Ta metoda jest dostępna jedynie dla zarejestrowanych deweloperów
Debiana i jest bardziej zalecana niż opisana wcześniej metoda pserver.
Jeśli ostatnio zostałeś deweloperem Debiana, proszę poinformuj
koordynatora dokumentacji, by usunął Twoje konto pserver.

<p>By połączyć się korzystając z ssh, najpierw poinformuj CVS, żeby go używał:

<p style="margin-left: 2em">
  <code>export CVS_RSH=ssh</code>
</p>

<p>Teraz utwórz katalog, w którym wszystko będzie przetrzymywane,
przejdź do niego i wpisz tę komendę:

<p style="margin-left: 2em">
  <code>cvs -d :ext:<var>userid</var>@cvs.debian.org:/cvs/debian-doc -z3 checkout <var>module</var></code>
</p>

<p>W powyższej komendzie zastąp <var>userid</var> swoją nazwą
użytkownika na serwerze CVS. Jest ona tak sama jak Twój login 
na wszystkich maszynach Debiana. Zastąp <var>module</var> 
nazwą modułu, który chcesz sprawdzić,
zazwyczaj jest nim <tt>ddp/manuals.sgml</tt>. Potem będziesz zapytany o
hasło na serwer CVS. Nie pomyl tego z własną maszyną.

<p>Wewnątrz wybranego katalogu zostaną stworzone dwa 
podkatalogi: <strong>CVS</strong> i 
<strong>ddp</strong>. CVS rekurencyjnie stworzy dowolne 
moduły (tzn. katalogi), o które poprosisz i wypełni je plikami.

<p>Możesz teraz używać standardowych komend CVS (zobacz strony
info CVS) do sprawdzania plików i ich aktualizacji.

<p>W celu aktualizacji swojej kopii w oparciu o zmiany dokonane przez
innych ludzi, wejdź do katalogu <strong>ddp/manuals.sgml</strong> i
uruchom komendę:

<p style="margin-left: 2em">
  <code>cvs -z3 update -d -P</code>
</p>

<toc-add-entry name="obtaining">Uzyskiwanie możliwości zapisu</toc-add-entry>

<p>Możliwości zapisu są dostępne dla każdego, kto chce uczestniczyć w
pisaniu podręczników. Generalnie wymagamy, by najpierw przesłać kilka
pożytecznych łatek. 

<p>By uzyskać możliwość zapisu prześlij prośbę do <a
href="mailto:aph@debian.org">Koordynatora Dokumentacji</a>,
zaszyfrowaną za pomocą publicznego klucza GPG dla <code>aph@debian.org</code>.
List ten powinien zawierać nazwę użytkowika na pserwerze, której chcesz używać
, alternatywną nazwę w przypadku, gdy pierwsza jest już
zajęta i proponowane hasło (czysty tekst albo zaszyfrowany)

<hr>

<toc-add-entry name="organization">Struktura plików</toc-add-entry>

<p>Ten rysunek przedstawia strukturę drzewa katalogów CVS:
</p>
<div class="center">
<img src="dirtree.jpg" alt="DDP CVS drzewo katalogów">
</div>

<p>Proszę zauważyć, że strona internetowa DDP jest umieszczona w module
webwml w repozytorium CVS, żeby była zintegrowana z resztą witryn WWW
Debiana.

<hr>

<toc-add-entry name="updates">Mechanizm automatycznej aktualizacji</toc-add-entry>

<p>Publikowane strony internetowe z podręcznikami są generowane przez
crona uruchomionego na www-master.debian.org codziennie o 15:39 Pacific
time.

<p>Skrypt wykonuje <kbd>cvs update -d -P</kbd>, potem <kbd>make -C
manuals.sgml clean publish</kbd>, oba w katalogu <code>ddp</code>.

<p>Plik makefile jest tak skonstruowany, by przebudować każdy podkatalog
(który zawiera utrzymywaną dokumentację) oraz przekopiować pliki z
każdego z nich do podkatalogu <code>doc/manuals/</code> strony
WWW. Pliki makefile znajdujące się w podkatalogach wywodzą się z
<code>ddp/manuals.sgml/standard.makefile</code>.

<p>Pliki dokumentacji generowane przez skrypt atkualizujący można
znaleźć na <a href="manuals/">http://www.debian.org/doc/manuals/</a>.</p>

<p>Pliki rejestru generowane przez skrypt aktualizujący można znaleźć na 
<url "http://www-master.debian.org/build-logs/ddp/">

# <!-- Created: Mon Jul  6 19:58:09 BST 1998 -->