Il manuale Gentoo è disponibile nelle seguenti lingue:
Cinese Semplificato | Francese | Giapponese | Inglese | Italiano | Polacco | Spagnolo | Tedesco
Benvenuti alla pagina di presentazione del Manuale Gentoo. Vengono ora fornite alcune spiegazioni riguardo al Manuale Gentoo che dovrebbero rispondere alla maggior parte delle domande. Vengono spiegate inoltre le idee che stanno dietro al manuale, il suo stato attuale, i progetti futuri, come vengono gestite le segnalazioni di errori e altro.
| Formato | Descrizione | Collegamento |
| HTML | Ultima versione, una pagina per capitolo, comodo per la consultazione Online | x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips, ia64, arm |
| HTML | Ultima versione, in un'unica pagina | x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips, ia64, arm |
| HTML | Ultima versione. in un'unica pagina in versione facile da stampare | x86, sparc, amd64, ppc, ppc64, alpha, hppa, mips, ia64, arm |
Versioni rilasciate in passato
Sono disponibili manuali per le versioni rilasciate in passato (in italiano dalla 2004.3). Versioni da stampare possono essere ottenute con il link "Stampa" in alto a destra di ogni pagina. Per la versione in una pagina unica aggiungere ?full=1 all'URL.
Avvertenza: Questi manuali non sono aggiornati. |
| Versione | Architettura |
| 2004.3 | amd64, hppa, ppc, sparc, x86 |
| 2005.0 | alpha, amd64, hppa, ppc, sparc, x86 |
| 2005.1 | alpha, amd64, hppa, ppc, ppc64, sparc, x86 |
| 2006.0 | alpha, amd64, hppa, ppc, ppc64, sparc, x86 |
| 2006.1 | alpha, amd64, hppa, ppc, ppc64, sparc, x86 |
| 2007.0 | amd64, hppa, ppc, ppc64, sparc, x86 |
| 2008.0 | amd64, hppa, ppc, ppc64, sparc, x86 |
3. Informazioni riguardanti il manuale
L'obiettivo del Manuale Gentoo è di creare un documento coerente che descriva ogni aspetto di Gentoo Linux. Incorpora le guide già disponibili in un unico volume omogeneo in modo che lo stesso documento venga utilizzato per ogni architettura, ogni tipo di installazione, ogni utente. Questo non facilita solo il processo di mantenimento, ma rende anche evidente agli utenti che le differenze sono lievi e che le altre architetture non son da considerare entità separate.
Consente inoltre di fermarsi sui punti più oscuri e dare maggiori esempi; infine la documentazione può essere diluita in varie pagine rendendo la lettura più agevole.
Al momento, la quarta parte riguardante Configurazione di rete di Gentoo è completa ed è ufficialmente disponibile. Questa parte contiene una trattazione approfondita delle opzioni di configurazione di rete per il baselayout stabile.
Se si è interessati allo sviluppo del Manuale, usare la mailing list gentoo-doc per tutti i commenti.
Segnalazione di errori e proposte
Se si trovano errori all'interno del manuale, è possibile visitare il nostro Bugzilla e creare un bug per Documentation, componente Installation Handbook.
Non si può avere automaticamente il manuale creato in modo dinamico per ogni scelta?
Tutto è possibile, ma si è optato per il no per molti motivi.
Mantenere la guida sarebbe molto più difficile. Si dovrebbe non soltanto tenere traccia nelle segnalazioni di errori delle scelte effettuate (e difficilmente nelle segnalazioni sarebbe possibile riportarle), ma sarebbe più difficile scrivere la guida in modo fluido: si dovrebbe fare estrema attenzione alla linea del manuale, alle consistenze, ecc
Anche se al momento si ha soltanto una versione online, si potrebbero preparare altri formati, ad esempio le versioni PDF. Se si dovessero creare i PDF per ogni architettura e opzione, si dovrebbero fornire numerosi PDF tutti quasi uguali: sarebbe uno spreco di risorse.
Le scelte dell'utente vengono effettuate in punti differenti. Questo renderebbe più difficile per l'utente, poter stampare il manuale: si dovrebbe informare l'utente di tutte le opzioni possibili prima che cominci a leggere e probabilmente si spaventerebbe.
La parte riguardante l' "Installazione di Gentoo" non è l'unica parte del Manuale Gentoo. È la prima, ma tutte le parti seguenti sono indipendenti delle scelte fatte dall'utente. Creare dinamicamente il manuale esclusivamente per le istruzioni di installazione sarebbe un errore.
Evitando di separare le istruzioni per ogni opzione possibile, l'utente può vedere in modo più facile i risultati delle altre scelte. Questo fornisce all'utente una miglior veduta d'insieme sulle istruzioni di installazione.
Non trovo informazioni sullo stage1 nel Manuale Gentoo
Le istruzioni su come condurre l'installazione utilizzando lo stage1 o stage2 sono ora disponibili nelle Domande frequenti su Gentoo. L'unica installazione supportata è quella mediante stage3.
È importante comunicare le proprie idee; non essere d'accordo senza fornire un consiglio costruttivo non è utile a nessuno. La documentazione è fatta per la comunità quindi i commenti della comunità sono bene accetti.
In ogni caso la maggior parte delle decisioni vengono prese con un metodo democratico. È impossibile scrivere/strutturare la documentazione in modo che tutti siano contenti. Bisogna essere capaci di accettare un rifiuto alla propria idea se lo stato attuale del documento soddisfa già la maggior parte delle persone.
I contenuti di questo documento sono rilasciati sotto la licenza Creative Commons - Attribution / Share Alike.