aboutsummaryrefslogtreecommitdiffstats
path: root/polish/doc/cvs.wml
blob: 24c285fa708cb1c0357fbdc9c811c3c93ecc6ff9 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
#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 -->

© 2014-2024 Faster IT GmbH | imprint | privacy policy