Differences between revisions 9 and 10
Revision 9 as of 2013-05-18 19:51:54
Size: 7351
Comment: sync with English master
Revision 10 as of 2014-07-19 19:17:14
Size: 7351
Comment: sync with English master
Deletions are marked like this. Additions are marked like this.
Line 64: Line 64:
 * http://news.debian.net - Debian News  * http://bits.debian.org - Blog Debian

Translation(s): English - Français - 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