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
|
#use wml::debian::template title="Dokumentacja"
#use wml::debian::translation-check translation="9aa7cfecde4026c09b63f9d42fa74cbe0f7e50bb"
# TODO - gdzie się da pododawać odnośniki do dokumentacji PO POLSKU
# TODO:
# Ponieważ tłumaczenie tytułu co najmniej jednego dokumentu (APT HOWTO) jest
# takie jak oryginał, samo umieszczenie przetłumaczonego tytułu jest
# niewystarczające do zaznaczenia które z dokumentów są dostępne po polsku.
<p>Ważną częścią systemu operacyjnego jest jego dokumentacja, czyli techniczne
podręczniki opisujące działanie i użycie programów. Projekt Debian, starając
się stworzyć system operacyjny wysokiej jakości, czyni wysiłki aby dostarczyć
wszystkim swoim użytkownikom odpowiednią dokumentację w łatwo dostępnej
postaci.</p>
<h2>Szybki start</h2>
<p>Jeśli jesteś <em>nowym</em> użytkownikiem Debiana, rekomendujemy, abyś
najpierw przeczytał:</p>
<ul>
<li><a href="$(HOME)/releases/stable/installmanual">Installation Guide</a></li>
<li><a href="manuals/debian-faq/">Debian GNU/Linux FAQ</a></li>
</ul>
<p>Mając je w ręku w czasie pierwszej instalacji, będziesz znał odpowiedzi
na wiele pojawiających się pytań, co pomoże Ci pracować w nowoinstalowanym
systemie. Potem warto zapoznać się z:</p>
<ul>
<li><a href="manuals/debian-handbook/">The Debian Administrator's Handbook</a>, obszerna instrukcja obsługi</li>
<li><a href="manuals/debian-reference/">Debian Reference</a>, zwięzły podręcznik użytkownika skupiający się na poleceniach konsoli</li>
<li><a href="$(HOME)/releases/stable/releasenotes">Uwag do Wydania</a>,
dla osób, które wykonują przejście na nowe wydanie</li>
<li><a href="https://wiki.debian.org/">Debian Wiki</a>, wartościowego źródła
inforamcji dla początkujących</li>
</ul>
<p>Na koniec wydrukuj i trzymaj pod ręką <a
href="https://www.debian.org/doc/manuals/refcard/refcard">Debian GNU/Linux Reference
Card</a>, listę najważniejszych poleceń Debiana.</p>
<p>Poniżej przedstawiamy pełniejszą listę dokumentacji.</p>
<h2>Rodzaje dokumentacji</h2>
<p>Większość dokumentacji zawartej w Debianie została napisana dla
dowolnego systemu GNU/Linux. Jest także dokumentacja napisana specjalnie
dla Debiana. Dokumenty te można ująć w następujące kategorie:</p>
<ul>
<li><a href="#manuals">podręczniki</a></li>
<li>dokumenty <a href="#howtos">HOWTO</a> (jak to zrobić)</li>
<li>dokumenty <a href="#faqs">FAQ</a> (odpowiedzi na często zadawane pytania)</li>
<li><a href="#other">inne krótsze dokumenty</a></li>
</ul>
<h3 id="manuals">Podręczniki</h3>
<p>Podręczniki przypominają książki, ponieważ w całościowy sposób opisują
większe tematy.</p>
<h3>Podręczniki specjalnie dla Debiana</h3>
<div class="line">
<div class="item col50">
<h4><a href="user-manuals">Podręczniki użytkownika</a></h4>
<ul>
<li><a href="user-manuals#faq">Debian GNU/Linux FAQ</a></li>
<li><a href="user-manuals#install">Debian Installation Guide</a></li>
<li><a href="user-manuals#relnotes">Debian Release Notes</a></li>
<li><a href="user-manuals#refcard">Debian Reference Card</a></li>
<li><a href="user-manuals#debian-handbook">The Debian Administrator's Handbook</a></li>
<li><a href="user-manuals#quick-reference">Debian Reference</a></li>
<li><a href="user-manuals#securing">Securing Debian Manual</a></li>
<li><a href="user-manuals#aptitude">podręcznik użytkownika aptitude</a></li>
<li><a href="user-manuals#apt-guide">APT User's Guide</a></li>
<li><a href="user-manuals#apt-offline">Using APT Offline</a></li>
<li><a href="user-manuals#java-faq">Debian GNU/Linux and Java FAQ</a></li>
<li><a href="user-manuals#hamradio-maintguide">Debian Hamradio Maintainer’s Guide</a></li>
</ul>
</div>
<div class="item col50 lastcol">
<h4><a href="devel-manuals">Podręczniki dla rozwijających</a></h4>
<ul>
<li><a href="devel-manuals#policy">Debian Policy Manual</a></li>
<li><a href="devel-manuals#devref">Debian Developer's Reference</a></li>
<li><a href="devel-manuals#debmake-doc">Guide for Debian Maintainers</a></li>
<li><a href="devel-manuals#maint-guide">Debian New Maintainers' Guide</a></li>
<li><a href="devel-manuals#packaging-tutorial">Introduction to Debian packaging</a></li>
<li><a href="devel-manuals#menu">Debian Menu System</a></li>
<li><a href="devel-manuals#d-i-internals">Debian Installer internals</a></li>
<li><a href="devel-manuals#dbconfig-common">Guide for database using package maintainers</a></li>
<li><a href="devel-manuals#dbapp-policy">Policy for packages using databases</a></li>
</ul>
<h4><a href="misc-manuals">Inne podręczniki</a></h4>
<ul>
<li><a href="misc-manuals#history">Debian Project History</a></li>
</ul>
</div>
</div>
<p class="clr">Pełna lista podręczników dla Debiana oraz innych dokumentów
znajduje się na stronach <a href="ddp">Projektu dokumentacji Debiana</a>.</p>
<p>Istnieją także różne podręczniki dla użytkowników, napisane pod kątem
systemu Debian GNU/Linux, dostępne jako <a href="books">drukowane książki</a>.</p>
<h3 id="howtos">Dokumenty HOWTO</h3>
<p>Dokumenty <a href="https://tldp.org/HOWTO/HOWTO-INDEX/categories.html">HOWTO</a> opisują
<em>jak</em> coś zrobić (ang. how to) i zazwyczaj obejmują jakiś konkretny
temat.</p>
<h3 id="faqs">Dokumenty FAQ</h3>
<p>Skrót FAQ oznacza <em>frequently asked questions (często zadawane
pytania)</em>. FAQ jest dokumentem, który odpowiada na te pytania.</p>
<p>Na pytania odnoszące się do samego Debiana można znaleźć odpowiedzi w
<a href="manuals/debian-faq/">Debian FAQ</a>.
Istnieje jeszcze dodatkowy dokument <a href="../CD/faq/">FAQ dotyczący obrazów
płyt CD/DVD z Debianem</a>.</p>
<h3 id="other">Inne krótsze dokumenty</h3>
<p>Następujące dokumenty zawierają krótsze instrukcje:</p>
<dl>
<dt><strong><a href="https://tldp.org/docs.html#man">strony
podręcznikowe</a></strong></dt>
<dd>Tradycyjną dokumentacją programów w systemach UNIX są tzw. <em>strony
podręcznika systemowego (ang. man pages)</em>. Są one dostępne przy
pomocy polecenia <tt>man</tt>. Zazwyczaj są przeznaczone dla doświadczonych
użytkowników. Możesz wyszukiwać i czytać strony podręcznikowe dostępne
w Debianie na
<a href="https://manpages.debian.org/cgi-bin/man.cgi">https://manpages.debian.org/</a>.
</dd>
<dt><strong><a href="https://www.gnu.org/software/texinfo/manual/texinfo/html_node/index.html">pliki
info</a></strong></dt>
<dd>Wiele programów GNU jest dokumentowanych za pomocą <em>plików
info</em> zamiast stron podręcznikowych. Pliki te zawierają szczegółowe
informacje o programie, opcjach i przykłady użycia
i są dostępne poprzez polecenie <tt>info</tt>.
</dd>
<dt><strong>różne pliki README</strong></dt>
<dd>Popularne są także pliki <em>read me (ang. przeczytaj mnie)</em>
— są to zwykłe pliki tekstowe opisujące pojedyncze rzeczy,
zazwyczaj pakiety.
Można znaleźć ich dużo w podkatalogach katalogu <tt>/usr/share/doc/</tt>
w każdym systemie Debian. Każdy pakiet ma tam podkatalog
z własnymi plikami README, gdzie mogą być dołączone także
przykłady konfiguracji. Dla większych programów dokumentacja
jest zwykle dostaraczana jako osobny pakiet (o nazwie identycznej
z pakietem pierwotnym zakończonej <em>-doc</em>).
</dd>
<dt><strong>karty referencyjne</strong></dt>
<dd>
<p>Karty referencyjne są bardzo zwięzłymi podsumowaniami całego
(pod)systemu. Zwykle zawierają najczęściej używane polecenia ujęte
na pojedynczej kartce paieru. Niektóre ważniejsze karty referencyjne
można znaleźć na:</p>
<dl>
<dt><a href="https://www.debian.org/doc/manuals/refcard/refcard">Debian
GNU/Linux Reference Card</a></dt>
<dd>Karta ta może zostać wydrukowana na pojedynczej kartce,
zawiera listę najważniejszych poleceń i jest polecana dla nowych
użytkowników Debiana, którzy chcą się z nim zapoznać. Konieczna
jest jedynie podstawowa wiedza o komputerze, plikach, katalogach
i poleceniach systemu. Nowi użytkownicy być może powinni
przeczytać najpierw
<a href="user-manuals#quick-reference">Debian Reference</a>.</dd>
</dl>
</dd>
</dl>
<hrline>
<p>Dokumenty po polsku są wymienione na
<a href="https://www.debian.org/international/Polish/">polskiej stronie</a>
<em>(uwaga tłum.)</em>.</p>
<p>Jeśli sprawdziłeś wszystkie powyższe zasoby i nadal nie możesz znaleźć
odpowiedzi na swoje pytania lub rozwiązania problemów dotyczących Debiana,
zobacz naszą <a href="../support">stronę dotyczącą wsparcia</a>.</p>
|
