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
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
|
#use wml::debian::template title="Documentación"
#use wml::debian::translation-check translation="c790f7f61751233c03e89933584b7792b6970aef" maintainer="Jorge Barreiro González"
<p>A documentación, os manuais técnicos que describen a operativa e
uso dos aplicativos, son unha parte importante de todo sistema operativo.
Como parte dos esforzos por crear un sistema operativo de alta calidade,
o proxecto Debian esfórzase en proporcionar aos seus usuarios unha documentación
axeitada de forma facilmente accesible.</p>
<h2>Comezo rápido</h2>
<p>Se é <em>novo</em> en Debian recomendámoslle que comece por ler:</p>
<ul>
<li><a href="$(HOME)/releases/stable/installmanual">Guía de instalación</a></li>
<li><a href="manuals/debian-faq/">FAQ de Debian GNU/Linux</a></li>
</ul>
<p>Teña estes documentos a man cando realice a súa primeira instalación de Debian.
Responderán moitas cuestións e axudaranlle a traballar co seu novo sistema Debian.
Máis tarde pode querer continuar con:</p>
<ul>
<li><a href="manuals/debian-reference/">Referencia de Debian</a>,
o manual principal para os usuarios</li>
<li><a href="$(HOME)/releases/stable/releasenotes">Notas da versión</a>,
para a xente que estea a actualizar</li>
<li><a href="https://wiki.debian.org/">Debian Wiki</a>, unha boa fonte de
información para os recen chegados.</li>
</ul>
<p>Finalmente, asegúrese de imprimir e ter sempre a man a <a
href="https://www.debian.org/doc/manuals/refcard/refcard">tarxeta de referencia
de Debian GNU/Linux</a>, unha lista dos comandos máis importantes nun
sistema Debian.</p>
<p>Hai bastante máis información listada a continuación.</p>
<h2>Tipos de documentación</h2>
<p>A maioría da documentación incluída en Debian foi escrita para GNU/Linux en
xeral. Tamén hai documentación escrita especificamente para Debian. Estes documentos
poden dividirse nestas categorías básicas:</p>
<ul>
<li><a href="#manuals">manuais</a></li>
<li><a href="#howtos">HOWTOs (receitas)</a></li>
<li><a href="#faqs">FAQs (preguntas comúns)</a></li>
<li><a href="#other">outros documentos máis curtos</a></li>
</ul>
<h3 id="manuals">Manuais</h3>
<p>Os manuais parecen libros, xa que describen temas importantes de forma
exhaustiva.</p>
<h3>Manuais específicos de Debian</h3>
<div class="line">
<div class="item col50">
<h4>Manuais para os usuarios</h4>
<ul>
<li><a href="user-manuals#faq">FAQ de Debian GNU/Linux</a></li>
<li><a href="user-manuals#install">Guía de instalación de Debian</a></li>
<li><a href="user-manuals#relnotes">Notas da versión de Debian</a></li>
<li><a href="user-manuals#quick-reference">Referencia de Debian</a></li>
<li><a href="user-manuals#securing">Manual de seguridade de Debian</a></li>
<li><a href="user-manuals#java-faq">FAQ de Debian GNU/Linux e Java</a></li>
</ul>
</div>
<div class="item col50 lastcol">
<h4>Manuais dos desenvolvedores</h4>
<ul>
<li><a href="devel-manuals#policy">Manual da política de Debian</a></li>
<li><a href="devel-manuals#devref">Referencia dos desenvolvedores de Debian</a></li>
<li><a href="devel-manuals#maint-guide">Guía do novo mantedor de Debian</a></li>
<li><a href="devel-manuals#packaging-tutorial">Introdución ó empaquetado de Debian</a></li>
<li><a href="devel-manuals#menu">O sistema de menú de Debian</a></li>
<li><a href="devel-manuals#i18n">Introdución á i18n (internacionalización)</a></li>
<li><a href="devel-manuals#d-i-internals">Implementación do instalador de Debian</a></li>
</ul>
<h4>Manuais varios</h4>
<ul>
<li><a href="misc-manuals#history">Historia do proxecto Debian</a></li>
<li><a href="misc-manuals#markup">Manual da linguaxe de marcado SGML-Debiandoc</a></li>
<li><a href="misc-manuals#sgml-howto">Receita de Debian SGML/XML</a></li>
</ul>
</div>
</div>
<p class="clr">Pode atopar a lista completa de manuais de Debian e outra documentación nas
páxinas web do <a href="ddp">proxecto de documentación de Debian</a>.</p>
<p>Tamén hai varios manuais para usuarios de Debian GNU/Linux dispoñíbeis en
<a href="books">formato impreso</a>.</p>
<h3>Manuais para GNU/Linux en xeral</h3>
<p>Algúns dos documentos e manuais máis coñecidos para Linux son
<a href="https://tldp.org/LDP/gs/gs.html">«Instalando e comezando
con Linux»</a>,
<a href="http://www.ibiblio.org/pub/Linux/docs/linux-doc-project/users-guide/">\
«Guía dos usuarios de Linux»</a>,
<a href="https://tldp.org/LDP/nag/nag.html">
«Guía dos administradores de rede»</a>,
<a href="https://tldp.org/LDP/sag/">
«Guía dos administradores de sistemas»</a>, entre outros.</p>
<p>A documentación de Linux coordínase a través dos esforzos do
<a href="https://tldp.org/">proxecto de documentación de Linux</a>
(Linux Documentation Project, LDP).
Pode atopar a colección completa de manuais do LDP
<a href="https://tldp.org/guides.html">na súa páxina web</a>, con moita
outra documentación, tanto en formato electrónico como impreso.</p>
<h3 id="howtos">Receitas (HOWTOs)</h3>
<p>Os <a href="https://tldp.org/docs.html#howto">documentos de receitas
(HOWTO)</a>, como o seu nome indica, describen <em>os pasos dunha receita</em>
para facer algo, e normalmente cobren un tema máis específico.</p>
<p>Algunhas das receitas máis importantes de Linux son:</p>
<ul>
<li><a href="https://tldp.org/HOWTO/Hardware-HOWTO/">
Receita para a compatibilidade do Hardware</a>,</li>
<li><a href="https://tldp.org/HOWTO/Unix-and-Internet-Fundamentals-HOWTO/">\
receita de Unix e Internet básicos</a>,</li>
# currently not available
# <li><a href="https://tldp.org/HOWTO/Kernel-HOWTO.html">Kernel
# HOWTO</a>,</li>
<li><a href="https://tldp.org/HOWTO/Filesystems-HOWTO.html">
receita dos sistemas de ficheiros</a>,</li>
<li><a href="https://tldp.org/HOWTO/Config-HOWTO.html">
receita de configuración</a>,</li>
<li><a href="https://tldp.org/HOWTO/Net-HOWTO/">
receita para rede</a>,</li>
<li>entre <a href="https://tldp.org/HOWTO/HOWTO-INDEX/categories.html">\
outras moitas</a>.</li>
</ul>
<h3 id="faqs">Preguntas comúns (FAQs)</h3>
<p>FAQ é acrónimo de <em>frequently asked questions</em> (preguntas comúns). Un FAQ é un
documentos que responde a esas preguntas.</p>
<p>O <a href="https://tldp.org/FAQ/Linux-FAQ/">FAQ de Linux</a>
contén información sobre Linux en xeral.</p>
<p>As cuestións especificamente sobre Debian respóndense no
<a href="manuals/debian-faq/">FAQ de Debian</a>.
Tamén hai un <a href="../CD/faq/">FAQ independente sobre as imaxes de CD/DVD de Debian
</a>.</p>
<p>Consulte o <a href="https://tldp.org/FAQ/">índice de FAQs do LDP
</a> para obter máis información.</p>
<h3 id="other">Outros documentos máis curtos</h3>
<p>Os seguintes documentos inclúen instrucións máis rápidas e curtas:</p>
<dl>
<dt><strong><a href="https://tldp.org/docs.html#man">páxinas do manual</a></strong></dt>
<dd>Tradicionalmente, todos os programas de Unix se documentan con <em>páxinas do manual</em>,
manuais de referencia dispoñíbeis ca orde <tt>man</tt>. Normalmente non están pensados
para novatos. Pode buscar e consultar as páxinas do manual dispoñíbeis en Debian en
<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">ficheiros info</a></strong></dt>
<dd>Moito do software de GNU documéntase mediante <em>ficheiros info</em>
en lugar de en páxinas do manual. Estes ficheiros inclúen información
detallada sobre o propio programa, opcións e exemplos de uso e están
dispoñíbeis a través da orde <tt>info</tt>.</dd>
<dt><strong>ficheiros README (léame) variados</strong></dt>
<dd>Os ficheiros <em>léame</em> tamén son comúns — son simples
ficheiros de texto que describen un só elemento, normalmente un paquete.
Pode atopar moitos deles nos subcartafois de <tt>/usr/share/doc/</tt>
no seu sistema Debian. Cada paquete terá un subcartafol aí, co seu propio
ficheiro «léame», e pode incluír tamén exemplos de configuración. Fíxese que
para aplicativos grandes, a documentación normalmente ven en un paquete separado
(co mesmo nome que o paquete orixinal, pero acabado en <em>-doc</em>).
</dd>
<dt><strong>tarxetas de referencia rápida</strong></dt>
<dd>
<p>As tarxetas de referencia rápida son resumos moi curtos dun (sub)sistema
concreto. Normalmente estas tarxetas traen as ordes de usuario máis comúns nun só
folio. Algunhas das tarxetas de referencias e coleccións son:</p>
<dl>
<dt><a href="https://www.debian.org/doc/manuals/refcard/refcard">
Tarxeta de referencia de Debian GNU/Linux</a></dt>
<dd>Esta tarxeta, que pode ser impresa nun só folio, ofrece unha lista das
ordes máis importantes e é unha boa referencia para os novos usuarios de Debian que
queiran familiarizarse con elas. Requírese polo menos ter un coñecemento básico do
computador, ficheiros, directorios e da liña de ordes. Os usuarios novatos deberían
ler antes a <a href="user-manuals#quick-reference">referencia de Debian</a>.</dd>
</dl>
</dd>
</dl>
<hrline />
<p>Se xa comprobou os anteriores recursos e aínda así non atopa resposta ás súas
cuestións ou solución aos seus problemas sobre Debian, bótelle unha ollada á nosa
<a href="../support">páxina de asistencia</a>.</p>
|
