Le Manuel Gentoo est disponible dans les langues suivantes :
Allemand | Anglais | Chinois simplifié | Espagnol | Français | Italien | Japonais | Polonais
Bienvenue sur la page d'accueil du Manuel Gentoo. Cette page contient quelques explications relatives à la production du Manuel Gentoo et devrait répondre à la plupart des questions à son sujet. Vous trouverez ici les idées qui ont abouti à la création de ce Manuel, son statut actuel, ses développements futurs, comment nous avertir d'un bogue, etc.
Le Manuel est actuellement disponible en ligne, en version web ou imprimable, page par page ou en une seule page. La production de la documentation sous d'autres formats est à l'étude.
| Format | Description | Architectures |
| HTML | Le Manuel Gentoo : un chapitre par page, idéal pour une lecture en ligne. |
x86,
amd64,
ppc,
ppc64,
sparc,
mips,
hppa,
alpha
Non traduits : ia64, arm |
| HTML | Le Manuel Gentoo sur une seule page. |
x86,
amd64,
ppc,
ppc64,
sparc,
mips,
hppa,
alpha
Non traduits : ia64, arm |
| HTML | Le Manuel Gentoo : version imprimable. |
x86,
amd64,
ppc,
ppc64,
sparc,
mips,
hppa,
alpha
Non traduits : ia64, arm |
Pour des raisons purement historiques, les anciennes versions des manuels sont conservées depuis la version 2004.2. Pour obtenir un manuel complet sur une seule page, ajoutez ?full=1 à l'URL.
Attention : Ces manuels ne sont plus mis à jour. |
| Versions | Architectures |
| 2004.2 | x86, alpha, amd64, hppa, mips, ppc, sparc |
| 2004.3 | x86, amd64, hppa, ppc, sparc |
| 2005.0 | alpha, amd64, hppa, ppc, sparc, x86 |
| 2005.1 | alpha, amd64, hppa, sparc, x86 |
| 2006.0 | alpha, amd64, hppa, sparc, x86 |
Attention : Certaines versions du manuel n'ont pas été traduites en français et ne sont pas répertoriées ici. Vous pouvez consulter la liste des versions originales archivées pour les trouver. |
Le but du Manuel est de rassembler différents documents en un ensemble cohérent. Quelques guides ont déjà été intégrés de façon à présenter une information complète et cohérente pour chaque architecture, chaque installation et chaque utilisateur. Cela est non seulement plus facile à maintenir, mais montre aussi que les différences sont minimes et que toutes les architectures bénéficient d'un traitement équitable.
Cela nous permet également de mieux développer certains points délicats et de donner plus d'exemples. De plus, la documentation est plus agréable à lire que si elle était présentée en une seule page.
À l'heure actuelle, la quatrième partie du Manuel qui traite de la configuration du réseau sous Gentoo est terminée et est disponible dans sa version officielle. Cette partie traite en profondeur la configuration des interfaces réseaux avec le baselayout qui est maintenant stable.
Si vous désirez participer à la rédaction du Manuel, veuillez envoyer un courriel en anglais sur la liste de diffusion gentoo-doc.
Pour participer à la traduction du Manuel dans votre langue, suivez le lien correspondant ou envoyez un message au responsable de la langue à partir de la page du projet gdp/international.
Rapports de bogue et demandes d'améliorations
Si vous constatez une erreur dans le Manuel, veuillez nous en avertir en remplissant un rapport de bogue via notre interface Bugzilla. Adressez-le au produit Documentation, composant Installation Handbook.
Pourquoi ne pas générer un manuel adapté à la demande ?
Tout est possible, mais nous avons choisi d'éviter cette voie pour diverses raisons.
La maintenance d'un tel guide serait très difficile. D'une part, il serait complexe de déterminer le contexte d'un rapport de bogue à cause des différents choix que l'utilisateur aurait faits. D'autre part, il serait aussi bien délicat de fournir un texte d'une lecture fluide à partir des différents segments de texte que cela impliquerait.
Bien que nous n'ayons en ce moment qu'un seul format, d'autres formats pourraient être produits, par exemple le format PDF. Si nous devions fournir des fichiers PDF pour chaque architecture et chaque combinaison de choix possibles, nous serions alors obligés de créer un grand nombre de fichiers PDF pour seulement quelques sections différentes. Quel gaspillage de ressources !
Une autre raison est que les choix que doit faire l'utilisateur se trouvent à plusieurs endroits du Manuel et il faudrait lui poser toutes les questions en une fois avant la production du Manuel. Cela serait maladroit et effraierait probablement plus d'un utilisateur potentiel.
La partie qui traite de l'installation n'est pas la seule partie, c'est la première, mais toutes les parties suivantes seront identiques. Par conséquent, créer des manuels différents de façon dynamique serait un véritable gaspillage de ressources.
Enfin, en ne séparant pas les instructions qui correspondent à chaque choix, nous permettons à l'utilisateur de voir rapidement les résultats des autres choix possibles. Il a ainsi une meilleure perception des différentes options et de leurs conséquences.
Le Manuel ne parle pas de l'installation à partir d'un stage1
Les installations à partir des stage1 et stage2 ne sont pas couvertes par ce manuel. Veuillez consulter notre FAQ à ce sujet.
Je ne suis pas d'accord avec...
N'hésitez pas à nous faire part de vos remarques, idées ou commentaires via notre interface Bugzilla. Tout commentaire constructif sera apprécié. La documentation est destinée à la communauté et tout retour d'expérience nous intéresse. N'oubliez pas de donner votre avis en anglais afin que tout le monde puisse comprendre.
Notez que la plupart des décisions quant aux développements de la documentation sont collégiales et qu'il est parfois impossible de satisfaire tout le monde. Ne nous en voulez donc pas si nous déclinons vos propositions.
Ce document est protégé par la licence Creative Commons : Paternité - Partage des Conditions Initiales à l'Identique 2.5.