====== Référence Debian ======
* Objet : Découvrir et installer le manuel de l'utilisateur de Debian
* Niveau requis : {{tag>débutant avisé}}
* Commentaires : //Ce tutoriel est extrêmement simple mais la documentation qu'il vise à faire découvrir sera utile à tous, du débutant, qui y trouvera de nombreuses réponses à ses légitimes questions, à l'utilisateur confirmé qui pourra approfondir certains aspects de l'administration de son système.//
* Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !]] :-)
* Suivi :
* Création par [[user>sogalpunx]] le 17/11/2014
* Testé par [[user>paskal]] le 02/10/2015
* Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?pid=102308#p102308|C'est ici]]((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))
===== Introduction =====
Debian, c'est bien, Debian, c'est beau. Et Debian, c'est grand, très grand.\\
Quand on souhaite apprendre à utiliser son système, on commence souvent par lire les pages de manuels qui sont tout de même assez austères et pas toujours localisées. Mais il existe également un livre, une référence, qui présente et souvent détaille, la plupart des outils et fonctionnalités au sein du système dont peut avoir besoin un utilisateur. Et quand bien même on pense connaître son système, il permet d'en découvrir des aspects sur lesquels on ne se penche pas forcément régulièrement (ex : chiffrer un périphérique externe USB).
Ce livre a été rédigé par Osamu Aoki et il est disponible à tous en ligne, à l'adresse suivante : [[https://www.debian.org/doc/manuals/debian-reference/|Référence Debian]].
===== Installation =====
Être disponible sur le Web, c'est bien, mais c'est super de l'avoir chez soi, bien au chaud dans les entrailles de son disque dur le jour où l'on en a besoin sans avoir de connexion réseau (ou, justement, pour trouver des informations sur les moyens de la réparer !).
Le livre a donc été empaqueté dans différentes langues afin de pouvoir être installé facilement :
apt-get update && apt-get install debian-reference-fr
===== Utilisation =====
Après installation, vous pouvez y accéder grâce à la commande :
debian-reference
qui se charge en fait de lancer le navigateur par défaut du système pour y afficher le contenu de ''/usr/share/debian-reference/index.html''.
La consultation est également possible depuis le menu //Guide de référence pour Debian//, dans la catégorie //Accessoires//.
Vous pouvez maintenant explorer et lire tranquillement cet excellent ouvrage en local, sans avoir à supporter le coût (en temps et en énergie électrique consommée) d'une connexion internet.
===== Formats alternatifs epub et pdf =====
Il est possible de récupérer le livre aux formats EPUB et/ou PDF. Les fichiers sont placés dans le répertoire ''/usr/share/debian-reference/'' :
/usr/share/debian-reference/debian-reference.fr.epub
/usr/share/debian-reference/debian-reference.fr.pdf
===== Ce que vous apprendrez =====
Le parti pris du livre est de présenter avant tout des outils en ligne de commande, donc accessibles en cas de défaillance de l'interface graphique et indépendants de tout [[doc:environnements:environnements|environnement de bureau]].
Dans un premier temps, le lecteur trouvera un didacticiel sur GNU/Linux et Debian avec les commandes de base, le fonctionnement global du système de gestion des paquets et des outils essentiels.\\
Le livre détaille ensuite le fonctionnement normal du système, son initialisation, sa configuration (système, réseau, paquets, etc.) et donne au lecteur les moyens d'en assurer la maintenance.\\
L'utilisateur curieux trouvera également des informations sur des considérations plus avancées, telles que l'utilisation des dépôts versionnés avec CVS et Git ou encore les bases de la programmation.
===== Conclusion =====
Il existe de nombreux ouvrages sur Debian (ex : //Le cahier de l'administrateur Debian//((Vous pouvez consulter en ligne les versions Debian 8 Jessie (en [[https://debian-handbook.info/browse/fr-FR/jessie/|français]] ou en [[https://debian-handbook.info/browse/jessie/|anglais]]) et Debian 10 Buster (en [[https://debian-handbook.info/browse/fr-FR/buster/|français]] ou en [[https://debian-handbook.info/browse/buster/|anglais]]).))), qui présentent le fonctionnement du projet et des aspects propres à Debian (ex : APT, les branches //stable//, //testing//, etc.).\\ Cette //Référence Debian// rentre beaucoup plus dans le détail, sur des aspects techniques et pratiques utiles au quotidien, et, à ce titre, constitue donc une lecture essentielle pour l'utilisateur désireux de maîtriser son système ou, tout le moins, de le comprendre.