6 999
contributi
Documentazione Debian: differenze tra le versioni
Vai alla navigazione
Vai alla ricerca
corretti link
S3v (discussione | contributi) m (→I file info) |
S3v (discussione | contributi) (corretti link) |
||
| (19 versioni intermedie di 2 utenti non mostrate) | |||
| Riga 8: | Riga 8: | ||
{{Versioni compatibili}} | {{Versioni compatibili}} | ||
== Introduzione == | == Introduzione == | ||
Questa guida cercherà di raggruppare il maggior numero possibile di link e informazioni riguardanti la | 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/> | ||
Tutti sono liberi di modificare questa pagina per fare in modo che chi si trovasse a leggerla possa ottenere il maggior numero possibile di informazioni su Debian e poter restituire in seguito un po' della conoscenza acquisita alla comunità a cui appartiene (non necessariamente Debian :) ) | Tutti sono liberi di modificare questa pagina per fare in modo che chi si trovasse a leggerla possa ottenere il maggior numero possibile di informazioni su Debian e poter restituire in seguito un po' della conoscenza acquisita alla comunità a cui appartiene (non necessariamente Debian :) ) | ||
| 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-get install installation-guide-amd64</pre> | <pre># apt-get 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> | ||
==== Changelog.gz e Changelog.Debian.gz ==== | ==== Changelog.gz e Changelog.Debian.gz ==== | ||
È il file in cui sono contenuti tutti i cambiamenti apportati al pacchetto .deb dal suo maintainer o dall'[[Upstream Author|upstreamer]]. Può essere visualizzato con <code>zless</code>: | È il file in cui sono contenuti tutti i cambiamenti apportati al pacchetto .deb dal suo [[maintainer]] o dall'[[Upstream Author|upstreamer]]. Può essere visualizzato con <code>zless</code>: | ||
<pre>$ zless Changelog.gz</pre> | <pre>$ zless Changelog.gz</pre> | ||
==== Copyright ==== | ==== Copyright ==== | ||
È il file che contiene informazioni sulla licenza e il copyright del contenuto del pacchetto. | È il file che contiene informazioni sulla licenza e il [[copyright]] del contenuto del pacchetto. | ||
==== News ==== | ==== News ==== | ||
È il file in cui il maintainer | È il file in cui il maintainer può inserire le novità introdotte dalle varie versioni del pacchetto. | ||
==== Readme ==== | ==== Readme ==== | ||
Il nome può trovarsi in diverse forme, ma l'unica cosa importante è che questo è un file da leggere assolutamente se si hanno problemi con un determinato pacchetto.<br/> | Il nome può trovarsi in diverse forme, ma l'unica cosa importante è che questo è un file da leggere assolutamente se si hanno problemi con un determinato pacchetto.<br/> | ||
Questi file sono tipicamente scritti dall'upstreamer del programma. Se il maintainer del pacchetto Debian è una persona diversa, è facile che esista anche un file README.Debian o con nome simile. | Questi file sono tipicamente scritti dall'upstreamer del programma. Se il [[maintainer]] del pacchetto Debian è una persona diversa, è facile che esista anche un file README.Debian o con nome simile. | ||
== Pacchetti di documentazione == | == Pacchetti di documentazione == | ||
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 ~Gdocumentation</pre> | <pre>$ aptitude search "~Gdocumentation"</pre> | ||
Notare che per effettuare una ricerca basata su tag | Notare che per effettuare una ricerca basata su tag serviranno i pacchetti '''[[aptitude]]''' e '''<code>debtags</code>'''. Per installarli, con [[privilegi di amministrazione]] è sufficiente: | ||
<pre># apt-get install aptitude debtags</pre> | |||
È 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> | |||
== 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-get</pre> | <pre>$ man apt-get</pre> | ||
| Riga 100: | Riga 109: | ||
==== 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''' . | ||
==== 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 114: | Riga 123: | ||
==== 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 | la guida è presente nel pacchetto '''developers-reference''' ed è disponibile in diverse lingue (inglese, tedesco, francese e giapponese). | ||
==== Debian Packaging Tutorial ==== | |||
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/> | |||
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 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 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 138: | Riga 152: | ||
== Link utili == | == Link utili == | ||
https://www.debian.org/doc/ | |||
{{Autori | |||
|Autore = [[Utente:S3v|S3v]] | |||
|Estesa_da = | |||
|Verificata_da = | |||
: [[Utente:HAL 9000|HAL 9000]] 13:51, 8 apr 2016 (CEST) | |||
|Numero_revisori = 1 | |||
}} | |||
[[Categoria:Introduzione a Debian]][[Categoria:Documentazione tecnica]] | [[Categoria:Introduzione a Debian]][[Categoria:Documentazione tecnica]][[Categoria: Risorse]] | ||