3 581
contributi
Documentazione Debian: differenze tra le versioni
Vai alla navigazione
Vai alla ricerca
verificata per Buster, controllo link/esistenza dei pacchetti di documentazione
S3v (discussione | contributi) m (→Introduzione) |
(verificata per Buster, controllo link/esistenza dei pacchetti di documentazione) |
||
| (12 versioni intermedie di 2 utenti non mostrate) | |||
| Riga 6: | Riga 6: | ||
Tutta la documentazione è completamente libera e modificabile, chiunque può suggerire cambiamenti. | Tutta la documentazione è completamente libera e modificabile, chiunque può suggerire cambiamenti. | ||
{{Versioni compatibili}} | {{Versioni compatibili|Jessie|Stretch|Buster}} | ||
== Introduzione == | == Introduzione == | ||
Questa guida cercherà di raggruppare il maggior numero possibile di link e informazioni riguardanti la documentazione ufficiale presente in Debian. Se qualcosa manca, basta aggiungerla!<br/> | Questa guida cercherà di raggruppare il maggior numero possibile di link e informazioni riguardanti la documentazione ufficiale presente in Debian. Se qualcosa manca, basta aggiungerla!<br/> | ||
| Riga 14: | Riga 14: | ||
==== Contratto sociale ==== | ==== Contratto sociale ==== | ||
Il contratto sociale che è alla base della comunità Debian e la filosofia che ne muove le scelte e i passi.<br/> | Il contratto sociale che è alla base della comunità Debian e la filosofia che ne muove le scelte e i passi.<br/> | ||
[ | [https://www.debian.org/social_contract Il contratto sociale di Debian]<br/> | ||
[ | [https://www.debian.org/social_contract#guidelines Debian Free Software Guidelines]<br/> | ||
Queste pagine sono contenute anche nel pacchetto '''doc-debian''' . | Queste pagine sono contenute anche nel pacchetto '''doc-debian''' . | ||
==== Debian Project History ==== | ==== Debian Project History ==== | ||
Questo manuale tratta la storia, gli scopi e le problematiche del Progetto Debian.<br/> | Questo manuale tratta la storia, gli scopi e le problematiche del Progetto Debian.<br/> | ||
[ | [https://www.debian.org/doc/manuals/project-history/index.it.html Storia del progetto Debian]<br/> | ||
Il manuale è contenuto anche nel pacchetto '''debian-history''' . | Il manuale è contenuto anche nel pacchetto '''debian-history''' . | ||
| Riga 26: | Riga 26: | ||
==== Guida all'installazione ==== | ==== Guida all'installazione ==== | ||
Contiene le informazioni che è necessario leggere per installare Debian o per risolvere problemi legati all'installazione.<br/> | Contiene le informazioni che è necessario leggere per installare Debian o per risolvere problemi legati all'installazione.<br/> | ||
[ | [https://www.debian.org/releases/stable/installmanual Guida all'installazione di Debian]<br/> | ||
Questa guida è disponibile come pacchetto per diverse architetture. Ad esempio per leggere la guida sull'installazione per ''amd64'': | Questa guida è disponibile come [[pacchetto]] per diverse architetture. Ad esempio per leggere la guida sull'installazione per ''amd64'', è sufficiente installare con [[privilegi di amministrazione]] il pacchetto '''installation-guide-amd64''': | ||
<pre># apt | <pre># apt install installation-guide-amd64</pre> | ||
altri pacchetti disponibili: '''installation-guide- | altri pacchetti disponibili: '''installation-guide-arm64''', '''installation-guide-armel''', '''installation-guide-armhf''', '''installation-guide-i386''', '''installation-guide-kfreebsd-amd64''', '''installation-guide-kfreebsd-i386''', '''installation-guide-mips''', '''installation-guide-mipsel''', '''installation-guide-powerpc''', '''installation-guide-ppc64el''', '''installation-guide-s390x'''. | ||
Il pacchetto è multilingua, e in particolare contiene la guida sia in italiano sia in inglese, in formato HTML oppure compresso nei formati PDF e TXT. La guida in italiano e inglese nei diversi formati è consultabile nelle cartelle '''<code>it</code>''' ed '''<code>en</code>''' rispettivamente al percorso <code>/usr/share/doc/''nome-pacchetto''</code> (per esempio '''<code>/usr/share/doc/installation-guide-amd64/it</code>''' per la guida in italiano per l'architettura ''amd64''). | |||
==== Debian release notes ==== | ==== Debian release notes ==== | ||
Le note di rilascio di Debian. Vengono scritte quando una nuova versione di Debian è disponibile per il download.<br/> | Le note di rilascio di Debian. Vengono scritte quando una nuova versione di Debian è disponibile per il download.<br/> | ||
[ | [https://www.debian.org/releases/stable/releasenotes Note di rilascio di Debian] | ||
==== Debian reference guide ==== | ==== Debian reference guide ==== | ||
La guida di riferimento per chiunque utilizzi Debian.<br/> | La guida di riferimento per chiunque utilizzi Debian.<br/> | ||
[ | [https://www.debian.org/doc/manuals/debian-reference/ Debian reference guide]<br/> | ||
La guida è disponibile tramite i pacchetti '''debian-reference''' (versione inglese) e '''debian-reference-it''' (in italiano) nella cartella <code>/usr/share/debian-reference</code> nel formato HTML o compresso nei formati EPUB e TXT. | |||
==== Debian FAQ ==== | ==== Debian FAQ ==== | ||
Le domande (e le risposte) più ricorrenti che si pone un utente Debian.<br/> | Le domande (e le risposte) più ricorrenti che si pone un utente Debian.<br/> | ||
[ | [https://www.debian.org/doc/manuals/debian-faq/index.it.html Debian FAQ]<br/> | ||
Le FAQ sono disponibili | Le FAQ sono disponibili tramite i pacchetti '''debian-faq''' (versione inglese) e '''debian-faq-it''' (versione italiana) nella cartella <code>/usr/share/doc/debian/FAQ</code> o <code>/usr/share/doc/debian/FAQ/it</code> rispettivamente, nel formato HTML o compresso nei formati PDF, PS e TXT. | ||
==== Debian Policy ==== | ==== Debian Policy ==== | ||
Questo documento contiene tutto ciò che c'è da sapere sulla distribuzione Debian, il suo utilizzo del filesystem e i requisiti richiesti affinché un pacchetto possa aderire alle regole che Debian si è data.<br/> | Questo documento contiene tutto ciò che c'è da sapere sulla distribuzione Debian, il suo utilizzo del filesystem e i requisiti richiesti affinché un pacchetto possa aderire alle regole che Debian si è data.<br/> | ||
[ | [https://www.debian.org/doc/debian-policy/ Debian Policy]<br/> | ||
La policy di Debian è consultabile anche installando il pacchetto '''debian-policy'''. | La policy di Debian è consultabile anche installando il pacchetto '''debian-policy''', leggendo tutta la documentazione presente nella cartella <code>/usr/share/doc/debian-policy</code> nei formati disponibili. | ||
==== The Debian Administrator's Handbook ==== | ==== The Debian Administrator's Handbook ==== | ||
Libro che spiega come amministrare una macchina Debian. Leggere anche [[Il manuale dell'amministratore Debian|qui]]. | <!-- | ||
NOTA: *NON* cambiare il nome della sezione "The Debian Administrator's Handbook", perché è utilizzata da altre guide. Cercare prima seguendo il link "Strumenti -> Puntano qui" che non ci siano più guide che fanno riferimento a questa sezione. | |||
--> | |||
Libro che spiega come amministrare una macchina Debian. Leggere anche [[Il manuale dell'amministratore Debian|qui]].<br/> | |||
Il manuale è incluso anche nel pacchetto '''debian-handbook''' nella cartella <code>/usr/share/doc/debian-handbook/html</code> in formato HTML. | |||
==== Securing Debian Manual ==== | ==== Securing Debian Manual ==== | ||
Il manuale per configurare correttamente Debian dal punto di vista della sicurezza e per utilizzare le applicazioni necessarie a renderlo più sicuro e stabile.<br/> | Il manuale per configurare correttamente Debian dal punto di vista della sicurezza e per utilizzare le applicazioni necessarie a renderlo più sicuro e stabile.<br/> | ||
[ | [https://www.debian.org/doc/manuals/securing-debian-howto/index.en.html Securing Debian Manual]<br/> | ||
Il manuale è incluso anche nel pacchetto '''harden-doc'''. | Il manuale è incluso anche nel pacchetto '''harden-doc''', che non è presente in Debian 8 ([[Jessie]]), nella cartella <code>/usr/share/doc/harden-doc</code> in formato HTML oppure compresso nei formati PDF, PS e TXT. | ||
== Documentazione dei pacchetti == | == Documentazione dei pacchetti == | ||
Ciascun pacchetto installa i propri file di documentazione nella directory <code>/usr/share/doc/</code> o nella directory <code>/usr/share/doc-base/</code>.<br/> | Ciascun pacchetto installa i propri file di documentazione nella directory <code>/usr/share/doc/</code> o nella directory <code>/usr/share/doc-base/</code>.<br/> | ||
In queste directory sono presenti, e divisi in sottodirectory, tutti i file che ciascun pacchetto mette a disposizione per documentare il proprio funzionamento.<br/> | In queste directory sono presenti, e divisi in sottodirectory, tutti i file che ciascun pacchetto mette a disposizione per documentare il proprio funzionamento.<br/> | ||
Per conoscere quali sono i file che un pacchetto installa sul filesystem, si può ricorrere a | Per conoscere quali sono i file che un pacchetto installa sul filesystem, si può ricorrere a [[dpkg]]: | ||
<pre>$ dpkg -L nomepacchetto</pre> | <pre>$ dpkg -L nomepacchetto</pre> | ||
| Riga 81: | Riga 87: | ||
Ulteriore documentazione può essere contenuta in pacchetti separati che hanno, tipicamente ma non necessariamente, nel nome l'indicazione "-doc". È caso ad esempio di "linux-doc" o di "apt-doc"; ma ne esistono tantissimi altri.<br/> | Ulteriore documentazione può essere contenuta in pacchetti separati che hanno, tipicamente ma non necessariamente, nel nome l'indicazione "-doc". È caso ad esempio di "linux-doc" o di "apt-doc"; ma ne esistono tantissimi altri.<br/> | ||
La lista può essere ottenuta a partire dal [[tag]] "role:documentation" che accompagna pacchetti di questo tipo: | La lista può essere ottenuta a partire dal [[tag]] "role:documentation" che accompagna pacchetti di questo tipo: | ||
<pre>$ aptitude search | <pre>$ aptitude search "?tag(documentation)"</pre> | ||
(forma abbreviata: <code>"~Gdocumentation"</code>)<br/> | |||
È possibile utilizzare anche il solo <code>debtags</code> come segue, senza ricorrere alla ricerca avanzata di <code>aptitude</code>: | |||
<pre>$ debtags search role::documentation</pre> | <pre>$ debtags search role::documentation</pre> | ||
Notare che per effettuare una ricerca basata su tag servirà almeno uno dei pacchetti '''[[aptitude]]''' e '''<code>debtags</code>'''. Per installare quello preferito, con [[privilegi di amministrazione]] è sufficiente: | |||
<pre># apt install aptitude | |||
# apt install debtags</pre> | |||
== Le pagine di manuale == | == Le pagine di manuale == | ||
Anche note come man pages o [[ | Anche note come man pages o [[manpage]] o pagine man, sono probabilmente il tipo di documentazione più conosciuto e immediatamente accessibile a chiunque si trovi a che fare con una distribuzione Debian.<br/> | ||
La policy di Debian impone che qualunque pacchetto o funzione o libreria utilizzata debba essere accompagnata da una pagina di manuale, per cui è sufficiente un: | La policy di Debian impone che qualunque pacchetto o funzione o libreria utilizzata debba essere accompagnata da una pagina di manuale, per cui è sufficiente un: | ||
<pre>$ man apt | <pre>$ man apt</pre> | ||
per aprire, ad esempio, la pagina di manuale di "apt | per aprire, ad esempio, la pagina di manuale di "apt".<br/> | ||
Le pagine di manuale si trovano nella directory <code>/usr/share/man/</code> . | Le pagine di manuale si trovano nella directory <code>/usr/share/man/</code> . | ||
== I file info == | == I file info == | ||
Alcuni pacchetti possono prevedere una documentazione molto corposa oppure includere diversi comandi, ciascuno dei quali con una propria documentazione. In questo caso, accanto alla pagina di manuale, viene installato anche un file "info" che è possibile leggere con il comando "info". Ad esempio il comando: | Alcuni pacchetti, in particolare buona parte di quelli appartenenti al [[Il Progetto GNU|Progetto GNU]], possono prevedere una documentazione molto corposa oppure includere diversi comandi, ciascuno dei quali con una propria documentazione. In questo caso, accanto alla pagina di manuale, viene installato anche un file "info" che è possibile leggere con il comando "info". Ad esempio il comando: | ||
<pre>$ info grep</pre> | <pre>$ info grep</pre> | ||
permetterà di leggere il file "info" associato a grep.<br/> | permetterà di leggere il file "info" associato a grep.<br/> | ||
Fornisce informazioni molto utili in particolare per: <code>grub</code>, <code>find</code>, <code>nano</code>, <code>gnupg</code>, <code>wget</code>, <code>grep</code> e <code>sed</code>. Tutti i file info si trovano nella directory <code>/usr/share/info/</code> .<br/> | |||
In nuove installazioni di Debian 10 ([[Buster]]) è necessario installare il pacchetto, dato che non è più presente di default: | |||
<pre># apt install info</pre> | |||
== Il kernel Linux == | == Il kernel Linux == | ||
==== linux-doc ==== | ==== linux-doc ==== | ||
Questo pacchetto contiene tutte le informazioni sulla struttura del kernel e le specifiche dei driver.<br/> | Questo pacchetto contiene tutte le informazioni sulla struttura del kernel e le specifiche dei driver.<br/> | ||
Esistono diversi pacchetti in base alla versione del kernel: '''linux-doc-3.2''', '''linux-doc- | Esistono diversi pacchetti in base alla versione del kernel: '''linux-doc-3.2''', '''linux-doc-4.14'''. '''linux-doc-4.18'''. | ||
==== Kernel Hacker's Guide ==== | ==== Kernel Hacker's Guide ==== | ||
Contiene, sotto forma di manpage, la documentazione sulle API del kernel Linux. | Contiene, sotto forma di manpage, la documentazione sulle API del kernel Linux. Il nome di questi pacchetti è del tipo '''linux-manual-versione''', ad esempio '''linux-manual-3.2''', '''linux-manual-3.16''', '''linux-manual-4.9''' . | ||
Il pacchetto non è più presente a partire da Debian 10 ([[buster]]). | |||
==== Debian Kernel Handbook ==== | ==== Debian Kernel Handbook ==== | ||
Probabilmente la guida che bisogna assolutamente leggere se si vuol compilare un kernel per Debian, pacchettizzarlo in formato .deb o applicare una [[patch]].<br/> | Probabilmente la guida che bisogna assolutamente leggere se si vuol compilare un kernel per Debian, pacchettizzarlo in formato .deb o applicare una [[patch]].<br/> | ||
[ | [https://kernel-team.pages.debian.net/kernel-handbook/ Debian Kernel Handbook]<br/> | ||
La guida è contenuta anche nel pacchetto '''debian-kernel-handbook'''. | La guida è contenuta anche nel pacchetto '''debian-kernel-handbook'''. | ||
| Riga 116: | Riga 129: | ||
==== Guida per il nuovo Maintainer ==== | ==== Guida per il nuovo Maintainer ==== | ||
Scritta per coloro vogliono manutenere un pacchetto Debian e che si apprestano a diventare [[Debian Maintainers]]. Spiega i passi necessari per creare un pacchetto Debian in modo che soddisfi tutti gli standard necessari per essere incluso nella distribuzione.<br/> | Scritta per coloro vogliono manutenere un pacchetto Debian e che si apprestano a diventare [[Maintainer|Debian Maintainers]]. Spiega i passi necessari per creare un pacchetto Debian in modo che soddisfi tutti gli standard necessari per essere incluso nella distribuzione.<br/> | ||
[ | [https://www.debian.org/doc/manuals/maint-guide/ Guida per il nuovo maintainer]<br/> | ||
La documentazione è presente anche nei pacchetti '''maint-guide''' (in inglese) e '''maint-guide-it''' (in italiano). | La documentazione è presente anche nei pacchetti '''maint-guide''' (in inglese) e '''maint-guide-it''' (in italiano). | ||
==== Debian Developer's Reference ==== | ==== Debian Developer's Reference ==== | ||
Scritta per i [[Debian Developers]] ma consultabile, ovviamente, da chiunque. Copre tutti gli aspetti necessari da conoscere per essere un buon DD.<br/> | Scritta per i [[Debian Developer|Debian Developers]] ma consultabile, ovviamente, da chiunque. Copre tutti gli aspetti necessari da conoscere per essere un buon DD.<br/> | ||
[ | [https://www.debian.org/doc/manuals/developers-reference/ Debian Developer's Reference]<br/> | ||
la guida è presente nel pacchetto '''developers-reference''' ed è disponibile in diverse lingue (inglese, tedesco, francese e giapponese). | la guida è presente nel pacchetto '''developers-reference''' ed è disponibile in diverse lingue (inglese, tedesco, francese e giapponese). | ||
| Riga 128: | Riga 141: | ||
Semplice guida sulla pacchettizzazione in Debian. Il tutorial è corredato da molti link ed esempi e la sua lettura è fortemente consigliata per chi si accinge a creare un pacchetto Debian per la prima volta.<br/> | Semplice guida sulla pacchettizzazione in Debian. Il tutorial è corredato da molti link ed esempi e la sua lettura è fortemente consigliata per chi si accinge a creare un pacchetto Debian per la prima volta.<br/> | ||
La documentazione si trova in formato PDF nel pacchetto '''packaging-tutorial''' ed è disponibile in diverse lingue.<br/> | La documentazione si trova in formato PDF nel pacchetto '''packaging-tutorial''' ed è disponibile in diverse lingue.<br/> | ||
I file PDF possono essere scaricati anche da [ | I file PDF possono essere scaricati anche da [https://www.debian.org/doc/manuals/packaging-tutorial/ qui]. | ||
== Wiki Debian == | == Wiki Debian == | ||
Il Wiki è un ulteriore strumento messo a disposizione per fornire documentazione, howto, guide e informazioni su tutti gli aspetti che riguardano il progetto Debian, i progetti ad esso collegati e la configurazione del sistema operativo.<br/> | Il Wiki è un ulteriore strumento messo a disposizione per fornire documentazione, howto, guide e informazioni su tutti gli aspetti che riguardano il progetto Debian, i progetti ad esso collegati e la configurazione del sistema operativo.<br/> | ||
[ | [https://wiki.debian.org Il Wiki di Debian] | ||
== Pagine web dei pacchetti == | == Pagine web dei pacchetti == | ||
Ciascun pacchetto ha una pagina web in cui vengono riportate molte informazioni sulla sua funzione, sul suo stato, sui [[maintainer|maintainers]], sui [[bug]] e tanto altro.<br/> | Ciascun pacchetto ha una pagina web in cui vengono riportate molte informazioni sulla sua funzione, sul suo stato, sui [[maintainer|maintainers]], sui [[bug]] e tanto altro.<br/> | ||
È disponibile anche, se esiste, la homepage del programma se esso è il risultato di progetti esterni a Debian.<br/> | È disponibile anche, se esiste, la homepage del programma se esso è il risultato di progetti esterni a Debian.<br/> | ||
Ad esempio [ | Ad esempio [https://packages.debian.org/stable/apt questa] è la pagina web del pacchetto ''apt''. Per effettuare una ricerca dei pacchetti o nei pacchetti, si può utilizzare https://www.debian.org/distrib/packages . | ||
== Documentazione esterna == | == Documentazione esterna == | ||
| Riga 145: | Riga 158: | ||
== Link utili == | == Link utili == | ||
https://www.debian.org/doc/ | |||
{{Autori | |||
|Autore = [[Utente:S3v|S3v]] | |||
|Estesa_da = | |||
|Verificata_da = | |||
:[[Utente:HAL 9000|HAL 9000]] 08:55, 28 lug 2019 (CEST) | |||
|Numero_revisori = 1 | |||
}} | |||
[[Categoria:Introduzione a Debian]][[Categoria:Documentazione tecnica]] | [[Categoria:Introduzione a Debian]][[Categoria:Documentazione tecnica]][[Categoria: Risorse]] | ||