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
226
227
228
229
230
231
232
233
234
235
|
#use wml::debian::template title="Documentazione"
#use wml::debian::translation-check translation="1.104" maintainer="Mirco Scottà"
<p>Una parte importante di qualsiasi sistema operativo è la documentazione,
cioè i manuali tecnici che descrivono le operazioni e l'uso dei programmi.
Una parte degli sforzi che il Progetto Debian fa per creare un sistema
operativo libero di alta qualità è relativa alla fornitura di documentazione
corretta a tutti gli utenti in maniera facilmente accessibile.</p>
<h2>Per iniziare</h2>
<p>Se <em>non si conosce già</em> Debian è raccomandabile iniziare
leggendo:</p>
<ul>
<li><a href="$(HOME)/releases/stable/installmanual">Installation Guide (Guida all'installazione)</a></li>
<li><a href="manuals/debian-faq/">Debian GNU/Linux FAQ</a></li>
</ul>
<p>Le si tenga a portata di mano durante la prima installazione,
probabilmente risolveranno molti dubbi ed aiuteranno a lavorare con il proprio nuovo sistema Debian. Dopo si dovrebbe proseguire con:</p>
<ul>
<li><a href="manuals/debian-reference/">Debian Reference (La guida Debian)</a>,
il manuale principale per gli utenti</li>
<li><a href="$(HOME)/releases/stable/releasenotes">Release Notes</a>,
utili a chi sta effettuando un aggiornamento</li>
<li><a href="https://wiki.debian.org/">Debian Wiki</a>, una buona fonte
di informazioni per i novizi</li>
</ul>
<p>Infine si stampi e si tenga a portata di mano la <a
href="https://www.debian.org/doc/manuals/refcard/refcard">Debian GNU/Linux Reference
Card</a>, un elenco dei più importanti comandi dei sistemi Debian.</p>
<p>Altra documentazione utile è elencata in seguito.</p>
<h2>Tipi di documentazione</h2>
<p>Gran parte della documentazione inclusa in Debian è stata scritta per
GNU/Linux in generale. C'è anche della documentazione scritta specificatamente
per Debian. Questi documenti sono divisi principalmente in queste categorie:</p>
<ul>
<li><a href="#manuals">manuali</a></li>
<li><a href="#howtos">HOWTO</a></li>
<li><a href="#faqs">FAQ (domande frequenti)</a></li>
<li><a href="#other">altri documenti brevi</a></li>
</ul>
<h3 id="manuals">Manuali</h3>
<p>I manuali sembrano dei libri poiché descrivono in maniera esaustiva
argomenti corposi.</p>
<h3>Manuali specifici Debian</h3>
<div class="line">
<div class="item col50">
<h4>Manuali utente</h4>
<ul>
<li><a href="user-manuals#faq">Debian GNU/Linux FAQ</a></li>
<li><a href="user-manuals#install">Debian Installation Guide (Guida all'installazione di Debian)</a></li>
<li><a href="user-manuals#relnotes">Debian Release Notes</a></li>
<li><a href="user-manuals#quick-reference">Debian Reference (La guida Debian)</a></li>
<li><a href="user-manuals#securing">Securing Debian Manual</a></li>
<li><a href="user-manuals#java-faq">Debian GNU/Linux and Java FAQ</a></li>
</ul>
</div>
<div class="item col50 lastcol">
<h4>Manuali per gli sviluppatori</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#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#i18n">Introduction to i18n</a></li>
<li><a href="devel-manuals#d-i-internals">Debian Installer internals</a></li>
</ul>
<h4>Manuali vari</h4>
<ul>
<li><a href="misc-manuals#history">Debian Project History</a></li>
<li><a href="misc-manuals#markup">Debiandoc-SGML Markup Manual</a></li>
<li><a href="misc-manuals#sgml-howto">Debian SGML/XML HOWTO</a></li>
</ul>
</div>
</div>
<p class="clr">La lista completa dei manuali Debian e altra documentazione può essere
trovata alle pagine web del <a href="ddp">Debian Documentation Project</a>.</p>
<p>Ci sono anche altri manuali utente scritti per Debian GNU/Linux disponibili
in <a href="books">forma stampata</a>.</p>
<h3>Manuali per GNU/Linux in generale</h3>
<p>Alcuni dei più popolari documenti Linux e manuali sono
<a href="http://www.tldp.org/LDP/gs/gs.html">Linux Installation and
Getting Started</a>,
<a href="http://www.ibiblio.org/pub/Linux/docs/linux-doc-project/users-guide/">\
Linux Users' Guide</a>,
<a href="http://www.tldp.org/LDP/nag/nag.html">Network Administrators'
Guide</a>,
<a href="http://www.tldp.org/LDP/sag/">System Administrator's
Guide</a> e altri.</p>
<p>Linux documentation è coordinato tramite lo sforzo del
<a href="http://www.tldp.org/">Linux Documentation Project</a> (LDP).
Puoi trovare l'elenco completo dei manuali LDP
<a href="http://www.tldp.org/guides.html">presso il sito LDP</a>, assieme
a molta altra documentazione, sia in formato elettronico che cartaceo.</p>
<h3 id="howtos">HOWTO</h3>
<p>I <a href="http://www.tldp.org/docs.html#howto">documenti
HOWTO</a>, come suggerisce il nome, descrivono <em>how to (come si)</em> fa
qualcosa. Di solito coprono un oggetto molto specifico.</p>
<p>Alcuni dei più importanti HOWTO Linux sono:</p>
<ul>
<li><a href="http://www.tldp.org/HOWTO/Hardware-HOWTO/">Hardware
Compatibility HOWTO</a>,</li>
<li><a href="http://www.tldp.org/HOWTO/Unix-and-Internet-Fundamentals-HOWTO/">\
Unix and Internet Fundamentals HOWTO</a>,</li>
# currently not available
# <li><a href="http://www.tldp.org/HOWTO/Kernel-HOWTO.html">Kernel
# HOWTO</a>,</li>
<li><a href="http://www.tldp.org/HOWTO/Filesystems-HOWTO.html">Filesystems
HOWTO</a>,</li>
<li><a href="http://www.tldp.org/HOWTO/Config-HOWTO.html">Configuration
HOWTO</a>,</li>
<li><a href="http://www.tldp.org/HOWTO/Net-HOWTO/">Networking
HOWTO</a>,</li>
<li>e <a href="http://www.tldp.org/HOWTO/HOWTO-INDEX/categories.html">\
molti altri</a>.</li>
</ul>
<h3 id="faqs">FAQ</h3>
<p>FAQ sta per <em>frequently asked questions (domande fatte spesso)</em>.
Una FAQ è un documento che riporta le risposte a queste domande.</p>
<p>La <a href="http://www.tldp.org/FAQ/Linux-FAQ/">Linux FAQ</a>
contiene informazioni che riguardano Linux in generale.</p>
<p>Domande relative a Debian trovano invece risposta nella
<a href="manuals/debian-faq/">Debian FAQ</a>.
È anche disponibile una <a href="../CD/faq/">FAQ sulle immagini CD/DVD
Debian</a>.</p>
<p>Si veda anche l'<a href="http://www.tldp.org/FAQ/">indice FAQ LDP</a>
per maggiori informazioni.</p>
<h3 id="other">Altri documenti brevi</h3>
<p>I seguenti documenti forniscono informazioni veloci e brevi:</p>
<dl>
<dt><strong><a href="http://www.tldp.org/docs.html#man">pagine man</a></strong></dt>
<dd>Per tradizione tutti i programmi Unix sono documentati con delle
<em>pagine di manuale</em>, vale a dire il manuale di riferimento che
è accessibile tramite il comando <tt>man</tt>.
In genere non sono pensate per chi si sta avvicinando a Unix. Si possono ricercare
e leggere le pagine man disponibili in Debian
su <a href="http://manpages.debian.net/cgi-bin/man.cgi">http://manpages.debian.net/</a>.
</dd>
<dt><strong><a href="http://www.gnu.org/software/texinfo/manual/texinfo/html_node/index.html">file info</a></strong></dt>
<dd>Molto del software GNU ha la propria documentazione contenuta nei <em>file
info</em> invece che nelle pagine man. Questi file contengono informazioni dettagliate
sul programma stesso, sulle opzioni ed esempi d'uso e sono disponibili
tramite il
comando <tt>info</tt>.
</dd>
<dt><strong>vari file README</strong></dt>
<dd>I file <em>read me (leggimi)</em> sono molto diffusi — sono dei
semplici file di testo che descrivono una sola cosa, normalmente un
pacchetto. Se ne trovano parecchi nelle sottodirectory di
<tt>/usr/share/doc/</tt> del proprio sistema Debian. Ogni pacchetto software ha una sottodirectory
contenente i suoi file readme e che potrebbe contenere anche
degli esempi di configurazioni. Si noti come, per i programmi di maggior dimensione, la documentazione
è solitamente fornita in un pacchetto separato (con lo stesso nome del
pacchetto originale e l'aggiunta del suffisso <em>-doc</em>).
</dd>
<dt><strong>quick reference card</strong></dt>
<dd>
<p>Le <q>Quick reference card</q> sono dei sommari molto brevi di alcuni
(sotto)sistemi. Abitualmente forniscono un riferimento alla maggior parte dei comandi
più usati su un singolo foglio. Alcune di esse
sono:</p>
<dl>
<dt><a href="https://www.debian.org/doc/manuals/refcard/refcard">Debian
GNU/Linux Reference Card</a></dt>
<dd>Questa card, che può essere stampata su un singolo foglio,
fornisce un elenco dei più importanti comandi ed è
un buon punto di riferimento per i nuovi utenti di Debian che vogliano
familiarizzare con essa. È richiesta una conoscenza di base di computer,
file, directory e della riga di comando.
I novizi dovrebbero leggere prima la
<a href="user-manuals#quick-reference">Debian Reference (La guida Debian)</a>.</dd>
<dt><a href="http://www.refcards.com/">refcards.com</a></dt>
<dd>Una collezione di quick reference card focalizzata principalmente sul
Software Free ed Open Source</dd>
<dt><a href="http://www.digilife.be/quickreferences/quickrefs.htm">Quick Reference Cards</a></dt>
<dd>Una collezione di <q>quick reference card</q> per i più popolari
programmi e linguaggi di programmazione</dd>
</dl>
</dd>
</dl>
<hrline />
<p>Se hai verificato tutto quanto qui descritto senza trovare le risposte
alle domande che poni o soluzione ai tuoi problemi con Debian, allora dai
uno sguardo alle nostre <a href="../support">pagine di supporto</a>.</p>
|
