Le manuel Gentoo Sven Vermeulen Xavier Neys Le manuel Gentoo est le résultat d'un effort de centralisation de la documentation en un manuel cohérent. Ce manuel contient les instructions d'installation de la version courante avec un connexion Internet opérationnelle. Il couvre également l'utilisation de Gentoo et de Portage. 0.34 2006-02-27 Le manuel Gentoo
Langues disponibles

Le manuel Gentoo est disponible dans les langues suivantes :

Allemand | Anglais | Chinois traditionnel | Espagnol | Français | Italien | Japonais | Polonais | Portugais brésilien | Roumain | Russe | Tchèque

Introduction

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 mené au manuel, son statut actuel, ses développements futurs, comment nous avertir d'un bogue, etc.

Consulter le manuel

Actuellement, nous fournissons uniquement le manuel dans une version lisible en ligne ou imprimable, page par page ou en une seule page. La production de la documentation sous d'autres formats est à l'étude.

HTMLDernière version, un chapitre à la fois, idéal pour une lecture en ligne x86, alpha, amd64, hppa, mips, ppc64, sparc HTMLDernière version, tout le manuel x86, alpha, amd64, hppa, mips, ppc64, sparc HTMLDernière version, tout le manuel, version imprimable x86, alpha, amd64, hppa, mips, ppc64, sparc HTMLVersion 2006.0 pour une installation sans connexion réseauLes manuels de la version 2006.0
Format Description Architectures

Les manuels spécifiques qui accompagnent les sorties de nouveaux CD Gentoo sont disponibles pour une installation sans connexion réseau. Veuillez consulter les manuels de la version 2006.0.

Anciennes versions

Pour des raisons purement historiques, des manuels d'anciennes versions sont conservés depuis la version 2004.2. Pour obtenir un manuel complet sur une seule page, veuillez ajouter ?full=1 à l'URL.

Ces manuels ne sont plus mis à jour. 2004.2 x86, alpha, amd64, hppa, mips, ppc, sparc 2004.3 x86, amd64, hppa, ppc, sparc 2005.0 alpha, amd64, hppa, ppc, sparc, x86
Versions Architectures
À propos du manuel
Objectif

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.

Statut

À 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 ou directement à Sven Vermeulen.

Rapports de bogue et demandes d'amélioration

Si vous constatez une erreur dans le manuel, veuillez nous en avertir en remplissant un rapport de bogue via notre interface Bugzilla. Adressez-le à Docs-user, « Component » Handbook.

Foire aux questions
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 sont à l'étude, 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.

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.