Differences between revisions 1 and 4 (spanning 3 versions)
Revision 1 as of 2010-01-25 17:35:15
Size: 6690
Comment: new translated page
Revision 4 as of 2010-09-22 10:19:57
Size: 7284
Comment: sync with English translation
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
~-Translation(s): [[DebianDocumentation|English]] -~ ~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: [[DebianDocumentation|English]] - Italiano-~
Line 4: Line 4:
Line 18: Line 17:
== Per gli utenti ==
Line 19: Line 20:
 * la guida di installazione ~-<<BR>>. [[http://www.debian.org/doc/user-manuals#install]]<<BR>>. (o la versione di sviluppo, disponibile a [[http://d-i.alioth.debian.org/manual/]]-~
 * le note di rilascio ~-<<BR>>. [[http://www.debian.org/doc/user-manuals#relnotes]]-~
 * la Debian reference ~-<<BR>>. [[http://www.debian.org/doc/user-manuals#quick-reference]]-~
 * la [[http://www.debian.org/releases/stable/installmanual|guida di installazione]] (o la [[http://d-i.alioth.debian.org/manual/|versione di sviluppo]])
 * le [[http://www.debian.org/releases/stable/releasenotes|note di rilascio]]
 * la [[http://www.debian.org/doc/user-manuals#quick-reference|Debian reference]]
Line 27: Line 28:
== Per i collaboratori ==
Line 28: Line 30:
La maggior parte della documentazioned per gli sviluppatori Debian (e per i mantainer dei pacchetti) è disponibile a questo indirizzo : [[http://www.debian.org/devel/|www.debian.org/devel/]]. La documentazione più famosa per i collaboratori Debian è :
 * il [[http://www.debian.org/social_contract|Contratto sociale]]
 * le [[http://www.debian.org/social_contract#guidelines|Linee guida Debian per il software libero (DFSG)]]
 * le [[http://www.debian.org/devel/dmup|Politiche Debian Machine Usage]] (dmup)
 * la [[DebianPolicy| Debian policy]]
 * il [[http://www.debian.org/doc/devel-manuals#devref|Manuale Debian Reference]]
 * la [[http://www.debian.org/doc/devel-manuals#maint-guide|Guida del nuovo manutentore Debian]]

La maggior parte della documentazione per gli sviluppatori Debian (e per i manutentori dei pacchetti) è disponibile su [[http://www.debian.org/devel/|www.debian.org/devel/]].
Line 32: Line 42:

Il Progetto Debian ha una [[http://www.debian.org/devel/constitution|costituzione]] e una [[http://www.debian.org/intro/organization|struttura organizzativa]].
Line 37: Line 50:
 * http://www.debian.org/doc/manuals/reference/ - il Debian Reference Manual;
 * http://www.debian.org/releases/stable/installmanual - il manuale di installazione;
Line 53: Line 64:
 * http://news.debian.net - Debian News
Line 57: Line 69:
 * http://times.debian.net - Debian Times
Line 88: Line 99:
= Program documentation = = Documentazione programmi =
Line 93: Line 104:
 * una [[ManPage|pagina man]] (digitare {{{man}}} seguito dal nome del comando).  * una [[it/ManPage|pagina man]] (digitare {{{man}}} seguito dal nome del comando).
Line 126: Line 137:
 * [[DebianResources]]

 * [[it/DebianResources|Risorse Debian]]

Translation(s): English - Italiano


Debian è una distribuzione costituita da molte migliaia di programmi liberi.

Questa pagina tratta della Documentazione ufficiale Debian.

Esistono anche altre risorse Debian.

Documentazione Debian

Per gli utenti

La documentazione più famosa per utenti Debian è:

Molta altra documentazione per Debian è disponibile all'indirizzo www.debian.org/doc

Per il momento, Debian non ha un manuale per Amministratore di Sistema.

Per i collaboratori

La documentazione più famosa per i collaboratori Debian è :

La maggior parte della documentazione per gli sviluppatori Debian (e per i manutentori dei pacchetti) è disponibile su www.debian.org/devel/.

Siti ufficiali del Progetto Debian

Il Progetto Debian ha una costituzione e una struttura organizzativa.

Su Debian.org, sito ufficiale di Debian, si può trovare una sezione specificamente dedicata alla documentazione.

Forum

Advocacy, sviluppatori, informazioni interne

Wiki

Debian Related Wikis

Books

Molti libri liberi e non sono elencati sul sito internet di Debian.

Ulteriori libri possono essere elencati qua sotto.

Instant Messaging

Esistono canali IRC ufficiali di Debian.

È possibile anche usare Jabber

Documentazione programmi

Ciascun programma fornisce la sua documentazione specifica.

Sotto Debian (Unix), la documentazione di un programma consiste, in genere, di uno o più dei seguenti elementi:

  • una pagina man (digitare man seguito dal nome del comando).

  • un file README, fornito dalla versione originale. (È un file di testo che si trova al percorso /usr/share/doc/pkgname/README)

  • un file README.Debian, fornito dal maintainer del pacchetto Debian. (È un file che si trova al percorso /usr/share/doc/pkgname/README.Debian)

  • i programmi dotati di interfaccia grafica (Gnome, KDE...) di solito hanno delle pagine di aiuto (raggiungibili tramite Menu > Help).

  • alcuni programmi forniscono la propria documentazione in formato html, o sotto forma di pagina info.

Descrizione dei pacchetti

Nella descrizione di un pacchetto si possono trovare alcune informazioni utili, come una breve descrizione del pacchetto stesso, un link al sito del progetto, un elenco dei file contenuti al suo interno, e molto altro. Si può accedere alla descrizione di un pacchetto tramite l'url http://packages.debian.org/<package-name> , oppure provando "aptitude show $PKG" (potrebbe essere necessario eseguire prima un "apt-get update && apt-get aptitude && aptitude update").

Uno dei modi più indicati per trovare un aiuto per un singolo pacchetto o applicazione è leggere il contenuto di /usr/share/doc/<package-name> (in particolare il file README.Debian). Questa documentazione è stata scritta dagli sviluppatori o dai manutentori dei pacchetti ed è abbastanza sintetica ma, normalmente, menziona i problemi più comuni e le relative soluzioni, le nuove funzionalità e i bug risolti.

Sistema di tracciamento dei bug (BTS)

La soluzione a molti problemi può essere trovata sotto forma di risposte alle segnalazioni dei bug. Un motore di ricerca per le segnalazioni di bug si trova su http://bugs.debian.org ; se si desidera ricercare tra i bug archiviati (quelli abbastanza vecchi) bisogna scegliere l'opzione "bug archiviati". Per guardare i bug relativi ad un pacchetto specifico si può usare http://bugs.debian.org/<package-name>.

Contribuire alla documentazione

La maggior parte della documentazione Debian è disponibile all'indirizzo http://www.debian.org/doc/ddp

se si è interessati a contribuire, è possibile leggere le mailing list:

Si veda anche