982
contributi
Documentazione Debian: differenze tra le versioni
m
link a materiale in italiano e verifica
S3v (discussione | contributi) (corretti link) |
m (link a materiale in italiano e verifica) |
||
| (Una versione intermedia di un altro utente 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 13: | Riga 13: | ||
== Il progetto Debian == | == Il progetto Debian == | ||
==== 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 | [https://www.debian.org/social_contract.it.html Il Contratto Sociale Debian]<br /> | ||
[https://www.debian.org/social_contract#guidelines Debian Free Software Guidelines]<br/> | [https://www.debian.org/social_contract.it.html#guidelines Le Linee Guida Debian per il Software Libero (Debian Free Software Guidelines - DFSG)]<br /> | ||
Una versione solo in lingua inglese é contenuta 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 | [https://www.debian.org/doc/manuals/project-history/index.it.html Breve storia di Debian]<br /> | ||
Il manuale è | Consultabile e scaricabile in lingua italiana in [https://www.debian.org/doc/misc-manuals.it.html diversi formati]<br /> | ||
Il manuale è disponibile nel [[pacchetto]] multilingue: '''debian-history'''. | |||
== Il sistema operativo Debian == | == Il sistema operativo Debian == | ||
==== Guida all'installazione ==== | ==== Guida all'installazione ==== | ||
Il manuale descrive la procedura di installazione per installare Debian e per risolvere eventuali problemi legati all'installazione.<br /> | |||
[https://www.debian.org/releases/stable/installmanual Guida all'installazione di Debian]<br/> | [https://www.debian.org/releases/stable/installmanual.it.html Guida all'installazione di Debian]<br /> | ||
Disponibile per ogni architettura supportata, consultabile e scaricabile in vari formati. [https://www.debian.org/releases/buster/installmanual.it.html Debian buster – Guida all'installazione]. | |||
É presente come [[pacchetto]] multilingue per diverse architetture. [https://packages.debian.org/installation-guide Pagina di riferimento] | |||
É necessario installare, con [[privilegi di amministrazione]], il pacchetto relativo alla propria architettura. Ad esempio per leggere la guida sull'installazione per ''amd64'', il pacchetto é '''installation-guide-amd64''': | |||
<pre># apt install installation-guide-amd64</pre> | |||
Il percorso della guida é <code>usr/share/doc/installation-guide-amd64/</code> con ulteriori sottocartelle relative alle varie traduzioni. Pe la lingua italiana é '''it''' comprendente i formati HTML, PDF e TXT. | |||
==== 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] | [https://www.debian.org/releases/stable/releasenotes.it.html Note di rilascio di Debian]<br /> | ||
Disponibile per ogni architettura supportata, consultabile e scaricabile in vari formati. | |||
==== 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 | [https://www.debian.org/doc/manuals/debian-reference/index.it.html Debian Reference]<br />Consultabile e scaricabile in [https://www.debian.org/doc/user-manuals.it.html#quick-reference vari formati]<br /> | ||
Il pacchetto installabile della guida è disponibile in [https://packages.debian.org/debian-reference diverse lingue]: '''debian-reference''' (versione inglese) e '''debian-reference-it''' (in italiano) nella cartella <code>/usr/share/debian-reference</code> nei formati HTML, EPUB, PDF 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/> | [https://www.debian.org/doc/manuals/debian-faq/index.it.html Debian FAQ]<br /> | ||
Consultabili e scaricabili in lingua italiana e in [https://www.debian.org/doc/user-manuals.it.html#faq diversi formati]<br /> | |||
Il pacchetto installabile delle FAQ é disponibili in [https://packages.debian.org/debian-faq diverse lingue] '''debian-faq''' (versione inglese) nella cartella <code>/usr/share/doc/debian/FAQ</code> e '''debian-faq-it''' (versione italiana) nella sottocartella <code>/usr/share/doc/debian/FAQ/it</code> rispettivamente, nel formato HTML, 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/> | [https://www.debian.org/doc/debian-policy/ Debian Policy]<br /> | ||
La policy di Debian è | Consultabile e scaricabile in lingua inglese anche in [https://www.debian.org/doc/devel-manuals#policy altr formati]<br /> | ||
La policy di Debian è disponibile come pacchetto (in inglese) '''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 ==== | ||
| Riga 56: | Riga 62: | ||
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. | 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/> | Libro che spiega come amministrare una macchina Debian. Leggere anche [[Il manuale dell'amministratore Debian|qui]].<br /> | ||
[https://www.debian.org/doc/manuals/debian-handbook/index.it.html Il Manuale dell'Amministratore Debian]<br /> | |||
Il manuale è incluso anche nel pacchetto '''debian-handbook''' nella cartella <code>/usr/share/doc/debian-handbook/html</code> in formato HTML. | 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/> | [https://www.debian.org/doc/manuals/securing-debian-howto/index.en.html Securing Debian Manual (EN)]] - [https://www.debian.org/doc/manuals/securing-debian-manual/index.it.html Manuale di sicurezza Debian]<br/> | ||
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. | 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. | ||
| Riga 87: | Riga 94: | ||
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>: | È 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 [[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/> | 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 == | ||
| Riga 113: | Riga 124: | ||
==== Kernel Hacker's Guide ==== | ==== Kernel Hacker's Guide ==== | ||
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''' . | 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 ==== | ||
| Riga 152: | Riga 165: | ||
== Link utili == | == Link utili == | ||
https://www.debian.org/doc/ | [https://www.debian.org/doc/ Documentation (EN)]<br /> | ||
[https://www.debian.org/doc/index.it.html Documentazione (IT)]<br /> | |||
[https://www.debian.org/doc/user-manuals Debian Users' Manuals (EN)]<br /> | |||
[https://www.debian.org/doc/user-manuals.it.html Manuali del DDP per gli utenti (IT)]<br /> | |||
{{Autori | {{Autori | ||
| Riga 158: | Riga 174: | ||
|Estesa_da = | |Estesa_da = | ||
|Verificata_da = | |Verificata_da = | ||
: [[Utente:HAL 9000|HAL 9000]] | :[[Utente:HAL 9000|HAL 9000]] 08:55, 28 lug 2019 (CEST) | ||
|Numero_revisori = | : [[Utente:Selky|Selky]] 18:59, 8 set 2020 (CEST) | ||
|Numero_revisori = 2 | |||
}} | }} | ||
[[Categoria:Introduzione a Debian]][[Categoria:Documentazione tecnica]][[Categoria: Risorse]] | [[Categoria:Introduzione a Debian]][[Categoria:Documentazione tecnica]][[Categoria: Risorse]] | ||