6704
Comment:
|
6759
|
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 88: | Line 88: |
= Program documentation = | = Documentazione programmi = |
Line 93: | Line 93: |
* una [[ManPage|pagina man]] (digitare {{{man}}} seguito dal nome del comando). | * una [[it/ManPage|pagina man]] (digitare {{{man}}} seguito dal nome del comando). |
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
La documentazione più famosa per utenti Debian è:
la guida di installazione
. http://www.debian.org/doc/user-manuals#install
. (o la versione di sviluppo, disponibile a http://d-i.alioth.debian.org/manual/le note di rilascio
. http://www.debian.org/doc/user-manuals#relnotesla Debian reference
. http://www.debian.org/doc/user-manuals#quick-reference
Molta altra documentazione per Debian è disponibile all'indirizzo www.debian.org/doc
Per il momento, Debian non ha un manuale per Amministratore di Sistema.
La maggior parte della documentazioned per gli sviluppatori Debian (e per i mantainer dei pacchetti) è disponibile a questo indirizzo : www.debian.org/devel/.
Siti ufficiali del Progetto Debian
Su Debian.org, sito ufficiale di Debian, si può trovare una sezione specificamente dedicata alla documentazione.
http://db.debian.org - il database degli sviluppatori Debian;
http://www.debian.org/doc - la homepage della documentazione Debian;
http://www.debian.org/doc/manuals/reference/ - il Debian Reference Manual;
http://www.debian.org/releases/stable/installmanual - il manuale di installazione;
http://www.debian.org/support - la homepage del supporto;
Forum
http://lists.debian.org - le Mailinglist, il modo principale di comunicare in Debian;
http://lists.debian.org/users.html - le mailing list degli utenti;
http://forums.debian.net - i forum di Debian.net ;
Advocacy, sviluppatori, informazioni interne
UnofficialRepositories - un elenco di repository non ufficiali: possono essere davvero utili;
http://alioth.debian.org - hosting per i progetti degli sviluppatori programmi open source;
http://mentors.debian.net - repository di pacchetti pubblici;
http://planet.debian.org - Planet Debian, aggregatore di un gran numero di blog degli svluppatori;
http://planeta.debian.net - Planeta Debian, un aggregatore di blog in spagnolo;
http://release.debian.org - pagine di gestione delle versioni Debian;
http://snapshot.debian.net - pacchetti Debian archiviati giornalmente dal 2002/06/04;
http://times.debian.net - Debian Times
http://www.backports.org - i backport per la distribuzione stable;
http://www.debian.org/News - le notizie ufficiali;
http://db.debian.org - database degli sviluppatori Debian;
http://udd.debian.org/ - Ultimate Debian Database;
Wiki
Debian Related Wikis
http://wiki.debconf.org - il Wiki della DebConf;
http://wiki.debian.org - il Wiki ufficiale Debian;
Books
Molti libri liberi e non sono elencati sul sito internet di Debian.
http://www.debian.org/doc/books - la biblioteca 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:
Questo è free software,tu puoi aiutare a migliorare la documentazione
(cioè non devi scrivere il tuo Howto personale!).