Documentation
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.
Démarrage rapide
Si vous ne connaissez pas Debian, nous vous recommandons de commencer par lire ces deux guides :
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 ;
- le wiki Debian : le wiki officiel de Debian.
Manuels
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 de USB/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.
Manuels spécifiques à Debian
Manuels pour les utilisateurs
- Les cahiers du débutant sur Debian Bookworm
- FAQ Debian GNU/Linux
- Manuel d'installation Debian
- Notes de publication Debian
- Carte de référence Debian
- Manuel de l’administrateur Debian
- Guide de référence pour Debian
- Manuel de sécurisation
- Manuel de l’utilisateur d’aptitude
- Guide pour l’utilisateur d’APT
- FAQ Debian GNU/Linux et Java
- Guide pour le responsable du radioamateurisme dans Debian
Manuels pour les développeurs
- Charte Debian
- Référence du développeur Debian
- Guide pour les responsables de paquet Debian
- Introduction à l'empaquetage Debian
- Le système de menu Debian
- À l’intérieur de l’installateur Debian
- Guide pour les responsables de paquet utilisant une base de données
- Politique pour les paquets utilisant une base de données
Autres documents plus concis
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/
- Fichiers info
- 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).