La création d'un système d'exploitation libre de haute qualité englobe les
manuels techniques qui décrivent le fonctionnement et l'utilisation des
programmes. Le « Projet Debian » s'efforce de fournir à tous ses
utilisateurs une documentation facilement accessible. Cette page fournit un
ensemble de liens vers des guides d'installation, des guides pratiques, des FAQ,
les notes de publication et bien plus encore.
Conservez ces documents à portée de main lors de votre première
installation de Debian, ils répondront probablement à un grand nombre de
questions et ils vous aideront à utiliser votre nouveau système
Debian.
Par la suite, vous pouvez consulter ces documents :
la référence Debian : le
manuel concis pour l’utilisateur axé sur la ligne de commande ;
les notes de publication :
publiées à chaque mise à jour de Debian, pour les personnes effectuant une
mise à niveau de la distribution ;
La plupart de la documentation disponible avec Debian est issue de la
documentation écrite pour le système GNU/Linux. Il existe, toutefois, des
documents spécifiques à Debian. En gros, ils sont classés selon les catégories
suivantes :
les manuels : ces guides sont comparables à des livres parce qu'ils
décrivent des sujets majeurs de manière très détaillée. Beaucoup des
manuels listés ici sont disponibles à la fois en ligne et sous la forme
de paquets Debian. En fait, la plupart des manuels sur le site web sont
extraits de leurs paquets respectifs. Vous pouvez choisir un des manuels
ci-dessous par son nom de paquet ou par sa version en ligne ;
les guides d'emploi : comme leurs noms l'indiquent, les
guides d'emploi
(« HOWTO ») décrivent comment faire une action particulière
c'est-à-dire qu'ils offrent des conseils pratiques détaillés sur la manière
de faire quelque chose ;
les FAQ : nous avons rassemblé plusieurs documents répondant à des
questions souvent posées. Les questions spécifiques à Debian sont
traitées dans la FAQ Debian. Il existe
également une FAQ sur les images CD/DVD Debian,
répondant à toutes sortes de questions sur les média d'installation ;
autres documents plus concis : consultez aussi liste
de modes d'emploi concis.
Beaucoup des manuels listés ici sont disponibles à la fois en ligne et sous
la forme de paquets Debian. En fait, la plupart des manuels sur le site web
sont extraits de leurs paquets respectifs. Vous pouvez choisir un des manuels
ci-dessous par son nom de paquet ou par sa version en ligne.
Les documents suivants fournissent des instructions plus concises et
rapidement consultables :
Pages de manuels
Traditionnellement, tous les programmes Unix sont documentés par des
pages de manuel, accessibles avec la commande
man. Elles ne s'adressent habituellement pas aux
débutants, mais documentent toutes les caractéristiques et fonctions
d'une commande. Le dépôt complet de l'ensemble des pages de manuel
disponibles dans Debian est en ligne à l'adresse https://manpages.debian.org/
Un grand nombre de logiciels GNU sont documentés par des
fichiers info au lieu de pages de manuel. Ces fichiers
incluent des informations détaillées sur le programme lui-même,
ses options et des exemples d'utilisation. Les pages info
sont disponibles grâce à la commande info.
Fichiers README
Les fichiers README sont de simples fichiers textes décrivant un
sujet unique, d'habitude un paquet. Vous en trouverez beaucoup dans
les sous-répertoires /usr/share/doc/ du système Debian. En
plus du fichier README, certains de ces répertoires contiennent des
exemples de configuration. Veuillez noter que la documentation des
plus gros programmes est habituellement fournie dans un paquet
séparé (avec un nom similaire au paquet d'origine, mais se
terminant par -doc).